Skip to Content
Documentação de integração da plataforma — em evolução contínua.

Ativação de loja no Grocers

A ativação inicial de loja ocorre pelo time Grocers, que fornece e orienta como utilizar as chaves e entidades para atualização de estoque, preços e ativações de novas lojas.

Trilha recomendada

Receber acesso

Credenciais Basic, contractAccountId e ambiente. Veja Credenciais e ambientes.

Marcas e categorias primeiro, depois produtos com seus SKUs. Veja Marcas e categorias.

Publicar estoque e preço

Sem estoque em warehouse e sem preço na política comercial, o item não aparece na loja.

Assinar os eventos de pedido

Registre o webhook e trate o ciclo de vida do pedido até o faturamento.

Credenciais e ambientesAtivar uma lojaEnviar catálogoAtualizar estoqueDefinir preçosRegistrar o webhook

Convenções que valem para toda a API

  • Idempotência por referência externa. Todo recurso enviado pela integração é identificado pelo seu externalReference — o código que ele já tem no seu ERP. Reenviar o mesmo externalReference atualiza o registro, não duplica. Uma exceção: o warehouse é reconciliado pelo name (veja Warehouses).
  • Processamento assíncrono. As rotas em lote respondem 200 OK com um operationId e processam em fila. O resultado do processamento retorna pelo webhook.
Credenciais e ambientes