Factura gratuita

POST/comprobantes/emitirscope: invoices.create

El tipoIgv por sí solo marca el ítem como gratuito — "13" (gravado, retiro por bonificación) deja el total de la línea en 0, aunque precioUnitario se conserva como valor referencial.

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.

Usa un tipoIgv del rango de retiro/bonificación (11-17, 21 o 31-37) — no "10", que es para operaciones onerosas. Ver la referencia completa de campos.

{ "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": "Muestra promocional", "cantidad": 5, "precioUnitario": 20, "tipoIgv": "21" } ] } }

{ "success": true, "message": "La Factura número F001-00000004, ha sido aceptada.", "data": { "estado": "ACEPTADA", "entorno": "demo", "documento": { "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84", "estado": "ACEPTADA", "serie": "F001", "correlativo": "F001-00000004", "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": 0, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 100, "descuento": 0, "anticipo": 0, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 100 }, "items": [ { "codigo": "", "descripcion": "Muestra promocional", "unidad": "NIU", "cantidad": 5, "valorUnitario": 20, "precioUnitario": 20, "descuento": 0, "subtotal": 100, "tipoIgv": "21", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 0, "total": 100 } ], "guias": [], "cuotas": [] }, "sunat": { "estado": "ACEPTADA", "codigo": "0", "mensaje": "La Factura numero F001-00000004 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|00000004|0|100|2026-09-17|6|20112273922|", "codigoBarras": "20601234567|01|F001|00000004|0|100|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-00000004", "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": 0, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 100, "descuento": 0, "anticipo": 0, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 100 }, "items": [ { "codigo": "", "descripcion": "Muestra promocional", "unidad": "NIU", "cantidad": 5, "valorUnitario": 20, "precioUnitario": 20, "descuento": 0, "subtotal": 100, "tipoIgv": "21", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 0, "total": 100 } ], "guias": [], "cuotas": [] }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/7111d8e0-6891-11f1-ab2a-23413cd2ac7c" } } }

{ "success": false, "error": { "code": "BAD_REQUEST", "message": "La solicitud tiene 2 errores de validación", "details": { "fields": { "documento.cliente.numeroDocumento": "El número de documento debe tener 11 dígitos para tipo RUC.", "documento.items": "El campo items es requerido." } } } }

{ "success": false, "message": "El documento fue rechazado por SUNAT.", "data": { "estado": "RECHAZADA", "entorno": "demo", "documento": { "id": "9c948140-674e-11f1-85b5-d764057e10c4", "serie": "F001", "correlativo": "F001-00000004", "tipo": "FACTURA" }, "sunat": { "codigo": "2800", "mensaje": "El número de RUC del emisor no existe.", "notas": [] } } }

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.

Usa un tipoIgv del rango de retiro/bonificación (11-17, 21 o 31-37) — no "10", que es para operaciones onerosas. Ver la referencia completa de campos.