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

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

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 5.0

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

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