Manual de Integração — Open Delivery Pedidos

Revisão 14/07/2026 — adicionada a Seção 6 (papel de Software Service e endpoint de consulta do Merchant). Revisão anterior 07/07/2026 — correção da URL de autenticação (o sistema agora completa o /oauth/token sozinho) e nova seção de resolução de problemas.

1. Descrição Geral

A integração Open Delivery Pedidos centraliza o recebimento, processamento e conversão de pedidos provenientes do padrão de API unificado da Abrasel (Open Delivery) para o ecossistema interno de PDV/ERP.

O fluxo monitora eventos da Open Delivery (via Webhook ou via consulta ativa por Polling) e lida de forma nativa com três modalidades de consumo:

2. Configuração de Parâmetros da Integração

2.1. Plataforma ou Marketplace

Integração: Open Delivery Pedidos.

2.2. Informações Específicas de Conexão e Autenticação

As credenciais e URLs variam conforme a plataforma parceira. Siga a descrição de cada parâmetro:

Parâmetro 1: URL Base de Autenticação (OAuth Token)

URL usada para gerar o token de autenticação na API da plataforma parceira.

Pode ser preenchida de duas formas — as duas funcionam:

O que a plataforma informou O que preencher O que o sistema chama
Só a URL base (ex: https://api.empresa.com.br) A URL base como veio https://api.empresa.com.br/oauth/token (o sistema completa sozinho)
A URL completa do token (ex: https://api.empresa.com.br/oauth/token) A URL completa como veio Exatamente a URL informada

Regra técnica: se a URL terminar com /token, o sistema usa como está; senão, ele adiciona /oauth/token no final. Barra no final da URL é ignorada.

IMPORTANTE: este campo é o que decide o modo de autenticação da integração: