Organización, tienda y vendedor

Cada recurso comercial pertenece a una tienda, y las tiendas pertenecen a una organización. En un marketplace, las ofertas además pertenecen a un vendedor.

Los tres niveles

Organización. Agrupa la cuenta, el plan, la facturación, los usuarios y una o varias tiendas.

Tienda. Tiene su propio catálogo, pedidos, clientes y configuración. Recibe un dominio *.ecomiq.app y puede conectar un dominio propio.

Vendedor. Dueño de una oferta dentro de la tienda. Una tienda simple tiene uno; un marketplace puede tener varios.

Cómo se elige la tienda

Admin

Una aplicación creada en una tienda recibe un token con store_id, y con seller_id si es de un vendedor. Envía solo el token:

curl "https://api.ecomiq.pe/api/v1/catalog/products?limit=25" \
  -H "Authorization: Bearer $ECOMIQ_TOKEN"

Una aplicación de organización recibe un token sin store_id. Elige la tienda en cada petición con x-Store-Id; debe ser una tienda de la misma organización:

curl "https://api.ecomiq.pe/api/v1/catalog/products?limit=25" \
  -H "Authorization: Bearer $ECOMIQ_TOKEN" \
  -H "x-Store-Id: $ECOMIQ_STORE_ID"

Si el token ya trae store_id y envías x-Store-Id con otra tienda, la API responde 403. Para trabajar con tiendas de otra organización, crea una aplicación en esa organización.

Storefront

Envía en x-Store-Domain el slug de la tienda, su subdominio *.ecomiq.app o su dominio propio:

curl "https://storefront.ecomiq.pe/v1/products?page=1&pageSize=24" \
  -H "x-Store-Domain: mi-tienda"

El token de un cliente identifica al comprador en las operaciones de cuenta y checkout. La tienda se sigue eligiendo con x-Store-Domain.

Identificadores

Un identificador vale solo dentro de su tienda. Pedir un recurso de otra tienda o de otro vendedor responde 404 o 403, aunque el recurso exista. Ante esos estados, revisa primero el token y el encabezado de tienda.

Para copiar datos a otra tienda, créalos o impórtalos en la tienda destino.