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

# Movtech

Integração | Industrial

### Visão geral

A integração entre o Consistem ERP e a plataforma Movtech tem como objetivo automatizar a troca de dados operacionais e de gestão industrial entre os sistemas. O processo permite a sincronização contínua de Ordens de Produção, Compras, Estoque e Itens (cadastros mestres), eliminando a digitação manual, reduzindo falhas operacionais e garantindo que o planejamento fabril e o suprimento de materiais estejam perfeitamente alinhados entre os dois ambientes.

### Requisitos

<table><thead><tr><th width="461">Consistem ERP</th><th>Movtech</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.6 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Industrial, Compras, Estoques e Itens.<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>MOVT</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://www.movtech.com.br/">Saiba mais</a></td></tr><tr><td><strong>Permissões de Acesso:</strong> Usuário de serviço cadastrado no ERP com permissões de leitura e escrita nas rotinas de integração.</td><td><strong>Ambiente Ativo:</strong> Conta cadastrada e funcional na plataforma Movtech.</td></tr><tr><td><strong>Comunicação de Rede:</strong> Liberação de portas e endereços IP/URL no firewall da infraestrutura para tráfego HTTPS seguro.</td><td><strong>Chaves de Autenticação (API Key / Token):</strong> Token de acesso / API Key gerados no painel do sistema Movtech para autorizar chamadas do Consistem ERP.</td></tr><tr><td></td><td><strong>Cadastros de Apoio:</strong> Parametrizações prévias no ambiente Movtech (ex.: unidades de medida, depósitos, centros de trabalho).</td></tr></tbody></table>

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

#### No Consistem ERP:

1. **Geração de Credenciais de Acesso:** Crie um usuário de serviço específico para a integração no Consistem ERP com as permissões de acesso necessárias para leitura e escrita dos módulos envolvidos.
2. **Obtenção do Token / Chave de API:** Gere e copie a chave de autenticação (API Token / Chave de Acesso) correspondente ao usuário criado no ERP.
3. **Liberação de Endpoints:** Certifique-se de que a URL do Web Service do Consistem ERP está acessível e liberada na rede/firewall para receber e disparar requisições para a plataforma Movtech.

#### Na integração Movtech:

1. **Acessar as Configurações de API/Integração:** Faça login no painel administrativo do sistema Movtech e acesse a seção de *Integrações / APIs*.
2. **Inserir Credenciais e URL do ERP:** Informe a URL do endpoint do Consistem ERP e as credenciais de acesso/tokens gerados no ERP.
3. **Gerar Chave do Sistema Movtech:** Obtenha e copie a *API Key* ou *Secret Key* da Movtech para validar a comunicação de via inversa.
4. **Mapeamento de Dados (De-Para):** Realize o mapeamento dos campos correspondentes entre a Movtech e o Consistem ERP (ex.: tipos de ordem de produção, códigos de depósitos, grupos de itens, unidades de medida e status operacionais).
5. **Configurar Webhooks/Gatilhos:** Configure os eventos ou a periodicidade de execução (Jobs/Agendamentos) para envio e recebimento automático de informações.
6. **Teste de Conexão:** Execute o teste de integração no ambiente Movtech para validar o apontamento e a resposta da API do Consistem ERP.

### Como a integração funciona

A troca de dados entre o Consistem ERP e o sistema Movtech ocorre por meio de APIs RESTful trafegadas com segurança pelo protocolo HTTPS.

* **Formato da Comunicação:** As mensagens e arquivos trafegados utilizam a estrutura padrão em formato JSON ou XML.
* **Autenticação:** As requisições são validadas por meio de *Tokens* ou *API Keys* no cabeçalho (*Header*) de cada chamada.
* **Métodos Utilizados:**
  * POST: Para envio e inclusão de novos dados/registros (ex.: Ordens de Produção, Pedidos de Compra ou Apontamentos).
  * GET: Para consulta periódica de retornos, posições de estoque, cadastros de itens e status operacionais.
  * PUT / PATCH: Para atualização de dados e status de registros existentes.
* **Estrutura de Leiautes:** A integração segue estritamente os leiautes padrão da Consistem para importação e exportação de dados, garantindo as regras de negócio e a integridade das informações no ERP.

### Fluxo do processo

O fluxo de trabalho da integração ocorre em passos sequenciais entre as plataformas, abrangendo a disponibilização dos dados mestres e operacionais pelo ERP e o retorno das movimentações e apontamentos executados na Movtech:

1. **Disponibilização dos Dados (O que a Consistem envia):** O Consistem ERP disponibiliza via API os dados cadastrais e operacionais para a plataforma Movtech, utilizando o leiaute padrão Consistem de exportação. As informações enviadas englobam:
   1. Cadastros de Itens: Código do item, descrição, unidade de medida, grupo/família e características do produto.
   2. Ordens de Produção: Número da OP, código do item a ser produzido, quantidade planejada, datas previstas, estrutura de produto (BOM) e roteiros de operações.
   3. Dados de Compras: Pedidos e solicitações de compra, dados de fornecedores, prazos e quantidades contratadas.
   4. Saldos de Estoque: Posição e saldos atuais de matérias-primas, insumos e produtos acabados/semiacabados em estoque.
2. **Processamento na Movtech:** O sistema Movtech recebe a requisição, valida a estrutura enviada em relação ao leiaute Consistem e registra os dados em seu banco de dados.
   1. A Movtech executa o sequenciamento industrial, controle de chão de fábrica, acompanhamento de compras e gestão física dos materiais.
3. **Retorno dos Dados (O que a Consistem recebe):** Após a execução do processo no ambiente Movtech, a plataforma dispara os retornos para o Consistem ERP. As informações são recebidas através do leiaute padrão Consistem de importação, englobando:
   1. Apontamentos de Ordem de Produção: Confirmações de início e fim de etapas/OP, quantidades produzidas, refugos/perdas e tempos consumidos.
   2. Movimentações de Estoque: Baixas de matérias-primas por consumo, entradas de produtos acabados/semiacabados e transferências entre depósitos.
   3. Atualizações de Compras: Status de recebimento, confirmações de entregas de insumos e atualizações dos processos de aquisição.
4. **Validação e Gravação no ERP:** O Consistem ERP recebe as requisições da Movtech e as submete às regras de negócio do seu leiaute de importação.
   1. Se aprovado: O ERP grava as informações, efetuando a baixa/atualização automática de estoque, atualização do status da OP e lançamento dos custos de produção e compras.
   2. Se houver divergência: O sistema de validação do leiaute Consistem retorna uma mensagem de erro detalhada indicando a falha (ex.: item não cadastrado, saldo insuficiente ou parâmetro incorreto) para correção no sistema de origem.

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