Função: Este método deve ser utilizado para verificar a situação dos serviços de web services do SEFAZ de origem e o tempo de espera para os lotes de processamento. O método solicita como parâmetro o código da entidade para identificar o SEFAZ de Origem. Em caso de duvida, verifique os serviços de Administração do SPED.
<soap:Body>
<USERTOKEN>STRING</USERTOKEN> <ID_ENT>STRING</ID_ENT> <MODELOS> <MODDOCS> <MODDOC> <MODELO>STRING</nfs:MODELO> <MODDOC> <MODDOC> <MODELO>STRING</nfs:MODELO> <MODDOC> <MODDOCS> <MODELOS> </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. | MODELOS | Estrutura |
| - | Opcional - Modelos de documentos para verificar o serviço | MODDOCS | Estrutura |
| MODELOS |
| MODDOC | Estrutura |
| MODDOCS | Poderá ser informado mais de um. | MODELO | Alfanumérico | 002 | MODDOC | Valores aceito: '55','57','58','65' e '67'. |
|
<soap:Body> <STATUSSEFAZMODELO> <MONITORSTATUSSEFAZMODELO> <LOGAUDITORIA>STRING</LOGAUDITORIA> <MODELO>STRING</MODELO> <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> </MONITORSTATUSSEFAZMODELO> </STATUSSEFAZMODELO> </soap:Body>
Parâmetro | Tipo | Tam | Pai | Observação | STATUSSEFAZMODELO | Estrutura | - | - | - | LOGAUDITORIA | Alfanumérico | 0-500k | STATUSSEFAZMODELO | 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. | MODELO | Alfanumérico | 002 | STATUSSEFAZMODELO | Modelo do WebService consultado (55,57). | MOTIVO | Alfanumérico | 0-250 | STATUSSEFAZMODELO | Mensagem de motivo enviada pela SEFAZ. Motivo vinculado ao STATUSCODIGO. | OBSERVAÇÃO | Alfanumérico | 0-250 | STATUSSEFAZMODELO | Texto de observação retornado pela SEFAZ. | STATUSCODIGO | Alfanumérico | 003 | STATUSSEFAZMODELO | Código do status da comunicação conforme tabela contida no manual do contribuinte. | STATUSMENSAGEM | Alfanumérico | 1-250 | STATUSSEFAZMODELO | Mensagem explicativa do STATUSCODIGO. | SUGESTAO | Alfanumérico | 0-999 | STATUSSEFAZMODELO | Sugestão do TSS para o usuário referente às informações coletadas da SEFAZ. | TEMPOMEDIOSEF | Inteiro | 0-3 | STATUSSEFAZMODELO | Tempo médio de resposta da SEFAZ para processar um lote de 50 notas. A unidade fornecida é em segundos. | UFORIGEM | Alfanumérico | 002 | STATUSSEFAZMODELO | Unidade federativa de origem da comunicação. | UFRESPOSTA | Alfanumérico | 0-2 | STATUSSEFAZMODELO | Unidade federativa de destino da comunicação. | VERSAOMENSAGEM | Alfanumérico | 004 | STATUSSEFAZMODELO | 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. | 004 | Modelo inválido. Somente serão aceitos os modelos '55','57','58','65' e '67'. | 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.