Editar clasificación de mercadería

Actualiza una clasificación de mercadería existente. Permite actualizar los datos de la categoría.

---

Entorno

URL Base: https://api.guarani.app

Endpoint

PUT /mercaderias-clasificaciones/{id}

Ejemplo de solicitud

curl -X PUT "https://api.guarani.app/mercaderias-clasificaciones/{id}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "nombre": "CATEGORÍA EJEMPLO"
  }' | jq

Nota: 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 encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	uuid	Sí	ID de la clasificacion de mercaderia para actualizar sus datos. (ver clasificaciones)

Encabezado 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

Parámetro	Tipo	Requerido	Tamaño	Descripción
nombre	string	Sí	100	Nombre de la clasificación de mercaderias.

Nota importante: El campo codigo no se puede modificar en las actualizaciones. Solo se puede actualizar el nombre de la clasificación.

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

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

Para más información sobre posibles errores y cómo manejarlos, consulta errores.