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 proveedor
Identificación, nombre y dirección de a quien le compras.
Confirma con tu contador
Que tu caso corresponde a una liquidación de compra.
Paso 1 · Entiende cuándo se usa
La liquidación de compra respalda compras a personas que no emiten factura, por ejemplo ciertos productores o prestadores de servicios. Los casos exactos los define el SRI. Lee qué es y cuándo se emite.
Paso 2 · Emite la liquidación
curl -X POST https://api.flashpi.ec/v1/liquidaciones-de-compra \
-H "Authorization: Bearer $FLASHPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"proveedor": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Proveedor de ejemplo",
"direccion": "Av. Principal y Calle Secundaria, Quito"
},
"detalles": [
{ "descripcion": "Producto agrícola de ejemplo", "cantidad": 10, "precio_unitario": 8.50 }
]
}'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 · Registra el comprobante en tu sistema
Guarda la clave_acceso junto a la compra. Te servirá para consultar el XML y para tus reportes. Mira cómo consultar el XML por clave de acceso.
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 |