Lanzamiento inicial

v3.0.0

2026-06-13

Nuevo en v3

NUEVO

Endpoint unificado /documentos/enviar

Facturas, boletas, notas de crédito y débito se emiten desde un único endpoint. El tipo de comprobante se determina por tipoComprobante en el payload.

NUEVO

Cálculo automático de IGV

Solo se envía precioUnitario y tipoIgv por ítem. La API calcula IGV, subtotales y totales automáticamente.

NUEVO

Dos tipos de token

user_sk_... para gestión de cuenta. sk_test_... / sk_live_... para operaciones de documentos. El entorno se detecta automáticamente del prefijo.

NUEVO

Modo asíncrono con webhook

Envía "webhook": true para recibir una respuesta inmediata EN_PROCESO y obtener el resultado SUNAT en la URL de webhook configurada.

NUEVO

Endpoint /guias/enviar

Guías de remisión remitente (transporte público y privado) y transportista desde un endpoint dedicado.

NUEVO

Respuesta estructurada unificada

Todas las respuestas exitosas siguen el esquema: { success, message, data: { estado, entorno, documento, sunat, enlaces } }.

NUEVO

Archivos públicos sin autenticación

Los enlaces /{id}.pdf, /{id}.ticket.pdf, /{id}.xml y /{id}.cdr son públicos — compartibles directamente con el cliente sin exponer tokens.

NUEVO

Historial de eventos por documento y guía

GET /documentos/{id}/eventos y GET /guias/{id}/eventos retornan el ciclo completo: recepción, generación de XML, envío a SUNAT, respuesta SUNAT y notificación webhook.

NUEVO

Gestión completa de webhooks

Endpoints para listar eventos activos, activar/desactivar por tipo, consultar webhooks enviados y reenviar webhooks fallidos manualmente.

NUEVO

SIRE — Ventas (RVIE) y Compras (RCE)

Integración completa con el Sistema Integrado de Registros Electrónicos de SUNAT. Consulta periodos, resúmenes y comprobantes, acepta propuestas, exporta y descarga reportes, y gestiona preliminares. Compras incluye además conciliación automática contra los registros de Facturalo.

Endpoints disponibles

POST/documentos/enviarEmitir factura, boleta, nota de crédito o débito
POST/guias/enviarEmitir guía de remisión remitente o transportista
POST/documentos/anularAnular un documento emitido
GET/documentos/{id}Consultar estado de un documento
GET/documentos/{id}/eventosHistorial de eventos de un documento
GET/empresas/documentosListar documentos de la empresa
GET/guias/{id}Consultar estado de una guía
POST/guias/ticketConsultar ticket asíncrono de una guía
GET/guias/{id}/eventosHistorial de eventos de una guía
GET/empresasListar empresas de la cuenta
POST/empresasCrear empresa
PATCH/empresas/{uuid}Actualizar datos de empresa
POST/empresas/{uuid}/token/regenerarRegenerar token de empresa
GET/empresas/{uuid}/establecimientosListar establecimientos
POST/empresas/{uuid}/establecimientosCrear establecimiento
PATCH/empresas/{uuid}/establecimientos/{id}Actualizar establecimiento
PATCH/empresas/{uuid}/webhookActualizar URL de webhook demo / prod
GET/empresas/{uuid}/webhook/eventosListar eventos de webhook activos
PATCH/empresas/{uuid}/webhook/eventosActivar o desactivar eventos de webhook
GET/webhooksListar webhooks enviados
POST/webhooks/{id}/reenviarReenviar webhook fallido
GET/sire/ventas/periodosPeriodos RVIE disponibles
GET/sire/ventas/{periodo}/resumenResumen de inconsistencias RVIE
GET/sire/ventas/{periodo}/resumen-comprobantesResumen de comprobantes RVIE
GET/sire/ventas/{periodo}/comprobantesComprobantes de la propuesta RVIE
POST/sire/ventas/{periodo}/aceptar-propuestaAceptar propuesta RVIE
GET/sire/ventas/{periodo}/exportarExportar propuesta RVIE (genera ticket)
GET/sire/ventas/tickets/{numTicket}/descargarDescargar propuesta RVIE en Base64
GET/sire/ventas/{periodo}/preliminaresPreliminares registrados RVIE
PUT/sire/ventas/{periodo}/eliminar-preliminar-registradoRevertir a Propuesta desde Preliminar Registrado
PUT/sire/ventas/{periodo}/eliminar-preliminarRevertir a Propuesta desde Preliminar
GET/sire/compras/periodosPeriodos RCE disponibles
GET/sire/compras/{periodo}/resumenResumen de inconsistencias RCE
GET/sire/compras/{periodo}/resumen-comprobantesResumen de comprobantes RCE
GET/sire/compras/{periodo}/comprobantesComprobantes de la propuesta RCE
POST/sire/compras/{periodo}/aceptar-propuestaAceptar propuesta RCE
GET/sire/compras/{periodo}/exportarExportar propuesta RCE (genera ticket)
GET/sire/compras/tickets/{numTicket}/descargarDescargar propuesta RCE en Base64
GET/sire/compras/{periodo}/preliminaresPreliminares registrados RCE
PUT/sire/compras/{periodo}/eliminar-preliminar-registradoRevertir a Propuesta desde Preliminar Registrado
PUT/sire/compras/{periodo}/eliminar-preliminarRevertir a Propuesta desde Preliminar
POST/sire/compras/{periodo}/conciliarIniciar conciliación RCE
GET/sire/conciliaciones/{conciliacionId}Consultar estado de conciliación