Voltar para ""

Cadastro de Série via Web Service

Antes de realizar a emissão de qualquer tipo de documento fiscal, é necessário realizar algumas ações para viabilizar a emissão de documentos, como por exemplo o cadastro de séries. Este artigo, detalha como realizar os processos de cadastro, consulta, alteração e exclusão da série de um documento.

Para configurar o envio das requisições a seguir através do SOAP, é necessário estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:

• Homologação:https://homolog.invoicy.com.br/arecepcao.aspx?wsdl
• Produção: https://app.invoicy.com.br/arecepcao.aspx?wsdl

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

Confira abaixo uma breve descrição sobre as ações de cadastro, consulta (geral e específica), alteração e exclusão de série:

• Cadastro de Série: Esta ação permite realizar a inclusão de uma nova série para qualquer tipo de documento. Para esta operação preencha o campo Operacao com o valor "I".

• Consulta de Série: Permite consultar a série que foi cadastrada, para que o usuário tenha a certeza de que a mesma foi cadastrada corretamente. A consulta divide-se em Geral e Específica: a primeira retorna todas as séries vinculadas à empresa, enquanto a segunda detalha uma série específica conforme o tipo de documento informado. Para esta operação preencha o campo Operacao com o valor "C".

• Alteração de Série: Possibilita realizar a alteração de uma série já cadastrada no InvoiCy. Para esta operação preencha o campo Operacao com o valor "A".

• Exclusão de Série: Nesta requisição, o usuário pode excluir a série cadastrada no InvoiCy. Para esta operação preencha o campo Operacao com o valor "E".

Para prosseguir, preencha o XML de envio com as informações necessárias para determinada operação. 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:

CadastroConsulta GeralConsulta EspecíficaAlteraçãoExclusão

<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>ace1175f9d021f1e212040b2a95c4794</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.

<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>61409aa1fd47d4a5332de23cbf59571f</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.

<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>50e7040523e32e84606132d43e57f864</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.

<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>9a70086302d33451d655f4639903b415</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.

<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>6889d1b0d268800e70191c94d69351e3</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.