NCM Buscador
Buscar
CAMPO DO XML · BP-E Obrigatório 3 posições 6 regras

vPgto

Valor pago pelo BP-e (vBP - vDesconto)

✓ Conferido · 12 de outubro de 2026 BP-e (modelo 63): regras de validação — MOC BP-e — Visão Geral, versão 1.00b (as regras NÃO estão no Anexo I, que é só leiaute). Inclui a NT 2025.002 v2.00 — BP-e Transporte Aéreo (222 regras), que não tem MOC próprio · Portal Nacional do BP-e / SVRS

Onde fica no arquivo

No documento

  • BPe/infBPe/infValorBPe/vPgto

    Obrigatório, uma vez

  • BPeTA/infBPe/infValorBPe/vPgto

    Obrigatório, uma vez

  • bpeProc/BPe/infBPe/infValorBPe/vPgto

    Obrigatório, uma vez

O caminho até aqui, nível a nível

  1. BPe — Bilhete de Passagem Eletrônico
  2. └ infBPe — Informações do BP-e
  3. └ infValorBPe — Informações dos valores do Bilhete de Passagem
  4. └ vPgto — você está aqui

Dentro do grupo infValorBPe , informações dos valores do Bilhete de Passagem

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
TDec_1302
Formato base
string

Formato exigido: 0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})? Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

As regras que verificam este campo — 6

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.

438 vPgto Validações de Valores

Validar se o somatório das formas de pagamento (tag:pag/vPag) é diferente do valor pago do BP-e (tag:vPgto) + Troco (tag:vTroco) * Considerar uma tolerância de R$ 1,00 para mais ou para menos

Mensagem: BP-e com somatório dos pagamentos diferente do total pago

403 vPgto Validações de Valores

Validar se o valor pago pelo BP-e (tag:vPgto) corresponde ao valor total do bilhete (tag: vBP) menos o valor do desconto (tag:vDesconto)

Mensagem: Valor pago difere do Valor Total menos o desconto concedido

438 vPgto Ajuste de regras de validação do BPe

Validar se o somatório das formas de pagamento (tag:pag/vPag) é diferente do valor pago do BPe (tag:vPgto) + Troco (tag:vTroco) * Considerar uma tolerância de R$ 1,00 para mais ou para menos

Mensagem: BPe com somatório dos pagamentos diferente do total pago

403 vPgto Ajuste de regras de validação do BPe

Validar se o valor pago pelo BPe (tag:vPgto) corresponde ao valor total do bilhete (tag: vBP) menos o valor do desconto (tag:vDesconto)

Mensagem: Valor pago difere do Valor Total menos o desconto concedido

438 vPgto Validações de Valores

Validar se o somatório das formas de pagamento (tag:pag/vPag) é diferente do valor pago do BPe (tag:vPgto) + Troco (tag:vTroco)

Mensagem: BPe com somatório dos pagamentos diferente do total pago

403 vPgto Validações de Valores

Validar se o valor pago pelo BPe (tag:vPgto) corresponde ao valor total do bilhete (tag: vBP) menos o valor do desconto (tag:vDesconto)

Mensagem: Valor pago difere do Valor Total menos o desconto concedido

Campos do mesmo grupo — 8

São os campos que ficam ao lado deste no arquivo, dentro de BPe/infBPe/infValorBPe. Quem preenche um costuma precisar dos outros na mesma passada.

cDesconto Código do desconto quando informado com tipo 99 - Outros comp Identificação do Comprador do BP-e tpDesconto Tipo de desconto/benefício para o BP-e vBP Valor do Bilhete de Passagem vBPLiq Valor Líquido total do Bilhete SEM tributos vDesconto Valor do desconto concedido ao comprador vTroco Valor do troco xDesconto Descrição do tipo de desconto/benefício concedido

Perguntas frequentes

O que é o campo vPgto do BP-e?

Valor pago pelo BP-e (vBP - vDesconto) No XML ele fica em BPe/infBPe/infValorBPe/vPgto. Obrigatório, uma vez.

vPgto aparece em quantos lugares do BP-e?

Em 3 posições do esquema oficial: BPe/infBPe/infValorBPe/vPgto, BPeTA/infBPe/infValorBPe/vPgto, bpeProc/BPe/infBPe/infValorBPe/vPgto. 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.

Que formato o campo vPgto exige no BP-e?

Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. A regra é a expressão do próprio esquema (0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?), e ela é verificada antes de qualquer regra de negócio: valor fora do formato faz o arquivo ser recusado na validação, com rejeição genérica de schema — que é a mais difícil de diagnosticar justamente por não citar o campo.

Que rejeição vPgto pode causar no BP-e?

6 regras do manual citam este campo, disparando os códigos 438, 403. ⚠ 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.

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.

Voltar ao topo