Objetivo
Este documento visa explicar o funcionamento da Integração de Produtos.
Integração de Pedidos
A integração consiste em recepcionar os pedidos após a conclusão da separação pelo gestor de pedidos (SMR - SiteMercado Receptor) possibilitando a separação através do mesmo ou do SMC (SiteMercado Coletor).
É iniciada a separação do pedido. Assim que finalizada a separação, o pedido vai para a coluna Aguardando Retirada/Entrega e neste momento o pedido fica com o status PE0
Neste status, o integrador identifica o pedido e o mesmo é integrado para as estruturas do ERP.
O é integrado nas estruturas comercias?
Com o pedido no status PE0, a API busca os principais dados como:
| Campo | ERP TOTVS(Linha Consinco) | Campo API Site Mercado |
| Número do pedido | Número do pedido AFV exibido no módulo Pedido Venda. Os caracteres são retirados, sendo enviado apenas números | Código Pedido. É gerado no Ifood |
| Número Empresa | Aplicação Configuração de Pedidos > campo Empresa | -- |
| Pessoa | Pessoa vinda no pedido. Verificamos se a pessoa já existe. Caso não exista, a pessoa é cadastrada no ERP, se já existe, é feira uma verificação e atualizados os dados de cadastro | Cliente. Nessa tag vem os dados do cliente |
| Representante | Aplicação Configuração de Pedidos > campo Representante | -- |
| Forma de Pagamento | Aplicação Configuração de Pedidos > campo Forma de Pagamento. Hoje não existe uma verificação para este campo. Inserindo apenas a forma de pagamento do pedido. Não é feita a inserção nas estruturas de forma de pagamento | Pagamentos. Nessa tag vem os dados da forma de pagamento, como ID, nome da forma de pagamento |
| CGO | Aplicação Configuração de Pedidos > campo CGO | -- |
| Usuário | Aplicação Configuração de Pedidos > campo Usuário | -- |
| Valor Pedido | Valor total do pedido | Dado do cabeçalho do pedido, onde está o valor total do pedido |
| Codigo acesso produto | Código EAN ou Interno que foi integrado junto ao produto | tag codigoBarra |
| Codigo interno produto | Código interno do produto integrado no campo PLU no Ifood | tag PLU |
| Qtde Pedida | Quantidade que foi pedida no pedido no Ifood | tag Quantidade |
| Qtde Embalagem | Quantidade da embalagem que foi integrada junto com o produto | -- |
| Valor Tabela de Preço | Valor calculado de acordo com a tabela de venda informada na aplicação Configuração de Pedidos | -- |
| Numero Tabela Venda | Aplicação Configuração de Pedidos > campo Tabela de Venda | -- |
Restrições
- Não é feita a integração da Forma de pagamento nas tabelas de forma de pagamento
- As demais chamadas de pedido da API contam com uma proteção de rate limit para evitar abusos nas rotas dos serviços. Cada cliente da API deve fazer no máximo 20 requests a cada 1 segundo. Caso exceda o limite de requisições, o cliente pode ser bloqueado temporariamente. Nesses casos receberá como resposta o código 403.
Devido a lei do LGPD alguns campos contendo os dados dos clientes não são enviados sendo eles: E-mail e Telefone
- Após o pedido integrado no ERP, a chamada de eventos é enviado no body da requisição e o pedido é retirado da integração.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas