Espécie dos volumes na NF-e: o que informar em esp
<esp>transp › vol › espRevisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
esp descreve a espécie dos volumes transportados: a maneira como o conjunto está apresentado para transporte, como caixas, sacos ou tambores quando essas descrições correspondem à carga real. O campo fica em /nfeProc/NFe/infNFe/transp/vol/esp. Sua função é ajudar a identificar os volumes do grupo vol, ao lado de sua quantidade, numeração e pesos.
A espécie do volume não é a descrição comercial de cada produto. Dez caixas podem conter diversos itens da nota; os nomes desses itens continuam em seus respectivos campos de produtos. Também não se deve copiar para esp a marca da mercadoria ou seu código de classificação fiscal. O MOC 7.0, X28 chama esse dado de espécie dos volumes transportados, e o schema PL_010c efetivamente consultado o define como texto, não como código fiscal.
Existe uma tabela de espécies permitidas?
A definição lida de esp usa TString, com comprimento de 1 a 60 caracteres. Ela não contém uma enumeração de palavras nem uma tabela de códigos para selecionar caixa, saco, palete ou outra espécie. Portanto, CAIXAS nos exemplos é uma descrição sintética, e não o nome de uma opção oficial obrigatória.
Isso permite representar uma descrição comprovada da expedição, mas não torna qualquer texto útil. Um preenchimento como MERCADORIA, repetido para toda operação sem olhar a embalagem, não explica a espécie dos volumes. Preferir uma descrição clara é uma decisão de qualidade do dado. Esta página não cria um catálogo universal de embalagens e não decide qual unidade física deve ser adotada quando a preparação da carga é ambígua.
Qual dado consultar antes de preencher
Confira a relação de embalagens da expedição e como os volumes serão efetivamente entregues ao transporte. O cadastro do produto pode descrever uma embalagem comercial interna, enquanto o transporte usa um acondicionamento diferente. Por exemplo, a venda de 48 frascos não significa que haverá 48 volumes: a expedição pode confirmar quatro caixas com 12 frascos cada.
Nessa hipótese, esp descreve as caixas do conjunto transportado, enquanto qVol informa sua quantidade. Se os frascos estiverem acomodados de outro modo, não mantenha CAIXAS por cópia do exemplo. Paletização, reembalagem e consolidação devem ser esclarecidas com a documentação física; o schema não decide se você deve contar caixas internas, unidades agrupadas ou outra apresentação.
A marca que identifica o volume, se houver, pertence a marca. A identificação como CX001 ou uma faixa documentada pertence a nVol. Não reúna essas três informações em esp quando seus campos próprios são aplicáveis e conhecidos.
Exemplo com uma espécie de embalagem
A expedição fictícia confirmou quatro caixas identificadas de CX001 a CX004. O trecho parcial abaixo mostra a associação entre espécie, quantidade e identificação:
<vol xmlns="http://www.portalfiscal.inf.br/nfe">
<qVol>4</qVol>
<esp>CAIXAS</esp>
<nVol>CX001 A CX004</nVol>
</vol>
A descrição e a faixa são ilustrativas. Não representam uma exigência de plural, maiúsculas ou sintaxe padronizada de numeração. Este trecho não inclui o restante da NF-e e não está pronto para transmissão. Ele também não declara pesos desconhecidos como zero.
E se houver caixas e sacos?
Quando a expedição diferencia conjuntos, registros separados podem preservar a espécie e a quantidade de cada um. Suponha três caixas e dois sacos distintos:
<vol xmlns="http://www.portalfiscal.inf.br/nfe">
<qVol>3</qVol>
<esp>CAIXAS</esp>
</vol>
<vol xmlns="http://www.portalfiscal.inf.br/nfe">
<qVol>2</qVol>
<esp>SACOS</esp>
</vol>
Os dois fragmentos são irmãos dentro do transporte, não um XML completo. O total físico desta hipótese é cinco volumes. Não copie qVol=5 em cada registro: isso descreveria dez volumes se os conjuntos fossem somados. O leiaute permite até 5.000 grupos vol; cada um tem no máximo um esp. Essa estrutura permite manter a espécie ligada aos demais dados do próprio grupo, sem inventar uma obrigação de separar toda embalagem individualmente.
Formato, ausência e falhas comuns
esp tem ocorrência de zero a um por vol. Quando não informado, sua ausência estrutural é diferente de enviar <esp/>, que não contém o mínimo de um caractere. Não use SEM INFORMACAO como preenchimento automático para esconder uma dúvida sobre a carga. A necessidade de documentar a espécie deve ser conferida no caso concreto; a opcionalidade do XSD não é uma dispensa geral.
O tipo TString preserva espaços e seu padrão não aceita espaço no início ou no fim do valor. Espaços internos podem compor uma descrição. Acentos compatíveis com esse tipo não são proibidos só por se tratar de XML, e a regra lida não impõe letras maiúsculas. Caracteres reservados do XML, como &, devem ser escapados pelo serializador; não altere a descrição real apenas para contornar uma implementação incorreta.
No grupo, esp vem depois de qVol, quando este existe, e antes de marca, nVol e pesos. Se houver erro estrutural, confira a ordem, o limite de 60 caracteres, o conteúdo vazio e os espaços nas extremidades. Se a divergência for física, compare o dado com a relação de expedição; trocar uma palavra para satisfazer o schema não resolve embalagem incorreta. Não há nesta página um código de rejeição inventado para essa divergência.
A referência estrutural é o PL_010c real, confrontado com o MOC e os documentos posteriores consultados até 26/09/2026. Ela não equivale a confirmação de implantação da UF. A visão completa dos campos relacionados está no artigo de volumes transportados.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/transp/vol/esp- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–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
60- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve