POST/comprobantes/emitirscope: invoices.create

Anticipo — 1er pago

El primer pago (anticipo) no tiene campos especiales — es una factura normal por el monto adelantado.

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.

Guarda el tipoComprobante, serie y correlativo de la respuesta (documento.tipoComprobante / documento.serie / documento.correlativo) — los necesitas para aplicar este anticipo en la factura final, ver Anticipo — pago total.

{ "webhook": false, "documento": { "sunatTransaccion": "0101", "tipoComprobante": "01", "serie": "F001", "moneda": "PEN", "formaPago": "CONTADO", "fechaEmision": "2026-11-06", "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": "Anticipo — servicio de consultoría", "cantidad": 1, "precioUnitario": 500, "tipoIgv": "10" } ] } }

{ "success": true, "message": "La Factura numero F001-00000008, ha sido aceptada", "data": { "entorno": "demo", "documento": { "id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c84", "estado": "ACEPTADA", "serie": "F001", "correlativo": "F001-00000008", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0101", "fechaEmision": "2026-11-06", "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": 423.73, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 76.27, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "Anticipo — servicio de consultoría", "unidad": "NIU", "cantidad": 1, "valorUnitario": 423.73, "precioUnitario": 500, "descuento": 0, "subtotal": 423.73, "tipoIgv": "10", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 76.27, "total": 500 } ], "guias": [], "cuotas": [], "sunat": { "codigo": "0", "mensaje": "La Factura numero F001-00000008, ha sido aceptada", "notas": [] }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|01|F001|00000008|76.27|500.00|2026-11-06|6|20112273922|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|01|F001|00000008|76.27|500.00|2026-11-06|6|20112273922|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/cdr" } } }

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

{ "success": false, "message": "Los datos enviados no son válidos.", "errors": { "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 número de RUC del emisor no existe.", "data": { "entorno": "demo", "documento": { "id": "9c948140-674e-11f1-85b5-d764057e10c4", "estado": "RECHAZADA", "serie": "F001", "correlativo": "F001-00000008", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0101", "fechaEmision": "2026-11-06", "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": 423.73, "exonerada": 0, "inafecta": 0, "exportacion": 0, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 76.27, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "Anticipo — servicio de consultoría", "unidad": "NIU", "cantidad": 1, "valorUnitario": 423.73, "precioUnitario": 500, "descuento": 0, "subtotal": 423.73, "tipoIgv": "10", "tipoIgvDescripcion": "GRAVADO - OPERACIÓN ONEROSA", "igv": 76.27, "total": 500 } ], "guias": [], "cuotas": [], "sunat": { "codigo": "2800", "mensaje": "El número de RUC del emisor no existe.", "notas": [] }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|01|F001|00000008|76.27|500.00|2026-11-06|6|20112273922|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|01|F001|00000008|76.27|500.00|2026-11-06|6|20112273922|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/8/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.