uEmb na NF-e: unidade do conteúdo por embalagem

uEmb informa a unidade de medida do conteúdo do produto em uma embalagem. Fica em /nfeProc/NFe/infNFe/det/prod/infProdEmb/uEmb e deve ser lido junto de qVolEmb e xEmb.

No exemplo “caixa com 3 kg”, xEmb é caixa, qVolEmb é 3 e uEmb é kg. Escrever “caixa” em uEmb nesse exemplo confundiria o recipiente com a unidade da quantidade medida.

Em quais emissões o campo aparece

A NT 2021.002 v1.12 vincula o grupo à Nota Fiscal Fácil e à nota avulsa. A I87-10, p.22, prevê 833 para o grupo informado fora das condições permitidas. No caso da NFF, a tabela de leiaute observa 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.

O campo não é uma unidade genérica para qualquer NF-e comercial. A necessidade de informar caixas no transporte não habilita infProdEmb. Processo de emissão e parâmetro fiscal devem corresponder à operação, sem alteração para contornar a restrição.

Unidade, recipiente e unidade comercial

As respostas podem coincidir em uma operação, mas essa coincidência precisa ser documentada. Se uCom contar caixas e uEmb medir kg, o conteúdo por caixa permite uma relação física; não significa que os dois campos devam receber a mesma unidade.

Também não confunda uEmb com espécie ou número de volumes transportados. Essas informações pertencem a outro contexto da nota.

Formato no XML

No PL 010f v1.04, uEmb é obrigatório uma vez dentro de infProdEmb, com TString de 1 a 8 caracteres. Não há enumeração de unidades nessa declaração. A NT apresenta exemplos como grama, kg, ton, litro, metro, m3, m2, unid e dúzia; exemplos não são uma lista fechada do XSD.

Use uma representação fiel à unidade confirmada, dentro do limite. Não complete com texto genérico para satisfazer a presença. Uma unidade desconhecida deixa a quantidade sem interpretação e não pode ser substituída automaticamente por “unid”.

Fragmento sintético parcial, sob hipótese de conteúdo medido em quilogramas:

<uEmb xmlns="http://www.portalfiscal.inf.br/nfe">kg</uEmb>

O trecho não é uma nota pronta para transmissão. No grupo, qVolEmb=3.000 passa a significar 3 kg por embalagem. Sem a quantidade e a descrição, o elemento isolado só demonstra formato.

Conversão precisa preservar a grandeza

Se cada embalagem contém 750 gramas, isso equivale a 0,750 kg. Representar qVolEmb=750 com uEmb=kg multiplicaria a leitura por 1000. Mudar apenas o texto da unidade, sem converter a quantidade, altera o conteúdo informado.

A conversão ilustrativa usa uma relação de massa conhecida. Ela não decide unidade comercial, tributável ou base fiscal, e não deve ser aplicada a volume/massa sem a informação física necessária. Litro e quilograma, por exemplo, não são intercambiáveis por uma simples troca de rótulo.

Como investigar inconsistência

Leia os três filhos no XML e compare com a especificação do produto e da embalagem. Confira se a origem contém uma unidade ou uma descrição do recipiente, se houve abreviação que perdeu significado e se a quantidade acompanhou eventual conversão.

Em falha de schema, confira presença, limite de 8 caracteres e ordem após qVolEmb. Em 833, confira aplicação do grupo. Corrija o cadastro ou mapeamento comprovado; se faltar a medida ou o critério de conversão, obtenha a informação antes de gerar o XML. O enquadramento da emissão e seus parâmetros fiscais continuam dependendo da operação real.