Endpoint de documentos

Actualizado hoy

Archive el documento de la solicitud asociado al pedido indicado en native_system_load_id y a la parada cuando se haya establecido native_system_stop_id. Enviamos comprobantes de entrega (POD): uno cada vez que un tracker carga un POD en TrackFlo o se aprueba un POD recopilado del transportista o del conductor. Los demás tipos de documentos solo se envían si los solicita.

Ruta sugerida: POST /trackflo/documents. Encontrará información sobre la autenticación, los campos compartidos, las respuestas y los reintentos en Crear endpoints de escritura de vuelta para TrackFlo.

Campos

Cada solicitud incluye los campos compartidos y estos. event_type es document.

Campo	Tipo	Descripción
`doc_type`	string	El tipo de documento. Consulte Tipos de documentos más abajo.
`file_name`	string	El nombre del archivo, por ejemplo, `Order_1089520_POD.pdf`.
`content_type`	string	`application/pdf`, `image/jpeg` o `image/png`. Los POD siempre son un único PDF con todas las páginas combinadas.
`file_size_bytes`	integer	El tamaño del archivo antes de codificarlo.
`file_sha256`	string	El valor SHA-256 hexadecimal del archivo. Compruébelo después de decodificar `file_base64`.
`file_base64`	string	El archivo codificado en base64. Hasta 20 MB antes de codificarlo.
`native_system_stop_id`	string or null	La parada a la que pertenece el documento, como la recogida para un BOL. Null para documentos asociados al pedido, como un POD.
`note`	string or null	La nota del tracker sobre el documento, de hasta 1.000 caracteres.

Ejemplo

{
  "event_id": "9b2e6d14-7f3a-4c58-a1e9-0d84c5b7f2a6",
  "event_type": "document",
  "native_system_load_id": "1089520",
  "native_system_load_leg_id": "2330158",
  "entered_by_name": "Jordan Ellis",
  "entered_by_email": "[email protected]",
  "entered_by_tms_user_id": "JELLIS",
  "entered_at_utc": "2026-10-25T18:20:03Z",
  "trackflo_load_url": "https://app.trackflo.tech/public_load_details/4b6e…",
  "doc_type": "pod",
  "file_name": "Order_1089520_POD.pdf",
  "content_type": "application/pdf",
  "file_size_bytes": 412883,
  "file_sha256": "a3f1c9…",
  "file_base64": "JVBERi0xLjcKJeLjz9MK…",
  "native_system_stop_id": null,
  "note": null
}

Responda con el id del documento:

{ "id": "img-55120-1" }

Tipos de documentos

`doc_type`	Documento	Asociado a
`pod`	Comprobante de entrega	El pedido
`bol`	Conocimiento de embarque	La parada
`lumper_receipt`	Recibo de descarga	La parada
`scale_ticket`	Ticket de báscula	La parada
`pallet_photo`	Foto del palé	La parada
`temp_gauge_photo`	Foto de la unidad refrigerada	El tramo
`in_transit_photo`	Foto en tránsito	El tramo
`other`	Cualquier otro documento	El pedido

Enviamos pod de forma predeterminada. Indíquenos qué otros tipos desea y a qué tipos de documentos de su TMS se asigna cada uno.

Información importante

Acepte cuerpos de hasta 30 MB. Un archivo de 20 MB aumenta aproximadamente un tercio al codificarse en base64. Rechace los cuerpos de mayor tamaño con 413 y avisaremos a nuestro equipo.
Un segundo POD para el mismo pedido es un documento nuevo. Significa que un tracker cargó un reemplazo o las páginas que faltaban. Guárdelo junto con el primero; no lo trate como un duplicado. Si se vuelve a intentar enviar el mismo documento, tendrá el mismo event_id.
Su equipo también recibe el POD por correo electrónico. Si su equipo ya recibe los POD por correo electrónico desde TrackFlo, seguirá recibiéndolos. El endpoint añade el POD al pedido en su TMS; no sustituye el correo electrónico.

¿Te fue útil?