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 (informe o requisito relacionado) : | DINTVENDAS-52 |
|---|
02. SITUAÇÃO/REQUISITO
A necessidade central é automatizar o fluxo de vendas originadas no iFood, garantindo que os pedidos B2C cheguem ao sistema Winthor sem a necessidade de intervenção manual.
O objetivo é consumir a API Order do iFood e utilizar o payload (o pacote de dados) recebido para alimentar a API interna do Winthor (api/wholesale/v1/orders/), que já é responsável pelo processamento de pedidos B2C.
Esta entrega inicial foca na importação do pedido base. A funcionalidade de aplicação de descontos e taxas não será contemplada nesta fase, sendo planejada para uma história futura
03. SOLUÇÃO
Foi implementado um mecanismo de integração que atua como uma ponte, buscando o pedido no iFood e convertendo os dados para o formato aceito pelo 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 mínimas ou superiores: - Atualizar o objeto winthor-venda para a versão 0.38.4.1 ou superior.
- Atualizar o serviço WSH para a versão 1.38.5.2 ou superior.
- Dependências necessárias: winthor-integracao-config 1.38.3.2 e winthor-integracao-2650 1.38.1.3.
- O usuário deve possuir Permissões na Rotina 530 para a Rotina 2650.
- A empresa iFood deve ser configurada como Multifilial no sistema.
Os produtos devem ter sido carregados na plataforma iFood via API Ingestion - send items. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Na Rotina 2650 - 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.
|
| 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 pedido 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 DEVAM ter 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. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo5 |
|---|
| Após o pedido alcançar o status SPE, o sistema Winthor tentará a importação. Verificação da API (Postman/Virtual Bag)Ao executar o endpointvirtual-bag com o orderId gerado, o status esperado é 200 OK. Verificação na Rotina 2650Na Rotina 2650, ao acessar a opção Detalhes Técnicos, a importação do pedido deve apresentar o Status S (Sucesso). Verificação no Winthor (Rotina 336)- Os pedidos importados são gravados no sistema Winthor com a origem de pedido "R" (Balcão Reserva).
- Os pedidos podem ser consultados e gerenciados na Rotina 336 - Alterar Pedido de Venda.
- Se a configuração Multi Filial estiver ativa na Rotina 2650, pedidos originados em uma loja iFood associada à Filial 2, por exemplo, serão recebidos corretamente na Filial 2 no Winthor.
|
|
| 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
...