> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/industrial/mes-tnah.md).

# MES-TNAH

Integração | Industrial

#### Visão Geral

A integração entre o Consistem ERP e o MES-TNAH automatiza a gestão do chão de fábrica, garantindo o registro em tempo real de apontamentos e paralisações. Utilizando dispositivos próprios TNAH acoplados aos equipamentos, o sistema captura dados diretamente das máquinas, convertendo-os em informações precisas para o software de apontamento.

A comunicação ocorre via APIs, permitindo a sincronização automática de Ordens de Fabricação (OFs) e a gestão dinâmica dos eventos produtivos. Como resultado, elimina-se o trabalho manual do operador e reduzem-se drasticamente erros ou omissões nos registros de produção.

#### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>MES-TNAH</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.6 ou superiores do Consistem ERP.</p><p><strong>Módulo:</strong> Industrial - Integrações Indústria 4.0.</p><p><strong>Módulo Adquirido:</strong> É necessário possuir a licença ativa no sistema > <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>SIA</strong> ativa junto à Consistem.</p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br><a href="https://tnah.io/">Saiba mais</a></td></tr></tbody></table>

#### Configuração da Integração

**No Consistem ERP**

A configuração centralizada ocorre através do módulo Industrial - Integrações Indústria 4.0.

1. **Parâmetros Básicos**:

   * Acesse o programa [Configuração de Integração MES (CCSIAT005)](/modulos/industrial/manuais-de-telas/industrial-integracoes-industria-40/integracoes/configuracao-de-integracao-mes.md).
   * No campo **Situação**, selecione *Ativo*.
   * No campo **Integrador**, escolha a opção *TNAH*.

   <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FhcJXZaN6p6ayzrXxLDq2%2Fimage.png?alt=media&amp;token=a10bd7c3-9a80-4a8c-a359-b1813814d67a" alt=""><figcaption></figcaption></figure>
2. **Configuração do Integrador:**

   * Acesse o programa [Integração (CSINTEGRACAO010)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md);
   * Localize a *Integracao API TNAH* e clique em **Editar** para executar o [Cadastro de Integração (CSINTEGRACAO010A)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md);
   * Defina os parâmetros de endpoint e credenciais necessários para a comunicação via API;
   * No campo **Situação**, selecione *Ativo*.

   <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FgpOwLQ4VTRQRQ9SrYO7q%2Fimage.png?alt=media&amp;token=bdd15ab4-ec2b-4194-a39f-cbc43def8be8" alt=""><figcaption></figcaption></figure>
3. **Configuração de Operações:**

   * Acesse o programa [Cadastro de Operação (CCPGA015A)](/modulos/industrial/manuais-de-telas/industrial-ppcp-industrial/cadastros-gerais-do-ppcp/cadastro-de-operacao.md) para cada operação que deve ser monitorada pelo MES, marque o campo **Integra com MES** como *Sim*.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Este campo será habilitado para operações do tipo Interno.</p></div>

   <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2FHF9Ttxbmv0I797KKBiaG%2Fimage.png?alt=media&amp;token=62c769b4-a176-4d7e-bf97-4968effb7ff6" alt=""><figcaption></figcaption></figure>

**Na Integração TNAH:**

* O sistema TNAH deve estar preparado para receber notificações via método `PUT` (inclusão) e `POST` (cancelamento).
* Configurar a ferramenta para realizar o <kbd>GET</kbd> nas APIs do Consistem ERP assim que receber o código da OF/Lote enviado pelo integrador.

#### Como a integração funciona

A comunicação é realizada através de APIs (WebServices). O Consistem ERP atua como o gatilho inicial para o envio de dados de planejamento, enquanto o TNAH consome informações detalhadas e retorna o status da execução.

* **Método PUT:** Utilizado pela [Geração de OF Manual (CCPMPC005)](/modulos/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/geracao-de-of-manual.md) para incluir novas Ordens de Fabricação no TNAH.
* **Método POST:** Utilizado pelo [Cancelamento de OF (CCPMP025)](/modulos/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/cancelamento-de-of.md) para cancelar Ordens de Fabricação.
* **Formato de Comunicação:** JSON.
* **Leiaute de Envio:** O ERP envia um objeto simplificado contendo:
  * `codOF`: Código da Ordem de Fabricação/Lote.
  * `tipoOperacao`: Define se é <kbd>I</kbd> (Incluir) ou <kbd>C</kbd> (Cancelar).

#### Fluxo do processo

O fluxo segue o padrão de leiaute da Consistem para garantir a integridade dos dados operacionais e industriais:

1. **Geração da Ordem de Fabricação (ERP):** Ao criar ou alterar uma OF no Consistem ERP via [Geração de OF Manual (CCPMPC005)](/modulos/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/geracao-de-of-manual.md), o sistema valida se a integração MES está ativa e se a operação vinculada exige integração.
2. **Notificação de Inclusão (ERP** <i class="fa-arrow-right">:arrow-right:</i> **MES):** O Consistem gera a notificação no leiaute padrão de envio (contendo `codOF` e `tipooperacao: "I"`) e dispara um PUT para o endpoint do MES-TNAH.
3. **Coleta de Dados Detalhados da OF (MES** <i class="fa-arrow-right">:arrow-right:</i> **ERP):** Ao receber a notificação, o MES-TNAH lê o `codOF` e faz uma requisição GET nas APIs do Consistem ERP para buscar as informações detalhadas da OF/Lote (itens, estrutura, roteiro de produção, quantidades, etc.) necessárias para iniciar a produção.
4. **Execução e Apontamentos no Chão de Fábrica (MES** <i class="fa-arrow-right">:arrow-right:</i> **ERP):**
   1. **Abertura de Apontamento:** O MES envia o evento de início de produção para o ERP.
   2. **Paralisações:** Registros de paradas da máquina/equipamento são enviados ao Consistem, que realiza a validação das regras de negócio.
   3. **Fechamento de Apontamento:** O MES-TNAH comunica a conclusão da OF. O Consistem valida se existem apontamentos ou paralisações pendentes antes de registrar o encerramento final da ordem.
5. **Cancelamento da OF (ERP** <i class="fa-arrow-right">:arrow-right:</i> **MES):** Se uma OF for encerrada manualmente ou cancelada no ERP via [Cancelamento de OF (CCPMP025)](/modulos/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/cancelamento-de-of.md), o Consistem envia uma notificação no leiaute padrão (contendo `codOF` e `tipooperacao: "C"`) via método POST imediatamente ao MES-TNAH.

A configuração correta desses passos é essencial para evitar falhas na sincronização de dados de produção.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/industrial/mes-tnah.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.