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).
Skill para asistentes de IA Descarga esta skill y agrégala a tu proyecto para que tu asistente de IA tenga el contexto de lo que necesitas integrar. Descargar
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
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.
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 .
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 .
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 .
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
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