Manual de integração com o webservice
Modelos Operacionais
As solicitações de serviços que exigem processamento intenso serão executadas de forma assíncrona e as demais solicitações de serviços de forma síncrona.
Serviço | Implementação |
Recepção e Processamento de Lote de RPS | Assíncrona |
Geração de NFSe | Síncrona |
Consulta de Situação de Lote de RPS | Síncrona |
Consulta de NFSe por RPS | Síncrona |
Consulta de Lote de RPS | Síncrona |
Consulta de NFSe | Síncrona |
Cancelamento de NFSe | Síncrona |
Portais Disponíveis
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe por RPS.
- Consulta de NFSe por Lote de RPS
- Cancelamento de NFSe.
Observações
- Link com lista de rejeições
- Belo Horizonte adota o RPS gerado manualmente ou por alguma aplicação local, possuindo uma numeração sequencial crescente e devendo ser convertido em NFS-e. Serão aceitos somente RPS com Status do RPS (TsStatusRps) igual a 1 – “Normal”
- Possui Envio em Lote de até 3 RPS.
- É necessário certificado digital do tipo A1, A3 ou certificado de servidor (híbrido).
- A troca de mensagens entre o Web Service do Sistema de Notas Fiscais de Serviço Eletrônicas das Secretaria Municipais de Fazenda e o sistema do contribuinte será realizada no padrão SOAP, com troca de mensagens XML no padrão Style/Enconding: Document/Literal, wrapped. A opção “wrapped” representa a chamada aos métodos disponíveis com a passagem de mais de um parâmetro. Para descrever os serviços disponibilizados, será utilizado um documento WSDL (Web Service Description Language). O WSDL é o padrão recomendado para descrição de serviços SOAP.
Formatos e padrões utilizados
Formato | Observação |
Data (date) | Formato: AAAA-MM-DD |
Data/Hora (datetime) | Formato AAAA-MM-DDTHH:mm:ss |
Valores decimais (decimal) | Formato: 0.00 Não deve ser utilizado separador de milhar. O ponto (.) deve ser utilizado para separar a parte inteira da fracionária. |
Valores Percentuais (decimal) | Formato 0.0000 O formato em percentual presume o valor percentual em sua forma fracionária, contendo 5 dígitos. O ponto (.) separa a parte inteira da fracionária. |
Campos customizados para a impressão
Impressão do RPS
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- CodigoMunicipioPrestador=String[10]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[10]
- ComplementoEnderecoPrestador=String[20]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- SubstitutoTributario=String[3]
- InscricaoMunicipalPrestador=String[20]
- CnpjPrestador=String[20]
- InscricaoEstadualPrestador=String[20]
- CidadePrestador=String[40]
- OutrasRetencoes=String[10]
- ValorIssRetido=String[10]
- TotalRetencoes=String[10]
- ValorLiquido=String[10]
- BaseCalculo=String[10]
- ValorIss=String[10]
- DataCancelamento=String[30]
Impressão da NFSe
- InscricaoMunicipalPrestador=String[20]
- CnpjPrestador=String[20]
- InscricaoEstadualPrestador=String[20]
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- CidadePrestador=String[40]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[10]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- SubstitutoTributario=String[3]
- OutrasRetencoes=String[10]
- ValorIssRetido=String[10]
- TotalRetencoes=String[10]
- ValorLiquido=String[10]
- BaseCalculo=String[10]
- ValorIss=String[10]
- DataCancelamento=String[30]
Comentários
0 comentário
Por favor, entre para comentar.