Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Recepção e Processamento de Lote RPS. (Modelo ABRASF)
  • Síncrono. 
• Geração de NFSe
• Consulta de Situação de Lote RPS (Modelo ABRASF)
• Consulta de Lote RPS (Modelo ABRASF)
• Consulta NFSe (Modelo ABRASF)
• Cancelamento de NFSe. (Modelo ABRASF)

Observações

• Tirando o método GerarNfse, todos os outros seguem o modelo ABRASF.
• Necessário Certificado Digital
• O método GerarNfse funciona através do envio da mensagem XML através do parâmetro.
• O elemento CompNfse é retornado caso o RPS seja processado com sucesso. Em casos de alertas, o RPS é processado, sendo retornado a mensagem de alerta (tipo ListaMensagemRetorno) e a NFSe gerada. Em caso de erro, a NFSe não é gerada, sendo retornado apenas a mensagem de erro ocorrida.
• Tamanho máximo das mensagens XML pelo webservice é 512kb
• No caso em que o prestador possui o benefício de imunidade de ISS, deve se preencher os seguintes campos, da seguinte maneira: TipoTributacao=2 ExigibilidadeISS=5
• No caso em que a NFSe a ser emitida faça jus a um benefício fiscal, o prestador deverá preencher a TAG <CodigoTributacaoMunicipio> com código do benefício e o código do serviço no município

//Exemplo: 
//Código do benefício: 123 
//Código do serviço no município: 07.02.01 
<CodigoTributacaoMunicipio>123070201</CodigoTributacaoMunicipio>

É possível consultar o código do benefício clicando aqui.

Códigos de Cancelamento

As tabelas a seguir, relacionam os erros, alertas e procedimentos específicos do município do Rio de Janeiro na substituição do Recibo Provisório de Serviços - RPS por NFS-e através de arquivo XML. Consulte o manual da Abrasf para obter os demais códigos de erros e alertas utilizados:

• Códigos de Cancelamento
  1 Erro na emissão
  2 Serviço não prestado
  3 Duplicidade da nota
  9 Outros

Relação de Erros

Para demais erros, conferir Manual da Abrasf