Web Service - BPeTMRecepcao
cStat prevista na NT 2025.001. As regras de negócio completas serão reunidas na página própria de Regras de Validação.O Serviço de Recepção de BP-e Transporte Metropolitano é oferecido pelos Portais das Secretarias da Fazenda dos Estados para a recepção dos BP-e TM emitidos pelos contribuintes credenciados em sua unidade federada.
O processamento é síncrono e não utiliza lotes. O contribuinte transmite um BP-e TM e recebe o resultado na mesma conexão.
O BP-e TM é emitido por contribuintes com credenciamento específico para essa modalidade, identificada pelo tipo de BP-e igual a 4. Esses contribuintes não são necessariamente os mesmos credenciados para emitir o BP-e normal.
- Função: recepção de mensagens de envio de BP-e Transporte Metropolitano.
- Processo: síncrono.
- Método:
bpeRecepcaoTM. - Parâmetro da mensagem da área de dados: compactado utilizando GZip e convertido para Base64.
1. Leiaute da Mensagem de Entrada
Entrada: estrutura XML do Bilhete de Passagem Transporte Metropolitano definida no capítulo final da NT 2020.002.
Schema XML: BPeTM_v9.99.xsd.
2. Leiaute da Mensagem de Retorno
Retorno: estrutura XML com o resultado do envio do BP-e TM, utilizando o mesmo Schema de retorno do BP-e normal.
Schema XML: retBPe_v9.99.xsd.
| # | Campo | Ele. | Pai | Tipo | Ocor. | Tam. | Descrição/Observação |
|---|---|---|---|---|---|---|---|
| AR01 | retBPe | Raiz | - | - | - | - | TAG raiz da resposta. |
| AR02 | versao | A | AR01 | N | 1-1 | 1-4 | Versão do leiaute. |
| AR03 | tpAmb | E | AR01 | N | 1-1 | 1 | Identificação do ambiente: 1 - Produção; 2 - Homologação. |
| AR04 | cUF | E | AR01 | N | 1-1 | 2 | Código da UF que atendeu à solicitação. |
| AR05 | verAplic | E | AR01 | C | 1-1 | 1-20 | Versão do aplicativo que recebeu o BP-e. |
| AR06 | cStat | E | AR01 | N | 1-1 | 3-4 | Código do status da resposta. |
| AR07 | xMotivo | E | AR01 | C | 1-1 | 1-255 | Descrição literal do status da resposta. |
| AR08 | protBPe | G | AR01 | - | 0-1 | - | Resposta ao processamento do BP-e. |
3. Leiaute de BP-e TM Processado
O BP-e TM utiliza o mesmo leiaute de BP-e processado normal.
| # | Campo | Ele. | Pai | Tipo | Ocor. | Tam. | Descrição/Observação |
|---|---|---|---|---|---|---|---|
| PR01 | protBPe | Raiz | - | - | - | - | TAG raiz da resposta de processamento. |
| PR02 | versao | A | PR01 | N | 1-1 | 2v2 | Versão do leiaute. |
| PR03 | infProt | G | PR01 | - | 1-1 | - | Informações do protocolo de resposta. |
| PR04 | Id | A | PR03 | C | 0-1 | - | Identificador da TAG a ser assinada. Se a UF assinar a resposta, preencher com o número do protocolo precedido do literal “ID”. |
| PR05 | tpAmb | E | PR03 | N | 1-1 | 1 | Identificação do ambiente: 1 - Produção; 2 - Homologação. |
| PR06 | verAplic | E | PR03 | C | 1-1 | 1-20 | Versão do aplicativo que recebeu o BP-e. |
| PR07 | chBPe | E | PR03 | N | 1-1 | 44 | Chave de acesso do BP-e. |
| PR08 | dhRecbto | E | PR03 | D | 1-1 | - | Data e hora do processamento, no formato AAAA-MM-DDTHH:MM:SS TZD. Em autorização, corresponde à gravação no banco de dados; em rejeição, ao recebimento do arquivo. |
| PR09 | nProt | E | PR03 | N | 0-1 | 15 | Número do protocolo de autorização do BP-e. |
| PR10 | digVal | E | PR03 | C | 0-1 | 28 | Digest Value do BP-e processado, utilizado para conferir a integridade com o documento original. |
| PR11 | cStat | E | PR03 | N | 1-1 | 3-4 | Código do status da resposta para o BP-e. |
| PR12 | xMotivo | E | PR03 | C | 1-1 | 1-255 | Descrição literal do status da resposta para o BP-e. |
| PR13 | infFisco | G | PR01 | - | 0-1 | - | Grupo reservado para mensagem do Fisco ao contribuinte. |
| PR14 | cMsg | E | PR13 | N | 1-1 | 3 | Código de status da mensagem do Fisco. |
| PR15 | xMsg | E | PR13 | C | 1-1 | 1-255 | Mensagem do Fisco para o contribuinte. |
| PR16 | Signature | G | PR01 | XML | 0-1 | - | Assinatura XML do grupo identificado pelo atributo “ID”. A decisão de assinar a mensagem fica a critério da UF. |
4. Regras de Validação Básicas do Serviço
| Grupo | Descrição |
|---|---|
| A | Validação do Certificado Digital do Transmissor no protocolo TLS. |
| B-0 | Validação da compactação da mensagem. |
| B | Validação inicial da mensagem no Web Service. |
| C | Validação da área de dados da mensagem. |
| D | Validação do certificado utilizado na assinatura digital do BP-e TM. |
| E | Validação da assinatura digital do BP-e TM. |
A mensagem da área de dados é descompactada antes das demais validações. O XML descompactado está sujeito ao limite de 1024 Kbytes, à validação de formação, disponibilidade do serviço, Schema, namespace, caracteres de edição, prefixos e codificação UTF-8.
5. Validação das Regras de Negócio do BP-e TM
As regras de negócio específicas do BP-e TM estão descritas na NT 2020.002 e foram atualizadas pelas Notas Técnicas posteriores. Elas serão consolidadas na página Regras de Validação.
A base de dados usada na verificação do BP-e TM é a mesma do BP-e normal. Uma Chave de Acesso do tipo Transporte Metropolitano não pode existir simultaneamente para os tipos Normal e Substituição.
6. Final do Processamento do BP-e TM
A validação pode resultar em:
- Rejeição: o BP-e TM é descartado e não é armazenado no banco de dados, podendo ser corrigido e transmitido novamente.
- Autorização de uso: o BP-e TM é armazenado no banco de dados.
| Validação de forma | Situação do BP-e TM | Para o contribuinte | Banco de Dados |
|---|---|---|---|
| Inválida | Rejeição | Corrigir BP-e TM | Não gravar |
| Válida | Autorização de uso | Autorizado | Gravar |
Para cada BP-e TM é atribuído um número de protocolo do Ambiente Autorizador.