Pular para conteúdo

Licenciamento para Empresas via Web Service

O processo de licenciamento para empresa via Web Service, permite solicitar, bloquear, desbloquear ou cancelar a contratação da licença de qualquer tipo de modelo de documento para determinada empresa e/ou ambiente.

Através desta funcionalidade, o usuário tem a possibilidade de habilitar ou desabilitar o módulo desejado - para a emissão de qualquer tipo de documento, o módulo precisa constar como habilitado.

Para configurar o licenciamento para empresas via SOAP, é necessário estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:

Em seguida, será preciso realizar o consumo do Web Service para efetuar a integração.

Exemplo de Envio

Inicialmente, preencha o XML de envio com as informações necessárias para solicitar o licenciamento. 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/" xmlns:inv="InvoiCy">
   <soapenv:Header/>
   <soapenv:Body>
      <inv:recepcao.Execute>
         <inv:Invoicyrecepcao>
            <inv:Cabecalho>
               <inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
               <inv:EmpCK>e995ebc02ed439fc80306554c2705e80</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>
  1. Neste campo, informe o XML de envio. Para visualizar um exemplo de envio, clique aqui.

Ressaltando que, para licenças com o status "Bloqueada", a cobrança do uso da mesma ainda é existente pois isso significa que ela está apenas suspensa para o uso temporário. Então caso sua necessidade seja não usar mais o serviço do InvoiCy a licença deve ser do tipo “Cancelada”, finalizando desta forma o contrato de uso da aplicação.

A tag "Acao" representa o que você deseja fazer em relação a licença, onde as opções de ações disponíveis são as seguintes: 1 – Solicitar; 2 – Bloquear; 3 – Desbloquear; 4 – Cancelar.

No retorno desta requisição, será retornado o código de retorno "100" e a mensagem "Licenciamento processado" se o processo for executado com sucesso. Do contrário, é necessário ajustar a estrutura e enviar novamente até receber o retorno desejado.