> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear artículo

> Crea un nuevo artículo de catálogo para el vendor.

<ParamField header="x-api-key" type="string" required>
  API key de BOH con scope `catalog:write`.
</ParamField>

<ParamField path="vendorId" type="string" required>UUID del vendor.</ParamField>

<ParamField body="name" type="string" required>Nombre del artículo (máx. 200 caracteres).</ParamField>
<ParamField body="base_unit_id" type="string" required>UUID de la unidad de medida base.</ParamField>
<ParamField body="unit_group_id" type="string" required>UUID del grupo de unidades.</ParamField>
<ParamField body="external_item_id" type="string">Identificador en tu sistema.</ParamField>
<ParamField body="metadata" type="object">Datos adicionales libres.</ParamField>
<ParamField body="external_user_id" type="string">Actor para auditoría (opcional en catálogo).</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "name": "Tomate Bola",
    "base_unit_id": "unit_kg_01...",
    "unit_group_id": "ug_peso_01...",
    "external_item_id": "tomate-bola"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "itm_01...",
    "account_id": "acc_01j5k...",
    "name": "Tomate Bola",
    "status": "ACTIVE",
    "base_unit_id": "unit_kg_01...",
    "unit_group_id": "ug_peso_01...",
    "external_item_id": "tomate-bola",
    "metadata": {}
  }
  ```

  ```json 422 theme={null}
  {
    "error": {
      "kind": "unit_not_found",
      "message": "Unit not found"
    }
  }
  ```
</ResponseExample>