Obtener clasificación de mercadería por su ID
Obtiene información detallada de una clasificación de mercadería específica usando su ID único. Incluye código y nombre de la categoría.
Entorno
Sección titulada «Entorno»URL Base: https://api.guarani.app
Endpoint
Sección titulada «Endpoint»GET /mercaderias-clasificaciones/{id}Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X GET "https://api.guarani.app/mercaderias-clasificaciones/{id}" \ -H "x-api-key: Bearer <access_token>" \ -H "Accept: application/json" | jqNota: Asegúrate de reemplazar
{id}con el identificador único de la clasificacion de la mercaderia y<access_token>con un token JWT válido proporcionado por el equipo Guarani. Importante:
Es imprescindible incluir un token de acceso válido en el encabezadox-api-keypara autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.
Parámetros de ruta
Sección titulada «Parámetros de ruta»| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id | uuid | Sí | ID de la clasificación de mercaderia para obtener sus datos. (ver clasificaciones) |
Encabezados de la Solicitud
Sección titulada «Encabezados de la Solicitud»| Encabezado | Valor | Descripción |
|---|---|---|
x-api-key | Bearer <access_token> | Token de autenticación necesario para acceder al recurso. |
Accept | application/json | Indica que la respuesta debe devolverse en formato JSON. |
Ejemplo de respuesta
Sección titulada «Ejemplo de respuesta»{ "success": true, "codigo": "200", "message": "Operación realizada correctamente.", "data": { "id": "c5a0b11f-3011-4ae4-8a4b-1a0f2dfd032c", "codigo": "01", "nombre": "CATEGORÍA EJEMPLO" }}Descripción de Campos de Respuesta
Sección titulada «Descripción de Campos de Respuesta»Campos principales
Sección titulada «Campos principales»| Campo | Tipo | Descripción |
|---|---|---|
id | uuid | Identificador único de la clasificación. |
codigo | string | Código estructurado que identifica la clasificación. Ej: “01”, “01.01”, “01.01.001”. |
nombre | string | Nombre descriptivo de la clasificación de mercaderías. |
Recursos adicionales
Sección titulada «Recursos adicionales»Para más información sobre posibles errores y cómo manejarlos, consulta errores.