Consulta de Status do Município
Com o intuito de facilitar o monitoramento do serviço de recepção de documentos das prefeituras, é disponibilizado diretamente no InvoiCy a consulta de status do município. Esta funcionalidade permite que o cliente identifique se a prefeitura enfrenta instabilidade em seu serviço.
Para realizar uma consulta de status do município via SOAP, é necessário estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:
- Homologação: https://consultahomolog.invoicy.com.br/aconsultadocumentos.aspx?wsdl
- Produção: https://consulta.invoicy.com.br/aconsultadocumentos.aspx?wsdl
Em seguida, será preciso realizar o consumo do Web Service para efetuar a integração.
Inicialmente, preencha o XML de envio com as informações necessárias para realizar a consulta de status do município. Em seguida, é realizada a geração do hash MD5, conforme orientações do artigo de referência.
Além disso, o XML deve ser linearizado, convertido para texto e enviado dentro da tag <inv:Documento> na estrutura SOAP, conforme demonstrado a seguir:
<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
<soapenv:Header/>
<soapenv:Body>
<inv:recepcao.Execute>
<inv:Invoicyrecepcao>
<inv:Cabecalho>
<inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
<inv:EmpCK>fda84cf3a29a642d2046fff4d2d981d2</inv:EmpCK>
<inv:EmpCO></inv:EmpCO>
</inv:Cabecalho>
<inv:Informacoes>
<inv:Texto></inv:Texto>
</inv:Informacoes>
<inv:Dados>
<inv:DadosItem>
<inv:Documento><!-- (1) --></inv:Documento>
<inv:Parametros></inv:Parametros>
</inv:DadosItem>
</inv:Dados>
</inv:Invoicyrecepcao>
</inv:recepcao.Execute>
</soapenv:Body>
</soapenv:Envelope>
- Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.
No caso de sucesso no envio da consulta, será informado o código de retorno "100" e a mensagem "Consulta realizada com sucesso!", juntamente com o status do município, você verá o status do serviço, indicando se está online ou offline, além dos tempos mínimo, máximo e médio de resposta e a data do último documento processado com sucesso.
Para visualizar os tempos de comunicação (mínimo, máximo e médio), é necessário primeiro realizar uma consulta ou tentativa de emissão de documento. Caso contrário, esses dados não são incluídos no retorno.
No entanto, se ocorrer alguma falha no envio da requisição, a mesma será retornada e poderá ser corrigida.