Eliminar mercadería
Elimina una mercadería del sistema permanentemente. Útil para remover mercaderías obsoletas o incorrectas.
Entorno
Sección titulada «Entorno»URL Base: https://api.guarani.app
Endpoint
Sección titulada «Endpoint»DELETE /mercaderias/{id}Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X DELETE "https://api.guarani.app/mercaderias/{id}" \ -H "x-api-key: Bearer <access_token>" \ -H "Accept: application/json" | jqNota: Asegúrate de reemplazar
{id}con el identificador único 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 mercadería para eliminar sus datos. (ver mercaderias) |
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": "204", "message": "Recurso eliminado correctamente.", "data": { "id": "ejemplo-uuid-mercaderia-123", "eliminado_en": "2025-11-13 10:45:27.102345-03" }}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 mercadería eliminada. |
eliminado_en | string | Fecha y hora en formato ISO 8601 de la eliminación. |
Recursos adicionales
Sección titulada «Recursos adicionales»Para más información sobre posibles errores y cómo manejarlos, consulta errores.