Crear marca

Registra una nueva marca en el sistema. Permite crear marcas para identificar y categorizar mercaderías.

---

Entorno

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

Endpoint

POST /marcas

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/marcas" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{ "nombre": "COCA COLA" }' | jq

Nota: Asegúrate de reemplazar <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.

---

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

Parámetro	Tipo	Requerido	Descripción
nombre	string	Sí	Nombre de la marca.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "201",
  "message": "Recurso creado con éxito.",
  "data": {
    "id": "dc25a120-d05a-43df-987f-c90e021b969a",
    "nombre": "COCA COLA"
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único de la marca creada.
nombre	string	Nombre de la marca.

Recursos adicionales

Para más información sobre posibles errores relacionados, consulta errores.