Antes de iniciar a leitura deste artigo, realize a leitura do artigoAutenticação API Rest.
Entendido o processo de geração do token JWT (JSON Web Token) para a obtenção do accessToken e refreshToken, entenderemos a utilização dos mesmos através de exemplificação na ferramenta Postman, utilizada pela Migrate. Caso não deseje utilizar o Postman, é possível a utilização de outra ferramenta a seu critério.
A utilização do accessToken e do refreshToken pode ser realizada de duas formas pelo sistema parceiro, sendo elas:
Autenticação utilizando apenas o accessToken
Obtidos os accessToken e refreshToken, o accessToken terá validade de 1 hora e o refreshToken terá validade de 24 horas. É necessário o tempo de expiração dos tokens para que apenas usuários em posse da chave de parceiro e chave de acesso da empresa emissora, possam realizar a autenticação com a aplicação, fazendo uso dos serviços e tendo acesso às informações das operações dos emissores.
Desta forma, o accessToken poderá ser utilizado para autenticação com o Invoicy dentro do período de 1 hora. O mesmo deverá ser enviado na aba “Headers” em “Authorization” em todas as requisições:
Se o accessToken for utilizado com sua validade expirada, o Invoicy retornará a seguinte estrutura:
Com isso, o sistema parceiro deverá possuir um tratamento em que sempre que receber o retorno de status 400 com title “\”Invalid token\”” será necessário gerar um novo JWT a ser enviado na opção Gerar Token do projeto, para receber um novo accessToken a ser utilizado.
Autenticação utilizando o accessToken e refreshToken
Neste caso, ao receber o retorno de status 400 com title “\”Invalid token\”” o sistema parceiro deverá enviar o refreshToken ao Invoicy através da opção Refresh Token do projeto exemplo:
Ao realizar este envio, serão retornados novos accessToken e refreshToken a serem utilizados para a autenticação. Vale ressaltar que a diferença ao utilizar o accessToken e também utilizar o refreshToken é que no momento em que o accessToken expira utiliza-se o refreshToken e não é necessário gerar um novo token JWT.
Importante! Após expiradas as 24 horas de validade do primeiro refreshToken retornado, obrigatoriamente o sistema parceiro deverá gerar um novo token JWT para receber accessToken e refreshToken novos. Ou seja, se optar por utilizar o refreshToken, no mínimo 1 vez ao dia o sistema integrado ao Invoicy terá de gerar um JWT para receber o accessToken e refreshToken e nas próximas 24 horas poderá trabalhar apenas com o refreshToken para receber chaves accessToken válidas.
Situação hipotética 1: por exemplo, a empresa gerou seu primeiro accessToken e refreshToken para autenticação com o Invoicy para envio de documentos e ela emitiu 3 documentos dentro de 1 hora com este accessToken. Após, a empresa realizou o envio do quarto documento, excedendo a 1 hora de validade mas ainda dentro das 24 horas de validade do refreshToken, e o Invoicy retornou status 400 com title “\”Invalid token\””. Neste momento, o sistema parceiro deve enviar o resfreshToken para obter o novo accessToken e refreshToken a serem utilizados na autenticação.
Situação hipotética 2: a empresa gerou seu primeiro accessToken e refreshToken para autenticação com o Invoicy para envio de documentos e ela emitiu 3 documentos dentro de 1 hora com este accessToken. Após, a empresa realizou o envio do quarto documento, excedendo a 1 hora de validade do accessToken, assim, o sistema envia o refreshToken e recebe um novo accessToken e refreshToken. O quinto documento foi emitido após as 24 horas de validade do refreshToken gerado para o primeiro documento emitido, assim, o sistema parceiro gera um novo JWT para enviar na opção Gerar Token do projeto.
Se enviado um refreshToken expirado, o Invoicy retornará a seguinte estrutura:
Importante observar que title passa a ser message e a descrição do retorno muda para “Invalid refresh token”.
Recebendo este retorno o software da empresa parceira deve gerar um novo JWT para receber novos accessToken e refreshToken a serem utilizados na autenticação.
Antes de iniciar o desenvolvimento da autenticação com o Invoicy na integração através da API Rest, a melhor alternativa para entendimento do processo de autenticação é a geração do token no padrão JWT (JSON Web Token) (RFC – 7519) de forma manual.Para isso, acesse o portal JWT(https://jwt.io/) e configure o painel Decoded ajustando os grupos Payload e Verify Signature.
Entendendo o grupo Payload:
“iat”: campo numérico que deve conter a data/hora atual no fuso zero e em formato timestamp;
“exp”: campo numérico que deve conter a data/hora atual + 120 segundos no fuso zero e em formato timestamp;
“sub”: é uma string com o CNPJ da empresa emissora ou a chave de parceiro. Quando for gerado um token para cadastro/atualização de empresa deverá conter a chave de parceiro, no restante das situações será utilizado o CNPJ da empresa;
“partnerKey”: é uma string com a chave de parceiro fornecida pelo InvoiCy. Quando for gerado um token para cadastro de empresa, não envie essa informação.
A geração da data/hora em timestamp pode ser realizada no portal Epoch Converter (https://www.epochconverter.com/) conforme imagem:
Entendendo o grupo Verify Signature:
No campo em que é permitida a edição, informar a chave de acesso da empresa. A chave de acesso é a chave privada fornecida pelo InvoiCy para cada empresa cadastrada. Quando for gerado um token para cadastro de empresa deverá conter a chave de acesso do parceiro. Ambas informações, chave de parceiro e chave de acesso da empresa, podem ser localizadas acessando no Invoicy a tela Painel de controle > Dados da empresa.
Obs: para consulta de empresa utilizar a chave de acesso da empresa e não a chave de parceiro.
Importante! Após a geração do JWT o sistema parceiro terá 120 segundos para envio do código ao Invoicy no campo “token”, tempo de expiração informado no parâmetro “exp”.
Com o envio do JWT serão retornados o accessToken e o refreshToken que serão utilizados para autenticação com o Invoicy no processo de envio dos documentos.
Para mais detalhes da utilização do accessToken e refreshToken confira o artigoaccessToken e refreshToken.
Já está disponível em homologação a versão 2.39.0 do InvoiCy.
Confira as novidades:
– Novo componente para personalização do DANFE:
Olha só que super novidade! Buscando entregar uma melhor experiência para os usuários no momento de personalizar as configurações para impressão do DANFE, liberamos um novo componente Personalizado BETA.
Como pode ser visto na imagem abaixo, na lateral esquerda da tela existem algumas configurações de tamanhos de fontes, como: ‘Tamanho da Fonte dos produtos/serviços’, ‘Tamanho da fonte da informação adicional do produto’ e ‘Tamanho da fonte das informações complementares’.
Também é possível definir o ‘Modelo da folha’, que no momento disponibilizamos apenas A4, e escolher a ‘Posição da área destacável’.
Pode-se ainda optar pelo ‘Destaque dos produtos perigosos’ e ‘Imprimir duplicatas’ e ‘Imprimir ICMS Desonerado’.
Nessa tela também já é possível observar a logomarca que sairá impressa no DANFE, de acordo com o cadastro da empresa.
As demais configurações são opções que também estão disponíveis no modo personalizado normal de configurações do DANFE, com exceção de algumas opções que serão liberadas apenas para esse componente.
Ao ativar a opção ‘Personalizar tabela de produtos’, será possível posicionar as colunas correspondentes de acordo com as suas necessidades.
Ainda é possível preencher o campo ‘XML Documento’, com o conteúdo do XML da NF-e e efetuar a pré-visualização do DANFE antes de emitir esse documento. No combobox ‘Modelo do documento para pré-visualização’, é possível selecionar dentre os modelos disponíveis para simular diferentes situações de impressão do DANFE.
Ao clicar em ‘Restaurar DANFE’, tudo que foi personalizado pelo usuário será retornado às configurações padrão novamente.
– Novos parâmetros nas configurações de impressão do DANFE:
A partir dessa versão, as configurações de impressão do DANFE contam com três parâmetros novos, são eles: ‘Imprimir informações do bloco emitente centralizadas’, ‘Imprimir textos em negrito’ e ‘Imprimir FCP’.
Por padrão a logomarca e informações do emitente são impressas do lado esquerdo do DANFE, como demonstramos na imagem abaixo.
Ao ativar o novo parâmetro ‘Imprimir informações do bloco emitente centralizadas’ a logomarca e demais informações do emitente serão impressas de forma centralizada no DANFE, como demonstra na imagem a seguir.
Ativando o parâmetro ‘Imprimir textos em negrito’, todas as informações do DANFE serão impressas em negrito, com exceção dos valores referentes aos itens.
Por fim, ao ativar o parâmetro ‘Imprimir FCP’, o valor do FCP será impresso no bloco de impostos do DANFE, como destacado na imagem abaixo.
– Digitação de NF-e com pessoa física:
O InvoiCy já está ajustado de acordo com a NT 2018/001, que permite a emissão de NF-e por pessoas físicas que possuem inscrição estadual, e um certificado digital do tipo e-CPF. Com isso, o InvoiCy passa a atender a demanda de produtores rurais que também precisam emitir uma Nota Fiscal Avulsa (NFAe).
Porém, até agora só era possível realizar a emissão via Web Service. Mas a boa notícia é que a partir dessa versão será possível emitir NF-e também através da tela de digitação.
Mas atenção! Conforme regra da SEFAZ, os documentos emitidos por pessoas físicas devem obedecer a faixa de numeração para série, devendo estar entre 920 e 969.
Também é importante destacar que essa funcionalidade está disponível apenas para empresas que possuem a contratação da licença de digitação via parceiro.
– Download de PDF na tela de Documentos emitidos:
Na tela de documentos emitidos, você vai encontrar uma nova opção de download dos arquivos PDF: ‘Download PDF – Arquivos separados’, como demonstra a imagem abaixo.
Ao selecionar vários documentos na tela e selecionar essa nova opção, os PDFs serão exportados em arquivos separados, compactados em um arquivo .zip.
Porém, caso optar por: ‘Download PDF – Arquivo único’, será feita a exportação de um único arquivo PDF, contendo todos os PDF dos documentos selecionados.
– Inicializar municípios somente para importação de NFS-e:
A partir de agora o InvoiCy permitirá que prestadores de serviço possam importar documentos emitidos ou recebidos mesmo que o município não possua o serviço de emissão de NFS-e via Web Service e independente de o Prestador utilizar o InvoiCy para emissão de documentos ou utilizar outros sistemas.
No retorno da consulta de Municípios Integrados via Web Service, foram incluídos 3 novos campos que informam se o município consultado possui o serviço de Emissão integrado no InvoiCy ou não, e quais as formas de importação disponíveis. Os novos campos são:
possuiRecepcao – Retorna “S” (município possui serviço de emissão) ou “N” (município não possui serviço de emissão)
importaNotasEmitidas – Retorna a forma de importação de documentos disponível para o município, sendo as opções “Web Service”, “E-mail” ou “Não”.
importaNotasRecebidas – Retorna a forma de importação de documentos recebidos, sendo as opções:
Web Service = consulta automática liberada para qualquer empresa.
Web Service (1) = consulta automática liberada apenas para empresas que também são deste município, pois é obrigatório informar inscrição municipal.
Web Service (2) = consulta automática possível apenas se cadastrar previamente os prestadores de quem a empresa contrata os serviços.
E-mail = não possui consulta automática na prefeitura, porém é possível baixar as notas do site da prefeitura e importar no InvoiCy ou cadastrar uma caixa de e-mail onde recebe os XMLs das notas (e-mail deve ser enviado pelo prestador ou pela prefeitura).
Não = ainda não foi implementada a consulta automática nem cadastrado layout compatível para leitura de e-mail.
A imagem a seguir apresenta um exemplo de retorno de uma consulta contendo os novos campos.
Essas mesmas informações estão disponíveis no InvoiCy na tela de Municípios Integrados, no grupo de informações de NFS-e, que pode ser acessado no Painel de Controle.
Nessa tela também foi adicionada a coluna “Emissão” que informa se o município possui ou não serviço de emissão de documentos. Essa coluna representa o campo possuiRecepcao no retorno da consulta via Web Service.
– Adequar espelho RPS para Uberlândia – MG:
Foram realizadas algumas alterações visuais no espelho RPS (documentos ainda não convertidos em NFS-e) exclusivamente para Uberlândia/MG, para adequar exigências da fiscalização municipal. Dentre as mudanças estão a alteração do cabeçalho para “Secretaria municipal de finanças” e posicionamento do número do RPS no bloco superior direito.
– Consulta automática de notas recebidas em 2 novos padrões:
A extensão de importação de documentos conta com mais alguns municípios com importação automática de notas recebidas e/ou emitidas. Os padrões incluídos são Smarapd Sil WS2 e Portal Fácil, apenas nos municípios que disponibilizam o serviço.
– Consulta de NFS-e recebidas por prestador
Na versão 2.38.0 do InvoyCy disponibilizamos a opção de consultar documentos recebidos a partir de um cadastro de Prestadores de serviços, que pode ser realizado diretamente via Painel de Controle.
Nessa nova versão do InvoiCy estamos liberando o cadastro de prestadores via Web Service, tanto para integrações via SOAP ou API REST. A partir de agora é possível cadastrar o prestadores no momento do cadastro de uma nova empresa ou por meio da atualização das informações já cadastradas.
Para cadastrar prestadores via integração SOAP, é necessário enviar alumas informações, conforme apresentamos a seguir;
Podem ser enviados vários prestadores no mesmo cadastro, bastando apenas repetir o grupo <Prestador>.
Para integração via API REST, os os campos a serem enviados no JSON são:
É possível alterar o status, o nome, o código do município e a inscrição municipal de um prestador cadastrado, para isso deve-se enviar todas as informações do prestador, alterando o campo desejado, o InvoiCy irá verificar se o prestador já está cadastrado pelo CNPJ e atualizar seus dados.
Importante lembrar que essa funcionalidade atende somente clientes que utilizam o Módulo NFS-e.
Já está disponível em produção a versão 2.38.1 do InvoiCy.
Confira as novidades:
Adequação conforme NT 2021.002 do MDF-e:
O InvoiCy está atualizado de acordo com a nova Nota Técnica 2021.002. Esta NT promove ajustes no leiaute do MDF-e do modal rodoviário, e do evento de pagamento da operação, adequando o grupo de informações do pagamento a prazo do frete e suas respectivas regras de validação.
Os prazos para implementação dos ajustes seguem o seguinte cronograma:
02/05/2021 – Ambiente de Homologação
07/06/2021 – Ambiente de Produção
O que preciso alterar para me adequar a NT? Foi incluído o novo campo vAdiant (Valor do Adiantamento) no grupo de Informações do Pagamento do Frete InfPagamento. Como demonstra o exemplo abaixo.
O mesmo campo também foi inserido no Evento de Pagamento da Operação, dentro do mesmo grupo correspondente.
Atenção! As regras de validação associadas a essa NT passam a ser aplicadas em produção no dia 02/08/2021.
Para acompanhar todas as alterações que essa NT engloba, leia oartigono nosso Blog. Também confira as alterações realizadas em nossos layouts de integração: Layout de EnvioeLayout de Eventos.
Estamos disponibilizando uma nova extensão no InvoiCy, a Compliance NFS-e. Essa nova extensão foi desenvolvida com objetivo de facilitar a busca de informações essenciais para emissão de Notas Fiscais de Serviços. Por meio dela é possível obter informações como Particularidades dos Padrões, Naturezas de Operação, Códigos de Tributação do Município (TributMunicipio), Itens da Lista de Serviços (IteListServico), Descrições dos Serviços, Alíquotas, Observações das Alíquotas, Retenção de ISS e INSS, Domicílio do ISS (local de pagamento), Data de Início de Vigência da Lei, Fonte da Base Legal das Informações, Formato do Item da Lista de Serviços e Observações de cada município.
Importante: As informações retornadas pela extensão Compliance NFS-e dependem dos dados disponibilizados pelas prefeituras. Portanto, a Migrate se resguarda em não retornar dados de um município, caso estes não estejam disponíveis.
Ativação da Extensão
Para utilização dos serviços apresentados a seguir é necessária a ativação da Extensão Compliance NFS-e e dos municípios que o parceiro deseja consultar as informações.
No InvoiCy, nova extensão pode ser acessada através do menu de Extensões, por meio do ícone correspondente ao Compliance NFS-e.
Ao clicar no ícone será aberta a tela com as informações da extensão.
A ativação dos municípios para realizar a consulta dos dados para emissão é realizada na aba ‘Ativação’, marcando a opção ‘Ativar’ e confirmando a ação na janela que será apresentada.
Nessa tela é possível realizar a ativação de um município individualmente ou de todos os municípios disponíveis na extensão. A busca por municípios poderá ser realizada por meio do código IBGE e Nome, sendo possível filtrar ainda por UF e status.
Para os municípios que constam na lista como “Não habilitados” será possível realizar a solicitação de mapeamento das informações. Para solicitar a habilitação de um município deve ser marcada a opção na coluna “Solicitar”. Essa solicitação será enviada para a Migrate, que dará início ao levantamento das informações e atualização dos dados no InvoiCy. Após esse processo será possível consultar os dados via integração e via tela no sistema.
Ativação via web service
A ativação da extensão pode ser realizada no momento do cadastro da empresa, para empresas novas, ou por meio da atualização das informações de uma empresa já cadastrada no InvoiCy.
Em ambos os casos, é preciso adicionar o grupo de informações referentes a nova extensão no layout de cadastro de empresas, conforme exemplos a seguir.
Para integração via SOAP
TipoExtensao – Código da extensão que será ativada. Para Compliance NFS-e informar ‘10’.
Módulo – Módulo para o qual a extensão será ativada. Informar ‘NFSe’.
MunicipiosAtivar – Informar o código do IBGE do município que deseja ativar para consultar as informações. Podem ser informados vários códigos usando o separador ‘;’ ou a palavra ‘Todos’, ativando assim todos os municípios habilitados na extensão. Para ativar um município também é necessário informar o campo Ativar como ‘S’.
Somente serão retornadas informações dos municípios já habilitados na extensão e que foram ativados pelo parceiro na extensão Compliance NFS-e.
MunicipiosDesativar – Informar o código do IBGE do município que deseja desativar na extensão. Podem ser informados vários códigos usando o separador ‘;’ ou a palavra ‘Todos’, desativando assim todos os municípios ativos para o parceiro na extensão. Para desativar um município também é necessário informar o campo Ativar como ‘N’.
Ativar – Informar ‘S’ para Ativar a extensão e municípios e ‘N’ para Desativar a extensão e municípios.
Baixe o nosso layout de cadastro de empresas, já atualizado com todas as informações.
Consultar Serviços do Município (REST)
Por meio dessa consulta é possível obter uma listagem de todos os serviços e as naturezas de operação cadastrados em determinado município.
Essa consulta é destinada a usuários parceiros, portanto, para a realização da mesma é necessário a geração de um Token com os dados da Chave de Parceiro, conforme descrito a seguir.
Para geração do Token do parceiro deve ser enviada a Chave de Parceiro no parâmetro ‘sub’, os demais campos seguem a mesma estrutura da geração de token para empresas.
Clientes que utilizam integração via SOAP com o InvoiCy podem realizar a busca pelos serviços dos municípios por meio do web service ‘arecepcao.aspx’, o mesmo utilizado para envio de documentos. Para essa consulta é preciso enviar a estrutura a seguir com as informações e os parâmetros desejados.
CNPJEmissor – CNPJ da empresa cadastrada no InvoiCy
Versão – 1.0 (fixo)
tpAmb – Ambiente de emissão, sendo 1 – Produção e 2 – Homologação
CodMunicipio – Código IBGE do município que deseja consultar as informações
RetornaListaServiço – Retornar a lista de serviços do município, sendo S – Sim e N- Não
RetornaNaturezaOp – Retornar a lista de naturezas de operação do município, sendo S – Sim e N – Não.
Consulta Particularidades dos Padrões
Atualmente a consulta das particularidades de cada padrão de NFS-e integrado com o InvoiCy encontra-se disponível em nosso Portal dos Desenvolvedores, em forma de artigos onde são listadas as características próprias de cada um. Com a nova extensão do InvoiCy, catalogamos todas as particularidades de cada padrão integrado e disponibilizamos para consulta por meio de uma API.
A consulta de particularidades dos municípios foi adicionada à Consulta de Municípios Integrados já disponibilizada pelo InvoiCy, que a partir de agora passa a retornar informações mais completas para aqueles parceiros que tenham o município ativado na extensão Compliance NFS-e. Caso o município não esteja ativo, o retorno da consulta de municípios integrados permanece da forma atual, retornando dados básicos.
Para obter as informações completas sobre as particularidades, a consulta deverá ser realizada pelo código IBGE do município.
Para os parceiros com o município ativado na extensão, o retorno da consulta terá as seguintes informações, além daquelas que já retornam atualmente.
Ainda no Painel de Controle do InvoiCy, é possível acessar uma Lista de Serviços dos municípios. Para isso, adicionamos um novo ícone no grupo de informações de NFS-e, chamado “Lista Serviços Municípios”, por meio dele é possível consultar os serviços disponíveis em cada um dos municípios que o parceiro tiver ativado na Extensão Compliance NFS-e. Conforme mostra a imagem a seguir.
Importante lembrar que o acesso à essa opção está disponível para usuários do tipo Parceiro, porém, este poderá disponibilizar ao seu cliente final acesso à essa nova opção, para isso é necessário alterar as permissões no cadastro do usuário que terá acesso à essas informações.
Nessa tela é possível localizar os serviços disponíveis em um determinado município, buscando por meio do código IBGE do mesmo, pelo nome do município, código de tributação, código do item da lista de serviços ou pela descrição do serviço.
Oferecemos também a possibilidade de exportar as informações listadas em tela para um arquivo .csv, clicando sobre o botão conforme mostra a imagem a seguir.
Ao clicar no ícone , na última coluna da tela, é possível consultar detalhes de um determinado serviço, como mostra a imagem a seguir.
Já está disponível em produção a versão 2.38.0 do InvoiCy.
Confira as novidades:
– Adequação conforme NT 2020.006 v.1.20 – Intermediador da Operação:
Oba! O InvoiCy está atualizado de acordo com a nova NT 2020.006 v1.20, com atualizações nas regras de validação para a NF-e/NFC-e versão 4.0, alteração na obrigatoriedade do indicativo da operação com intermediador/marketplace, e inclusão da descrição do meio de pagamento.
O prazo previsto para a implementação das mudanças é:
Ambiente de homologação até: 03/05/2021 Postergada entrada em produção para: 01/09/2021
O que preciso alterar para me adequar a NT?
As alterações incluem o campo de indicativo da operação com intermediador/marketplace, que precisará ser informado apenas quando o indicador de presença (indPres) for igual a:
2 – Operação não presencial, pela Internet; 3 – Operação não presencial, Teleatendimento; 4 – NFC-e em operação com entrega a domicílio; 9 – Operação não presencial, outros.
E também foi incluído o novo campo xPag, dentro do grupo de Pagamento, para informar a descrição do meio de pagamento quando: tPag (meio de pagamento) for igual a 99 – Outros.
Para ficar por dentro de todas as alterações realizadas em decorrência dessa NT, faça download do nosso layout de integração clicando aqui, as informações atualizadas estão destacadas em cor amarela. E não deixe de ler a NT 2020.006 v1.20 na íntegra.
– Nova extensão Compliance NFS-e:
Olha só que super novidade! Estamos disponibilizando uma nova extensão no InvoiCy, a Compliance NFS-e. Essa nova extensão foi desenvolvida com objetivo de facilitar a busca de informações essenciais para emissão de Notas Fiscais de Serviços.
Por meio dela é possível obter informações como Particularidades dos Padrões, Naturezas de Operação, Códigos de Tributação do Município (TributMunicipio), Itens da Lista de Serviços (IteListServico), Descrições dos Serviços, Alíquotas, Observações das Alíquotas, Retenção de ISS e INSS, Domicílio do ISS (local de pagamento), Data de Início de Vigência da Lei, Fonte da Base Legal das Informações, Formato do Item da Lista de Serviços e Observações de cada município.
Para mais informações leia o artigo completo clicando aqui.
– Informação do emissor no canhoto do DACTE:
A partir dessa versão, será possível imprimir a informação do nome do emissor no canhoto do DACTE, legal né?.
Basta configurar o novo parâmetro ‘Imprimir informações do nome do emissor do CT-e’, disponível na tela de configurações de impressão do módulo CT-e.
Ao configurar o novo parâmetro como ‘Sim’, será impresso no cabeçalho do DACTE a informação do nome do emissor.
Mas atenção! Essa configuração está disponível apenas para o DACTE na orientação Retrato.
– Possibilidade de gerar duas vias do DANFE via InvoiCy Conector:
E tem mais! Com a atualização desta nova versão, os usuários terão a possibilidade de gerar o DANFE duplicado no mesmo arquivo em PDF e utilizar o recurso da impressora para imprimir as duas vias em uma única página.
Mas como isso vai funcionar na prática? O InvoiCy Conector poderá solicitar este modelo de DANFE, e o emissor deverá tratar na impressora para ser impresso estes dois DANFEs na mesma página.
A nova opção estará disponível através do layout de integração do Invoicy, onde foi criada uma nova tag chamada <ImprimirDuasVias>, esta deve ser preenchida com os valores S ou N, conforme exemplo na imagem abaixo.
Caso vier preenchida com S, o DANFE será gerado em duas vias, e caso vier com o valor N, irá gerar o DANFE em uma via. As configurações do DANFE seguem da mesma forma, através dos parâmetros de impressão, a diferença é que a partir dessa versão poderá ser gerada duas páginas iguais.
– Impressão automática no InvoiCy Conector:
O InvoiCy Conector sofreu uma adequação, buscando permitir a impressão de documentos com impressoras remotas.
Existe uma nova opção a ser selecionada na aba de impressão ‘Utilizar AcroWrap (necessário instalar)’, como demonstra a imagem abaixo.
Essa opção faz com que a impressão seja feita por outro processo, corrigindo algumas situações de falta de permissão de usuários. Mas atenção! Para que esse processo funcione é necessário ter o Adobe Reader instalado no computador.
Disponibilizamos aqui olinkpara fazer download do Adobe Reader.
Observação: por enquanto essa opção é utilizada apenas no processo de emissão normal de documentos, ou seja, que não foram emitidos em contingência.
Para mais informações sobre o processo de impressão via InvoiCy Conector, leia o artigoConfigurações de impressão.
– Permitir consultar notas recebidas em prestadores cadastrados:
A importação de NFS-e de entrada também está com novidades! A partir de agora, prestadores de serviços que utilizam o InvoiCy e que contratam serviços de empresas das cidades atendidas pelo Padrão JFISS Digital, podem cadastrar esses fornecedores para que o invoiCy realize a aimportação de NFS-e de entrada automaticamente.
Com essa nova funcionalidade, você poderá cadastrar seus fornecedores e quando for contratado um serviço e uma NFS-e for emitida por uma dessas empresas, o InvoiCy irá importar automaticamente esse documento, disponibilizando o mesmo para consulta, download e impressão.
Mas atenção! Para usar essa funcionalidade é necessário ter a Extensão Importação de Documentos ativa.
O cadastro de prestadores de serviço pode ser realizado por meio do Painel de Controle do InvoiCy, no grupo de informações da NFS-e, onde foi adicionado um novo ícone chamado ‘Cadastro de Prestadores’.
Ao clicar no ícone ‘Cadastro de Prestadores’, será exibida a tela com a lista de empresas cadastradas e a opção ‘Adicionar’, para ter acesso ao formulário de cadastro de um novo prestador.
Caso precise localizar um prestador cadastrado, poderá utilizar os filtros por CNPJ, Nome, Município, UF e status.
Os dados dos prestadores cadastrados podem ser alterados (exceto o CNPJ), por meio do ícone ‘Editar’. Caso não queira que o InvoiCy importe documentos emitidos por algum prestador cadastrado, é possível alterar o status para ‘Inativo’, na tela de edição do cadastro, ou realizar a exclusão do registro, por meio do ícone ‘Excluir’.
Clicando no botão ‘Adicionar’, será exibida a tela de cadastro de um novo prestador. Preencha as informações dos campos e clique em ‘Salvar’. A partir desse momento, toda vez que esse prestador emitir uma NFS-e onde você seja o Tomador, o InvoiCy irá consultar esse documento na prefeitura e realizará a importação do mesmo.
E olha só que legal! Estamos liberando 90 novos municípios que permitem a consulta automática.
– Link do XML no retorno da consulta de documentos:
A partir desta versão ao realizar a consulta de um documento, o link do XML correspondente a tag DocXMLLink, que antes era retornado em protocolo HTTP, passará a ser retornado em protocolo HTTPS.
Atenção! Essa alteração no protocolo do link de retorno impacta apenas no processo de consulta de documentos, para as integrações via REST e SOAP, onde a partir de agora passará a utilizar o endereço: https://app.invoicy.com.br para montar o link de retorno do XML.
Faça as alterações necessárias e desfrute de todo o potencial da Plataforma InvoiCy!
Ficou com alguma dúvida? Encaminhe para atendimento@migrate.info que nossa equipe de atendimento te ajuda!
Essa novidade é para você, usuário parceiro! A partir de agora, permitimos replicar os dados do cadastro de uma empresa entre os ambientes de homologação e produção, flexibilizando as novas integrações.
Essa funcionalidade está disponível através do novo ícone “Replicar empresa”, localizado na tela de Início do InvoiCy, como demonstra a imagem a seguir.
Dessa forma, basta clicar no ícone correspondente a empresa que você deseja enviar o cadastro para o outro ambiente, onde o sistema irá apresentar uma mensagem em tela, solicitando a confirmação para replicar o cadastro da empresa.
Se o cadastro ocorrer com sucesso, será apresentada em tela a mensagem “A empresa foi cadastrada no Invoicy”. Caso contrário, será apresentada uma mensagem informando o que aconteceu.
Atenção! Estando no ambiente de homologação, a empresa será automaticamente cadastrada no ambiente de produção, mas fique tranquilo que isso não acarretará em custos adicionais, pois a empresa ainda não estará licenciada para emitir documentos.
Também é possível fazer o processo inverso, estando no ambiente de produção, a empresa será automaticamente cadastrada no ambiente de homologação.
É importante destacar que, os dados enviados no cadastro compreendem as informações relativas aos dados da empresa (CNPJ, Razão Social, endereços), bem como logomarca e certificado digital. Demais dados como, parâmetros configurados por módulo, caixas de e-mail e licenciamento, não serão replicados para o outro ambiente.
O Padrão NFSeWeb segue o modelo padronizado ABRASF 2.02. Segue abaixo suas particularidades:
1. O sistema não permite:
Substituição de Notas Fiscais de Serviço Eletrônica;
Inutilização de Notas Fiscais de Serviço Eletrônica;
Tomador estrangeiro.
2. Obrigatoriedades
Informar valor no item da lista de serviço;
Informar valor no ISS Retido;
Informar a alíquota do ISS cadastrada na prefeitura.
3. Código CNAE
O código CNAE segue as regras legislativas do município, sendo informado apenas quando o município possuir em sua legislação a permissão para tal, em certos municípios possui a exigência para informar, portanto mantendo em branco.
4. Impressão
Possui disponibilidade de impressão pelo modelo da prefeitura do município onde a empresa está situada.
5. Cancelamento de NFS-e
O código de cancelamento não permitido pela prefeitura é o número 1. A seguir tabela de códigos:
6. Natureza da Operação:
O campo de natureza da operação deverá seguir o padrão ABRASF:
7. Regime Especial de Tributação
Conforme o padrão ABRASF seguem os seguintes valores para o campo de Regime Especial de Tributação:
8. Exemplo XML
Clique aqui para visualizar um exemplo de XML enviado ao InvoiCy NFS-e.
Já está disponível em produção a versão 2.37.0 do InvoiCy.
Confira as novidades:
– Adequação conforme NT 2021.001 do CT-e:
Em resumo, esta Nota Técnica promove uma nota explicativa sobre a regra de validação da duplicidade de chaves de acesso visando padronizar o entendimento em todos os DF-e. E também a desativação da validação que impede autorização de CT-e cuja numeração encontra-se inutilizada.
Mas o que isso significa na prática?
A autorização de CT-e apresenta uma regra de validação que garante a unicidade da chave natural (chave de acesso) do Documento Fiscal Eletrônico composta por CNPJ/CPF, Modelo, Série e Número do documento.
Há situações onde um mesmo documento pode ser emitido e autorizado de forma normal (tpEmis 1) e também em contingência SVC (tpEmis 6 ou 7), caracterizando duplicidade.
Quando ocorre uma falha de comunicação com a SEFAZ, não sabemos se o documento foi ou não autorizado. De praxe, quando ocorre essa falha, o aplicativo comercial pode efetuar a emissão deste mesmo documento em contingência SVC, autorizando-o com tpEmis 6 ou 7.
Porém, o documento enviado anteriormente com tpEmis 1 que recebeu a falha de comunicação, pode ter sido autorizado no ambiente normal da SEFAZ. Desta forma, teríamos 2 documentos autorizados com mesmo número e série, porém somente com tpEmis diferentes.
Anteriormente, este procedimento poderia causar duplicidade, sendo que o InvoiCy não armazenaria um dos documentos por conter a mesma numeração e série. Com esta nova atualização, o InvoiCy passará a armazenar ambos os documentos, exibindo em tela e retornando em consultas os dois arquivos, tanto o que foi emitido em tpEmis normal, quanto o documento que foi emitido com tpEmis de contingência.
Para ficar bem informado sobre tudo que engloba essa NT, leia o artigo no nosso Blog.
– Adequação conforme NT 2021.001 do MDF-e:
Em resumo, esta Nota Técnica promove ajustes no leiaute do MDF-e do modal RODOVIÁRIO adequando o grupo de informações do vale pedágio em acordo com a definição da ANTT (Agência Nacional de Transportes Terrestres). Também a inclusão da chave do PIX como forma alternativa de recebimento do frete no modal rodoviário e no evento de pagamento do frete.
Também promove uma nota explicativa sobre a regra de validação da duplicidade de chaves de acesso, visando padronizar o entendimento em todos os DF-e. Por fim, o novo padrão de placas do Mercosul não traz mais no registro de licenciamento a informação da UF de emplacamento, tornando facultativo o preenchimento deste campo.
O que preciso alterar para me adequar a NT?
Algumas alterações foram realizadas no layout XML do MDF-e, as quais destacamos abaixo. É importante ressaltar que as regras de validação relacionadas ao Vale Pedágio, entram em vigor somente na data de 07/06/2021.
– Alterado campo numeroCompra do grupo de Vale Pedágio tornando-o de preenchimento opcional;
– Incluído campo tpValePed no grupo de Vale Pedágio para informação do Tipo de Vale Pedágio. Aceita os valores: – 01 – TAG; – 02 – Cupom; – 03 – Cartão.
– Incluído campo categCombVeic no grupo de Vale Pedágio para informação da categoria de Combinação veicular. Aceita os valores: – 02 Veículo Comercial 2 eixos; – 04 Veículo Comercial 3 eixos; – 06 Veículo Comercial 4 eixos; – 07 Veículo Comercial 5 eixos; – 08 Veículo Comercial 6 eixos; – 10 Veículo Comercial 7 eixos; – 11 Veículo Comercial 8 eixos; – 12 Veículo Comercial 9 eixos; – 13 Veículo Comercial 10 eixos; – 14 Veículo Comercial Acima de 10 eixos.
– Incluído campo indAltoDesemp no grupo de Informações do Pagamento do Frete para informar indicação de operação de transporte de alto desempenho;
– Incluído campo PIX no grupo de Informações Bancárias para informar a chave PIX para recebimento do pagamento do frete realizado;
– No grupo VeicTracao e VeicReboque, o campo UF (UF em que o veículo está licenciado), passa a ser de preenchimento opcional, uma vez que o campo deixou de existir para o padrão de placa MERCOSUL;
– No Evento de Pagamento da Operação também foi incluído o campo PIX, para que seja possível informar a chave PIX para recebimento do pagamento do frete.
Para acompanhar todas as alterações que essa NT engloba, leia o artigo no nosso Blog. Também confira as alterações realizadas em nossos layouts de integração: Layout de Envio e Layout de Eventos.
– Implementação de Web Service de licenciamento para API REST:
Olha só que super novidade! A partir dessa versão o InvoiCy passa a disponibilizar o serviço de licenciamento de empresas também via API REST, possibilitando realizar a solicitação, cancelamento, bloqueio e desbloqueio de licenças.
A seguir apresentamos a estrutura do layout do JSON a ser enviado, onde deve-se informar o CNPJ da empresa, tipo de ambiente (1 – Produção, 2 – Homologação), Ação que será executada, Módulo, Modelo de contrato e Autor responsável pela solicitação, destacando que a informação do Autor é obrigatória.
Na sequência explicamos cada campo dessa estrutura:
CnpjEmpresa – empresa cadastrada no InvoiCy para a qual serão realizadas as ações de licenciamento.
tpAmb – Ambiente do licenciamento, sendo 1 – Produção e 2 – Homologação.
Acao – representa ação a ser realizada sobre a licença, sendo que as opções disponíveis são: 1 – Solicitar, 2 – Bloquear, 3 – Desbloquear e 4 – Cancelar.
Modulo: módulo para o qual será realizada a ação sobre a licença, exemplo: NF-e, CT-e, NFS-e.
Modelo: modelo de contrato, sendo 1 – Bilhetagem ou 2 – Licenciamento.
Autor: responsável pela ação realizada.
Para mais informações e exemplos de JSON, acesse a documentação da API REST, neste link.
– Possibilidade de replicar o cadastro de empresas automaticamente:
Oba! Essa novidade é para você, usuário parceiro! A partir de agora, permitimos replicar os dados do cadastro de uma empresa entre os ambientes de homologação e produção, flexibilizando as novas integrações.
Essa funcionalidade está disponível através do novo ícone “Replicar empresa”, localizado na tela de Início do InvoiCy, como demonstra a imagem a seguir.
Dessa forma, basta clicar no ícone correspondente a empresa que você deseja enviar o cadastro para o outro ambiente, onde o sistema irá apresentar uma mensagem em tela informando que “A empresa foi cadastrada no Invoicy”.
Atenção! Estando no ambiente de homologação, a empresa será automaticamente cadastrada no ambiente de produção, mas fique tranquilo que isso não acarretará em custos adicionais, pois a empresa ainda não estará licenciada para emitir documentos, ok?!
Também é possível fazer o processo inverso, estando no ambiente de produção, a empresa será automaticamente cadastrada no ambiente de homologação.
É importante destacar que, os dados enviados no cadastro compreendem as informações relativas aos dados da empresa (CNPJ, Razão Social, endereços), bem como logomarca e certificado digital. Demais dados como, parâmetros configurados por módulo, caixas de e-mail e licenciamento, não serão replicados para o outro ambiente.
– Novas opções de retorno nos parâmetros da consulta de documentos:
O processo de consulta de documentos sofreu algumas adequações, e a partir dessa versão conta com dois novos parâmetros, que serão detalhados na sequência.
Retornar tipo de emissão na consulta de documentos:
O processo de consulta de documentos conta com o novo parâmetro RetornartpEmis, que permite retornar o tipo de emissão do documento consultado. Veja na imagem abaixo um exemplo dos parâmetros da consulta:
A tag RetornartpEmis aceita os valores: S – Sim e N – Não, e quando for preenchida com ‘S’ será disponibilizada a informação <tpEmis> no retorno da consulta.
O retorno do tpEmis se faz necessário para empresas que gostariam de identificar o tipo de emissão do documento retornado na consulta (normal ou contingência). Conforme últimas NT publicadas pela SEFAZ, poderá haver um mesmo documento autorizado com numeração e série iguais, porém somente com tpEmis diferentes, fato que anteriormente retornaria duplicidade. Ambos os documentos serão armazenados pelo InvoiCy e caso este cenário ocorra, os dois documentos serão retornados na consulta, podendo ser diferenciados pelo tpEmis retornado.
Retornar DANFE em formato paisagem na consulta de documentos:
E tem mais! Agora o processo de consulta de documentos também foi adequado para permitir o retorno do DANFE em modelo paisagem.
Quer saber como isso funciona? É bem simples! Basta informar nos parâmetros da consulta a tag TipoImpressao com o valor ‘P’, com isso o DANFE retornado será impresso no modelo Paisagem. Veja um exemplo abaixo dos parâmetros de envio da consulta:
Fique atento para as demais opções aceitas na tag TipoImpressao:
S – Simplificado N – Retrato P – Paisagem E – Etiqueta
Para ficar bem informado, faça download do nosso layout de integração para consulta de documentos, e confira os novos campos destacados em amarelo.
– Disponibilizado novo modelo do DANFE
A partir desta nova versão, foi disponibilizado o novo modelo “Legado” nas configurações de impressão da NF-e, que está disponível apenas para o DANFE paisagem, como demonstra a imagem abaixo:
Essa nova atualização, estará seguindo o padrão do DANFE do antigo produto GNF-e Desktop. Os pontos alterados são os seguintes:
– Posicionamentos de alguns campos nos dados do Emissor e principalmente nos dados do Destinatário;
– Dados referente aos volumes que possuem as linhas com fonte pequena e Descrição; – Dados dos produtos onde os dados ficam muito próximos da linha.
Dessa forma, quando selecionada a orientação Paisagem, será disponibilizada a opção “Legado” no campo “Modelo do DANFE”. Ao selecionar esta opção, já passará a ser impresso o novo DANFE com os ajustes aplicados.
– Possibilidade de aumentar a largura da descrição do item no DANFE:
As novidades não param por aí não!A tela de configurações de impressão da NF-e disponibiliza um novo parâmetro “Aumentar a largura da descrição do item”, que pode ser visto na imagem a seguir.
Mas atenção! Esse parâmetro está disponível apenas para o DANFE na orientação Retrato e modelo Personalizado.
Ao configurar esse parâmetro como ‘Sim’, a largura da coluna de descrição do produto sairá com um espaço maior no DANFE, como pode ser observado no exemplo abaixo.
– Recebimento e armazenamento do XML da NF-e quando o CNPJ estiver como transportador:
Através dessa atualização, você usuário terá a possibilidade de receber e armazenar o XML da NF-e, quando o CNPJ contratante da extensão de Importação de Documentos estiver relacionado somente como transportador, no grupo Transporta, como exemplificamos na imagem abaixo:
Fique atento! O InvoiCy não permitirá o envio de nenhum evento de manifestação, cancelamento ou CC-e sobre estes documentos.
Na extensão de Importação de Documentos, foi disponibilizado o novo parâmetro “Buscar como transportadora”, para configurar a baixa ou não quando o CNPJ estiver como transportador no XML, como apresentado na imagem abaixo.
– Integração com o padrão NFSeWeb de Neves Paulista – SP:
Oba! Foi liberada a integração da emissão de NFS-e para o município de Neves Paulista, atendido pelo padrão NFSeWeb. A partir de agora prestadores de serviço deste município podem utilizar o InvoiCy para realizar a emissão e gestão de suas notas fiscais.
Não perca tempo! Para mais informações acesse o artigo do padrão clicando aqui.
Faça as alterações necessárias e desfrute de todo o potencial da Plataforma InvoiCy!
Ficou com alguma dúvida? Encaminhe para atendimento@migrate.info que nossa equipe de atendimento te ajuda!
O Padrão ADM Nota Fiscal segue o modelo padronizado ABRASF 2.00. Segue abaixo suas particularidades:
Observações importantes:
Só solicite o ambiente de produção após finalizar todos os testes no ambiente de homologação. Após terminar os testes em homologação deve-se acessar o portal da prefeitura do município e na opção a direita clicar em Web Services e nesta tela possui o botão em verde para ‘Solicitar Produção’.Imagens abaixo ilustram a tela que deve ser acessada.
Dados importantes que devem ser inseridos no InvoiCy:
Durante o cadastro de empresa, tem-se a etapa de configurações de emissão para NFS-e com os campos que devem ser preenchidos da seguinte forma:
Usuário de autenticação = Inserir o valor do campo Auth
Senha de autenticação = Inserir o valor do campo ReqId
Chave primária de autenticação = Inserir o valor do campo Token
Verificar os campos na imagem abaixo:
Outra regra a ser observada durante o cadastro de empresas é que o valor da inscrição municipal deve ser cadastrada como está na prefeitura, se possuir traços ou pontos devem ser inseridos no cadastro também. Exemplo: 00-0000
1. O sistema não permite:
Substituição de Notas Fiscais de Serviço Eletrônica;
Inutilização de Notas Fiscais de Serviço Eletrônica;
Enviar notas sem identificação do Tomador do serviço;
2. Obrigatoriedades
Informar valor no item da lista de serviço;
Informar valor no ISS Retido.
3. Código CNAE
O código CNAE segue a regras legislativas do município, sendo informado apenas quando o município possuir em sua legislação a permissão para tal, em certos municípios possui a exigência para informar, portanto deve ser enviado.
4. Impressão
Não possui disponibilidade de impressão pelo modelo da prefeitura do município onde a empresa está situada.
5. Natureza da Operação
O campo de natureza da operação deverá seguir o padrão ABRASF:
6. Regime Especial de Tributação
Conforme o padrão ABRASF seguem os seguintes valores para o campo de Regime Especial de Tributação:
7. Exemplo XML
Clique aqui para visualizar um exemplo de XML enviado ao InvoiCy NFS-e.
, na última coluna da tela, é possível consultar detalhes de um determinado serviço, como mostra a imagem a seguir.
Desenvolvedores Migrate 