Referencia de la API

Cada página de esta pestaña es un endpoint de la API de Facturalo: método, ruta, JSON que envías y JSON que vuelve. El paso a paso para empezar está en Guías.

El sidebar izquierdo es el índice de https://api.facturalo.pe/api/v3. No hay un host distinto para demo y producción: el entorno lo decide el token que envías.

Guías o esta pestaña

Guías te lleva de cero a tu primer comprobante aceptado. Aquí abres un endpoint concreto y ves sus campos, ejemplos de respuesta y el código para llamarlo.

Secciones

Sección	Para qué	Empieza por
Cuenta	Empresas emisoras, sus tokens y establecimientos	Listar empresas
Facturas	Emitir facturas y sus notas de crédito y débito, un caso por página	Factura gravada
Boletas	Emitir boletas y sus notas	Boleta gravada
Anular documento	Dar de baja facturas (RA) y boletas (RC)	Anular documento
Documentos	Consultar un comprobante con su detalle completo, su historial y listarlos	Consultar
Guía de remisión	Emitir guías remitente y transportista y consultarlas	Remitente — público
Webhook	Configurar tu URL, elegir eventos y ver los payloads	Payload de eventos
Consultas	RUC, DNI y tipo de cambio	RUC
SIRE	Registro de ventas (RVIE) y de compras (RCE)	Periodos de ventas

Lo que se repite en todas las llamadas

Autenticación: el token va en el header Authorization sin Bearer. user_sk_… para la sección Cuenta; sk_test_… (demo) o sk_live_… (producción) para todo lo demás. Detalle en Autenticación.
Formato de respuesta: siempre { success, message, data }. Los errores de validación responden 422 con errors por campo.
Correlativos a 8 dígitos en las respuestas (00000001), aunque los envíes sin ceros.
Envío síncrono o con webhook: con webhook: false (por defecto) la respuesta ya trae el resultado de SUNAT; con webhook: true responde 202 EN_PROCESO y el resultado llega a tu webhook.
Respuesta corta, consulta completa: enviar devuelve solo la identificación del comprobante, el resultado de SUNAT, los enlaces (PDF, XML, CDR), hash y cadenaQr. El detalle completo se obtiene con GET /documentos/{id} o GET /guias/{id}.

Base URLbash

https://api.facturalo.pe/api/v3

Tu primera factura

Con un token sk_test_… esto emite una factura en demo. Todos los campos están explicados en Factura gravada.

POST /documentos/enviarbash

-primary-dark)">curl -s https://api.facturalo.pe/api/v3/documentos/enviar \
  -H 'Authorization: sk_test_…' \
  -H 'Content-Type: application/json' \
  -d @factura.json

Factura gravada — cuerpo completo, respuesta y errores de POST /documentos/enviar
Estados — qué significa cada estado de SUNAT y de Facturalo
Errores — códigos HTTP y errores de SUNAT más comunes