Padrão API Open delivery
A API Open Delivery do Entregas Expressas permite que os softwares que disponibilizam integrações baseados nas específicações do open delivery se integrem à nossa plataforma sem a necessidade de efetuar novos desenvolvimentos.
Na construção dessa API, foi utilizado os modelos de dados e chamadas baseados no Open Delivery, portando, é necessário que o desenvolvimento seja baseado nesse padrão de comunicação.
Quer incluir a logo do seu software para todos os estabelecimentos que utilizam o entregas expressas?
Conclua a integração com sucesso com ao menos um cliente ativo, usando o padrão Open Delivery.
Após isso, preencha este formulário com os dados do seu software e o link da documentação.
🔁 Informações que você precisa enviar para o seu cliente (estabelecimento):
Merchant ID: Identificador do estabelecimento no seu sistema. (Deve ser fornecido pelo cliente)
Webhook URL: A URL para onde você quer receber atualizações dos pedidos. (Fornecida pelo seu cliente)
🔐 Informações que o cliente precisa fornecer para você:
Client ID: Gerado no painel Entregas Expressas para autenticação.
Client Secret: Usado junto com o Client ID para gerar tokens de acesso.
O cliente também deve preencher todas as informações no painel e ativar a integração para que tudo funcione corretamente.
O seu cliente pode obter e preencher essas informações no menu Integrações > Open Delivery do Painel do Cliente.
Informações que você precisa fornecer para seus clientes realizarem a integração:
Merchant ID: O ID do estabelecimento no seu sistema.
Webhook URL: A URL completa que os webhooks serão enviados.
Informações que eles precisarão fornecer para você:
Client ID: Identificador fornecido pelo nosso sistema para autenticação conforme descrito abaixo.
Client Secret: Secret fornecido pelo nosso sistema para autenticação conforme descrito abaixo.
Além disso, solicite que ele preencha as demais informações e marque ativar integração para que sua integração funcione corretamente.
A URL base padrão da nossa API é:
https://entregasexpressas.com.br/api/opendeliverySe o seu software for incluído oficialmente na nossa lista de parceiros, você receberá uma URL base única, mas os endpoints continuarão os mesmos.
Nosso APP-ID é:
d3e3eaf2-e585-4177-962a-7be998efab8eGerar Token de Acesso
Para autenticar suas requisições, gere um token utilizando o client_id e client_secret fornecidos pelo cliente seguindo a documentação oficial do padrão Open Delivery.
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/authentication/operation/getToken
Simular entrega (disponibilidade e preço)
Antes de criar uma entrega, você pode simular valores e disponibilidade com base nos dados fornecidos.
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/logisticPrice/operation/logisticsAvailability
Criar nova entrega
Utilize esse endpoint para registrar uma nova entrega na plataforma.
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/logisticOrder/operation/logisticsNewDelivery
Informar que o pedido está pronto para coleta
Mesmo que o sistema chame automaticamente o entregador após o tempo definido, você pode antecipar a coleta informando que o pedido está pronto.
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/logisticOrder/operation/logisticsReadyForPickup
Cancelar entrega (antes de ser aceita por um entregador)
Se a entrega ainda não foi aceita por um entregador, é possível cancelá-la usando o endpoint abaixo.
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/logisticOrder/operation/logisticsCancel
⚠️ Após aceitação pelo entregador, o pedido não pode mais ser cancelado via API.
A cada atualização de status de uma entrega (como aceito, coletado, entregue, etc.), enviaremos um webhook para a Webhook URL configurada seguindo a seguinte especificação:
📄 Documentação oficial:
https://abrasel-nacional.github.io/docs/#tag/logisticsWebhook/operation/newLogisticEvent
Preencha o Formulário abaixo para adicionarmos a logo do seu Software em nosso portal de parceiros:
https://docs.google.com/forms/d/e/1FAIpQLScG8GoSrU-ehU-r3e7w3G2Joc3UxnHc0u9JNSHDfb-yBMAOaw/viewform