POST/comprobantes/emitirscope: invoices.create

Factura de exportación

documento.sunatTransaccion "0200" (exportación de bienes o servicios). Los ítems usan tipoIgv "40" — no afectos a IGV, su monto va a totales.exportacion en vez de totales.gravada.

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.

El cliente extranjero usa tipoDocumento "B" (catálogo SUNAT 06 — documento tributario del país de residencia, sin RUC). No es obligatorio enviar documento.tipoCambio aunque moneda sea "USD" — a diferencia de Factura en dólares, una exportación no convierte el total a soles.

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

{ "webhook": false, "documento": { "sunatTransaccion": "0200", "tipoComprobante": "01", "serie": "F001", "moneda": "USD", "formaPago": "CONTADO", "fechaEmision": "2026-11-06", "cliente": { "tipoDocumento": "B", "numeroDocumento": "EXT123456", "denominacion": "FOREIGN CLIENT LLC", "direccion": "123 Main St, Miami, FL" }, "items": [ { "unidadMedida": "NIU", "descripcion": "SERVICIO DE EXPORTACION", "cantidad": 1, "precioUnitario": 500, "tipoIgv": "40" } ] } }

{ "success": true, "message": "La Factura numero F001-00000079, ha sido aceptada", "data": { "entorno": "demo", "documento": { "id": "0da78a97-8bd1-44e9-8928-08fc7f144a6d", "estado": "ACEPTADA", "serie": "F001", "correlativo": "F001-00000079", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0200", "fechaEmision": "2026-11-06", "moneda": "USD", "formaPago": "contado", "cliente": { "tipoDocumento": "B", "numeroDocumento": "EXT123456", "denominacion": "FOREIGN CLIENT LLC", "direccion": "123 Main St, Miami, FL" }, "totales": { "gravada": 0, "exonerada": 0, "inafecta": 0, "exportacion": 500, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "SERVICIO DE EXPORTACION", "unidad": "NIU", "cantidad": 1, "valorUnitario": 500, "precioUnitario": 500, "descuento": 0, "subtotal": 500, "tipoIgv": "40", "tipoIgvDescripcion": "", "igv": 0, "total": 500 } ], "guias": [], "cuotas": [], "sunat": { "codigo": "0", "mensaje": "La Factura numero F001-00000079, ha sido aceptada", "notas": [] }, "hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=", "cadenaQr": "20601234567|01|F001|00000079|0.00|500.00|2026-11-06|B|EXT123456|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|01|F001|00000079|0.00|500.00|2026-11-06|B|EXT123456|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/cdr" } } }

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

{ "success": false, "message": "Los datos enviados no son válidos.", "errors": { "documento.items[].tipoIgv": "Los ítems de una operación de exportación (sunatTransaccion \"0200\") deben usar tipoIgv \"40\"." } }

{ "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-00000079", "tipo": "FACTURA", "tipoCodigo": "01", "sunatTransaccion": "0200", "fechaEmision": "2026-11-06", "moneda": "USD", "formaPago": "contado", "cliente": { "tipoDocumento": "B", "numeroDocumento": "EXT123456", "denominacion": "FOREIGN CLIENT LLC", "direccion": "123 Main St, Miami, FL" }, "totales": { "gravada": 0, "exonerada": 0, "inafecta": 0, "exportacion": 500, "gratuita": 0, "descuento": 0, "anticipo": 0, "descuentoGlobal": 0, "descuentoGlobalAfectaBase": false, "isc": 0, "igv": 0, "impuestoBolsa": 0, "otrosCargos": 0, "total": 500 }, "items": [ { "codigo": "", "descripcion": "SERVICIO DE EXPORTACION", "unidad": "NIU", "cantidad": 1, "valorUnitario": 500, "precioUnitario": 500, "descuento": 0, "subtotal": 500, "tipoIgv": "40", "tipoIgvDescripcion": "", "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|01|F001|00000079|0.00|500.00|2026-11-06|B|EXT123456|xvQpVbLssRc8FlD8/0LuSYeIPo8=", "codigoBarras": "20601234567|01|F001|00000079|0.00|500.00|2026-11-06|B|EXT123456|xvQpVbLssRc8FlD8/0LuSYeIPo8=" }, "enlaces": { "consulta": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79", "pdf": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf", "pdfTicket80mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf?format=ticket_80mm", "pdfTicket58mm": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/pdf?format=ticket_58mm", "xml": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/xml", "cdr": "https://api.facto.com.pe/api/v1/comprobantes/01/F001/79/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.