Desenvolvedores

Informações técnicas para desenvolvedores

Integração Open Delivery

A Prefiro Delivery possui integração nativa com o padrão Open Delivery, permitindo que sistemas parceiros consumam pedidos e eventos de forma padronizada.

O Open Delivery define contratos claros para troca de informações entre plataformas, reduzindo a necessidade de integrações proprietárias.

Documentação oficial do padrão:
https://developer.opendelivery.com.br/api-portal/content/documentação

Conceito de Merchant

No contexto do Open Delivery, o Merchant representa o sistema parceiro que irá consumir os pedidos originados na Prefiro Delivery.

Os dados do Merchant são definidos pelo desenvolvedor do sistema parceiro e devem ser informados ao administrador do restaurante, que realizará o cadastro do Merchant e a criação do App de Open Delivery no painel da Prefiro Delivery.

Como a integração funciona na Prefiro Delivery

  • O sistema parceiro define os dados do Merchant
  • O restaurante cadastra essas informações no painel da Prefiro Delivery
  • O painel gera as credenciais do App de Open Delivery
  • O sistema parceiro passa a consumir os pedidos conforme o padrão Open Delivery

O que vocês precisam fornecer ao restaurante

Para que o restaurante consiga criar o App de Open Delivery no painel do Prefiro Delivery, o sistema parceiro deve fornecer as informações abaixo:

  • Merchant URL e Token: URL base e token para obter os dados do merchant, conforme o padrão oficial.
  • Webhook URL (opcional): endpoint para recebimento de eventos

Criação do App pelo restaurante

Após receber os dados do Merchant, o administrador do restaurante irá:

  • Acessar o painel da Prefiro Delivery
  • Criar um novo App de Open Delivery ( Integração -> Open Delivery)
  • Informar os dados do Merchant fornecidos pelo sistema parceiro
  • Definir os estabelecimentos/unidades que o App poderá acessar
  • Concluir a criação do App e liberar o uso da integração

Sistemas que ainda não utilizam Open Delivery

Para adequação ao padrão, utilize a documentação oficial como referência para implementação:

https://developer.opendelivery.com.br/api-portal/content/documentação

A Prefiro Delivery atua como um Ordering Application, sendo responsável pela geração dos pedidos, enquanto o sistema parceiro atua como o Merchant (Software Service), podendo consumir esses pedidos via polling ou webhook, conforme definido pelo padrão Open Delivery.

Atualmente, a Prefiro Delivery consome o endpoint do Merchant apenas para recuperar o id e o nome do sistema parceiro. Essas informações são sempre devolvidas nos detalhes do pedido.

Suporte

Em caso de dúvidas sobre o fluxo de cadastro ou criação do App, o restaurante pode entrar em contato com o suporte da Prefiro Delivery informando:

  • Nome do sistema parceiro
  • Dados do Merchant