Ir al contenido

Versiones

  • La versión actual es v1. Dentro de v1 solo se agregan campos, endpoints y códigos de reason nuevos. Tu integración debe ignorar los campos que no conoce.
  • Un cambio incompatible (quitar o renombrar un campo, cambiar un tipo) saldría en /v2, con al menos 6 meses de convivencia.
Fecha Cambio
2026-11-15 GET /v1/lookup/dni/{dni}: consulta de DNI para personas naturales con negocio (RUC 10 en el padrón de SUNAT). GET /v1/me incorpora api_key.scope y api_key.expires_at.
2026-11-14 Firma inmediata al emitir (sunat.hash y links.xml desde la respuesta 201), claves de alcance lookup, reenvío de comprobantes fallidos (POST /v1/documents/{id}/retry), formato ticket58 (links.public_ticket_58) y company.certificate_valid_until en /v1/me.
2026-11-14 Emisión con issue_date (hasta 3 días atrás), tasa reducida de IGV (10.5 % para restaurantes y hoteles MYPE), recargo al consumo (service_charge), afectaciones gratuito_exonerado y gratuito_inafecto, motivos de nota de crédito 03, 04, 05, 08 y 13, descuentos por ítem y globales, detracción, retención del IGV, orden de compra, guías de remisión, listado GET /v1/documents y envío por correo (POST /v1/documents/{id}/email).
2026-11-13 Lanzamiento de API v1: facturas (01), boletas (03), notas de crédito (07), notas de débito (08), anulaciones (RA y RC), descargas de PDF (a4 y ticket), XML y CDR, consultas de RUC individual y por lotes (POST /v1/lookup/ruc), webhooks firmados (/v1/webhooks), series (/v1/series), verificación de API key (/v1/me) e idempotencia.

Funcionalidades previstas en la hoja de ruta de v1 (sin cambios incompatibles):

  • Guía de remisión electrónica — remitente (09) y transportista (31).
  • Facturas de exportación y operaciones con anticipos (incluidas notas de crédito de motivo 11).
  • Consulta de DNI para personas naturales sin RUC.
  • Impuesto Selectivo al Consumo (ISC) e Impuesto a la Venta de Arroz Pilado (IVAP).
  • Comprobantes de retención (20), percepción (40) y liquidación de compra (04).