> ## 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 un establecimiento

> Crea un nuevo establecimiento (ubicación física) 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 de visualización (máx. 200 caracteres).
</ParamField>

<ParamField body="timezone" type="string" required>
  Identificador de zona horaria IANA (ej. `America/Mexico_City`).
</ParamField>

<ParamField body="code" type="string">
  Código alfanumérico corto.
</ParamField>

<ParamField body="external_store_id" type="string">
  Identificador del establecimiento en tu sistema. Usado en payloads de operaciones en lugar del UUID.
</ParamField>

<ParamField body="tax_id" type="string">
  Identificador fiscal del establecimiento (RUC, CNPJ, CUIT, NIT, RUT, RFC u otro código alfanumérico del país, máx. 64 chars). Opcional y no único — en algunos países todos los locales de una empresa comparten el mismo RUC. Se usa para resolver el establecimiento en órdenes de compra mediante `store_tax_id`. Envía `null` para borrar.
</ParamField>

<ParamField body="metadata" type="object">
  Datos adicionales libres.
</ParamField>

<ParamField body="external_user_id" type="string">
  Actor para auditoría.
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "name": "Cocina Principal",
    "timezone": "America/Mexico_City",
    "code": "EST-001",
    "external_store_id": "tienda-principal",
    "external_user_id": "usuario_admin_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "str_principal_01...",
    "account_id": "acc_01j5k...",
    "code": "EST-001",
    "name": "Cocina Principal",
    "timezone": "America/Mexico_City",
    "status": "ACTIVE",
    "external_store_id": "tienda-principal",
    "tax_id": null,
    "metadata": {},
    "created_at": "2026-08-07T14:30:00.000Z",
    "updated_at": "2026-08-07T14:30:00.000Z"
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "kind": "validation_error",
      "message": "timezone is required"
    }
  }
  ```
</ResponseExample>