Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

xEmb na NF-e: descrição da embalagem no contexto NFF

<xEmb>det › prod › infProdEmb › xEmb

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

xEmb descreve a embalagem do produto no grupo infProdEmb. Fica em /nfeProc/NFe/infNFe/det/prod/infProdEmb/xEmb. É a descrição do recipiente ou da forma de acondicionamento, como caixa, saco ou “a granel”, e não a quantidade de embalagens.

O grupo tem contexto específico de Nota Fiscal Fácil ou nota avulsa. Não use esse campo como descrição logística genérica em qualquer NF-e comercial.

Aplicação e rejeição 833

A NT 2021.002 v1.12, p.22, restringe as informações de embalagem à NFF ou à nota avulsa e documenta a I87-10, com 833 quando informadas indevidamente. A tabela da NT, p.8, observa, para a NFF, preenchimento somente quando modBC=1, pauta.

No diagnóstico de 833, os indicadores conferíveis na NT, p.22, são tpEmis=3 para NFF ou procEmi=1/procEmi=2 para nota avulsa. Eles precisam corresponder ao processo real; não devem ser alterados para habilitar a embalagem.

Essas condições devem refletir o processo verdadeiro e o tratamento já confirmado. Alterar processo de emissão ou método de base para permitir uma descrição de caixa não resolve a aplicação fiscal do grupo.

Se a necessidade é descrever volumes transportados, consulte a estrutura própria de transporte. xEmb pertence ao produto e explica o conteúdo por embalagem junto dos outros filhos; não substitui espécie, quantidade ou peso dos volumes de uma carga.

Texto curto, sem enumeração nacional no elemento

No PL 010f v1.04, xEmb é obrigatório uma vez quando infProdEmb existe. O tipo é TString, com 1 a 8 caracteres. Não há lista de códigos enumerados nessa declaração.

A NT apresenta exemplos como caixa, saco, balde, bandeja, barril, copo, fardo, garrafa, lata, pacote e pote. Eles ajudam a compreender o significado; não transformam o campo em uma enumeração fechada. Uma descrição fora dos exemplos não é automaticamente inválida, mas precisa representar a embalagem verdadeira e respeitar o limite.

Evite abreviação que destrua o sentido ou corte automático de uma descrição longa. Se o cadastro precisa de uma designação curta, confirme a forma fiel ao acondicionamento. Não preencha com um número ou um código interno sem garantir que ele representa a descrição esperada.

Relação com conteúdo e unidade

xEmb responde qual embalagem; qVolEmb, quanto produto há por embalagem; uEmb, em que unidade esse conteúdo é medido. O grupo exige todos os três filhos, na ordem descrição, quantidade e unidade.

Exemplo sintético parcial, sob hipótese de emissão apta ao grupo e caixa contendo 3 kg. Não representa uma nota completa ou pronta para transmissão:

<infProdEmb xmlns="http://www.portalfiscal.inf.br/nfe">
  <xEmb>caixa</xEmb>
  <qVolEmb>3.000</qVolEmb>
  <uEmb>kg</uEmb>
</infProdEmb>

O texto “caixa” não informa quantas caixas foram vendidas. O valor 3 informa o conteúdo em kg de cada caixa, não três caixas. Uma remessa de 10 caixas iguais teria 30 kg de conteúdo sob essa hipótese; o número de volumes, o peso bruto e a unidade comercial continuam sendo outras informações.

Diferença para uEmb e uCom

No exemplo, uEmb=kg, não “caixa”, porque o conteúdo é medido em massa. uCom pode ter outro contexto comercial já definido; não deve ser copiado de xEmb ou de uEmb por padrão. A descrição da embalagem não escolhe a unidade tributável nem o método de cálculo fiscal.

Como investigar descrição incorreta ou grupo recusado

Compare produto, embalagem cadastrada e XML. Em erro de schema, confira elemento vazio, limite de 8 caracteres, caracteres XML escapados e ordem dos filhos. Se houver 833, investigue o processo real de emissão e a condição de aplicação antes de trocar o texto.

Se o cadastro contém “caixa” mas o produto foi acondicionado em saco, confirme o fato e corrija a origem. Se falta informação, obtenha a descrição verdadeira; não use um termo genérico para ocultar a pendência. A confirmação do fluxo NFF/avulsa e do parâmetro de pauta pertence à operação, com os responsáveis, e não pode ser deduzida da embalagem física.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/infProdEmb/xEmb
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
inline:TString · TString
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

maxLength
8
minLength
1
pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}
whiteSpace
preserve