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

Última atualização em: 27 de setembro, 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.

Cadastro de Empresas via InvoiCy Conector – versão 5.0

Última atualização em: 27 de setembro, 2017

Integrando com o InvoiCy Conector, além de emitir documentos também é possível realizar o cadastro de empresas. Neste artigo iremos descrever como proceder para cadastrar uma nova empresa através do InvoiCy Conector, demonstrando um exemplo de envio de um arquivo xml seguindo o layout para cadastro de empresas.

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

Após realizar a configuração do InvoiCy Conector de acordo com as suas preferências, e iniciar o serviço de emissão da instância configurada, é necessário gerar um documento de integração de acordo com o layout de cadastro de empresas, que posteriormente será salvo no diretório de Entrada configurado.

Para facilitar seu entendimento disponibilizamos um exemplo do XML com o layout de cadastro de empresas, clique aqui para realizar o download.

Note que é necessário acrescentar no início da estrutura do arquivo xml a tag , onde deve-se informar a chave de parceiro da empresa emissora que está sendo cadastrada. A imagem abaixo demonstra a utilização dessa tag.

Cadastro empresa XML

Após o Conector fazer a leitura e envio desse arquivo para o InvoiCy, no diretório de Saída configurado é possível observar o arquivo XML de retorno do InvoiCy, onde pode-se consultar o status da operação para identificar se a empresa foi cadastrada com sucesso. A imagem a seguir demonstra a estrutura do arquivo de retorno.

Retorno cadastro empresa

O arquivo de retorno contém o código e status final da operação, e a chave de acesso da empresa, quando o cadastro foi concluído com sucesso. Para facilitar seu entendimento anexamos um exemplo do XML do retorno representado acima. Clique aqui e realize o download.

Quando ocorrer alguma falha no cadastro a mesma também estará representada no arquivo de retorno, ou ainda nos logs do Conector. Para acessar os logs basta abrir o Conector e no Menu superior selecionar Opções – Logs, como demostra a imagem a seguir.

4 - Configurações Gerais

Será aberta então uma tela que lista todos os logs das principais ações executadas pelo usuário durante o uso do Conector, como demonstra a imagem abaixo.

Logs

Em caso de dúvidas vocês pode acessar o Menu Ajuda – Documentação, como demonstra a imagem a seguir. Você será direcionado para o nosso Portal dos Desenvolvedores, onde consta uma vasta documentação sobre todas as funcionalidades do InvoiCy Conector, e também alguns exemplos de integração.

Menu - Ajuda

Agora que sua empresa já está cadastrada no InvoiCy você pode iniciar a emissão de seus documentos. Para facilitar seu entendimento disponibilizamos alguns exemplos de layouts de integração. Para mais informações acesse o artigo Downloads.

Instalação InvoiCy Conector versão 5.0

Última atualização em: 27 de setembro, 2017

Olá! Neste artigo vamos demonstrar num passo a passo como realizar o download do novo InvoiCy Conector com diversas funcionalidades e gerenciamento via InvoiCy, sem a necessidade de conectar no cliente para ajustar informações.

Atenção! Para emissão em homologação e produção deverá possuir dois conectores. Sendo um, realizado o download no homolog.invoicy.com.br, para emissão em modo de homologação. E para emissões em modo de produção deverá realizar o download do conector no ambiente web.invoicy.com.br.

Basicamente, é necessário cadastrar no InvoiCy um conector e em seguida realizar o download na máquina e prosseguir com a instalação. Para isso é necessário possuir acesso de usuário “Parceiro” na plataforma de Soluções InvoiCy. Vamos dar início? Siga os passos abaixo:

1. Acesso ao painel do Conector

Na tela de Painel de Controle, no módulo “Configurações do Parceiro”, clique na opção “Conector”.

Conector

2. Adicionar Conector

Para que seja possível realizar o download do instalador do InvoiCy Conector é necessário adicionar um conector. Basta clicar em Adicionar conforme demonstrado na imagem abaixo.

VisualizarConectores

Após clicar em Adicionar, na próxima tela é necessário informar o nome do conector e os CNPJs raiz que realizarão a importação de documentos pelo InvoiCy Conector. Por padrão, o CNPJ raiz da empresa seleciona já estará adicionado. Caso não realize a importação de documento, não há problemas em manter o cadastro do CNPJ.  Após inserir as informações, basta clicar em Salvar.

CadastrodeConectores

Uma opção para facilitar a adição de CNPJs para utilizar o conector é clicar no botão “Selecionar”, com isso será aberta uma tela para a realização de filtros e selecionar as empresas para realizarem o envio de documentos pelo InvoiCy Conector conforme imagem abaixo.

Tela InvoiCy Conector Selecionar

Lembrando de que o conector é único para uma máquina, sempre que utilizar o Conector em máquinas diferentes deverá cadastrar conectores diferentes. Do mesmo para emissão em modo de homologação e produção, deverá realizar o cadastro em ambos ambientes, homolog.invoicy.com.br e web.invoicy.com.br, respectivamente.

3. Realizar download do InvoiCy Conector

Concluído o cadastro do conector no InvoiCy poderá realizar o download do InvoiCy Conector e instalar no cliente.

Para isso basta clicar no ícone de Download conforme demonstrado na imagem abaixo.

tela-invoicy-conector

4. Instalação do InvoiCy Conector

Realizar a instalação do InvoiCy Conector na máquina do cliente. O aplicativo estará na pasta de download da máquina do cliente conforme suas configurações, o nome do mesmo será “Conector+NomeConector_GUID.exe”. Basta executar este programa, definir um local de instalação, clicar duas vezes em avançar, em seguida em instalar e aguardar a sua instalação conforme imagem abaixo.

OBS.: Cada instalador do conector é ÚNICO e deverá ser instalado em apenas uma máquina.

Feito isso poderá optar por abrir o InvoiCy Conector e aguardar a abertura do programa para iniciar suas configurações.

Agora que você já tem o embasamento de como funciona o processo de inclusão, download e instalação do InvoiCy Conector vamos partir para o seu funcionamento e configurações? Seu próximo passo é configurar as instâncias para emissão, para mais detalhes acesse o artigo Como funciona o InvoiCy Conector.

Release Notes – Versão 3.0.0.11

Versão 3.0.0.11 – 12/09/2016

 

Emissão com Certificado Digital A1 ou A3

A partir dessa versão o InvoiCy Conector permite ao emissor optar por emitir seus documentos utilizando o certificado digital A1 ou A3. Para mais informações sobre o processo de emissão com Certificado Digital A3 leia o artigo ‘Configurações de Assinatura‘.

Exibir informações do conector

Para os clientes que integram via InvoiCy Conector, a partir de agora ao enviar um documento será possível consultar na Plataforma InvoiCy algumas informações enviadas pelo Conector, como o IP e nome da máquina que enviou o documento, data do último documento emitido, versão do Conector, entre outras informações.

Para isso basta acessar o Painel de Controle na Plataforma InvoiCy, grupo Empresa – Conector. Na tela serão listadas as principais informações enviadas pelo InvoiCy Conector, como demonstra a imagem abaixo. Se o emissor realiza emissões com o InvoiCy Conector em mais de uma máquina irá aparecer as informações de cada máquina em específico, de acordo com a instância configurada.

 

Ao clicar no link ‘Mais detalhes’ serão exibidos informações mais detalhadas, como o diretório de entrada configurado e a versão do InvoiCy Conector que o emissor está utilizando.

Controlar atualização automática do conector

A partir dessa versão a Plataforma InvoiCy será responsável por controlar automaticamente a atualização do InvoiCy Conector, onde a mesma acontecerá de forma transparente ao usuário, com o mínimo de impacto no seu fluxo de emissão.

Configurar forma de leitura e envio dos documentos

É possível também configurar a forma de leitura e envio dos documentos, onde pode-se definir a forma como o Conector irá efetuar a leitura dos arquivos do diretório de entrada e enviar ao InvoiCy. O modo de envio pode ser ‘Paralelo’ ou ‘Sequencial’. Para mais informações sobre esse processo leia o artigo ‘Configurações de Conexão‘.

Exemplos de Documentos para download

Última atualização em: 13 de fevereiro, 2017

 

Olá! Neste artigo vamos disponibilizar os principais downloads de documentos que você vai precisar para realizar a integração com o InvoiCy Conector. Vejamos abaixo:

Exemplos de arquivo XML de envio e retorno dos documentos possíveis de emissão através do InvoiCy.

Envio de NF-e: download

Envio Eventos NF-e: download

Retorno de NF-e: download

Envio de NFS-e: download

Retorno de NFS-e: download

Envio de MDF-e: download

Envio Eventos MDF-e: download

Envio de CT-e: download

Envio Eventos CT-e: download

Retorno de CT-e: download

Envio de Consulta de documento: download

Retorno de Consulta de documento: download

Cadastro de Empresas via InvoiCy Conector – versão 3.0

Última atualização em: 01 de setembro, 2016

Integrando com o InvoiCy Conector, além de emitir documentos também é possível realizar o cadastro de empresas. Neste artigo iremos descrever como proceder para cadastrar uma nova empresa através do InvoiCy Conector, demonstrando um exemplo de envio de um arquivo xml seguindo o layout para cadastro de empresas.

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

Após realizar a configuração do InvoiCy Conector de acordo com as suas preferências, e iniciar o serviço de emissão da instância configurada, é necessário gerar um documento de integração de acordo com o layout de cadastro de empresas, que posteriormente será salvo no diretório de Entrada configurado.

Para facilitar seu entendimento disponibilizamos um exemplo do XML com o layout de cadastro de empresas, clique aqui para realizar o download.

Note que é necessário acrescentar no início da estrutura do arquivo xml a tag , onde deve-se informar a chave de parceiro da empresa emissora que está sendo cadastrada. A imagem abaixo demonstra a utilização dessa tag.

Cadastro empresa XML

Após o Conector fazer a leitura e envio desse arquivo para o InvoiCy, no diretório de Saída configurado é possível observar o arquivo XML de retorno do InvoiCy, onde pode-se consultar o status da operação para identificar se a empresa foi cadastrada com sucesso. A imagem a seguir demonstra a estrutura do arquivo de retorno.

Retorno cadastro empresa

O arquivo de retorno contém o código e status final da operação, e a chave de acesso da empresa, quando o cadastro foi concluído com sucesso. Para facilitar seu entendimento anexamos um exemplo do XML do retorno representado acima. Clique aqui e realize o download.

Quando ocorrer alguma falha no cadastro a mesma também estará representada no arquivo de retorno, ou ainda nos logs do Conector. Para acessar os logs basta abrir o Conector e no Menu superior selecionar Opções – Logs, como demostra a imagem a seguir.

opcoes

Será aberta então uma tela que lista todos os logs das principais ações executadas pelo usuário durante o uso do Conector, como demonstra a imagem abaixo.

Visualizar logs

Em caso de dúvidas vocês pode acessar o Menu Ajuda – Documentação, como demonstra a imagem a seguir. Você será direcionado para o nosso Portal dos Desenvolvedores, onde consta uma vasta documentação sobre todas as funcionalidades do InvoiCy Conector, e também alguns exemplos de integração.

ajuda

Agora que sua empresa já está cadastrada no InvoiCy você pode iniciar a emissão de seus documentos. Para facilitar seu entendimento disponibilizamos alguns exemplos de layouts de integração. Para mais informações acesse o artigo Layouts XML de Integração.

Layouts XML de Integração InvoiCy Conector

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

 

Olá! Neste artigo estaremos disponibilizando para download os Layouts XML dos documentos possíveis de integração no InvoiCy Conector.

        NF-e / NFC-e layout 4.00: download
        Exemplo NF-e: download
        Evento NF-e: download

NF-e / NFC-e layout 3.10: download
Eventos: download

NFS-e: download
NFS-e Cancelamento: download
NFS-e Consulta: download

MDF-e layout 3.0: download
Eventos MDF-e: download

Consulta de Status de Documentos: download

CT-e layout 2.0: download
Eventos CT-e: download
Eventos CC-e: download

       CT-e layout 3.0: download
       Exemplo CT-e: download

Exemplo para cadastro de empresa: download

Consulte também o menu Downloads para obter estes documentos.

Como funciona o InvoiCy Conector 3.0

Última atualização em: 20 de março, 2017

Primeiramente deve-se instalar o InvoiCy Conector na sua máquina. Vamos dar início? Siga os passos abaixo:Olá! Neste artigo vamos demonstrar de forma resumida a estrutura do InvoiCy Conector 3.0, e o funcionamento do mesmo. Nos próximos artigos iremos descrever de forma detalhada cada processo citado no presente artigo.

Importante: InvoiCy Conector 3.0 foi descontinuado e não há mais opção de download do aplicativo, apenas a utilização do conector já instalado em sua máquina e/ou servidor.

Ao executar o Conector pela primeira vez aparecerá uma mensagem, demonstrada na imagem abaixo, informando que o serviço do conector não está rodando, você deve então inicia-lo para poder utilizar o aplicativo.

Instalação do Conector

Após confirmar a mensagem, abrirá a tela de instâncias do InvoiCy Conector, conforme demonstra a imagem a seguir.

InvoiCy

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.

Apesar disso, é possível criar duas ou mais instâncias para o mesmo ambiente, por exemplo, você pode criar duas ou mais instâncias para o ambiente de homologação, e duas ou mais instâncias para o ambiente de produção, monitorando diretórios diferentes.

Através dessa tela também é possível iniciar/parar os serviços de emissão e assinatura do certificado digital A3, através dos botões “Iniciar emissão” e “Iniciar Serviço A3”.

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.

nova-instc3a2ncia

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

No grupo “Configurações de Emissão” temos a possibilidade de configurar diretórios de Entrada, Saída, Arquivos XML e PDF, e Arquivos 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.

No grupo “Configurações de Conexão”, temos as configurações do ambiente de emissão e proxy. E ainda 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.

Em “Configurações de Impressão Local” 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, o grupo “Configuração de Assinatura A3” permite configurar um certificado A3 para efetuar a emissão dos documentos. Entenda mais sobre essa funcionalidade lendo o artigo Configuração de Assinatura A3.

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.

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.

O que é o InvoiCy Conector 3.0?

Última atualização em: 03 de abril, 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 Integrar com o InvoiCy Conector – versão 3.0

Última atualização em: 17 de março, 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:

Preferências de Configurações de Emissão

2. 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.

3. Os arquivos XML de cada documento devem ser gerados a partir dos layouts contidos na página de Downloads.

 

4. Depois de gerado o documento o mesmo deverá ser salvo dentro do diretório de “Entrada” 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 Saída 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)

5. 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, 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.