> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/delivery-salao/integracoes/quero-delivery.md).

# Quero Delivery

Use esta integração para sincronizar os pedidos realizados no Quero Delivery e gerenciá-los em um só lugar!

## Visão geral

Com a integração, os pedidos do Quero Delivery chegam ao Gestor de Pedidos e você acompanha tudo na mesma tela dos pedidos do seu delivery. O status é atualizado nos dois lados, então a equipe não precisa alternar entre os painéis.

O que a integração faz:

* Busca pedidos novos a cada 30 segundos.
* Envia a mudança de status para o Quero Delivery.
* Cancela o pedido na plataforma quando ele é cancelado no Quero Delivery.
* Identifica o pedido com a marca e o número do Quero Delivery.
* Importa desconto, taxa de entrega, taxa de serviço e gorjeta.
* Associa produtos pelo código para estoque, notas fiscais, relatórios e setores de impressão.

{% hint style="success" icon="lightbulb-on" %}
**Exemplo prático**

Sua loja recebe o pedido #123 no Quero Delivery. Ele aparece no Gestor de Pedidos como #123 Quero Delivery, com endereço, desconto e taxa de entrega já preenchidos. Ao aceitar na plataforma, o pedido é confirmado automaticamente para o cliente no aplicativo do Quero Delivery.
{% endhint %}

## Como ativar

A integração fica no menu **Integrações**:

<div data-with-frame="true"><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F377VD8naKvWQq2OIe9Zf%2Fquero-delivery-lista.png?alt=media" alt="Quero Delivery na lista do menu Integrações"></div>

1. Acesse o menu **Integrações**.
2. Clique em **Quero Delivery**.
3. Preencha o **Place ID** e o **Token**.
4. Ative a integração e clique em **Salvar**.

<div data-with-frame="true"><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FOTNA548OTPQd1oV9KOfj%2Fquero-delivery-ativacao.png?alt=media" alt="Tela de integração do Quero Delivery com Place ID, Token e o botão Salvar"></div>

O Place ID é o identificador do estabelecimento no painel do Quero Delivery. O Token também aparece nesse painel. Se esses dados não estiverem disponíveis, solicite ao suporte do Quero Delivery.

{% hint style="info" %}
**Observação**

Use o Place ID e o Token de produção da loja. Dados de homologação (teste) são diferentes e não ativam a integração na operação real.

Se o Place ID ou o Token estiver incorreto, a integração não é ativada e a mensagem "Erro ao autenticar com dados informados" é exibida.
{% endhint %}

## Pedidos

Os pedidos chegam como qualquer outro pedido da plataforma. A busca por pedidos novos acontece a cada 30 segundos e não é necessário manter o painel aberto.

* Na lista, o pedido aparece com a logo do Quero Delivery e o número de lá, por exemplo #123 Quero Delivery.
* Ao abrir o pedido, o número também aparece como **Pedido Quero Delivery**.
* Pedidos de retirada chegam como retirada.
* Pedidos de entrega chegam com o endereço enviado pelo Quero Delivery.
* Descontos e taxa de entrega são importados.
* Taxa de serviço e gorjeta, quando existirem, aparecem como **Taxas Quero Delivery**.
* O código do pedido fica nas observações e sai na impressão: **por Quero Delivery #123**.

{% hint style="info" %}
**Observações importantes**

* Aceitar o pedido (**Em produção**) confirma o pedido no Quero Delivery.
* Se o pedido já foi aceito no aplicativo do Quero Delivery, ele entra na plataforma já aceito.
* Em uma retirada, ou quando a entrega é feita pelo Quero Delivery, o próximo status envia **pronto para retirada**.
* Quando a entrega é da própria loja, o próximo status envia **saiu para entrega**.
* Concluir o pedido (**Retirado** ou **Entregue**) marca a entrega como concluída no Quero Delivery.
* Cancelar o pedido na plataforma solicita o cancelamento no Quero Delivery enquanto ele ainda não saiu para entrega e não foi concluído. Depois disso, o cancelamento precisa ser feito no Quero Delivery.
* Se o pedido for cancelado no Quero Delivery, ele também é cancelado na plataforma.
* Pode levar até cerca de 30 segundos para um pedido novo aparecer.
* Não é possível abrir ou fechar a loja no Quero Delivery por este painel.
  {% endhint %}

## Formas de pagamento

O pedido chega com a forma de pagamento informada pelo Quero Delivery: crédito, débito, dinheiro ou outra forma. Pagamentos já quitados online são identificados como pagamento online. Quando houver troco no dinheiro, esse valor também vem no pedido.

Para lançar essas vendas no caixa:

1. Acesse o menu **Formas de pagamento**.
2. Com a integração ativa, a opção para criar a conta do Quero Delivery aparece.
3. Clique em **CRIAR** e depois em conectar.
4. Selecione as formas de pagamento correspondentes e salve.

## Estoque, notas fiscais e setores de impressão

Os cardápios da loja e do Quero Delivery não são integrados. O cadastro e a edição dos produtos continuam no cardápio do Quero Delivery.

Para que os produtos sejam identificados nas notas fiscais, nos setores de impressão, nos relatórios e no controle de estoque, associe os produtos pelo código:

1. Abra o cadastro do produto na plataforma. O código aparece junto às informações do item, no formato **Cód. produto: i\_12345**. No complemento, aparece como **Cód. complemento: c\_1234**.
2. No cardápio do Quero Delivery, localize o mesmo produto e informe esse código no campo de código externo (código PDV).
3. Repita o processo em cada complemento que deseja associar.

{% hint style="info" %}
**Observações importantes**

Com o código igual nos dois lados:

* O produto recebido no pedido é associado ao item correto da plataforma.
* A venda realizada pelo Quero Delivery atualiza o estoque.
* O produto é identificado corretamente nos relatórios, nas notas fiscais e nos setores de impressão.

Sem o código, o pedido continua chegando, mas o item não fica vinculado ao produto já cadastrado. Estoque, nota fiscal e setor de impressão desse produto não são aplicados.

Pausar um produto na plataforma não pausa o mesmo produto no Quero Delivery, e o estoque de lá não é atualizado.
{% endhint %}
