Postman Collection

Assets

The Postman collection and environment files are located in the backend repository:

• docs/proyectos/api-clientes/postman/GeoTareas API Client.postman_collection.json
• docs/proyectos/api-clientes/postman/GeoTareas API Client.local.postman_environment.json

Request Inventory

Auth (1)

• POST Login

Fleet (8)

• GET List Devices
• GET Device Detail
• GET Device Position
• PUT Update Device
• GET List Drivers
• POST Create Driver
• PUT Update Driver

Telemetry (1)

• POST Ingest Batch

Reports — AVL (9)

• GET Kilometers
• GET Geofence
• GET Trips
• GET Speed
• GET Idle
• GET Temperature
• GET Maintenance
• GET Ignition
• GET Vehicle Performance

Reports — GT Analytics (10)

• GET Quantity of Services
• GET Arrival Time
• GET Attention Time
• GET Assignment Time
• GET Service Full Time
• GET Total Service Time
• GET Control Arrival Time
• GET Control Total Time
• GET Delay Bands
• GET Task Kilometers

Reports — GT Operations (9)

• GET Tasks General
• GET Productivity
• GET Alerts
• GET Live Location
• GET Rejected Tasks
• GET Advanced Forms
• GET Accounts Report
• GET Proactivity by Device
• GET Proactivity by Task

Reports — General (3)

• GET Hardware Messages
• GET Logins
• GET Generated Alerts

Reports — CPM (1)

• GET Activity Detail

Accounts (4)

• GET List Accounts
• GET Account Detail
• POST Create Account
• PUT Update Account

Clients (4)

• GET List Clients
• GET Client Detail
• POST Create Client
• PUT Update Client

Workflow (12)

• GET List Definitions
• GET Definition Detail
• GET List Instances
• GET Instance Detail
• GET Instance Timeline
• GET Instance Captured Data
• POST Start Instance
• POST Cancel Instance
• GET List Tasks
• GET Task Detail
• POST Complete Task
• POST Reassign Task

Kanban (12)

• GET List Workspaces
• GET List Boards
• GET Board Detail
• GET Board Tasks
• PUT Change Task State
• GET List Cards
• GET Card Detail
• POST Create Card
• PUT Update Card
• PUT Move Card
• GET List Comments
• POST Add Comment

Reports — Portal (5)

• GET Dashboard
• GET Differences
• GET Billing
• GET Settlements
• GET Tolerance

Billing (16)

• GET List Invoices
• GET Invoice Detail
• GET Invoice Concepts
• GET Export CSV
• POST Create Invoice
• PUT Update Invoice
• PUT Replace Concepts
• PUT Change Status
• POST Run Automation
• GET List Statuses
• GET List Concepts
• GET List Tariffs
• GET Tariff Detail
• GET List Automation Rules
• GET Rule Detail
• POST Evaluate Rule (Dry Run)

Portal Proveedores (13)

• GET List Provider Invoices
• GET Invoice Detail
• POST Declare Amount
• POST Declare Batch
• POST Validate Amount
• GET Invoice States
• GET Concepts
• GET Effective Tolerance
• GET List Settlements
• GET Settlement Detail
• POST Create Settlement
• PUT Submit Settlement

Legacy Despacho (10)

• POST WSGetServicios
• POST WSSeguimientoTarea
• POST WSGetTareaMultimedia
• POST WSGeocoding (CalleEsquina + CalleNumero)
• POST WSReverseGeocoding
• POST WSSearchGeocoding
• POST WSGetArchivosMultimedia (3 operations)
• POST WSGetFacturas
• POST WSABMCuentas
• POST WSAltaServicio (Crear + Cancelar)

Variables

Variable	Description
baseUrl	API base URL (e.g. https://yourcompany.geotareas.com)
tenant	Tenant domain
email	Login email
password	Login password
token	JWT token (auto-set by Login request)
apiKey	API key from onboarding
deviceId	Device ID for detail/position/update
driverId	Driver ID for update
accountId	Account ID for detail/update
clientId	Client ID for detail/update
definitionId	Workflow definition ID
instanceId	Workflow instance ID
taskId	Workflow task ID or Kanban task ID
boardId	Kanban board ID
cardId	Kanban card ID
invoiceId	Billing invoice ID
tariffId	Billing tariff ID
ruleId	Automation rule ID
settlementId	Portal settlement ID
startDate	Report start date (ISO 8601)
endDate	Report end date (ISO 8601)

Auto-configured Behavior

• Login auto-saves token from data.authorization
• All protected requests send Authorization: Bearer {{token}} + X-API-Key: {{apiKey}} + tenant: {{tenant}}

Quick Test Flow

1. Run Login — token is saved automatically
2. Run List Devices — copy an id to deviceId
3. Run Device Detail and Device Position
4. Run any report with startDate and endDate set
5. For Telemetry, use the same token and apiKey
6. For Workflow, get a definitionId from List Definitions first
7. For Kanban, get a boardId from List Boards first