01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Pedido de Venda

Função:Integrações Winthor
País:Brasil
Requisito/Story/Issue:DINTVENDAS-46


02. SITUAÇÃO/REQUISITO

Foi implementado um mecanismo de integração responsável por consultar os detalhes de pedidos no iFood a partir do OrderId, garantindo que o payload original do pedido seja recuperado e disponibilizado para conversão e integração no Winthor.

Antes da utilização desta integração, é pré-requisito consultar a documentação do fluxo de Polling, pois é a partir dele que os orderIds com status SPE (Separação Finalizada) são identificados e repassados para esta etapa.

03. SOLUÇÃO

Fluxo de Consulta e Recuperação de Pedido

  1. Entrada e Autenticação:

  2. Consulta à API de Order:

  3. Retorno e Armazenamento:

Regras de Resiliência e Tratamento de Erros

• Falha de Autenticação (401 – Unauthorized):
Registra log informando falha de autenticação, indicando que o token está inválido ou expirado, porém apenas é apresentado nos logs do Winthor Smart Hub

• Pedido Inexistente (404 – Not Found):
Registra log informando que o orderId não foi encontrado ou não pertence ao token/filial informada.

• Erros de Rede ou Timeout:
Caso ocorra falha de comunicação com a API, o sistema registra o erro e devolve um status nos logs, preservando a estabilidade do processo.


Pré-requisitos e Atualizações

Para iniciar a funcionalidade, o ambiente deve estar nas versões abaixo ou superiores:

  • Versão do serviços: 
    • winthor-venda                      - v0.38.4.1
    • winthor-smart-hub               - v1.38.3.2
    •  winthor-integracao-config - v1.38.2.6
    • winthor-integracao-2650    - v1.38.5.2
    • winthor-smart-hub-layouts - v1.38.0.17

Na Rotina 2670 - Configuração de Integrações, é necessário cadastrar a integração e definir os parâmetros fixos:

  1. Crie a Integração E-commerce informando o código de layout (1 ou 2) e as filiais associadas.
  2. Defina os parâmetros de utilização e requisição, que são os valores fixos (Código de Cliente Padrão, Vendedor Padrão, etc.) que serão utilizados no Winthor.


Na Rotina 2650 - Configuração de Integrações no WSH e instale o layout relacionado a essa nova integração.

É necessário obter o accessToken para que o Winthor possa se comunicar com a API do iFood.

  1. Execute o endpoint /oauth/userCode para gerar um userCode e uma URL de verificação completa (verificationUrlComplete).
  2. Copie a URL completa e abra-a no navegador. Faça login na conta de desenvolvedor iFood e autorize o aplicativo para a loja.
  3. O iFood exibirá o código de autorização.
  4. Execute o endpoint /oauth/token, preenchendo o authorizationCode (código obtido no passo anterior) e o authorizationCodeVerifier (valor gerado no primeiro passo).

O retorno deve ser o accessToken, que será utilizado para a busca dos pedidos.

Para que um evento seja importado, ele precisa passar pelo fluxo de separação do iFood até atingir o status SPE (Separação Finalizada).

  1. O pedido é gerado no iFood (e passa pelos status PLC e CFM).
  2. Utilize o App Separador para iniciar a separação do pedido.
  3. Confirme os itens, geralmente digitando os 6 últimos dígitos do Código de Barras (EAN) do produto.
  4. Ao clicar em Finalizar Separação, o polling do sistema iFood gera o status SPE (SEPARATION_ENDED).
  5. Somente com o status SPE o pedido está pronto para ser consumido e importado para o Winthor.

IMPORTANTE:

É fundamental que os produtos cadastrados na loja iFood tenham o mesmo Código de Barras (EAN) e Código de Produto (CODPROD/SKU) cadastrados no Winthor. Caso contrário, será gerado um erro de produto não encontrado.


04. DEMAIS INFORMAÇÕES


Importante!

As versões estarão disponíveis para download no CCW. 

https://centraldecontrole.pcinformatica.com.br/


Mantenha suas rotinas sempre atualizadas!


05. ASSUNTOS RELACIONADOS