Crear comprobante

POST/comprobantes/emitirscope: invoices.create + invoices.send_sunat

Crea una factura o boleta y la envía a SUNAT en la misma llamada. Por defecto (webhook: false) espera la respuesta de SUNAT antes de responder — ver la nota sobre el flag webhook más abajo.

Parámetros del body

webhook

boolean opcional

Si es true, la respuesta es inmediata (EN_PROCESO) y el resultado llega a tu webhook configurado. Si es false (por defecto), la llamada espera la respuesta de SUNAT antes de responder.

documento

object requerido

Datos del comprobante electrónico.

sunatTransaccion

string requerido

Código de tipo de operación SUNAT. Gravada: "0101" — ver la variante correspondiente para otros códigos.

tipoComprobante

"01" | "03" requerido

01 = factura, 03 = boleta.

serie

string requerido

Serie del comprobante. Facturas: F001–F999. Boletas: B001–B999.

moneda

"PEN" | "USD" requerido

Código de moneda.

formaPago

"CONTADO" | "CREDITO" requerido

Condición de pago.

fechaEmision

string (YYYY-MM-DD) requerido

Fecha de emisión.

fechaVencimiento

string (YYYY-MM-DD) opcional

Requerido si formaPago es CREDITO — fecha de la última cuota.

cliente

object requerido

Datos del cliente.

tipoDocumento

string requerido

Catálogo SUNAT 06 (ej. "1" = DNI, "6" = RUC).

numeroDocumento

string requerido

Número de documento del cliente.

denominacion

string requerido

Nombre o razón social del cliente.

direccion

string opcional

Dirección fiscal del cliente.

correo

string opcional

Correo del cliente — Facto le reenvía el comprobante (opcional).

items

array requerido

Ítems del comprobante.

descripcion

string requerido

Descripción del ítem.

unidadMedida

string requerido

Unidad de medida SUNAT (ej. NIU, ZZ).

cantidad

number requerido

Cantidad.

precioUnitario

number requerido

Precio unitario, IGV incluido.

tipoIgv

"10" | "20" | "30" | ... requerido

Código de afectación IGV — ver la tabla en Conceptos.

cuotas

array opcional

Requerido si formaPago es CREDITO — cronograma de pago. Facto asigna el número de cuota en la respuesta.

monto

number requerido

Monto de la cuota.

fechaVencimiento

string (YYYY-MM-DD) requerido

Fecha de vencimiento de la cuota.

data.entorno confirma si la key usada era test (aquí, demo) o live — ver Autenticación. data.documento.estado es el estado SUNAT del comprobante (ACEPTADA, EN_PROCESO o RECHAZADA) — Estados de documento. Cuando es ACEPTADA, data.enlaces trae los enlaces de descarga (pdf, pdfTicket, xml, cdr) y data.hash/data.cadenaQr/data.codigoBarras para la representación impresa.

Cada ítem de la respuesta trae valorUnitario (precio sin IGV) junto al precioUnitario que enviaste (con IGV) — en el ejemplo, 500 × 1.18 = 590.

Pago a crédito (documento.cuotas[])

Si documento.formaPago es "CREDITO", agrega documento.fechaVencimiento (fecha de la última cuota) y documento.cuotas[] con el cronograma de pago. Cada cuota solo necesita monto y fechaVencimiento — Facto asigna el numero de cuota en la respuesta. Ver Factura al crédito para un ejemplo completo.

Si el envío a SUNAT falla después de crear

El comprobante puede quedar creado en Facto aunque la transmisión a SUNAT falle (por ejemplo, un problema al leer la respuesta de SUNAT). En ese caso la respuesta no sigue el envelope estándar de Errores — trae estos campos propios del escenario:

Comprobante creado, envío a SUNAT falló

{
  "success": false,
  "code": "INVOICE_SEND_FAILED_AFTER_CREATE",
  "message": "El comprobante se creó pero el envío a SUNAT falló.",
  "error": "SUNAT send failed: extracting CDR from response: could not find applicationResponse or content node in the XML response",
  "comprobante_id": "60f2c04c-61cc-4a9e-84fb-45db67c5fcb9",
  "reintentar_en": "/invoices/60f2c04c-61cc-4a9e-84fb-45db67c5fcb9/send"
}

Campo	Descripción
`code`	`INVOICE_SEND_FAILED_AFTER_CREATE` — el comprobante sí se creó.
`comprobante_id`	Id del comprobante ya creado — no vuelvas a crearlo, reintenta el envío.
`error`	Detalle técnico de la falla (para logs/soporte).
`message`	Mensaje legible para mostrar al usuario.
`reintentar_en`	Ruta para reintentar solo el envío, sin crear un comprobante nuevo.

Reintenta con un POST a la ruta indicada en reintentar_en (/invoices/{id}/send) — reutiliza el mismo comprobante_id, evitando duplicar el correlativo.

Variantes de factura

El mismo endpoint cubre distintos escenarios de facturación — solo cambia el payload. Cada uno tiene su propia página con ejemplo en la barra lateral, bajo Facturas. Los marcados Pronto ahí todavía no tienen campos en la API — la página explica qué falta.

Notas de crédito y débito

Son recursos aparte de /comprobantes/emitir — ver Documentos.

{ "webhook": false, "documento": { "sunatTransaccion": "0101", "tipoComprobante": "01", "serie": "F001", "moneda": "PEN", "formaPago": "CONTADO", "fechaEmision": "2026-09-17", "cliente": { "tipoDocumento": "6", "numeroDocumento": "20112273922", "denominacion": "TIENDAS DEL MEJORAMIENTO DEL HOGAR S.A.", "direccion": "AV. ANGAMOS ESTE NRO. 1805 INT. 2 - LIMA - LIMA - SURQUILLO", "correo": "cliente@empresa.com" }, "items": [ { "unidadMedida": "NIU", "descripcion": "Servicio de consultoría", "cantidad": 2, "precioUnitario": 590, "tipoIgv": "10" } ] } }

{ "success": true, "message": "La Factura número F001-00000001, ha sido aceptada.", "data": { "estado": "ACEPTADA", "entorno": "demo", "documento": { "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84", "estado": "ACEPTADA", "serie": "F001", "correlativo": "F001-00000001", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0101", "fechaEmision": "2026-09-17", "fechaVencimiento": "2026-09-17", "moneda": "PEN", "formaPago": "CONTADO", "cliente": { "tipoDocumento": "6", "numeroDocumento": "20112273922", "denominacion": "TIENDAS DEL MEJORAMIENTO DEL HOGAR S.A.", "direccion": "AV. ANGAMOS ESTE NRO. 1805 INT. 2 - LIMA - LIMA - SURQUILLO", "correo": "cliente@empresa.com" }, "totales": { "gravada": 1000, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "isc": 0, "igv": 180, "impuestoBolsa": 0, "otrosCargos": 0, "total": 1180 }, "items": [ { "codigo": "", "descripcion": "Servicio de consultoría", "unidad": "NIU", "cantidad": 2, "valorUnitario": 500, "precioUnitario": 590, "descuento": 0, "subtotal": 1000, "tipoIgv": "10", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 180, "total": 1180 } ], "guias": [], "cuotas": [] }, "sunat": { "estado": "ACEPTADA", "codigo": "0", "mensaje": "La Factura numero F001-00000001 ha sido aceptada", "notas": [] }, "enlaces": { "pdf": "https://api.facto.com.pe/api/v1/invoices/83ad82a0-680e-11f1-8e35-2d93ac0f2c84/pdf", "pdfTicket": "https://api.facto.com.pe/api/v1/invoices/83ad82a0-680e-11f1-8e35-2d93ac0f2c84/pdf?formato=ticket", "xml": "https://api.facto.com.pe/api/v1/invoices/83ad82a0-680e-11f1-8e35-2d93ac0f2c84/xml", "cdr": "https://api.facto.com.pe/api/v1/invoices/83ad82a0-680e-11f1-8e35-2d93ac0f2c84/cdr" }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|01|F001|00000001|180|1180|2026-09-17|6|20112273922|", "codigoBarras": "20601234567|01|F001|00000001|180|1180|2026-09-17|6|20112273922|" } }

{ "success": true, "message": "El documento está siendo procesado por SUNAT. Recibirás una notificación en tu webhook o puedes consultar el estado en el enlace adjunto.", "data": { "entorno": "demo", "documento": { "id": "7111d8e0-6891-11f1-ab2a-23413cd2ac7c", "estado": "EN_PROCESO", "serie": "F001", "correlativo": "F001-00000001", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0101", "fechaEmision": "2026-09-17", "fechaVencimiento": "2026-09-17", "moneda": "PEN", "formaPago": "CONTADO", "cliente": { "tipoDocumento": "6", "numeroDocumento": "20112273922", "denominacion": "TIENDAS DEL MEJORAMIENTO DEL HOGAR S.A.", "direccion": "AV. ANGAMOS ESTE NRO. 1805 INT. 2 - LIMA - LIMA - SURQUILLO", "correo": "cliente@empresa.com" }, "totales": { "gravada": 1000, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "isc": 0, "igv": 180, "impuestoBolsa": 0, "otrosCargos": 0, "total": 1180 }, "items": [ { "codigo": "", "descripcion": "Servicio de consultoría", "unidad": "NIU", "cantidad": 2, "valorUnitario": 500, "precioUnitario": 590, "descuento": 0, "subtotal": 1000, "tipoIgv": "10", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 180, "total": 1180 } ], "guias": [], "cuotas": [] }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/7111d8e0-6891-11f1-ab2a-23413cd2ac7c" } } }

Parámetros del body

webhook

boolean opcional

Si es true, la respuesta es inmediata (EN_PROCESO) y el resultado llega a tu webhook configurado. Si es false (por defecto), la llamada espera la respuesta de SUNAT antes de responder.

documento

object requerido

Datos del comprobante electrónico.

sunatTransaccion

string requerido

Código de tipo de operación SUNAT. Gravada: "0101" — ver la variante correspondiente para otros códigos.

tipoComprobante

"01" | "03" requerido

01 = factura, 03 = boleta.

serie

string requerido

Serie del comprobante. Facturas: F001–F999. Boletas: B001–B999.

moneda

"PEN" | "USD" requerido

Código de moneda.

formaPago

"CONTADO" | "CREDITO" requerido

Condición de pago.

fechaEmision

string (YYYY-MM-DD) requerido

Fecha de emisión.

fechaVencimiento

string (YYYY-MM-DD) opcional

Requerido si formaPago es CREDITO — fecha de la última cuota.

cliente

object requerido

Datos del cliente.

tipoDocumento

string requerido

Catálogo SUNAT 06 (ej. "1" = DNI, "6" = RUC).

numeroDocumento

string requerido

Número de documento del cliente.

denominacion

string requerido

Nombre o razón social del cliente.

direccion

string opcional

Dirección fiscal del cliente.

correo

string opcional

Correo del cliente — Facto le reenvía el comprobante (opcional).

items

array requerido

Ítems del comprobante.

descripcion

string requerido

Descripción del ítem.

unidadMedida

string requerido

Unidad de medida SUNAT (ej. NIU, ZZ).

cantidad

number requerido

Cantidad.

precioUnitario

number requerido

Precio unitario, IGV incluido.

tipoIgv

"10" | "20" | "30" | ... requerido

Código de afectación IGV — ver la tabla en Conceptos.

cuotas

array opcional

Requerido si formaPago es CREDITO — cronograma de pago. Facto asigna el número de cuota en la respuesta.

monto

number requerido

Monto de la cuota.

fechaVencimiento

string (YYYY-MM-DD) requerido

Fecha de vencimiento de la cuota.

Cada ítem de la respuesta trae valorUnitario (precio sin IGV) junto al precioUnitario que enviaste (con IGV) — en el ejemplo, 500 × 1.18 = 590.

Si el envío a SUNAT falla después de crear

Comprobante creado, envío a SUNAT falló

{
  "success": false,
  "code": "INVOICE_SEND_FAILED_AFTER_CREATE",
  "message": "El comprobante se creó pero el envío a SUNAT falló.",
  "error": "SUNAT send failed: extracting CDR from response: could not find applicationResponse or content node in the XML response",
  "comprobante_id": "60f2c04c-61cc-4a9e-84fb-45db67c5fcb9",
  "reintentar_en": "/invoices/60f2c04c-61cc-4a9e-84fb-45db67c5fcb9/send"
}

Campo

Descripción

code

INVOICE_SEND_FAILED_AFTER_CREATE — el comprobante sí se creó.

comprobante_id

Id del comprobante ya creado — no vuelvas a crearlo, reintenta el envío.

error

Detalle técnico de la falla (para logs/soporte).

message

Mensaje legible para mostrar al usuario.

reintentar_en

Ruta para reintentar solo el envío, sin crear un comprobante nuevo.

Reintenta con un POST a la ruta indicada en reintentar_en (/invoices/{id}/send) — reutiliza el mismo comprobante_id, evitando duplicar el correlativo.

Variantes de factura

Notas de crédito y débito

Son recursos aparte de /comprobantes/emitir — ver Documentos.