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}.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.

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