Catálogos

Códigos SUNAT que acepta la API y búsqueda de productos del catálogo 25.

Los catálogos se consultan con GET /catalogs/{name}, por nombre o por número SUNAT (units o 03). Cada fila indica con supported si la API la acepta hoy.

bash

curl https://api.apisunat.net/api/v1/issuer/catalogs/09 \
  -H "X-API-Key: $APISUNAT_KEY"

json

{
  "name": "credit-note-reasons",
  "sunatNumber": "09",
  "description": "Motivos de nota de crédito",
  "rows": [
    { "code": "01", "description": "Anulación de la operación", "supported": true },
    { "code": "11", "description": "Ajustes de operaciones de exportación", "supported": false }
  ]
}

GET /catalogs lista todos los catálogos disponibles.

Los códigos y descripciones salen tal cual del Excel oficial de SUNAT ("Reglas de validación", hoja Catálogos). Cada fila indica con supported si la API la acepta hoy.

Nombre	N.° SUNAT	Se usa en
`document-types`	01	`documentType`
`currencies`	02	`currency`
`units`	03	`items[].unitCode`
`identity-documents`	06	`customer.documentType`
`tax-affectations`	07	`items[].taxCode`
`credit-note-reasons`	09	`noteReasonCode` (notas de crédito)
`debit-note-reasons`	10	`noteReasonCode` (notas de débito)
`transport-modes`	18	`transportMode` (guías)
`transfer-reasons`	20	`motiveCode` (guías)
`perception-regimes`	22	`perception.code`
`retention-regimes`	23	`retention.code`
`operation-types`	51	`operationType`
`legends`	52	`legends[].code`
`charges-and-discounts`	53	`charges[].code`
`detractions`	54	`detraction.code`
`payment-means`	59	`detraction.paymentMethod`
`transport-documents`	61	`relatedDocuments` de guías

Afectación del IGV (catálogo 07)

Código	Afectación
`10`	Gravado - operación onerosa (por defecto)
`11` a `16`	Gravado - retiros, premios, donaciones, publicidad y bonificaciones
`20`	Exonerado - operación onerosa
`21`	Exonerado - transferencia gratuita
`30`	Inafecto - operación onerosa
`31` a `37`	Inafecto - retiros, muestras médicas, convenio colectivo, premios, publicidad y transferencias gratuitas
`40`	Exportación

El IVAP (17) todavía no está soportado.

Unidades (catálogo 03)

Los más usados: NIU unidad de bienes, ZZ unidad de servicios, KGM kilogramo, LTR litro, MTR metro, BX caja, PK paquete, DZN docena, GLL galón. El catálogo de la API lista los más comunes; se acepta cualquier código del catálogo 03 de SUNAT.

Motivos de traslado (catálogo 20)

La API acepta 01 venta, 02 compra, 04 traslado entre establecimientos de la misma empresa (requiere arrivalEstablishmentCode), 06 devolución (destinatario con RUC) y 13 otros (requiere motiveDescription).

Productos SUNAT (catálogo 25)

El catálogo de productos y servicios (UNSPSC) tiene 49 022 códigos. Búscalos por texto o código:

bash

curl "https://api.apisunat.net/api/v1/issuer/catalogs/products?q=43211503&limit=5&page=1" \
  -H "X-API-Key: $APISUNAT_KEY"

json

{
  "data": [{ "code": "43211503", "description": "Computadores notebook" }],
  "total": 1,
  "page": 1,
  "limit": 5,
  "hasMore": false,
  "version": "25"
}

q necesita al menos 2 caracteres. limit va de 1 a 100 (por defecto 20).

Calcular totales

POST /calculations recibe las mismas líneas que un documento y devuelve los importes sin emitir nada:

bash

curl https://api.apisunat.net/api/v1/issuer/calculations \
  -H "X-API-Key: $APISUNAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "items": [{ "description": "Servicio", "quantity": 1, "unitPrice": 118 }] }'

json

{
  "items": [
    { "code": "", "description": "Servicio", "quantity": 1, "unitCode": "NIU", "unitPrice": 118, "taxCode": "10", "base": 100, "tax": 18, "total": 118 }
  ],
  "totals": { "base": 100, "tax": 18, "charges": 0, "prepayments": 0, "perception": 0, "total": 118 }
}

Acepta también igvRate, discountAmount, discountPercent, charges y perception.