01. DADOS GERAIS
| Produto: | | Solucoes_totvs |
|---|
| Solucao | TOTVS Distribuição e Varejo |
|---|
|
| Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | Modulos_totvs_prestadores_de_servicos |
|---|
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
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.
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.
...
| 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. |
|
| Aviso |
|---|
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
...
