Flashpi 01
La guía de remisión debe emitirse antes de que la mercadería salga.
Para quién es esta página
Proveedores de software de transporte y logística (TMS) y equipos técnicos de empresas con sistema propio.
¿Tienes una empresa de transporte o un parqueadero?
El reto
Lo que tendrás que resolver
02
Los datos del transportista y la placa deben ir completos y correctos.
03
Un mismo viaje puede llevar mercadería para varios destinatarios.
04
La factura del flete debe cuadrar con la guía y con el viaje.
05
Los viajes se reprograman o se cancelan.
Cómo se integra
Cómo se integra con tu TMS
Tu software no necesita generar XML, firmarlo ni hablar con los servicios del SRI.
TMS Software de transporte
API Flashpi XML · firma · envío
SRI Recepción y autorización
- 01 Conecta Genera tu API key y úsala solo desde tu backend.
- 02 Engánchate al evento correcto Cuando ocurra en tu sistema, envía los datos a Flashpi.
- 03 Guarda el resultado Registra la
clave_accesoy el estado en tu documento. - 04 Mantén el estado al día Recibe webhooks o consulta el comprobante cuando lo necesites.
En qué momento emitir cada comprobante
| Evento en tu TMS | Comprobante |
|---|---|
| Despacho del viaje | Guía de remisión |
| Entrega o cierre del servicio | Factura |
| Ajuste del servicio | Nota de crédito |
Del viaje a la guía de remisión
| En tu TMS | En la API |
|---|---|
| Cliente que envía | remitente |
| Cliente que recibe | destinatario |
| Conductor o empresa transportista y vehículo | transportista (con la placa) |
| Origen, destino, motivo y fecha | traslado |
| Carga | detalles |
| Resultado | Guarda clave_acceso y estado en el viaje |
Ejemplo de guía de remisión de un viaje:
{
"remitente": { "identificacion": "1790000000001", "razon_social": "Empresa de ejemplo" },
"destinatario": { "identificacion": "0102030405", "razon_social": "Cliente de ejemplo" },
"transportista": {
"identificacion": "0911223344",
"razon_social": "Transportista de ejemplo",
"placa": "ABC-1234"
},
"traslado": {
"motivo": "venta",
"punto_partida": "Quito",
"punto_llegada": "Guayaquil",
"fecha_inicio": "2026-12-03"
},
"detalles": [
{ "descripcion": "Caja de mercadería", "cantidad": 10 }
]
}Respuesta esperada al emitir:
{
"estado": "AUTORIZADO",
"clave_acceso": "(49 dígitos)",
"numero_autorizacion": "(número de autorización del SRI)",
"fecha_autorizacion": "(fecha y hora)"
} Buenas prácticas
Buenas prácticas para tu TMS
- 1 Emite la guía al despachar Antes de que el vehículo salga.
- 2 Una guía por destinatario Cuando el viaje reparte carga a varios clientes.
- 3 Guarda la
clave_accesoen el viaje Para consultas y auditoría. - 4 Vincula la guía con la factura del servicio Para que el flete cuadre con el viaje.
- 5 Define el proceso para viajes cancelados o reprogramados Antes de salir a producción.
Incluido
Lo que Flashpi te da
- API REST con JSON Versionada en /v1 y descrita con OpenAPI 3.1. Ver referencia
- Ambiente de pruebas del SRI Valida tu integración antes de producción. Cómo probarlo
- Colección de Postman Para explorar los endpoints.
- SDKs open source en GitHub
- Webhooks Para recibir el estado de cada comprobante.
- Ejemplos por lenguaje y soporte técnico
- Estado del servicio en tiempo real status.flashpi.ec
Preguntas frecuentes
Preguntas sobre la integración con TMS
¿Cuándo debe emitirse la guía de remisión?
Antes de iniciar el traslado, según el SRI. Confirma los casos y plazos vigentes.
¿Puedo emitir la guía y la factura del flete con la misma API?
Sí, con endpoints distintos. Mira cómo emitir guías de remisión por API.
¿Qué datos del vehículo necesito?
Como mínimo la placa, y los datos del transportista. Confirma los campos obligatorios en la referencia del endpoint.
¿Funciona con varios destinatarios por viaje?
Sí, con una guía por destinatario.