> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/integracoes/erps-and-pdvs/erp-colibri-novo.md).

# Colibri

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="false"><figure><img src="/files/KXUgCBnSSHEfDvZf3tml" alt="Logo Colibri - RS Solutions"><figcaption><p>Colibri</p></figcaption></figure></div>

Ao ativar a integração, você poderá enviar os pedidos recebidos no seu delivery diretamente para o Colibri e atualizar automaticamente o status do pedido no delivery.

## Ativando a integração com Servidor Colibri

Em seu painel, acesso **DeliveryStore.** Você deve clicar em **"Autorizar Aplicativo"** e informar o seguinte token de acesso:

{% hint style="info" %}
856d34f9-0fc7-4c59-8516-c7caae49767a
{% endhint %}

<figure><img src="/files/P0ii9IY2jWFlSx1ZFc28" alt=""><figcaption></figcaption></figure>

Depois de achar o aplicativo de integração com o Colibri, você deve clicar em **"Instalar".**

<figure><img src="/files/qOGxL0mpAchARhSWUfsF" alt=""><figcaption></figcaption></figure>

### **Passo 1**

Depois de instalado o aplicativo de integração com o Colibri, você deve baixar o aplicativo **DeliveryTunnel** como mostrado na imagem abaixo e depois informar o endereço e a porta do servidor na rede clique no botão salvar, como mostrado na imagem abaixo.

<figure><img src="/files/eriCaapQ69ZStCs9CY1u" alt=""><figcaption></figcaption></figure>

### **Passo 2**

Ao clicar em salvar o sistema irá gerar um token de conexão do DeliveryTunnel com o gestor de pedidos, copie esse token de conexão e cole no campo do aplicativo DeliveryTunnel instalado no servidor colibri, como mostrado nas imagens abaixo.

<figure><img src="/files/VBzJJ9fparHdRXcWbGy5" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bZDAQbE0xG6Ng2SjJraw" alt=""><figcaption></figcaption></figure>

Depois de colado o token de conexão no DeliveryTunnel clique em conectar. Pronto seu Tunnel foi criado com sucesso, tendo assim uma comunicação do gestor de pedidos web direto com o servidor da colibri.

## Configurando Produto

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

### Produto Normal

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

{% hint style="info" %}
Se um produto normal tiver opções a ser escolhidas com código será tratado como um produto normal e caso alguma opção não tenha código ela será tratada como uma observação no produto principal.
{% endhint %}

<figure><img src="/files/6E8jH7YBPut6fpiQpTvK" alt=""><figcaption></figcaption></figure>

### Produto Combo

Um produto combo é quando ele tem modificadores, então você deve informar o código da opção no campo "Cód. ERP" no seu delivery com o início **"CMB"**, exemplo de código **"CMB-2010".**

{% hint style="info" %}
Um produto combo preferencialmente deve ter opções a ser escolhidas com um código de integração, mas caso alguma opção não tenha código ela será tratada como um observação no produto principal.
{% endhint %}

<figure><img src="/files/zJLdMiPYoyhEQxhG0bPs" alt=""><figcaption></figcaption></figure>

## Configurando Pagamentos

### Entrega

Para pagamentos na entrega, é necessário configurar os códigos externos nos meios de pagamento.

Para isso, siga os passos abaixo:

1. Acesse o seu painel.
2. Vá até **Configurações**.
3. Selecione **Formas de Pagamento**.
4. Clique em **Pagamento na Entrega**.
5. Adicione uma nova forma de pagamento ou edite uma existente.
6. No campo **Cód. ERP**, insira o código de pagamento correspondente do seu Colibri.

<figure><img src="/files/5mHx97cyh4XJ6XcLhsxC" alt=""><figcaption></figcaption></figure>

### Online

Para configurar o código de pagamento online, acesse o aplicativo de integração com o Colibri no "DeliveryStore" do seu painel, acesse no meu acima as configurações e coloque o código do pagamento online configurado no Colibri.

<figure><img src="/files/bUbksIswpGaFopSlbk5d" alt=""><figcaption></figcaption></figure>

## Erros no envio do pedido

Erros no envio de pedidos podem ocorrer devido à falta de um código de integração no produto ou opção, ou mesmo por falhas de conexão com o Colibri. O sistema de integração com o Colibri tentará enviar o pedido até 5 vezes; após essas tentativas, ele não enviará mais automaticamente. Para reenviar manualmente, acesse o aplicativo de integração com o Colibri no **"DeliveryStore"** do seu painel, localize o pedido não enviado, clique nele e selecione **"Reenviar"**.

<figure><img src="/files/Oe2oxvzTXHtNaCy7QQpd" alt=""><figcaption></figcaption></figure>

## Perguntas frequentes

<details>

<summary>Abre e fecha automático a loja?</summary>

Não, essa integração não inclui a funcionalidade de abrir e fechar a loja automaticamente. Ela é projetada apenas para enviar os pedidos para o Colibri.

</details>

<details>

<summary>O status do pedido é automaticamente atualizada?</summary>

Sim, o status do pedido é atualizado automaticamente. Todas as operações que você realizar no pedido no Colibri serão automaticamente refletidas no status do pedido no delivery. Caso você venha cancelar um pedido diretamente no Delivery, o integrador vai tentar cancelar o pedido no Colibri.

</details>

<details>

<summary>Código no produto principal</summary>

O produto principal é produto que o consumidor escolhe para comprar, caso ele não tenha código, ela será ignorado e vai ser integrado as opções escolhidas e caso no produto principal tenha valor, esse valor é adicionado a primeira opção da lista.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://delivery.ajuda.cc/integracoes/erps-and-pdvs/erp-colibri-novo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.