Saltar al contenido
Facturador

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:

  • 401 sin 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

{
  "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.