Pular para conteúdo

Operação

Este artigo detalha o fluxo de trabalho essencial do InvoiCy Framework. A seguir, você encontrará informações sobre a forma correta de emissão de documentos e o gerenciamento do seu ciclo de vida, incluindo o armazenamento e tratamento dos arquivos pendentes e de logs, as configurações de impressão do DANFE-NFC-e e os requisitos de dados fiscais complementares exigidos pela legislação.

Emissão de Documentos

Para efetuar a emissão de documentos fiscais, envio de eventos e consultas, o Aplicativo Comercial deverá gerar a informação de entrada em formato XML, seguindo o layout de integração InvoiCy. A documentação que descreve o layout de integração InvoiCy está disponível aqui. Também é necessário que sejam configurados os parâmetros a seguir.

Diretório de Documentos

- Documentos Pendentes: É onde são armazenados os XMLs dos documentos emitidos em contingência e que estão pendentes de sincronização na Plataforma InvoiCy e de autorização na Secretaria da Fazenda (SEFAZ). O InvoiCy Framework salva os documentos pendentes no subdiretório “\DocsPendentes” da pasta de trabalho e tenta sincronizar os documentos periodicamente, em tempo definido através do parâmetro "TEMPO_VERIFICACAO". O subdiretório “\DocsPendentes” é criado automaticamente pelo InvoiCy Framework.

Opcionalmente, o Aplicativo Comercial poderá forçar o envio dos documentos pendentes através da função "InvoiCyFramework_EnviaDocumentosPendentes". Esta função não tem parâmetros de entrada e retornará um tipo Integer indicando a quantidade de documentos remanescentes.

O parâmetro "EMITIR_EM_CONTINGENCIA=1" impede o envio dos documentos que se encontram pendentes.

- Documentos com Retorno de Erro ao Sincronizar: O InvoiCy Framework move os documentos cuja sincronização e/ou autorização na SEFAZ tenha retornado algum código de rejeição para o subdiretório “\DocPendentes\Erro”. O subdiretório \Erro é criado automaticamente pelo Framework. A presença de arquivos nesta pasta deve ser verificada pelo Aplicativo Comercial para encaminhamento de ajuste manual.

Arquivo de Logs

O InvoiCy Framework gera arquivos de logs da sua operação, que são muito úteis para entender alguma inconsistência que possa ocorrer durante o processo de emissão de documentos.

Por padrão, os arquivos de log são gravados na pasta de trabalho. O nome dos arquivos de log serão definidos conforme o dia de execução, no formato invoicyfrmwrkAAAAMMDD.log. Serão mantidos os arquivos de logs dos últimos 30 dias, considerando a data atual. A cada novo dia de emissão, os arquivos mais antigos são excluídos.

Algumas características da gravação de logs podem ser modificadas através da configuração dos parâmetros LOG_REGISTRO, LOG_NIVEL, LOG_DIAS e LOG_DIRETORIO. Veja o detalhamento da função "InvoiCyFramework_Configura".

Dados do Responsável Técnico

Algumas UF exigem que seja informado o grupo com os dados do Responsável Técnico no XML da NFC-e.

Estes dados devem ser cadastrados na plataforma InvoiCy. O InvoiCy Framework realiza a consulta destes dados dentro da plataforma, e desta maneira preenche automaticamente estas informações quando necessário. Entenda mais sobre o responsável técnico e como cadastrar os dados no InvoiCy clicando aqui.

DANFE-NFC-e

- Configurações de Impressão: Existem três possibilidades para realizar a impressão do DANFE NFC-e, seja a emissão realizada online ou autorizado em contingência:

  • Framework monta e imprime o DANFE NFC-e:
    Para que o InvoiCy Framework monte e realize a impressão do DANFE NFC-e, é necessário que seja configurado o parâmetro IMPRESSORA_CANAL, permitindo configurar uma impressora conectada em porta serial, em rede ou do spool de impressão do windows;

  • Framework monta o DANFE NFC-e e o AC realiza a impressão:
    Para isso, é necessário que seja criado manualmente o subdiretório “Recibos” na pasta de trabalho. Após o retorno bem sucedido de uma emissão, o Aplicativo Comercial deve obter o recibo a ser impresso neste subdiretório;

  • AC monta e imprime o DANFE NFC-e:
    Se isto ocorrer, os dados XML do documento autorizado - retornados na emissão na tag DocXMLBase64 - deverão ser utilizados. Opcionalmente, também poderá usar os parâmetros "LAYOUT_IMPRESSAO_DANFENFCE" e "LAYOUT_IMPRESSAO_POS_QRCODE" para definir o formato e o posicionamento do QR Code.

Caso o Aplicativo Comercial tenha a necessidade de controlar individualmente a impressão do DANFE NFC-e, este poderá utilizar os parâmetros adicionais na chamada da função "InvoiCyFramework_EmiteDocumento".

- Geração e Impressão em somente uma via na Emissão Offline: Por default, o InvoiCy Framework imprime o DANFE NFC-e de emissões em contingência offline em duas vias (estabelecimento e consumidor).

No entanto, existe a opção de imprimir somente a via do consumidor, mediante consulta e configuração realizada na Plataforma InvoiCy. Essa alteração é feita em Início > Painel de controle > Configurações para a emissão de NFC-e > Imprimir uma via (DANFE) em contingência?, e o Framework obtém e aplica esse parâmetro ao realizar a emissão.

Para poder fazer uso da opção de guarda eletrônica do arquivo XML emitido em contingência, o emissor deverá, previamente, lavrar termo no livro Registro de Utilização de Documentos Fiscais e Termos de Ocorrência - modelo 6, ou formalizar declaração de opção segundo disciplina que vier a ser estabelecida por sua UF, assumindo total responsabilidade pela guarda do arquivo e declarando ter ciência que não poderá, posteriormente, alegar problemas técnicos para justificar a eventual perda desta informação eletrônica que está sob sua posse, assumindo as consequências legais porventura cabíveis.

Logomarca

A DANFE NFC-e pode ser gerada contendo o logotipo do emissor. Para isso, é necessário disponibilizar um arquivo bitmap do logotipo na pasta de trabalho. O arquivo deve ter o formato BMP e o nome “logotipo.bmp”. A imagem deve ser gerada em preto e branco (nas propriedades do arquivo deve constar intensidade de bits =1) e largura máxima de 567 pixels.

Se a imagem tiver até 210 x 210 pixels, o logotipo será impresso à esquerda e dados do estabelecimento serão impressos à direita da logo. Se a largura da imagem for entre 211 e 567 pixels, qualquer que seja a altura, o logotipo será impresso centralizado no topo e dados do estabelecimento serão impressos abaixo.

Valor Aproximado dos Tributos

O InvoiCy Framework possui o recurso opcional de obter a tabela de produtos x tributações, calcular e alimentar as tags infAdProd e vTotTrib do XML de emissão, e também gerar a mensagem indicativa do valor aproximado dos tributos na tag infCpl, além de imprimi-la. Este recurso é desabilitado por default, e pode ser ativado através do parâmetro LEI_DO_IMPOSTO_CALCULAR_VALORES, conforme segue:

  • Desabilitado (Parâmetro = 0): O Framework não realiza nenhuma tratativa referente à Lei do Imposto. Dessa forma, o AC é responsável por realizar o controle e o cálculo dos impostos aproximados, preenchimento da tag imposto\vTotTrib no grupo do produto, vTotTrib do grupo total\ICMSTot e também o texto a ser impresso no final do comprovante através da tag infCpl.

  • Habilitado (Parâmetro = 1, 2, 3, 4 ou 5): O Framework realiza as tratativas referentes à Lei do Imposto.

Se o parâmetro estiver habilitado, o InvoiCy Framework obtém a tabela de produtos e alíquotas através de consulta à plataforma InvoiCy. Caso prefira, o AC pode ser responsável por fornecer a tabela de produtos x tributações. Para isso, deve-se informar o nome do arquivo que contém a tabela de produtos através do parâmetro LEI_DO_IMPOSTO_ARQUIVO.

Detalhamento do Texto na Nota Fiscal (infAdProd e infCpl):

Indicador Tag "infAdProd" Tag "infCpl"
1 Não insere o texto nesta tag Texto adicionado: "Valor Aprox. dos tributos: R$xx,xx"
2 Insere o texto “Trib aprox R$: xx,xx Federal, yy,yy Estadual e zz,zz Municipal Fonte: nnnnnn” detalhando os tributos incidentes específicos de cada item. Texto adicionado: "Valor Aprox. dos tributos: R$xx,xx"
3 Insere o texto “Trib aprox R$: xx,xx Federal, yy,yy Estadual e zz,zz Municipal Fonte: nnnnnn” detalhando os tributos incidentes específicos de cada item. Texto adicionado: “Valor Aprox dos Tributos
4 e 5 Insere o texto “Trib aprox R$: xx,xx Federal, yy,yy Estadual e zz,zz Municipal Fonte: nnnnnn” detalhando os tributos incidentes específicos de cada item. Texto adicionado: "Valor Aprox. dos tributos: R$ww,ww"

Reimpressão de Documentos

Caso tenha o intuito de reimprimir um documento utilize a função "InvoiCyFramework_ImprimeDocumento". Deverá ser informado como parâmetro o XML do documento autorizado, que pode ser o conteúdo decodificado da tag DocXMLBase64 que a Aplicação Comercial recebeu na resposta da emissão, ou obtido através da consulta de documento.