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.
| Cardápio Web → Fácil123 | Fácil123 → Cardápio Web | |
|---|---|---|
| Cadastro de produtos | ✓ | ✗ |
| Cadastro de clientes | ✗ | ✗ |
| Pedidos | ✓ | ✗ |
| Meio de pagamento | ✓ | ✗ |
| Frete | ✗ | ✗ |
| Desconto | ✗ | ✗ |
| Estoque | ✗ | ✗ |
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.
Configurando a integração com o Cardápio Web
Obtendo o token no Cardápio Web
- Acesse o Cardápio Web com credenciais de Administrador
- Clique em Configurações → Integrações
- Clique em API → Copiar Token
Instalando na Loja de Apps
- No Fácil123, clique na Engrenagem
- Clique em Loja de Apps
- Localize Cardápio Web e clique em Instalar
- Cole o token copiado no campo Chave da API
- Clique em Salvar
Configurando a plataforma de vendas
- Clique na Engrenagem
- Clique em Plataforma de Vendas
- Clique em Incluir
- Clique em Cardápio Web
- Preencha o nome da plataforma
- Em Aplicativo, selecione Cardápio Web
- Selecione o Quadro e a Etapa de vendas
- Se desejar, vincule a um Canal de vendas
- Selecione o Depósito
- Clique em Salvar
Cadastrando código do produto
Para que o Fácil123 reconheça os produtos vendidos, o código precisa estar cadastrado.
- No Fácil123, acesse Compras → Produtos
- Localize o produto, clique nos três pontinhos e clique em Plataforma de Vendas
- Selecione Cardápio Web, preencha a Chave do produto com o ID e clique em 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:
| Forma de pagamento no Cardápio Web | Nome no Fácil123 |
|---|---|
| Dinheiro | Dinheiro |
| Cartão de crédito | Cartão de crédito |
| Cartão de débito | Cartão de débito |
| PIX | PIX |
| PIX automático | PIX automático |
| Vale refeição | Vale refeição |
| Vale alimentação | Vale alimentação |
| Transferência bancária | Transferência bancária |
| Boleto | Boleto |
| PicPay | PicPay |
| Crediário | Crediário |
| Cartão de crédito online | Cartão de crédito online |
| iFood | iFood |
| Desconto iFood | Desconto iFood |
| 99Food | 99Food |
| Desconto 99Food | Desconto 99Food |
Para cadastrar no Fácil123:
- Acesse Vendas → Meios de pagamento → Incluir
- No campo Nome, digite exatamente o nome da coluna "Nome no Fácil123" da tabela acima
- Preencha as demais configurações e clique em 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.