Boleta de exportación
Boleta de exportación (sunatTransaccion: 0200, tipoIgv: 40). IGV 0%.
POSThttps://api.facturalo.pe/api/v3/documentos/enviar
Parámetros del body
webhookbooleanopcional
Si es true, la respuesta es inmediata (EN_PROCESO) y el resultado llega al webhook configurado. Default: false (síncrono).Ej:
falseestablecimientostring | nullopcional
UUID del establecimiento emisor. Si se omite, se usa el establecimiento principal de la empresa.
documentoobjectrequerido
Datos del comprobante electrónico.
sunatTransaccionstringrequerido
0200 = Exportación. Obligatorio para boletas de exportación.Ej:
0200tipoComprobantestringrequerido
03 = Boleta de venta.Ej:
03seriestringrequerido
Serie del comprobante. Facturas: F001–F999. Boletas: B001–B999. Exactamente 4 caracteres.Ej:
F001correlativostringrequerido
Correlativo numérico. Máximo 8 caracteres.Ej:
1fechaEmisionstringrequerido
Fecha de emisión en formato YYYY-MM-DD.Ej:
2026-06-13fechaVencimientostring | nullopcional
Fecha de vencimiento. Formato YYYY-MM-DD. Si no se envía, se toma la fechaEmision como fecha de vencimiento.
formaPagostringrequerido
"CONTADO" | "CREDITO". Si es CREDITO, se requiere el array cuotas.Ej:
CONTADOmonedastringrequerido
USD para exportaciones.Ej:
USDobservacionesstring | nullopcional
Texto libre que aparece en el comprobante.
placaVehiculostring | nullopcional
Placa del vehículo asociado a la operación.
ordenComprastring | nullopcional
Número de orden de compra del cliente.
descuentoGlobalnumber | nullopcional
Descuento global aplicado al total del documento (con IGV incluido).
enviarCorreobooleanopcional
Si es true, envía el PDF y XML al correo del cliente tras la aceptación. Default: false.Ej:
trueclienteobjectrequerido
Datos del adquirente.
tipoDocumentostringrequerido
6 = RUC · 1 = DNI · 0 = Sin documento (clientes varios).Ej:
6numeroDocumentostringrequerido
Número sin puntos ni guiones. RUC: 11 dígitos. DNI: 8 dígitos.Ej:
20609753413denominacionstringrequerido
Razón social o nombre completo.Ej:
TEC WORLD S.A.C.direccionstring | nullopcional
Requerida si tipoDocumento = 6 (RUC).
correostring | nullopcional
Correo del cliente para envío del PDF/XML.
celularstring | nullopcional
Número de celular. Exactamente 9 dígitos.
itemsarrayrequerido
Líneas del comprobante. Mínimo 1 ítem.
unidadMedidastringrequerido
Código SUNAT: NIU = unidad · ZZ = servicio · BX = caja · KGM = kilogramo · GLI = galón.Ej:
NIUcodigostring | nullopcional
Código interno del producto (max 30 caracteres).
descripcionstringrequerido
Descripción del producto o servicio (max 250 caracteres).Ej:
SERVICIO DE CONSULTORÍAcantidadnumberrequerido
Cantidad de unidades. Mínimo 0.Ej:
2precioUnitarionumberrequerido
Precio por unidad con IGV incluido. La API calcula el IGV automáticamente.Ej:
590tipoIgvstringrequerido
40 = Exportación. IGV es 0%.Ej:
40descuentonumber | nullopcional
Descuento por ítem (con IGV incluido).
impuestoBolsaboolean | nullopcional
Si es true, aplica ICBPER (impuesto a bolsas plásticas) a este ítem.
Boleta exportación — tipoIgv: 40json
{
"webhook": false,
"documento": {
"sunatTransaccion": "0200",
"tipoComprobante": "03",
"serie": "B001",
"correlativo": "1",
"fechaEmision": "2026-06-13",
"formaPago": "CONTADO",
"moneda": "USD",
"cliente": {
"tipoDocumento": "0",
"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"
}
]
}
}Respuesta exitosajson
{
"success": true,
"message": "La Boleta número B001-00000001, ha sido aceptada.",
"data": {
"estado": "ACEPTADA",
"entorno": "demo",
"documento": {
"id": "83ad82a0-680e-11f1-8e35-2d93ac0f2c85",
"estado": "ACEPTADA",
"serie": "B001",
"correlativo": "00000001",
"tipo": "BOLETA",
"tipoCodigo": "03",
"fechaEmision": "2026-06-13",
"fechaVencimiento": "2026-06-14",
"moneda": "USD",
"formaPago": "CONTADO",
"cliente": {
"tipoDocumento": "0",
"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,
"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": "EXPORTACION",
"igv": 0,
"total": 500
}
],
"guias": [],
"cuotas": []
},
"sunat": {
"estado": "ACEPTADA",
"codigo": "0",
"mensaje": "La Boleta numero B001-00000001 ha sido aceptada",
"notas": []
},
"enlaces": {
"pdf": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c85.pdf",
"xml": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c85.xml",
"cdr": "https://api.facturalo.pe/api/v3/documentos/83ad82a0-680e-11f1-8e35-2d93ac0f2c85.cdr"
},
"hash": "xvQpVbLssRc8FlD8/0LuSYeIPo8=",
"cadenaQr": "20601476551 | 03 | B001 | 00000001 | 13/06/2026 | 12345678 | 500.00 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |",
"codigoBarras": "20601476551 | 03 | B001 | 00000001 | 13/06/2026 | 12345678 | 500.00 | xvQpVbLssRc8FlD8/0LuSYeIPo8= |"
}
}200 — webhook: true (EN_PROCESO)json
{
"success": true,
"message": "El documento está siendo procesado por SUNAT. Recibirá una notificación en su webhook o puede consultar el estado en el enlace adjunto.",
"data": {
"entorno": "demo",
"documento": {
"id": "7111d8e0-6891-11f1-ab2a-23413cd2ac7d",
"estado": "EN_PROCESO",
"serie": "B001",
"correlativo": "00000001",
"tipo": "BOLETA",
"tipoCodigo": "03",
"fechaEmision": "2026-06-13",
"fechaVencimiento": "2026-06-15",
"moneda": "USD",
"formaPago": "CONTADO",
"cliente": {
"tipoDocumento": "0",
"numeroDocumento": "EXT123456",
"denominacion": "FOREIGN CLIENT LLC",
"direccion": "123 Main St, Miami, FL"
},
"totales": {
"gravada": 0,
"exonerada": 0,
"inafecta": 0,
"exportacion": 0,
"gratuita": 0,
"descuento": 0,
"anticipo": 0,
"isc": 0,
"igv": 0,
"impuestoBolsa": 0,
"otrosCargos": 0,
"total": 0
},
"items": [
{
"codigo": "",
"descripcion": "SERVICIO DE EXPORTACION",
"unidad": "NIU",
"cantidad": 1,
"valorUnitario": 500,
"precioUnitario": 500,
"descuento": 0,
"subtotal": 500,
"tipoIgv": "40",
"tipoIgvDescripcion": "EXPORTACION",
"igv": 0,
"total": 500
}
],
"guias": [],
"cuotas": []
},
"enlaces": {
"consulta": "https://api.facturalo.pe/api/v3/documentos/7111d8e0-6891-11f1-ab2a-23413cd2ac7d"
}
}
}422 — Error de validaciónjson
{
"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."
]
}
}200 — Rechazada por SUNATjson
{
"success": false,
"message": "El documento fue rechazado por SUNAT.",
"data": {
"estado": "RECHAZADA",
"entorno": "demo",
"documento": {
"id": "9c948140-674e-11f1-85b5-d764057e10c4",
"serie": "F001",
"correlativo": "1",
"tipo": "FACTURA"
},
"sunat": {
"codigo": "2800",
"mensaje": "El número de RUC del emisor no existe.",
"notas": []
}
}
}