Ir al contenido

Referencia · Catálogos

Listar rubros

POST/serviciosRubrosListado

Listado de rubros de servicios. No requiere body.

La guía correspondiente está en Crear o editar un rubro.

La ruta POST /serviciosRubrosListado se agrega a la URL base del ambiente.

Enviá los headers x-api-key y x-api-secret. Cómo obtenerlos está en Credenciales.

No lleva cuerpo.

Este endpoint no recibe campos.

Listado de rubros de servicios

Si la operación sale bien, codigoError es "0".

Campo Tipo Obligatorio Descripción Ejemplo
descripcion string Sí — —
codigoError string Sí — —
rubrosServicios array de objetos No Ver rubrosServicios. —
Campo Tipo Obligatorio Descripción Ejemplo
version number Sí Versión interna del registro. —
id string Sí Identificador del rubro. Hace falta para editarlo. —
codigo string Sí Código corto del rubro. —
nombre string Sí Nombre del rubro. —
padreId string | null Sí Identificador del rubro padre. null si es un rubro raíz. —
nombreCompleto string Sí Nombre incluyendo la jerarquía. —
activo boolean Sí El listado solo incluye rubros activos. —
esHoja boolean Sí true si el rubro no tiene hijos. —
ultimaEdicion number Sí Marca de tiempo de la última edición, en milisegundos. —

Una respuesta de error trae codigoError y descripcion. El mismo código puede significar cosas distintas según el endpoint. El índice completo está en Códigos de error.

Si fallan las credenciales o el formato del body, aplican los códigos comunes: A01 a A06, V01 y V02.

Código Significado
E02 Empresa no encontrada

Error al obtener catálogo

{
"descripcion": "Empresa no encontrada",
"codigoError": "E02"
}

Este endpoint no lleva cuerpo.