> 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/drummer.md). # Drummer #### Visão geral Esta integração permite conectar o Consistem ERP ao sistema especialista Drummer, com o objetivo principal de automatizar o planejamento e controle industrial através da alimentação contínua de Ordens de Fabricação (OFs). A integração elimina processos manuais e retrabalhos, permitindo que a criação, modificação, consulta, cancelamento e exclusão de OFs ocorram de forma centralizada e ágil via APIs, com os dados sendo inseridos diretamente em uma plataforma e atualizados de forma automática no ERP. #### Requisitos
Consistem ERPDrummer

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Escopo de PCP: A integração é projetada exclusivamente para o módulo de PPCP Industrial.

Módulos: Estoque, Itens, PCP Industrial e PPCM.

Licença: Aquisição de licença IDR ativa junto à Consistem.

Infraestrutura: Consistem API ativa.

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação do Drummer que deve ser verificada com a empresa fornecedora.
Saiba mais
#### Configuração da integração **No Consistem ERP** 1. **Permissões de Serviço:** No [Cadastro de Usuário (CSMEN050)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario.md), acesse a [Aba Serviço](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario/aba-servico.md) e certifique-se de que a opção para o módulo *Industrial* e serviço *Drummer - Ordem de Fabricação* está marcada como *Sim* (**Liberado Consistem**). Isso garante que o usuário atrelado ao token possua permissão para alimentar o ERP.
2. **Geração do Token:** Na [Aba Segurança](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-usuario/aba-seguranca.md), selecione a empresa padrão e clique em **Gerar Token** para obter a *API\_KEY* que autenticará as requisições do Drummer.
**No Drummer** Com as credenciais do ERP geradas, configure o ambiente do Drummer para realizar as requisições: 1. **Configurar URL Base:** Aponte o conector de saída do Drummer para o link da API do Consistem ERP (exemplo padrão: `https://{host}/drummer/v10/`). 2. **Inserir Parâmetros de Cabeçalho (Header):** Configure o Drummer para injetar obrigatoriamente duas chaves em todas as requisições HTTP: 1. `Authorization`: Preencher com o Token (`YOUR_API_KEY`) copiado do Consistem ERP. 2. `empresa`: Preencher com o código numérico correspondente à empresa parametrizada. 3. **Definir o Tipo de Conteúdo:** Configure a propriedade `Content-Type` e `Accept` como `application/json`, pois as APIs da Consistem operam exclusivamente com estruturas JSON. #### Como a integração funciona A integração funciona por meio de chamadas ativas de Web Services baseados em arquitetura RESTful, utilizando o formato JSON (`application/json`) para a troca de mensagens. O Consistem ERP atua como o servidor que expõe os endpoints, e o Drummer atua como o cliente que consome os recursos. A API disponibiliza endpoints específicos para cada operação de negócio que é movimentada de maneira automatizada: * **Obter uma OF (GET):** Recupera os detalhes de uma ordem específica pelo código (`/ordemFabricacao/{codOF}`). * **Obter Listagem de OFs (GET):** Retorna uma lista paginada de ordens cadastradas (`/ordemFabricacao`). * **Cadastrar uma OF (PUT):** Realiza a inclusão de novas tabelas de ordens de fabricação no ERP (`/ordemFabricacao`). * **Atualizar OF(s) (POST):** Modifica dados de ordens e lotes existentes (`/ordemFabricacao`). * **Liberar OF Bloqueada (PUT):** Realiza a liberação de um lote retido informado na rota (`/liberarOrdemFabricacao/{codOF}/{codLote}`). * **Cancelar OF (POST):** Registra o cancelamento de uma ordem ou lote específico (`/cancelarOrdemFabricacao/{codOF}`). * **Estornar OF (POST):** Realiza o estorno de lançamentos da ordem (`/estornarOrdemFabricacao/{codOF}`). * **Excluir uma OF (DELETE):** Remove fisicamente o registro de uma OF que ainda não tenha movimentações impeditivas (`/ordemFabricacao/{codOF}`). #### Fluxo do processo O ciclo de vida das informações trafegadas entre os sistemas segue os passos abaixo: 1. **Planejamento no Origem (O que o Drummer envia):** O usuário realiza o sequenciamento e o planejamento da produção diretamente no sistema Drummer. 2. **Montagem do Payload:** O sistema Drummer gera um arquivo eletrônico estruturado no formato JSON. Este arquivo segue estritamente o leiaute padrão estabelecido pela Consistem, contendo campos obrigatórios e opcionais de engenharia, como identificação do produto, quantidade programada, máquina alocada, datas de início/término e a árvore de lotes/insumos. 3. **Envio dos Dados:** O Drummer realiza o disparo da requisição HTTP (utilizando o método adequado como PUT, POST ou DELETE) para a URL da API da Consistem, transmitindo o Token de autenticação e o código da empresa no cabeçalho da mensagem. 4. **Recebimento e Direcionamento Interno:** A API do Consistem ERP recebe o leiaute enviado, valida as credenciais de segurança e direciona os dados automaticamente para processamento no programa interno do ERP correspondente: 1. Criações, atualizações e exclusões acionam a [Geração de OF Manual (CCPMPC005)](/industrial/manuais-de-telas/ppcp-padrao/ordem-de-fabricacao-of/geracao-de-of-manual.md). 2. Consultas acionam o programa de [Consulta de OF (CCPMP740)](/industrial/manuais-de-telas/industrial-ppcp-industrial/consultas-de-ofs/consulta-de-of.md) ou de listagem/impressão [Impressão de OF com Código de Barras e Requisição (CCPOF455)](/industrial/manuais-de-telas/industrial-ppcp-industrial/impressao-de-of/impressao-de-of-com-codigo-de-barras-e-requisicao.md). 3. Liberações disparam o programa [Liberação de OF (CCPMPC045)](/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/liberacao-de-of.md) e cancelamentos utilizam o [Cancelamento de OF (CCPMP025)](/industrial/manuais-de-telas/industrial-ppcp-industrial/ordem-de-fabricacao-of/cancelamento-de-of.md). 5. **Validação de Negócio e Persistência:** O programa interno do ERP executa todas as regras de negócio nativas do PPCP Industrial (como checagem de estrutura de engenharia e saldos). Se os dados estiverem consistentes com as regras da fábrica, o movimento é gravado no banco de dados. 6. **Resposta Final (O que o Consistem devolve):** O ERP encerra o processo enviando um JSON de retorno para o Drummer: 1. **Em caso de sucesso (200 OK):** O Consistem envia ao Drummer o leiaute de confirmação contendo a tag *erpNumber* preenchida com o número oficial da Ordem de Fabricação gerada no ERP, além de atualizar o status do **errorFlag** para falso. Se for uma requisição de consulta (GET), a Consistem devolve o leiaute completo com os saldos atuais e consumos da OF. 2. **Em caso de falha (400 / 500):** A Consistem envia um leiaute de erro acompanhado de uma descrição detalhada no campo **mensagem** (como falta de saldo, parâmetro obrigatório em branco ou engenharia inválida), sinalizando que a operação foi rejeitada pelo ERP.

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