> 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/ag-trace.md). # Ag Trace Integração | Industrial ### Visão geral A integração entre o Consistem ERP e a plataforma Ag Trace tem como objetivo principal automatizar o intercâmbio e a validação de dados de rastreabilidade de algodão e fios (padrão ABRAPA), além de gerenciar a sincronização do fluxo de movimentações fiscais de entrada e saída. Com a expansão da integração para contemplar as Notas Fiscais, a solução permite consultar e importar automaticamente as etiquetas dos fornecedores no lançamento das notas de entrada, efetuar o rastreamento em rotinas de terminais e pesagem, realizar o bloqueio preventivo no fechamento de partidas com pendências de dados ABRAPA e transmitir automaticamente (ou sob demanda) as atualizações de status das Notas Fiscais de saída do ERP para a Ag Trace. ### Requisitos
Consistem ERPAg Trace

Compatibilidade: 7.6 ou superiores do Consistem ERP.

Módulos: Faturamento, Estoques, Itens e PCP Tecelagem.

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

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
Cadastro ativo dos Clientes, Fornecedores e Produtos sujeitos ao controle ABRAPA.Conta ativa na plataforma Ag Trace com perfil de administrador.
Credenciais de API ativas (Token de Autenticação / API Key e URLs dos Endpoints).
Ambiente configurado para recepção e envio dos eventos referente às Notas Fiscais e Etiquetas ABRAPA.
### Configuração da integração #### No Consistem ERP: 1. **Configuração dos Parâmetros de Integração:** 1. Acesse o programa [Integração (CSINTEGRACAO010)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md). 2. Localize o registro da integração **Ag Trace** e acione a opção *Editar*. 3. Informe os campos **Usuário Responsável**, **Host (Produção)** e **Host Homologação**. 4. Na coluna **Campo**, selecione o nível de acesso desejado. 5. Clique no botão **Empresa** para vincular os fornecedores que farão parte da integração com a Ag Trace. 6. Acesse a [aba Endpoints (CSINTEGRACAO010ATAB2)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-endpoints.md) e habilite os endpoints para a comunicação via API. 7. *(Opcional)* Utilize a [aba Integração Manual (CSINTEGRACAO010ATAB3)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-integracao-manual.md) para realizar simulações e validar o envio/recebimento de dados. 2. **Configuração do Módulo de Etiqueta e Terminal:** 1. Acesse o programa [Configuração do Módulo de Etiqueta Terminal (CCTGG024)](/modulos/industrial/manuais-de-telas/industrial-ppcp-tecelagem/configuracoes-gerais-de-tecelagem/configuracao-do-modulo-de-etiqueta-terminal.md). 2. Defina o tipo de controle exigido no campo **Controla Etiqueta Fornecedor**. 3. Configure a regra adotada no campo **Tipo Pesagem Etiqueta Fornecedor**. 3. **Parametrização de Regras ABRAPA e Validação de Fechamento:** 1. Mapeie os produtos, clientes e fornecedores sujeitos ao controle ABRAPA. 2. Ative a regra de validação no fechamento da partida para checar a existência dos dados ABRAPA nas etiquetas vinculadas. #### Na Ag Trace: 1. Acesse o portal da Ag Trace com credenciais administrativas. 2. Gere o Token/API Key de autenticação e registre as URLs de comunicação com o Consistem ERP. 3. Alinhe a tabela de "De-Para" dos cadastros de clientes, fornecedores e grupos de etiquetas ABRAPA para equivalência com os códigos do ERP. 4. Configure os Webhooks/Endpoints de recepção para acolher as alterações de status de Notas Fiscais enviadas pelo Consistem ERP. ### Como a integração funciona A comunicação entre o Consistem ERP e a Ag Trace ocorre por meio de Web Services e APIs RESTful, garantindo a troca contínua de dados nos formatos padrão estabelecidos. **O que a Consistem envia (para a Ag Trace):** * **Dados de Nota Fiscal de Saída (por mudança de status):** Sempre que uma Nota Fiscal de Saída sofre alteração de status no Consistem ERP (ex.: autorizada, emitida, cancelada), o sistema dispara automaticamente o envio das informações para a Ag Trace. * **Envio Manual de Nota Fiscal:** Funcionalidade que permite ao usuário reenviar, sob demanda, os dados de uma Nota Fiscal específica para a Ag Trace via rotina do ERP. * **Informações de Rastreabilidade e Etiquetas:** Dados detalhados dos produtos, clientes e etiquetas ABRAPA vinculados aos documentos fiscais. **O que a Consistem recebe (da Ag Trace):** * **Dados de Rastreabilidade na Entrada da NF:** Durante o lançamento de uma Nota Fiscal de Entrada no Consistem ERP, o sistema aciona a API da Ag Trace para consultar e importar os dados das etiquetas e informações de rastreio ABRAPA associadas aos produtos/fornecedores. * **Etiquetas de Fornecedores:** Informações das etiquetas do fornecedor capturadas e integradas diretamente no fluxo de recebimento e movimentação por terminais. ### Fluxo do processo O fluxo de trabalho descreve os passos sequenciais da integração, garantindo que o intercâmbio ocorra dentro do leiaute da Consistem: 1. **Importação das etiquetas na entrada da Nota Fiscal (Consistem recebe):** Ao cadastrar uma Nota Fiscal de Entrada no programa [Nota Fiscal de Entrada (CCESN110)](/modulos/entradas/manuais-de-telas/entradas-estoques/notas-fiscais-de-entrada/nota-fiscal-de-entrada.md), o Consistem ERP valida se o fornecedor possui integração ativa na tela [Integração (CSINTEGRACAO010)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md). Em caso positivo, efetua a consulta via API para a Ag Trace e importa os dados das etiquetas e informações ABRAPA no leiaute da Consistem. 2. **Apontamento e geração no terminal:** No programa [Geração de Etiqueta de Fio (CCTTGM120)](/modulos/entradas/manuais-de-telas/entradas-estoques/itens/geracao-de-etiqueta-de-fio.md), o operador seleciona o terminal (previamente configurado na [Configuração do Módulo de Etiqueta Terminal (CCTGG024)](/modulos/industrial/manuais-de-telas/industrial-ppcp-tecelagem/configuracoes-gerais-de-tecelagem/configuracao-do-modulo-de-etiqueta-terminal.md)), digita a etiqueta do fornecedor e aciona a opção **Gerar Etiqueta**. O sistema consulta as informações de acordo com a operação fiscal (Entrada de Fio, Retorno de Requisição, Remessa para Retorno Não Industrializado ou Partida de Fio Tinto). 3. **Validação no fechamento da partida:** Durante o encerramento/fechamento da partida, o Consistem ERP verifica se o cliente do pedido e o produto exigem o controle ABRAPA. Se a etiqueta do fornecedor não contiver os dados ABRAPA validados, o ERP bloqueia o fechamento do processo. 4. **Atualização das etiquetas e auditoria:** As etiquetas vinculadas podem ser consultadas no programa [Consulta das Etiquetas de Fios por Produto/Situação (CCTTGA670)](/modulos/industrial/manuais-de-telas/industrial-ppcp-tecelagem/consultas-gerais-da-tecelagem/consulta-das-etiquetas-de-fios-por-produto-situacao.md), detalhadas na [Consulta Detalhada de Etiqueta Têxtil (CCTTGA616)](/modulos/industrial/manuais-de-telas/industrial-ppcp-tecelagem/consultas-gerais-da-tecelagem/consulta-detalhada-de-etiqueta-textil.md) e auditadas na tela [Consulta das Etiquetas do Fornecedor do Documento Fiscal de Entrada (CCESN630)](/modulos/entradas/manuais-de-telas/entradas-estoques/consultas-de-notas-fiscais-de-entrada/consulta-das-etiquetas-do-fornecedor-do-documento-fiscal-de-entrada.md). 5. **Envio das alterações de status da Nota Fiscal (Consistem envia):** Sempre que houver alteração no status de uma Nota Fiscal de Saída (ou via acionamento da rotina de envio manual), o Consistem ERP compila os dados fiscais e de rastreabilidade e transmite as informações atualizadas para a Ag Trace no leiaute da Consistem.

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 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/ag-trace.md?ask=&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.