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 exige Loja online (add-on) ou acesso legado equivalente, 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. Confira o Modo: Entrega, Retirada (balcão) ou No local. Quando o comprovante diz Endereço: Balcão, o ERP já marca Retirada. Retirada e no local não geram corrida para entregador nem taxa de entrega. Se aparecer o aviso de endereço incompleto, confira se o cliente vai buscar.
5. 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.
6. 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.
7. Confirme a forma de pagamento.
8. Escolha se envia para a cozinha (padrão: só registrar no ERP, sem cozinha).
9. 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.

Por padrão, marcar Pronto não chama os entregadores da Vitrine. Quem busca o pedido do Mais Delivery é o motoboy desse app. A loja só passa a usar a frota dela (própria ou rede Vitrine) se o franqueado ligar isso na configuração da cidade. Pedido com mais de 4 horas não é enviado mesmo com essa opção ligada.

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).

Importei errado, cancelei e quero colar de novo o mesmo número? Sim. Em Colar pedido, cole o texto do comprovante Mais Delivery (formato 1x NOME - R$ …, não a tela do ERP). Se o pedido estiver cancelado, confirme com Reabrir com vínculos novos — o mesmo # é reaberto sem duplicar. Pedido ainda ativo não pode ser colado de novo.

O vínculo memorizado veio errado (ex.: Coca Zero no lugar da Coca)? Na prévia, o ERP avisa quando o nome do pedido não bate com o produto memorizado e não pré-seleciona. Escolha o produto certo e deixe Lembrar associações marcado para corrigir os próximos. Se só o preço for diferente do catálogo, o vínculo memorizado continua pré-selecionado (o ERP mantém o preço do Mais Delivery).

Vinculei todos os sabores da pizza e mesmo assim pediu produto no catálogo? Sabores/complementos são filhos do produto principal (ex.: PIZZA EXTRA GG). Vincule os dois: o produto no topo do bloco e cada sabor. Se todos os sabores apontam ao mesmo item do catálogo, o ERP pode inferir o produto principal automaticamente ao confirmar.

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.

Colei 7x lanche e o valor ficou multiplicado demais (ex.: R$ 1.568)? O cupom do Mais Delivery às vezes mostra o total da linha (7x X TUDO - R$ 224,00), não o unitário. O ERP agora detecta isso pelo Sub Total. Se um pedido antigo ficou errado, cancele e cole de novo (ou peça suporte para corrigir a linha).

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.