Editar clasificacion de cliente
Actualiza una clasificación de cliente existente. Permite actualizar el código y nombre de la categoría.
Entorno
Sección titulada «Entorno»URL Base: https://api.guarani.app
Endpoint
Sección titulada «Endpoint»PUT /clientes-clasificaciones/{id}Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X PUT "https://api.guarani.app/clientes-clasificaciones/{id}" \ -H "Content-Type: application/json" \ -H "x-api-key: Bearer <access_token>" \ -d '{ "nombre": "CATEGORÍA EJEMPLO" }' | jqNota: Asegúrate de reemplazar
{id}con el identificador único de la clasificacion del cliente 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 clasificacion del cliente para actualizar sus datos. ver (clasificaciones) |
Encabezados de la Solicitud
Sección titulada «Encabezados de la Solicitud»| Encabezado | Valor | Descripción |
|---|---|---|
Content-Type | application/json | Indica que los datos se envían en formato JSON. |
x-api-key | Bearer <access_token> | Token de autenticación necesario para acceder al recurso. |
Descripción de Campos
Sección titulada «Descripción de Campos»| Parámetro | Tipo | Requerido | Tamaño | Descripción |
|---|---|---|---|---|
nombre | string | Sí | 100 | Nombre descriptivo de la clasificación de clientes. |
Nota importante: El campo
codigono se puede modificar en las actualizaciones. Solo se puede actualizar elnombrede la clasificación.
Ejemplo de respuesta
Sección titulada «Ejemplo de respuesta»{ "success": true, "codigo": "200", "message": "Recurso actualizado con éxito.", "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 clientes. |
Recursos adicionales
Sección titulada «Recursos adicionales»Para más información sobre posibles errores relacionados, consulta la sección errores.