Integração com Cardápio Web

A integração do Fácil123 com o Cardápio Web importa os pedidos concluídos para emissão de NF-e, controles financeiros, gestão de estoque e acompanhamento de métricas de vendas.

Sobre a integração entre sistemas

A integração entre Fácil123 e Cardápio Web não foi projetada para gerenciar pedidos em tempo real. O sistema importa pedidos resolvidos do Cardápio Web para permitir emissão de NF-e, controles financeiros, gestão de estoque e acompanhamento de métricas de vendas.

Pedidos: O Fácil123 importa pedidos atualizados nas últimas 24 horas com status "Fechado". Tentar importar pedidos mais antigos que 24 horas gera um erro. Pedidos legados que são modificados no Cardápio Web são reenviados e atualizados no Fácil123.

Clientes: Os cadastros de clientes do Cardápio Web contêm apenas nome e telefone. Pedidos podem ser emitidos sem dados do cliente. Por isso, todos os pedidos são importados como "consumidor final" com os nomes aparecendo nas observações. Quando nenhum cliente é especificado, "não informado" é exibido nas observações.

Produtos: O Fácil123 importa produtos fazendo correspondência pelo ID do item. Produtos com complementos importam cada opção como itens separados.

Forma de pagamento: As parcelas do pedido são importadas para o campo de pagamento da venda. Para que o Fácil123 reconheça cada forma de pagamento, você precisa ter meios de pagamento ativos com nomes específicos. Veja Cadastrando meios de pagamento.

Configurar integração com Cardápio Web

No Cardápio Web

1. Acesse o Cardápio Web com credenciais de Administrador
2. Clique em Configurações → Integrações
3. Clique em API → Copiar Token

No Fácil123

1. Clique no ícone de engrenagem → Plataforma de vendas
2. Clique em Incluir → Cardápio Web
3. Insira o nome da plataforma
4. Selecione o Quadro e a Etapa para os pedidos importados
5. Caso queira vincular o Cardápio Web com algum canal de venda selecione no campo correspondente
6. Cole o token da API em Chave da API → Salvar

Cadastrando código do produto

Para que o Fácil123 reconheça os produtos vendidos, o código precisa estar cadastrado.

1. No Fácil123, acesse Compras → Produtos
2. Localize o produto → clique nos três pontinhos → Plataforma de Vendas
3. Selecione Cardápio Web e preencha a Chave do produto com o ID → Salvar

Localize o ID nas informações do produto no Cardápio Web usando o Código interno.

Cadastrando meios de pagamento

O Cardápio Web tem um conjunto fixo de formas de pagamento.
Para que uma parcela seja importada, é preciso ter um meio de pagamento ativo no Fácil123 com o nome correspondente à forma que veio do Cardápio Web.

A correspondência ignora maiúsculas e minúsculas. A tabela abaixo mostra cada forma de pagamento do Cardápio Web e o nome que o meio de pagamento precisa ter no Fácil123:

Para cadastrar no Fácil123:

1. Acesse Vendas → Meios de pagamento → Incluir
2. No campo Nome, digite exatamente o nome da coluna "Nome no Fácil123" da tabela acima
3. Preencha as demais configurações → Salvar

Cadastre apenas as formas de pagamento que seu estabelecimento realmente usa no Cardápio Web. Meios de pagamento arquivados não são considerados na importação.

Erros na importação de pedidos

Produto XXXXXX: não foi encontrado um produto com esse código no Fácil123.

Esse erro mostra que o vínculo do produto não foi feito no Fácil123. Para solucionar basta seguir esse passo a passo.

Meio de pagamento "XXXXXX" não encontrado.

O Cardápio Web enviou uma forma de pagamento que não corresponde a nenhum meio de pagamento ativo no Fácil123.
Cadastre um meio de pagamento com o nome indicado no erro seguindo esse passo a passo.

Perguntas e respostas

1 - Posso usar essa integração para gerenciamento de pedidos de restaurante em tempo real?
R: O Fácil123 importa apenas pedidos fechados. A integração não foi projetada para gerenciamento de pedidos em tempo real.

2 - Como importo pedidos da semana passada?
R: O Cardápio Web entrega apenas pedidos atualizados nas últimas 24 horas. Não é possível importar pedidos mais antigos.