API v3
Facturalo API
API REST para emisión de comprobantes electrónicos ante SUNAT (Perú). Soporta Facturas, Boletas, Notas de Crédito/Débito y Guías de Remisión. Los cálculos de IGV, subtotales y totales son automáticos — solo envía el precioUnitario y el tipoIgv.
Emitir factura
POST /documentos/enviarEmitir boleta
POST /documentos/enviarEmitir guía
POST /guia/enviarAutenticación
Hay dos tipos de token, ambos se envían en el header Authorization. El entorno (demo / producción) se detecta automáticamente del prefijo del token.
user_sk_...Token de usuario
Crear y gestionar empresas y establecimientos.
sk_test_...Token de empresa — Demo
Emitir documentos en entorno de pruebas SUNAT.
sk_live_...Token de empresa — Producción
Emitir documentos en producción SUNAT.
Headers de autenticaciónhttp
// Token de empresa — documentos y guías
Authorization: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
// Token de usuario — gestión de empresas y establecimientos
Authorization: user_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxEjemplo rápido
cURL — Factura normalbash
curl -X POST https://api.facturalo.pe/api/v3/documentos/enviar \
-H "Authorization: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"webhook": false,
"documento": {
"sunatTransaccion": "0101",
"tipoComprobante": "01",
"serie": "F001",
"correlativo": "1",
"fechaEmision": "2026-06-13",
"moneda": "PEN",
"formaPago": "CONTADO",
"cliente": {
"tipoDocumento": "6",
"numeroDocumento": "20609753413",
"denominacion": "TEC WORLD S.A.C.",
"direccion": "AV. LIMA 123, TRUJILLO"
},
"items": [{
"unidadMedida": "NIU",
"descripcion": "SERVICIO DE CONSULTORÍA",
"cantidad": 1,
"precioUnitario": 590,
"tipoIgv": "10"
}]
}
}'Características clave
Cálculos automáticosSolo envía precioUnitario y tipoIgv por ítem. La API calcula IGV, subtotales y totales automáticamente.
Entorno por tokenEl entorno (demo / producción) se detecta del token. sk_test_ = demo, sk_live_ = producción. No existe parámetro de entorno.
Síncrono o asíncronoCon "webhook": false (default) la respuesta incluye el resultado SUNAT. Con "webhook": true retorna EN_PROCESO y el resultado llega al webhook.
Archivos públicosLos endpoints /{id}.pdf, /{id}.xml y /{id}.cdr no requieren autenticación — son links compartibles directamente con el cliente.
Respuesta estructuradaTodas las respuestas exitosas siguen el mismo esquema: success, message, data. Dentro de data: estado, entorno, documento, sunat.notas, enlaces.
Códigos de respuesta HTTP
200OKPetición exitosa201CreatedRecurso creado (empresa, establecimiento)401UnauthorizedToken inválido o ausente422UnprocessableErrores de validación — revisa el campo errors500Server ErrorError interno del servidor