Integrar o Mais Delivery ao ERP

O que é

A integração traz os pedidos do Mais Delivery para o ERP. Depois de configurar e revisar os vínculos, você acompanha o preparo, altera o status do pedido, baixa o estoque e registra o financeiro sem digitar a venda novamente.

No PDV, os pedidos também aparecem na fila Pedidos (junto com loja e comandas) e abrem no próprio caixa. Editar itens no PDV grava só no sistema local — não altera o carrinho no app do Mais Delivery.

O recurso está disponível no plano ERP Premium e é ativado separadamente para cada empresa.

Como conectar

1. Entre no ERP da empresa.
2. No menu, acesse Integrações.
3. No cartão Mais Delivery, informe o código do restaurante, o ID da empresa integrada, o Access Token e o Basic Auth fornecidos no painel do Mais Delivery.
4. Mantenha o ambiente de teste enquanto estiver homologando.
5. Confira a comissão informada e clique em Conectar e testar.
6. Aguarde o ERP buscar situações, formas de pagamento e produtos.

As credenciais ficam protegidas e não são mostradas novamente na tela.

Vincular produtos

O código de produto do Mais Delivery é diferente do código interno do ERP.

1. Na seção Vínculo de produtos, localize o produto recebido.
2. Busque o item correspondente no catálogo do ERP.
3. Clique em Salvar vínculo.
4. Se o item não deve controlar estoque, marque Item sem controle de estoque.

Não é necessário copiar ou digitar IDs. O vínculo fica salvo para os próximos pedidos.

Configurar pagamentos e status

Em Formas de pagamento, escolha a forma equivalente no ERP e indique se o pagamento acontece online ou na entrega. Para pagamento online, selecione a conta financeira e a regra de liquidação do Mercado Pago quando existirem.

Em Status dos pedidos, relacione as situações do Mais Delivery com as etapas Aceito, Em preparo, Pronto, Em entrega, Entregue e Cancelado.

Depois de resolver todas as pendências, clique em Ativar importação de pedidos.

Receber e atender pedidos

Opção A — colar texto (modo manual)

Use quando a API ainda não foi liberada pelo franqueado, ou para registrar pedidos depois do fechamento, um de cada vez.

1. Em Pedidos marketplace, clique em Colar pedido Mais Delivery.
2. Cole o texto completo do pedido (com o código #…).
3. Confira cliente, itens, cupom/desconto e totais.
4. Vincule cada item ao catálogo (necessário para estoque e ficha técnica). Se o item for um combo do Mais Delivery, escolha o produto tipo combo do ERP (kit com a ficha dos componentes) — não um item avulso que só aparece no nome.
5. Se o item tiver sabores (pizza meio a meio, etc.), vincule cada sabor ao complemento do catálogo — sem isso, o sabor fica só como texto e a ficha do sabor não baixa estoque.
6. Confirme a forma de pagamento.
7. Escolha se envia para a cozinha (padrão: só registrar no ERP, sem cozinha).
8. Confirme a importação, depois Aceite e conclua o pedido normalmente para baixar estoque/ficha e lançar no financeiro.

Em Integrações, você pode deixar o modo Manual (colar texto) ou Automática (API). No modo manual, o ERP não fica sincronizando a API (e o erro do franqueado não impede colar).

Opção B — API automática

1. Acesse Pedidos marketplace.
2. Use as abas Todos, Revisar, Novos, Em andamento, Entregues e Cancelados. Por padrão a lista mostra só o dia de hoje — use Ver todos os pedidos ou o filtro de datas para dias anteriores.
3. Abra o novo pedido sincronizado.
4. Se aparecer Revisar vínculos, resolva os itens ou pagamentos pendentes.
5. Clique em Aceitar pedido.
6. Use Imprimir no detalhe do pedido: Manual (cupom no navegador), Completo (estação/cupom) ou Cozinha (tickets de produção).
7. Atualize as etapas durante o preparo e a entrega.

No modo automático, cada mudança é enviada ao Mais Delivery. Se a conexão estiver temporariamente indisponível, o ERP mantém a atualização na fila e tenta novamente.

Comissão mensal

O ERP calcula a comissão sobre o valor dos produtos, sem incluir a entrega. A comissão não reduz o valor bruto da venda.

No início de cada mês, o fechamento cria uma conta em Contas a pagar. Confira o valor com o boleto do Mais Delivery antes de quitar.

Perguntas frequentes

Onde vejo pedidos cancelados? Em Pedidos marketplace, aba Cancelados. Inclui vendas canceladas depois de importar e pedidos recusados na Fila Zap (sem importar). Se estiver vazio, clique em Ver todos os pedidos (o padrão é só hoje).

A API está com erro do franqueado. Consigo usar mesmo assim? Sim. Em Integrações, escolha o modo Manual (colar texto) ou use Colar pedido Mais Delivery em Pedidos marketplace. O erro da API não bloqueia a cola.

O texto veio do PDF e o preço quebrou em duas linhas (R$ numa linha e o valor na seguinte). Funciona? Sim. Cole o texto completo mesmo assim — o ERP junta o preço quebrado pelo PDF.

Como vincular um combo (ex.: 2 X Tudo + Coca)? Vincule a um produto combo do catálogo (kit). Uma linha do Mais Delivery vira um produto no ERP; a ficha do combo baixa os componentes. Não use um item avulso só porque o nome aparece no texto.

Ovo, borda, calabresa vieram como produto separado? No cupom, o que vem depois do lanche/pizza no mesmo ITEM (com ou sem preço) é tratado como adicional — vincule ao complemento do produto no catálogo.

O pedido baixa estoque assim que chega? Não. O estoque é aplicado ao concluir o pedido, usando apenas os produtos vinculados.

O pagamento online entra como dinheiro disponível na hora? Não necessariamente. Ele pode ficar pendente de liquidação conforme a regra do Mercado Pago.

Posso pausar a integração? Sim. Ao pausar, o ERP deixa de buscar novos pedidos, mas preserva o histórico. No modo manual, o poll da API também fica parado.

O que acontece com produto sem vínculo? O pedido fica retido para revisão. Ele não avança nem movimenta estoque ou financeiro até a correção.

Posso usar outra integração no futuro? Sim. O ERP guarda os vínculos separadamente por marketplace, sem misturar os códigos dos parceiros.