Exibir origem

Função: Método destinado à consulta do status do serviço prestado pela SEFAZ. Este serviço não deve ser chamado em períodos inferiores há três minutos para não sobrecarregar os servidores da SEFAZ.

<soap:Body>

<USERTOKEN>STRING</USERTOKEN>

<ID_ENT>STRING</ID_ENT>

</soap:Body>

Parâmetro	Tipo	Tam	Pai	Observação
USERTOKEN	Alfanumérico	006	-	Token de bilhetagem para execução do serviço.
ID_ENT	Alfanumérico	006	-	Código da entidade retornado pelo WS SpedAdm/AdmEmpresas.

<soap:Body>

<LOGAUDITORIA>STRING</LOGAUDITORIA>

<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>

</STATUSSEFAZEX>

</soap:Body>

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

Fault	Descrição
Invalid Token	O parâmetro USERTOKEN foi passado incorretamente.
001	Código da entidade inválida.
002	Código da entidade em branco.
Falha de Post	Falha de execução em post: https://

Processos:

1) Valida o UserToken enviado.

2) Inicializa a conexão com o SGBD e cria as tabelas do sistema se necessário.

3) Valida os parâmetros recebidos.

4) Obtém a URL de comunicação da SEFAZ por meio da UF cadastrada na tabela de entidade.

5) Realiza um post na SEFAZ e aguarda resposta.

6) Formata a mensagem da resposta.

7) 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.

8) 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.

9) Retorna para a aplicação.