xLocDesemb na NF-e: local do desembaraço aduaneiro

xLocDesemb informa o local onde ocorreu o desembaraço aduaneiro da importação. É um campo textual do grupo DI do produto, em /nfeProc/NFe/infNFe/det/prod/DI/xLocDesemb.

O dado deve corresponder ao desembaraço da declaração associada à mercadoria. Não é, por definição, o endereço da empresa, o destino final da carga ou qualquer porto por onde o produto passou.

Qual local precisa ser confirmado

O MOC 7, p.19 distingue xLocDesemb, UFDesemb e dDesemb: local, unidade federada e data do mesmo evento aduaneiro. Essa associação é a primeira conferência.

O ponto de chegada internacional e o local do desembaraço podem representar etapas distintas do fluxo. Não deduza o segundo apenas pelo conhecimento de transporte, pela cidade de entrada ou pelo endereço do importador. Use os registros da declaração e do desembaraço; quando divergirem, confirme com o responsável aduaneiro qual informação documenta o fato.

Uma descrição logística como “entrega na filial” não substitui o local aduaneiro. Tampouco o código interno de um armazém comprova, sozinho, onde o desembaraço ocorreu.

Obrigatoriedade, tamanho e tipo

O grupo DI é opcional na estrutura de prod e pode se repetir até 100 vezes. Se uma ocorrência existir, xLocDesemb é obrigatório uma vez. No PL 010f v1.04, usa TString, com 1 a 60 caracteres.

Não existe, nessa declaração XSD, uma enumeração nacional de nomes para o campo. A ausência de enumeração não autoriza inventar a descrição: o conteúdo precisa representar o documento de origem. Não insira um código IBGE no lugar do nome apenas porque outros campos de município usam códigos.

O elemento fica depois de dDI e antes de UFDesemb. Respeitar a ordem dos filhos é necessário para a estrutura do XML. Se um sistema trabalha com texto longo, preserve a descrição fiel dentro do limite; um corte automático pode eliminar a parte que diferencia unidades aduaneiras.

Exemplo de representação

Fragmento sintético parcial do campo; o nome é fictício e não identifica recinto real ou uma declaração completa:

<xLocDesemb xmlns="http://www.portalfiscal.inf.br/nfe">Recinto Aduaneiro Exemplo</xLocDesemb>

Em uma operação real, compare essa descrição com UFDesemb e dDesemb da mesma DI. Se houver outro grupo DI no produto, confira seu local separadamente. A mesma descrição em duas declarações só é correta quando os documentos sustentam essa coincidência.

Se o nome verdadeiro contiver &, o serializador XML deve escapar o caractere como &; isso preserva o texto e não muda o local. Não substitua caracteres ou remova acentos por tentativa de autorização sem verificar a causa real da falha.

Como investigar campo ausente ou incoerente

Confira o XML efetivamente gerado: existência do grupo DI, presença de xLocDesemb, tamanho, conteúdo e ordem. Em falha de schema, procure elemento vazio, texto acima de 60 caracteres, caractere XML não escapado ou campo fora da sequência. Em divergência material, compare declaração, desembaraço, UF e item da NF-e.

Se a integração reutilizou o local de outra DI ou de outra empresa, corrija a associação na origem. Não basta alterar a aparência da descrição. Preserve o vínculo com os documentos e participantes reais da importação.

Quando o desembaraço ou seu local ainda não estiverem confirmados, a pendência é obter o registro correto. Preencher a cidade do importador ou a primeira unidade da lista não resolve essa falta. A definição do procedimento e do momento fiscal da emissão depende da operação real e do responsável, não deste campo textual.