Configurar o XPED do Item Na Descrição da Nota Fiscal

---
title: Configurar o XPED do Item na Descrição da Nota Fiscal
slug: configurar-xped-item-na
sistema:
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
autor: Antonio Marcos Zampier
setor: Qualidade
modulo: ""
publico: ""
keywords:
  - XPED
  - macro
  - nota fiscal
  - cadastro de itens
  - referências adicionais
  - descrição do item
aprovado_em: 05/2024
release: ""
versao_pipeline: 2.5.2
chamado: ""
ultima_revisao: "2026-06-12"
---

## Visão Geral

Permite configurar uma macro nos Parâmetros de Nota Fiscal para que o número de Pedido de Compra do Comprador (XPED), cadastrado na aba **8 Referências Adicionais** do item, seja incluído automaticamente na descrição do item ao emitir a nota fiscal.

> **Nota:** As macros operam sobre dados do cadastro de itens. O valor do XPED é sempre buscado da aba Referências Adicionais; alterações feitas durante o lançamento da nota não são consideradas.

---

## Configurar a Macro nos Parâmetros de Empresa

Acesse **Parâmetros de Empresa** e vá até a aba **8 Parâmetros de Nota Fiscal**. Na seção **1 Informações da Observação**, em **Configuração Descrição Item NF**, configure o campo **Linha 01** com a macro `[ITEM_DESCRICAO] [ITEMCODIGO_XPED]`, selecionando o campo `ITEMCODIGO_XPED` na lista de campos disponíveis.

![Tela Parâmetros de Empresa, aba 8 Parâmetros de Nota Fiscal. Seção "1 Configuração Descrição Item NF" com Linha 01 preenchida com [ITEM_DESCRICAO] [ITEMCODIGO_XPED]. Painel "Campos" à direita exibe a lista de macros disponíveis com ITEMCODIGO_XPED selecionado.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/configurar-xped-item-na/configurar-xped-item-na-01.png)

---

## Cadastrar o XPED no Item

No **Cadastro de Itens**, acesse a aba **2 Relacionamentos** e depois a aba **8 Referências Adicionais**. Vincule o fornecedor ao item e preencha o campo **No. xPED** com o número do Pedido de Compra do Comprador correspondente.

![Tela Cadastro de Itens do item 021141 - AGUA COM GAS VALLE VITA 500ML. Aba 8 Referências Adicionais exibindo linha com fornecedor FARMAGILSON COM DE MEDICAMENTOS E PERFUMARIA LTDA, referência 54706, descrição AGUA COM GAS VALLE VITA 500ML, e campo No. xPED preenchido com XPED444.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/configurar-xped-item-na/configurar-xped-item-na-02.png)

> **Nota:** O campo XPED precisa ser preenchido para o fornecedor correto nesta aba, pois a macro busca exclusivamente aqui para compor a descrição na nota fiscal.

---

## Emitir a Nota Fiscal com o Fornecedor Vinculado

Na emissão da nota fiscal, informe o fornecedor que está relacionado na aba **8 Referências Adicionais** do item. No exemplo, o fornecedor selecionado é **FARMAGILSON COM DE MEDICAMENTOS E PERFUMARIA LTDA** (código 0000106).

![Tela Notas Fiscais em modo Inclusão. Campo Fornecedor preenchido com código 0000106 e FARMAGILSON COM DE MEDICAMENTOS E PERFUMARIA LTDA. Campos de cabeçalho incluem Tipo NSU, Situação NF-e, Modo NF-e 1 - NF-e Normal e Data Emissão 24/05/2024.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/configurar-xped-item-na/configurar-xped-item-na-03.png)

---

## Verificar o XPED no Lançamento do Item

Ao lançar o item na nota fiscal, o campo **Xped / No Item** é preenchido automaticamente com o valor cadastrado na aba Referências Adicionais (no exemplo, `XPED444`). Caso o valor seja alterado manualmente nesta tela, a alteração não será considerada — o sistema utiliza sempre o valor do cadastro.

![Tela Lançamento de Itens do item 021141 - AGUA COM GAS VALLE VITA 500ML. Campo "Xped / No Item" preenchido com XPED444 buscado automaticamente do cadastro do item.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/configurar-xped-item-na/configurar-xped-item-na-04.png)

---

## Conferir a Descrição Final na Nota Fiscal

Após salvar o lançamento, na grade de itens da nota fiscal o campo **Descrição do Item** exibe o valor composto pela macro: descrição original do item seguida do número do XPED (ex.: `AGUA COM GAS VALLE VITA 500ML XPED444`).

![Tela Notas Fiscais, aba 2 Itens e Serviços, sub-aba 3 Itens. Grade exibe item 021141 com Descrição do Item "AGUA COM GAS VALLE VITA 500ML XPED444", quantidade 1,00 UN, valor unitário 5,00 e valor total 5,00.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/configurar-xped-item-na/configurar-xped-item-na-05.png)

---

## Informações do documento

> Autor: Antonio Marcos Zampier
> Setor: Qualidade
> Módulo:
> Chamado:
> Versão do Sistema: 23.07a
> Versão do documento: 01
> Revisão: Andreia Burko Bley
> Aprovado em: 05/2024

---

> 📎 **Arquivos originais:** [Manual  Configurar o XPED do item na descrição da Nota Fiscal.docx](https://drive.google.com/uc?export=download&id=1Wjjd7-efzGy8TuqRcB4SeAr0NYaZ5F48) · [Manual  Configurar o XPED do item na descrição da Nota Fiscal.pdf](https://drive.google.com/uc?export=download&id=1CmdJSnioMa84DRavSq9gHCpJaNQv3J2k)