POST/comprobantes/emitirscope: invoices.create

Boleta exonerada

Mismo endpoint que una boleta clásica — usa tipoIgv en el rango exonerado (20-21) en el ítem.

Parámetros del body

webhook

boolean opcional

Si es true, la llamada responde de inmediato (HTTP 202) con el comprobante en estado "pendiente_envio" y el resultado final llega a tu webhook configurado. Si es false (por defecto), la llamada espera la respuesta de SUNAT y devuelve el comprobante completo 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

"6" | "1" | "4" | "7" | "B" opcional

Catálogo SUNAT 06: "6" RUC, "1" DNI, "4" carné de extranjería, "7" pasaporte, "B" no domiciliado. Una factura exige RUC ("6"), salvo exportación con "B". En una boleta hasta S/ 700 puede omitirse junto con el número: se emite a cliente varios (DNI 00000000).

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. "17" (IVAP) no está soportado.

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.

Ver la referencia completa de campos y la tabla de códigos de afectación IGV en Conceptos.

{ "webhook": false, "documento": { "sunatTransaccion": "0101", "tipoComprobante": "03", "serie": "B001", "moneda": "PEN", "formaPago": "CONTADO", "fechaEmision": "2026-11-06", "cliente": { "tipoDocumento": "1", "numeroDocumento": "45678912", "denominacion": "JUAN PEREZ RAMIREZ", "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA" }, "items": [ { "unidadMedida": "NIU", "descripcion": "Servicio educativo", "cantidad": 1, "precioUnitario": 500, "tipoIgv": "20" } ] } }

{ "success": true, "message": "La Boleta numero B001-00000002, ha sido aceptada", "data": { "entorno": "demo", "documento": { "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84", "estado": "ACEPTADA", "serie": "B001", "correlativo": "B001-00000002", "tipo": "BOLETA", "tipoCodigo": "03", "sunatTransaccion": "0101", "fechaEmision": "2026-11-06", "moneda": "PEN", "formaPago": "contado", "cliente": { "tipoDocumento": "1", "numeroDocumento": "45678912", "denominacion": "JUAN PEREZ RAMIREZ", "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA" }, "totales": { "gravada": 0, "exonerada": 500, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "Servicio educativo", "unidad": "NIU", "cantidad": 1, "valorUnitario": 500, "precioUnitario": 500, "descuento": 0, "subtotal": 500, "tipoIgv": "20", "tipoIgvDescripcion": "EXONERADO - OPERACIÓN ONEROSA", "igv": 0, "total": 500 } ], "guias": [], "cuotas": [], "sunat": { "codigo": "0", "mensaje": "La Boleta numero B001-00000002, ha sido aceptada", "notas": [] }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|03|B001|00000002|0.00|500.00|2026-11-06|1|45678912|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|03|B001|00000002|0.00|500.00|2026-11-06|1|45678912|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/cdr" } } }

{ "success": true, "message": "Comprobante creado, envío a SUNAT en proceso", "data": { "invoice_id": "7111d8e0-6891-11f1-ab2a-23413cd2ac7c", "series": "B001", "correlativo": 2, "status": "pendiente_envio" } }

{ "success": false, "message": "Los datos enviados no son válidos.", "errors": { "documento.cliente.numeroDocumento": "El número de documento debe tener 8 dígitos para tipo DNI.", "documento.items": "El campo items es requerido." } }

{ "success": false, "message": "El número de RUC del emisor no existe.", "data": { "entorno": "demo", "documento": { "id": "9c948140-674e-11f1-85b5-d764057e10c4", "estado": "RECHAZADA", "serie": "B001", "correlativo": "B001-00000002", "tipo": "BOLETA", "tipoCodigo": "03", "sunatTransaccion": "0101", "fechaEmision": "2026-11-06", "moneda": "PEN", "formaPago": "contado", "cliente": { "tipoDocumento": "1", "numeroDocumento": "45678912", "denominacion": "JUAN PEREZ RAMIREZ", "direccion": "AV. LIMA 123 - LIMA - LIMA - LIMA" }, "totales": { "gravada": 0, "exonerada": 500, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "Servicio educativo", "unidad": "NIU", "cantidad": 1, "valorUnitario": 500, "precioUnitario": 500, "descuento": 0, "subtotal": 500, "tipoIgv": "20", "tipoIgvDescripcion": "EXONERADO - OPERACIÓN ONEROSA", "igv": 0, "total": 500 } ], "guias": [], "cuotas": [], "sunat": { "codigo": "2800", "mensaje": "El número de RUC del emisor no existe.", "notas": [] }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|03|B001|00000002|0.00|500.00|2026-11-06|1|45678912|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|03|B001|00000002|0.00|500.00|2026-11-06|1|45678912|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/03/B001/2/cdr" } } }

Parámetros del body

webhook

boolean opcional

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

"6" | "1" | "4" | "7" | "B" opcional

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. "17" (IVAP) no está soportado.

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.