TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • DINTVENDAS-45 - DT - Obter eventos de Pedidos do iFood para o Winthor.

01. DADOS GERAIS

Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor

Segmento:

Distribuição

Módulo:

Pedido de Venda

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


02. SITUAÇÃO/REQUISITO

Permitir que o WSH consulte periodicamente os pedidos do iFood com status de separação finalizada (SPE), para que esses pedidos possam ser processados posteriormente no Winthor.

03. SOLUÇÃO

Fluxo de Consulta e Filtragem de Pedidos

  1. Consulta à API Polling:
    O WSH realiza chamadas periódicas (a cada 30 segundos) ao endpoint https://merchant-api.ifood.com.br/events/v1.0/events:polling?x-polling-merchants utilizando o método GET e o token de autenticação (Bearer <access_token>).

  2. Recebimento do Retorno:
    A API do iFood retorna uma lista de eventos em formato JSON, onde cada objeto contém o identificador do evento, o ID do pedido e o tipo do evento (exemplo: SPE, PLC, CAN).

  3. Filtragem de Eventos:
    O WSH analisa a resposta e filtra apenas os eventos do tipo SPE (Separação Finalizada), desconsiderando os demais tipos retornados.

  4. Disponibilização para Processamento:
    Após o filtro, os pedidos SPE são armazenados temporariamente, ficando disponíveis para processamento da próxima etapa.

Regras de Comportamento

• Intervalo de Consulta:
O intervalo recomendado entre as consultas é de 30 segundos, evitando sobrecarga de requisições e garantindo atualização constante dos eventos. 

Este intervalo pode ser consultado na rotina de Fluxo do WSH.

• Validação de Autenticação:
Caso o token seja inválido ou expirado, a API retornará erro 401 – Unauthorized. O sistema renova o token antes de realizar nova tentativa.

• Permissões de Acesso:
Se o ambiente não possuir as permissões adequadas para consumo da API, o retorno será 403 – Forbidden, devendo ser revisadas as credenciais associadas.

• Tipos de Eventos:
Embora o Polling retorne múltiplos tipos de eventos, somente os SPE devem ser considerados válidos para continuidade do fluxo de integração com o Winthor.


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