# Delivery Legal (Integração)

{% hint style="warning" %}
**Este Material é indicado para:**

* Parceiros comerciais (Canais) que desejam criar e gerenciar lojas no Delivery Legal para seus clientes.
* Integradores que precisam vincular licenças OEM a lojas do Delivery Legal.

Se você é de um estabelecimento comercial (loja), acesse o [material ](https://ajuda.pdvlegal.com.br/integracoes/delivery-legal/delivery-legal-para-lojas)feito para você!
{% endhint %}

{% hint style="danger" %}
**Pré-requisitos**

* O módulo **Delivery Legal** precisa estar **habilitado** na licença do cliente.
* Caso não esteja, entre em contato com o responsável pelo licenciamento na sua revenda ou grupo econômico.
  {% endhint %}

## Como **Vincular a API do Retaguarda Cloud ao Delivery Legal?**

{% stepper %}
{% step %}

### **Obter a Chave da API no Delivery Legal:**

* Acesse a loja do cliente no **Delivery Legal**.
* Vá em **Configurações > Geral**.
* Role até o final da página e copie a **Chave de Acesso da API**.

{% endstep %}

{% step %}

### **Configurar a Chave da API no Cloud:**

* Acesse o **Cloud** do cliente.
* Vá em **Administrativo > Filiais**.
* Selecione a **filial** correspondente.
* Vá para **Integrações > Delivery Legal**.
* Cole a **Chave de Acesso da API** copiada anteriormente.
* Clique em **Validar** e depois em **Gravar**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FGv9wBcV7EQIa4RhmxFnV%2Fdelivery41.png?alt=media&#x26;token=09533524-aaa0-4a2e-b2e2-451ced36dde2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Revalidar a Configuração:**

* Após salvar, volte para essa tela. Agora, novos campos estarão disponíveis para configurar.
  {% endstep %}
  {% endstepper %}

***

## **Configurações do Gestor de Pedidos**

No menu do **Gestor de Pedidos**, algumas configurações impactam diretamente o funcionamento da integração.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FMfULGjntkf71gwRqYF7N%2Fdelivery42.png?alt=media&#x26;token=ff43bcf1-575d-40b4-84fa-5f511aa672f0" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### **Confirmação Automática:**

* **SIM:** Todos os pedidos são automaticamente aceitos e enviados ao PDV.
* **NÃO:** Um usuário precisará confirmar manualmente cada pedido antes de seguir para o PDV.
  {% endstep %}

{% step %}

### **Tipo de Validação do Produto:**

* **Código** – A integração usa apenas os códigos para vinculação (nomes podem ser diferentes).
* **Nome + Código** – Os produtos devem ter o **mesmo nome e código** no Cloud e no Delivery Legal.
  {% endstep %}

{% step %}

### **Modo de Preparo:**

* Quando ativado, todos os pedidos são aceitos **automaticamente**, evitando falhas na comunicação.
* Os pedidos podem ser despachados diretamente **sem precisar do PDV**.
  {% endstep %}

{% step %}

### **Tempo de Aviso (PDV Offline):**

* Define em quanto tempo o sistema notificará o lojista caso o **PDV esteja offline**.
* O aviso chega por **e-mail** cadastrado no Cloud (*Administrativo > Filiais > Geral > Campo E-mail*).
* Pode ser configurado para **5, 10, 15, 20, 25 ou 30 minutos**.
  {% endstep %}

{% step %}

### **Pedidos em Caso de Falha na Internet:**

* Se houver queda de internet, o pedido será armazenado no Cloud.
* Para processá-lo posteriormente, clique no botão **"Despachar"** na tela do pedido.
* O status mudará de **EM PREPARO** para **PEDIDO ENVIADO**.
  {% endstep %}

{% step %}

### **Configurar Usuário e Forma de Pagamento Padrão:**

* **Usuário Padrão →** Deve ser igual ao **vendedor cadastrado** no sistema.
* **Forma de Pagamento Padrão →** Deve corresponder à opção de pagamento online usada no Delivery Legal.

{% hint style="warning" %}
**Dica:** Confirme se todas as **formas de pagamento** estão cadastradas corretamente antes de iniciar a operação.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## **Vincular Produtos do Retaguarda Cloud ao Delivery Legal**

<details>

<summary>Vincular um Produto Manualmente</summary>

1 - **Obter o Código do Produto no Cloud:**

* Acesse **Retaguarda > Produtos > Cadastro**.
* O código do produto estará listado ao lado esquerdo do item.
* Copie esse código.

<img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F2PMIeUF35bPABVkC2X99%2Fdelivery43.png?alt=media&#x26;token=29f1e6e7-c1ce-4696-8c67-7614ea299644" alt="" data-size="original">

**2 - Associar o Código ao Produto no Delivery Legal:**

* Acesse **Delivery Legal > Produtos**.
* Clique nos **três pontinhos** ao lado do produto.
* Selecione **Editar**.
* Insira o **código do produto** copiado do Cloud.
* Clique em **Atualizar**

<img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FOy5pCSaGigLZvIi3W7lW%2Fdelivery44.png?alt=media&#x26;token=7d38395c-5eb1-4071-8a33-6fb4481d9dc1" alt="" data-size="original">

</details>

<details>

<summary><strong>Adicionar Diretamente do Cloud para o Delivery Legal</strong></summary>

**1- Acesse o Cloud:**

* Vá para **Administrativo > Filiais** e selecione a filial correspondente.
* Vá para **Integrações > Delivery Legal**.

**2 - Adicionar um Item:**

* Clique em **ADICIONAR ITEM**.
* Preencha os dados necessários do produto.
* Confirme e envie para o **Delivery Legal**.

<img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FfO4oxZTwT7eMwQKyGdvz%2Fdelivery45.png?alt=media&#x26;token=0e352369-7bae-4c35-ab90-4ca7f3a0076e" alt="" data-size="original">

> **📌 Dica:** **Não é possível enviar complementos do Cloud para o Delivery Legal automaticamente**. Os complementos devem ser adicionados manualmente no **Delivery Legal**.

</details>

***

## **Habilitando o Terminal para Recebimento de Pedidos**

Após configurar toda a integração, é necessário ativar o **terminal** para garantir que os pedidos sejam recebidos corretamente.

{% stepper %}
{% step %}

### **Acesse o Cloud:**

* Vá para **Administrativo > Filiais**.
* Selecione a filial correspondente.
* Vá para **Meus Terminais**.
  {% endstep %}

{% step %}

### **Configurar o Terminal de Pedidos:**

* Clique no **ícone da caneta** ao lado do terminal que receberá os pedidos.
* Ative a opção **"Gestor"** como **SIM**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FXi7KYv7QRkrn9kB21PcB%2Fdelivery46.png?alt=media&#x26;token=6118dfee-545e-4494-bf9c-f5af8b5e6c18" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Atenção:**

**Não recomendamos utilizar terminais SmartPOS** como **Gestor de Pedidos**, pois eles não possuem o hardware necessário para recepção eficiente dos pedidos.
{% endhint %}

***

## <mark style="background-color:red;">**Preciso de Ajuda**</mark>

{% hint style="danger" %}

* **Problema:** Pedidos não chegam ao PDV.

**Solução:**

1 - Vefique se a **API Key** foi colada corretamente no PDV Legal.

2 - Confirme se o terminal está marcado como **Gestor**.

* **Problema:** Produtos não sincronizam.

**Solução:**

1 - Valide se o *Código ERP* é idêntico nos dois sistemas.

2 - Certifique-se de que o produto não está desativado no Delivery Legal.

* **Problema:** Alertas de offline não funcionam.

**Solução:** Confira o e-mail cadastrado em **PDV Legal > Filiais > Geral**.
{% endhint %}

## <mark style="background-color:green;">**Dicas Rápidas**</mark>

{% hint style="success" %}

* **Teste de Pedido**: Envie um pedido-teste para validar a integração.
* **Códigos Únicos**: Use códigos ERP exclusivos para evitar conflitos.
* **Backup**: Exporte a lista de produtos antes de sincronizar em massa.
  {% endhint %}