Emitir Factura

Esta guía muestra cómo emitir una factura electrónica (código 01 del SRI) con la API de Factio. La emisión es síncrona: la respuesta trae el resultado del SRI.

Requisitos Previos

Un emisor con certificado de firma electrónica (.p12) vigente.
Al menos un establecimiento y un punto de emisión.
Una API Key (fac_...).

1. Crear el request de emisión

Haz un POST a /documents. Factio asigna el secuencial automáticamente.

curl -X POST https://api.factioapp.com/documents \
  -H "X-API-Key: fac_TU_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 60 \
  -d '{
    "issuer_id": "TU_ISSUER_ID",
    "establishment_id": "TU_ESTABLISHMENT_ID",
    "emission_point_id": "TU_EMISSION_POINT_ID",
    "document_type": "01",
    "issue_date": "2026-10-20",
    "numeric_code": "12345678",
    "idempotency_key": "erp-factura-000123",
    "buyer_id_type": "04",
    "buyer_id": "1792146739001",
    "buyer_name": "Empresa de Pruebas S.A.",
    "buyer_email": "[email protected]",
    "subtotal": "100.00",
    "total_discount": "0.00",
    "total_tax": "15.00",
    "total": "115.00",
    "lines": [
      {
        "line_number": 1,
        "description": "Desarrollo de software",
        "quantity": "1",
        "unit_price": "100.00",
        "discount": "0.00",
        "subtotal": "100.00",
        "tax_code": "2",
        "tax_rate_code": "4"
      }
    ],
    "taxes": [
      {
        "tax_code": "2",
        "tax_rate_code": "4",
        "taxable_base": "100.00",
        "rate": "0.1500",
        "tax_amount": "15.00"
      }
    ],
    "payments": [
      {
        "line_number": 1,
        "payment_method_code": "20",
        "total": "115.00"
      }
    ]
  }'

Campos clave

Campo	Descripción
`document_type`	`"01"` indica que es una factura.
`issue_date`	Fecha de emisión en formato `YYYY-MM-DD`.
`numeric_code`	8 dígitos que eliges tú. Forman parte de la clave de acceso.
`idempotency_key`	Opcional, recomendado. Identificador único de la operación en tu sistema. Ver Idempotencia.
`buyer_id_type`	Tipo de identificación del comprador según la Ficha Técnica del SRI (por ejemplo `"04"` RUC, `"05"` cédula, `"07"` consumidor final).
`lines[]`	Detalle de la factura. `tax_code` `"2"` es IVA y `tax_rate_code` es la tarifa (por ejemplo `"4"` = 15 %).
`taxes[]`	Totales de impuestos por código y tarifa. `rate` va en decimal (`"0.1500"` = 15 %).
`payments[]`	Formas de pago según la tabla del SRI (por ejemplo `"20"` = otros con utilización del sistema financiero).

Los montos deben cuadrar: la suma de los subtotal de las líneas con el subtotal del documento, los impuestos con total_tax, y los pagos con total. Si no cuadran, la API o el SRI rechazan el comprobante.

2. Tiempo de respuesta

Factio genera el XML, lo firma, lo envía al SRI y consulta la autorización dentro de la misma petición. Si el SRI tiene una intermitencia breve, reintenta antes de responder. Configura un timeout de al menos 60 segundos.

Si tu cliente corta la conexión por timeout, no envíes un comprobante nuevo. Reenvía el mismo request con la misma idempotency_key: Factio devuelve el documento existente en lugar de crear otro.

3. Interpretar la respuesta

La respuesta siempre tiene este formato:

{
  "document_id": "0f6c1d52-8a3e-4b7a-9c21-5d4e7b8a1f90",
  "status": "AUTHORIZED",
  "action_taken": "authorized",
  "sri_messages": [],
  "authorization_number": "2010202601179214673900110010010000000011234567811",
  "authorization_date": "2026-10-20T15:30:00Z",
  "new_access_key": null
}

`action_taken`	HTTP	`status`	Qué significa
`authorized`	`200`	`AUTHORIZED`	El SRI autorizó el comprobante.
`devuelta`	`202`	`DEVUELTA`	El SRI lo devolvió en la recepción. Revisa `sri_messages`.
`rejected`	`202`	`REJECTED`	El SRI no lo autorizó. Revisa `sri_messages`.
`received_by_sri`	`202`	`PENDING_AUTHORIZATION`	El SRI lo recibió pero todavía no confirma la autorización.
`retry_scheduled`	`202`	`PENDING_AUTHORIZATION`	El SRI no respondió a tiempo después de los reintentos.
`unknown`	`202`	`PENDING_AUTHORIZATION`	El resultado del SRI fue ambiguo.

new_access_key solo viene informado cuando el SRI devolvió el error 45 y Factio tuvo que regenerar la clave de acceso. Para los casos pendientes, consulta Consultar Estado. Para devueltos y no autorizados, consulta Manejar Rechazos.

Introducción

Conceptos clave

Guías

Emitir Factura

Requisitos Previos

1. Crear el request de emisión

Campos clave

2. Tiempo de respuesta

3. Interpretar la respuesta

​Requisitos Previos

​1. Crear el request de emisión

​Campos clave

​2. Tiempo de respuesta

​3. Interpretar la respuesta

Requisitos Previos

1. Crear el request de emisión

Campos clave

2. Tiempo de respuesta

3. Interpretar la respuesta