Manual Webservice RPS
Manual Webservice RPS
Manual Webservice RPS
Eletrônica de
Serviços
Webservice de Envio de RPS em Lote
- Instruções e Layout -
Versão 1.00
1. Modelo Conceitual
• Fluxo de comunicação
É iniciado pelo aplicativo cliente através do envio de uma mensagem ao webservice com a solicitação do
serviço desejado. O webservice sempre deverá devolver uma mensagem de resposta confirmando o
recebimento da solicitação na mesma conexão.
• Meio Acesso
O meio acesso de comunicação utilizado será a Internet, com um mecanismo de segurança "accessKeyId",
"secretAccessKey" e "accessToken" sobre o protocolo HTTPS (Hypertext Transfer Protocol Secure).
A troca de mensagens entre o webservice e o aplicativo do Contribuinte será realizada no padrão REST,
com troca de mensagens JSON.
O RPS é o documento que tem validade temporária e é emitido previamente pelo prestador, e deverá ser
usado nas seguintes situações:
3. Solicitação
O Recibo Provisório de Serviços deverá ser solicitado através do webservice conforme seção Métodos.
4. Autorização
Após a solicitação o webservice irá autorizar e criará um lote contendo as numerações dos RPS e seus
respectivos códigos de verificação.
5. Emissão
O RPS deve ser emitido conforme a data de execução do serviço e em 2 (duas) vias:
O RPS deverá ser convertido por NFS-e até o 10º (décimo) dia subseqüente ao de sua emissão. O prazo
inicia-se no dia seguinte ao da emissão do RPS.
7. Cancelamento
O RPS somente poderá ser cancelado pelo emitente nos seguintes casos:
• quando o serviço não for aceito pelo tomador ou intermediário do serviço, no ato da entrega do
mesmo;
• quando o documento fiscal tiver sido emitido com erro ou rasura relativos à prestação do serviço.
• todas as vias deverão ser conservadas em poder do emitente para apresentação ao Fisco quando
solicitado;
• anotar na primeira via a expressão “CANCELADA” e o motivo pelo qual houve o cancelamento.
8. Substituição
O RPS poderá substituir uma NFS-e quando o documento fiscal tiver sido emitido com erro ou rasura
relativos à prestação do serviço e necessite ser emitido corretamente.
O RPS que substituir a NFS-e terá obrigatoriamente o número e série da NFS-e a ser substituída. Essa
informação deverá constar no campo “Outras Informações” no RPS.
• Modelo de RPS: O RPS poderá ser confeccionado ou impresso em sistema próprio do contribuinte,
mediante Autorização de Impressão de Recibo Provisório de Serviço - AIRPS. Não existe modelo
padrão de RPS, mas o mesmo deverá ser confeccionado ou impresso contendo todos os dados que
permitam a sua conversão por NFS-e, em especial o CPF ou CNPJ do tomador de serviços.
• Quantidade de vias de um RPS: O RPS deve ser emitido em 2 vias, sendo a 1ª entregue ao
tomador de serviços, ficando a 2ª em poder do emitente.
A não conversão do RPS pela NFS-e equipara-se a não emissão de documento fiscal e sujeitará o
prestador de serviços a penalidade de 50 (cinqüenta) UFIRCA´s, por cada RPS não convertido.
Visando facilitar a substituição do RPS por NFS-e (conversão em lote), o Sistema de Nota Fiscal de Serviço
Eletrônica (NFS-e), permite que sejam enviados informações dos contribuintes para a Prefeitura em lotes
via webservice. Tais lotes devem atender a um layout pré-definido. O webservice de NFS-e permite ao
prestador de serviço enviar, validar e processar os lotes contendo os RPS emitidos em determinado
período. Após o envio, o lote é validado. Se a validação for bem sucedida, o lote será processado
automaticamente, substituindo os RPS enviados por NFS-e. O lote enviado deverá conter no máximo 50
unidades.
No caso de ser necessário cancelar um RPS antes de sua conversão em NFS-e, o prestador de serviços
deverá manter arquivo de todas as vias do RPS com a tarja de “cancelado”, caso contrário, seu
cancelamento não será permitido. O sistema da NFS-e controlará a seqüência numérica dos RPS
convertidos.
O sistema da NFS-e permite que o tomador de serviços que recebeu um RPS consulte a sua conversão em
NFS-e. A consulta de RPS será disponibilizada no site da SEFIN.
• token – permite gerar token de acesso, que será utilizado nas requisições.
• solicitarAirps – permite solicita um lote de números de RPS com seus respectivos Códigos de
Validação para ser utilizado pelo Contribuinte.
• gerarRps – permite enviar lote de RPS para ser validado e convertido em NFS-e.
O contribuinte através do seu aplicativo deverá enviar requisição para o método token passando
accessKeyId e secretAccessKey, via verbo POST. O webservice retornará o accessToken, onde o mesmo
será utilizado no cabeçalho das futuras requisições.
• Método: token
• Verbo: POST
Tipo: Requisição
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
accessKeyId 14 String S Deve ser preenchido com CPF/CNPJ
do Prestador de Serviço de acesso ao
Sistema de NFS-e.
secretAccessKey - String S Deve ser preenchido com a senha de
acesso ao Sistema de NFS-e.
Tipo: Resposta
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
• Método: solicitarAirps
• Verbo: POST
Tipo: Requisição
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
acessToken - String S Deve ser informado no header da
requisição.
inscricaoMunicipalPrestador 7 String S Inscrição municipal do prestador a
que se refere ao lote.
Formato: AAAAMMDD
Tipo: Resposta
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
numeroSolicitacao - Numérico S Retorna o número da solicitação
gerada no Sistema de NFS-e
dataSolicitacao 8 String S Retorna a data da solicitação
informada na requisição.
Formato: AAAAMMDD
dataAutorizaçãoSolicitacao 8 String S Retorna a data da autorização
gerada no Sistema de NFS-e.
Formato: AAAAMMDD
numerosRps - listaNumeroRps S Retorna lista de números de RPS e
seus respectivos códigos de
validação gerada no Sistema de
NFS-e.
• Método: gerarRps
• Verbo: POST
Tipo: Requisição
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
acessToken - String S Deve ser informado no header da
requisição.
inscricaoMunicipalPrestador 7 String S Inscrição municipal do prestador a
que se refere ao lote.
Formato: AAAAMMDD
ambiente 1 String S Deve ser informado:
H – Homologação
P – Produção
Tipo: Resposta
Campo Tamanho Tipo de Dado Campo Obrigatório (S/N) Conteúdo
mensagem - String S Retorna mensagem contendo os
erros conforme tabela de Erros e
Procedimento caso erro durante o
processamento.
A tabela a seguir, relacionam os erros e procedimentos adotados pelo Sistema de Notas Fiscais Eletrônicas
na substituição do Recibo Provisório de Serviços - RPS por NFS-e.