ACBrOpenDelivery Integração Dúvidas

[valterpatrick]

Pessoal, eu estou desenvolvimento uma integração com o Cardapio Web via Open Delivery com o componente do ACBr.
Nisto eu peguei as chaves com o cliente (clientid e clientsecret) e a url base.
Eu comecei a olhar o demo, mas pelo jeito tenho que estudar bastante ele para entender como funciona, mas vamos lá as minhas dúvidas.

A documentação do Cardapio Web é esta:
https://cardapioweb.stoplight.io/docs/api/gr82prcl4v2jr-introducao

A documentação do Open Delivery que está no site do Cardapio Web é esta:
https://abrasel-nacional.github.io/docs/

Eu queria a partir do Open Delivery listar o catalogo:
https://cardapioweb.stoplight.io/docs/api/1a0cf0640308c-consultar-catalogo

Eu não achei a opção de listar o catalogo dentre as opções disponiveis do demo do OpenDelivery no ACBr, teria isto, se sim como faço?

Eu vou criar um serviço que vai pegar os pedidos finalizados do Cardapio Web e importar para o meu sistema para fazer a emissão da NFCe, nisto os pedidos do whatsapp, ifood e etc, vai cair dentro do Cardapio Web e eu vou baixar eles, pelo o que eu li na documentação do Cardapio Web, eu poderia utilizar o polling (https://cardapioweb.stoplight.io/docs/api/99e29b35f6821-polling-de-pedidos) ou até mesmo o histórico de pedidos (https://cardapioweb.stoplight.io/docs/api/k2oylg7ohuf53-historico-de-pedidos), além do consultar pedido (https://cardapioweb.stoplight.io/docs/api/de286d8b93f76-consultar-detalhes-do-pedido) para pegar os demais detalhes.

No video do ACBr no youtube (https://www.youtube.com/watch?v=X07tulj8nm8 tempo 02:50) pelo o que eu entendi, ao usar o polling eu vou marcar a loja como online, no caso se eu iniciar a aplicação antes da loja ficar de fato aberta, não vai atrapalhar? 
Eu queria entender melhor este conceito.

[Diego Foliene]

Bom dia @valterpatrick!

Quando falamos do OpenDelivery, é importante entendermos os papéis dos participantes envolvidos.

AQUI você entra a explicação completa e detalhada, mas em resumo, podemos dividir em 3 participantes:

• A Aplicação de Pedidos (Ordering Application: é a plataforma final onde o consumidor final faz o pedido(podemos entender como o market place).
• O Serviço de Software (Software Service): é a plataforma de gerenciamento do comerciante.
• O Serviço de Logística (Logistics Service): é a plataforma que coordena as entregas.

Se você analisar a documentação do OpenDelivery, vai encontrar a tabela Development que tem os endpoints que devem ser implementados por cada participante.

Nesse contexto, o componente ACBrOpenDelivery assume o papel do Serviço de Software e consome os endpoints implementados pela Aplicação de Pedidos.

Então este endpoint /catalog não é implementado.

Indo um pouco além nessa consideração, comparando as documentações, não encontrei este endpoint na documentação do OpenDelivery, ela me parece ser própria do Cardápio Web.

A impressão é que eles optaram por separar a resposta do endpoint GET/merchant que se você observar no exemplo de resposta da documentação do OpenDelivery, trás todas as informações, incluindo horários e itens. Dividindo essa resposta nos endpoints /merchant e  /catalog da API do Cardápio Web.

[valterpatrick]

Agora, Diego Foliene disse:

Bom dia @valterpatrick!

Quando falamos do OpenDelivery, é importante entendermos os papéis dos participantes envolvidos.

AQUI você entra a explicação completa e detalhada, mas em resumo, podemos dividir em 3 participantes:

• A Aplicação de Pedidos (Ordering Application: é a plataforma final onde o consumidor final faz o pedido(podemos entender como o market place).
• O Serviço de Software (Software Service): é a plataforma de gerenciamento do comerciante.
• O Serviço de Logística (Logistics Service): é a plataforma que coordena as entregas.

Se você analisar a documentação do OpenDelivery, vai encontrar a tabela Development que tem os endpoints que devem ser implementados por cada participante.

Nesse contexto, o componente ACBrOpenDelivery assume o papel do Serviço de Software e consome os endpoints implementados pela Aplicação de Pedidos.

Então este endpoint /catalog não é implementado.

Indo um pouco além nessa consideração, comparando as documentações, não encontrei este endpoint na documentação do OpenDelivery, ela me parece ser própria do Cardápio Web.

A impressão é que eles optaram por separar a resposta do endpoint GET/merchant que se você observar no exemplo de resposta da documentação do OpenDelivery, trás todas as informações, incluindo horários e itens. Dividindo essa resposta nos endpoints /merchant e  /catalog da API do Cardápio Web.

Obrigado pelo retorno, vou analisar a documentação e o código com um olhar diferenciado agora com estas observações que você me passou.

[Diego Foliene]

1 minuto atrás, valterpatrick disse:

Obrigado pelo retorno, vou analisar a documentação e o código com um olhar diferenciado agora com estas observações que você me passou.

Apenas para referência, esses são os endpoints que o ACBrOpenDelivery consome:

 

[valterpatrick]

Agora, Diego Foliene disse:

Apenas para referência, esses são os endpoints que o ACBrOpenDelivery consome:

 

Certo, já tenho um norte de onde começar.

A minha última dúvida é quanto ao ACBrOpenDelivery.MarketPlace.Name que pode ser mpOutro ou mpHubDelivery, não entendi ainda a diferença e como devo selecionar.

[Diego Foliene]

3 minutos atrás, valterpatrick disse:

Certo, já tenho um norte de onde começar.

A minha última dúvida é quanto ao ACBrOpenDelivery.MarketPlace.Name que pode ser mpOutro ou mpHubDelivery, não entendi ainda a diferença e como devo selecionar.

O componente ACBrOpenDelivery foi concebido de forma a integrar com APIs desenvolvidas conforme padrão OpenDelivery e também com Hub Delivery.

Caso você pretenda comunicar com uma API no padrão OpenDelivery, deve selecionar a opção mpOutro, do contrário, a opção mpHubDelivery.