Integração com ERPs
O MeuCardapio.ai se integra com os principais sistemas ERP do mercado de food service. Com a integração ativa, os pedidos recebidos no cardápio digital são enviados automaticamente para o ERP, e o estoque/disponibilidade dos produtos é sincronizado em tempo real.
ERPs Suportados
| ERP | Identificador | Envio de Pedidos | Importação de Produtos | Sincronização de Estoque | Sincronização de Preços | Cancelamento | Comandas |
|---|---|---|---|---|---|---|---|
| Tiny ERP | tiny | Sim | Sim | Sim | Sim | Sim | Sim* |
| Eclética | ecletica | Sim | Sim | Sim | Sim | Sim | Sim |
| Saipos | saipos | Sim | Sim | Sim | Sim | Sim | Sim |
| BlueSoft | bluesoft | Sim | Sim | Sim | Sim | Sim | Sim |
| GCom | gcom | Sim | Sim | Sim | Sim | Sim | Sim |
| Teknisa | teknisa | Sim | Sim | Sim | Sim | Sim | Sim |
| TOTVS Chef | totvs | Sim | Sim | Sim | Sim | Sim | Sim |
| Menew | menew | Sim | Sim | Sim | Sim | Sim | Sim |
| RP Info | RPInfo | Sim | Sim | Não | Não | Sim | Não |
| Consumer | consumer | Sim | Não | Não | Não | Não | Não |
* Tiny ERP suporta comandas somente quando a opção "Enviar pedidos de mesas no fechamento da comanda" está ativa.
Requisitos por ERP
Cada ERP possui requisitos diferentes para o cliente final. Confira abaixo quais campos se tornam obrigatórios:
| ERP | CEP obrigatório | Tempo estimado de entrega obrigatório | Código PDV obrigatório |
|---|---|---|---|
| Tiny ERP | Não | Não | Não |
| Eclética | Sim | Não | Não |
| Saipos | Não | Sim | Configurável |
| BlueSoft | Sim | Não | Não |
| GCom | Sim | Sim | Não |
| Teknisa | Não | Não | Não |
| TOTVS Chef | Sim | Não | Não |
| Menew | Não | Não | Não |
| RP Info | Não | Não | Sim |
| Consumer | Não | Sim | Não |
Como Ativar a Integração
Passo 1 -- Acesse o painel administrativo
Navegue até Menu lateral > Integrações > ERP.
Passo 2 -- Selecione o ERP
Escolha o sistema ERP que utiliza no seu estabelecimento. Cada ERP exige credenciais diferentes (veja a seção de configuração específica abaixo).
Passo 3 -- Informe as credenciais
Preencha os campos de configuração de acordo com o ERP selecionado. O sistema validará o token/credencial automaticamente antes de salvar.
Passo 4 -- Mapeie as formas de pagamento
Vincule as formas de pagamento do MeuCardapio.ai com as bandeiras/formas correspondentes no ERP. Isso garante que os pedidos sejam registrados com a forma de pagamento correta.
Passo 5 -- Importe os produtos
Após ativar a integração, importe os produtos do ERP. Isso vincula o Código PDV de cada produto no MeuCardapio.ai com o produto correspondente no ERP.
Após a primeira importação, sincronize periodicamente os produtos para manter os dados atualizados. Use o botão Sincronizar Produtos na tela de integração.
Configuração por ERP
Tiny ERP
O Tiny ERP utiliza autenticação via token de API.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Token de API gerado no painel do Tiny ERP |
Configurações específicas:
- Enviar pedidos de mesas no fechamento da comanda -- quando ativado, pedidos feitos em mesas (via QR Code) são enviados ao Tiny ERP somente quando a comanda é fechada, em vez de individualmente.
Momento de envio do pedido: o pedido é enviado ao Tiny ERP assim que recebe o status Novo (antes da confirmação pelo operador).
Eclética
A Eclética utiliza autenticação via credenciais de rede e loja, sem token tradicional. A validação do acesso ocorre no momento da ativação.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Rede | Código da rede no sistema Eclética |
| Loja | Código da loja no sistema Eclética |
Configurações específicas:
- Observações no início -- envia as observações do pedido no início do corpo da mensagem ao ERP (em vez do final).
- Integrar com comandas -- ativa o envio de pedidos de mesa/comanda para o sistema Eclética.
- Integrar com DMWS -- utiliza o serviço DMWS da Eclética para comunicação (recomendado para versões mais recentes).
CEP obrigatório: sim. O cliente precisa informar o CEP ao realizar o pedido.
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
Saipos
O Saipos utiliza autenticação OAuth com renovação automática de token a cada 24 horas.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
Código da Loja (cod_store) | Código da loja no Saipos |
ID do Parceiro (idPartner) | Identificador do parceiro fornecido pelo Saipos |
| Secret | Chave secreta para autenticação |
Configurações específicas:
- Não enviar código PDV -- quando ativado, o MeuCardapio.ai não envia o código PDV dos produtos nos pedidos (útil quando o mapeamento é feito pelo Saipos).
Tempo estimado de entrega obrigatório: sim. Todo pedido de delivery precisa conter o tempo estimado de entrega.
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
O token do Saipos expira a cada 24 horas. O MeuCardapio.ai renova o token automaticamente antes da expiração. Não é necessária intervenção manual.
BlueSoft
O BlueSoft utiliza autenticação via token de API com configuração de loja, grupo e canal de venda.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Token de API da BlueSoft |
Loja (lojaKey) | Identificador da loja |
| CPF/CNPJ da Loja | Documento da loja cadastrada na BlueSoft |
| Grupo | Grupo da rede (ex: soneda) |
| ID Ecommerce | Identificador do e-commerce (padrão: 1) |
Canal de Venda (canalVendaKey) | Canal de venda (1 = E-commerce, 2 = Delivery) |
CEP obrigatório: sim. O cliente precisa informar o CEP ao realizar o pedido.
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
GCom
O GCom utiliza autenticação via Bearer Token gerado automaticamente pelo MeuCardapio.ai. O GCom busca os pedidos via polling (consulta periódica), em vez de receber notificações push.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Gerado automaticamente na ativação |
Configurações específicas:
- Unidade China -- código da unidade para operações com produtos da linha China.
- Unidade Gendai -- código da unidade para operações com produtos da linha Gendai.
CEP obrigatório: sim. Tempo estimado de entrega obrigatório: sim.
Momento de envio do pedido: o GCom realiza polling; os pedidos ficam disponíveis para consulta, mas não são notificados ativamente.
Diferente dos outros ERPs, o GCom não recebe notificações de novos pedidos. O sistema GCom faz a consulta periódica (polling) dos pedidos pendentes.
Teknisa
A Teknisa utiliza autenticação via token de API com identificação da filial (subsidiary).
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Token de API da Teknisa |
Código da Filial (subsidiaryCode) | Código da filial no sistema Teknisa |
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
TOTVS Chef
O TOTVS Chef utiliza autenticação via token com validação automática na ativação.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Token de autenticação do TOTVS Chef |
| Código do Estabelecimento | Código do estabelecimento no TOTVS |
CEP obrigatório: sim. O cliente precisa informar o CEP ao realizar o pedido.
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
Menew
A Menew utiliza autenticação OAuth com renovação automática de token a cada 2 horas.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Estabelecimento | Código do estabelecimento na Menew |
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
O token da Menew expira a cada 2 horas. O MeuCardapio.ai renova automaticamente antes da expiração. Não é necessária intervenção manual.
RP Info
O RP Info utiliza autenticação via usuário e senha com token renovável automaticamente. O sistema se comunica com a API REST do RP Info para envio de pedidos e importação de produtos.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token | Token de autenticação gerado automaticamente via API |
| Loja/Unidade | Código da unidade no sistema RP Info |
| Espécie | Código da espécie do documento fiscal |
| Código do Documento | Identificador do tipo de documento |
| URL da API | Endereço da API REST do RP Info (ex: http://servidor:porta) |
Funcionalidades suportadas:
- Envio de pedidos -- pedidos são enviados ao RP Info com dados do cliente, endereço e itens.
- Alteração de pedidos -- pedidos já enviados podem ser atualizados via API.
- Cancelamento de pedidos -- pedidos podem ser cancelados no RP Info.
- Importação de produtos -- importa produtos paginados com categorias (departamentos) do RP Info.
- Cadastro de clientes -- o sistema cria/consulta automaticamente o cliente no RP Info usando CPF/CNPJ antes de enviar o pedido.
Momento de envio do pedido: o pedido é enviado assim que recebe o status Novo.
O RP Info não suporta integração com mesas/comandas. Pedidos feitos via QR Code em mesas não serão enviados ao RP Info.
O token do RP Info possui validade definida pelo servidor. O MeuCardapio.ai renova o token automaticamente quando detecta que está expirado.
Consumer
O Consumer utiliza uma integração baseada em eventos (event-driven). Em vez de enviar o pedido diretamente via API, o MeuCardapio.ai cria eventos de pedido que o Consumer consome via polling.
Credenciais necessárias:
| Campo | Descrição |
|---|---|
| Token de Acesso | Gerado automaticamente pelo MeuCardapio.ai com base no domínio da empresa |
Como funciona:
- Ao ativar a integração, o MeuCardapio.ai gera automaticamente um token de acesso e as URLs de comunicação.
- Essas credenciais devem ser configuradas no painel do Consumer (no lado do parceiro).
- O Consumer faz polling nas URLs fornecidas para buscar novos pedidos.
URLs geradas automaticamente:
| Endpoint | Descrição |
|---|---|
/apiconsumer/events:polling | Polling de eventos de novos pedidos |
/apiconsumer/orders | Consulta de pedidos |
/apiconsumer/orders/status | Atualização de status dos pedidos |
/apiconsumer/orders/infodetails | Detalhes dos pedidos |
Funcionalidades suportadas:
- Envio de pedidos -- via eventos de criação de pedido (o Consumer consome os eventos).
- Mapeamento de bandeiras -- suporte completo a bandeiras de cartão de crédito (Visa, Mastercard, Diners, Amex, Hipercard, Elo, Aura, etc.) e vale-refeição (VR Beneficios, Sodexo, Ticket, Good Card, Green Card, etc.).
Tempo estimado de entrega obrigatório: sim. Todo pedido de delivery precisa conter o tempo estimado de entrega.
Momento de envio do pedido: o evento de pedido é criado assim que o pedido recebe o status Novo.
Diferente dos outros ERPs, a integração Consumer não requer credenciais externas. Basta ativar a integração e copiar o token e as URLs geradas para configurar no painel do Consumer. Veja a documentação do Consumer para mais detalhes.
Fluxo de Sincronização
A integração com ERPs opera em quatro eixos de sincronização:
1. Produtos
O MeuCardapio.ai importa o catálogo de produtos do ERP e vincula pelo Código PDV. A importação pode ser feita de forma assíncrona (em segundo plano) para catálogos grandes.
Caminho: Integrações > ERP > Importar Produtos
O fluxo de importação:
- O sistema consulta os produtos disponíveis no ERP.
- Produtos novos (sem vínculo) são listados para seleção.
- O operador escolhe quais produtos importar.
- Os produtos importados recebem o código PDV correspondente.
2. Preços
A sincronização de preços atualiza os valores dos produtos no MeuCardapio.ai com os preços cadastrados no ERP.
Caminho: Integrações > ERP > Sincronizar Preços
- É possível sincronizar todos os preços ou apenas os alterados desde a última sincronização.
- A data da última sincronização é registrada automaticamente.
3. Estoque / Disponibilidade
A sincronização de estoque marca produtos como indisponíveis no cardápio digital quando estão em falta no ERP. Funciona tanto para produtos quanto para opções de adicionais.
Caminho: Integrações > ERP > Sincronizar Estoque
O sistema verifica:
- Produtos com estoque zerado ou marcados como indisponíveis no ERP.
- Opções de adicionais vinculadas a itens indisponíveis.
- Tamanhos de produto (para pizzas e similares) indisponíveis.
A sincronização de disponibilidade ocorre automaticamente em intervalos regulares. Não é necessário executá-la manualmente, mas a opção está disponível para situações urgentes.
4. Pedidos
O envio de pedidos é o fluxo principal da integração. Quando um pedido chega ao MeuCardapio.ai, ele é convertido para o formato do ERP e enviado automaticamente.
O fluxo:
- Cliente faz o pedido no cardápio digital.
- Pedido entra no MeuCardapio.ai com status Novo.
- O sistema converte o pedido para o DTO do ERP (incluindo produtos, adicionais, formas de pagamento e endereço).
- O pedido é enviado ao ERP.
- A referência externa (ID no ERP) é salva no pedido.
Ações suportadas:
- Adicionar pedido -- envia pedido novo ao ERP.
- Alterar pedido -- atualiza pedido existente no ERP (quando suportado).
- Cancelar pedido -- cancela o pedido no ERP com motivo.
- Fechar comanda -- envia o fechamento de comanda ao ERP (para operações com mesas).
Operação com Mesas e Comandas
Alguns ERPs suportam integração com o módulo de mesas/comandas do MeuCardapio.ai. Quando ativa, os pedidos feitos via QR Code na mesa são enviados ao ERP vinculados à comanda correspondente.
| ERP | Integração com Comandas | Observação |
|---|---|---|
| Tiny ERP | Sim* | Somente no fechamento da comanda (configurável) |
| Eclética | Sim | Suporte nativo, incluindo via DMWS |
| Saipos | Sim | Envio por comanda |
| BlueSoft | Sim | Envio por comanda |
| GCom | Sim | Via polling |
| Teknisa | Sim | Envio por comanda |
| TOTVS Chef | Sim | Envio por comanda |
| Menew | Sim | Envio por comanda |
| RP Info | Não | Não suporta mesas/comandas |
| Consumer | Não | Não suporta mesas/comandas |
Catálogos Multi-empresa
Para redes com múltiplas unidades utilizando o mesmo catálogo, a sincronização de disponibilidade pode operar por empresa. Nesse modo:
- Cada unidade tem sua própria disponibilidade de produtos e opções.
- Um produto pode estar disponível na unidade A e indisponível na unidade B.
- O sistema cria registros de
ProdutoNaEmpresaeOpcaoNaEmpresapara gerenciar a disponibilidade individual.
Quando o catálogo opera com "disponibilidade por empresa", a sincronização de estoque cria registros separados para cada unidade. Essa configuração é definida no catálogo da rede.
Solução de Problemas
O pedido não foi enviado ao ERP
- Verifique se a integração está ativa em Integrações > ERP.
- Confirme que o token/credencial não expirou. Para Saipos e Menew, o token é renovado automaticamente; caso falhe, reative a integração.
- Verifique se o produto possui Código PDV preenchido. Sem esse código, o ERP pode rejeitar o pedido.
- Confira se as formas de pagamento estão mapeadas corretamente.
Produto aparece como disponível no ERP mas indisponível no cardápio
- Execute uma sincronização manual de estoque em Integrações > ERP > Sincronizar Estoque.
- Marque a opção "Todos" para forçar a resincronização completa (ignorando a data da última sincronização).
- Verifique se o produto está vinculado pelo Código PDV correto.
Erro "Integração com sistema parceiro não está ativada"
Esse erro indica que a empresa não possui uma integração ativa. Acesse o painel e ative a integração com o ERP desejado.
Token expirado (Saipos / Menew)
O sistema renova o token automaticamente. Se a renovação falhar:
- Verifique se as credenciais do parceiro (idPartner/secret) estão corretas.
- Confirme que o serviço do ERP está online.
- Desative e reative a integração para forçar a geração de um novo token.
Produtos não aparecem na importação
- Confirme que os produtos estão cadastrados e ativos no ERP.
- Verifique se a árvore mercadológica (categorias) está configurada no ERP.
- Tente acessar Integrações > ERP > Listar Produtos para verificar se a comunicação com o ERP está funcionando.
CEP obrigatório mas não preenchido
Alguns ERPs (Eclética, BlueSoft, GCom, TOTVS Chef) exigem CEP no pedido. Configure o formulário de endereço para tornar o campo CEP obrigatório nas configurações da loja.
Perguntas Frequentes
Posso usar mais de um ERP ao mesmo tempo? Não. Cada estabelecimento pode ter apenas uma integração ERP ativa por vez.
Preciso recadastrar todos os produtos depois de ativar a integração? Não. Use a função de importação para vincular os produtos existentes no MeuCardapio.ai com os do ERP pelo Código PDV.
A sincronização de estoque é em tempo real? A sincronização ocorre em intervalos regulares e também pode ser disparada manualmente. Para o GCom, o próprio ERP faz polling dos dados.
O que acontece se o ERP estiver fora do ar? O pedido é registrado normalmente no MeuCardapio.ai. O envio ao ERP falha silenciosamente, e o pedido pode ser reenviado manualmente quando o serviço voltar.
Posso desativar a integração sem perder os dados? Sim. Ao desativar a integração, os vínculos (Código PDV) dos produtos são mantidos. Ao reativar, os produtos continuam vinculados.
Qual a diferença entre "Importar Produtos" e "Sincronizar Produtos"? "Importar Produtos" busca produtos novos do ERP que ainda não existem no cardápio. "Sincronizar" atualiza dados (preço, estoque, disponibilidade) dos produtos já vinculados.