Importação de documentos via Web Service

Última atualização em: 09 de julho, 2018

Olá! Neste artigo vamos explicar sobre o funcionamento do Web Service disponibilizado para importação de documentos no InvoiCy. O seu ERP deve realizar a integração com o Web Service aimportacao.aspx disponibilizado pelo InvoiCy. Este WS é único, e deve ser utilizado apenas para efetuar a importação de documentos no InvoiCy, independentemente do tipo de documento que se deseja importar.

Porém, é importante destacar que para realizar a importação de documentos através desse Web Service a empresa deve ter ativa a extensão Documentos importados.

Para saber mais sobre essa extensão e como ativá-la leia o artigo Extensão Documentos importados.

Para realizar a integração com o Web Service siga os passos abaixo.

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, para empresas que utilizam o ambiente de homologação, utilizar o link https://homolog.invoicy.com.br/aimportacao.aspx?wsdl. Assim é possível visualizar 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 efetuar a integração. Ao consumir o 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 os 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.

  • EmpCNPJ: CNPJ da empresa para a qual os documentos serão importados.
  • Texto: Uso interno do InvoiCy. Não é necessário o preenchimento.
  • Documento: Conteúdo do XML a ser importado para o InvoiCy.
  • Parâmetros: Não é necessário o preenchimento.

3. Realize a importação do arquivo XML

Através desse Web Service você usuário poderá importar os arquivos XML de documentos NF-e, CT-e, MDF-e, NFC-e, NFS-e e CF-e, tanto de entrada como de saída.

Você deve enviar toda a estrutura dos arquivos XML emitidos que serão importados para o InvoiCy, dentro da tag ‘Documentos’ convertido para texto, como demonstra a imagem.

Clique aqui para fazer download do XML exibido na imagem.

Após o envio do arquivo é preciso verificar o retorno do processamento do documento. No caso de sucesso na importação do arquivo a mensagem retornada será a seguinte: “100 – Documentos processados”. Caso ocorrer alguma falha a mesma será retornada.

Caso a importação for finalizada com sucesso, ao acessar o InvoiCy já poderá consultar pelo documento que foi importado.

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s