FAQ da API MaisEntregas - Dúvidas e perguntas sobre nossa documentação
9 min
Criado por Luiz Moura em 11/10/2021 15:55
Atualizado por Dimas Oliveira em 30/01/2026 08:32
Neste artigo responderemos as principais perguntas para você que quer integrar um sistema parceiro com o sistema MaisEntregas.Pra facilitar a navegação, vamos apresentar primeiro as perguntas e em seguida vamos responder uma a uma.Principais perguntas: 1. Onde encontrar documentação de integração API?**2.**Quem deverá fazer a integração entre o Sistema parceiro e o sistema MaisEntregas?**3.**Por que é melhor que o sistema parceiro realize a integração e não a MaisEntregas?4. Pode integrar com qualquer sistema?5. Se o sistema parceiro não se disponibilizar para realizar a integração, a MaisEntregas pode realizar este serviço?6. Como posso tirar dúvidas técnicas sobre a integração e documentação API da MaisEntregas?7. Quais os dados a serem enviados para "gerar o pedido"?8.“client” é o e-mail do cliente?9. O valor da entrega é o campo "value" dentro do "billing"?10. No envio dos endereços no "address" devemos enviar primeiro o endereço de retirada e depois o de entrega? Nesta ordem?11. O cancelamento pode ser realizado a qualquer momento?12. Por que recebo o erro error.address.notFound – Endereço #2 não foi localizado ao enviar um pedido via API, e como posso corrigir?Se após a leitura deste artigo, você ainda tiver dúvidas, entre em contato com o nosso Suporte.**Contatos do time de Suporte:**Suporte WhatsApp: (71) 99161-6127 - Link rápido: https://bit.ly/suporte_maisentregas.Botão atendimento na sua plataforma (balão verde na parte de baixo da tela).Central de Ajuda: https://maisentregas.movidesk.com/kbSegue abaixo as respostas para as principais perguntas sobre integração e nossa API.1. Onde encontrar documentação de integração API?**R.**Link da nossa documentação de Integração: https://docs.google.com/document/d/1rlo0k7mXyFl5YCizjinI5JMth13sWi8HNGEnOfL8UBk/edit**2.**Quem deverá fazer a integração entre o Sistema parceiro e o sistema MaisEntregas?R: Sempre que tivermos um sistema que vai mandar o pedido pela API, o ideal é que a integração inicie pelo time de desenvolvimento desse sistema, pois o fluxo começa com eles enviando dados do pedido para a plataforma Mais Entregas. Nossa API é muito simples e em poucas horas conseguem integrar. Para isso, basta enviar a documentação acima (item 1) para o parceiro que vai integrar, enfatizando que eles iniciem.3.Por que é melhor que o sistema parceiro realize a integração e não a MaisEntregas?R: Imagine que você está esperando uma encomenda. O que é melhor: ir na porta da sua casa a cada 10 minutos ou esperar a campainha tocar? Claro que esperar a campainha tocar, pois assim você não precisa usar seu tempo de forma desnecessária fazendo uma verificação a toa. O sistema MaisEntregas funciona de forma semelhante. Nosso sistema "espera" receber pedidos de corrida. Então é sempre preferível que o pedido seja enviado para nós ao invés de termos que consultar de tempos em tempos se tem algum pedido novo para que seja criada uma corrida. 4. Pode integrar com qualquer sistema?R: Podemos integrar com qualquer sistema por nossa API (temos uma API aberta). Nossa API tem como principal funcionalidade receber de outro sistema os dados de um pedido, venda, etc, gerar uma corrida no nosso sistema (OS) e devolver para esse sistema que está integrando, o status da corrida (entregador alocado, horários, status, fotos etc).5. Se o sistema parceiro não se disponibilizar para realizar a integração, a MaisEntregas pode realizar este serviço?R: A MaisEntregas pode realizar a integração em alguns casos após análise, principalmente se for uma integração importante, estratégica. No entanto, esse é um serviço pago e que precisaremos analisar a documentação do sistema a ser integrado. Com a documentação em mãos iremos orçar o serviço de integração. Como a análise da documentação requer tempo do time de desenvolvimento, também cobramos pelo orçamento. Caso o serviço de integração seja fechado, o valor do orçamento será descontado do valor do serviço.Caso tenha interesse em realizar esta negociação, nos envie a documentação da API do sistema do parceiro e abra um ticket nos canais de Suporte, indicados abaixo, para que o time de Tecnologia possa avaliar. Após esta análise a nossa equipe irá retornar informando custo, prazo e podendo solicitar mais detalhes ao parceiro para fazermos a integração.6. Como posso tirar dúvidas técnicas sobre a integração e documentação API da MaisEntregas?R: Para tirar dúvidas técnicas sobre integração, formalize a dúvida por escrito para nosso time de Suporte. A dúvida será encaminhada para o time de Tecnologia para que a sua dúvida seja sanada. O nosso time de Suporte irá formalizar para você a resposta do time de Tecnologia.7. Quais os dados a serem enviados para "gerar o pedido"?R: Todas as informações marcadas como requeridas são obrigatórias. Elas devem ser enviadas no "body".8.“client” é o e-mail do cliente?R: É o e-mail do cliente da transportadora9. O valor da entrega é o campo "value" dentro do "billing"?R: Sim, seria o valor já calculado da corrida.10. No envio dos endereços no "address" devemos enviar primeiro o endereço de retirada e depois o de entrega? Nesta ordem?**R:**Sim, devem ser enviados nas ordens correspondentes, pode ser manipulado posteriormente, porém inicialmente deve ser enviado na ordem esperada para que o entregador siga.11. O cancelamento pode ser realizado a qualquer momento?**R:**O usuário da transportadora consegue a qualquer momento, já o usuário cliente apenas se a corrida não tiver em andamento ainda.12. Por que recebo o erro error.address.notFound – Endereço #2 não foi localizado ao enviar um pedido via API, e como posso corrigir?**R:**Esse erro ocorre quando o endereço informado no pedido (por exemplo, o endereço de entrega #2) não é encontrado na base da API nem pelo Google Maps, que é utilizado como consulta secundária. Atualmente, não existe um endpoint para cadastro ou validação prévia de endereços.Para evitar o erro, existem duas alternativas:
Observação: mesmo seguindo essas recomendações, não há garantia de que o endereço será encontrado, pois a pesquisa via API é diferente da realizada diretamente no Google.Para mais detalhes favor assistir o vídeo: Como funciona a integração via API da MaisentregasQualquer dúvida, favor acionar o time de suporte, através da abertura de ticket no Movidesk.