# ERP Colibri

{% hint style="danger" %}
**Aviso:** A versão atual da integração com o ERP **será descontinuada em 31/12/2025**.\
Por favor, planeje a migração para a nova versão antes desta data. [Nova versão!](https://delivery.ajuda.cc/integracoes/erps-and-pdvs/erp-colibri-novo)
{% endhint %}

O Colibri ERP é um software integrado de gestão empresarial projetado para otimizar processos em diversas áreas de uma empresa. Ele oferece funcionalidades como controle financeiro, gestão de estoques, emissão de notas fiscais e gerenciamento de vendas. É uma solução escalável que se adapta tanto a pequenas quanto a médias empresas.

<div data-full-width="true"><figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-6773a5878f56ca2b3c55888fa0336148c5ed9020%2FNCR%20Colibri%20Logo.jpg?alt=media" alt=""><figcaption><p>NCR Colibri</p></figcaption></figure></div>

{% hint style="info" %}
Para integrar o seu delivery com o Colibri, é obrigatório instalar o nosso gestor de pedidos. Você pode obter mais detalhes em: [gestor-de-pedidos](https://delivery.ajuda.cc/integracoes/aplicativos/gestor-de-pedidos "mention").
{% endhint %}

## **Configurando o Gestor de Pedidos:**

### **Chave de Acesso a API**

Para acessar sua chave de API, siga estes passos: Entre no seu painel, vá até "Configurações", depois "Geral", e na seção "API" você encontrará a chave da API.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-7ae3a9966eb299857f44d457bd97a8f52339a79b%2FScreenshot%202024-04-27%20at%2009.39.39.png?alt=media" alt=""><figcaption><p>Obtendo a chave da API</p></figcaption></figure>

Agora que você possui a chave da API, siga estes passos para configurá-la: Abra o gestor de pedidos, vá até "Configurações", e cole sua chave no campo "Token DeliveryVip".

![Gestor de pedidos](https://lh6.googleusercontent.com/kbL1YAMhhT_kjO3bikukUInMoWJ1CUUyy5m-XM4LMovwLL8aIRbxjl1ThnKSvoFN_GGl0CsFYCXrbuT4RDh-wr4YsLi_WZuKyF3CNLq8x6kXDFD15e8Ku9jMhd_TxXgsfVxF3Ak1)

Agora no campo "Aplicativo Integração", selecione "Colibri".

![Gestor de pedidos](https://lh3.googleusercontent.com/_ZjyozOhUXDwT15AGZY4H0CZP41JoU0A8LbfpVFc4OOckWte4WjlGdK7o-Q7wjcFwUGBbykdezBkAgxSTRt7piMPVrE-lPRUYIzhWWGmEm4BNPmBTv31CalZ-EfetQH1v-ZfXT3Q)

Caso você selecione "Sim" na opção "Utilizar Balcão>Ficha", quando o cliente optar por "Retirada Balcão" no delivery, o sistema registrará o movimento como Ficha. Se você escolher "Não", todos os pedidos serão registrados como Delivery.

![Gestor de pedidos](https://lh5.googleusercontent.com/5cAbp0njnxNFwFYWO7--r4JLh7syz_zStV3oM-ObqCk807HCoDxXbtgJHUrqkLcoQunt6g0rFtajg-XZKrbugA9INStBcxFFWCEQxskdmEL1MnSe7O3S5PKsc6uXTXOx4wamZ_hB)

Agora que tudo está configurado, precisamos ativar o serviço de integração no Colibri. Para isso, acesse o painel de serviços do Colibri e ative a opção "Serviço de Integrações NCR". Após executar esta ação, reinicie o serviço e reabra o gestor de pedidos.

![Colibri Serviços](https://lh5.googleusercontent.com/L1xuvGXbAaoyTWbOLE2gyR19CTe0CmKAdduXOuPHP3Pz09-j-BI2i7SsI8kzuUtZ46QAMcgDuZR_w_0Jw5TO_yIWErEpS7tUp1ljVtgAwRLADmMrq2YnYi_YqnwTqNWexJJco9nQ)

## **Configuração dos Produtos**

Antes de iniciarmos a explicação de como funciona a integração com o Colibri, é importante entender como funciona a estrutura cadastro do seu delivery, você pode obter mais detalhes em: [visao-geral-produtos](https://delivery.ajuda.cc/geral/visao-geral-produtos "mention").

### Produto Simples

Um produto simples é quando ele não tem modificadores, nesse caso é só informar o código do produto no campo "Cód. ERP" no seu delivery.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-73d517ea8785bf78816133dc2923cd5adf2e81b9%2FScreenshot%202024-04-27%20at%2009.59.42.png?alt=media" alt=""><figcaption><p>Editando um produto</p></figcaption></figure>

### **Produto Composto**

Um produto composto é quando ele tem componentes, então você deve informar o código do componente no campo "Cód. ERP" no seu delivery.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-9bf8f44ce66389d4e3084e42fe9f9706ca2b362d%2FScreenshot%202024-04-27%20at%2010.05.23.png?alt=media" alt=""><figcaption><p>Editando um componente</p></figcaption></figure>

### **Produto Combo**

Para identificar a venda de um produto como combo, você deve indicar na categoria do produto que se trata de um combo. Para isso, insira a letra **'c'** seguida do código do combo no campo "Cód. ERP" da categoria desejada.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-d65373df7a8a2dc204775dfe1ddfb3718824739d%2FScreenshot%202024-04-27%20at%2010.08.02.png?alt=media" alt=""><figcaption><p>Editando categoria</p></figcaption></figure>

### Produto Inteiro ou Fracionado

Caso a quantidade do item no slot seja inteira, você deve indicar isso usando **'i'** para inteiro, ou **'f'** para fracionada, no "Cód. ERP" do modificador. Insira o número do slot após a letra, como **'i0'** ou **'f0'** para o slot 0.

<figure><img src="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-c83305dde8720f8beabd7b1fe9acf09f7e9a9b08%2FScreenshot%202024-04-27%20at%2010.18.51.png?alt=media" alt=""><figcaption><p>Editando modificador</p></figcaption></figure>

## **Despachar pedidos**

Se desejar, você pode configurar para que os pedidos sejam despachados diretamente do delivery. Para isso, basta habilitar a opção "Despachar Pedidos" no gestor de pedidos.

{% hint style="warning" %}
Se você estiver usando a opção de aceite automático no delivery, é necessário desativar essa função para garantir o funcionamento correto da integração com a Colibri.
{% endhint %}

Neste caso, ao você passar do Status “Aceito” para “Entregando” o gestor de pedidos irá exibir uma tela com os entregadores disponíveis no Colibri para você selecionar o entregador desejado e efetuar a expedição.

Caso você opte por não expedir o pedido pelo gestor de pedidos, o sistema irá ficar monitorando o status dos pedidos no Colibri para atualizar automaticamente o delivery.

![Gestor de pedidos](https://lh3.googleusercontent.com/VIpkVoTC4lXcw1_HPeXlL7KL4ZkTTlNzXchfWcJ__wT2_1bBSfmvF3nsg_hK_cEHuO9ctubTFOCCphFwCM42sXKJOLD4ZSjvxJI1ZrTjiOwn79MjPFNG3BMk5w6LYf9oo9U6Tlld)