UF
Sigla da UF, informar EX para operações com o exterior.
Onde fica no arquivo
No documento
-
BPe/infBPe/agencia/enderAgencia/UF
Obrigatório, uma vez
-
BPe/infBPe/comp/enderComp/UF
Obrigatório, uma vez
-
BPe/infBPe/emit/enderEmit/UF
Obrigatório, uma vez
Sigla da UF
-
BPeTA/infBPe/agencia/enderAgencia/UF
Obrigatório, uma vez
-
BPeTA/infBPe/comp/enderComp/UF
Obrigatório, uma vez
-
BPeTA/infBPe/emit/enderEmit/UF
Obrigatório, uma vez
Sigla da UF
-
BPeTM/infBPe/emit/enderEmit/UF
Obrigatório, uma vez
Sigla da UF
-
bpeProc/BPe/infBPe/agencia/enderAgencia/UF
Obrigatório, uma vez
-
bpeProc/BPe/infBPe/comp/enderComp/UF
Obrigatório, uma vez
-
bpeProc/BPe/infBPe/emit/enderEmit/UF
Obrigatório, uma vez
Sigla da UF
-
bpeTMProc/BPeTM/infBPe/emit/enderEmit/UF
Obrigatório, uma vez
Sigla da UF
O caminho até aqui, nível a nível
- BPe — Bilhete de Passagem Eletrônico
- └ infBPe — Informações do BP-e
- └ agencia — Identificação da agência/preposto/terceiro que comercializou o BP-e
- └ enderAgencia — Endereço da agência
- └ UF — você está aqui
Dentro do grupo enderAgencia , endereço da agência
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- —
- Tipo no esquema
- TUf
- Formato base
- string
Valores aceitos — 28
- AC
- AL
- AM
- AP
- BA
- CE
- DF
- ES
- GO
- MA
- MG
- MS
- MT
- PA
- PB
- PE
- PI
- PR
- RJ
- RN
- RO
- RR
- RS
- SC
- SE
- SP
- TO
- EX
Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.
As regras que verificam este campo — 10
O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.
Se informado Comprador e endereço do Comprador não for exterior (tag:enderComp/UF <> “EX”) - Código do Município do Comprador deve existir (Tabela Municípios do IBGE)
Mensagem: Município do comprador inexistente
Se informado Comprador e endereço do Comprador for exterior (tag:enderComp/UF = “EX”) - Código do Município do Comprador deve ser 9999999
Mensagem: Código de Município inválido para comprador residente no exterior
Se informada Agência (grupo:agencia) e endereço não for exterior (tag:enderAgencia/UF <> “EX”): Código do Município da Agência deve existir (Tabela Municípios do IBGE)
Mensagem: Município da Agência inexistente
Se informado Agência e endereço da Agência for exterior (tag:enderAgencia/UF = “EX”): Código do Município da Agência deve ser 9999999
Mensagem: Código de Município inválido para Agência do exterior
Se informado Comprador,informado endereço do comprador e endereço do Comprador não for exterior (tag:enderComp/UF <> “EX”) - Código do Município do Comprador deve existir (Tabela Municípios do IBGE)
Mensagem: Município do comprador inexistente
Se informado Comprador, informado endereço do comprador e endereço do Comprador for exterior (tag:enderComp/UF = “EX”) - Código do Município do Comprador deve ser 9999999
Mensagem: Código de Município inválido para comprador residente no exterior
Se informado Comprador e endereço do Comprador não for exterior (tag:enderComp/UF <> “EX”) - Código do Município do Comprador deve existir (Tabela Municípios do
Mensagem: Município do comprador inexistente IBGE)
Se informado Comprador e endereço do Comprador for exterior (tag:enderComp/UF = “EX”) - Código do Município do Comprador deve ser 9999999
Mensagem: Código de Município inválido para comprador residente no exterior
Se informada Agência (grupo:agencia) e endereço não for exterior (tag:enderAgencia/UF <> “EX”): Código do Município da Agência deve existir (Tabela Municípios do IBGE)
Mensagem: Município da Agência inexistente
Se informado Agência e endereço da Agência for exterior (tag:enderAgencia/UF = “EX”): Código do Município da Agência deve ser 9999999
Mensagem: Código do Município inválido para Agência do exterior
O mesmo nome em outros documentos fiscais — 10
UF aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de
um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele
documento, que é onde a diferença aparece primeiro.
| Documento | O que o leiaute dele diz | Caminho lá |
|---|---|---|
| CT-e | Sigla da UF | ferrov/trafMut/ferroEnv/enderFerro/UF |
| CT-e OS | UF | rodoOS/veic/prop/UF |
| DC-e | Sigla da UF | DCe/infDCe/emit/enderEmit/UF |
| GTV-e | Sigla da UF | GTVe/infCte/ide/tomaTerceiro/enderToma/UF |
| MDF-e | Sigla da UF, , informar EX para operações com o exterior. | enviMDFe/MDFe/infMDFe/emit/enderEmit/UF |
| NF-e | Sigla da UF | NFe/infNFe/emit/enderEmit/UF |
| NF3e | Sigla da UF | NF3e/infNF3e/emit/enderEmit/UF |
| NFAg | Sigla da UF | NFAg/infNFAg/emit/enderEmit/UF |
| NFCom | Sigla da UF | NFCom/infNFCom/emit/enderEmit/UF |
| NFGas | Sigla da UF | NFGas/infNFGas/emit/enderEmit/UF |
Campos do mesmo grupo — 11
São os campos que ficam ao lado deste no arquivo, dentro de BPe/infBPe/agencia/enderAgencia. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo UF do BP-e?
Sigla da UF, informar EX para operações com o exterior. No XML ele fica em BPe/infBPe/agencia/enderAgencia/UF. Obrigatório, uma vez.
UF aparece em quantos lugares do BP-e?
Em 11 posições do esquema oficial: BPe/infBPe/agencia/enderAgencia/UF, BPe/infBPe/comp/enderComp/UF, BPe/infBPe/emit/enderEmit/UF, BPeTA/infBPe/agencia/enderAgencia/UF, BPeTA/infBPe/comp/enderComp/UF, BPeTA/infBPe/emit/enderEmit/UF e outras. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.
Quais valores UF aceita no BP-e?
O esquema oficial restringe a 28 valores: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE… Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.
Que rejeição UF pode causar no BP-e?
10 regras do manual citam este campo, disparando os códigos 425, 426, 433, 503. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.
UF no BP-e é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 10 outros documentos (CT-e, CT-e OS, DC-e, GTV-e, MDF-e, NF-e, NF3e, NFAg, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.
De onde vem esta descrição do BP-e?
Do esquema XML oficial (PL_BPe_100b_NT2026.004_RTC_1.00). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.