Release Notes – InvoiCy Conector Versão 4.2.0.0

Versão 4.2.0.0 – 16/03/2017

Instalação do InvoiCy Conector

Nesta versão do InvoiCy Conector a forma de download e instalação foi remodelado, a partir de agora é necessário acessar o InvoiCy Conector com usuário do tipo parceiro, adicionar um novo conector e em seguida realizar o download, para posterior instalação na máquina/servidor do cliente. Para conhecimento do processo, clique aqui.

Também foi modificado a forma de emissão em homologação e produção. Agora será necessário utilizar dois conectores diferentes, um de homologação e outro de produção. Ou seja, para emissão ou importação em homologação deverá realizar o cadastro e o download do conector através do ambiente homolog.invoicy.com.br. Já para emissões e importações de documentos em modo de produção é necessário realizar o cadastro e download do conector pelo ambiente web.invoicy.com.br. Na máquina/servidor os conectores serão instalados em diretórios diferentes, podendo utilizar ambos sem problemas.

Gerenciamento do InvoiCy Conector via tela da Plataforma InvoiCy

Na versão 1.21.0.0 do InvoiCy foi liberada uma nova tela para gerenciamento do InvoiCy Conector, que poderá ser acessada com usuário do tipo parceiro, podendo adicionar conectores para realizar emissão e importação de documentos. Também é possível gerenciar os conectores do cliente, permitindo a inativação, ativação e bloqueio de um conector ou instância específica, como também, a adição de CNPJ habilitados para a importação de documentos. Mais informações sobre esta nova forma de gerenciar os conectores, clique aqui.

Atualização automática do InvoiCy Conector

O InvoiCy Conector a partir desta versão será atualizado de forma automática através da Plataforma de Soluções InvoiCy, não necessitando mais realizar emissões para receber a atualização. Assim que for liberado no painel do InvoiCy o novo pacote de atualização, o Conector, independente do que estará realizando (emissão, importação ou nenhuma ação), será atualizado automaticamente com as melhorias.

Para mais informações acesse a página do InvoiCy Conector versão 4.0 ou superior, clicando aqui.

O que é o InvoiCy Conector 4.0?

Última atualização em: 08 de maio, 2017

Olá! Este artigo tem como objetivo demonstrar o funcionamento do aplicativo InvoiCy Conector.

O InvoiCy Conector é um aplicativo desenvolvido pela Migrate, com o intuito de facilitar a integração com o InvoiCy – Plataforma de Soluções Fiscais. O aplicativo poderá ser utilizado por empresas que não dispõem de tecnologia para realizar consumo de Web Services, tornando o processo mais simples.

De uma forma geral o desenvolvedor não precisa consumir o Web Service, e este serviço fica a cargo do Conector InvoiCy, que fará todo o trabalho de envio dos Documentos Fiscais à Plataforma.

Na nova versão do aplicativo foram implementadas algumas melhorias em relação à versão anterior. Agora é possível configurar várias instâncias do conector que funcionarão em paralelo, sendo possível por exemplo, monitorar 2 diretórios diferentes, sendo que um é usado para emissões em produção e outro é usado para emissões em homologação. Também foi implementada uma nova configuração para NFS-e, o Diretório de Arquivos para Prefeitura, a impressão automática para os documentos efetivados, e a possibilidade de utilizar o certificado digital A3 para a assinatura de documentos NF-e, CT-e e MDF-e, além de melhorias em todo o layout do aplicativo.

O InvoiCy Conector também permite a emissão de NFC-e com certificado A3, porém é importante destacar que não permite a emissão de NFC-e em Contingência Offline se o conector não tiver conexão com a internet ou com o InvoiCy.

A assinatura dos documentos com certificado digital A3 não está disponível para o módulo NFS-e.

É importante destacar que ao utilizar o certificado digital A3 no InvoiCy Conector não será possível fazer uso do processo de DistribuicaoDFe (Distribuição de Documento Fiscal Eletrônico), para consulta dos documentos de entrada. Já com o certificado digital A1 esse processo funciona corretamente.

Veja abaixo o fluxo do InvoiCy Conector:

Simples, não é mesmo? Agora vamos ao próximo passo. Vamos saber como funciona o InvoiCy Conector?

Como funciona o InvoiCy Conector 4.0

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

Olá! Neste artigo vamos demonstrar de forma resumida a estrutura do InvoiCy Conector, e o funcionamento do mesmo. Nos próximos artigos iremos descrever de forma detalhada cada processo citado no presente artigo.

Primeiramente deve-se instalar o InvoiCy Conector na sua máquina conforme apresentado no artigo Instalação do InvoiCy Conector.

Ao iniciar o InvoiCy Conector será estabelecida uma conexão à internet, caso o conector não consiga efetuar sua inicialização normal devido a uma falha de conexão, por existir na estrutura de rede configurações de proxy, o conector vai solicitar ao usuário que seja informado os dados de proxy, para que assim o mesmo faça a autenticação e inicie seu serviço.

1_Conectando

Não obtendo sucesso na tentativa de conexão à internet, será apresentada a tela a seguir, para informar as configurações de proxy da rede da empresa. Acesse a opção de “Configurar proxy”.

2_ConexaoConector

Informe ao InvoiCy Conector se ele precisará utilizar o proxy – marcando o checkbox “Usar Proxy”, e informe então os dados de “Host”, “Porta”, e ainda se o proxy necessitar a autenticação de usuário informe também o “Usuário” e a “Senha” e salve os dados informados.

3_ConfiguracaoProxyConector

Ao salvar as configurações de proxy, utilize a opção “Tentar novamente” para que assim o InvoiCy Conector faça uma nova tentativa de conexão e possa ter sucesso e iniciar o seu serviço.

4_ConexaoConector

Após concluída a instalação e a configuração do proxy será aberta a tela de instâncias do InvoiCy Conector, conforme demonstra a imagem a seguir, porém sem as instâncias estarem criadas.

invoicy-conector1

Nessa tela serão listadas todas as instâncias que estão cadastradas, onde cada instância é responsável por monitorar um determinado diretório. Dessa forma, não é possível colocar duas ou mais instâncias para monitorar o mesmo diretório de entrada. É necessário que cada instância monitore um diretório diferente.

Através dessa tela também é possível acessar a tela dos serviços através do botão ‘Serviços’, podendo gerenciar os serviços que estão sendo executados no conector instalado na máquina.

Conector Servicos

Nesta tela é possível iniciar/parar o serviço de emissão, de assinatura do certificado digital A3 e a importação de documentos emitidos NF-e e NFC-e e SAT. Quando clicar sobre o botão de ‘Iniciar’ e o processo demorar para iniciar ficará a mensagem ‘Iniciando’ e em seguida o botão de ‘Iniciar’ ficará inativo, podendo apenas clicar no botão ‘Parar’, onde, caso demorar para encerrar o serviço poderá aparecer a mensagem ‘Parando’. Quando o serviço estiver iniciado o status estará como ‘Ativo’, do mesmo modo, se o serviço estiver parado o status será ‘Inativo’.

Na tela inicial do conector, ao clicar duas vezes sobre a linha da instância, ou clicando no botão ‘Nova Instância’, a tela de edição/inserção irá aparecer, onde será possível ajustar as configurações de emissão, configurações de conexão, configurações de impressão e ainda configurar a assinatura com certificado A3. A imagem abaixo representa a tela de configurações do Conector dividido em abas.

ConfiguraçõesInstância

No campo “Nome da instância”, podemos inserir uma descrição que será a identificação da instância.

Na aba “Diretórios para emissão” temos a possibilidade de configurar diretórios de Envio, Retorno, Arquivos XML e PDF, e Arquivos TXT para Prefeitura. Caso seja necessário, é possível configurar o diretório de saída igual em todas as instâncias. O InvoiCy Conector não executa nenhum monitoramento sobre esses diretórios. Para mais informações sobre as configurações dessa tela, acesse o artigo Configurações de emissão.

Na aba “Conexão”, temos as configurações de proxy que podem ser adicionadas ao conector, bem como o timeout. Na aba Leitura de Arquivos possui as configurações do modo de leitura e envio dos arquivos. Para entender melhor as configurações de conexão do Conector acesso o artigo.

Na aba “Assinatura A3” é possível configurar um certificado A3 para efetuar a emissão dos documentos. Entenda mais sobre essa funcionalidade lendo o artigo Configuração de Assinatura A3, clique aqui.

Na aba “Impressão” pode-se adicionar e configurar as impressoras desejadas para realizar a impressão dos documentos emitidos. Para saber como funciona a impressão automática dos documentos acesse o artigo Configurações de impressão.

E por fim, na aba “Importação” é possível configurar um diretório de entrada e de erros para realizar a importação de documentos SAT, NF-e e NFC-e emitidos para armazenar no InvoiCy. Para saber como funciona todo o processo de importação de documentos emitidos acesse o artigo Importação de Documentos Emitidos.

Após preencher todas as configurações desejadas, clique em “Salvar” para que as informações sejam armazenadas. Ao clicar sobre o botão “Fechar” o aplicativo não será encerrado, mas ficará em execução nos serviços do Windows em segundo plano.

NOTA:

Para que os processos sejam executados com sucesso é necessário configurar nos serviços do Windows para os serviços abaixo serem inicializados com o usuário que utiliza o Conector no servidor/máquina, ou seja, o usuário que inicializa a máquina com permissões de administrador e realiza as interações com o InvoiCy Conector, como a emissão e importação de documentos.

InvoiCyConectorServicoEmissaoHomologacao                        InvoiCyConectorServicoImportacaoHomologacao        InvoiCyConectorServicoMaestroHomologacao

Para isso basta abrir os serviços do Windows e pesquisar pelos serviços acima, em seguida com o botão direito clicar em ‘Propriedades’, nesta tela acessar a aba “Logon” e escolher a opção “Esta conta” e informar os dados de login. Realizar o processo para os três serviços e reiniciar a máquina, ou então, reiniciar os serviços do Windows.

Agora que você já tem o embasamento de como funciona o InvoiCy Conector vamos partir para a integração? Seu próximo passo é cadastrar uma empresa no InvoiCy, para mais detalhes acesse o artigo Cadastro de empresa via InvoiCy Conector.

Configurações de Emissão – versão 4.0

Última atualização em: 08 de maio, 2017

Olá! Neste artigo vamos descrever de forma mais detalhada como efetuar as configurações para emissão de documentos no InvoiCy Conector, e o funcionamento desse processo.

Vamos dar início? Siga os passos abaixo:

Com o InvoiCy Conector já instalado na sua máquina execute o aplicativo. Se ainda não tiver instalado o Conector acesse o artigo Instalação do InvoiCy Conector.

Caso seja a primeira execução aparecerá uma tela carregando as informações de conexão com o InvoiCy, basta aguardar a tela se fechar e ter acesso a tela de instâncias do Conector, conforme demonstra a imagem abaixo.

invoicy-conector1

Conforme já foi mencionado, nessa tela serão listadas todas as instâncias que estão cadastradas. Caso você já tenha uma instância cadastrada, basta clicar duas vezes sobre a linha correspondente à instância para abrir a tela de edição. Ou se preferir clique no botão ‘Editar instância’ localizado abaixo da tela.

Se você ainda não possui nenhuma instância cadastrada clique no botão ‘Nova instância’ para abrir a tela de cadastro e configurações, como representa a imagem acima.

Informe no campo ‘Nome da instância’, localizado na parte superior da tela, uma descrição para identificar a nova instância cadastrada, ou se deseja alterar o nome de uma instância já existente. E clique na aba ‘Diretórios para emissão’ para prosseguir com as configurações. A imagem abaixo demonstra a tela de configurações de emissão.

DiretoriosParaEmissao

Nessa tela temos a possibilidade de configurar o diretório de envio, retorno, armazenamento dos arquivos XML e PDF e arquivos para padrões TXT de NFS-e. Ainda pode-se escolher se deseja armazenar os arquivos processados separando-os por modelo do documento ou data.

Confira a seguir uma explicação sobre cada uma dessas configurações:

Ativar emissão de documentos: Ao selecionar essa opção, o processo de envio de documentos para o InvoiCy estará ativo para a instância. Caso não habilitar esta opção o Conector não permitirá configurar os diretórios para emissão. Esta opção é desativada pelo parceiro nos casos em que o Conector não deverá processar os arquivos da instância por algum incidente.

Diretório de Envio: Neste campo você deve informar o diretório de destino onde serão salvos os arquivos XML que devem ser enviados ao InvoiCy pelo Conector.

Diretório de Retorno: Neste campo você deve informar o diretório de destino onde serão gravados os arquivos de retorno do InvoiCy. A cada envio de um novo documento será gravado um retorno no formato XML, que pode ser lido pelo ERP, a fim de obter o status da emissão do documento.

Nomenclatura dos arquivos de retorno no padrão InvoiCy: Para padronizar a nomenclatura dos arquivos de retornos salvos em seu diretório, é possível selecionar está opção e assim seus arquivos estarão salvos no padrão do InvoiCy para todos os módulos contratos. 

ATENÇÃO! Porém é importante observar que para utilizar esta opção seu sistema de integração deverá estar preparado para ler a nova estrutura criada para a nomenclatura dos arquivos de retorno. Caso não necessitar utilizar a nova forma de armazenar os arquivos, esta opção não deverá ser selecionada, e o Conector continuará a armazenar seus documentos da forma atual.

Abaixo são apresentados alguns dos exemplos de arquivo de retorno utilizando a nova Nomenclatura dos arquivos de retorno no padrão InvoiCy:

Módulo NFS-e:

  • NFSE015630000000000091850000S.xml

Módulo NF-e:

  • 35170418115979000109553210000000611000000614-NFe;
  • 35170418115979000109553210000001071000001077-procNFe;
  • Evento NF-e 35170418115979000109553210000001051000001056-1115001-procEve.

Módulo NFC-e:

  • 43170406354976000149653210000001011000000438-procNFCe;
  • 43170635497600014965321000000102000000102_102-procInutNFe.

Módulo CT-e:

  • 43170406354976000149575180000000021004561323-procCTe.

Módulo MDF-e:

  • 43170406354976000149585180000000031000000034-procMDFe;
  • 43170406354976000149585180000000041000000040-1101121-procEvento.

Salvar arquivos XML e PDF no diretório: Caso marcar a opção ‘Salvar arquivos XML e PDF no diretório’ deve informar o diretório de destino onde serão armazenados os arquivos XML e PDF do documento emitido. A cada envio de um novo documento, se o mesmo for efetivado, será gerado um arquivo XML e um PDF correspondente ao documento enviado, e armazenado no diretório configurado de acordo com as configurações contidas no InvoiCy.

Diretório de Arquivos para padrões TXT de NFS-e: Neste campo você deve informar o diretório de destino onde serão salvos os arquivos de texto que deverão ser enviados para a prefeitura. Esta é uma configuração especial para NFS-e, e se aplica somente para as empresas que emitem NFS-e em prefeituras com Padrões TXT.

Separar arquivos por data: Ao optar pela opção ‘Separar arquivos por data’ os arquivos processados serão salvos no diretório especificado com a seguinte estrutura:

Diretório de saída\ano\mês\dia\arquivo.xml

Diretório de saída\2017\03\09\arquivo.xml

Separar arquivos por modelo: Já ao selecionar a opção ‘Separar arquivos por modelo’, os arquivos processados serão armazenados no diretório especificado na seguinte estrutura:

Diretório de saída\modelo\arquivo.xml

Diretório de saída\NFe\arquivo.xml

Também é possível optar pelas duas formas, onde ao marcar as opções ‘Separar arquivos por data’ e ‘Separar arquivos por modelo’ os arquivos processados serão armazenados no diretório escolhido seguindo a estrutura:

Diretório de saída\modelo\ano\mês\dia\arquivo.xml

Diretório de saída\NFe\2017\03\09\arquivo.xml

Após finalizar todas as configurações clique em ‘Salvar’. Agora que você já tem todas as configurações de emissão finalizadas pode iniciar o serviço de emissão de documentos.

Então novamente na tela inicial do Conector clique no botão ‘Serviços‘ e na próxima tela no botão “Iniciar” no serviço de Emissão para iniciar o serviço de emissão dos documentos, como demonstra a imagem a seguir.

É importante destacar que ao clicar nessa opção irá iniciar o serviço para todas as instâncias cadastradas e que estejam ativadas, as instâncias que estiverem com a opção “Ativar emissão de documentos” desmarcada não terão os documentos processados. Para parar o serviço de emissão basta clicar em ‘Parar”.

Para ter acesso aos modelos de documentos de XML, XSD e layout em XLS acesse a página de downloads, clicando aqui.

Como próximo passo você pode efetuar as configurações de conexão. Leia o artigo para obter informações mais detalhadas sobre esse procedimento.

Observação – Emissão de documentos em contingência EPEC:

Ao enviar documentos em contingência com o InvoiCy Conector, o aplicativo não irá respeitar a ordem de contingência configurada para o módulo no Painel de Controle da Plataforma InvoiCy. O InvoiCy Conector utilizará como padrão sempre a primeira opção de contingência configurada, e se por algum motivo esta não funcionar, não será executada uma nova tentativa para a próxima opção da lista, e o envio do documento será suspenso e o mesmo ficará com status Rejeitado.

Para os emissores que utilizam o certificado A3, ao enviar um documento em contingência EPEC será gerado dois arquivos de retorno, um referente a situação do evento, e outro que se refere a situação do documento. Para entender melhor como esse processo irá funcionar, veja um exemplo de retorno para o evento e um exemplo para o retorno do documento.

Já para emissores que utilizam o certificado A1 o processo continua o mesmo, gerando apenas um arquivo de retorno.

Configurações de Conexão – versão 4.0

Última atualização em: 08 de maio, 2017

Olá! Neste artigo vamos descrever de forma mais detalhada como efetuar as configurações de conexão para envio de documentos no InvoiCy Conector, e o funcionamento desse processo.

A partir de agora assumimos que você já tenha o Conector instalado na sua máquina, e uma instância cadastrada. Caso ainda não tenha realizado esses passos leia o artigo ‘Configurações de emissão’ para mais informações.

Execute o Conector e na tela de instâncias edite a instância desejada, clicando duas vezes na linha correspondente. Na tela de edição da instância clique na aba ‘Conexão’, como demonstra a imagem abaixo.

Nestas abas selecionadas na imagem é possível efetuar as configurações de conexão, e a forma de leitura e envio dos documentos. Primeiramente vamos definir nossas configurações de conexão.

No campo ‘Timeout em Segundos’ deve-se definir o tempo de retorno do InvoiCy ao processar os documentos. Caso deixe o valor como zero será considerado como 2 minutos.

E se a empresa utiliza algum proxy de rede para se conectar à internet deve selecionar a opção ‘Usar Proxy’, e preencher as demais configurações como Host, Porta, Usuário e Senha.

Após todas as informações preenchidas clique em “Salvar” para que as informações sejam armazenadas.

Se deseja alterar as configurações de leitura e envio de documentos clique na aba ao lado ‘Leitura de Arquivos’, conforme demonstra a imagem abaixo.

LeituraArquivos

Nessa tela pode-se definir a forma como o Conector irá efetuar a leitura dos arquivos do diretório de envio e enviar ao InvoiCy. O modo de envio pode ser ‘Paralelo’ ou ‘Sequencial’.

No modo de envio paralelo, o Conector irá enviar os arquivos conforme o valor configurado na opção ‘Envios paralelos’, que apresenta os valores de 1 a 8.

Ao selecionar o valor 2, por exemplo, o Conector irá ler 2 arquivos do diretório de entrada, e enviar os 2 ao mesmo tempo para o InvoiCy. A imagem abaixo representa a configuração dessa opção.

OrdemLeitura

Já ao optar pelo envio sequencial não é possível definir a quantidade de arquivos que serão enviados, mas sim a forma como os mesmos serão enviados, através da opção ‘Ordem de Leitura’.

Pode-se configurar a leitura dos arquivos em ordem Crescente ou Decrescente, de acordo com a sua Data de Criação, Nome do Arquivo ou Indefinido, ou seja, sem uma ordem específica.

É importante destacar que para empresas que emitem NFS-e recomenda-se utilizar a forma de leitura e envio sequencial, pois existem algumas prefeituras que esperam receber os documentos em ordem.

Após o término das configurações clique em ‘Salvar’, para que as informações sejam armazenadas.

Agora que você já finalizou suas configurações de emissão e de conexão, você pode iniciar a emissão dos seus documentos. Leia o artigo Como Integrar com o InvoiCy Conector’ para maiores informações.

Configurações de Assinatura – versão 4.0

Última atualização em: 08 de maio, 2017

O InvoiCy Conector também permite utilizar certificado A3 para os módulos NF-e, NFC-e, CT-e e MDF-e para realizar a emissão dos documentos. Nesse artigo iremos detalhar as configurações necessárias para utilizar o certificado A3, e como proceder com a emissão dos documentos. 

A partir desse momento assumimos que você já cadastrou sua empresa e efetuou todas as configurações necessárias, mas caso ainda estiver com dúvidas, leia o artigo ‘Como funciona o InvoiCy Conector’ para mais informações.

Execute o Conector e na tela de instâncias edite a instância desejada, clicando duas vezes na linha correspondente. Na tela de edição da instância clique na aba “Assinatura A3”, como demonstra a imagem abaixo.

Ao configurar pela primeira vez aparecerá uma mensagem em tela solicitando a inicialização do serviço de assinatura, se o mesmo ainda não estiver iniciado. Confirme a mensagem para prosseguir.

Na tela que abrirá a seguir você deve ativar a assinatura A3, e através do botão destacado na imagem abaixo buscar o certificado A3 que está conectado em sua máquina.

Ao clicar no botão ‘Exibir opções avançadas de busca’ é possível detalhar mais a busca do certificado, fazendo uso dos filtros ‘Local’ e ‘Nome’, como demonstra a imagem a seguir. Para ocultar novamente os filtros clique em ‘Esconder opções avançadas de busca’.

Após definir o certificado A3 corretamente clique em ‘Salvar’ para armazenar as configurações. Ao concluir essas configurações o serviço de assinatura do certificado A3 será iniciado automaticamente.

Se desejar cancelar a emissão com o certificado A3, basta acessar essa mesma tela de configurações de assinatura e desativar a configuração. E na tela inicial do Conector parar o serviço de emissão com certificado A3, como destaca a imagem abaixo.

Lembrando que ao parar esse serviço, todas as instâncias configuradas para emitir com certificado A3 ficarão impossibilitadas de prosseguir com a emissão.

É importante destacar que, como um requisito mínimo para que a emissão com o certificado A3 funcione corretamente é necessário que você possua os drivers do certificado instalados, na mesma máquina onde o Conector também está instalado e devidamente configurado para executar o processo de emissão.

Para as empresas que emitem no módulo NFS-e não será possível fazer uso do certificado A3. E para as empresas que emitem em mais de um módulo a configuração do certificado digital será geral, ou seja, não será possível emitir para o módulo NF-e com certificado A1 e para o módulo CT-e com certificado A3, por exemplo.

Observação: Quando rodar o processo de atualização automática do InvoiCy Conector, para os emissores que fazem uso do certificado A3, ao emitir o primeiro documento após finalizada a atualização será solicitada novamente a senha do certificado A3. Já para os emissores que utilizam certificado A1 o processo não sofrerá nenhum impacto.

Configurações de Impressão – versão 4.0

Última atualização em: 08 de maio, 2017

O InvoiCy Conector também conta com uma funcionalidade de impressão automática dos documentos emitidos e efetivados.

Neste artigo vamos descrever de forma mais detalhada como efetuar as configurações de impressão automática de documentos no Conector, e o funcionamento desse processo.

Após instalado o Conector, cadastrada a instância e finalizada as configurações de emissão, o primeiro passo é abrir a tela de edição da instância e clicar na aba “Impressão”, como destaca a imagem abaixo.

Primeiramente deve-se ativar a funcionalidade de impressão, selecionando a opção ‘Ativar impressão de documentos’, como demonstrado na imagem acima.

Habilitará então um combobox para você escolher a impressora padrão que deseja imprimir seus documentos e poderá optar pela quantidade de cópias que deseja imprimir os documentos, sendo possível configurar a impressão de 1 até 5 cópias cada documento. Selecione sua opção e salve suas configurações, conforme imagem a seguir:

QuantidadeImpressao

Você também pode adicionar novas impressoras, através do botão ‘Adicionar impressora’, localizado no rodapé da tela.

Para adicionar uma impressora você deve escolher no combobox a impressora desejada, e atribuir um apelido para ela, para sua identificação. A imagem abaixo representa a tela de cadastro e edição de impressoras. Após definidas as configurações clique em ‘Salvar’ para armazenar as informações.

EditarImpressora

Você pode adicionar quantas impressoras desejar, também editá-las e removê-las, e todas elas serão exibidas na lista de impressoras, como na imagem abaixo.

AdicinarImpressoras

Para o InvoiCy Conector identificar que precisa mandar o documento para a impressora após a emissão, você deve acrescentar duas tags novas no layout de envio dos documentos, como demonstra a imagem a seguir.

XML_Impressora

A tag deve ser preenchida com ‘S’, quando você deseja imprimir o documento, ou ‘N’ para não imprimir. E na tag você pode definir a impressora que irá imprimir o documento, informando o apelido da impressora que está cadastrada no Conector.

Se a tag estiver como ‘S’, e a tag não for informada, o Conector irá imprimir o documento na impressora padrão que está configurada.

Caso desejar cancelar a impressão automática dos documentos, basta acessar a tela de configurações de impressão, e desativar a funcionalidade.

ATENÇÃO! Caso ocorra algum problema no momento da impressão automática do documento ou seja necessário uma segunda via do documento, você poderá enviar uma consulta ao documento preenchendo os campos <Imprimir> e <ApelidoImpressora>, desta forma será realizada a reimpressão do documento. Veja o exemplo abaixo:

ConsultaImpressao

É importante destacar que as margens dos documentos impressos devem ser configuradas na própria impressora do usuário, isso não depende do InvoiCy Conector ou da Plataforma InvoiCy.

Caso a impressora não estiver na rede interna da empresa será necessário realizar um ajuste no serviço de emissão. O procedimento é simples: Abrir o Serviço do Windows -> serviço InvoiCyConectorServicoEmissao, abrir as Propriedades e na aba Logon inserir o usuário administrador da máquina e confirmar as alterações. Em seguida, deverá reiniciar a máquina para que as modificações sejam aplicadas.

NOTA: Para que a impressão ocorra de forma satisfatória pelo Conector é necessário que a empresa tenha configurado o retorno dos arquivos na Plataforma InvoiCy, através do Painel de Controle – Configurações para Emissão do respectivo módulo, onde o retorno dos arquivos XML e PDF deve estar como ‘Base64’. Caso a empresa marque para retornar apenas o ‘Link para Download’ a impressão não irá ocorrer pelo Conector, pois o mesmo não consegue gerar os arquivos sem o Base64.

Como Integrar com o InvoiCy Conector – versão 4.0

Última atualização em: 08 de maio, 2017

Olá! Neste artigo iremos exemplificar o processo de integração com o InvoiCy utilizando o aplicativo InvoiCy Conector. Mostraremos um exemplo prático de envio de um documento fazendo uso desse aplicativo. Vamos lá!

A partir deste momento assumimos que você já leu o artigo “Como funciona o InvoiCy Conector” e “Cadastro de empresas via interface web”. Caso ainda não tenha lido tais artigos por favor volte um passo, antes de iniciar a leitura deste documento.

  1. Inicialmente, configure o InvoiCy Conector de acordo com a sua preferência de diretórios. Exemplo:

DiretoriosParaEmissao

  1. Após o aplicativo devidamente configurado e as informações salvas, vamos agora gerar um documento de integração que posteriormente será salvo no diretório de Entrada para ser enviado ao InvoiCy. Neste artigo, estaremos gerando um documento NF-e como exemplo, porém você poderá gerar o documento de sua preferência.

Clique aqui para ver um exemplo de documento XML de uma NF-e.

  1. Os arquivos XML de cada documento devem ser gerados a partir dos layouts abaixo:

NF-e / NFC-e layout 3.10: download

NF-e layout 2.0: download

CT-e layout 2.0: download

CT-e Eventos: download

NFS-e: download

NFS-e Cancelamento: download

NFS-e Consulta: download

MDF-e: download

Eventos MDF-e: download

Consulta de Status de Documentos: download

  1. Depois de gerado o documento o mesmo deverá ser salvo dentro do diretório de “Envio” configurado no InvoiCy Conector. No momento que o arquivo for salvo no diretório o aplicativo fará a sua leitura e processamento, enviando o mesmo para o InvoiCy, que por sua vez fará o envio para a SEFAZ e devolverá um retorno no diretório de Retorno configurado no InvoiCy Conector.

Clique aqui para obter um exemplo de retorno do Conector InvoiCy.

O arquivo de retorno conterá a seguinte estrutura em sua nomenclatura:

CNPJ: 14 posições (ex: 88128984000224)

Numero: 9 posições (ex: 000000123)

Serie: 5 posições (ex: 00451)

Evento: 6 posições (ex: 110111)

Sequencial do evento: 2 posições (ex: 01)

Ex: 881289840002240000001230045100000000-ret.xml (Exemplo de retorno do envio de uma nota)

Ex: 881289840002240000001230045111011101-ret.xml (Exemplo de retorno do envio de um evento de cancelamento)

  1. Após o envio do documento pelo aplicativo, serão salvos no diretório Arquivos, configurado no InvoiCy Conector, os arquivos XML e PDF do documento enviado, caso o mesmo for efetivado. O arquivo XML é o arquivo protocolado pela SEFAZ. Já o PDF será o DANFE para o caso de NF-e/NFC-e, DACTE para o caso de CT-e, DAMDFE para o caso de MDF-e e Espelho de RPS para o caso de NFS-e.

Estes são os processos básicos de envio e retorno de documentos através do InvoiCy Conector. Em nosso próximo artigo estaremos disponibilizando exemplos de envio e retorno para cada documento que pode ser emitido através do InvoiCy.

Importação de documentos via InvoiCy Conector – versão 4.0

Última atualização em: 08 de maio, 2017

Olá! Neste artigo iremos explicar detalhadamente como utilizar a funcionalidade de importação de documentos já emitidos através do InvoiCy Conector.

Assumimos que você já tenha o aplicativo instalado em sua máquina, e conhecimento sobre o InvoiCy Conector, mas caso ainda tenha alguma dúvida acesse o artigo ‘O que é o InvoiCy Conector?’.

Para efetuar a importação dos seus arquivos emitidos para a Plataforma InvoiCy fazendo uso do InvoiCy Conector, acesse o aplicativo InvoiCy Conector e crie uma nova instância, ou edite uma que já está cadastrada. A imagem abaixo representa a tela de instâncias do InvoiCy Conector.

Na tela inicial do Conector edite a instância desejada, clicando duas vezes na linha correspondente. Na tela de edição da instância clique na aba “Importação”, como demonstra a imagem abaixo.

Importação

Na tela de configurações de importação você deve ativar o processo de importação, e configurar um diretório de entrada onde serão armazenados os arquivos emitidos que devem ser importados para o InvoiCy.

Dica: para facilitar o gerenciamento dos documentos de importação gere uma estrutura de diretório onde a entrada e erros estejam na mesma pasta, por exemplo, …\Importacao\Entrada e …\Importacao\Erros.

Após clicar em Salvar é necessário acessar a tela de “Serviços” e iniciar o serviço de “Importação de Documentos NF-e, NFC-e e SAT”.

Em seguida, basta colocar seus arquivos XML emitidos no diretório configurado ou dentro de pastas neste diretório de Entrada, e os mesmos serão importados automaticamente para a Plataforma InvoiCy. Detalhe, documentos compactados não serão processados pelo Conector.

Após a importação dos arquivos o InvoiCy Conector adiciona os arquivos importados na pasta “Processados” no mesmo nível de diretório de entrada, por exemplo, diretório de entrada: C:\Migrate\InvoiCyConector\Importacao\Envio, os processados serão adicionados em: C:\Migrate\InvoiCyConector\ Importacao\Processados\.

É importante ressaltar que por enquanto essa funcionalidade de importação está disponível apenas para documentos dos módulos NF-e, NFC-e e CF-e SAT. Permitindo a importação de documentos efetivados, cancelados, inutilizados e eventos que possuírem o protocolo de autorização.

Caso ocorrer algum erro no processo de importação será registrado no diretório de erros configurado, o Conector adiciona uma pasta com o nome do arquivo XML adicionando o XML enviado e um arquivo com o nome Erro.log informando o problema que ocasionou a falha na importação.

Além deste retorno de erro descrito acima, é possível através da Plataforma InvoiCy acompanhar os logs da importação, para identificar se houve falhas durante o processo. Para isso basta acessar o Painel de Controle – Log de importação, como demonstra a imagem a seguir.

O acesso a essa tela é liberado para usuários do tipo Parceiro e Normal, onde é possível acompanhar todos os logs de importação de arquivos da sua empresa Matriz e suas Filiais. Ao acessar a tela o campo ‘CNPJ da matriz’ já virá preenchido, de acordo com o CNPJ da matriz que o usuário logado está vinculado.

Os logs serão agrupados por data, por empresa e modelo de documento, onde é possível visualizar o status da importação (sucesso ou falha), a empresa que efetuou a importação, modelo do documento, log da importação, quantidade de documentos importados e horário da importação.

Atenção! Quando a importação de CF-e SAT for realizada, somente será gravado os logs relacionados a falhas no processo.

Sempre que uma importação resultar em sucesso irá incrementar a quantidade de documentos importados e atualizar o horário de importação, de acordo com o modelo. Agora caso resultar em falha será criado um novo registro específico dessa importação.

Para consulta dos registros pode-se ainda efetuar filtros pelo Modelo de documento, Status do log e Período da importação, onde este não pode ultrapassar 1 mês.

Para os arquivos que falharam na importação será possível efetuar o download do documento XML, através do botão de exportação localizado em cada registro da grid. Os registros que resultaram em sucesso estarão com essa opção de download bloqueada.

Caso desejar exportar um relatório PDF para visualização dos dados basta clicar na opção ‘Exportar Relatório’, ao lado do botão Pesquisar. No cabeçalho do relatório irão constar os filtros utilizados para a consulta dos dados, como o CNPJ da matriz, Período e Modelo de documentos.

Na sequência estarão dispostos os logs dos documentos importados com sucesso, e logo abaixo os logs dos documentos que não foram importados, devido alguma falha. A imagem a seguir representa o relatório de logs de importação de documentos.

É possível ainda efetuar o cadastro automático de filiais, ao realizar a importação de documentos de uma filial que ainda não está cadastrada no InvoiCy. Para isso basta selecionar sua empresa Matriz no combobox de empresas da tela inicial da Plataforma InvoiCy, acessar o Painel de Controle – Filiais.

Na tela de Filiais habilitar a opção ‘Permitir cadastrar filiais automaticamente?’ para Sim, e clicar no botão ‘Confirmar’, como demonstra a imagem abaixo.

A filial será cadastrada com base nos dados do emitente dos arquivos importados. Na tela de Log de importação será possível acompanhar os registros para verificar se a empresa foi cadastrada com sucesso.

Caso a opção de cadastro automático de filiais não esteja habilitada também será gravado um registro no log de importação, informando que não foi possível cadastrar a empresa filial.

Gerenciamento do InvoiCy Conector versão 4.0 via Painel do InvoiCy

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

Olá! Neste artigo vamos explicar de que forma é possível realizar o gerenciamento e acompanhamento do InvoiCy Conector instalado na máquina do cliente. Lembrando de que o acesso à esta tela é realizado com o usuário do tipo Parceiro.

Para acessar a tela de visualização dos conectores acesse o Painel de Controle no módulo “Configurações do Parceiro”, clique na opção “Conector”.

Conector

Nesta tela é possível cadastrar um novo conector pelo botão ‘Adicionar’, para saber mais, poderá acessar o artigo “Instalação do InvoiCy Conector”. 

telavisualizaconector

Na tela de “Visualizar Conectores” é possível realizar filtros de conectores pelo PDE (ponto de emissão), pelo CNPJ e qual seu status (Ativo, Inativo ou Bloqueado). Bem como, analisar mais detalhes dos conectores instalados, realizar download do instalador e desativar um conector.

Ao clicar em ‘Mais detalhes’ em um dos conectores exibidos na tela, será aberta a tela de Edição do Conector conforme imagem abaixo.

EditarConectores

Nesta página acima é possível analisar as informações técnicas da máquina onde o InvoiCy Conector está instalado, como nome da máquina, versão .NET, versão CLR e sistema operacional.

O GUID é o identificador único de cada conector a fim de manter a integração entre o aplicativo instalado na máquina e o gerenciamento via tela do InvoiCy. A versão do conector apresenta a versão do conector, lembrando de que o mesmo possui atualização automática quando necessário.

Se a opção Ativo estiver habilitada o InvoiCy Conector realiza a emissão normal dos documentos e importação. Porém, se desabilitar a opção Ativo o conector não realizará a emissão de documentos, nem a importação. Para desativar, basta desmarcar o checkbox e informar a justificativa de inativação.

Em seguida, possui os botões Salvar, Duplicar, Download e Bloquear.

Salvar: salva as alterações realizadas em tela.

Duplicar: nos casos em que o parceiro desejar utilizar as mesmas configurações de instância, mas em máquinas diferentes, é possível duplicar o conector com todas as configurações, podendo modificar o nome.

Download: se a máquina foi formatada ou teve problemas no InvoiCy Conector e precisou desinstalar, é possível realizar novamente o download do conector e instalar na máquina.

Bloquear: Esta ação é utilizada nos casos em que não haverá mais emissões no InvoiCy Conector ou por algum motivo o parceiro não desejar mais que o cliente realize emissões, como por exemplo, motivo de não pagamento, cancelamento de contrato. Para confirmar esta ação deverá informar a justificativa de bloqueio do conector.

TelaJustificativa

Instâncias: Na próxima tela são exibidas as informações dos serviços das instâncias cadastradas no InvoiCy Conector, podendo habilitar, desativar ou bloquear a ação das instâncias em relação à emissão, impressão, assinatura A3 e importação de documentos.

TelaEditInstancia

Em qualquer alteração de status das instâncias é necessário informar a justificativa, a fim de manter registro das ações realizadas.

Empresas Habilitadas (Importação Docs): Permite habilitar CNPJs raízes existentes no InvoiCy para a importação de documentos NFC-e, NF-e e CF-e SAT na plataforma. Para adicionar os CNPJs, se necessário, poderá clicar em Selecionar e pesquisar pela empresa ou CNPJ e selecionar a quantidade de CNPJs necessários e clicar em Selecionar, conforme imagem abaixo.

Caso tente realizar a importação de documentos e o CNPJ não estiver adicionado, o InvoiCy não realizará a importação dos documentos.

Logs do Conector: Nesta tabela consta o usuário que realizou a alteração de status de alguma ação do InvoiCy Conector, apresentando também a data desta ação, o que foi realizado e a justificativa de alteração de status.