Detalhes de loja

Exibição da loja

PUT

POST

/stores/v1/{store_id}/display

Para que a loja seja exibida no aplicativo, é necessário fornecer pelo menos os seguintes elementos:

• Imagem de capa
• Imagem de logotipo
• De 1 a 3 tipos de culinária

Cada imagem passa por uma aprovação interna e, após aprovação, é exibida na página da loja no aplicativo.

As imagens precisam ser de boa qualidade, com posicionamento e iluminação adequados, originais, sem textos ou informações adicionais, e devem respeitar as seguintes dimensões:

• Capa: mínimo de 800 x 600 px e máximo de 1600 x 1200 px
• Logotipo: mínimo de 75 x 75 px e máximo de 500 x 500 px

A seleção de culinária ajuda a categorizar a loja de acordo com os produtos que oferece (como hambúrgueres, hortifrúti, medicamentos, produtos para pets, etc.). A listagem de culinárias existentes pode ser encontrada em /auxiliaries/culinaries.

Recomenda-se selecionar as três culinárias principais para que a loja seja categorizada corretamente, facilitando a localização pelos clientes.

A faixa de aviso é um elemento opcional e, se utilizada, deve conter informações relevantes sobre a loja. Ao ativá-la, uma faixa com o texto configurado será exibida sobre o logotipo da loja no aplicativo.

Horários de atendimento

PUT

POST

/stores/v1/{store}/hour

A loja deve cadastrar pelo menos um dia de funcionamento em /stores/v1/{store}/hour , podendo configurar um período contínuo (exemplo: das 11h às 22h) ou dois períodos no mesmo dia (exemplo: das 11h às 15h e das 18h às 22h). Em caso de lojas com atendimento 24 horas, o horário também deve ser indicado como 00:00 a 23:59.

Além disso, é necessário especificar o tipo de atendimento oferecido pela loja, que pode incluir entrega e/ou retirada. A informação de tempos de entrega e preparo serão exibidos no aplicativo e, portanto, devem refletir o tempo médio praticado pela loja para garantir precisão nas informações para os clientes.

Caso a loja selecione uma opção com DELIVERY, é obrigatório definir o tempo estimado de entrega, escolhendo uma das opções abaixo:

• 15 a 30 min = enviar para API 15 - 30
• 20 a 40 min = enviar para API 20 - 40
• 40 a 60 min = enviar para API 40 - 60
• 60 a 90 min = enviar para API 60 - 90
• 90 a 120 min = enviar para API 90 - 120

Configurações de entrega

PUT

POST

/stores/v1/{store_id}/delivery

O endpoint /stores/v1/{store_id}/delivery permite a atualização das informações de entrega da loja. Estão disponíveis duas modalidades de entrega:

• Entrega por bairro: permite que a loja selecione os bairros onde realiza entregas e defina um valor de entrega específico para cada um.
• Entrega por raio: permite que a loja estabeleça diferentes zonas de entrega em torno de seu endereço, baseadas em distâncias em quilômetros. Cada zona pode ter um valor de entrega específico, e é possível configurar áreas de restrição, onde a entrega não será realizada.

As modalidades de entrega disponíveis dependem da cidade onde a loja está localizada.

Para configurar entrega gratuita, a loja pode ativar ou desativar a opção de entrega grátis. Não é recomendável ajustar os valores de cada bairro ou raio para zero. Quando a entrega gratuita está ativada, ela será aplicada todos os dias da semana. Quando desativada, a loja pode configurar um valor mínimo de pedido para dias específicos (por exemplo, entrega grátis nas segundas-feiras para pedidos acima de R$30,00).

Além disso, a loja precisa estar configurada corretamente com seu tipo de atendimento (campo store_delivery_type na API), com uma das seguintes opções:

• DELIVERY (entrega) = Enviar para API 0
• PICK_UP (retirada na loja) = Enviar para API 1
• DELIVERY e PICK_UP (ambos) = Enviar para API 2

As configurações de períodos para agendamento de entrega também podem ser feitas neste endpoint, caso a loja ofereça a opção de entrega agendada, configurável no endpoint /stores/v1/{store_id}/hour.

Meios de pagamento

PUT

POST

/stores/v1/{store_id}/payment-methods

As formas de pagamento online — como PIX, débito, crédito e Nupay — são habilitadas por padrão para oferecer a melhor experiência no aplicativo. Já as opções de pagamento offline, como dinheiro e bandeiras de cartão, podem ser ativadas ou desativadas por meio do endpoint /stores/v1/{store_id}/payment-methods