2014
Enviando um CT-e
16 de setembro de 2014Neste 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 “<” e “>” 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: