Exibir origem

Função: Método destinado à consulta dos status de serviços prestados por todas as SEFAZes. Este serviço não deve ser chamado em períodos inferiores há três minutos para não sobrecarregar os servidores.

<soap:Body>

<USERTOKEN>STRING</USERTOKEN>

</soap:Body>

Parâmetro	Tipo	Tam	Pai	Observação
USERTOKEN	Alfanumérico	006	-	Token de bilhetagem para execução do serviço.

<soap:Body>

<AMBIENTE>INTEGER</AMBIENTE>

<MOTIVO>STRING</MOTIVO>

<OBSERVACAO>STRING</OBSERVACAO>

<STATUSCODIGO>STRING</STATUSCODIGO>

<STATUSMENSAGEM>STRING</STATUSMENSAGEM>

<SUGESTAO>STRING</SUGESTAO>

<TEMPOMEDIOSEF>INTEGER</TEMPOMEDIOSEF>

<UFORIGEM>STRING</UFORIGEM>

<UFRESPOSTA>STRING</UFRESPOSTA>

<VERSAOMENSAGEM>STRING</VERSAOMENSAGEM>

</MONITORONLINESEFAZ>

</MONITORSEFAZES>

</soap:Body>

Parâmetro	Tipo	Tam	Pai	Observação
MONITORSEFAZES	Estrutura	-	-	-
MONITORONLINESEFAZ	Estrutura	1-27	MONITORSEFAZES	-
AMBIENTE	Alfanumérico	001	MONITORONLINESEFAZ	1- Produção 2- Homologação
MOTIVO	Alfanumérico	0-250	MONITORONLINESEFAZ	Mensagem de motivo enviada pela SEFAZ. Motivo vinculado ao STATUSCODIGO.
OBSERVAÇÃO	Alfanumérico	0-250	MONITORONLINESEFAZ	Texto de observação retornado pela SEFAZ.
STATUSCODIGO	Alfanumérico	003	MONITORONLINESEFAZ	Código do status da comunicação, conforme tabela contida no manual do contribuinte.
STATUSMENSAGEM	Alfanumérico	1-250	MONITORONLINESEFAZ	Mensagem explicativa do STATUSCODIGO.
SUGESTAO	Alfanumérico	0-999	MONITORONLINESEFAZ	Sugestão do TSS para o usuário, referente às informações coletadas da SEFAZ.
TEMPOMEDIOSEF	Inteiro	0-3	MONITORONLINESEFAZ	Tempo médio de resposta da SEFAZ para processar um lote de 50 notas. A unidade fornecida é em segundos.
UFORIGEM	Alfanumérico	002	MONITORONLINESEFAZ	Unidade federativa de origem da comunicação.
UFRESPOSTA	Alfanumérico	0-2	MONITORONLINESEFAZ	Unidade federativa de destino da comunicação.
VERSAOMENSAGEM	Alfanumérico	004	MONITORONLINESEFAZ	Versão do layout de retorno da comunicação.

Fault	Descrição
Invalid Token	O parâmetro USERTOKEN foi passado incorretamente.

Processos:

1) Valida o UserToken enviado.

2) Valida os parâmetros recebidos.

3) Obtém as URLs de comunicação da SEFAZes.

4) Realiza um post nas SEFAZes e aguarda resposta.

5) Formata a mensagem da resposta.

6) Verifica o status do serviço e adiciona uma recomendação, ser for necessária, para o usuário entrar em contingência se a SEFAZ retornar mensagem de serviço interrompido ou com tempo de espera superior ao máximo configurado. Note que algumas SEFAZes não informam que o serviço está parado e apenas interrompem o comunicação com a empresa. Nesta situação haverá um Soap Fault pois não houve resposta do serviço.

7) Caso haja problemas de comunicação com a SEFAZ, o sistema emitirá os seguintes alertas, todos com o código de status 999:

a. Falha de comunicação (Acesso a internet) – Mensagem gerada quando o POST da mensagem não obteve nenhum retorno. Isto pode ocorrer devido a erro de autenticação com o Proxy, bloqueio pelo Firewall ou quando o hardware de instalação do TSS não possui nenhum acesso a internet.

b. Falha na comunicação (Certificado Digital recusado) – Mensagem gerada quando a comunicação foi estabelecida com o servidor de destino, porém este servidor recusou o certificado digital.

c. Bloqueio de transmissão (Proxy ou Firewall) – Mensagem gerada quando o POST da mensagem obteve retorno, porém não foi um retorno esperado do servidor de destino. Isto pode ocorrer devido a erro de autenticação com o Proxy ou bloqueio pelo Firewall.

8) Retorna para a aplicação.