Rendiciones por hoja de ruta

Las rendiciones por hoja de ruta (route settlements) son un agrupamiento operativo de comprobantes registrados por un asociado durante un día de trabajo, identificado por un código de ruta. Aplican a customers cuyo modelo operativo incluye choferes o distribuidores que recorren clientes en una jornada y necesitan rendir lo cobrado al cierre.

Cuándo usar este recurso

Si tu customer no tiene flota o no usa el concepto de hoja de ruta, podés ignorar esta sección. Las rendiciones se aplican a modelos B y C del lado de los asociados.

Modelo

{
  "id": 5001,
  "routeCode": "AA-2026-05-15-042",
  "date": "2026-05-15",
  "associateId": 88,
  "receivableAccountIds": [4242, 4243, 4250],
  "summary": {
    "receivablesCount": 12,
    "totalAmount": 425000.00,
    "byReceivableType": [
      { "type": "INVOICE",     "count": 10, "amount": 450000.00 },
      { "type": "RETURN_PRODUCT", "count": 1, "amount": -15000.00 },
      { "type": "RETENTION",   "count": 1, "amount": -10000.00 }
    ]
  },
  "creationDate": "2026-05-15T18:30:00-03:00"
}

Campo	Descripción
routeCode	Código de hoja de ruta. Único por date y customer
date	Día de la rendición
associateId	Asociado que rindió
receivableAccountIds	Cuentas recaudadoras tocadas en la jornada
summary.receivablesCount	Cantidad de comprobantes registrados en la jornada
summary.totalAmount	Suma neta (positivos suman, negativos restan)
summary.byReceivableType	Desglose por tipo de comprobante

Endpoints

Método	Path	Descripción
GET	/v1/route-settlements	Lista con filtros
POST	/v1/route-settlements	Crea o actualiza una rendición
GET	/v1/route-settlements/{routeCode}	Detalle por código
GET	/v1/route-settlements/{routeCode}/receivables	Comprobantes de la rendición
GET	/v1/associates/{id}/route-settlements	Rendiciones de un asociado

Crear o actualizar

POST /v1/route-settlements
Idempotency-Key: erp-route-AA-2026-05-15-042
Content-Type: application/json

{
  "routeCode": "AA-2026-05-15-042",
  "date": "2026-05-15",
  "associateId": 88
}

Campo	Tipo	Requerido	Descripción
routeCode	string	Sí	Único por date y customer
date	YYYY-MM-DD	Sí	Día de la jornada
associateId	int64	Sí	Asociado responsable

Una vez creada, los comprobantes que el asociado registre durante el día con externalRoutingCode = "AA-2026-05-15-042" quedan automáticamente agrupados bajo esta rendición.

Validaciones

Validación	Error
routeCode ya existe para otro date	422 route-code-already-used
Asociado deshabilitado	422 associate-disabled
Mismo (routeCode, date) con associateId distinto	409 route-code-already-used

Filtros

GET /v1/route-settlements

Parámetro	Tipo	Descripción
associateId	int64	Rendiciones de un asociado
routeCode	string	Búsqueda por código
fromDate, toDate	YYYY-MM-DD	Rango de fechas
page, count	int	Paginación

Listar comprobantes de una rendición

GET /v1/route-settlements/AA-2026-05-15-042/receivables

Devuelve la lista de comprobantes (no items de liquidación, sino los comprobantes registrados durante esa jornada). Cada uno con su status, amount, client, etc. Es el insumo principal para la conciliación diaria del chofer.