Padrão SJP

Última atualização em: 11 de fevereiro, 2015

 

Para o padrão SJP existe algumas diferenças em relação aos demais modelos que seguem o padrão ABRASF, listadas abaixo:

1. Cancelamento de NFS-e

Para efetuar o cancelamento de NFS-e via Web Service, é necessário solicitar a liberação junto à prefeitura.

2. Exemplo XML

Para visualizar o XML de exemplo clique aqui.

Padrão Nota Natalense

Última atualização em: 13 de outubro, 2016

 

O padrão Nota Natalense não apresenta diferenças relevantes em relação ao padrão ABRASF.

1. Liberação de acesso

Para possibilitar a emissão em ambiente de homologação, será necessário enviar um e-mail para ‘semut.setinf@natal.rn.gov.br‘ solicitando liberação de acesso para emitir RPS pelo Web Service de homologação.

2. Exemplo XML

Montamos um exemplo de XML de envio para facilitar o entendimento do usuário. Clique aqui para visualizar o XML de exemplo.

Consulta de MDF-e não encerrados

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

 

Olá! Neste artigo descrevemos como é realizada a consulta dos documentos MDF-e não encerrados através do InvoiCy.

A Plataforma InvoiCy foi adequada de acordo com a NT2015/001, que tem como objetivo disponibilizar um novo Web Service para que os usuários da Plataforma InvoiCy possam verificar quais os documentos MDF-e que ainda não estão encerrados para a sua empresa, pois a SEFAZ não permite enviar um novo MDF-e para a mesma placa antes de executar o encerramento de todos os demais MDF-e.

O Web Service receberá as solicitações de consultas dos documentos MDF-e que ainda não foram encerrados pelo emitente, ou seja, que ainda estejam com status Autorizado. O acesso a consulta é permitido apenas através do CNPJ da empresa emitente do MDF-e.

1. Gere a estrutura do arquivo XML de consulta de MDF-e não encerrados

Através dessa nova funcionalidade é possível realizar a busca de todos os documentos MDF-e ainda não encerrados para a empresa do usuário.

Clique aqui para visualizar um exemplo de XML com a estrutura para consultar os MDF-e não encerrados.

Disponibilizamos também um documento que especifica o layout do arquivo XML que deve ser gerado, clique para fazer o download.

2. Consuma o Web Service de envio de documentos do InvoiCy

Após a geração do XML de consulta dos documentos MDF-e não encerrados, o próximo passo é realizar o consumo do Web Service de recepção do InvoiCy.

O XML de consulta deve estar na tag “Documento”, convertido para texto, como demonstra a imagem abaixo:

Clique aqui para fazer download do XML exibido na imagem.

Para a geração do código hash informado no campo “EmpCK” deve-se utilizar todo o conteúdo da tag “Documento”. O procedimento para a geração do hash você encontra no artigo Gerando o hash MD5.

3. Obtenha retorno da consulta de MDF-e não encerrados

Será retornada uma relação com as chaves de acesso e número de protocolo dos MDF-e não encerrados.

Disponibilizamos um exemplo de XML de retorno, clique aqui para fazer o download.

Para ter acesso completo as informações da Nota Técnica 2015/001, clique aqui.

Versão 1.8.0.0 – mais detalhes

Confira todas as alterações realizadas na versão 1.8.0.0 do InvoiCy:

 

Código da solicitação – Descrição

2740 – Permitir desabilitar caixa de e-mail
2739 – Notificações de e-mails
2642 – Alteração no controle da SEFAZ utilizada
2924 – Web Service para busca Notas de entrada na SEFAZ
3034 – Download do XML da NF-e emitida contra o CNPJ
3111 – Erro no Cadastro de Empresas via WebService
3090 – Timeout – Configuração de Caixa de Envio de E-mail
2842 – Validações InvoiCy – módulo
2670 – Melhorias no painel de controle
2991 – Data e Hora de Autorização – módulo
2829 – Seleção de empresas do usuário
2712 – Consulta de Documentos – CNPJEmissor
3277 – Possibilitar impressão do Canhoto do DANFE NF-e no Rodapé
3243 – Permitir inserção de variáveis nos textos padrão de E-mails
3242 – Permitir remoção Moldura da Logo no DANFE – módulo
2668 – 2774 – Melhorias nos filtros e forma de busca
2674 – Melhorias tela Inicial
2728 – Dados do parceiro na tela de cadastro do emitente
3354 – Reenviar NFC-e quando ocorrer o erro 202
3371- Impressão infAdFisco no DANFE

Release Notes – Versão 1.8.0.0

Versão 1.12.0.0 Módulo NFS-e – 25/03/2015

Liberação Padrão Equiplano

A partir de agora, o InvoiCy – Módulo NFS-e passa a integrar com o padrão EQUIPLANO, abrangendo atualmente o município de Toledo/PR. Para consultar a lista completa de municípios integrados, acesso o mapa.

Versão 1.8.0.0 – 05/02/2015

Licenciamento

A partir de agora, quando o usuário parceiro cadastrar empresas emitentes em ambiente de produção já deverá fazer a solicitação da licença para os módulos que possui contrato, sendo obrigatório o preenchimento dessa etapa para prosseguir com o cadastro da empresa.

Web Service para buscar Notas de entrada na SEFAZ

Atualmente a Plataforma InvoiCy já está preparada para receber por Web Service arquivos de manifestação de destinatário, e a partir desta versão também disponibiliza a funcionalidade de consulta das notas emitidas contra o CNPJ da empresa que está manifestando.

Download do XML da NF-e emitida contra o CNPJ

Após realizar a ciência da operação também será possível baixar o arquivo XML completo, sendo que o cliente poderá solicitar o download de até dez documentos por vez.

Configuração dos textos de E-mail

Agora o usuário pode configurar suas mensagens de e-mail em formato HTML, com a possibilidade de inserir links de imagens, mudar a fonte, tamanho e cor do texto.

É possível também inserir variáveis junto ao texto padrão dos e-mails, como número do documento, série, chave de acesso, nome do destinatário, link para download do XML e do PDF, facilitando assim para montar a mensagem desejada.

Alterações no DANFE

Para os clientes que possuem uma folha customizada para impressão do DANFE é possível configurar se o canhoto do DANFE será impresso no cabeçalho ou no rodapé.

Nesta versão também foi liberada uma opção para definir se a logomarca do DANFE terá moldura ou não.

Detalhamento das versões

Para conhecer todas as modificações realizadas nessa versão, clique aqui.

Licenciamento das empresas

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

 

Ao cadastrar uma empresa emitente em ambiente de produção, o usuário parceiro já deverá fazer a solicitação da licença para os módulos que possui contrato.

Caso o sistema esteja no ambiente de produção, ao preencher as informações na primeira etapa de Dados da empresa, ao avançar para a próxima etapa será apresentada uma tela com informações de licenciamento, com os módulos disponíveis para solicitação de licença.

Para solicitar uma licença basta selecionar os módulos desejados, então já serão apresentados em tela os contratos que o usuário tem disponível para cada módulo selecionado. Caso tiver mais de um contrato os mesmos serão apresentados em um combobox destacando o modelo do contrato, por exemplo bilhetagem ou licença, possibilitando selecionar qual contrato será atribuído para a empresa que está sendo cadastrada. Caso possuir um só contrato para o módulo selecionado apenas aquele aparecerá em tela.

 

Após selecionar os módulos e definir os contratos que serão atribuídos para a empresa, ao clicar em Solicitar licença o InvoiCy já fará a solicitação das licenças. Se ocorrer algum problema será apresentada para o usuário uma mensagem em tela, possibilitando que o mesmo altere as informações e tente solicitar novamente a licença.

Nesse processo também será controlado o estoque de licenças do parceiro, ou seja, se o mesmo possui licenças disponíveis para os módulos selecionados. Caso não possua mais licenças ativas será exibida uma mensagem em tela para conhecimento do usuário.

É importante salientar que ao realizar o cadastro de uma empresa via Web Service, também será possível definir o tipo de contrato utilizado para cada módulo, e assim ao final do cadastro a empresa já estará licenciada para realizar emissões no InvoiCy. Caso não seja definido nenhum contrato durante o cadastro, a licença será solicitada automaticamente, mas apenas na primeira emissão da empresa.

Após o usuário Parceiro finalizar o cadastro da sua empresa,  através do Painel de Controle, tela de Módulos contratados, poderá visualizar e gerenciar as licenças das suas empresas emissoras, podendo cancelar a licença de algum módulo, bloquear ou solicitar uma nova licença. É possível também editar uma licença selecionando um outro contrato disponível, ou cancelar todas as licenças que estão ativas.

 

Através dessa tela fica mais fácil para o usuário Parceiro identificar para quais módulos já possui licença ativa. Para solicitar uma nova licença basta clicar no ícone semelhante a uma medalha, como demonstra a imagem abaixo.

 

Serão exibidos então os contratos que o usuário tem disponível para o módulo selecionado. Caso possuir mais de um contrato, estes serão apresentados em um combobox destacando o modelo do contrato, bilhetagem ou licença, por exemplo.

 

Ao clicar em Solicitar licença, aparecerá uma mensagem informativa em tela, com mais informações sobre o tipo de contrato selecionado e a forma de cobrança do mesmo. Ao finalizar o processo aparecerá uma mensagem em tela, indicando o sucesso ou falha na solicitação de licença.

Através dessa tela de módulos contratados também é possível bloquear uma licença. O bloqueio é temporário, onde a licença continuará sendo cobrada normalmente. O processo de bloqueio poderá ser revertido pelo usuário parceiro a qualquer momento.

 

Por fim, através da tela de Módulos contratados o Parceiro também conseguirá efetuar o cancelamento de suas licenças, como demonstra a imagem a seguir.

 

É importante destacar que o cancelamento da licença é permanente, onde a partir do próximo mês essa licença não será mais cobrada. Esse processo deve ser executado apenas para emissores que não irão mais utilizar o sistema, e só pode ser revertido através da solicitação de uma nova licença.

Ao optar por cancelar todas as licenças a cobrança também será interrompida a partir do próximo mês, e o acesso dos usuários ao InvoiCy será bloqueado permanentemente.

É importante destacar que esse processo de licenciamento das empresas também pode ser executado via Web Service. Para mais informações leia o artigo Licenciamento das empresas via Web Service.

Permitir desabilitar caixa de e-mail

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

 

Para receber e-mails de alertas e notificações do InvoiCy a empresa deve realizar o cadastro de uma caixa de e-mail, que o InvoiCy irá utilizar para enviar e-mails do emissor aos seus clientes. Para receber e-mails do InvoiCy é necessário informar um endereço válido no Painel de controle – Dados da empresa,  campo “E-mail para notificações”.

Quando o usuário deseja que o InvoiCy pare de enviar e-mails para uma de suas caixas de e-mail cadastradas tem a opção de habilitar ou desabilitar essa caixa de e-mail, deixando assim de receber os e-mails da aplicação.

Para configurar esta opção basta acessar o Painel de controle no grupo Empresa e clicar na opção Caixas de e-mail.

Na tela de edição da caixa de e-mail existe a opção Caixa ativa, onde ao desmarcar essa opção a caixa de e-mail deixará de receber os e-mails do InvoiCy. Com isso não é necessário excluir as caixas de e-mail cadastradas, basta deixá-las inativas.

 

Distribuição de Notas de entrada na SEFAZ

Última atualização em: 11 de abril, 2017

Olá! Neste artigo descrevemos como é realizada a consulta e solicitação de download dos documentos XML das NF-e emitidas contra o CNPJ da empresa através do InvoiCy.

Até então a SEFAZ disponibilizava o Web Service NFeDownloadNF para efetuar o download das Notas emitidas contra o CNPJ da empresa, e o Web Service NFeDistribuicaoDFe para efetuar a consulta dessas notas. E no InvoiCy existiam layouts específicos para consumir cada um destes Web Service.

A partir da data 01/05 o Web Service NFeDownloadNF será descontinuado pela SEFAZ, porém os clientes que já vinham integrando com esse Web Service para fazer o download de suas Notas poderão continuar enviando o mesmo layout, que o InvoiCy automaticamente encaminhará as informações para o Web Service NFeDistribuicaoDFe.

Porém, recomenda-se que todos os clientes passem a usar o novo layout para consulta ao Web Service NFeDistribuicaoDFe, informando a chave de acesso do documento.

De acordo com a NT2014/002, o Web Service denominado NFeDistribuicaoDFe tem como objetivo disponibilizar para os atores da NF-e informações e documentos fiscais eletrônicos de seu interesse. A distribuição será realizada para Emitentes, Destinatários, Transportadores e Terceiros informados no conteúdo da NF-e respectivamente no grupo de Emitente, no grupo do Destinatário, no grupo do Transportador e no grupo de pessoas autorizadas a acessar o XML.

Este serviço permitirá que um ator da NF-e tenha acesso aos documentos fiscais eletrônicos (DF-e) e informações resumidas que não tenham sido geradas por ele e que sejam de seu interesse.

Os documentos fiscais eletrônicos e informações resumidas estarão disponíveis para distribuição por até 3 meses após sua recepção pelo Ambiente Nacional da NF-e.

Para o usuário não terá nenhum impacto na execução do processo, que continuará integrando com o Web Service de recepção do InvoiCy. A única alteração será o acréscimo do campo ‘chaAcesso’ no layout de envio, possibilitando consultar por uma chave de acesso específica ao invés do NSU. No decorrer do artigo explicaremos com mais detalhes sobre as alterações no layout.

1. Gere a estrutura do arquivo XML de distribuição da NF-e de entrada

Através da integração com o Web Service NFeDistribuicaoDFe é possível realizar a consulta e download das Notas emitidas contra o CNPJ da empresa que está manifestando.

Clique aqui para visualizar um exemplo de XML com a estrutura para distribuição das NF-e de entrada.

Será necessário informar o modelo do documento (NFe), versão do layout (atenção pois a versão agora é 1.01), CNPJ do emissor que se deseja consultar as notas de entrada e tipo de ambiente.

Em caso de consulta pelo NSU, através do campo ‘UsarUltimoNSU’, deve-se indicar se o InvoiCy deve ou não usar o último NSU (Número Sequencial Único). Caso informar o valor ‘S’ deve-se preencher o campo ‘NSUEspecifico’ com o número do NSU. Caso informar o valor ‘N’, não é necessário preencher o campo ‘NSUEspecifico’.

Se desejar consultar por uma chave de acesso específica não deve-se informar os campos relacionados ao NSU, e somente informar o campo ‘chaAcesso’ com a chave de acesso do documento que se deseja consultar.

Disponibilizamos também um documento que especifica o layout do XML que deve ser gerado, clique aqui para fazer o download.

2. Consuma o Web Service de recepção de documentos do InvoiCy

Após a geração do XML de distribuição das NF-e de entrada o próximo passo é realizar o consumo do Web Service de recepção do InvoiCy.

O XML gerado deve estar na tag “Documento”, convertido para texto, como demonstra a imagem abaixo:

 

Clique aqui para fazer download do XML exibido na imagem.

Para a geração do código hash informado no campo “EmpCK” deve-se utilizar todo o conteúdo da tag “Documento”. Maiores explicações sobre a geração do código hash você encontra no artigo Gerando o hash MD5.

3. Obtenha o retorno da distribuição da NF-e de entrada

O conteúdo retornado para o usuário não sofreu nenhum impacto. Será retornada uma lista com as Notas de entrada de acordo com os parâmetros informados para a busca.

Para visualizar um arquivo de exemplo de retorno da consulta clique aqui.

Para ter acesso completo as informações da Nota Técnica 2014/002, clique aqui.

Permitir inserção de variáveis no texto padrão dos E-mails

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

 

Na tela de Configurações dos e-mails o usuário pode configurar suas mensagens de e-mail em formato HTML, com a possibilidade de inserir links de imagens, mudar a fonte, tamanho e cor do texto. Basta acessar o Painel de controle e no módulo desejado clicar sobre a opção ‘Configurações dos e-mails’.

O usuário poderá formatar mais facilmente o texto da mensagem do e-mail, definindo a fonte desejada, bem como seu tamanho, cor e alinhamento. Poderá também inserir links e imagens. O InvoiCy preenche um modelo de texto padrão para todas as empresas, mas é possível alterar essas informações conforme as necessidades do usuário.

É possível também inserir dados do documento junto ao texto padrão dos e-mails, como número do documento, série, chave de acesso, nome do destinatário, link para download do XML e do PDF, facilitando assim para montar a mensagem desejada.

Basta clicar sobre o ícone ‘@ – Inserir dados dos documentos’, escolher no combobox abaixo a informação que deseja inserir e clicar no botão ‘OK’, e a variável correspondente será inserida no texto, no local onde o cursor estiver posicionado. A imagem a seguir demonstra as informações disponíveis para inserir essas informações no texto.

Ao enviar um e-mail essas varáveis serão substituídas pelo conteúdo correspondente. A imagem a seguir demonstra a estrutura do e-mail recebido, após a substituição das variáveis.

Configurações do DANFE – Impressão do canhoto e moldura da logomarca

Última atualização em: 13 de agosto, 2018

Para os clientes que possuem uma folha customizada para impressão do DANFE é possível configurar a forma de impressão do Canhoto do DANFE, definindo se o mesmo será impresso no cabeçalho ou no rodapé.

Para configurar esta opção basta acessar o Painel de controle e no módulo NF-e clicar sobre a opção Impressão.

Na tela de Impressão tem a opção Local de impressão do canhoto, e um combobox com as opções Cabeçalho e Rodapé.

Ao selecionar a opção Rodapé o canhoto será impresso na parte inferior do DANFE, conforme a imagem abaixo.

E ao selecionar a opção Cabeçalho o canhoto será impresso na parte superior do DANFE, como demonstra a imagem a seguir.

Nesta tela de Impressão também existe a opção Moldura na logomarca, e um combobox com as opções Sim e Não para definir se a logomarca do DANFE terá moldura ou não.

Ao selecionar a opção Sim a logomarca do DANFE sairá com moldura, conforme a imagem abaixo.

E ao selecionar a opção Não será removida a moldura da logomarca do DANFE, como demonstra a imagem a seguir.