Referencia · Catálogos
Listar rubros
POST
/serviciosRubrosListadoListado de rubros de servicios. No requiere body.
La guía correspondiente está en Crear o editar un rubro.
Solicitud
Sección titulada «Solicitud»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.
Respuesta 200
Sección titulada «Respuesta 200»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. | — |
Respuesta rubrosServicios
Sección titulada «Respuesta 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. | — |
Errores
Sección titulada «Errores»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 |
HTTP 500
Sección titulada «HTTP 500»Error al obtener catálogo
{ "descripcion": "Empresa no encontrada", "codigoError": "E02"}Ejemplos
Sección titulada «Ejemplos»Este endpoint no lleva cuerpo.