> 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/liber.md).

# Liber

Integração | Industrial

### Visão geral

A integração entre o Liber e o Consistem ERP tem como objetivo automatizar e otimizar a troca de informações operacionais da gestão fabril e do processo têxtil entre as duas plataformas. Por meio dessa solução, elimina-se o controle manual e o retrabalho de digitação, permitindo a sincronização fluida de cadastros de itens, estruturas de engenharia e ordens de tecelagem/partida para execução, além do envio dos apontamentos de chão de fábrica diretamente para o Consistem ERP.

### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Liber</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 8.0 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Estoques, Itens e Industrial.<br><a href="https://ajuda.consistem.com.br/consistem-api/">Consistem API</a></p><p><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>LIBER</strong> ativa junto à Consistem.<br></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://libercapital.com.br/">Saiba mais</a></td></tr><tr><td><strong>Servidor e Acessibilidade:</strong> Servidor do ERP acessível via protocolo seguro HTTPS (porta 443 liberada no firewall/proxy).</td><td><strong>Conta de Acesso Ativa:</strong> Empresa/Usuário cadastrado e ativo no ambiente da Liber com perfil Administrador.</td></tr><tr><td><strong>Usuário de Integração:</strong> Usuário exclusivo cadastrado no ERP com permissões de leitura e gravação nas rotinas industriais e de engenharia.</td><td><strong>Credenciais de API:</strong> Chave de API (<em>API Key</em>, <em>Token</em>) ou credenciais de cliente (<em>Client ID</em> e <em>Client Secret</em>) geradas no portal da Liber.</td></tr><tr><td></td><td><strong>Serviço de Endpoint:</strong> URLs dos serviços de homologação e produção disponibilizados pela Liber.</td></tr></tbody></table>

### Configuração da integração

#### No Consistem ERP:

1. **Ativação dos Serviços de API:** Certifique-se de que os serviços de Web Services / APIs REST do Consistem ERP estejam ativos e em execução no servidor.
2. **Criação do Usuário de Integração:** Cadastre um usuário de sistema exclusivo para a integração no ERP, atribuindo as permissões necessárias para manipulação de dados de engenharia, itens e ordens de produção/tecelagem.
3. **Obtenção do Endpoint e Credenciais:** Localize e copie a URL base do Endpoint do Consistem ERP e o token de autenticação vinculado ao usuário de integração. Esses dados serão inseridos no painel da Liber.

#### Na integração Liber:

1. **Acesso ao Painel de Integrações:** Faça login no portal da Liber utilizando uma conta Administrador e navegue até o menu Configurações > Integrações / API.
2. **Adicionar Conexão:** Selecione a opção para criar uma nova integração e escolha *Consistem ERP*.
3. **Parametrização de Acesso:** Insira a URL do Endpoint da API do Consistem ERP e o token/chave de autenticação obtidos no ERP.
4. **Mapeamento de Campos (De/Para):** Configure a correspondência entre os parâmetros do Liber e do Consistem ERP (ex.: códigos de itens, tipos de ordens de tecelagem/partida, centros de trabalho, máquinas e motivos de refugo).
5. **Teste de Conectividade:** Execute o teste de conexão na interface do Liber para validar se a comunicação com a API do Consistem ERP foi estabelecida com sucesso.
6. **Ativação:** Salve as configurações e ative a chave de sincronização automática.

### Como a integração funciona

A troca de informações entre o Liber e o Consistem ERP ocorre por meio de APIs RESTful sob o protocolo criptografado HTTPS/TLS, garantindo integridade e segurança no tráfego dos dados de produção.

* **Formato de Comunicação:** As requisições e respostas utilizam mensagens estruturadas no padrão JSON (ou XML, conforme especificação do endpoint).
* **Autenticação:** As chamadas são validadas via cabeçalho HTTP (*Header*) contendo o token de segurança (*Authorization: \<TOKEN>*).
* **Troca de Informações:**
  * **O que a Consistem envia:** Cadastro de Itens (matérias-primas e produtos), dados de Engenharia (estruturas de produtos e fichas técnicas) e Ordens de Tecelagem / Ordens de Partida programadas no ERP.
  * **O que a Consistem recebe:** Apontamentos de produção (quantidades produzidas, refugos e paradas de máquina), acompanhamento de operações e confirmações de consumo registradas na plataforma Liber.

### Fluxo do processo

O ciclo de vida das informações operacionais trocadas entre as plataformas segue a estrutura abaixo:

1. **Origem dos Dados:** Os cadastros de itens, as estruturas de engenharia e as ordens de tecelagem/partida são criados e programados no Consistem ERP.
2. **Formatação no Leiaute:** Os dados a serem integrados são consolidados estritamente no leiaute da Consistem, garantindo o preenchimento correto dos campos obrigatórios, tipos de dados e tabelas auxiliares.
3. **Envio da Carga:** O pacote de dados formatado no leiaute da Consistem é transmitido via API REST/HTTPS para os serviços da Liber.
4. **Execução no Chão de Fábrica:** A plataforma Liber recebe a carga de dados, gerencia a fila de produção nas máquinas/teares e realiza a coleta dos dados operacionais.
5. **Retorno do Apontamento:** Ao registrar a produção, o Liber envia uma resposta ao ERP formatada no leiaute de retorno da Consistem, contendo os apontamentos operacionais e atualizando o progresso das ordens e o saldo dos estoques no Consistem ERP.

<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/liber.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.