Tipos de cargos y descuentos
GET /api/catalogs/charge-discount-types
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Catálogo SUNAT 53: códigos de cargos y descuentos, por ítem o globales, y si afectan la base imponible.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: estándar {success, data, message?} (registro único). Aquí data es la lista completa (sin paginación ni pagination): son catálogos cortos.
Activos e inactivos: por defecto solo devuelve los registros activos de la empresa (los que se ofrecen en los formularios del sistema). Envía all=1 para incluir también los inactivos; cada fila trae active para distinguirlos. Un código inactivo puede ser rechazado al registrar comprobantes: usa siempre los activos.
Parámetros de la URL (query):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
type |
string | No | discount o charge. |
level |
string | No | item o global. |
all |
0 / 1 | No | 1 = incluir inactivos. |
Campos de cada fila de data:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
string | Sí | Código a enviar en el campo correspondiente del comprobante / registro. |
description |
string | Sí | Descripción para mostrar al usuario. |
type |
string | Sí | discount (descuento) o charge (cargo). |
level |
string | Sí | item (por ítem) o global (a todo el comprobante). |
base |
boolean | Sí | true si afecta la base imponible del IGV. |
active |
boolean | Sí | true si la empresa lo tiene activo. |
Errores:
401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
type |
query | no | discount |
discount o charge. Opcional. |
level |
query | no | item |
item o global. Opcional. |
all |
query | no | 1 |
1 = incluir también los registros inactivos (cada fila trae active). Por defecto solo activos. |
Respuestas
200 — Catálogo
{
"success": true,
"data": [
{
"id": "00",
"description": "Descuentos que afectan la base imponible del IGV/IVAP",
"type": "discount",
"level": "item",
"base": true,
"active": true
},
{
"id": "01",
"description": "Descuentos que no afectan la base imponible del IGV/IVAP",
"type": "discount",
"level": "item",
"base": false,
"active": true
},
{
"id": "02",
"description": "Descuentos globales que afectan la base imponible del IGV/IVAP",
"type": "discount",
"level": "global",
"base": true,
"active": true
},
{
"id": "03",
"description": "Descuentos globales que no afectan la base imponible del IGV/IVAP",
"type": "discount",
"level": "global",
"base": false,
"active": true
},
{
"id": "47",
"description": "Cargos que afectan la base imponible del IGV/IVAP",
"type": "charge",
"level": "item",
"base": true,
"active": true
},
{
"id": "50",
"description": "Otros cargos globales que no afectan la base imponible",
"type": "charge",
"level": "global",
"base": false,
"active": true
}
]
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.