Crear un establecimiento

{
  "name": "Cocina Principal",
  "timezone": "America/Mexico_City",
  "code": "EST-001",
  "external_store_id": "tienda-principal",
  "external_user_id": "usuario_admin_01"
}

{
  "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"
}

{
  "error": {
    "kind": "validation_error",
    "message": "timezone is required"
  }
}

POST

api

public

vendors

{vendorId}

identity

stores

{
  "name": "Cocina Principal",
  "timezone": "America/Mexico_City",
  "code": "EST-001",
  "external_store_id": "tienda-principal",
  "external_user_id": "usuario_admin_01"
}

{
  "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"
}

{
  "error": {
    "kind": "validation_error",
    "message": "timezone is required"
  }
}

string

requerido

API key de BOH con scope catalog:write.

string

requerido

UUID del vendor.

string

requerido

Nombre de visualización (máx. 200 caracteres).

string

requerido

Identificador de zona horaria IANA (ej. America/Mexico_City).

string

Código alfanumérico corto.

string

Identificador del establecimiento en tu sistema. Usado en payloads de operaciones en lugar del UUID.

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.

object

Datos adicionales libres.

string

Actor para auditoría.

{
  "name": "Cocina Principal",
  "timezone": "America/Mexico_City",
  "code": "EST-001",
  "external_store_id": "tienda-principal",
  "external_user_id": "usuario_admin_01"
}

{
  "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"
}

{
  "error": {
    "kind": "validation_error",
    "message": "timezone is required"
  }
}

Descripción general

Identidad

Establecimientos

Proveedores

Artículos de catálogo

Sincronización de catálogo

Recetas

Recepciones de mercancía

Conteos de inventario

Eventos de merma

Transferencias

Lotes de producción

Seguimiento

Niveles de reorden

Pedido sugerido

Órdenes de compra

Líneas de OC

Webhooks

Crear un establecimiento