Os 276 campos do XML do BP-e
Onde cada tag fica no arquivo, o que ela aceita e qual regra a verifica. São 1499 posições no esquema — a mesma tag aparece em mais de um lugar, com ocorrência própria em cada um — e 34 campos têm lista fechada de valores.
(raiz do arquivo)
18 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| BPe | Bilhete de Passagem Eletrônico | Obrigatório, uma vez | — |
| bpeProc | BP-e processado | Obrigatório, uma vez | — |
| BPeTA | Bilhete de Passagem Eletrônico - Transporte Aéreo | Obrigatório, uma vez | — |
| BPeTM | Bilhete de Passagem Eletrônico Transporte Metropolitano | Obrigatório, uma vez | — |
| bpeTMProc | BP-e TM processado | Obrigatório, uma vez | — |
| consSitBPe | Schema de validação XML dp Pedido de Consulta da Situação Atual do BP-e. | Obrigatório, uma vez | — |
| consStatServBPe | Schema XML de validação do Pedido de Consulta do Status do Serviço BP-e | Obrigatório, uma vez | — |
| evAlteracaoPoltrona | Schema XML de validação do evento de alteração de poltrona 110116 | Obrigatório, uma vez | — |
| evCancBPe | Schema XML de validação do evento do cancelamento 110111 | Obrigatório, uma vez | — |
| evCancVincPgto | Schema XML de validação do evento cancelamento da vinculação do pgto 110301 | Obrigatório, uma vez | — |
| eventoBPe | Schema XML de validação do Pedido de Registro de Evento do BP-e | Obrigatório, uma vez | — |
| evExcessoBagagem | Schema XML de validação do evento de excesso de bagagem 110117 | Obrigatório, uma vez | — |
| evNaoEmbBPe | Schema XML de validação do evento do não embarque 110115 | Obrigatório, uma vez | — |
| evVincPgto | Schema XML de validação do evento de vinculação da transação de pagamento com o DFe - 110300 | Obrigatório, uma vez | — |
| retBPe | Schema XML de validação do retorno do BP-e | Obrigatório, uma vez | — |
| retConsSitBPe | Schema XML de validação do retorno da consulta da situação atual do BP-e. | Obrigatório, uma vez | — |
| retConsStatServBPe | Schema XML de validação do Resultado da Consulta do Status do Serviço de BP-e | Obrigatório, uma vez | — |
| retEventoBPe | Schema XML de validação do retorno Pedido de Evento do BP-e | Obrigatório, uma vez | — |
BPe
2 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| infBPe | Informações do BP-e | Obrigatório, uma vez | — |
| infBPeSupl | Informações suplementares do BP-e | Obrigatório, uma vez | — |
bpeProc
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| dhConexao | Data e Hora da Conexão de Origem | Opcional, no máximo uma vez | — |
| ipTransmissor | IP do transmissor do documento fiscal para o ambiente autorizador | Opcional, no máximo uma vez | — |
| nPortaCon | Porta de origem utilizada na conexão (De 0 a 65535) | Opcional, no máximo uma vez | — |
| protBPe | Tipo Protocolo de status resultado do processamento do BP-e (Modelo 63) | Obrigatório, uma vez | — |
| versao | Versão do leiaute | Obrigatório, uma vez | — |
consSitBPe
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| xServ | Serviço Solicitado | Obrigatório, uma vez | — |
evAlteracaoPoltrona
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| descEvento | Descrição do Evento - “Alteração de Poltrona” | Obrigatório, uma vez | — |
evCancVincPgto
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| nProtVincPgto | Número do Protocolo de autorização do evento a ser cancelado | Obrigatório, uma vez | — |
eventoBPe
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| infEvento | — | Obrigatório, uma vez | — |
evExcessoBagagem
2 campos
retConsSitBPe
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| procEventoBPe | Tipo procEvento | Opcional, quantas vezes precisar | — |
retConsStatServBPe
3 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| dhRetorno | AAAA-MM-DDTHH:MM:SSDeve ser preenchida com data e hora previstas para o retorno dos serviços prestados. | Opcional, no máximo uma vez | — |
| tMed | Tempo médio de resposta do serviço (em segundos) dos últimos 5 minutos | Opcional, no máximo uma vez | — |
| xObs | Campo observação utilizado para incluir informações ao contribuinte | Opcional, no máximo uma vez | — |
BPe/infBPe
15 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| agencia | Identificação da agência/preposto/terceiro que comercializou o BP-e | Opcional, no máximo uma vez | — |
| autXML | Autorizados para download do XML do DF-e | 0 a 10 vez(es) | — |
| comp | Identificação do Comprador do BP-e | Opcional, no máximo uma vez | — |
| emit | Identificação do Emitente do BP-e | Obrigatório, uma vez | — |
| Id | Identificador da tag a ser assinada | Obrigatório, uma vez | — |
| ide | Identificação do BP-e | Obrigatório, uma vez | — |
| imp | Informações relativas aos Impostos | Obrigatório, uma vez | — |
| infAdic | Informações Adicionais | Opcional, no máximo uma vez | — |
| infBPeSub | Informações dos BP-e de Substituição para remarcação e/ou transferência | Opcional, no máximo uma vez | — |
| infPassagem | Informações do detalhamento da Passagem | Obrigatório, uma vez | — |
| infRespTec | Informações do Responsável Técnico pela emissão do DF-e | Opcional, no máximo uma vez | — |
| infValorBPe | Informações dos valores do Bilhete de Passagem | Obrigatório, uma vez | — |
| infViagem | Grupo de informações da viagem do BP-e | Obrigatório, 1 vez(es) ou mais | — |
| pag | Dados de Pagamento. | 1 a 10 vez(es) | — |
| pgtoVinc | Grupo de informações da vínculação com a transação de pagamento | Opcional, no máximo uma vez | — |
BPe/infBPeSupl
2 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| boardPassBPe | Texto contendo o boarding Pass impresso no DABPE (padrão PDF417) | Opcional, no máximo uma vez | — |
| qrCodBPe | Texto com o QR-Code impresso no DABPE | Obrigatório, uma vez | — |
bpeProc/protBPe
2 campos
BPeTA/infBPe
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| infBPeVinculado | Informações do Serviço Vinculado a BPe Multiplo | Obrigatório, uma vez | — |
BPeTM/infBPe
2 campos
eventoBPe/infEvento
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cOrgao | Código do órgão de recepção do Evento. | Obrigatório, uma vez | — |
| detEvento | Detalhamento do evento específico | Obrigatório, uma vez | — |
| dhEvento | Data e Hora do Evento, formato UTC (AAAA-MM-DDThh:mm:ssTZD) | Obrigatório, uma vez | — |
| nSeqEvento | Seqüencial do evento para o mesmo tipo de evento. Para maioria dos eventos será 1, nos casos em que possa existir mais de um evento o autor do evento… | Obrigatório, uma vez | — |
| tpEvento | Tipo do Evento | Obrigatório, uma vez | — |
retEventoBPe/infEvento
2 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| dhRegEvento | Data e Hora de do recebimento do evento ou do registro do evento formato AAAA-MM-DDThh:mm:ssTZD | Opcional, no máximo uma vez | — |
| xEvento | Descrição do Evento | Opcional, no máximo uma vez | — |
BPe/infBPe/agencia
3 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| CNPJ | Número do CNPJ | Obrigatório, uma vez | 502478 |
| enderAgencia | Endereço da agência | Obrigatório, uma vez | — |
| xNome | Razão social ou Nome da Agência | Obrigatório, uma vez | — |
BPe/infBPe/autXML
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| CPF | CPF do autorizado | Obrigatório, uma vez | — |
BPe/infBPe/comp
3 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| enderComp | Endereço do comprador | Obrigatório, uma vez | — |
| idEstrangeiro | Identificador do comprador em caso de comprador estrangeiro | Obrigatório, uma vez | — |
| IE | Inscrição Estadual | Opcional, no máximo uma vez | — |
BPe/infBPe/emit
8 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| CNAE | CNAE Fiscal | Obrigatório, uma vez | — |
| CRT | Código de Regime Tributário. | Obrigatório, uma vez | — |
| enderEmit | Endereço do emitente | Obrigatório, uma vez | — |
| IEST | Inscrição Estadual do Substituto Tributário | Opcional, no máximo uma vez | — |
| IM | Inscrição Municipal | Obrigatório, uma vez | — |
| ISUFEmit | Inscrição do emitente da Suframa | Opcional, no máximo uma vez | — |
| TAR | Termo de Autorização de Serviço Regular | Opcional, no máximo uma vez | 414 |
| xFant | Nome fantasia do emitente | Opcional, no máximo uma vez | — |
BPe/infBPe/ide
20 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cBP | Código numérico que compõe a Chave de Acesso. | Obrigatório, uma vez | — |
| cDV | Digito verificador da chave de acesso | Obrigatório, uma vez | — |
| cMunFim | Código do município do fim da viagem | Obrigatório, uma vez | — |
| cMunIni | Código do município do início da viagem | Obrigatório, uma vez | — |
| cUF | Código da UF do emitente do BP-e | Obrigatório, uma vez | — |
| dhCont | Data e Hora da entrada em contingência | Obrigatório, uma vez | — |
| dhEmi | Data e hora de emissão do Bilhete de Passagem | Obrigatório, uma vez | — |
| gCompraGov | Grupo de Compras Governamentais | Opcional, no máximo uma vez | — |
| indPres | Indicador de presença do comprador no estabelecimento comercial no momento da operação | Obrigatório, uma vez | — |
| mod | Modelo do Bilhete de Passagem | Obrigatório, uma vez | — |
| modal | Modalidade de transporte | Obrigatório, uma vez | — |
| nBP | Número do bilhete de passagem | Obrigatório, uma vez | — |
| serie | Série do documento fiscal | Obrigatório, uma vez | — |
| tpAmb | Tipo do Ambiente | Obrigatório, uma vez | — |
| tpBPe | Tipo do BP-e | Obrigatório, uma vez | — |
| tpEmis | Forma de emissão do Bilhete (Normal ou Contingência Off-Line) | Obrigatório, uma vez | 228 |
| UFFim | Sigla da UF do Fim da Viagem | Obrigatório, uma vez | 406411 |
| UFIni | Sigla da UF Início da Viagem | Obrigatório, uma vez | — |
| verProc | Versão do processo de emissão | Obrigatório, uma vez | — |
| xJust | Justificativa da entrada em contingência | Obrigatório, uma vez | — |
BPe/infBPe/imp
6 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| IBSCBS | Grupo de informações do IBS e CBS | Opcional, no máximo uma vez | — |
| ICMS | Informações relativas ao ICMS | Obrigatório, uma vez | 435 |
| ICMSUFFim | Informações do ICMS de partilha com a UF de término do serviço de transporte na operação interestadual | Opcional, no máximo uma vez | — |
| infAdFisco | Informações adicionais de interesse do Fisco | Opcional, no máximo uma vez | — |
| vTotDFe | Valor total do documento fiscal (vBP) | Opcional, no máximo uma vez | — |
| vTotTrib | Valor Total dos Tributos | Opcional, no máximo uma vez | — |
BPe/infBPe/infAdic
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| infCpl | Informações complementares de interesse do Contribuinte | Opcional, no máximo uma vez | — |
BPe/infBPe/infBPeSub
2 campos
BPe/infBPe/infPassagem
7 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cLocDest | — | Obrigatório, uma vez | — |
| cLocOrig | Código da Localidade de Origem | Obrigatório, uma vez | — |
| dhEmb | Data e hora de embarque | Obrigatório, uma vez | — |
| dhValidade | Data e hora de validade do bilhete | Obrigatório, uma vez | — |
| infPassageiro | Informações do passageiro | Opcional, no máximo uma vez | — |
| xLocDest | Descrição da Localidade de Destino | Obrigatório, uma vez | — |
| xLocOrig | Descrição da Localidade de Origem | Obrigatório, uma vez | — |
BPe/infBPe/infRespTec
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| Email da pessoa jurídica a ser contatada | Obrigatório, uma vez | — | |
| fone | Telefone da pessoa jurídica a ser contatada | Obrigatório, uma vez | — |
| hashCSRT | Hash do token do código de segurança do responsável técnico | Obrigatório, uma vez | 680 |
| idCSRT | Identificador do código de segurança do responsável técnico | Obrigatório, uma vez | 680 |
| xContato | Nome da pessoa a ser contatada | Obrigatório, uma vez | — |
BPe/infBPe/infValorBPe
8 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cDesconto | Código do desconto quando informado com tipo 99 - Outros | Opcional, no máximo uma vez | — |
| tpDesconto | Tipo de desconto/benefício para o BP-e | Opcional, no máximo uma vez | 437511682 |
| vBP | Valor do Bilhete de Passagem | Obrigatório, uma vez | 434436403 |
| vBPLiq | Valor Líquido total do Bilhete SEM tributos | Opcional, no máximo uma vez | — |
| vDesconto | Valor do desconto concedido ao comprador | Obrigatório, uma vez | 401500403 |
| vPgto | Valor pago pelo BP-e (vBP - vDesconto) | Obrigatório, uma vez | 438403 |
| vTroco | Valor do troco | Obrigatório, uma vez | 438 |
| xDesconto | Descrição do tipo de desconto/benefício concedido | Opcional, no máximo uma vez | 437 |
BPe/infBPe/infViagem
11 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cPercurso | Código do percurso da viagem | Obrigatório, uma vez | — |
| dhViagem | Data e hora de referencia para a viagem | Obrigatório, uma vez | — |
| infTravessia | Informações do transporte aquaviário de travessia | Opcional, no máximo uma vez | — |
| plataforma | Plataforma/carro/barco de Embarque | Opcional, no máximo uma vez | — |
| poltrona | Número da Poltrona / assento / cabine | Opcional, no máximo uma vez | — |
| prefixo | Prefixo da linha | Opcional, no máximo uma vez | — |
| tpAcomodacao | Tipo de Acomodação | Obrigatório, uma vez | — |
| tpServ | Tipo de Serviço | Obrigatório, uma vez | 211 |
| tpTrecho | Tipo de trecho da viagem | Obrigatório, uma vez | 419420484485 |
| tpViagem | Tipo de Viagem | Obrigatório, uma vez | — |
| xPercurso | Descrição do Percurso da viagem | Obrigatório, uma vez | — |
BPe/infBPe/pag
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| card | Grupo de Cartões | Opcional, no máximo uma vez | 475478 |
| nDocPag | Número do documento ou carteira apresentada nas formas de pagamento diferentes de 03 e 04 | Opcional, no máximo uma vez | — |
| tPag | Forma de Pagamento:01-Dinheiro;02-Cheque;03-Cartão de Crédito;04-Cartão de Débito;05-Vale Transportel;06 - PIX; 99 - Outros | Obrigatório, uma vez | 475 |
| vPag | Valor do Pagamento | Obrigatório, uma vez | 438 |
| xPag | Descrição da forma de pagamento 99 - Outros | Opcional, no máximo uma vez | — |
BPe/infBPe/pgtoVinc
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pgto | Dados de cada pagamento previsto | 1 a 99 vez(es) | — |
bpeProc/protBPe/infFisco
2 campos
bpeProc/protBPe/infProt
6 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cStat | Código do status do BP-e. | Obrigatório, uma vez | — |
| dhRecbto | Data e hora de processamento, no formato AAAA-MM-DDTHH:MM:SS TZD. | Obrigatório, uma vez | — |
| digVal | Digest Value do BP-e processado. Utilizado para conferir a integridade do BP-e original. | Opcional, no máximo uma vez | — |
| nProt | Número do Protocolo de Status do BP-e. | Opcional, no máximo uma vez | — |
| verAplic | Versão do Aplicativo que processou o BP-e | Obrigatório, uma vez | — |
| xMotivo | Descrição literal do status do BP-e. | Obrigatório, uma vez | — |
BPeTA/infBPe/ide
2 campos
BPeTA/infBPe/imp
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| vINSSRet | Valor retido de contribuição previdenciária (informar apenas no Multiplo) | Opcional, no máximo uma vez | — |
BPeTA/infBPe/infBPeVinculado
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| chBPeMultiplo | Chave de acesso do BPe Multiplo | Obrigatório, uma vez | — |
BPeTA/infBPe/infViagem
4 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cAeroDest | Código IATA do Aeroporto de destino | Obrigatório, uma vez | — |
| cAeroOrig | Código IATA do Aeroporto de origem | Obrigatório, uma vez | — |
| nroVoo | Código voo viagem | Obrigatório, uma vez | — |
| SiglaCiaOperVoo | Sigla IATA da Companhia que opera o voo | Obrigatório, uma vez | — |
BPeTM/infBPe/detBPeTM
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| det | Datalhamento da viagem por trechos do BPeTM | 1 a 990 vez(es) | — |
| idEqpCont | Identificador do equipamento contador | Obrigatório, uma vez | — |
| placa | Placa do coletivo | Opcional, no máximo uma vez | — |
| UFFimViagem | Sigla da UF fim da Viagem | Opcional, no máximo uma vez | — |
| UFIniViagem | Sigla da UF início da Viagem | Obrigatório, uma vez | — |
BPeTM/infBPe/ide
2 campos
BPeTM/infBPe/total
3 campos
eventoBPe/infEvento/detEvento
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| versaoEvento | — | Obrigatório, uma vez | — |
BPe/infBPe/agencia/enderAgencia
10 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| CEP | CEP | Opcional, no máximo uma vez | — |
| cMun | Código do município (utilizar a tabela do IBGE), informar 9999999 para operações com o exterior. | Obrigatório, uma vez | 1015 |
| cPais | Código do país | Opcional, no máximo uma vez | — |
| nro | Número | Obrigatório, uma vez | — |
| UF | Sigla da UF, informar EX para operações com o exterior. | Obrigatório, uma vez | 425426433503 |
| xBairro | Bairro | Obrigatório, uma vez | — |
| xCpl | Complemento | Opcional, no máximo uma vez | — |
| xLgr | Logradouro | Obrigatório, uma vez | — |
| xMun | Nome do município, informar EXTERIOR para operações com o exterior. | Obrigatório, uma vez | — |
| xPais | Nome do país | Opcional, no máximo uma vez | — |
BPe/infBPe/ide/gCompraGov
4 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pRedutor | Percentual de redução de aliquota em compra governamental | Obrigatório, uma vez | 367381384 |
| refDFeAnt | Chave de acesso do documento fiscal anterior. Deverá ser informado para tpOperGov 2 e 3 e vedado para os tipos 1 e 4. No caso do tpOperGov 2 aceitará… | 0 a 99 vez(es) | — |
| tpEnteGov | Para administração pública direta e suas autarquias e fundações: 1=União 2=Estados 3=Distrito Federal 4=Municípios 5=Consórcio Público 6=Comitê… | Obrigatório, uma vez | 347 |
| tpOperGov | Tipo da operação com ente governamental: 1 – Fornecimento com pagamento posterior; 2 - Recebimento do pagamento com fornecimento já realizado; 3 –… | Obrigatório, uma vez | — |
BPe/infBPe/imp/IBSCBS
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cClassTrib | Código de Classificação Tributária do IBS e da CBS | Obrigatório, uma vez | 312388 |
| CST | Código Situação Tributária do IBS/CBS | Obrigatório, uma vez | 311366369383 |
| gEstornoCred | Informado conforme indicador no cClassTrib | Opcional, no máximo uma vez | — |
| gIBSCBS | Tipo CBS IBS Completo | Opcional, no máximo uma vez | — |
| indDoacao | Tipo Indicador de Doação | Opcional, no máximo uma vez | — |
BPe/infBPe/imp/ICMS
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| ICMS00 | Prestação sujeito à tributação normal do ICMS | Obrigatório, uma vez | — |
| ICMS20 | Prestação sujeito à tributação com redução de BC do ICMS | Obrigatório, uma vez | — |
| ICMS45 | ICMS Isento, não Tributado ou diferido | Obrigatório, uma vez | — |
| ICMS90 | ICMS Outros | Obrigatório, uma vez | — |
| ICMSSN | Simples Nacional | Obrigatório, uma vez | — |
BPe/infBPe/imp/ICMSUFFim
7 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pFCPUFFim | Percentual do ICMS relativo ao Fundo de Combate à pobreza (FCP) na UF fim da viagem | Obrigatório, uma vez | — |
| pICMSInter | Alíquota interestadual das UF envolvidas | Obrigatório, uma vez | — |
| pICMSUFFim | Alíquota interna da UF fim da viagem | Obrigatório, uma vez | — |
| vBCUFFim | Valor da BC do ICMS na UF fim da viagem | Obrigatório, uma vez | — |
| vFCPUFFim | Valor do ICMS relativo ao Fundo de Combate á Pobreza (FCP) da UF fim da viagem | Obrigatório, uma vez | — |
| vICMSUFFim | Valor do ICMS de partilha para a UF fim da viagem | Obrigatório, uma vez | — |
| vICMSUFIni | Valor do ICMS de partilha para a UF início da viagem | Obrigatório, uma vez | — |
BPe/infBPe/infPassagem/infPassageiro
4 campos
BPe/infBPe/infValorBPe/Comp
2 campos
BPe/infBPe/infViagem/infTravessia
2 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| sitVeiculo | Situação do veículo transportado | Obrigatório, uma vez | — |
| tpVeiculo | Tipo do veículo transportado | Obrigatório, uma vez | — |
BPe/infBPe/pag/card
8 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cAut | Número de autorização da operação cartão de crédito/débito | Opcional, no máximo uma vez | — |
| infAdCard | Informações adicionais operacionais para integração do cartão de crédito | Opcional, no máximo uma vez | — |
| nParcelas | Número de parcelas | Opcional, no máximo uma vez | — |
| nsuHost | Número sequencial único do Host | Opcional, no máximo uma vez | — |
| nsuTrans | Número sequencial único da transação | Opcional, no máximo uma vez | — |
| tBand | Bandeira da operadora de cartão de crédito/débito | Opcional, no máximo uma vez | — |
| tpIntegra | Tipo de Integração do processo de pagamento com o sistema de automação da empresa 1=Pagamento integrado com o sistema de automação da empresa Ex.… | Obrigatório, uma vez | 477478 |
| xBand | Descrição da operador de cartão para 99 - Outros | Opcional, no máximo uma vez | — |
BPe/infBPe/pgtoVinc/pgto
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| CNPJBasePSP | CNPJ base da instituição financeira ou de pagamento | Obrigatório, uma vez | — |
| CNPJReceb | CNPJ do recebedor do pagamento | Obrigatório, uma vez | — |
| idTransacao | ID específico da transação financeira conforme o meio de pagamento | Obrigatório, uma vez | — |
| nPag | Número sequencial do pagamento | Obrigatório, uma vez | — |
| tpMeioPgto | Código do meio de pagamento (ver IT DFe 2026.001) | Obrigatório, uma vez | — |
BPeTM/infBPe/detBPeTM/det
3 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| nContFim | Contador fim da viagem | Obrigatório, uma vez | — |
| nContInicio | Contador início da viagem | Obrigatório, uma vez | — |
| nViagem | — | Obrigatório, uma vez | — |
BPeTM/infBPe/total/IBSCBSTot
3 campos
BPeTM/infBPe/total/ICMSTot
2 campos
BPe/infBPe/imp/IBSCBS/gEstornoCred
2 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| vCBSEstCred | Valor da CBS a ser estornada | Obrigatório, uma vez | — |
| vIBSEstCred | Valor do IBS a ser estornado | Obrigatório, uma vez | — |
BPe/infBPe/imp/IBSCBS/gIBSCBS
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| gIBSMun | Grupo de Informações do IBS no Município | Obrigatório, uma vez | — |
| gIBSUF | Grupo de informações do IBS na UF | Obrigatório, uma vez | — |
| gTribCompraGov | Grupo de informações da composição do valor do IBS e da CBS em compras governamental | Opcional, no máximo uma vez | — |
| gTribRegular | Grupo de informações da Tributação Regular. Informar como seria a tributação caso não cumprida a condição resolutória/suspensiva. Exemplo 1: Art.… | Opcional, no máximo uma vez | — |
| vIBS | Valor do IBS | Obrigatório, uma vez | — |
BPe/infBPe/imp/ICMS/ICMS00
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pICMS | Alíquota do ICMS | Obrigatório, uma vez | — |
BPe/infBPe/imp/ICMS/ICMS20
3 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cBenef | Código de Benefício Fiscal na UF aplicado | Obrigatório, uma vez | — |
| pRedBC | Percentual de redução da BC | Obrigatório, uma vez | — |
| vICMSDeson | Valor do ICMS de desoneração | Obrigatório, uma vez | — |
BPe/infBPe/imp/ICMS/ICMS90
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| vCred | Valor do Crédito Outorgado/Presumido | Opcional, no máximo uma vez | — |
BPe/infBPe/imp/ICMS/ICMSSN
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| indSN | Indica se o contribuinte é Simples Nacional 1=Sim | Obrigatório, uma vez | — |
BPeTM/infBPe/detBPeTM/det/Comp
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| qComp | Quantidade do componente | Obrigatório, uma vez | — |
BPeTM/infBPe/total/IBSCBSTot/gCBS
3 campos
BPe/infBPe/imp/IBSCBS/gIBSCBS/gCBS
5 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| gALCZFMCBS | Grupo de operações em áreas incentivadas (ALC/ZFM) - CBS (alíquota zero) | Opcional, no máximo uma vez | — |
| gDevTrib | Grupo de Informações da devolução de tributos | Opcional, no máximo uma vez | — |
| gDif | Grupo de campos do Diferimento | Opcional, no máximo uma vez | — |
| gRed | Grupo de campos da redução de aliquota | Opcional, no máximo uma vez | — |
| pCBS | Aliquota da CBS (em percentual) | Obrigatório, uma vez | 347326 |
BPe/infBPe/imp/IBSCBS/gIBSCBS/gIBSMun
2 campos
BPe/infBPe/imp/IBSCBS/gIBSCBS/gIBSUF
2 campos
BPe/infBPe/imp/IBSCBS/gIBSCBS/gTribCompraGov
6 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pAliqCBS | Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais | Obrigatório, uma vez | — |
| pAliqIBSMun | Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais | Obrigatório, uma vez | — |
| pAliqIBSUF | Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais | Obrigatório, uma vez | — |
| vTribCBS | Valor que seria devido a CBS, sem aplicação do Art. 473. da LC 214/2025 | Obrigatório, uma vez | — |
| vTribIBSMun | Valor que seria devido ao município, sem aplicação do Art. 473. da LC 214/2025 | Obrigatório, uma vez | — |
| vTribIBSUF | Valor que seria devido a UF, sem aplicação do Art. 473. da LC 214/2025 | Obrigatório, uma vez | — |
BPe/infBPe/imp/IBSCBS/gIBSCBS/gTribRegular
8 campos
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| cClassTribReg | Informar qual seria o cClassTrib caso não cumprida a condição resolutória/suspensiva | Obrigatório, uma vez | 332 |
| CSTReg | Código da Situação Tributária do IBS e CBS | Obrigatório, uma vez | — |
| pAliqEfetRegCBS | Alíquota da CBS | Obrigatório, uma vez | — |
| pAliqEfetRegIBSMun | Alíquota do IBS do Município | Obrigatório, uma vez | — |
| pAliqEfetRegIBSUF | Alíquota do IBS da UF | Obrigatório, uma vez | — |
| vTribRegCBS | Valor da CBS | Obrigatório, uma vez | — |
| vTribRegIBSMun | Valor do IBS do Município | Obrigatório, uma vez | — |
| vTribRegIBSUF | Valor do IBS da UF | Obrigatório, uma vez | — |
BPe/infBPe/imp/IBSCBS/gIBSCBS/gCBS/gDevTrib
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pDevTrib | Percentual de devolução do tributo, conforme LC 214/25 art. 118. | Opcional, no máximo uma vez | — |
BPe/infBPe/imp/IBSCBS/gIBSCBS/gCBS/gDif
1 campo
| Campo | O que é | Ocorrência | Regras |
|---|---|---|---|
| pDif | Percentual do diferimento | Obrigatório, uma vez | — |
BPe/infBPe/imp/IBSCBS/gIBSCBS/gCBS/gRed
2 campos
Perguntas frequentes
Quantos campos tem o XML do BP-e?
O esquema oficial (PL_BPe_100b_NT2026.004_RTC_1.00), lido pelo Buscador NCM, declara 276 nomes de tag distintos, em 1499 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 1245 posições estão no documento em si; as demais são de evento, consulta e retorno do web service.
Onde fica cada tag no XML do BP-e?
No caminho completo a partir do elemento raiz, reconstruído caminhando pela árvore do esquema oficial — não por tabela de manual. O Buscador NCM agrupa os campos pelo grupo em que eles ficam, na ordem em que o arquivo é montado, e a ficha de cada tag mostra todas as posições dela.
O campo do BP-e é o mesmo campo da NF-e?
Não necessariamente, e essa confusão custa caro. O mesmo nome de tag existe em vários documentos fiscais com regras e sentidos diferentes: uTrib na NF-e não é o uTrib do CT-e. Cada ficha lista o mesmo nome nos outros documentos, com a redação e o caminho de cada um — justamente para que a regra de um não seja aplicada ao outro.
Todo campo que aparece no pacote de esquemas do BP-e é um campo do BP-e?
Não. O pacote traz um arquivo de tipos COMPARTILHADO entre os documentos fiscais, e nele viajam grupos que pertencem a outros documentos. O critério do Buscador NCM é alcance: só entra a tag que o caminho alcança a partir do elemento raiz do documento. Tag declarada no pacote e não alcançada não é campo do leiaute dele.