v3.0.0
2026-06-13
Nuevo en v3
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.
Cálculo automático de IGV
Solo se envía precioUnitario y tipoIgv por ítem. La API calcula IGV, subtotales y totales automáticamente.
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.
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.
Endpoint /guias/enviar
Guías de remisión remitente (transporte público y privado) y transportista desde un endpoint dedicado.
Respuesta estructurada unificada
Todas las respuestas exitosas siguen el esquema: { success, message, data: { estado, entorno, documento, sunat, enlaces } }.
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.
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.
Gestión completa de webhooks
Endpoints para listar eventos activos, activar/desactivar por tipo, consultar webhooks enviados y reenviar webhooks fallidos manualmente.
Endpoints disponibles
/documentos/enviarEmitir factura, boleta, nota de crédito o débito/guias/enviarEmitir guía de remisión remitente o transportista/documentos/anularAnular un documento emitido/documentos/{id}Consultar estado de un documento/documentos/{id}/eventosHistorial de eventos de un documento/empresas/documentosListar documentos de la empresa/guias/{id}Consultar estado de una guía/guias/ticketConsultar ticket asíncrono de una guía/guias/{id}/eventosHistorial de eventos de una guía/empresasListar empresas de la cuenta/empresasCrear empresa/empresas/{uuid}Actualizar datos de empresa/empresas/{uuid}/token/regenerarRegenerar token de empresa/empresas/{uuid}/establecimientosListar establecimientos/empresas/{uuid}/establecimientosCrear establecimiento/empresas/{uuid}/establecimientos/{id}Actualizar establecimiento/empresas/{uuid}/webhookActualizar URL de webhook demo / prod/empresas/{uuid}/webhook/eventosListar eventos de webhook activos/empresas/{uuid}/webhook/eventosActivar o desactivar eventos de webhook/webhooksListar webhooks enviados/webhooks/{id}/reenviarReenviar webhook fallido