API REST Bilhete de Transporte Eletrônico
Documentação: http://developer.ophos.com.br/?url=/api/bpe.json
0.2.1 – Outubro de 2025
Em conformidade com as alterações de layout publicadas pela SEFAZ em 01/10/2025, por meio da Nota Técnica 2025.001 – versão 1.10, realizamos a readequação do schema utilizado na emissão do BP-e (Bilhete de Passagem Eletrônico).
Essas atualizações são necessárias para garantir a conformidade com a nova reforma tributária, que entrará em vigor a partir de 01/01/2026.
Principais alterações implementadas:
- Remoção dos atributos tributacaoRegular, creditoPresumidoIbs e creditoPresumidoCbs da estrutura ibsCbs;
- Remoção dos atributos percentualDiferimento, valorDiferimento e devolucao das estruturas IBS e CBS;
- Inclusão de novos tipos de desconto: Idoso 50%, Acompanhante PCD e Pessoa Obesa.
Observações Importantes:
- As adequações relacionadas à Reforma Tributária ainda estão sujeitas a ajustes, pois as discussões técnicas sobre a implementação permanecem em andamento pela SEFAZ.
- Recomenda-se que as integrações sejam revisadas e testadas em ambiente de homologação antes da data de vigência oficial (01/01/2026).
0.2.0 – Setembro de 2025
Foram realizados ajustes no schema da emissão do BP-e, utilizado na URI /emissao, com o objetivo de adequá-lo à nova reforma tributária, entre outras atualizações:
- Inclusão dos elementos valorDesonerado e codigoBeneficio, de preenchimento opcional, nas seguintes estruturas: ICMSN20, ICMSN40, ICMSN41, ICMSN51, ICMSN90.
- Adição dos elementos situacaoTributaria, classificacaoTributaria, ibsCbs e valorTotalDfe na estrutura Impostos. Esses campos estão relacionados aos novos tributos e passarão a ser obrigatórios a partir de janeiro de 2026.
Aqui está um exemplo em JSON que ilustra a estrutura impostos com os novos elementos mencionados:
{
"imposto": {
"situacaoTributária": "ST_000",
"classificacaoTributaria": "000000",
"icms": {},
"ibsCbs": {
"baseCalculo": 100,
"uf": {
"aliquota": 0,
"valor": 0
},
"municipal": {
"aliquota": 0,
"valor": 0
},
"federal": {
"aliquota": 0,
"valor": 0
}
}
}
}
Atenção: As adequações para a reforma tributária ainda estão sujeitas a alterações, pois as discussões sobre sua implementação continuam em andamento pela SEFAZ.
0.1.0 – Agosto de 2024
Publicação da documentação no formato OpenAPI