--- title: "Integrações e API: arquivos, pedidos e POD | OptiRoutes" description: "Conecte a OptiRoutes ao seu ERP: upload de Excel e CSV, FTP ou SFTP, Files API para pedidos e PODs assinados, API de relatórios, exportação de rotas e webhooks." url: https://optiroutes.com/pt/integrations/ lang: pt-BR updated: 2026-10-24 --- # Integrações e API A OptiRoutes se conecta aos sistemas que você já usa. Os pedidos entram por um arquivo Excel ou CSV, por FTP ou SFTP ou por uma Files API segura; as notas de entrega assinadas, as exportações de rotas e os relatórios voltam pelo mesmo caminho. Uma API de relatórios entrega os seus dados a ferramentas de BI, e endereços web recebem relatórios de entrega e exportações de rotas à medida que acontecem. ## Quais integrações a OptiRoutes oferece? | Necessidade | Como a OptiRoutes atende | | --- | --- | | Carregar os pedidos do dia | Upload de Excel ou CSV, carregamento automático por FTP, SFTP ou pela Files API, em CSV, JSON ou TXT de largura fixa. | | Coletar os PODs assinados | Chamadas da Files API por dia ou por pedido, ou um ZIP por dia; cópias por e-mail. | | Enviar as rotas ao seu sistema | Exportação de rotas em CSV, XLSX, XML, JSON ou TXT, para um arquivo, o seu FTP, a pasta da empresa ou um endereço web. | | Levar relatórios ao BI ou ao ERP | A API de relatórios: pedidos, rotas, motoristas, clientes, POD e um resumo diário das entregas. | | Reagir a cada entrega | Um endereço de relatórios de entrega que recebe cada relatório no momento em que é feito. | | Pagar pelo serviço | Stripe Checkout para recargas pré-pagas e recarga automática. | ## Como carregar pedidos de um arquivo, FTP ou SFTP A integração mais simples é o arquivo que o seu sistema já exporta. Na tela de pedidos, **Carregar entregas** lê um arquivo Excel ou CSV; você associa uma única vez cada campo do sistema — endereço, nome do cliente, número do pedido, quantidade e assim por diante — ao nome da sua coluna, e todo arquivo posterior é carregado da mesma forma. Para um arquivo TXT de largura fixa, você informa as posições dos caracteres em vez dos nomes das colunas. É possível ignorar linhas por uma palavra-chave nas observações, uma segunda palavra-chave pode substituir o endereço, e você decide se um número de pedido existente é atualizado ou adicionado como novo. Para tirar as pessoas do processo, escolha um método de carregamento automático nas configurações: - **O servidor de arquivos da OptiRoutes** — o seu sistema deposita o arquivo diário, nomeado pela data, na pasta da sua empresa no servidor FTP ou no servidor SFTP criptografado. - **O seu próprio servidor FTP** — a OptiRoutes se conecta com o usuário que você fornecer e carrega o arquivo com a data de hoje no nome ou o arquivo atualizado mais recentemente. - **Importação e exportação automáticas** — os pedidos entram sozinhos e as rotas também são planejadas, sem nenhum clique. - **A Files API** — o seu software envia o arquivo de pedidos por HTTPS, conforme descrito abaixo. Na tela de clientes, um arquivo Excel ou CSV com número do cliente, nome, endereço, tempo de parada e horários de abertura e fechamento cria ou atualiza os clientes e as suas janelas de horário. ## A Files API: pedidos entrando, PODs e relatórios saindo Cada empresa na OptiRoutes tem a própria pasta privada de arquivos: os pedidos que carrega, as notas de entrega assinadas com fotos e assinaturas, as exportações de rotas e os relatórios de fim de dia. A **Files API** permite que os seus sistemas leiam e gravem nessa pasta diretamente por HTTPS, sem servidor FTP no meio. O gerente da empresa alterna entre FTP e a API em **Configurações → API e arquivos** e cria as chaves ali mesmo — não é preciso pedir ao suporte, e as empresas novas já começam na API. | Pasta | O que contém | Quem grava | | --- | --- | --- | | orders_files/ | O arquivo diário de pedidos e as exportações de rotas. | Você (pedidos), a OptiRoutes (exportações) | | pod/YYYY/MM/DD/ | Os PODs assinados daquele dia: o PDF assinado, a assinatura e as fotos. | OptiRoutes | | pod/ | Notas de entrega de origem a serem assinadas no app do motorista, um PDF por número de pedido. | Você | | reports/YYYY/MM/ | Relatórios de fim de dia e de devoluções. | OptiRoutes | | podBaseFile/ | O formulário-base de POD. | Você | | inbox/ | Uma pasta livre para os arquivos que você quiser entregar. | Você | A pasta da empresa na Files API. As chamadas cobrem a verificação da chave, a listagem de uma pasta, o download, o upload (até 50 MB por arquivo) e a exclusão dos arquivos que você enviou, a listagem dos arquivos de POD de um dia por pedido e tipo e o download de todos os arquivos de POD de um dia em um único ZIP. O guia traz exemplos de código em Python, C# e Node.js, além de um script PowerShell que mantém uma pasta do seu servidor sincronizada com a pasta da empresa — para que uma equipe acostumada ao FTP continue trabalhando do mesmo jeito. Leia o [guia da Files API](https://srv2.optiroutes.com/api/v1/docs?lang=pt). ## Como as chaves de API são protegidas? - **Privilégio mínimo** — cada chave recebe apenas as permissões de que precisa: só PODs assinados, leitura de todos os arquivos ou upload de pedidos e de arquivos da inbox. - **Endereços autorizados** — uma chave pode ser limitada aos endereços IP fixos do seu servidor. - **Validade e rotação** — uma chave pode expirar após um número de dias; crie uma chave nova, faça a troca e depois revogue a antiga, sem interrupção. - **Revogação imediata** — uma chave revogada para de funcionar em até 30 segundos. - **Auditoria** — cada chamada é registrada com horário, endereço, arquivo e resposta, e exibida ao gerente. - **Armazenamento seguro** — a OptiRoutes guarda apenas uma impressão digital SHA-256 de cada chave; as conexões usam HTTPS com TLS 1.2 ou superior, e uma chave só acessa a pasta da própria empresa. Limites: 300 requisições por minuto por chave, 50 MB por arquivo, 20 chaves ativas por empresa e até 5.000 itens em uma listagem de pasta. ## A API de relatórios e de envio Para ferramentas de relatórios e conectores de ERP, uma API separada em api-users.optiroutes.com fornece os dados da sua empresa como relatórios e aceita dados enviados. Um único endereço e um único token, emitidos pela OptiRoutes para a sua empresa, cobrem todas as chamadas. A página de documentação permite colar o seu token e ver quais relatórios estão disponíveis para você e o mapeamento de colunas da sua conta: [leia a documentação da API](https://api-users.optiroutes.com/api-docs/en). | Relatório | O que retorna | | --- | --- | | orders | Pedidos e entregas, com rota e motorista. | | routes | Rotas, com motorista e número de paradas. | | drivers | Dados dos motoristas. | | customers | Dados e endereços dos clientes. | | pod | Documentação das entregas. | | delivery-summary | Um resumo diário por status. | Duas chamadas de envio funcionam no sentido inverso: enviar pedidos grava o arquivo de pedidos do dia e inicia o carregamento automático, e enviar motoristas, linhas e veículos substitui a frota inteira, como um arquivo de frota. Como a lista de motoristas enviada conta como a frota completa, envie sempre todos os motoristas, e não apenas as alterações. ## Exportação de rotas e webhooks A exportação de rotas grava as rotas marcadas em CSV, XLSX, XML, JSON ou TXT de largura fixa. Uma tabela de colunas define quais campos saem e com qual cabeçalho, é possível acrescentar colunas originais do seu arquivo de pedidos e, com a gestão de itens, um segundo arquivo lista todos os itens. As exportações podem ir para o seu computador, para o seu servidor FTP ou para a pasta da empresa, e, em JSON, também podem ser enviadas a um endereço web; se o envio falhar, o sistema tenta mais uma vez. Para cada entrega no momento em que acontece, preencha o **endereço de relatórios de entrega** nas configurações do app do motorista: cada relatório de entrega feito pelos motoristas também é enviado para lá, de modo que outro sistema seu se atualiza sozinho. ## E-mail, pagamentos, mapas e mensagens - **E-mail** — as notas de entrega assinadas saem da sua própria conta Gmail com uma senha de app do Google; relatórios como o de paletes do fim do dia vão para o seu e-mail de relatórios; os clientes pagantes recebem recibos e os motoristas, confirmações de depósito do Caixa. - **Pagamentos** — as recargas são pagas em uma página de pagamento segura da Stripe, com cartão salvo opcional para a recarga automática. - **Endereços e mapas** — os endereços são escolhidos entre as sugestões do Google e verificados no mapa antes do planejamento. - **Navegação** — o app do motorista passa cada parada ao Waze, ou ao Apple Maps no iPhone, por endereço ou por coordenadas exatas. - **SMS e WhatsApp** — mensagens de chegada e links de acompanhamento aos clientes, alertas aos gestores, linhas aos subcontratados e imagens de rotas aos motoristas pelo WhatsApp. Está planejando uma integração com o seu ERP ou sistema de armazém? Conte-nos o que precisa conectar. [Comece o teste gratuito](https://glob-a.optiroutes.com/auth/register?utm_source=site&utm_medium=cta&utm_campaign=integrations) ## Perguntas frequentes ### A OptiRoutes consegue carregar pedidos automaticamente do nosso ERP? Sim. O seu ERP pode depositar um arquivo diário no servidor FTP ou SFTP da OptiRoutes ou no seu próprio servidor FTP, ou enviá-lo pela Files API, e a OptiRoutes o carrega sozinha. ### Como levamos os PODs assinados para o nosso sistema? Pela Files API: liste e baixe os arquivos de POD de um dia, ou baixe todos em um único ZIP. Uma cópia também é enviada por e-mail conforme as suas regras de envio. ### Quem cria as chaves da Files API? O gerente da empresa, em Configurações, API e arquivos. As chaves têm permissões, endereços autorizados e validade opcionais e podem ser revogadas a qualquer momento. ### Existe uma API de relatórios? Sim. A API de relatórios retorna pedidos, rotas, motoristas, clientes, POD e um resumo diário das entregas, com um token emitido pela OptiRoutes. ### Em quais formatos de arquivo podemos exportar as rotas? CSV, XLSX, XML, JSON e TXT de largura fixa, com as colunas e os cabeçalhos que você escolher. --- OptiRoutes · 1235 Jefferson Ave, Redwood City, CA 94062, USA · yoni@optiroutes.com · https://optiroutes.com/pt/