Integração ERP com a Tiffin Foods
Integração desenvolvida pela Tiffin Foods, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos Solução desenvolvida pela Tiffin Foods Web | ✔ |
| Receber produtos Solução desenvolvida pela Tiffin Foods Web | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
Configuração no ERP
Configurar integração com a Tiffin Foods
Acesse as integrações do ERP em Menu → Início → Integrações.
Caso já possua integrações configuradas em sua conta, as mesmas serão exibidas e indicadas com suas respectivas situações.
Cada situação indica:
- Ativa: Representa que a configuração da integração foi realizada com sucesso e a mesma encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no ERP, a mesma não será utilizada ou mostrada para sincronização de pedidos, produtos e demais ações pertinentes.
- Não configurada: Esta situação indica que a configuração ainda não foi realizada.
- Não instalada: Representa que ainda não houve a comunicação com o e-commerce para ativar a integração.
Agora, clique no botão Adicionar integração, busque por Tiffin Foods clique em Instalar.
Na aba Conexão, no campo Nome informe o nome da sua loja.
Defina os seguintes campos abaixo:
Produtos > Fluxo de Produtos
| Enviar dias para preparação ao sincronizar |
Habilite a opção para enviar a informação da quantidade de dias necessários para o envio de produtos para a plataforma. * Para preencher este campo, acesse o menu → cadastro → produto → editar → aba dados gerais → seção estoque → dias para preparação. Lembramos que esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes. |
Notificações > Notificações por e-mail
| Enviar e-mail de rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática via e-mail conforme layout estabelecido nas configurações da expedição. |
|---|---|
| Enviar e-mail de entrega ao alterar a situação no ERP para entregue | Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, será enviado de forma automática um e-mail conforme layout estabelecido nas configurações da expedição. |
Configurações adicionais
| Intermediador |
Selecione o intermediador de suas operações. Maiores informações em Como utilizar e configurar os intermediadores de operações. * A informação de intermediador da transação é obrigatória para emissão de NFe. |
|---|
Na aba Produtos > Regras de estoque, defina as regras de estoque da integração:
| Atualizar estoque na loja virtual a partir do ERP | Selecione umas opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque). |
|---|---|
| Depósito a ser considerado na integração |
Escolha qual será o depósito padrão para as ações: importar pedido, importar produtos e enviar estoque. * O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada. |
| Lançamento de estoque para saídas |
Defina quando o estoque dos pedidos será lançado: ao selecionar a opção Manual , o usuário deverá através do menu de contexto localizado ao lado de cada pedido ou nota fiscal selecionar a opção Lançar estoque. Se escolhida uma das opções de Automático , o sistema fará o lançamento no momento determinado: Ao autorizar a NFe , Ao salvar NFe , Ao salvar o pedido ou Ao marcar pedido como enviado. Se selecionar Ao marcar pedido como enviado e o pedido tiver uma nota fiscal vinculada, o lançamento de estoque ocorrerá pela nota fiscal. * O lançamento do estoque pode ser parametrizado de acordo com as configurações das naturezas de operação. Ao lançar estoque manual para uma natureza configurada para não permitir lançamento de estoque, será exibido um aviso não permitindo lançar estoque. A configuração da natureza de operação deverá ser verificada. |
| Estoque de segurança |
Informe a quantidade de estoque de segurança para que, quando seu estoque atingir este número, a quantidade de estoque enviada para a plataforma seja Zero. * Produtos sob encomenda não estão abrangidos por este parâmetro. |
Na aba Pedidos > Dados Fiscais , no campo Natureza de operação para venda desta integração selecione uma Natureza de venda padrão para essa plataforma. A natureza selecionada será atribuída na Importação dos pedidos no ERP e no momento em que gerar a Nota Fiscal através do pedido importado.
Observação:
Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.
Na aba Produtos > Preços, defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce.
- Preço fixo : conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
- Conforme regras de preço : trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais;
- Conforme lista de preços : para uso de listas de preços dos produtos, específicas para o e-commerce ou marketplace.
Na aba Notificações preencha os campos URL do notificações de estoque, URL para envio de produtos, URL para envio do rastreio, URL para envio dos preços e URL para envio de alteração na situação de pedidos com as URLs utilizadas para webhook de sua loja virtual.
Observação:
Estes links devem ser solicitados ao suporte da Tiffin Foods.
Ao final, não esqueça de Salvar as configurações.
Adicionar extensão token api
Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Extensões do ERP.
Na seção Vendas , adicione a extensão Token API.
Agora, clique em Instalar e Confirme a instalação da extensão.
Gerar token api
Acesse as configurações de e-commerce do ERP em Menu → Configurações → Aba E-commerce → Token API.
No campo Token , encontra-se o Token identificador da sua conta.
Esse token deve ser adicionado no momento que integrar o ERP na Tiffin Foods, conforme orientação Como integrar o ERP com a plataforma Tiffin Foods.
Como enviar produtos do ERP para Tiffin Foods
Enviar apenas um produto
Para enviar apenas um produto para Tiffin Foods, acesse em Menu → Cadastros → Produtos.
Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.
A seguir, no campo Plataforma selecione sua loja Tiffin Foods e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Unidade;
- Preço;
- Peso bruto;
- Estoque;
- Imagens;
- Unidades por caixa.
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para Tiffin Foods, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Tiffin Foods e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Unidade;
- Preço;
- Peso bruto;
- Estoque;
- Imagens;
- Unidades por caixa.
Como mapear o cadastro dos produtos para integração do estoque
Para que o mapeamento dos itens entre o ERP e a Tiffin Foods ocorra, é necessário sincronizar o produto desejado a partir do ERP. Saiba mais como enviar produtos para a plataforma através da ajuda Como enviar produtos do ERP para Tiffin Foods.
Como visualizar os pedidos do e-commerce no ERP
A importação dos pedidos é realizada de forma automática. Para visualizar os pedidos, acesse sua conta no ERP em Menu → Vendas → Pedidos de venda.
Configuração na Tiffin Foods
Como integrar o ERP com a plataforma Tiffin Foods
Para ativar e configurar a integração da loja com o sistema ERP ERP, encaminhe o Token e o Identificador do integrador para que o suporte da plataforma possa dar sequência na integração. Saiba mais através da ajuda Gerar Token API.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à Tiffin Foods , alguns dados são sincronizados entre as duas plataformas, evitando que você precise fazer o cadastro de produtos duas vezes.
É importante que você entenda quais campos serão sincronizados. Segue abaixo a lista com a especificação de cada campo:
| Código (SKU) | Este campo é obrigatório. Sem ele a exportação não funcionará. Ele é a chave de conexão do produto entre as duas plataformas, então preencha preferencialmente apenas com números. |
|---|---|
| Descrição | O campo descrição no ERP equivale ao campo Título no painel de controle da Tiffin Foods. Esse campo é obrigatório. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da Tiffin Foods. |
| Peso bruto | O peso bruto equivale ao campo peso bruto no painel de controle da Tiffin Foods. |
| Unidade | A unidade do produto no ERP será sincronizada com a unidade do produto na Tiffin Foods. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Tiffin Foods. |
| Descrição complementar | Esse campo equivale a descrição do produto no painel de controle da Tiffin Foods. |
| Imagens | As imagens dos produtos no ERP serão sincronizadas com as imagens dos produtos na Tiffin Foods. |
| Unidades por caixa | O campo unidades por caixa do produto no ERP será sincronizado com a respectiva informação no painel da Tiffin Foods. |
Saiba como cadastrar no ERP produtos Simples e com Variações.
Enviar estoque dos produtos no ERP ao e-commerce
Enviar quantidade em estoque em lote
Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos. Na lista que será exibida, selecione as integrações que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar quantidade em estoque de forma individual
Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.
No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto. Na lista que será exibida, selecione aquelas que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar preço dos produtos no ERP ao e-commerce
Enviar preços em lote
Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Enviar preço de forma individual
Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Reajustar preço dos produtos no ERP e atualizar na Tiffin Foods
Para realizar os ajustes nos preços dos produtos cadastrados no ERP e após atualizar na loja virtual, acesse em Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.
Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.
Após isso, será exibido a lista dos produtos, clique em Informar reajuste.
Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços, por reajuste de Percentual , ou adicione o novo preço em cada produto na coluna Novo preço , marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.
Enviar código de rastreio para Tiffin Foods
Atenção!
Para enviar o código de rastreamento para Tiffin Foods, é preciso informar no pedido ou nota fiscal o transportador, sendo ele Correios ou Transportadora. O campo será preenchido no Pedido de Venda ou na Nota Fiscal e por fim, gerar o agrupamento (PLP ou Coleta) no módulo de Expedição. Veja como gerar a Expedição.
Acesse o módulo de Expedição, Selecione a forma de envio → Aba Concluídas → Clique no menu de contexto ao lado da expedição gerada → Enviar código de rastreio para o e-commerce.
Observação:
Ao enviar o código de rastreio, os pedidos são marcados como Processados na Tiffin Foods.
Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado para a Tiffin Foods.
Dicas e informações adicionais
- Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse Configurações → Aba E-commerce → Integrações e marque a integração desejada. Depois, clique em Mais ações → Excluir todos os anúncios no ERP. É importante mencionar que esta ação, depois de concluída, não poderá ser desfeita.
- Os campos sincronizados devem ser corrigidos/modificados apenas no ERP. Caso você corrija/modifique alguma destas informações no painel de controle da Tiffin Foods, estas informações serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.
