Saltar al contenido
Facturador

Tipos de percepción

GET /api/catalogs/perception-types

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Catálogo SUNAT 22: régimen de percepción del IGV, con su tasa.

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: este catálogo no se activa ni desactiva por empresa: siempre devuelve todos los registros (all no tiene efecto).

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.
percentage number Sí Tasa de percepción.
active boolean Sí true si la empresa lo tiene activo.

Errores:

  • 401 sin token o con un token inválido.

Respuestas

{
  "success": true,
  "data": [
    {
      "id": "01",
      "description": "Percepción Venta Interna",
      "percentage": 2.0,
      "active": true
    },
    {
      "id": "02",
      "description": "Percepción a la adquisición de combustible",
      "percentage": 1.0,
      "active": true
    },
    {
      "id": "03",
      "description": "Percepción realizada al agente de percepción con tasa especial",
      "percentage": 0.5,
      "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.