Skip to main content
This guide will walk you through the essential steps to get Alternativa Verde up and running, from initial configuration to creating your first material entry ticket.
Before starting this guide, make sure you have completed the Installation steps.

​
Getting Started

1

Configure Your Collection Center

When you first open Alternativa Verde, you need to set up your collection center:
  1. Navigate to the Configuration module (Configuración)
  2. Create a new collection center or select an existing one
  3. Fill in the collection center details:
    • Name: Your collection center name
    • State: State/province location
    • City: City location
    • Address: Physical address
    • Active Status: Mark as active
// Collection center data structure
{
  id: string,
  name: string,
  state: string,
  city: string,
  address: string,
  isActive: boolean
}
  1. Set as Active Center: Ensure your collection center is set as the active center in the application configuration
Only one collection center can be active at a time. All operations will be associated with the active center.
2

Register Your Team Members

Add the team members who will be handling material collections:
  1. In the Configuration module, go to Team Members (Miembros del Equipo)
  2. Click Add Member and provide:
    • Full Name: Team member’s complete name
    • Cédula: National ID number (optional)
    • Phone: Contact phone number
    • Role: Position (e.g., “Collector”, “Driver”, “Supervisor”)
    • Active Status: Mark as active
// Team member data structure
{
  id: string,
  centerId: string,
  fullName: string,
  cedula: string,
  phone: string,
  role: string,
  isActive: boolean
}
Register all team members who will be collecting materials, as they’ll be assigned to tickets later.
3

Add Material Generators (Clients)

Register the generators (clients) who provide materials to your collection center:
  1. Navigate to the Generators module (Generadores)
  2. Click Register Generator and complete:
    • Name: Generator/client name
    • RIF: Tax identification number
    • Phone: Contact number
    • Address: Generator location
    • Sector: Geographic sector or zone
    • Collection Mode: How materials are collected (e.g., “Pickup”, “Drop-off”)
// Generator data structure
{
  id: string,
  name: string,
  rif: string,
  phone: string,
  address: string,
  sector: string,
  collectionMode: string,
  collectionCenterId: string
}
The generator will be automatically associated with your active collection center.
4

Register Vehicles (Optional)

If you use vehicles for material collection, register them in the system:
  1. Go to the Vehicles module (Vehículos)
  2. Click Add Vehicle and enter:
    • Plate: Vehicle license plate
    • Brand: Vehicle manufacturer
    • Model: Vehicle model
    • Owner: Vehicle owner name
    • Default Vehicle: Mark if this is your primary vehicle
// Vehicle data structure
{
  id: string,
  plate: string,
  brand: string,
  model: string,
  owner: string,
  isDefault: boolean,
  collectionCenterId: string
}
You can mark one vehicle as the default, which will auto-populate in ticket creation forms.
5

Create Your First Entry Ticket

Now you’re ready to record your first material entry:
  1. Navigate to the Tickets module
  2. Click New Ticket (Nuevo Ticket)
  3. Fill in the ticket information:
    • Date: Collection date
    • Generator: Select from your registered generators
    • Material Type: Type of material collected (e.g., “Plastic”, “Cardboard”, “Metal”)
    • Quantity: Amount collected (in kg or your unit of measure)
    • Material State: Choose one:
      • Filtrado (Filtered): Sorted and clean material
      • Bruto (Raw): Unsorted material
      • Mezcla (Mixed): Mixed material types
    • Collector: Select the team member who performed the collection
    • Vehicle Plate: Enter or select the vehicle used
// Ticket data structure
{
  id: string,
  ticketNumber: string,        // Auto-generated
  date: string,
  generatorId: string,
  generatorName: string,        // Cached for history
  materialType: string,
  quantity: number,
  materialState: "Filtrado" | "Bruto" | "Mezcla",
  collectionCenterId: string,
  collectorMemberId: string,
  collectorName: string,
  vehiclePlate: string
}
  1. Click Create to save the ticket
The system automatically generates a unique ticket number for tracking purposes.
6

Review Your Ticket History

After creating tickets, you can:
  • View All Tickets: See complete entry history
  • Search Tickets: Find specific tickets by number or generator
  • Filter by Date: View tickets from specific time periods
  • Export Data: Download ticket data for reporting
Navigate to the History module (Historial) to review and validate all movements.

​
What’s Next?

​
Recording Material Dispatches

When you transfer materials to another location, create a dispatch record:
  1. Go to the Dispatches module (Salidas)
  2. Click New Dispatch
  3. Enter dispatch details:
    • Date and description
    • Presentation format (e.g., “Bales”, “Bags”)
    • Dispatched quantity
    • Destination information (name, RIF, address)
    • Vehicle and driver details
    • MINEC guide number (if applicable)
// Dispatch data structure
{
  id: string,
  date: string,
  description: string,
  presentation: string,
  dispatchedQuantity: number,
  destinationName: string,
  destinationRif: string,
  destinationAddress: string,
  vehicleId: string,
  driverName: string,
  driverId: string,
  minecGuideNumber: string,
  collectionCenterId: string
}

​
Best Practices

Regular Updates

Record tickets immediately after material collection to maintain accurate inventory levels

Complete Information

Fill in all relevant fields to ensure comprehensive tracking and reporting

Verify Active Center

Before creating tickets, always verify that the correct collection center is active

Team Training

Ensure all team members understand the material state classifications and ticket creation process

​
Data Management

Export for Reporting: Use the export functionality to generate reports for management, regulatory compliance, or analysis. Alternativa Verde supports Excel export for easy data manipulation.

​
Common Workflows

​
Daily Collection Operations

  1. Start your day by verifying the active collection center
  2. As materials arrive, create entry tickets with complete information
  3. Assign the correct collector and vehicle to each ticket
  4. Classify material state accurately (Filtrado, Bruto, or Mezcla)
  5. At end of day, review the ticket history for accuracy

​
Multi-Center Management

If you manage multiple collection centers:
  1. Switch the active center in Configuration when needed
  2. Each center maintains its own:
    • Team members
    • Generators
    • Vehicles
    • Ticket and dispatch history
  3. Use the center filter in reports to analyze performance by location

​
Need Help?

If you encounter any issues or have questions:
  • Review the Installation guide for setup troubleshooting
  • Check that your PostgreSQL database is running and accessible
  • Verify that the active collection center is correctly configured
  • Ensure team members and generators are registered before creating tickets

Back to Introduction

Learn more about Alternativa Verde’s capabilities and features

Build docs developers (and LLMs) love

Get started for freeTalk to us