Ir al contenido

Catálogos

La API usa nombres legibles y los traduce a los catálogos oficiales de SUNAT (Anexo N.° 8 de la RS N.° 097-2012/SUNAT y modificatorias).

Tipo de documento del cliente (customer.doc_type)

Sección titulada «Tipo de documento del cliente (customer.doc_type)»
Valor Catálogo 06 Formato de doc_number Permitido en
RUC 6 11 dígitos con dígito verificador válido Facturas y boletas
DNI 1 8 dígitos Boletas
CE 4 4 a 12 letras o números (carné de extranjería) Boletas
PASAPORTE 7 4 a 12 letras o números Boletas
NONE - Se omite; el cliente figura como «CLIENTES VARIOS» Boletas en soles de hasta S/ 700

Tipo de comprobante (document_type en las respuestas)

Sección titulada «Tipo de comprobante (document_type en las respuestas)»
Valor Comprobante Serie Endpoint
01 Factura electrónica F + 3 letras o números (F001) POST /v1/invoices
03 Boleta de venta electrónica B + 3 letras o números (B001) POST /v1/receipts
07 Nota de crédito electrónica Misma letra que el comprobante afectado (FC01, BC01) POST /v1/credit-notes
08 Nota de débito electrónica Misma letra que el comprobante afectado (FD01, BD01) POST /v1/debit-notes
Valor en la API Catálogo 07 Tributos en UBL 2.1 Cuándo usarlo
gravado (por defecto) 10 1000 (IGV 18 %) Operación onerosa gravada con el IGV.
exonerado 20 9997 (EXO 0 %) Operación exonerada del IGV por ley (p. ej. libros o productos agrarios del Apéndice I).
inafecto 30 9998 (INA 0 %) Operación fuera del ámbito de aplicación del IGV.
gratuito 15 9996 (GRA, IGV referencial 18 %) Bonificación, muestra comercial o retiro de bienes gravados.
gratuito_exonerado 21 9996 (GRA 0 %) Entrega gratuita de un bien exonerado.
gratuito_inafecto 31 9996 (GRA 0 %) Entrega gratuita de un bien o servicio inafecto.

Detalle de fórmulas y redondeo en Cálculo de impuestos.

Código del catálogo 03 de SUNAT (UN/ECE Rec. 20). Por defecto NIU. Los más usados:

Código Unidad
NIU Unidad (bienes)
ZZ Unidad (servicios)
KGM Kilogramo
GRM Gramo
LTR Litro
MTR Metro
MTK Metro cuadrado
MTQ Metro cúbico
BX Caja
PK Paquete
BG Bolsa
BO Botella
DZN Docena
HUR Hora
DAY Día
MON Mes

La API acepta de 1 a 3 letras mayúsculas o números; SUNAT rechaza un código que no exista en su catálogo.

Valor Moneda (ISO 4217) Leyenda en letras
PEN (por defecto) Sol … SOLES
USD Dólar estadounidense … DÓLARES AMERICANOS
Valor Significado
contado (por defecto) Pago al contado.
credito Pago al crédito con cronograma de cuotas (installments). Solo facturas.

Motivos de nota de crédito (reason_code — Catálogo 09)

Sección titulada «Motivos de nota de crédito (reason_code — Catálogo 09)»
Código Motivo items
01 Anulación de la operación Opcional (copia el comprobante)
02 Anulación por error en el RUC Opcional (copia el comprobante)
03 Corrección por error en la descripción Opcional (copia el comprobante)
04 Descuento global Obligatorio
05 Descuento por ítem Obligatorio
06 Devolución total Opcional (copia el comprobante)
07 Devolución por ítem Obligatorio
08 Bonificación Obligatorio
09 Disminución en el valor Obligatorio
10 Otros conceptos Obligatorio
13 Ajustes — montos y/o fechas de pago No admite items; usa payment

Detalle y reglas en Emitir una nota de crédito.

Motivos de nota de débito (reason_code — Catálogo 10)

Sección titulada «Motivos de nota de débito (reason_code — Catálogo 10)»
Código Motivo items
01 Intereses por mora Obligatorio
02 Aumento en el valor Obligatorio
03 Penalidades / otros conceptos Obligatorio

Detalle en Emitir una nota de débito.

Bienes y servicios sujetos a detracción (Catálogo 54)

Sección titulada «Bienes y servicios sujetos a detracción (Catálogo 54)»

En detraction.code se envía el código de 3 dígitos del catálogo 54 de SUNAT y en detraction.percent la tasa vigente que corresponde a la operación. Códigos frecuentes en servicios y comercio:

Código Bien o servicio Tasa habitual
012 Intermediación laboral y tercerización 12
019 Arrendamiento de bienes muebles o inmuebles 10
020 Mantenimiento y reparación de bienes muebles 12
021 Movimiento de carga 10
022 Otros servicios empresariales (consultoría, sistemas, contabilidad, legal, publicidad) 12
024 Comisión mercantil 10
025 Fabricación de bienes por encargo 10
026 Servicio de transporte de personas 10
027 Servicio de transporte de carga 4
030 Contratos de construcción 4
037 Demás servicios gravados con el IGV 12

Ejemplo completo en la guía de descuentos, detracción y retención.

Medio de pago de la detracción (Catálogo 59)

Sección titulada «Medio de pago de la detracción (Catálogo 59)»

En detraction.payment_method se envía un código de 3 dígitos del catálogo 59 de SUNAT (001 por defecto):

Código Medio de pago
001 (por defecto) Depósito en cuenta
002 Giro
003 Transferencia de fondos
004 Orden de pago
005 Tarjeta de débito
006 Tarjeta de crédito emitida en el país por una empresa del sistema financiero
999 Otros medios de pago

Guías de remisión relacionadas (despatch_references)

Sección titulada «Guías de remisión relacionadas (despatch_references)»

Cada elemento de despatch_references indica el tipo de guía (Catálogo 01) y su número en formato SERIE-NÚMERO (4 caracteres alfanuméricos de serie, guion y de 1 a 8 dígitos):

type Tipo de guía Ejemplo de number
09 Guía de remisión remitente T001-123 o EG07-45
31 Guía de remisión transportista V001-88