Emitir una factura por la API con la api_key del punto de emisión

Para qué sirve

La API de emisión directa permite que tu tienda en línea, tu ERP o tu propio programa emitan comprobantes electrónicos sin entrar al sistema. Cada llamada crea el comprobante y lo envía al SRI.

Antes de empezar

• Tu plan debe incluir uso de API. Los planes de entrada solo emiten desde la web.
• La empresa debe tener la firma electrónica cargada.
• Necesitas la api_key de emisión del punto de emisión (empieza con API_). Cada punto tiene la suya y define la empresa, el establecimiento, el punto y el ambiente (pruebas o producción). La ves en el pie de página → Extras → Detalle de cuenta, estando conectado a ese punto. Solo el dueño de la cuenta ve esa api_key ahí; los vendedores no la ven.

Emitir una factura

Envía un POST con Content-Type: application/json a:

https://(la dirección con la que entras al sistema)/plataforma/api/v2/factura/emision

El cuerpo JSON lleva:

• api_key y codigoDoc = "01".
• emisor: fecha_emision con barras (aaaa/mm/dd, la de hoy) y manejo_interno_secuencia = "SI" (o tu propio secuencial).
• comprador: tipo_identificacion (04 RUC de 13 dígitos, 05 cédula de 10 dígitos, 06 pasaporte, 07 consumidor final), identificacion, razon_social, dirección, teléfono y correo. Para consumidor final usa 9999999999999 con tipo 07 (hasta USD 50).
• items: código, descripción, precio_unitario sin IVA, cantidad, descuento en dinero, tipoproducto (1 servicio, 2 producto) y tipo_iva (4 = 15 %, 0 = 0 %).
• pagos (opcional): código de forma de pago del SRI y total. Ej.: 01 sin utilización del sistema financiero, 20 otros con utilización del sistema financiero.
• informacion_adicional (opcional): pares nombre/detalle, por ejemplo el número de pedido.

Respuesta de éxito: creado = true, la claveacceso (49 dígitos, guárdala) y el número de factura (001-001-000000123).

Otros comprobantes

Con el mismo formato puedes emitir en /credito/emision (nota de crédito, con el bloque documento_modificado), /debito/emision, /guia/emision, /liquidacion/emision y /retencionats/emision.

Retenciones: usa /retencionats/emision (esquema 2.0, con documento sustento, el que exige el ATS). /retencion/emision (1.0) se mantiene solo por compatibilidad.

Funciones útiles

Secuencial automático

Con "manejo_interno_secuencia": "SI" el sistema asigna el siguiente secuencial del punto. Es lo recomendado: no tienes que llevar la numeración en tu tienda. Si envías tu propio secuencial y ya existe, la API lo rechaza.

api_key en la cabecera

Además del cuerpo JSON, puedes mandar la api_key en las cabeceras X-Api-Key, Api-Key o Authorization: Bearer. Si viene en ambos lugares, manda la del cuerpo.

Reembolsos de gastos

La factura admite el bloque reembolsos (fecha, proveedor, identificación, tipo y número del comprobante, autorización, bases e impuestos) para facturar reembolsos de gastos.

PDF tipo ticket

Si tu empresa tiene activado el PDF tipo POS, la respuesta incluye enlace_pdf_pos, un PDF en formato rollo para impresoras térmicas.

Fecha de emisión

El SRI solo acepta comprobantes transmitidos el mismo día de su fecha. Envía siempre la fecha de hoy, con barras (aaaa/mm/dd, por ejemplo 2026/10/04). Una fecha futura se rechaza con «La fecha de emision no puede ser mayor a la fecha actual». Si envías una fecha pasada, el sistema la reemplaza en silencio por la de hoy; como ese cambio no se informa en la respuesta, tu tienda puede quedar con una fecha distinta a la que el SRI autorizó, así que evita enviar fechas pasadas.

Errores comunes

«Ya existe un comprobante registrado con el mismo secuencial» / «Clave de Acceso Registrada»

Enviaste un secuencial que ya está usado en ese punto de emisión (la segunda variante indica que ese mismo comprobante ya existe con esa clave de acceso). La respuesta trae de todas formas la claveacceso: consulta el estado con ella en vez de reintentar la emisión. Usa el siguiente secuencial libre, o mejor, activa manejo_interno_secuencia = "SI" para que el sistema lo asigne.

«La fecha de envío al SRI debe ser el mismo día de la emisión del comprobante»

El reproceso de un comprobante de ayer solo se admite hasta las 00:10 del día siguiente. Pasado ese margen, emite un comprobante nuevo con la fecha de hoy.

La fecha de emisión debe ir con barras (aaaa/mm/dd)

En emisor.fecha_emision (y en la fecha de los reembolsos) el formato es con barras, por ejemplo 2026/10/04. Con guiones (2026-10-04) la validación la rechaza. Ten en cuenta que la API v2 (borradores, filtros como modificado_desde) usa el formato con guiones (aaaa-mm-dd): no es el mismo formato en los dos lados de la API.