Introducción

API de Sincronización

Esta guía documenta los endpoints públicos de integración /transportes/sync/* para sistemas externos como external_erp, WMS u otros productores/consumidores de datos.

Objetivo

Los endpoints /sync existen para sincronizar datos maestros y documentos operativos desde un sistema externo hacia Smartfleet Transportes, y para que el integrador pueda consultar registros por source_id.

Casos principales:

  • Crear o actualizar catálogos: productos, clientes, proyectos, sedes, proveedores, choferes, vehículos y tipos.
  • Crear o actualizar documentos: facturas, recolecciones, traslados, devoluciones y guías.
  • Consultar registros sincronizados por source_id o listar registros por recurso.
  • Estandarizar errores de dependencias para que el integrador sepa qué entidad sincronizar primero.

Base path

POST/transportes/sync/{resource}

Todos los endpoints de sincronización comparten este prefijo base.