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 de la factura original
Número y fecha de emisión de la factura que vas a modificar.
Paso 1 · Decide qué estás corrigiendo
| Situación | Qué haces |
|---|---|
| Devolución total | Nota de crédito por el valor completo de la factura |
| Devolución parcial | Nota de crédito solo por los ítems devueltos |
| Descuento posterior | Nota de crédito por el valor del descuento |
| Error en la factura | Nota de crédito y, si corresponde, una nueva factura correcta |
Paso 2 · Emite la nota de crédito
curl -X POST https://api.flashpi.ec/v1/notas-de-credito \
-H "Authorization: Bearer $FLASHPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"documento_modificado": {
"tipo": "factura",
"numero": "001-001-000000045",
"fecha_emision": "2026-11-02"
},
"motivo": "Devolución de mercadería",
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{ "descripcion": "Servicio de ejemplo", "cantidad": 1, "precio_unitario": 25.00 }
]
}'El bloque documento_modificado es el que vincula la nota con la factura original. Debe coincidir exactamente con ella.
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 · Si necesitas anular la nota de crédito
Mira la referencia de anulación de una nota de crédito.
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 |