Pular para o conteúdo principal

Introdução ao fluxo de integração

Bem-vindo à documentação de integração. Este documento fornece uma visão geral de como funciona a seção de integração do sistema Grocers.

Diagrama de integração na perspectiva de sistemas​

Diagrama de Arquitetura

Como Funciona​

A integração se baseia em dois tipos de fluxo:

  1. Endpoints para Processamento em Lote: Utilizados para enviar dados em massa para o sistema.
  2. Webhook para notificação de eventos: Utilizado para receber notificações sobre eventos transacionais ocorrendo na base Grocers envolvendo o catálogo e os pedidos. Para mais detalhes, veja documentação de configuração de webhooks.

Diagrama de Arquitetura

  • Configuração do catálogo

    • Primeiro é necessário configurar as categorias e seus relacionamentos.
      • Categorias e sua relação em árvore;
    • Em seguida, é necessário incluir as marcas que serão utilizadas nos produtos.
    • Em seguida, é necessário configurar os produtos e seus SKUs para registro na base.
      • O ideal é cadastrar todos os SKUs já na criação do produto para que o sistema performe da melhor forma possível.

  • Configuração da precificação

    • É necessário atrelar a todo SKU um preço considerando valores de preço atual e previsões futuras.
      • Os preços se baseiam na estrutura de preço base, preço listado e preço fixo.
        • O preço fixo está acima de todos os preços em seu período de vigência, ele existe para permitir a configuração fácil de preços fixos em períodos promocionais.
        • O preço base é o valor base para garantir um valor mínimo de ofertas. É interessante que ele exista para que o sistema possa fazer a comparação entre o preço atual e o preço base, criando exibições promocionais.
        • O preço listado é o preço referencial mais baixo e de menor prioridade na exibição, ele tem que ser registrado sem considerar valores promocionais. Qualquer outro preço que esteja vigente ao mesmo tempo que ele vai sobrescrever seu valor.

  • Configuração do armazenamento

    • Após a configuração de catálogo e de preços, é necessário registrar as unidades de armazenamento.
    • Concluindo a configuração de unidades, é necessário relacionar os SKUs presentes nas unidades e suas quantidades.

As próximas páginas trarão detalhes sobre cada fluxo e a autenticação.