Função: Método de consulta de Nota Fiscal de Serviço Eletrônica, através do número e série do RPS. Este método retorna os dados da NFs-e gerada na prefeitura e atualiza a base do TSS com a autorização, caso seja retornado pela prefeitura. Este método inicialmente atende somente as prefeituras que a empresa Ginfes desenvolveu o sistema da NFs-e e homologados pelo TSS.

 


<soap:Body>

<USERTOKEN>STRING</USERTOKEN>

<ID_ENT>STRING</ID_ENT>

<CODMUN>STRING</CODMUN>

<TSSID>STRING</TSSID>

<NUMERORPS>STRING</NUMERORPS>

<SERIERPS>STRING</SERIERPS>

<TIPORPS>STRING</TIPORPS>

</soap:Body>

 

ParâmetroTipoTamPaiObservação
USERTOKEN Alfanumérico05--Token de bilhetagem para execução do serviço.
ID_ENT Alfanumérico06--Código da entidade retornado pelo WS SpedAdm/AdmEmpresas.
CODMUN Alfanumérico07 Código do município padrão IBGE.
TSSIDAlfanumérico1-250-Número de identificação do documento no TSS, que deverá ser retornado.
NUMERORPSAlfanumérico1-9 Número do RPS, que foi enviado para a prefeitura.
SERIERPSAlfanumérico1-4 Série do RPS, que foi enviado para a prefeitura.
TIPORPSAlfanumérico1-1 

Tipo do RPS que foi enviado para prefeitura:

  • Ginfes               

- 1 – RPS               

- 2 – Nota Fiscal Conjugada (Mista)               

- 3 – Cupom

 

<soap:Body>

<TSSCONSNFSERESPONSE>

<AMBIENTE>INTEGER</AMBIENTE>

<CODIGOAUTH>STRING</CODIGOAUTH>

<ID>STRING</ID>

<NOTA>STRING</NOTA>

<RPS>STRING</RPS>

<SERIERPS>STRING</SERIERPS>

<STATUSNFSE>STRING</STATUSNFSE>

<XMLRETPREF>STRING</XMLRETPREF>

</TSSCONSNFSERESPONSE>

 </soap:Body>

 

Parâmetro

Tipo

Observação

TSSCONSNFSERESPONSE

Estrutura

-

AMBIENTE

Inteiro

Número do ambiente:1 = Produção2 = Homologação

CODIGOAUTH

Alfanumérico

Código de autorização do documento, gerado pela prefeitura no momento da autorização da NFs-e.

ID

Alfanumérico

Número de identificação do documento no TSS, que deverá ser retornado.

NOTA

Alfanumérico

Número da NFs-e gerado pela prefeitura.

RPS

Alfanumérico

Número do RPS.

SERIERPS

Alfanumérico

Série do RPS.

STATUSNFSE

Alfanumérico

Status do documento na prefeitura: N = Normal C = Cancelado S = Substituído I = Inexistente O = OUTROS Deve ser passado somente se o documento não estiver na base de dados do TSS.

XMLRETPREF

Alfanumérico

-

 

 
FaultDescrição
Invalid TokenO parâmetro USERTOKEN foi passado incorretamente.
001Código da entidade inválido.
002Código da entidade em branco.
003Método não disponível para o código de município para esta entidade.
004Id do documento não encontrado na base do TSS.
005Documento não encontrado na base do TSS. Para consulta no município desejado é necessário passar o modelo do documento.
006Deve ser passado o IDTSS ou o NUMERORPS.
007Falha ao tentar consultar o RPS.