Gerar as Tags Auxxml e Agexml da Neogrid – Venda Agenciada

---
title: Gerar as Tags AuxXML e AgeXML da Neogrid – Venda Agenciada
slug: gerar-tags-auxxml-agexml
sistema:
  - Gestão Administrativa [04]
chamado: "0000263599"
categoria: user_manual
tipo: how-to
autor: Antonio Marcos Zampier
setor: Qualidade
modulo: Gestão Administrativa
publico: ""
keywords:
  - AuxXML
  - AgeXML
  - Neogrid
  - Intelbras
  - venda agenciada
  - NF-e
  - TXT Neogrid
  - PPA
  - ACK
versao_doc: 01
revisao: Paulo Bley
aprovado_em: 2025
versao_pipeline: 2.5.2
ultima_revisao: "2026-06-11"
---

## Visão Geral

Permite configurar e gerar automaticamente as tags `#AutXML` e `#AgeXML` no campo de Observações da Nota Fiscal Eletrônica (NF-e) para produtos da marca Intelbras, atendendo às exigências de integração com os parceiros PPA, ACK e a plataforma Neogrid. O módulo também possibilita exportar um arquivo TXT com dados de estoque da marca Intelbras no padrão requerido pela Neogrid.

**Pré-requisitos:** o item deve ter a marca Intelbras configurada no cadastro; o vendedor auxiliar deve estar vinculado ao cliente e com CNPJ/CPF preenchido.

## Configurar a Marca Intelbras no Cadastro do Item

Para que a tag `#AutXML` seja gerada, cada item deve ter a marca Intelbras configurada no cadastro.

No **Cadastro de Itens**, localize o item e preencha o campo **Marca**:

- Código: `00003`
- Descrição: `INTELBRAS`

![Cadastro de Itens com campo Marca preenchido com código 00003 e descrição INTELBRAS; item exibido: FECHADURA DIGITAL INTELBRAS FR331](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-06.png)

## Configurar o Vendedor Auxiliar para Geração da Tag AgeXML

A tag `#AgeXML` requer que o vendedor auxiliar esteja vinculado ao cliente e com documento fiscal preenchido.

**No Cadastro do Cliente:**

1. Acesse a aba **Relacionamentos**.
2. Clique em **Vendedores Auxiliares**.
3. Informe o vendedor auxiliar vinculado ao cliente.

**No Cadastro do Vendedor:**

- Preencha o campo **CPF** (pessoa física) ou **CNPJ** (pessoa jurídica).
- Confirme que o cadastro está **Ativo** e com o tipo **Vendedor** marcado.

![Cadastro de Clientes, Fornecedores e Transportadores — aba Vendedores Auxiliares com código 00004 e nome CATIELI listado; janela sobreposta mostra cadastro da vendedora CATIEL com CPF preenchido, cadastro Ativo e tipo Vendedor marcado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-07.png)

## Emitir a NF-e e Gerar as Tags Automaticamente

Com o cliente e os itens Intelbras devidamente configurados, o sistema gera as tags automaticamente ao finalizar a nota.

No módulo **Notas Fiscais**, com a nota aberta, clique em **Finalizar** e selecione a opção **Finalizar a Nota Fiscal e Imprimir**.

![Módulo Notas Fiscais com menu Finalizar aberto; opção Finalizar a Nota Fiscal e Imprimir destacada por seta](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-08.png)

> ⚠️ **Atenção:** a marca Intelbras no item e o CNPJ/CPF no cadastro do vendedor auxiliar são obrigatórios para que as tags sejam geradas. A ausência de qualquer um desses dados impede a geração.

## Geração Automática das Tags AuxXML e AgeXML nas Observações da NF-e

Ao finalizar e imprimir a NF-e, o sistema verifica as condições e insere as tags no campo **Observações** da nota.

**Tag `#AutXML` — autoriza XML para terceiros**

Gerada quando o cliente estiver cadastrado com código PPA ou ACK e houver itens da marca Intelbras na nota.

Formato gerado:

```
#AutXML:{cnpj:[xxxxxxxxxxx]}#AutXML
```

**Tag `#AgeXML` — venda agenciada**

Gerada quando a venda for agenciada. O sistema utiliza:

- CPF do vendedor informado no campo **Vendedor** da nota.
- CNPJ do vendedor auxiliar, extraído da aba **Vendedores Auxiliares** no cadastro do cliente.

Formato gerado:

```
#AgeXML:{cpf:[xxxxxxxxxxx],cnpj:[xxxxxxxxxxxxx]}#AgeXML
```

> **Nota:** as tags são gravadas diretamente no campo **Observações** da nota fiscal no momento de **Finalizar e Imprimir**. A presença dessas informações no XML permite o tratamento pelo servidor da Intelbras conforme exigências da operação.

![Cadastro Administrativo com NF-e aberta; seção Observações preenchida automaticamente com as tags AuxXML e AgeXML geradas pelo sistema](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-09.png)

## Gerar o Arquivo TXT de Itens para a Neogrid

No módulo **Geração PPA**, acesse o menu **Gerações** e selecione **Geração TXT Itens Neogrid**.

![Módulo Geração PPA com menu Gerações aberto, exibindo as opções Posicao Estoque - PPA, Movimentacao - PPA e Geração TXT Itens Neogrid (destacada por seta)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-10.png)

Na tela de geração, informe o **CNPJ da empresa destinatária**. O sistema filtra automaticamente os itens da marca Intelbras e exibe:

- Código reduzido do item
- Descrição completa
- Código de barras (EAN)
- Quantidade disponível em estoque
- Marca (Intelbras)

Após validar as informações, clique em **Gerar TXT** para exportar os dados no formato padrão Neogrid.

![Tela de Geração TXT Itens Neogrid com listagem de itens da marca Intelbras, incluindo colunas de código, EAN, quantidade em estoque e marca](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-11.png)

## Verificar o Formato do Arquivo TXT Gerado

Após a geração, o arquivo TXT pode ser aberto para validação da estrutura.

O arquivo contém:

- **Linha 01 (cabeçalho):** dados gerais do envio — tipo de operação, data, CNPJs envolvidos.
- **Linha 02 (detalhamento):** código interno, EAN, quantidade em estoque e valor.

O nome do arquivo segue o padrão:

```
RELEST_<CNPJ_PPA>_<DataHora>.txt
```

Exemplo: `RELEST_07673101000172_20250326103045.txt`

O local de salvamento é definido pelo usuário no momento da exportação.

> ⚠️ **Atenção:** antes de enviar, revise o conteúdo para garantir que não há dados negativos, EAN inválido ou campos em branco.

![Arquivo TXT gerado aberto no Bloco de Notas, exibindo cabeçalho e linhas de detalhamento no formato fixo requerido pela Neogrid](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/gerar-tags-auxxml-agexml/gerar-tags-auxxml-agexml-12.png)

## Informações do documento

> Autor: Antonio Marcos Zampier
> Setor: Qualidade
> Módulo: Gestão Administrativa
> Chamado: 0000263599
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Bley
> Aprovado em: 2025

---

> 📎 **Arquivos originais:** [Manual para gerar as Tags AuxXML e AgeXML da Neogrid – Venda Agenciada.docx](https://drive.google.com/uc?export=download&id=1P_uaknLS8YnJPpg-2XW0kG-VGlirBy1y) · [Manual para gerar as Tags AuxXML e AgeXML da Neogrid – Venda Agenciada.pdf](https://drive.google.com/uc?export=download&id=1K--k_Ke2JgUs3KfzWmDwlV56Ajo7ahiz)