====== IFood Restaurante ======


----

A integração entre o **iFood** e o **Intellicash** consiste em um conjunto de processos automatizados responsáveis por sincronizar dados operacionais, comerciais e cadastrais entre a plataforma de delivery e o sistema de gestão corporativa da IWS. Essa integração permite a comunicação bidirecional entre os sistemas, assegurando que informações críticas sejam transmitidas de forma precisa, padronizada e em tempo real.

----

===== Objetivos da Integração =====

==== Automação do Fluxo de Pedidos ====

Os pedidos gerados no iFood são automaticamente capturados pelo módulo de integração e registrados no Intellicash. Esse processo elimina intervenções manuais, reduz inconsistências e aumenta a confiabilidade das informações importadas, incluindo itens, quantidades, valores, taxas, descontos e dados de entrega.

==== Padronização e Confiabilidade dos Dados ====

A transmissão estruturada das informações assegura que o Intellicash receba os pedidos no formato correto, permitindo a execução de rotinas internas como baixa de estoque, emissão fiscal e atualizações financeiras.

==== Otimização Operacional ====

A integração proporciona maior agilidade no atendimento e no preparo dos pedidos, reduzindo o tempo de processamento e minimizando falhas humanas.

==== Centralização e Controle Unificado ====

Todas as informações relacionadas aos pedidos são consolidadas no Intellicash, possibilitando análises gerenciais, auditoria, rastreabilidade e integração com demais módulos (financeiro, estoque, vendas e fiscal).

==== Emissão Automática de Documentos ====

Dependendo da parametrização, a importação do pedido pode disparar automaticamente a geração de cupons fiscais, notas fiscais ou outros documentos internos.

==== Integração de Cadastros e Itens ====

A integração também contempla processos relacionados ao **cadastro e atualização de itens**, garantindo aderência entre o cardápio interno e os produtos ofertados no iFood.

==== Vinculação de Itens ====

Permite estabelecer o relacionamento entre o item cadastrado no Intellicash e o item correspondente cadastrado no iFood, assegurando que a identificação do produto seja consistente durante a importação do pedido.

==== Sincronização de Dados Cadastrais ====

Conforme os cadastros do Intellicash, podem ser sincronizados automaticamente:

  *  Descrições de produtos
  * Preços de venda
  * Categorias
  * Unidades de medida
  * Disponibilidade / ativação de itens

Essa sincronização evita divergências entre os ambientes e garante que o cliente visualize no iFood informações alinhadas ao cadastro corporativo.

==== Atualização de Modificadores e Adicionais ====

Modificadores, adicionais, complementos e observações de itens são mapeados para o Intellicash, garantindo que a composição do pedido seja interpretada corretamente durante o processamento interno.

----

===== Importante =====
<note warning>**Caso o cliente que irá utilizar a integração da IWS com o iFood já possua uma loja configurada e ativa na plataforma, será necessário excluir os cadastros de produtos, complementos e categorias existentes, para que todas as informações sejam enviadas corretamente pelo IC**.</note>

===== Em Resumo =====

A integração iFood x Intellicash fornece uma camada de comunicação estruturada que automatiza operações, reduz inconsistências, padroniza cadastros de itens e possibilita um fluxo operacional contínuo e auditável. Trata-se de uma solução essencial para estabelecimentos que dependem de operações de delivery integradas ao seu sistema de gestão.


----
Para abrir esta ferramenta basta entrar no menu em:

||Gerenciamento→Integrações→IFood Restaurante||

Ao clicar nesta opção aparecerá a seguinte interface:
{{ :manuais:intellicash:integracoes:ifoodrest.png |}}



==== Visão Geral da Tela de Importação ====

A tela é dividida em duas grandes áreas:

  - **Cabeçalho e filtros de consulta:**  onde o usuário define período, status dos pedidos e aciona funções de consulta.
  - **Detalhamento de pedidos e itens:**  onde aparecem os pedidos retornados da busca e os itens, dados de entrega e formas de pagamento pertencentes a cada pedido.

=== Filtros de Pesquisa ===

  - **Empresa:** Campo onde você escolhe qual empresa deseja consultar.
  - **PDV:** Seleção do ponto de venda utilizado para importação dos pedidos do iFood.
  - **Período (Início e Término):** Define o intervalo de datas dos pedidos que serão carregados.
  - **Aplicar:** Após configurar os filtros, clique em **Aplicar** para carregar os pedidos.
  - **Imprimir:** Permite emitir um relatório simples da listagem exibida.
  - **Debugar:** Usado por técnicos para verificar detalhes técnicos da comunicação.

=== Abas de Status dos Pedidos ===

Abaixo dos filtros, existem abas que agrupam os pedidos conforme a situação:

  * **Pendente:** lista os pedidos que foram baixados do IFood e estão agurdando ações do usuários;
  * **Confirmado:** lista os pedidos que foram confirmados para dentro do ERP gerando a pré-venda;
  * **Faturado:** lista os pedidos que já foram envidaos para nota fiscal ou cupom fiscal, porem ainda não foram confirmados;
  * **Finalizado:** lista os pedidos que já foram faturados (cupom fiscal ou nota fiscal emitida);
  * **Cancelados:** lista os pedidos com status cancelados;
  * **Todos:** lista todos os pedidos, independente do status;

Selecione uma aba para visualizar apenas os pedidos daquele status.

=== Lista de Pedidos ===

A tabela principal exibe os pedidos baixados. Entre as colunas disponíveis estão:

  * **Data Pedido**
  * **Código** (identificador do pedido)
  * **Documento ERP** (se já foi importado/faturado)
  * **Tipo Agendamento**
  * **Entrega/Retirada**
  * **Início Preparação**
  * **Data Entrega**
  * **Valor dos Itens**
  * **Frete**
  * **Taxas**
  * **Desconto**
  * **Total**
  * **Entre outros...**


=== Detalhe dos Itens do Pedido ===

Ao selecionar um pedido na lista superior, os itens aparecem na grade inferior com as seguintes informações:

  * **Cód. Barras**
  * **Descrição iFood** (como o cliente vê no aplicativo)
  * **Descrição Sistema** (produto correspondente no ERP)
  * **Unidade**
  * **Qtde**
  * **Valor Unitário**
  * **Adicional**
  * **Total**
  * **Pergunta** (opções/observações selecionadas pelo cliente)

=== Detalhe dos Pagamentos do Pedido ===
Lista as formas de pagamento que foram utilizadas no pedido.
=== Detalhe da Entrega do Pedido ===
Lista o endereço de entrega do pedido.
=== Detalhe dos Descontos do Pedido ===
Lista os descontos que o pedido teve.
=== Detalhe das Negociações do Pedido ===
Lista as opções de negocição quando pedido tiver.
  
=== Ações Disponíveis ===

Na parte inferior da tela estão os botões de operação:

  - **Baixar Pedidos:** Conecta-se ao iFood e baixa os pedidos mais recentes para o ERP.
  - **Importar Pedidos:** Importa os pedidos selecionados para dentro do ERP, gerando documentos internos.
  - **Exportar:** Permite exportar lista de pedidos para arquivos externos, conforme as opções disponíveis.
  - **Ações:** Tem as opções de marcar todos, desmarcar todos, inverter selelção, descartar pedidos...
  - **Faturar em Cupom Fiscal ao Importar:** Quando marcado, o sistema já gera automaticamente o cupom fiscal ao importar o pedido.

=== Fluxo de Trabalho ===

1. **Definir o período desejado:** Ex.: pedidos do dia.

2. **Clicar em “Baixar Pedidos”:** O sistema trará os pedidos do iFood.

3. **Clique em “Aplicar:”** Caso esteja ajustando filtros.

4. **Selecionar o pedido desejado:** Os itens aparecerão na área inferior.

5. **Verificar informações**

   * Produtos
   * Quantidades
   * Valores
   * Descontos
   * Taxas
   * Dados de entrega

6. **Clicar em “Importar Pedidos”:** O pedido será convertido em documento interno do Intellicash (orçamento).

7. Se a opção estiver marcada, o **Cupom Fiscal será emitido automaticamente**.


===== Visão Geral da Tela de Exportação =====
A aba de exportação permite cadastrar e atualizar itens na plataforma do IFood.
{{ :manuais:intellicash:integracoes:exptifood.png |}}

Nessa tela é possivel enviar os itens normal, item pizza, preços e status.
Os itens serão listados nas abas de acordo com os atributos alterados.
O usuário tem a opção de exportar todos ou marcar apenas os itens que deseja exportar. Também é possivel descartar os produtos do log através do botão de ações.
<note>O ideal é que essa aba seja usada apenas para casos especificos, no mais os itens devem ser enviados pelo integrador que faz de forma automatica de tempo em tempo, conforme configurações.</note>
===== Configurações =====
Ao acessar a aba de configurações temos várias sub-abas, como:
==== Aba Autenticação ====
Nessa aba deve ser informado as credenciais para autenticar a comunicação com ifood.
==== Aba Produtos ====
{{ :manuais:intellicash:integracoes:cfgifoodrest.png |}}

A tela de **Configurações de Produtos** permite gerenciar os produtos que serão integrados com Ifood, controlando preços, estoque, categorias e sincronização de informações.

=== Adicionar Produtos ===
É possivel adicionar produtos em lote utilizando a opção de filtrar por atributos ou inserir item a item utilizando a opção de localizar, que pode ser tanto por descrição ou por código de barras.
=== Lista de Produtos ===

Cada linha representa um produto com as seguintes colunas:

| Campo                 | Descrição                         |
| --------------------- | --------------------------------- |
| **Sel.**              | Seleciona o produto               |
| **Código**            | Código interno do produto         |
| **Descrição**         | Nome do produto                   |
| **Unidade**           | Unidade de venda (UN, KG, etc.)   |
| **Preço de Venda**    | Valor do produto                  |
| **Qtde Disponível**   | Quantidade em estoque             |
| **Bebida Alcoólica**  | Indica se é bebida alcoólica      |
| **Última Compra**     | Data da última compra             |
| **Última Venda**      | Data da última venda              |
| **Foto Sincronizada** | Indica se a imagem foi enviada    |
| **Tem Foto**          | Indica se o produto possui foto   |
| **Pizza**             | Identifica produtos do tipo pizza |


=== Ações Disponíveis ===

  * **Excluir:** Remove o produto selecionado da integração.
  * **Logar Produtos:** Adiciona os produtos na lista de exportação para o IFood.
  * **Sincronizar Foto:** Envia as fotos dos produtos para o IFood, essa opção apenas faz o envio de produtos que não tiveram as fotos sincronizadas. Caso a imagem tenha sido trocada é preciso clicar com botão direito sobre o "Sincronizar Foto" e forçar o Envio.
  * **Sincronizar Categorias:** Envia as categorias para o IFood. É recomendado executar essa opção sempre que for cadastrada uma nova categoria.
  * **Pesquisar:** Campo para localizar rapidamente um produto na lista.

<note important>Para ser sincronizado com IFood todos os produtos precisam ter a aba Ecommerce do cadastro de produtos com as informações de departamento, seção e descrições preenchidas.</note>

==== Estrutura de Item Pizza ====
O Item do tipo **PIZZA** é único no sistema e o mesmo precisa ser um kit do tipo **PIZZA IFOOD**. As váriações serão tratadas dentro do kit.
{{ :manuais:intellicash:integracoes:saborespizza.png |}}
Dentro da aba Kits e Produção temos as seguintes abas:
  * **Tamanhos:** cadastrada os tamanhos de pizzas que serão disponibilizados no ifood;
  * **Massas:** cadastra as massas que serão disponibilizadas;
  * **Bordas:** cadastra as boras que serão disponibilizadas;
  * **Sabores:** cadastra os sabores que serão disponibilizados.
  Os sabores precisam ter um cadastro especifico. 
    - É preciso cadastrar um produto que será a base para cada sabor, por exemplo recheio de calabresa.
    - É preciso cadastrar um produto para cada tamanho de recheio, por exemplo, recheio calabresa P, recheio calabresa M, recheio calabresa G. Esses produtos precisam ser do tipo produção automatica e ter como base o insumo recheio de calabresa.
<note important>Todos os produtos, tanto o insumo quanto o kit precisam ter a aba de ecommerce com as informações de departamento, seção e descrições preenchidas.</note>

==== Aba Catalogos ====
Lista os catalogos cadastrados no IFood;
==== Aba Categorias ====
Lista as categorias cadastradas no IFood;
==== Aba Usuário x Entregador ====
Permite vincular o usuário ao entregador para quando for fazer o agendamento da entre já preencher o entregador automatico;