> 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/ecubus.md). # eCubus ### Visão Geral A integração entre o Consistem ERP e o ecossistema eCubus (software de CAD/PDM) tem como objetivo principal unificar e automatizar o fluxo de engenharia de produtos. Esta sinergia elimina retrabalhos e digitações manuais, permitindo o fornecimento de informações estruturadas e atualizadas do banco de dados do Consistem ERP diretamente para o ambiente CAD. Em contrapartida, o sistema CAD retorna dados essenciais ao ERP, automatizando o cadastro de novos produtos, a definição das estruturas de produtos e o detalhamento dos processos de fabricação. ### Requisitos
Consistem ERPeCubus

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Estoque, Itens e PCP Industrial.

Licença: Aquisição de licença IEP ativo junto à Consistem.

Infraestrutura: Consistem API ativa.

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.
Saiba mais
### Configuração da Integração **No Consistem ERP** 1. **Ativação Geral do Módulo:** Acesse o programa [Configuração da Integração de Engenharia do Produto (CCPMEI000)](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/configuracao-da-integracao-de-engenharia-do-produto.md). Na [Aba Geral](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/configuracao-da-integracao-de-engenharia-do-produto/aba-geral.md), marque o campo **Ativar Integração de Importação de Engenharia** como *Sim*.

Essa flag é o gatilho essencial para que o barramento do ERP comece a aceitar e processar as requisições vindas do eCubus.

2. **Filtro e Validação de Escopo:** Ainda na [Aba Geral](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/configuracao-da-integracao-de-engenharia-do-produto/aba-geral.md), mapeie as regras de famílias de produtos permitidas nos campos **Máscara de Entrada para Integração** e **Máscara de Saída para Integração**.

Caso o eCubus tente integrar um código fora dessas máscaras, o Consistem rejeitará a transação por quebra de escopo aduaneiro/industrial.

3. **De/Para de Processos:** Acesse a [Aba Operações](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/configuracao-da-integracao-de-engenharia-do-produto/aba-operacoes.md), vincule as descrições ou abreviações de operações de texto vindas do CAD (ex: *Cortar* ou *Fresar)* aos respectivos códigos de Máquina/Linha e centros de trabalho cadastrados fisicamente no ERP. Esta amarração é obrigatória para que o roteiro seja interpretado corretamente pelo PCP.
4. **Parâmetros de Replicação de Insumos:** Acesse a [Aba Itens Base](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/configuracao-da-integracao-de-engenharia-do-produto/aba-itens-base.md), cadastre o código do item padrão (ou os itens base específicos por máscara) que servirá de modelo no ERP. Quando o eCubus projetar um novo insumo, o sistema clonará as parametrizações fiscais, tributárias e contábeis deste item base, alterando em tempo de execução apenas as propriedades do novo material (descrição, peso e unidade).
5. **Habilitação de Serviços e Token de Segurança:** Acesse o programa [Cadastro de Usuário (CSMEN050)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario.md) utilizando a conta de serviço atrelada à integração: 1. [Aba Serviço:](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario/aba-servico.md) Localize o agrupador do módulo *Industrial* e certifique-se de marcar como *Sim* (**Liberado Consistem**) as opções de serviço voltadas à entrada e consulta de engenharias.
2. [Aba Segurança:](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario/aba-seguranca.md) Selecione a empresa padrão e clique no botão **Gerar Token** para obter a chave criptografada exclusiva (`YOUR_API_KEY`). Esta chave deverá ser configurada no eCubus para ser injetada obrigatoriamente no cabeçalho (*Header*) de todas as requisições HTTP (`Authorization: Token YOUR_API_KEY`).
6. **Permissões de Perfil:** Certifique-se de que o perfil de acesso do usuário da integração possua direitos de execução liberados para os programas das classes `CCPMEI` e `CCCGI` envolvidos no barramento. **No eCubus** 1. **Configurar URL Base:** Aponte o conector ou gateway de saída do eCubus para o link das APIs do barramento do Consistem ERP (exemplo padrão: `https://{host}/api/v1/`). 2. **Inserir Parâmetros de Cabeçalho (Header):** Configure o conector do eCubus para injetar obrigatoriamente duas chaves em todas as requisições HTTP enviadas ao ERP: 1. `Authorization`: Preencher com o Token de segurança gerado no programa [Cadastro de Usuário (CSMEN050)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario.md) da Consistem. 2. `empresa`: Preencher com o código numérico correspondente à empresa/filial parametrizada no ERP. 3. **Definir o Tipo de Conteúdo:** Configure as propriedades de cabeçalho `Content-Type` e `Accept` como `application/json`, uma vez que as rotinas de integração operam exclusivamente com a troca de payloads estruturados em formato JSON. 4. **Mapeamento das Chamadas de Insumos:** Vincule a rotina de novos materiais do eCubus ao endpoint `CCCGI015APIRG` para disparar o cadastro automatizado via Item Base. Garanta também que o sistema consuma previamente o endpoint `CCCGI120APIRG` para mapear e validar a árvore de níveis de máscaras e evitar erros de hierarquia de itens antes de submeter um novo código ao ERP. 5. **Mapeamento de Estrutura de Engenharia:** Configure o eCubus para encapsular o projeto finalizado (contendo os dados de cabeçalho, a lista de materiais/componentes e o roteiro com os tempos e sequências de fabricação) e transmiti-lo via método HTTP POST para a rota da API `CCPMEI100APIRG`, direcionando as informações diretamente ao [Monitor para Geração de Engenharia Integrada (CCPMEI100)](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/monitor-para-geracao-de-engenharia-integrada.md). ### Como a Integração Funciona A comunicação e o intercâmbio de dados entre o Consistem ERP e o ecossistema eCubus ocorrem por meio de chamadas ativas de Web Services baseados em arquitetura RESTful, utilizando o formato JSON (`application/json`) para a estruturação das payloads. O Consistem ERP atua como o servidor que expõe os endpoints, e o integrador do eCubus atua como o cliente que consome e injeta os dados. A integração da Engenharia Padrão com o PDM/CAD via eCubus é operacionalizada em segundo plano por um motor de execução que aciona programas e APIs específicos de acordo com a operação de negócio: **Estrutura de Programas e Endpoints Executados** * Gestão de Itens e Insumos Básicos (Classe `CCCGI`): * [Cadastro de Item (CCCGI015)](/entradas/manuais-de-telas/entradas-estoques/itens/cadastro-de-item.md) / Rotina `CCCGI015APIRG`: Endpoint responsável por receber a requisição de novos materiais do eCubus, processar a clonagem automatizada com base no Item Base (parametrizado na `CCPMEI000`) e efetivar o cadastro de novos Itens Genéricos no ERP. Ele trata a geração dos dados de entrada e saídas de estoque de forma isolada. * [Cadastro dos Níveis da Máscara (CCCGI120)](/entradas/manuais-de-telas/entradas-estoques/configuracoes-de-estoque/cadastro-dos-niveis-da-mascara.md) / Rotina `CCCGI120APIRG`: Endpoint consumido de forma recursiva pelo eCubus para identificar, mapear e validar os níveis e hierarquias das máscaras de itens antes de submeter um novo código ao ERP. Também atua no método `GET` para validar se um item já existe e obter tabelas de correspondência. * Gestão de Engenharia do Produto (Classe `CCPMEI`): * [Monitor para Geração de Engenharia Integrada (CCPMEI100)](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/monitor-para-geracao-de-engenharia-integrada.md) / Rotina `CCPMEI100APIRG`: API Restful principal acionada pelo eCubus via método HTTP POST para receber o payload estruturado (contendo dados da Capa, lista de Componentes e o roteiro de Operações). O programa deposita as informações temporariamente na tela do [Monitor para Geração de Engenharia Integrada (CCPMEI100)](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/monitor-para-geracao-de-engenharia-integrada.md), que funciona como uma camada de homologação e validação estrutural antes da gravação oficial no ERP. * Tratamento de Revisões e Exclusões: * Ao receber uma atualização de engenharia (via método POST), o motor executa em background a limpeza da estrutura anterior cadastrada e gera um registro totalmente atualizado com base no último payload homologado do eCubus. Se houver uma requisição via método DELETE, a rotina `CCPMEI100APIRG` realiza a remoção física da pendência no monitor, desde que ela ainda não tenha sido efetivada. **Dinâmica do Conector e Flexibilidade** A estrutura de Web Services baseada em REST elimina a necessidade de alterar o projeto central do conector ou gerar novas compilações no ERP caso ocorram futuras inclusões, alterações ou exclusões de tags não obrigatórias nos arquivos JSON. O Consistem ERP está parametrizado para ler estritamente as tags oficiais detalhadas nos leiautes da integração e ignorar tags adicionais enviadas pelo eCubus que não estejam mapeadas no escopo padrão (elas não serão lidas nem gravadas), evitando falhas, quebras de contrato de API ou rejeições de comunicação. ### Fluxo do Processo O fluxo de trabalho da integração baseia-se em um modelo bidirecional e segue uma ordem cronológica rígida para garantir a consistência das informações entre as plataformas. 1. **Carga de Dados Iniciais (ERP → CAD):** O Consistem ERP envia as informações base de cadastros e chão de fábrica para abastecer o banco de dados do eCubus. 1. **Dados de Entradas enviados:** Natureza de estoque, posição de estoque, saldo atual de estoque, classificação fiscal, itens genéricos, definição dos níveis da máscara do item, itens sintéticos (níveis) e unidade de medida. 2. **Dados Industriais enviados:** Cadastro de máquinas, cadastro de engenharia, cadastro de fase de produção, cadastro de operações e cadastro de pendências de engenharia. 2. **Projeto e Engenharia no CAD:** Com os dados de insumos, máquinas e operações já atualizados dentro do ambiente de design, o projetista desenvolve o produto e sua respectiva árvore de componentes diretamente no software CAD integrado ao eCubus. 3. **Envio de Insumos/Itens Básicos (CAD → ERP):** Antes de enviar a estrutura de engenharia completa, o eCubus envia os novos insumos que foram criados no projeto e que servirão de base para a engenharia (apenas itens que não sejam compostos por outras subestruturas). 1. **API utilizada:** Rotina de Item Genérico / Entradas. 2. **Validações automáticas:** O sistema aciona os métodos para validar se o item já existe no banco e obter tabelas de correspondência por descrição ou máscara. Se o item for validado com sucesso, ele é inserido de forma definitiva no cadastro do ERP. 4. **Envio da Estrutura de Engenharia (CAD → ERP):** Com os itens e insumos base devidamente criados no ERP, o eCubus faz o envio da árvore do produto (estrutura) e do processo de fabricação. 1. **API utilizada:** Rotina de PCP Industrial / Engenharia do Produto. 2. **Destino do Leiaute:** Esses dados são recebidos e gravados no [Monitor para Geração de Engenharia Integrada (CCPMEI100)](/industrial/manuais-de-telas/industrial-integracao-de-engenharia-do-produto/integracao-de-engenharia-do-produto/monitor-para-geracao-de-engenharia-integrada.md), que serve como um ambiente de homologação técnica dentro do Consistem ERP. 5. **Validação e Ajustes no Monitor de Pendências:** O usuário responsável pela Engenharia no ERP revisa as pendências acumuladas. O sistema valida a consistência do leiaute enviado (regras de máscaras, operações de fabricação e insumos correspondentes). Caso encontre inconsistências, o ERP retorna um mapa de erros para que o eCubus ou o usuário faça as devidas correções antes da aprovação final. 6. **Liberação e Geração da Engenharia Padrão:** Após a validação e aprovação dos dados no monitor de pendências, o usuário aciona o comando para consolidar a engenharia no sistema. Os dados são movidos definitivamente para as tabelas oficiais de engenharia do produto (salvando nas globais de estrutura), tornando o item oficialmente disponível para o planejamento de produção (PCP) e faturamento. 7. **Processamento de Revisões e Atualizações:** Caso o projeto sofra alterações futuras dentro do eCubus, o fluxo se repete utilizando o método de tratamento de revisões. O PDM reenvia a engenharia utilizando o mesmo código identificador; o Consistem ERP recebe a atualização através do método do cadastro do item e atualiza o registro correspondente no banco de dados.

Esse conteúdo foi útil?

Sim Não

--- # 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://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/industrial/ecubus.md?ask=&goal= ``` `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.