Antes de empezar
Una API key de pruebas de Flashpi
Guárdala en una variable de entorno, nunca en el código ni en el repositorio.
Tu certificado de firma .p12
Cargado en la cuenta de pruebas.
Tus datos de emisor
RUC, establecimiento y punto de emisión configurados en tu cuenta.
Los datos del traslado
Remitente, destinatario, transportista (con placa) y puntos de partida y llegada.
Paso 1 · Reúne los datos del traslado
| Dato | Qué es |
|---|---|
remitente | Quien envía la mercadería |
destinatario | Quien la recibe |
transportista | Quien la lleva, con su identificación y la placa del vehículo |
traslado | Motivo, punto de partida, punto de llegada y fecha de inicio |
detalles | Qué mercadería se traslada y en qué cantidad |
Paso 2 · Emite la guía
curl -X POST https://api.flashpi.ec/v1/guias-de-remision \
-H "Authorization: Bearer $FLASHPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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 }
]
}'Emite la guía antes de que la mercadería salga. Los casos y plazos exactos los define el SRI.
Paso 3 · Lee la respuesta
{
"estado": "AUTORIZADO",
"clave_acceso": "(49 dígitos)",
"numero_autorizacion": "(número de autorización del SRI)",
"fecha_autorizacion": "(fecha y hora)"
}Paso 4 · Vincula la guía con tu factura
Guarda la clave_acceso de la guía junto a la factura de la venta. Así puedes mostrar ambos documentos en el mismo despacho.
Errores frecuentes
| Síntoma | Causa probable | Qué hacer | Referencia |
|---|---|---|---|
401 Unauthorized | API key ausente, inválida o de otro ambiente. | Revisa el header Authorization y que uses la key del ambiente correcto. | Ver detalle |
422 Esquema XML | Algún campo no cumple la estructura esperada. | Lee el detalle del error y corrige el campo indicado. | Ver detalle |
SRI 35 | El archivo no cumple la estructura XML. | Revisa los campos obligatorios y sus formatos. | Ver detalle |
SRI 45 | Secuencial ya registrado. | Revisa tu control de secuenciales por establecimiento y punto de emisión. | Ver detalle |