Reporte de Cuentas

Datos maestros de cuentas con detalles de cliente, proveedor, ubicación y saldo de servicios. No requiere rango de fechas.

GET/apidev/v1/reports/gt/accounts

PermisoAPICLI_RPTGT_CUENTAS

Límite de solicitudes10 req/min

Caché300s

---

Resumen

Devuelve los datos maestros de las cuentas como una instantánea actual (no requiere rango de fechas) — identidad completa, datos fiscales y de documento, contactos, ubicación con coordenadas, el cliente y el proveedor vinculados, saldos de servicios (inicial, usado, restante) y el vehículo asociado. Filtrá por cliente, proveedor, tipo de cuenta, geografía o estado, o realizá una búsqueda de texto libre.

---

Solicitud

Encabezados de la solicitud

Every request to a protected endpoint requires these headers:

Header	Required	Description
Authorization	Yes	Bearer token obtained from the Login endpoint. Format: Bearer <token>
X-API-Key	Yes	Company integration key provided during onboarding. Format: gtk_xxx...
tenant	Yes	Your assigned tenant domain (default: geotareas.com) — always send your assigned tenant
Content-Type	Conditional	application/json — required for POST and PUT requests

Parámetros de consulta

Parámetro	Tipo	Requerido	Por defecto	Descripción
client_id	string	No	—	Filtrar por ID de cliente.
provider_id	string	No	—	Filtrar por ID de proveedor.
account_type	string	No	—	Filtrar por tipo de cuenta.
country_id	string	No	—	Filtrar por ID de país.
department_id	string	No	—	Filtrar por ID de departamento.
city_id	string	No	—	Filtrar por ID de ciudad.
status	enum	No	—	Estado de la cuenta: active, inactive.
search	string	No	—	Búsqueda de texto libre. Máximo 200 caracteres.
limit	integer	No	25	Cantidad de registros por página (1–100).
offset	integer	No	0	Cantidad de registros a omitir para la paginación.

No requiere rango de fechas

Este es un reporte de estado instantáneo. Los parámetros startdate y enddate no se utilizan.

---

Ejemplos de código

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/accounts?status=active&limit=25"

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/accounts?status=active&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'X-API-Key': APIKEY,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

Python

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/gt/accounts",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"status": "active", "limit": 25},
)
data = response.json()

---

Respuesta

Campos de la respuesta

Campo	Tipo	Descripción
account_id	string | null	Identificador de la cuenta.
account_name	string	Nombre de la cuenta.
account_notes	string	Notas de la cuenta.
account_external_code	string	Código único de la cuenta.
task_count	number | null	Tareas de la cuenta en el período. Solo viene cuando account_type selecciona cuentas con tareas (conTareas / ambas); si no, null.
last_successful_task	object | null	Última tarea cerrada con un código de fin exitoso (task_number, completion_code, status, created_at, finished_at). Solo viene cuando el reporte de base lo calcula; si no, null.
products	string	Procedencia / producto (y cobertura) configurados en la cuenta, en una línea.
routes	string	Rutas fijas a las que pertenece la cuenta, con su estado, en una línea.
start_date	string | null	Fecha de inicio de la cuenta.
end_date	string | null	Fecha de fin de la cuenta.
account_type	string	Tipo de cuenta.
tax_id	string	Número de identificación fiscal.
legal_name	string	Razón social.
doc_type	string	Tipo de documento.
document	string	Número de documento.
phone	string	Número de teléfono.
mobile	string	Número de celular.
email	string	Dirección de correo electrónico.
client_id	string | null	Identificador del cliente.
client_name	string	Nombre del cliente.
provider_id	string | null	Identificador del proveedor.
provider_name	string	Nombre del proveedor.
coverage_area	string	Área de cobertura.
country	string	Nombre del país.
department	string	Nombre del departamento/estado.
city	string	Nombre de la ciudad.
address	string	Dirección.
postal_code	string	Código postal.
latitude	number | null	Latitud.
longitude	number | null	Longitud.
initial_services_balance	number	Saldo inicial de servicios.
services_used	number	Servicios consumidos.
services_remaining	number	Servicios restantes.
vehicle_make	string	Marca del vehículo.
vehicle_model	string	Modelo del vehículo.
vehicle_year	string	Año del vehículo.

Ejemplo de respuesta

{
  "success": true,
  "data": [
    {
      "account_id": "104820579501",
      "account_name": "Sucursal Centro",
      "account_notes": "Main downtown branch",
      "account_external_code": "EXT-9912",
      "task_count": 14,
      "last_successful_task": {
        "task_number": "55012",
        "completion_code": "Resuelto en el lugar",
        "status": "FIN",
        "created_at": "2026-03-05T08:15:00",
        "finished_at": "2026-03-05T10:30:00"
      },
      "products": "Asistencia - Mecanica (AMBA) | Asistencia - Grua (AMBA)",
      "routes": "Ruta Norte (A) Estado (A)",
      "start_date": "2025-01-15",
      "end_date": null,
      "account_type": "Commercial",
      "tax_id": "30-71234567-9",
      "legal_name": "Distribuidora Norte S.A.",
      "doc_type": "CUIT",
      "document": "30712345679",
      "phone": "+54 11 4555-1234",
      "mobile": "+54 9 11 5678-9012",
      "email": "centro@distribuidoranorte.com",
      "client_id": "104820579601",
      "client_name": "Distribuidora Norte",
      "provider_id": "104820579701",
      "provider_name": "LogiServ",
      "coverage_area": "AMBA",
      "country": "Argentina",
      "department": "Buenos Aires",
      "city": "CABA",
      "address": "Av. Reforma 1234, Col. Centro",
      "postal_code": "C1043",
      "latitude": -34.6037,
      "longitude": -58.3816,
      "initial_services_balance": 100,
      "services_used": 78,
      "services_remaining": 22,
      "vehicle_make": "Toyota",
      "vehicle_model": "Hilux",
      "vehicle_year": "2024"
    },
    {
      "account_id": "104820579502",
      "account_name": "Bodega Sur",
      "account_notes": "",
      "account_external_code": "",
      "task_count": null,
      "last_successful_task": null,
      "products": "Sin Configurar",
      "routes": "Sin Ruta",
      "start_date": "2025-06-01",
      "end_date": "2026-06-01",
      "account_type": "Industrial",
      "tax_id": "",
      "legal_name": "Logistica Express S.R.L.",
      "doc_type": "",
      "document": "",
      "phone": "",
      "mobile": "+54 9 11 3456-7890",
      "email": "bodega@logisticaexpress.com",
      "client_id": "104820579602",
      "client_name": "Logistica Express",
      "provider_id": null,
      "provider_name": "",
      "coverage_area": "",
      "country": "Argentina",
      "department": "Buenos Aires",
      "city": "Avellaneda",
      "address": "Calle 5 de Mayo 567",
      "postal_code": "1870",
      "latitude": -34.6633,
      "longitude": -58.3653,
      "initial_services_balance": 50,
      "services_used": 50,
      "services_remaining": 0,
      "vehicle_make": "",
      "vehicle_model": "",
      "vehicle_year": ""
    }
  ],
  "meta": {
    "total": 2,
    "limit": 25,
    "offset": 0
  }
}

---

Errores

Código	HTTP	Descripción
VALIDATION_ERROR	400	Parámetros inválidos: valores de enum inválidos.
UNAUTHORIZED	401	tenant / Authorization / X-API-Key faltante, inválido o expirado
FORBIDDEN	403	El usuario no tiene el permiso requerido.
RATE_LIMITED	429	Se superaron las 10 req/min.
INTERNAL_ERROR	500	Error inesperado del servidor.

---

Relacionados

• Reporte de Tareas General
• Reporte de Formularios Avanzados
• Reporte de Ubicación en Vivo
• Paginación