Cardápio

O cardápio (Menu) de um cliente é o conjunto de todos os itens de uma loja oferecidos para venda na plataforma do Delivery Direto.

O seguinte diagrama resume a hierarquia do cardápio:

A seguir, vamos detalhar cada uma das estruturas que compõem o cardápio do restaurante de um cliente.

Categoria

Categorias são formas de agrupar itens em uma loja. Categorias são criadas sem itens, mas são apenas exibidas para clientes finais da loja uma vez que passam a conter um ou mais itens.

Item, Variação e Opção

Itens no Delivery Direto representam os Itens oferecidos por um lojista em sua venda. Eles seguem a estrutura expressa visualmente acima: um Item pode (ou não) conter em si uma ou mais Variações, e estas devem conter no mínimo uma Opção para cada.

Variações são como grupos de opções:

• Elas geralmente possuem um título que representam genericamente as opções contidas em si
• Elas possuem o método de cálculo que será utilizado para determinar o valor total das opções selecionadas
• Elas determinam limites para quantas opções podem ser selecionadas, e se é obrigatório ou não selecionar uma determinada quantidade de opções

Opções, são utilizadas para expressar todas as possíveis formas/complementos que um item pode tomar/ter. Veja os seguintes exemplos de itens:

Legenda:

• Item é representado pela cor verde
• Variações são representados pela cor amarela
• Opções são representadas pela cor azul

A estrutura de itens no Delivery Direto permite grande liberdade na estruturação do cardápio de cada cliente, mas deve seguir necessariamente as regras expressas anteriormente.

Cada variação possui um tipo de cálculo que é utilizado para determinar o valor total das opções selecionadas naquela variação. Os tipos de cálculo possíveis são:

• Soma: os valores de todas as opções selecionadas são somados
• Média: os valores de todas as opções selecionadas são somados, e o resultado é então dividido pelo número total de opções selecionadas
• Maior: o valor final é equivalente ao valor da opção de maior valor selecionada
• Menor: o valor final é equivalente ao valor da opção de menor valor selecionada

Para auxiliar em sua integração, o sistema do Delivery Direto conta com o campo custom_code para cada Item e Opção. Este campo pode ser preenchido com qualquer valor alfanumérico, para que sejam feitas equivalências entre os itens e opções do Delivery Direto com elementos do seu próprio sistema.

Vale ressaltar que podem existir variações e opções sem vínculo. Para que opções sejam exibidas no cardápio da loja do Delivery Direto, estas devem estar vinculadas a variações, estas por sua vez tendo de estar vinculadas a algum produto.

Módulo de Pizza

O Módulo de Pizza é uma extensão gratuita do Delivery Direto, utilizado por restaurantes que buscam maior facilidade em representar os diversos tipos de pizza que eles podem servir para seus clientes.

As pizzas criadas por este módulo comportam-se de forma análoga aos itens regulares, mas diferem destes tanto na terminologia utilizada para definir sua estrutura, quanto nas relações entre cada parte de sua estrutura. Observe o seguinte diagrama:

As diferenças ocorrem principalmente no comportamento entre as entidades:

• O valor-base de um item de pizza não é definido pelo seu tamanho, e sim pela relação entre cada tamanho e um sabor
• Todos os tamanhos podem ter acesso a todos os sabores, mas é possível configurar para que certos sabores apareçam apenas para certos tamanhos
• Todos os adicionais ficam disponíveis para todos os tamanhos, mas seus valores podem variar dependendo do tamanho da pizza