...
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>).
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).
Filtragem de Eventos:
O WSH analisa a resposta e filtra apenas os eventos do tipo SPE (Separação Finalizada), desconsiderando os demais tipos retornados.
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.
• 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.
| Totvs custom tabs box |
|---|
| tabs | Pré-requisitos e Atualizações, Configuração de Integração, Autenticação e Obtenção do Token (API), Processamento de Pedidos no iFood,Verificação da Importação |
|---|
| ids | passo1,passo2,passo3,passo4,passo5 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Pré-requisitos e AtualizaçõesPara 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
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Na Rotina 2670 - Configuração de Integrações, é necessário cadastrar a integração e definir os parâmetros fixos: - Crie a Integração E-commerce informando o código de layout (1 ou 2) e as filiais associadas.
- 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. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| É necessário obter o accessToken para que o Winthor possa se comunicar com a API do iFood. - Execute o endpoint/oauth/userCode para gerar um userCode e uma URL de verificação completa (verificationUrlComplete).
- Copie a URL completa e abra-a no navegador. Faça login na conta de desenvolvedor iFood e autorize o aplicativo para a loja.
- O iFood exibirá o código de autorização.
- 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. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
| Para que um evento seja importado, ele precisa passar pelo fluxo de separação do iFood até atingir o status SPE (Separação Finalizada). - O pedido é gerado no iFood (e passa pelos status PLC e CFM).
- Utilize o App Separador para iniciar a separação do pedido.
- Confirme os itens, geralmente digitando os 6 últimos dígitos do Código de Barras (EAN) do produto.
- Ao clicar em Finalizar Separação, o polling do sistema iFood gera o status SPE (SEPARATION_ENDED).
- 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. |
|
...
