API REST de facturación electrónica Ecuador

Descargar colección de Postman

Inicio

El API HTTP REST de Factuplan te permite integrar facturación electrónica autorizada por el SRI del Ecuador desde cualquier lenguaje o plataforma: PHP, Python, Go, .NET, Ruby, Bash + cURL, etc.

Base URL: https://api-rest.factuplan.com.ec
Versionado por path: todos los endpoints viven bajo /v1/developer/*.
Respuestas siempre JSON con sobre { data, meta }.
Dos entornos: pruebas (ak_test_*) y producción (ak_live_*).
Compatible con Postman: descarga la colección oficial.

Importante: los comprobantes creados con una API key de pruebas se eliminan automáticamente cada hora. Usa pruebas solo para desarrollo.

Instalación

No hay nada que instalar — el API se consume con cualquier cliente HTTP.

Crear una API key

Inicia sesión en app.factuplan.com.ec.
Anda a Developer → Create API key.
Copia la clave generada — solo se muestra una vez.
Guárdala en una variable de entorno (FACTUPLAN_API_KEY), nunca la subas al repositorio.

Las API keys son por workspace. El prefijo indica el entorno:

Prefijo	Entorno	Comportamiento
`ak_test_*`	Pruebas	Comprobantes ficticios, eliminados cada hora
`ak_live_*`	Producción	Comprobantes reales firmados y enviados al SRI

Prueba rápida con cURL

curl https://api-rest.factuplan.com.ec/v1/developer/usage \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "Accept: application/json"

Autenticación

Todas las peticiones requieren dos cabeceras:

Cabecera	Valor	Notas
`X-API-Key`	Tu API key (`ak_test_` o `ak_live_`)	Identifica el workspace y el plan.
`x-taxpayer-ruc`	RUC del contribuyente emisor (13 dígitos)	Requerida cuando la operación emite o consulta comprobantes.

curl https://api-rest.factuplan.com.ec/v1/developer/invoices \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d @factura.json

Seguridad: nunca expongas tu API key en el frontend. Úsala solo desde tu servidor.

Convenciones

Sobre de respuesta

Todas las respuestas exitosas siguen la misma forma:

{
  "data": { /* recurso o lista */ },
  "meta": {
    "requestId": "req_1a2b3c",
    "timestamp": "2026-05-13T12:34:56.789Z"
  }
}

Las listas paginadas añaden meta.pagination:

{
  "data": [ /* ... */ ],
  "meta": {
    "requestId": "req_1a2b3c",
    "timestamp": "2026-05-13T12:34:56.789Z",
    "pagination": {
      "total": 120,
      "page": 1,
      "limit": 20,
      "totalPages": 6
    }
  }
}

Sobre de error

Los errores devuelven el mismo formato en todos los endpoints:

{
  "statusCode": 422,
  "message": "Customer identification is invalid",
  "code": "INVOICE_4002",
  "details": [
    "identification must be a 13-digit RUC"
  ]
}

Código HTTP	Significado
`200` / `201`	Operación correcta.
`400`	Error de validación o body mal formado.
`401`	API key faltante, inválida o expirada.
`403`	Permisos insuficientes o plan incompatible.
`404`	Recurso no encontrado.
`422`	Datos válidos sintácticamente pero rechazados por reglas del negocio o del SRI.
`429`	Rate limit o cuota mensual excedidos.
`500`	Error interno — reintenta con backoff.

Postman

Descarga la colección oficial e impórtala en Postman para probar el API en segundos. La colección incluye 52 endpoints organizados en 9 secciones (facturas, uso, certificado, clientes, productos, notas de crédito, notas de débito, retenciones y guías de remisión) con ejemplos de request y response.

1) Descarga: /factuplan-developer.postman_collection.json
2) Abre Postman → Import → arrastra el archivo.
3) En la colección "Factuplan API" → pestaña Variables, reemplaza:
     apiKey        = tu API key (ak_test_* o ak_live_*)
     taxpayerRuc   = tu RUC de 13 dígitos
   baseUrl ya viene pre-configurada en https://api-rest.factuplan.com.ec.

Descargar colección

Comprobantes

Emisión completa de facturas electrónicas. La API soporta tres modos:

Modo A — Factuplan crea el XML, lo firma, lo autoriza ante el SRI, genera el PDF (RIDE) y manda el correo. Es el camino recomendado.
Modo B — Tú generas el XML sin firmar; Factuplan lo firma, autoriza y notifica.
Modo C — Factuplan solo firma el XML; tú te encargas del envío al SRI.

Emitir comprobante (Modo A)

POST /v1/developer/invoices

Flujo completo: crea el XML, lo firma con tu certificado P12, lo autoriza ante el SRI, genera el PDF (RIDE) y envía el correo al cliente automáticamente.

Request body

{
  "customer": {
    "customerId": "cust_id (opcional)",
    "identificationType": "RUC",
    "identification": "0993378150001",
    "legalName": "Empresa Demo S.A.",
    "email": "facturas@empresademo.ec",
    "address": "Guayaquil, Ecuador",
    "phone": "+593985691039",
    "saveToContacts": true
  },
  "items": [
    {
      "quantity": 1,
      "productId": "prod_id (opcional)",
      "code": "SERV-001",
      "auxiliaryCode": "AUX-001 (opcional)",
      "description": "Servicio de consultoría",
      "unitPrice": 150.0,
      "discount": 0,
      "taxType": "IVA_RATE",
      "tax": 15,
      "saveToProducts": false
    }
  ],
  "emissionPointId": "ep_id (opcional)",
  "establishment": "001 (opcional)",
  "emissionPoint": "001 (opcional)",
  "additionalInfo": { "Vendedor": "Juan Pérez" },
  "sendEmail": true,
  "payments": [
    {
      "method": "20",
      "amount": 172.5,
      "term": 30,
      "timeUnit": "dias"
    }
  ]
}

Campos del `customer`

Campo	Tipo	Requerido	Notas
`customerId`	string	No	Si se envía, ignora los demás campos y usa el cliente del directorio.
`identificationType`	enum	Sí	`RUC`, `CEDULA`, `PASSPORT`, `FINAL_CONSUMER`
`identification`	string	Sí	RUC = 13 dígitos · CEDULA = 10 dígitos.
`legalName`	string	Sí	Razón social o nombre completo.
`email`	string	No	Necesario para envío automático del RIDE.
`address`	string	No	Aparece en el RIDE.
`phone`	string	No	Formato libre.
`saveToContacts`	boolean	No	Si `true`, lo guarda en tu directorio.

Campos de cada `item`

Campo	Tipo	Requerido	Notas
`quantity`	number	Sí	Cantidad facturada.
`productId`	string	No	Si se envía, los demás campos pueden omitirse.
`code`	string	Sí	Identificador del ítem.
`auxiliaryCode`	string	No	Código secundario (SKU, código de barras…).
`description`	string	Sí	Aparece en el RIDE.
`unitPrice`	number	Sí	Hasta 4 decimales de precisión.
`discount`	number	No	Descuento por línea.
`taxType`	enum	Sí	`IVA_0`, `IVA_RATE`, `NOT_TAXABLE`, `EXEMPT`.
`tax`	number	Sí cuando `taxType=IVA_RATE`	Tarifa: `0`, `5`, `8`, `12`, `14`, `15` (default `15`).
`saveToProducts`	boolean	No	Si `true`, lo guarda en tu catálogo.

Punto de emisión

Tres formas de resolverlo, en orden de prioridad:

Por UUID — envía emissionPointId.
Por códigos SRI — envía establishment + emissionPoint.
Auto-detección — omite todo; si solo tienes un punto activo, lo usa.

Tarifas de IVA (`tax`)

Aplica cuando taxType es IVA_RATE. Default: 15.

`tax`	Código SRI	Descripción
`0`	0	IVA 0%
`5`	5	IVA 5%
`8`	8	IVA 8%
`12`	2	IVA 12%
`14`	3	IVA 14%
`15`	4	IVA 15% (default)

Formas de pago (`payments`)

Cada entrada lleva el código SRI en method, el amount y, opcionalmente, term + timeUnit. Si omites payments, se aplica "01" (Sin utilización del sistema financiero).

La suma de los amount debe ser exactamente igual al total con impuestos. Si no, el SRI rechaza la factura con 400.

Código	Descripción
`01`	Sin utilización del sistema financiero
`15`	Compensación de deudas
`16`	Tarjeta de débito
`17`	Dinero electrónico
`18`	Tarjeta prepago
`19`	Tarjeta de crédito
`20`	Otros con utilización del sistema financiero
`21`	Endoso de títulos

`timeUnit`	Descripción
`dias`	Días
`meses`	Meses
`anios`	Años

Respuesta `201 Created`

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0104202601099337815000110010010000000011234567890",
    "sequential": "000000001",
    "status": "PROCESSING",
    "total": 172.5,
    "source": "API",
    "apiKeyId": "ak_01H..."
  },
  "meta": {
    "requestId": "req_1a2b3c",
    "timestamp": "2026-05-13T12:34:56.789Z"
  }
}

status empieza en PROCESSING y evoluciona a AUTHORIZED → COMPLETED, o a ERROR / REJECTED. Consulta el progreso con GET /v1/developer/receipts/{id}/status.

Ejemplo con cURL

curl https://api-rest.factuplan.com.ec/v1/developer/invoices \
  -X POST \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "identificationType": "RUC",
      "identification": "0993378150001",
      "legalName": "Empresa Demo S.A.",
      "email": "facturas@empresademo.ec"
    },
    "items": [
      {
        "code": "SERV-001",
        "description": "Servicio de consultoría",
        "quantity": 1,
        "unitPrice": 150.0,
        "taxType": "IVA_RATE",
        "tax": 15
      }
    ],
    "payments": [
      { "method": "20", "amount": 172.5 }
    ]
  }'

Listar facturas

GET /v1/developer/invoices

Lista las facturas emitidas con paginación. Puedes filtrar por RUC del cliente, estado y rango de fechas.

Query parameters

Parámetro	Tipo	Default	Notas
`page`	number	`1`	Página solicitada.
`limit`	number	`20`	Elementos por página (máx. `100`).
`ruc`	string	—	RUC o cédula del cliente (filtro opcional).
`status`	enum	—	`DRAFT`, `AUTHORIZED`, `REJECTED`, `VOIDED`.
`dateFrom`	string	—	Fecha de inicio ISO 8601 (ej: `2025-01-01`).
`dateTo`	string	—	Fecha de fin ISO 8601 (ej: `2025-12-31`).

Respuesta `200 OK`

{
  "data": [
    {
      "id": "rcpt_01HABC",
      "accessKey": "0104202601099337815000110010010000000011234567890",
      "sequential": "000000007",
      "status": "AUTHORIZED",
      "total": 172.5,
      "createdAt": "2026-05-13T12:34:56.789Z"
    }
  ],
  "meta": {
    "requestId": "req_1a2b3c",
    "timestamp": "2026-05-13T12:34:56.789Z",
    "pagination": { "total": 120, "page": 1, "limit": 20, "totalPages": 6 }
  }
}

Importar comprobante por clave de acceso

POST /v1/developer/invoices/import

Importa una factura ya autorizada por el SRI usando su clave de 49 dígitos. Útil para sincronizar comprobantes emitidos fuera de Factuplan.

Solo ak_live_*. No disponible con claves de pruebas.

Request body

{
  "accessKey": "0104202601099337815000110010010000000011234567890"
}

Respuesta `201 Created`

{
  "data": {
    "id": "rcpt_01HXYZ",
    "accessKey": "0104202601099337815000110010010000000011234567890",
    "sequential": "000000007",
    "status": "AUTHORIZED",
    "total": 230.0,
    "source": "IMPORT",
    "apiKeyId": "ak_01H..."
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Firmar y autorizar XML (Modo B)

Si tu sistema ya genera el XML de factura sin firmar, puedes enviarlo directamente a Factuplan para que lo firme con tu certificado y lo autorice ante el SRI.

POST /v1/developer/sign-and-authorize

Headers

Header	Valor
`X-API-Key`	`ak_live_...`
`x-taxpayer-ruc`	RUC del contribuyente emisor
`Content-Type`	`application/json`

Body

{
  "xml": "<factura>...</factura>"
}

Campo	Tipo	Requerido	Descripción
`xml`	string	Sí	XML de factura sin firmar, como string UTF-8

Respuesta 201 Created

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0104202601099337815000110010010000000011234567890",
    "status": "PROCESSING",
    "type": "INVOICE"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`id`	string	ID interno del comprobante en Factuplan
`accessKey`	string	Clave de acceso SRI de 49 dígitos
`status`	string	Estado inicial (`PROCESSING`)
`type`	string	Tipo de comprobante (`INVOICE`)

Ejemplo con cURL

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/sign-and-authorize \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "xml": "<factura>...</factura>" }'

Consulta el progreso con GET /v1/developer/receipts/{id}/status.

Firmar XML sin enviar al SRI (Modo C)

POST /v1/developer/sign

Firma el XML con tu certificado P12 de forma síncrona, sin enviarlo al SRI. Útil si necesitas controlar el envío al SRI por tu cuenta.

Body

{
  "xml": "<factura>...</factura>"
}

Respuesta 200 OK

{
  "data": {
    "signedXml": "<factura>...</factura>"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Validar estructura de XML

POST /v1/developer/validate-xml

Valida que el XML tenga la estructura correcta según el esquema del SRI, sin procesarlo ni enviarlo. Devuelve los errores de validación encontrados.

Body

{
  "xml": "<factura>...</factura>"
}

Respuesta 200 OK

{
  "data": {
    "valid": false,
    "errors": [
      "El elemento 'infoTributaria' es requerido"
    ]
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Consultar comprobantes

Consultar comprobante externo por clave de acceso

POST /v1/developer/receipts/query

Consulta cualquier comprobante autorizado por el SRI (Facturas 01, Notas de Crédito 04, Guías de Remisión 06), sin importar qué sistema lo emitió. Si el contribuyente emisor no existe en tu workspace, se crea automáticamente con firma vacía.

Solo ak_live_*. No disponible con claves de pruebas.

Cómo se descuenta el contador: el crédito se descuenta cuando el comprobante está autorizado, sin importar el valor de save. Si no está autorizado, no se descuenta ningún crédito.

Request body

Campo	Tipo	Requerido	Notas
`accessKey`	string	Sí	Clave de acceso SRI (49 dígitos).
`save`	boolean	No (default `true`)	Si `false`, solo verifica sin guardar en BD ni generar PDF.

{
  "accessKey": "0104202601019999999900110010010000000011234567813",
  "save": true
}

Obtener detalle del comprobante

GET /v1/developer/receipts/{id}

Devuelve todos los datos del comprobante: estado, clave de acceso, secuencial, totales y fechas.

Respuesta `200 OK`

{
  "data": {
    "id": "rcpt_01HABC",
    "accessKey": "0104202601099337815000110010010000000011234567890",
    "sequential": "000000001",
    "status": "COMPLETED",
    "total": 172.5,
    "source": "API",
    "apiKeyId": "ak_01H..."
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Consultar estado del comprobante

GET /v1/developer/receipts/{id}/status

Devuelve el estado actual: PROCESSING, AUTHORIZED, COMPLETED, ERROR o REJECTED.

Respuesta `200 OK`

{
  "data": {
    "status": "AUTHORIZED",
    "authorizationNumber": "0104202601...",
    "messages": []
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Descargar XML autorizado

GET /v1/developer/receipts/{id}/xml

Devuelve una URL pre-firmada del XML autorizado por el SRI (expira en 5 minutos) y una URL permanente de visualización (previewUrl) que no expira.

Respuesta `200 OK`

{
  "data": {
    "url": "https://files.factuplan.com.ec/...?sig=...",
    "previewUrl": "https://files.factuplan.com.ec/preview/rcpt_01HABC.xml"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Descargar PDF (RIDE)

GET /v1/developer/receipts/{id}/pdf

Devuelve una URL pre-firmada del PDF (RIDE) del comprobante (expira en 5 minutos) y una URL permanente de visualización (previewUrl).

Respuesta `200 OK`

{
  "data": {
    "url": "https://files.factuplan.com.ec/...?sig=...",
    "previewUrl": "https://files.factuplan.com.ec/preview/rcpt_01HABC.pdf"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Clientes

CRUD del directorio de clientes (receptores) que aparecerán en tus comprobantes.

Crear cliente

POST /v1/developer/customers

Request body

{
  "identificationType": "RUC",
  "identification": "0993378150001",
  "legalName": "Empresa Demo S.A.",
  "email": "facturas@empresademo.ec",
  "address": "Guayaquil, Ecuador",
  "phone": "+593985691039",
  "additionalEmail": "contabilidad@empresademo.ec"
}

Campo	Tipo	Requerido	Notas
`identificationType`	enum	Sí	`RUC`, `CEDULA`, `PASSPORT`, `FINAL_CONSUMER`.
`identification`	string	Sí	Validamos longitud y dígito verificador.
`legalName`	string	Sí	Razón social o nombre completo.
`email`	string	No	Para envío automático del RIDE.
`address`	string	No	Aparece en el RIDE.
`phone`	string	No	Formato libre.
`additionalEmail`	string	No	Copia opcional para el envío del RIDE.

Respuesta `201 Created`

{
  "data": {
    "id": "cust_01HABC",
    "taxpayerId": "tax_01H...",
    "identificationType": "RUC",
    "identification": "0993378150001",
    "legalName": "Empresa Demo S.A.",
    "email": "facturas@empresademo.ec",
    "isActive": true,
    "createdAt": "2026-05-13T12:34:56.789Z",
    "updatedAt": "2026-05-13T12:34:56.789Z"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Listar clientes

GET /v1/developer/customers

Query parameters

Parámetro	Tipo	Default	Notas
`page`	number	`1`	Página solicitada.
`limit`	number	`20`	Elementos por página.
`search`	string	—	Busca por nombre, identificación o email.
`identificationType`	enum	—	`RUC`, `CEDULA`, `PASSPORT`, `FINAL_CONSUMER`.
`isActive`	boolean	—	Filtra por estado activo.

Respuesta `200 OK`

{
  "data": [
    {
      "id": "cust_01HABC",
      "taxpayerId": "tax_01H...",
      "identificationType": "RUC",
      "identification": "0993378150001",
      "legalName": "Empresa Demo S.A.",
      "email": "facturas@empresademo.ec",
      "isActive": true,
      "createdAt": "2026-05-13T12:34:56.789Z",
      "updatedAt": "2026-05-13T12:34:56.789Z"
    }
  ],
  "meta": {
    "requestId": "req_1a2b3c",
    "timestamp": "2026-05-13T12:34:56.789Z",
    "pagination": { "total": 120, "page": 1, "limit": 20, "totalPages": 6 }
  }
}

Obtener cliente

GET /v1/developer/customers/{id}

Devuelve el detalle completo de un cliente específico por su ID.

Actualizar cliente

PATCH /v1/developer/customers/{id}

Actualiza uno o más campos. Solo se modifican los enviados en el body.

{
  "email": "nuevo@empresademo.ec",
  "phone": "+593987654321",
  "isActive": true
}

Eliminar cliente

DELETE /v1/developer/customers/{id}

Elimina un cliente del directorio. No afecta los comprobantes ya emitidos a ese cliente.

Respuesta `200 OK`

{
  "data": { "message": "Customer deleted successfully" },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Productos

CRUD del catálogo de ítems facturables. Funciona igual para productos tangibles y servicios.

Crear producto o servicio

POST /v1/developer/products

Request body

{
  "code": "SERV-001",
  "type": "SERVICE",
  "name": "Servicio de consultoría",
  "unitPrice": 150.0,
  "taxType": "IVA_RATE",
  "auxiliaryCode": "AUX-001",
  "description": "Hora de consultoría técnica",
  "iceCode": "",
  "iceRate": 0,
  "irbpnr": false,
  "unitOfMeasure": "hora"
}

Campo	Tipo	Requerido	Notas
`code`	string	Sí	Identificador único en tu workspace.
`type`	enum	Sí	`PRODUCT`, `SERVICE`.
`name`	string	Sí	Aparece en el RIDE.
`unitPrice`	number	Sí	Hasta 4 decimales de precisión.
`taxType`	enum	Sí	`IVA_0`, `IVA_RATE`, `NOT_TAXABLE`, `EXEMPT`.
`auxiliaryCode`	string	No	Código secundario (SKU, código de barras…).
`description`	string	No	Descripción larga.
`iceCode`	string	No	Código ICE del SRI.
`iceRate`	number	No	Tarifa ICE aplicable.
`irbpnr`	boolean	No	`true` si el ítem aplica IRBPNR.
`unitOfMeasure`	string	No	Ej. `unidad`, `kg`, `hora`.

Listar productos

GET /v1/developer/products

Query parameters

Parámetro	Tipo	Default	Notas
`page`	number	`1`	Página solicitada.
`limit`	number	`20`	Elementos por página.
`search`	string	—	Busca por nombre, código o descripción.
`type`	enum	—	`PRODUCT`, `SERVICE`.
`taxType`	enum	—	`IVA_0`, `IVA_RATE`, `NOT_TAXABLE`, `EXEMPT`.
`isActive`	boolean	—	Filtra por estado activo.

Obtener, actualizar y eliminar

GET    /v1/developer/products/{id}
PATCH  /v1/developer/products/{id}
DELETE /v1/developer/products/{id}

PATCH acepta cualquier subconjunto de los campos de creación más isActive: boolean. DELETE no afecta comprobantes históricos que ya referencien el ítem.

Uso & Cuota

GET /v1/developer/usage

Devuelve el consumo de documentos del mes actual, el límite de tu plan y el costo estimado.

Respuesta `200 OK`

{
  "data": {
    "currentMonth": "2026-05",
    "plan": "growth",
    "monthlyQuota": 1000,
    "monthlyUsed": 273
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`currentMonth`	string	Período actual (`YYYY-MM`).
`plan`	string	Plan vigente del workspace.
`monthlyQuota`	number	Límite mensual del plan.
`monthlyUsed`	number	Documentos consumidos en el período.

Certificado digital

GET /v1/developer/certificate/status

Indica si el certificado P12 configurado en tu cuenta está vigente, su fecha de vencimiento y el RUC del titular. Si no está vigente, los comprobantes no podrán firmarse.

Respuesta `200 OK`

{
  "data": {
    "hasCertificate": true,
    "isExpired": false,
    "daysUntilExpiry": 87,
    "ruc": "0950194407001",
    "legalName": "Mi Empresa S.A.",
    "issuedAt": "2025-05-13T00:00:00.000Z",
    "expiresAt": "2026-08-08T00:00:00.000Z",
    "issuer": "Banco Central del Ecuador"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`hasCertificate`	boolean	Si hay un certificado cargado.
`isExpired`	boolean	`true` si el certificado expiró.
`daysUntilExpiry`	number	Días restantes hasta el vencimiento.
`ruc`	string	RUC del titular del certificado.
`legalName`	string	Nombre registrado en el certificado.
`issuedAt`	string	Fecha de emisión (ISO 8601).
`expiresAt`	string	Fecha de vencimiento (ISO 8601).
`issuer`	string	Entidad certificadora emisora.

Si isExpired es true, renueva el certificado en Configuración → Certificado desde tu cuenta antes de seguir emitiendo.

Subir firma electrónica (P12)

POST /v1/developer/certificate
Content-Type: multipart/form-data

Sube un certificado P12. Si el RUC del certificado no existe aún como contribuyente en tu cuenta y tu plan lo permite, el contribuyente se crea automáticamente y se vincula a tu API key.

Campos del body (multipart/form-data)

Campo	Tipo	Requerido	Descripción
`file`	archivo	sí	Archivo P12 (`.p12` o `.pfx`).
`password`	string	sí	Contraseña del certificado.

Ejemplo con cURL

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/certificate \
  -H "x-api-key: ak_live_TU_CLAVE" \
  -F "file=@/ruta/firma.p12" \
  -F "password=MiContraseña"

Respuesta `200 OK`

{
  "data": {
    "hasCertificate": true,
    "isExpired": false,
    "daysUntilExpiry": 87,
    "ruc": "0950194407001",
    "legalName": "Mi Empresa S.A.",
    "expiresAt": "2026-08-08T00:00:00.000Z",
    "created": true
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`hasCertificate`	boolean	`true` si el certificado se subió correctamente.
`isExpired`	boolean	Si el certificado ya expiró.
`daysUntilExpiry`	number	Días restantes hasta el vencimiento.
`ruc`	string	RUC extraído del certificado.
`legalName`	string	Nombre legal extraído del certificado.
`expiresAt`	string	Fecha de vencimiento (ISO 8601).
`created`	boolean	`true` si se creó automáticamente un nuevo contribuyente. Solo presente cuando se creó.

Notas de crédito

Una nota de crédito corrige total o parcialmente una factura ya autorizada. Se identifica la factura original por su clave de acceso de 49 dígitos. Si la factura no existe en el sistema, Factuplan la importa automáticamente desde el SRI (genera XML y PDF sin enviar correo).

Emitir nota de crédito

POST /v1/developer/credit-notes

Headers

Header	Valor
`X-API-Key`	`ak_live_...`
`x-taxpayer-ruc`	RUC del contribuyente emisor
`Content-Type`	`application/json`

Body

{
  "invoiceAccessKey": "2312202301179214289100110010020000001231234567811",
  "reason": "Error en datos del cliente",
  "items": [
    {
      "code": "SERV-001",
      "description": "Servicio de desarrollo web",
      "quantity": 1,
      "unitPrice": 100.00,
      "taxType": "IVA_RATE"
    }
  ]
}

Campo	Tipo	Requerido	Descripción
`invoiceAccessKey`	`string`	Sí	Clave de acceso de 49 dígitos de la factura original
`reason`	`string`	Sí	Motivo de la nota de crédito
`items`	`array`	Sí	Ítems a acreditar (misma estructura que en facturas)
`emissionPointId`	`string`	No	UUID del punto de emisión (hereda el de la factura si se omite)
`payments`	`array`	No	Métodos de pago
`additionalInfo`	`object`	No	Campos adicionales clave-valor

Respuesta 201

{
  "data": {
    "id": "clx1234...",
    "accessKey": "0412202404179214289100110010040000001231234567814",
    "sequential": "000000001",
    "status": "PROCESSING",
    "total": 115.00
  },
  "meta": {}
}

Listar notas de crédito

GET /v1/developer/credit-notes

Lista las notas de crédito emitidas con paginación. Acepta los mismos filtros que el listado de facturas (page, limit, ruc, status, dateFrom, dateTo).

Consultar, descargar y anular

Una vez emitida, usa los endpoints genéricos de comprobantes:

GET  /v1/developer/receipts/:id           # Detalle
GET  /v1/developer/receipts/:id/status    # Estado
GET  /v1/developer/receipts/:id/xml       # XML autorizado
GET  /v1/developer/receipts/:id/pdf       # PDF RIDE
POST /v1/developer/receipts/:id/void      # Anular (solo a nivel sistema)

Importante: La anulación es solo a nivel del sistema Factuplan. La notificación de anulación ante el SRI es responsabilidad del desarrollador.

Actualizar secuencial de notas de crédito

PATCH /v1/developer/credit-notes/sequential

Establece el próximo número secuencial para notas de crédito en el punto de emisión indicado. El nuevo valor entra en efecto en el siguiente comprobante emitido.

{
  "branchCode": "001",
  "emissionCode": "001",
  "creditNoteSequential": 100
}

Campo	Tipo	Requerido	Descripción
`branchCode`	string	sí	Código del establecimiento (3 dígitos, ej: `"001"`)
`emissionCode`	string	sí	Código del punto de emisión (3 dígitos, ej: `"001"`)
`creditNoteSequential`	integer	sí	Nuevo valor del secuencial (≥ 0)

Firmar XML

Si tu sistema ya genera el XML de nota de crédito sin firmar, puedes enviarlo a Factuplan para que lo firme con tu certificado y lo autorice ante el SRI. La nota de crédito referencia una factura original por clave de acceso — si esa factura no existe en Factuplan, impórtala primero.

Paso 1 — Importar la factura vinculada (si no existe en Factuplan)

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/invoices/import \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "accessKey": "0102202401179213650600120010010000000011234567813" }'

Paso 2 — Firmar y autorizar el XML de la nota de crédito

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/sign-and-authorize \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "xml": "<notaCredito>...</notaCredito>" }'

Respuesta 201 Created

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0412202404179214289100110010040000001231234567814",
    "status": "PROCESSING",
    "type": "CREDIT_NOTE"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`id`	string	ID interno del comprobante en Factuplan
`accessKey`	string	Clave de acceso SRI de 49 dígitos
`status`	string	Estado inicial (`PROCESSING`)
`type`	string	Tipo de comprobante (`CREDIT_NOTE`)

Consulta el progreso con GET /v1/developer/receipts/{id}/status.

Notas de débito

Una nota de débito registra cargos adicionales sobre una factura ya autorizada: ajustes de precio, mora, flete no facturado, etc. Se identifica la factura original por su clave de acceso de 49 dígitos.

Emitir nota de débito

POST /v1/developer/debit-notes

Emite una nota de débito a partir de una factura ya autorizada. Si la factura no existe en el sistema, impórtala primero con POST /v1/developer/invoices/import.

Request body

{
  "invoiceAccessKey": "2312202301179214289100110010020000001231234567811",
  "reasons": [
    {
      "description": "Ajuste de precio",
      "amount": 10.00,
      "taxType": "IVA"
    }
  ],
  "additionalInfo": {}
}

Campo	Tipo	Requerido	Descripción
`invoiceAccessKey`	string	Sí	Clave de acceso de 49 dígitos de la factura original
`reasons`	array	Sí	Motivos del cargo: `description`, `amount` y `taxType`
`additionalInfo`	object	No	Campos adicionales clave-valor

Cada entrada de reasons lleva:

Campo	Tipo	Requerido	Descripción
`description`	string	Sí	Concepto del cargo (ej: “Ajuste de precio”)
`amount`	number	Sí	Monto del cargo
`taxType`	string	Sí	Impuesto aplicable al cargo (ej: `IVA`)

Respuesta `201 Created`

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0512202404179214289100110010050000001231234567815",
    "sequential": "000000001",
    "status": "PROCESSING",
    "total": 11.50
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Listar notas de débito

GET /v1/developer/debit-notes

Lista las notas de débito emitidas con paginación. Acepta los mismos filtros que el listado de facturas (page, limit, ruc, status, dateFrom, dateTo).

Consultar, descargar y anular

Una vez emitida, usa los endpoints genéricos de comprobantes:

GET  /v1/developer/receipts/:id           # Detalle
GET  /v1/developer/receipts/:id/status    # Estado
GET  /v1/developer/receipts/:id/xml       # XML autorizado
GET  /v1/developer/receipts/:id/pdf       # PDF RIDE
POST /v1/developer/receipts/:id/void      # Anular (solo a nivel sistema)

Actualizar secuencial de notas de débito

PATCH /v1/developer/debit-notes/sequential

Mismo contrato que el secuencial de facturas, con el campo debitNoteSequential:

{
  "branchCode": "001",
  "emissionCode": "001",
  "debitNoteSequential": 100
}

Firmar XML

Si tu sistema ya genera el XML de nota de débito sin firmar, puedes enviarlo a Factuplan para que lo firme con tu certificado y lo autorice ante el SRI.

Paso 1 — Importar la factura vinculada (si no existe en Factuplan)

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/invoices/import \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "accessKey": "0102202401179213650600120010010000000011234567813" }'

Paso 2 — Firmar y autorizar el XML de la nota de débito

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/sign-and-authorize \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "xml": "<notaDebito>...</notaDebito>" }'

Respuesta 201 Created

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0512202404179214289100110010050000001231234567815",
    "status": "PROCESSING",
    "type": "DEBIT_NOTE"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`id`	string	ID interno del comprobante en Factuplan
`accessKey`	string	Clave de acceso SRI de 49 dígitos
`status`	string	Estado inicial (`PROCESSING`)
`type`	string	Tipo de comprobante (`DEBIT_NOTE`)

Consulta el progreso con GET /v1/developer/receipts/{id}/status.

Retenciones

Emisión de comprobantes de retención electrónica (codDoc 07) autorizados por el SRI.

Emitir retención

POST /v1/developer/withholdings

Emite un comprobante de retención vinculado a una factura ya autorizada, identificada por su clave de acceso de 49 dígitos.

Request body

{
  "invoiceAccessKey": "2312202301179214289100110010020000001231234567811",
  "taxes": [
    {
      "taxType": "RENTA",
      "taxRateCode": "303",
      "taxRate": 10,
      "taxBase": 1000.00
    },
    {
      "taxType": "IVA",
      "taxRateCode": "725",
      "taxRate": 30,
      "taxBase": 150.00
    }
  ],
  "additionalInfo": {}
}

Campo	Tipo	Requerido	Descripción
`invoiceAccessKey`	string	Sí	Clave de acceso de 49 dígitos de la factura sustento
`taxes`	array	Sí	Impuestos a retener
`additionalInfo`	object	No	Campos adicionales clave-valor

Cada entrada de taxes lleva:

Campo	Tipo	Requerido	Descripción
`taxType`	enum	Sí	`RENTA` o `IVA`
`taxRateCode`	string	Sí	Código SRI de la retención (ej: `303` renta, `725` IVA 30%)
`taxRate`	number	Sí	Porcentaje de retención
`taxBase`	number	Sí	Base imponible sobre la que se calcula

Respuesta `201 Created`

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0712202404179214289100110010070000001231234567817",
    "sequential": "000000001",
    "status": "PROCESSING"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Listar retenciones

GET /v1/developer/withholdings

Lista las retenciones emitidas con paginación. Filtros: page, limit, ruc (RUC o cédula del proveedor), status, dateFrom, dateTo.

Consultar, descargar y anular

Una vez emitida, usa los endpoints genéricos de comprobantes:

GET  /v1/developer/receipts/:id           # Detalle
GET  /v1/developer/receipts/:id/status    # Estado
GET  /v1/developer/receipts/:id/xml       # XML autorizado
GET  /v1/developer/receipts/:id/pdf       # PDF RIDE
POST /v1/developer/receipts/:id/void      # Anular (solo a nivel sistema)

Firmar XML

Si tu sistema ya genera el XML de retención sin firmar, puedes enviarlo a Factuplan para que lo firme con tu certificado y lo autorice ante el SRI.

Paso 1 — Importar la factura vinculada (si no existe en Factuplan)

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/invoices/import \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "accessKey": "0102202401179213650600120010010000000011234567813" }'

Paso 2 — Firmar y autorizar el XML de la retención

curl -X POST https://api-rest.factuplan.com.ec/v1/developer/sign-and-authorize \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001" \
  -H "Content-Type: application/json" \
  -d '{ "xml": "<comprobanteRetencion>...</comprobanteRetencion>" }'

Respuesta 201 Created

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0712202404179214289100110010070000001231234567817",
    "status": "PROCESSING",
    "type": "WITHHOLDING"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Campo	Tipo	Descripción
`id`	string	ID interno del comprobante en Factuplan
`accessKey`	string	Clave de acceso SRI de 49 dígitos
`status`	string	Estado inicial (`PROCESSING`)
`type`	string	Tipo de comprobante (`WITHHOLDING`)

Consulta el progreso con GET /v1/developer/receipts/{id}/status.

Guías de remisión

Emisión de guías de remisión electrónicas (codDoc 06) autorizadas por el SRI. El sistema genera el XML, lo firma con tu certificado P12 y lo autoriza ante el SRI de forma asíncrona.

Emitir guía de remisión

POST /v1/developer/waybills

Request body

{
  "emissionPointId": "ep_id (opcional)",
  "customer": {
    "identificationType": "RUC",
    "identification": "0993378150001",
    "legalName": "Empresa Demo S.A.",
    "email": "facturas@empresademo.ec"
  },
  "transporterRuc": "0950194407001",
  "transporterName": "Transportes Demo S.A.",
  "vehiclePlate": "ABC-1234",
  "departureAddress": "Av. de las Américas, Guayaquil",
  "transportStartDate": "2026-06-10",
  "transportEndDate": "2026-06-11",
  "items": [
    {
      "code": "PROD-001",
      "description": "Descripción de la mercadería",
      "quantity": 10
    }
  ],
  "destinations": [
    {
      "receiverIdentification": "0993378150001",
      "receiverName": "Empresa Receptora S.A.",
      "address": "Av. Amazonas, Quito",
      "transferReason": "Venta de mercadería",
      "codDocSustento": "01",
      "numDocSustento": "001-001-000000001"
    }
  ],
  "additionalInfo": {}
}

Campo	Tipo	Requerido	Descripción
`emissionPointId`	string	No	UUID del punto de emisión (auto-detección si se omite)
`customer`	object	Sí	Destinatario principal: misma estructura que en facturas
`transporterRuc`	string	Sí	RUC del transportista
`transporterName`	string	Sí	Nombre o razón social del transportista
`vehiclePlate`	string	Sí	Placa del vehículo (ej: `ABC-1234`)
`departureAddress`	string	Sí	Dirección del punto de partida
`transportStartDate`	string	Sí	Fecha de inicio del transporte (ISO 8601)
`transportEndDate`	string	Sí	Fecha de fin del transporte (ISO 8601)
`items`	array	Sí	Mercadería transportada: `code`, `description`, `quantity`
`destinations`	array	Sí	Puntos de entrega (ver tabla siguiente)
`additionalInfo`	object	No	Campos adicionales clave-valor

Cada entrada de destinations lleva:

Campo	Tipo	Requerido	Descripción
`receiverIdentification`	string	Sí	RUC o cédula del destinatario
`receiverName`	string	Sí	Nombre del destinatario
`address`	string	Sí	Dirección de destino
`transferReason`	string	Sí	Motivo del traslado (ej: “Venta de mercadería”)
`codDocSustento`	string	No	Código del documento sustento (ej: `01` factura)
`numDocSustento`	string	No	Número del documento sustento (ej: `001-001-000000001`)

Respuesta `201 Created`

{
  "data": {
    "id": "rcpt_01HABCDEF",
    "accessKey": "0612202404179214289100110010060000001231234567816",
    "sequential": "000000001",
    "status": "PROCESSING"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Listar guías de remisión

GET /v1/developer/waybills

Query parameters

Parámetro	Tipo	Default	Notas
`page`	number	`1`	Página solicitada.
`limit`	number	`20`	Elementos por página (máx. `100`).
`search`	string	—	Búsqueda general (secuencial, clave de acceso, destinatario).
`status`	enum	—	`PROCESSING`, `AUTHORIZED`, `REJECTED`, `VOIDED`, `ERROR`.
`dateFrom`	string	—	Fecha de inicio ISO 8601 (ej: `2026-01-01`).
`dateTo`	string	—	Fecha de fin ISO 8601 (ej: `2026-12-31`).

Consultar, descargar y anular

Una vez emitida, usa los endpoints genéricos de comprobantes:

GET  /v1/developer/receipts/:id           # Detalle
GET  /v1/developer/receipts/:id/status    # Estado
GET  /v1/developer/receipts/:id/xml       # XML autorizado
GET  /v1/developer/receipts/:id/pdf       # PDF RIDE
POST /v1/developer/receipts/:id/void      # Anular (solo a nivel sistema)

Importante: la anulación marca la guía como VOIDED solo en Factuplan. La anulación ante el SRI es responsabilidad del emisor.

Anular comprobante

POST /v1/developer/receipts/{id}/void
x-taxpayer-ruc: 0950194407001

Anula un comprobante a nivel del sistema. El estado pasa a VOIDED. Solo se pueden anular comprobantes en estado AUTHORIZED o COMPLETED.

Importante: la anulación ante el SRI la debe gestionar el desarrollador de forma independiente. Este endpoint únicamente cambia el estado en Factuplan.

Parámetros de ruta

Parámetro	Descripción
`id`	ID del comprobante a anular.

Body JSON

{
  "reason": "Error en los datos del cliente"
}

Campo	Tipo	Requerido	Descripción
`reason`	string	sí	Motivo de la anulación. Obligatorio.

Respuesta `200 OK`

{
  "data": {
    "id": "01964ac3-7b2e-7e45-a9f2-2c3f4d5e6f7a",
    "status": "VOIDED",
    "accessKey": "2405202501179261786900110010010000000011234567816",
    "voidReason": "Error en los datos del cliente",
    "message": "Comprobante anulado correctamente"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-13T12:34:56.789Z" }
}

Actualizar secuencial de facturas

Establece el próximo número secuencial para facturas en un punto de emisión específico. El nuevo valor entra en efecto en el siguiente comprobante emitido.

PATCH /v1/developer/invoices/sequential
X-API-Key: ak_live_tu_api_key
x-taxpayer-ruc: 0950194407001
Content-Type: application/json

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
`branchCode`	string	sí	Código del establecimiento (3 dígitos, ej: `"001"`)
`emissionCode`	string	sí	Código del punto de emisión (3 dígitos, ej: `"001"`)
`invoiceSequential`	integer	sí	Nuevo valor del secuencial (≥ 0)

{
  "branchCode": "001",
  "emissionCode": "001",
  "invoiceSequential": 100
}

Respuesta `200 OK`

{
  "data": {
    "branchCode": "001",
    "emissionCode": "001",
    "invoiceSequential": 100,
    "updatedAt": "2026-05-26T15:00:00.000Z"
  },
  "meta": { "requestId": "req_1a2b3c", "timestamp": "2026-05-26T15:00:00.000Z" }
}

Nota: Este endpoint afecta únicamente el secuencial de facturas. Para notas de crédito y notas de débito usa PATCH /v1/developer/credit-notes/sequential y PATCH /v1/developer/debit-notes/sequential (mismo contrato, con creditNoteSequential / debitNoteSequential).

Errores

Todos los endpoints devuelven el mismo formato de error:

{
  "statusCode": 422,
  "message": "Customer identification is invalid",
  "code": "INVOICE_4002",
  "details": [
    "identification must be a 13-digit RUC"
  ]
}

Códigos frecuentes

Código	HTTP	Descripción
`AUTH_ERROR`	401	API key inválida o expirada.
`RATE_LIMIT`	429	Límite de solicitudes excedido.
`API_10001`	403	Plan no compatible con la operación.
`API_10002`	429	Cuota mensual excedida.
`INVOICE_4002`	422	Datos del cliente inválidos.
`INVOICE_4003`	422	Detalle de factura vacío.
`CERT_3008`	422	Certificado expirado.
`CUSTOMER_7004`	409	Cliente duplicado.
`PRODUCT_6002`	409	Código de producto duplicado.
`GENERAL_0003`	429	Rate limit por velocidad.

Rate limit

Cada API key tiene dos límites:

Velocidad: 100 peticiones por segundo por API key.
Cuota mensual: depende del plan contratado (consulta /precios).

Si superas cualquiera de los dos, recibes HTTP 429.

Respuesta al superar el límite de velocidad

{
  "statusCode": 429,
  "code": "GENERAL_0003",
  "message": "Has superado el límite de peticiones. Intenta de nuevo en unos segundos."
}

Respuesta al superar la cuota mensual

{
  "statusCode": 429,
  "code": "API_10002",
  "message": "Has alcanzado el límite mensual de 500 documentos.",
  "details": { "used": 500, "quota": 500 }
}

Manejo recomendado con reintentos

Implementa espera exponencial (500ms → 1s → 2s → 4s…) y un máximo de reintentos por petición. Ejemplo en Python con requests:

import os, time, requests

API = "https://api-rest.factuplan.com.ec/v1/developer"
HEADERS = {
    "X-API-Key": os.environ["FACTUPLAN_API_KEY"],
    "x-taxpayer-ruc": "0950194407001",
    "Content-Type": "application/json",
}

def emit_invoice(body, intentos=3):
    for i in range(intentos):
        r = requests.post(f"{API}/invoices", json=body, headers=HEADERS, timeout=30)
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()
        time.sleep(0.5 * (2 ** i))
    r.raise_for_status()

Webhooks

Antes de procesar un evento webhook, verifica que el comprobante exista y consulta su estado actual con GET /v1/developer/receipts/{id}. Esto evita que actualices tu base de datos con eventos manipulados o duplicados.

curl https://api-rest.factuplan.com.ec/v1/developer/receipts/$RECEIPT_ID \
  -H "X-API-Key: $FACTUPLAN_API_KEY" \
  -H "x-taxpayer-ruc: 0950194407001"

Tip: llama a este endpoint apenas recibes un evento webhook. Confirma que el comprobante existe antes de actualizar tu BD o disparar notificaciones a tus usuarios.

¿Necesitas ayuda integrando el API? Escríbenos a info@factuplan.com.ec o desde el Centro de ayuda. Si prefieres Node.js o TypeScript, te ahorra trabajo el SDK oficial.

API REST de facturación electrónica Ecuador

Inicio

Instalación

Crear una API key

Prueba rápida con cURL

Autenticación

Convenciones

Sobre de respuesta

Sobre de error

Postman

Comprobantes

Emitir comprobante (Modo A)

Request body

Campos del customer

Campos de cada item

Punto de emisión

Tarifas de IVA (tax)

Formas de pago (payments)

Respuesta 201 Created

Ejemplo con cURL

Listar facturas

Query parameters

Respuesta 200 OK

Importar comprobante por clave de acceso

Request body

Respuesta 201 Created

Firmar y autorizar XML (Modo B)

Firmar XML sin enviar al SRI (Modo C)

Validar estructura de XML

Consultar comprobantes

Consultar comprobante externo por clave de acceso

Request body

Obtener detalle del comprobante

Respuesta 200 OK

Consultar estado del comprobante

Respuesta 200 OK

Descargar XML autorizado

Respuesta 200 OK

Descargar PDF (RIDE)

Respuesta 200 OK

Clientes

Crear cliente

Request body

Respuesta 201 Created

Listar clientes

Query parameters

Respuesta 200 OK

Obtener cliente

Actualizar cliente

Eliminar cliente

Respuesta 200 OK

Productos

Crear producto o servicio

Request body

Listar productos

Query parameters

Obtener, actualizar y eliminar

Uso & Cuota

Respuesta 200 OK

Certificado digital

Respuesta 200 OK

Subir firma electrónica (P12)

Campos del body (multipart/form-data)

Ejemplo con cURL

Respuesta 200 OK

Notas de crédito

Emitir nota de crédito

Listar notas de crédito

Consultar, descargar y anular

Actualizar secuencial de notas de crédito

Firmar XML

Notas de débito

Emitir nota de débito

Request body

Respuesta 201 Created

Listar notas de débito

Consultar, descargar y anular

Actualizar secuencial de notas de débito

Firmar XML

Retenciones

Campos del `customer`

Campos de cada `item`

Tarifas de IVA (`tax`)

Formas de pago (`payments`)

Respuesta `201 Created`

Respuesta `200 OK`

Respuesta `201 Created`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `201 Created`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `200 OK`

Respuesta `201 Created`

Respuesta `201 Created`

Respuesta `201 Created`

Respuesta `200 OK`

Respuesta `200 OK`