# Facturalo API — Documentación

> Documentación de Facturalo API v3: emite facturas, boletas, notas de crédito y débito y guías de remisión ante SUNAT con JSON. IGV automático, PDF/XML/CDR, webhooks firmados con reintentos, idempotencia, SIRE (RVIE/RCE) y consultas RUC/DNI. Base URL https://api.facturalo.pe/api/v3.

Sitio: https://www.facturalo.pe
Docs: https://docs.facturalo.pe
API base: https://api.facturalo.pe/api/v3
Auth: header `Authorization` (ej. sk_test_…)
Cobertura: Perú. Moneda de cobro actual: PEN.
Última actualización: 2026-10-06

Versión extendida: https://docs.facturalo.pe/llms-full.txt
Sitemap: https://docs.facturalo.pe/sitemap.xml

## Licencia

Los sistemas de IA pueden indexar y citar esta documentación con fines informativos.
No uses el contenido para suplantar la marca ni para exfiltrar secretos de ejemplo como si fueran reales.

## Índice

### Esta referencia
- Cómo leerla: https://docs.facturalo.pe/referencia

### Introducción
- Primeros pasos: https://docs.facturalo.pe/introduccion
- Guía rápida: https://docs.facturalo.pe/guia-rapida
- Autenticación: https://docs.facturalo.pe/autenticacion
- Estados documento: https://docs.facturalo.pe/estados
- Errores: https://docs.facturalo.pe/errores
- Idempotencia: https://docs.facturalo.pe/idempotencia

### Cuenta
- GET Listar empresas: https://docs.facturalo.pe/empresas
- POST Crear empresa: https://docs.facturalo.pe/empresas/crear
- PATCH Actualizar empresa: https://docs.facturalo.pe/empresas/actualizar
- POST Regenerar token: https://docs.facturalo.pe/empresas/regenerar-token
- GET Listar establecimientos: https://docs.facturalo.pe/empresas/establecimientos
- POST Crear establecimiento: https://docs.facturalo.pe/empresas/establecimientos/crear
- PATCH Actualizar establecimiento: https://docs.facturalo.pe/empresas/establecimientos/actualizar

### Facturas
- POST Clásica (gravada): https://docs.facturalo.pe/documentos/factura/gravada
- POST Exonerada: https://docs.facturalo.pe/documentos/factura/exonerada
- POST Gratuita: https://docs.facturalo.pe/documentos/factura/gratuita
- POST Inafecta: https://docs.facturalo.pe/documentos/factura/inafecta
- POST Exportación: https://docs.facturalo.pe/documentos/factura/exportacion
- POST Al crédito: https://docs.facturalo.pe/documentos/factura/alcredito
- POST Descuento global: https://docs.facturalo.pe/documentos/factura/descuento-global
- POST Descuento por ítem: https://docs.facturalo.pe/documentos/factura/descuento-item
- POST ICBPER (bolsa): https://docs.facturalo.pe/documentos/factura/icbper
- POST Detracción: https://docs.facturalo.pe/documentos/factura/detraccion
- POST Retención: https://docs.facturalo.pe/documentos/factura/retencion
- POST Anticipo — 1er pago: https://docs.facturalo.pe/documentos/factura/anticipo-primer-pago
- POST Anticipo — pago total: https://docs.facturalo.pe/documentos/factura/anticipo-pago-total
- POST Con guía de remisión: https://docs.facturalo.pe/documentos/factura/guia-remision
- POST En dólares: https://docs.facturalo.pe/documentos/factura/dolares
- POST Nota de crédito (contado): https://docs.facturalo.pe/documentos/factura/nota-credito
- POST Nota de crédito (crédito): https://docs.facturalo.pe/documentos/factura/nota-credito-credito
- POST Nota de débito (contado): https://docs.facturalo.pe/documentos/factura/nota-debito
- POST Nota de débito (crédito): https://docs.facturalo.pe/documentos/factura/nota-debito-credito

### Boletas
- POST Clásica (gravada): https://docs.facturalo.pe/documentos/boleta/gravada
- POST Exonerada: https://docs.facturalo.pe/documentos/boleta/exonerada
- POST Gratuita: https://docs.facturalo.pe/documentos/boleta/gratuita
- POST Inafecta: https://docs.facturalo.pe/documentos/boleta/inafecta
- POST Exportación: https://docs.facturalo.pe/documentos/boleta/exportacion
- POST Al crédito: https://docs.facturalo.pe/documentos/boleta/alcredito
- POST Descuento global: https://docs.facturalo.pe/documentos/boleta/descuento-global
- POST Descuento por ítem: https://docs.facturalo.pe/documentos/boleta/descuento-item
- POST ICBPER (bolsa): https://docs.facturalo.pe/documentos/boleta/icbper
- POST Detracción: https://docs.facturalo.pe/documentos/boleta/detraccion
- POST Anticipo — 1er pago: https://docs.facturalo.pe/documentos/boleta/anticipo-primer-pago
- POST Anticipo — pago total: https://docs.facturalo.pe/documentos/boleta/anticipo-pago-total
- POST Con guía de remisión: https://docs.facturalo.pe/documentos/boleta/guia-remision
- POST En dólares: https://docs.facturalo.pe/documentos/boleta/dolares
- POST Nota de crédito (contado): https://docs.facturalo.pe/documentos/boleta/nota-credito
- POST Nota de crédito (crédito): https://docs.facturalo.pe/documentos/boleta/nota-credito-credito
- POST Nota de débito (contado): https://docs.facturalo.pe/documentos/boleta/nota-debito
- POST Nota de débito (crédito): https://docs.facturalo.pe/documentos/boleta/nota-debito-credito

### Anular documento
- POST Factura: https://docs.facturalo.pe/documento/anular/factura
- POST Boleta: https://docs.facturalo.pe/documento/anular/boleta

### Documentos
- GET Consultar: https://docs.facturalo.pe/documentos/consultar
- GET Eventos: https://docs.facturalo.pe/documentos/eventos
- GET Listar documentos: https://docs.facturalo.pe/documentos/listar

### Guía de Remisión
- POST Remitente — público: https://docs.facturalo.pe/guias/remitente-publico
- POST Remitente — privado: https://docs.facturalo.pe/guias/remitente-privado
- POST Transportista: https://docs.facturalo.pe/guias/transportista
- GET Consultar: https://docs.facturalo.pe/guias/consultar
- GET Eventos de guía: https://docs.facturalo.pe/guias/eventos
- POST Consultar ticket: https://docs.facturalo.pe/guias/ticket

### Webhook
- Introducción: https://docs.facturalo.pe/webhooks
- PATCH Actualizar webhook: https://docs.facturalo.pe/webhooks/actualizar
- GET Listar eventos: https://docs.facturalo.pe/webhooks/eventos
- PATCH Activar / desactivar eventos: https://docs.facturalo.pe/webhooks/eventos/actualizar
- GET Listar webhooks enviados: https://docs.facturalo.pe/webhooks/listar
- POST Reenviar webhook fallido: https://docs.facturalo.pe/webhooks/reenviar
- Payload de eventos: https://docs.facturalo.pe/webhooks/payload
  - documento.sunat.respuesta: https://docs.facturalo.pe/webhooks/payload/sunat-respuesta
  - documento.anulado: https://docs.facturalo.pe/webhooks/payload/anulado
  - documento.correo.enviado: https://docs.facturalo.pe/webhooks/payload/correo-enviado
  - documento.correo.fallido: https://docs.facturalo.pe/webhooks/payload/correo-fallido
  - guia.sunat.respuesta: https://docs.facturalo.pe/webhooks/payload/guia-respuesta
  - documento.error: https://docs.facturalo.pe/webhooks/payload/error

### Consultas
- Introducción: https://docs.facturalo.pe/consultas
- GET DNI: https://docs.facturalo.pe/consultas/dni
- GET RUC: https://docs.facturalo.pe/consultas/ruc
- GET RUC — Establecimientos: https://docs.facturalo.pe/consultas/ruc-establecimientos
- GET RUC — Representantes: https://docs.facturalo.pe/consultas/ruc-representantes
- GET Tipo de cambio: https://docs.facturalo.pe/consultas/tipo-cambio
- GET Placa: https://docs.facturalo.pe/consultas/placa
- GET Placa — SOAT: https://docs.facturalo.pe/consultas/placa-soat
- GET Licencia de conducir: https://docs.facturalo.pe/consultas/licencia

### SIRE
- Introducción: https://docs.facturalo.pe/sire
- Ventas — RVIE: https://docs.facturalo.pe/sire/ventas/periodos
  - GET Periodos: https://docs.facturalo.pe/sire/ventas/periodos
  - GET Resumen inconsistencias: https://docs.facturalo.pe/sire/ventas/resumen
  - GET Resumen de comprobantes: https://docs.facturalo.pe/sire/ventas/resumen-comprobantes
  - GET Comprobantes: https://docs.facturalo.pe/sire/ventas/comprobantes
  - GET Inconsistencias: https://docs.facturalo.pe/sire/ventas/inconsistencias
  - GET Inc. por comprobante: https://docs.facturalo.pe/sire/ventas/inconsistencia-por-comprobante
  - POST Aceptar propuesta: https://docs.facturalo.pe/sire/ventas/aceptar-propuesta
  - GET Exportar propuesta: https://docs.facturalo.pe/sire/ventas/exportar
  - GET Descargar propuesta: https://docs.facturalo.pe/sire/ventas/descargar-ticket
  - GET Preliminares: https://docs.facturalo.pe/sire/ventas/preliminares
  - PUT Eliminar prel. registrado: https://docs.facturalo.pe/sire/ventas/eliminar-preliminar-registrado
  - PUT Eliminar preliminar: https://docs.facturalo.pe/sire/ventas/eliminar-preliminar
  - POST Iniciar conciliación: https://docs.facturalo.pe/sire/ventas/conciliar
  - GET Consultar conciliación: https://docs.facturalo.pe/sire/conciliacion
- Compras — RCE: https://docs.facturalo.pe/sire/compras/periodos
  - GET Periodos: https://docs.facturalo.pe/sire/compras/periodos
  - GET Resumen inconsistencias: https://docs.facturalo.pe/sire/compras/resumen
  - GET Resumen de comprobantes: https://docs.facturalo.pe/sire/compras/resumen-comprobantes
  - GET Comprobantes: https://docs.facturalo.pe/sire/compras/comprobantes
  - GET Inconsistencias: https://docs.facturalo.pe/sire/compras/inconsistencias
  - GET Inc. por comprobante: https://docs.facturalo.pe/sire/compras/inconsistencia-por-comprobante
  - POST Aceptar propuesta: https://docs.facturalo.pe/sire/compras/aceptar-propuesta
  - GET Exportar propuesta: https://docs.facturalo.pe/sire/compras/exportar
  - GET Descargar propuesta: https://docs.facturalo.pe/sire/compras/descargar-ticket
  - GET Preliminares: https://docs.facturalo.pe/sire/compras/preliminares
  - PUT Eliminar prel. registrado: https://docs.facturalo.pe/sire/compras/eliminar-preliminar-registrado
  - PUT Eliminar preliminar: https://docs.facturalo.pe/sire/compras/eliminar-preliminar

### Integraciones
- Plugin WooCommerce: https://docs.facturalo.pe/woocommerce

### Tablas
- Tipos de comprobante: https://docs.facturalo.pe/tablas/tipos-comprobante
- Tipos de IGV: https://docs.facturalo.pe/tablas/tipos-igv
- Tipos de operación: https://docs.facturalo.pe/tablas/tipos-operacion
- Tipos de documento: https://docs.facturalo.pe/tablas/tipos-documento
- Notas de crédito: https://docs.facturalo.pe/tablas/notas-credito
- Notas de débito: https://docs.facturalo.pe/tablas/notas-debito
- Unidades de medida: https://docs.facturalo.pe/tablas/unidades-medida
- Monedas: https://docs.facturalo.pe/tablas/monedas
- Motivo de traslado: https://docs.facturalo.pe/tablas/motivo-traslado
- Modalidad de transporte: https://docs.facturalo.pe/tablas/modalidad-transporte
- Detracciones: https://docs.facturalo.pe/tablas/detracciones
- Medios de pago: https://docs.facturalo.pe/tablas/medios-pago

### Historial de cambios
- v3.0.0 — Lanzamiento inicial: https://docs.facturalo.pe/changelog/v3

## Entrada

- Introducción: https://docs.facturalo.pe/introduccion
- Guía rápida (primera factura): https://docs.facturalo.pe/guia-rapida
- Autenticación (token sin Bearer): https://docs.facturalo.pe/autenticacion
- Estados de documento: https://docs.facturalo.pe/estados
- Errores: https://docs.facturalo.pe/errores
- Idempotencia: https://docs.facturalo.pe/idempotencia

## Integraciones

- Webhooks (firma + 5 reintentos): https://docs.facturalo.pe/webhooks
- Estado del servicio: https://status.facturalo.pe
- Plugin WooCommerce: https://docs.facturalo.pe/woocommerce
- SDKs oficiales (Node.js y PHP): https://docs.facturalo.pe/sdks
- SDK Node.js (npm i @facturalo-pe/node): https://www.npmjs.com/package/@facturalo-pe/node
- SDK PHP (composer require facturalo-pe/facturalo-php): https://packagist.org/packages/facturalo-pe/facturalo-php
- Colección Postman: https://docs.facturalo.pe/collection.json
- OpenAPI: https://docs.facturalo.pe/openapi.json

## Producto

- Sitio y precios: https://www.facturalo.pe/precios
- Consola: https://console.facturalo.pe

## Contacto

- Sitio: https://www.facturalo.pe
- Soporte: contacto@facturalo.pe
- Empresa: Consultia Digital S.A.C.