Saltar al contenido
Facturador

Tipos de detracción

GET /api/catalogs/detraction-types

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

Catálogo SUNAT 54: bienes y servicios sujetos a detracción, con su porcentaje.

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
operation_type_id string No 1001 o 1004: solo los tipos de esa operación.
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.
percentage number Sí Porcentaje de detracción sobre el total.
operation_type_id string Sí Tipo de operación del comprobante con el que se usa: 1001 (general) o 1004 (transporte de carga).
active boolean Sí true si la empresa lo tiene activo.

La detracción aplica a comprobantes de más de S/ 700.

Errores:

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

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
operation_type_id query no 1001 1001 (general) o 1004 (transporte de carga). 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": "022",
      "description": "Otros servicios empresariales",
      "percentage": 12.0,
      "operation_type_id": "1001",
      "active": true
    },
    {
      "id": "027",
      "description": "Servicio de transporte de carga",
      "percentage": 4.0,
      "operation_type_id": "1004",
      "active": true
    },
    {
      "id": "037",
      "description": "Demás servicios gravados con el IGV",
      "percentage": 12.0,
      "operation_type_id": "1001",
      "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.