InvoiCy Conector | Desenvolvedores Migrate
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.
por karinebaiotto • Postado em InvoiCy Conector	• Com a tag InvoiCy Conector, Release Notes, Versão 4.2.0.0 Conector
por karinebaiotto • Postado em InvoiCy Conector	• Com a tag InvoiCy Conector
Como funciona o InvoiCy Conector 5.0
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.
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".
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.
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.
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.
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 da tela inicial do Conector é possível acessar o menu "Opções" e utilizar a opção de 'Configurações Gerais.
Acesse o artigo https://desenvolvedores.migrate.com.br/2017/08/02/envio-de-nfs-e-em-lote/, para entender como configurar essa opção.
Através do menu "Opções" do Conector ainda pode-se acessar o item 'Serviços' podendo assim gerenciar os serviços que estão sendo executados no conector instalado em seu computador.
Na tela 'Serviços' é 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.
Ao acessar as informações da instância, 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.
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.
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 5.0
Última atualização em: 19 de abril, 2018
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.
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.
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 esta 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:
NFSE015630000000000091850000S.xml
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.
OBSERVAÇÃO: não existe nenhuma regra quanto a nomenclatura dos arquivos enviados ao Conector, ficando a critério do usuário definir a nomenclatura que desejar para seus arquivos. Por exemplo: cte1.xml, NFe.xml, EnvioNFCe.xml. Indiferente da nomenclatura, os arquivos serão lidos e processados pelo InvoiCy Conector.
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 Menu – Opções – 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.
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:
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.
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:
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 InvoiCyConectorServicoMaestroHomologacao, 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.