Inutilizar um CT-e

Última atualização em: 06 de junho, 2017

 

Olá! Vamos aprender agora como efetuar a inutilização de um CT-e através do InvoiCy.

A inutilização é utilizada quando ocorre um pulo no sequencial de numeração dos documentos, ou quando um documento é rejeitado e não se deseja corrigi-lo. Neste caso, podemos inutilizar aquela numeração e emitir um novo documento com um novo número.

A inutilização pode ser realizada em qualquer momento, e não existe um prazo limite estipulado pela SEFAZ para realizar a inutilização de uma numeração. Além do mais, pode ser realizada a inutilização de um único número, ou ainda de uma faixa de números em um único pedido de inutilização.

A partir deste momento, assumimos que você já leu o artigo “Enviando um CT-e”. Caso ainda não tenha lido este artigo, recomendamos a sua leitura para facilitar o entendimento deste artigo.

Proceda com os seguintes passos para realizar a inutilização de um documento:

1.      Gere a estrutura do arquivo XML de inutilização
Você deverá gerar a estrutura do XML de inutilização de acordo com o Layout do InvoiCy.

Nós disponibilizamos para você um exemplo da estrutura do arquivo de inutilização para facilitar seu entendimento. Clique aqui, para realizar o download.

2.      Consuma o Web Service de envio de documentos do InvoiCy
Após gerar o layout de inutilização, basta realizar o consumo do WS de recepção do InvoiCy, conforme já descrito no artigo “Integrando com o InvoiCy”.

Para facilitar o seu entendimento, anexamos a este artigo um exemplo completo de inutilização de um CT-e através do WS de integração do InvoiCy. Clique aqui, e realize o download do documento.

3.      Obtenha o retorno da inutilização
Após os procedimentos acima, o InvoiCy irá retornar o status atual da inutilização. O layout de retorno da inutilização é o mesmo do envio e de eventos, como mostra a imagem abaixo.

Para facilitar seu entendimento anexamos a este artigo um exemplo dolayout de Inutilização. Clique aqui e realize o download do documento.

Artigos Relacionados:

Cancelando um CT-e

Última atualização em: 19 de setembro, 2014

 

Agora iremos descrever como é realizado o cancelamento de um CT-e através do InvoiCy.

A partir deste momento, assumimos que você já leu o artigo “Enviando um CT-e. Caso ainda não tenha lido este artigo, recomendamos a sua leitura para facilitar o entendimento deste artigo.

Proceda com os seguintes passos para realizar o cancelamento de um documento:

1.      Autorize um documento
O cancelamento só pode ser feito para documentos que receberam a autorização de uso pela SEFAZ. Atente-se para o prazo de cancelamento do CT-e que é de 7 dias a partir da data de emissão do documento.

2.      Gere a estrutura do arquivo XML de cancelamento
Você deverá gerar a estrutura do XML de cancelamento de um CT-e, de acordo com o Layout de eventos do CT-e. Para visualizá-lo, consulte o artigo “Envio de Eventos”.

Nós disponibilizamos para você um exemplo da estrutura do arquivo de cancelamento para facilitar seu entendimento. Clique aqui, para realizar o download.

3.      Consuma o Web Service de envio de documentos do InvoiCy
Após gerar o layout de cancelamento do CT-e que você deseja cancelar, basta realizar o consumo do WS de integração do InvoiCy, conforme já descrito no artigo “Integrando com o InvoiCy”.

Para facilitar o seu entendimento, anexamos a este artigo um exemplo completo de cancelamento de um CT-e através do WS de integração do InvoiCy. Clique aqui, e realize o download do documento.

4.      Obtenha o retorno do cancelamento
Ao realizar o consumo do Web Service do InvoiCy, no retorno será possível identificar se a operação foi realizada com sucesso e qual o status do documento.

O layout de retorno do Web Service para o cancelamento, assim como qualquer outro evento, é o mesmo retornado no momento da emissão do CT-e. Para os eventos, estarão preenchidas as tags específicas no retorno, como o EveTp e EveId, como mostra a imagem abaixo.

O próximo passo é: Consultando um CT-e, para isso acesse o artigo e confira.

 

Artigos Relacionados:

Enviando um CT-e

Última atualização em: 06 de junho, 2017

 

Neste momento iremos explicar como realizar a emissão de um CT-e integrando com o InvoiCy.

A partir de agora, assumimos que você já leu o artigo “Integrando com o módulo CT-e”. Caso ainda não tenha lido o artigo, recomendamos que realize a leitura do mesmo, para facilitar o entendimento deste artigo.

O envio de um documento é muito simples. Para que isso se torne possível, siga os seguintes passos:

1.      Consumindo o Web Service
Primeiramente, você deve realizar o consumo do Web Service de envio de documentos do InvoiCy, conforme o artigo “Integrando com o módulo CT-e”.

2.      Gerando o documento na estrutura correta
O InvoiCy permite o envio de documentos no layout 3.0 do CT-e.

Para obter esse Layout consulte o artigo “Layout 3.0”. Nele você encontra a estrutura completa do arquivo XML para gerar o documento a ser enviado ao InvoiCy.

O XML do documento deve ser convertido para texto, e inserido entre as TAGS <inv:Documento> </inv:Documento> do SOAP de envio. Veja abaixo um exemplo:

 

Nos casos em que for usada uma ferramenta RAD para consumo do Web Service através de componente nativo, por exemplo Visual Studio utilizando Web Reference, a conversão do XML para texto irá ocorrer de forma automática. Para os casos em que o desenvolvedor preferir codificar toda a comunicação sem utilizar componentes, além de ser necessário escrever todo o XML do SOAP, também deverá ser feita a conversão do XML do documento para texto, substituindo os caracteres “<” e “>” por “&lt;” e “&gt;” respectivamente, de acordo com a tabela da W3C: http://www.w3schools.com/html/html_entities.asp.

Para facilitar o seu entendimento, anexamos a este artigo um exemplo de arquivo XML no layout do CT-e.

Clique aqui, para realizar o download de um exemplo de Envio de CT-e, para o modal Rodoviário.

Para facilitar a geração do XML de integração, disponibilizamos um arquivo de esquema XSD que poderá servir como base. É recomendável que após a geração do arquivo XML e antes do consumo do Web Service, o mesmo seja validado contra o arquivo de esquema. OBS: O arquivo de esquema corresponde a versão 3.00.

Clique aqui, para realizar o download do arquivo de esquema XSD.

3.      Realize a leitura do retorno do envio
Após o envio do CT-e, precisamos realizar a leitura do retorno do processamento do documento. O retorno recebido segue a seguinte estrutura SOAP:

 

A estrutura SOAP acima demonstra o retorno do envio de apenas um único documento.

Note que na TAG <Documento> é retornado o conteúdo XML do retorno, codificado em “CDATA”. Este conteúdo pode ser lido pelo ERP para atualização do Status do documento.

Abaixo demonstramos a estrutura do XML de retorno:

 

Todo o conteúdo acima estará inserido em uma tag “CDATA” e retornará dentro da TAG <Documento> do SOAP de retorno.

Para facilitar seu entendimento, anexamos um exemplo do XML do retorno. Clique aqui, e realize o download.

Existe ainda uma tabela de códigos e descrições dos retornos da SEFAZ, que você pode consultar no artigo “Códigos de Retorno da SEFAZ”.

Agora que você já está familiarizado com a integração, podemos prosseguir ao próximo passo.

Seu próximo passo é:  Cancelando um CT-e

Artigos Relacionados:

 

Integrando com o módulo CT-e

Última atualização em: 06 de junho, 2017

 

Olá! Neste artigo vamos lhe auxiliar a realizar a integração de seu ERP com o módulo CT-e do InvoiCy. Pronto para iniciar? Vamos lá!

A integração de seu ERP com o módulo CT-e deve ser realizada através de Web Service disponibilizado pelo InvoiCy. Trata-se do WS arecepcao.aspx. Este Web Service é único, e deve ser utilizado para qualquer integração com o InvoiCy, independente do tipo de documento a ser enviado. Abaixo, detalhamos o processo de integração com o módulo CT-e.

Para realizar a integração, realize os seguintes passos:

1.      Visualize a estrutura WSDL do Web Service
Para visualizar a estrutura WSDL do Web Service, basta copiar e colar o link do Web Service em seu navegador de internet, por exemplo https://homolog.invoicy.com.br/arecepcao.aspx?wsdl. Assim podemos visualizar toda a estrutura do WSDL, conforme demonstra a imagem abaixo:

 

2.      Realize o consumo do Web Service
Você deverá realizar o consumo do Web Service para realizar a integração. Ao realizar o consumo do WS, você deverá informar os seguintes parâmetros:

  • EmpPK: Chave de Parceiro disponibilizada pela Migrate para cada cliente.
    Exemplo: PYcEsFuKroDBojfiFEl+Ms==

A chave de parceiro é gerada por nosso Sistema de Gestão no momento que a sua empresa é cadastrada como nosso parceiro. A mesma será enviada por e-mail e utilizada para controlar as empresas de clientes finais que utilizarão licenças adquiridas pela sua empresa.

  • EmpCK: Código HASH gerado em formato MD5 de acordo com dados enviados.
    Exemplo: 213f3b55d679e790258fd811cc86d309

Utilizado para validar a comunicação e propor segurança à comunicação. Consulte o artigo “Como gerar o código Hash MD5?” para mais informações.

  • EmpCO: Identificador do PDV.
  • Texto: Uso interno do InvoiCy. Não é necessário o preenchimento.
  • Documento: Conteúdo do documento Fiscal a ser enviado para o InvoiCy.
  • Parâmetros: Parâmetros de configuração do Sistema (não é necessário o preenchimento deste campo).

Dentro da TAG <inv:Documento>, você deverá informar o conteúdo XML do CT-e, contendo a estrutura de campos do layout 3.0 do CT-e. Os campos do CT-e devem ser convertidos para texto.

Obs: Caso deseje enviar mais de um documento, deve-se repetir a TAG <inv:DadosItem>, contendo o conteúdo dos documentos a serem enviados.

 

Para facilitar seu entendimento, disponibilizamos para você o download de um exemplo completo de consumo do WS de recepção.

Clique aqui, e realize o download do documento.

Para obter os Layouts atualizados do CT-e, consulte o artigo “Layout 3.0”. Neles você encontra a estrutura completa do arquivo XML do CT-e para gerar o documento a ser enviado ao InvoiCy.

3.      Realize a leitura do retorno do envio do CT-e
Após o envio do CT-e, precisamos realizar a leitura do retorno do processamento do documento. O retorno recebido segue a seguinte estrutura SOAP:

 

A estrutura SOAP acima demonstra o retorno do envio de apenas um único documento.

Note que na TAG <Documento> é retornado o conteúdo XML do retorno, codificado em “CDATA”. Este conteúdo pode ser lido pelo ERP para atualização do Status do documento.

Abaixo demonstramos a estrutura do XML de retorno:

 

Todo o conteúdo acima estará codificado em “CDATA” e retornará dentro da TAG <Documento> do SOAP de retorno.

Para facilitar seu entendimento, anexamos um documento completo a este artigo.

Clique aqui, e realize o download do arquivo SOAP de retorno.

Existe ainda uma tabela de códigos e descrições dos retornos da SEFAZ, que você pode consultar no artigo “Códigos de Retorno da SEFAZ”.

Agora que você já realizou sua integração, podemos dar prosseguimento ao próximo passo.

Seu próximo passo é: Enviando um CT-e

Artigos Relacionados: