# Histórico de Codin por Filial

## Visão Geral

Vincule uma filial a um CODIN cadastrado no SURICATO, associando ambos por meio de uma chave externa utilizada na integração com a TOTVS.

Essa vinculação garante que as marcações sejam corretamente identificadas e processadas na filial correspondente.

#### Onde encontro esta tela?

Seja pelo menu superior ou lateral, o caminho é: **Dispositivo ➜ Codin ➜ Histórico de Codin por Filial**

* **Na Versão 3.1 (Nova):** Clique no ícone de menu à esquerda para expandir.

{% hint style="info" icon="lightbulb-on" %}
**Dica Ágil:** Pressione a lupa no topo e digite “Histórico de Codin por Filial” para ir direto, sem cliques extras. *v3.1.0*
{% endhint %}

## Regras de Negócio

**Pré-requisitos:**

* Possuir um CODIN cadastrado.
* Possuir uma Filial cadastrada.
* Possuir uma Chave Externa válida (fornecida pela TOTVS).

**Obrigatório:** Todos os campos do cadastro devem ser preenchidos.

## Como consultar um Histórico de Codin por filial

Ao acessar o menu, a primeira tela exibida é a de consulta, onde é possível visualizar e gerenciar os registros cadastrados.

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

### Consulta - Histórico de Codin por Filia

{% stepper %}
{% step %}
**+ Novo:** Cadastre um Histórico de Codin por filial para sua empresa, clicando neste botão.
{% endstep %}

{% step %}
**Pesquisar:** Pesquise usando filtros um Histórico de Codin por filial já cadastrado.
{% endstep %}

{% step %}
**Ferramentas da Tabela:** Você pode ordenar colunas (A-Z) ou exportar a lista em formatos como PDF, Excel ou CSV.
{% endstep %}

{% step %}
**Busca Rápida:** Localize um Histórico de Codin por filial pelo nome ou código.
{% endstep %}

{% step %}
**Editar cadastro:** Edite o cadastro de um Histórico de Codin por filial, clicando no botão de edição.
{% endstep %}
{% endstepper %}

## Como cadastrar um Histórico de Codin

Para iniciar um novo cadastro, clique no botão **+ Novo**.

**Dados do Cadastro**

1. **Código da Filial:** Selecione a filial que será vinculada.
2. **Codin:** Selecione o equipamento que será associado à filial.
3. **Chave Externa:** Informe o identificador utilizado na integração com a TOTVS.

**Salvar:** Clique em **+ Incluir** para registrar o vínculo.

{% hint style="success" %}
**Dica:** Utilize o botão de pesquisa nos campos para facilitar a localização dos registros.
{% endhint %}

<figure><img src="/files/Ldnhhvv7fR0qVD4bnOHK" alt=""><figcaption><p><em>Cadastro Histórico de Codin por filial</em></p></figcaption></figure>

## Guia de Edição Rápida

Precisa alterar um cadastro? Siga os passos:

1. Na tela de consulta, localize o registro desejado.
2. Clique no ícone de **edição**.
3. Realize as alterações necessárias.
4. Clique em **Salvar** para finalizar.

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

## FAQ - Perguntas Frequentes

<details>

<summary>Todos os campos precisam ser preenchidos no cadastro do Histórico de Codin por Filial?</summary>

Sim. Todos os campos da tela de cadastro são obrigatórios, pois o vínculo entre filial, CODIN e chave externa é essencial para o funcionamento correto da integração com a TOTVS.

</details>

<details>

<summary>O CODIN selecionado precisa ser de um tipo específico, como refeitório?</summary>

Não necessariamente. O CODIN deve ser um dispositivo previamente cadastrado no sistema e compatível com o processo de integração da filial, conforme a configuração definida junto à TOTVS.

</details>

<details>

<summary>Posso utilizar a mesma chave externa para mais de uma filial?</summary>

Isso depende da configuração fornecida pela TOTVS. Normalmente, a chave externa identifica de forma única a relação entre o CODIN e a filial, portanto é importante validar essa regra antes de reutilizá-la.

</details>

<details>

<summary>É possível alterar a filial ou o CODIN depois que o histórico já foi cadastrado?</summary>

Sim. Diferente de outros cadastros, todos os campos podem ser alterados no modo de edição do Histórico de Codin por Filial.

</details>

<details>

<summary>O que acontece se esse vínculo não for cadastrado corretamente?</summary>

Se o vínculo entre filial, CODIN e chave externa estiver incorreto ou ausente, as marcações enviadas pela TOTVS podem não ser processadas corretamente no SURICATO, impactando a integração e os registros da filial.

</details>


---

# Agent Instructions: 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:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao/manual-do-suricato/estrutura-e-equipamentos/dispositivos/codin-equipamento/historico-de-codin-por-filial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.