https://wiki.adapter.net.br/wiki/api.php?action=feedcontributions&feedformat=atom&user=Caio.silva 2026-05-04T14:19:24Z Contribuições do usuário MediaWiki 1.41.0 https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3566 2025-12-18T18:51:50Z

<p>Caio.silva: </p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ===Seleção de Integradora para Recorrência de Pix===<br /> <br /> Foi ajustado o fluxo de configuração da recorrência de Pix nas formas de cobrança.<br /> <br /> Anteriormente, ao marcar a flag “Utiliza recorrência de Pix” (campo UtilizaRecorrenciaPix na TB_FormaCobranca), não era possível selecionar a integradora Pix responsável pela recorrência, impedindo a configuração completa da funcionalidade.<br /> <br /> Com a correção, foi disponibilizada em tela a seleção da integradora de Pix, permitindo associar corretamente a forma de cobrança à integradora responsável. O valor configurado passa a ser buscado a partir do campo de integradora de remessa eletrônica, seguindo o mesmo padrão já utilizado em outros pontos do sistema.<br /> <br /> ===Download de XML de NFCOM Autorizada na Tela do Cliente===<br /> <br /> Foi implementado um novo botão na tela de notas fiscais do cliente que permite baixar o XML da NFCOM, desde que a nota esteja autorizada.<br /> <br /> Ao acionar o botão, o sistema disponibiliza o arquivo XML correspondente à nota fiscal, facilitando o acesso ao documento eletrônico diretamente pela interface do cliente.<br /> <br /> ===Status do contrato ao desfazer negociação===<br /> <br /> Descrição:<br /> Foi criada uma nova chave de configuração no módulo financeiro chamada STATUS_CONTRATO_NEGOCIACAO_DESFEITA.<br /> <br /> Essa chave recebe um IDStatusContrato e não possui preenchimento obrigatório.<br /> <br /> Funcionamento:<br /> <br /> Quando a chave estiver preenchida (exemplo: 5 = SUSPENSO), ao desfazer uma negociação, todos os contratos HABILITADOS vinculados a essa fatura de negociação terão seu status alterado para o status informado na chave.<br /> <br /> Caso a chave esteja null, o funcionamento atual do sistema será mantido, sem alteração de status dos contratos.<br /> <br /> Observações Técnicas:<br /> <br /> Para a alteração do status do contrato, será utilizado o mesmo método já existente no sistema.<br /> Apenas contratos HABILITADOS poderão ser impactados pela chave.<br /> Alteração para a funcionalidade de DESFAZER NEGOCIAÇÃO e não para cancelamento de negociação.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|''Extratos a contestar'']]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3564 2025-12-16T18:49:29Z

<p>Caio.silva: /* Status do contrato ao desfazer negociação */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ===Seleção de Integradora para Recorrência de Pix===<br /> <br /> Foi ajustado o fluxo de configuração da recorrência de Pix nas formas de cobrança.<br /> <br /> Anteriormente, ao marcar a flag “Utiliza recorrência de Pix” (campo UtilizaRecorrenciaPix na TB_FormaCobranca), não era possível selecionar a integradora Pix responsável pela recorrência, impedindo a configuração completa da funcionalidade.<br /> <br /> Com a correção, foi disponibilizada em tela a seleção da integradora de Pix, permitindo associar corretamente a forma de cobrança à integradora responsável. O valor configurado passa a ser buscado a partir do campo de integradora de remessa eletrônica, seguindo o mesmo padrão já utilizado em outros pontos do sistema.<br /> <br /> ===Download de XML de NFCOM Autorizada na Tela do Cliente===<br /> <br /> Foi implementado um novo botão na tela de notas fiscais do cliente que permite baixar o XML da NFCOM, desde que a nota esteja autorizada.<br /> <br /> Ao acionar o botão, o sistema disponibiliza o arquivo XML correspondente à nota fiscal, facilitando o acesso ao documento eletrônico diretamente pela interface do cliente.<br /> <br /> ===Status do contrato ao desfazer negociação===<br /> <br /> Descrição:<br /> Foi criada uma nova chave de configuração no módulo financeiro chamada STATUS_CONTRATO_NEGOCIACAO_DESFEITA.<br /> <br /> Essa chave recebe um IDStatusContrato e não possui preenchimento obrigatório.<br /> <br /> Funcionamento:<br /> <br /> Quando a chave estiver preenchida (exemplo: 5 = SUSPENSO), ao desfazer uma negociação, todos os contratos HABILITADOS vinculados a essa fatura de negociação terão seu status alterado para o status informado na chave.<br /> <br /> Caso a chave esteja null, o funcionamento atual do sistema será mantido, sem alteração de status dos contratos.<br /> <br /> Observações Técnicas:<br /> <br /> Para a alteração do status do contrato, será utilizado o mesmo método já existente no sistema.<br /> Apenas contratos HABILITADOS poderão ser impactados pela chave.<br /> Alteração para a funcionalidade de DESFAZER NEGOCIAÇÃO e não para cancelamento de negociação.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3563 2025-12-16T18:47:38Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ===Seleção de Integradora para Recorrência de Pix===<br /> <br /> Foi ajustado o fluxo de configuração da recorrência de Pix nas formas de cobrança.<br /> <br /> Anteriormente, ao marcar a flag “Utiliza recorrência de Pix” (campo UtilizaRecorrenciaPix na TB_FormaCobranca), não era possível selecionar a integradora Pix responsável pela recorrência, impedindo a configuração completa da funcionalidade.<br /> <br /> Com a correção, foi disponibilizada em tela a seleção da integradora de Pix, permitindo associar corretamente a forma de cobrança à integradora responsável. O valor configurado passa a ser buscado a partir do campo de integradora de remessa eletrônica, seguindo o mesmo padrão já utilizado em outros pontos do sistema.<br /> <br /> ===Download de XML de NFCOM Autorizada na Tela do Cliente===<br /> <br /> Foi implementado um novo botão na tela de notas fiscais do cliente que permite baixar o XML da NFCOM, desde que a nota esteja autorizada.<br /> <br /> Ao acionar o botão, o sistema disponibiliza o arquivo XML correspondente à nota fiscal, facilitando o acesso ao documento eletrônico diretamente pela interface do cliente.<br /> <br /> ===Status do contrato ao desfazer negociação===<br /> <br /> Descrição:<br /> Foi criada uma nova chave de configuração no módulo financeiro chamada STATUS_CONTRATO_NEGOCIACAO_DESFEITA.<br /> <br /> Essa chave recebe um IDStatusContrato e possui preenchimento não obrigatório.<br /> <br /> Funcionamento:<br /> <br /> Quando a chave estiver preenchida (exemplo: 5 = SUSPENSO), ao desfazer uma negociação, todos os contratos HABILITADOS vinculados a essa negociação terão seu status alterado para o status informado na chave.<br /> <br /> Caso a chave esteja null, o funcionamento atual do sistema será mantido, sem alteração de status dos contratos.<br /> <br /> Observações Técnicas:<br /> <br /> Para a alteração do status do contrato, será utilizado o mesmo método já existente no sistema, não sendo criada uma nova rotina para esse processo.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3562 2025-12-16T15:00:34Z

<p>Caio.silva: /* BUG - Duplicidade de contratos em processos de upgrade/downgrade */</p> <hr /> <div>==BUG - Duplicidade de contratos em processos de upgrade/downgrade==<br /> <br /> Erro identificado:<br /> No processo de upgrade/downgrade de contratos, era possível ocorrer a criação de dois ou mais contratos quando a ação era confirmada mais de uma vez pelo teclado (ENTER) nos modais do fluxo.<br /> Esse comportamento gerava duplicidade mesmo sem erros aparentes na execução, resultando em:<br /> <br /> Contratos duplicados ou triplicados para um único upgrade/downgrade<br /> <br /> Em alguns casos, contratos gerados sem todos os vínculos esperados (ex.: ausência de registro em log)<br /> <br /> Inconsistência de dados e necessidade de correções manuais<br /> <br /> O problema foi identificado como relacionado à confirmação repetida da ação via teclado, especialmente pelo uso contínuo da tecla ENTER.<br /> <br /> Correção aplicada:<br /> O fluxo de confirmação foi ajustado para impedir a continuidade do processo apenas com o uso da tecla ENTER, evitando múltiplas submissões da mesma ação.<br /> Com a correção:<br /> <br /> A confirmação via ENTER direto foi desabilitada nos modais do processo de upgrade/downgrade<br /> <br /> O usuário só consegue avançar conscientemente no fluxo, reduzindo o risco de múltiplas execuções<br /> <br /> Permanece possível avançar utilizando TAB + ENTER.<br /> <br /> ==BUG - Duplicidade de movimentação de materiais ao falhar fechamento de OS==<br /> <br /> Erro identificado:<br /> No app do técnico, ao executar uma OS do tipo Alteração de Endereço com movimentação de material, quando ocorria erro no fechamento da OS, o sistema realizava a movimentação dos materiais mesmo sem concluir o atendimento.<br /> Em novas tentativas de finalização, os mesmos materiais eram movimentados novamente, gerando duplicidade de registros na TB_Movimento (estoque).<br /> O problema ocorria porque a movimentação era executada antes da confirmação final da atualização do atendimento, fazendo com que falhas no fluxo não impedissem a gravação das movimentações.<br /> <br /> Correção aplicada:<br /> O fluxo de finalização da OS foi ajustado com a reordenação do método de conclusão do atendimento, garantindo que:<br /> <br /> A atualização do atendimento seja concluída primeiro<br /> <br /> A movimentação de materiais seja executada somente após o atendimento ser atualizado com sucesso<br /> <br /> Em caso de erro no fechamento da OS, nenhuma movimentação de material ou equipamento seja registrada<br /> <br /> Com a correção, o sistema evita movimentações duplicadas, garantindo consistência no estoque e integridade no processo de finalização das ordens de serviço.<br /> <br /> ==BUG - Erro e duplicidade no envio de imagens em OS no app do técnico==<br /> <br /> Erro identificado:<br /> No app do técnico, durante a execução de uma OS, ao anexar imagens ocorria erro no momento do envio. Em cenários com múltiplas imagens:<br /> <br /> Apenas parte das imagens era vinculada com sucesso<br /> <br /> Novas tentativas de envio resultavam em duplicidade de registros na TB_AtendimentoDocumento<br /> <br /> O processo falhava devido a deadlock no banco de dados, causado por múltiplas inserções concorrentes durante o envio unitário das imagens<br /> <br /> Esse comportamento comprometia a finalização da OS e gerava inconsistência nos anexos vinculados ao atendimento.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes tanto no app quanto no comercial para garantir consistência e evitar duplicidades:<br /> <br /> No app, o método de envio de imagens foi reescrito para envio em lotes, limitando o processamento a até 6 imagens por vez, reduzindo concorrência e risco de deadlock.<br /> <br /> No comercial, foi criada uma tratativa para não persistir nenhuma imagem no banco caso ocorra erro no processamento, evitando gravações parciais e duplicadas.<br /> <br /> Com esses ajustes, o envio de imagens passou a ser transacional e consistente, garantindo que as imagens sejam anexadas corretamente ou não persistidas em caso de falha.<br /> <br /> ==BUG - Erro ao alterar o estado no cadastro de cidade==<br /> <br /> Erro identificado:<br /> Na tela de cadastro de cidades, ao alterar o estado (UF) de uma cidade já cadastrada e tentar salvar, o sistema retornava erro de NullPointerException, impedindo a conclusão da edição.<br /> O problema ocorria de forma consistente, inclusive em cidades sem vínculos, em diferentes bases e ambientes, indicando falha no tratamento da alteração do estado durante o salvamento.<br /> <br /> Esse comportamento gerava incerteza ao usuário, pois o sistema não informava claramente se a alteração era inválida por regra ou se se tratava de erro técnico.<br /> <br /> Correção aplicada:<br /> O fluxo de salvamento do cadastro de cidades foi ajustado para tratar corretamente a alteração do estado, evitando a ocorrência de exceção durante o processo.<br /> Além disso, foi implementado tratamento adequado para o cenário, garantindo que:<br /> <br /> A alteração seja processada corretamente quando permitida<br /> <br /> Ou, caso a regra não permita a mudança de estado para cidades já cadastradas, o sistema apresente uma mensagem clara e orientativa ao usuário, em vez de erro técnico<br /> <br /> Com o ajuste, o cadastro de cidades passa a ter comportamento previsível e estável ao editar o estado.<br /> <br /> ==BUG - Alteração de titularidade de pacote gerando erro de integração e migração parcial de contratos==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade de pacotes com planos de TV, foram identificadas falhas que causavam inconsistência na migração dos contratos e erros de integração.<br /> <br /> Os principais problemas observados eram:<br /> <br /> A requisição de integração era enviada mais de uma vez durante a alteração de titularidade, ocasionando erro por duplicidade de cadastro (ex.: e-mail já registrado).<br /> <br /> Em caso de erro retornado pela integração, o sistema migrava apenas parte dos contratos do pacote para o novo titular, mantendo outros contratos vinculados ao titular anterior.<br /> <br /> Em cenários de alteração de pacote, contratos de TV cancelados no sistema não tinham o cancelamento enviado à plataforma externa, fazendo com que o serviço permanecesse ativo externamente.<br /> <br /> Esse comportamento resultava em pacotes com contratos vinculados a dois titulares diferentes, além de impedir vendas ou alterações futuras devido a serviços ainda ativos na plataforma.<br /> <br /> Esse conjunto de falhas comprometia a integridade do processo de alteração de titularidade e a consistência entre o sistema e a plataforma integrada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade e alteração de pacote foi ajustado para garantir que:<br /> <br /> As requisições de integração sejam executadas apenas uma vez, evitando envios duplicados.<br /> <br /> Em caso de qualquer erro durante a integração, nenhum contrato do pacote seja migrado, mantendo o pacote íntegro no titular original.<br /> <br /> Sempre que um contrato de TV for cancelado em decorrência de alteração de pacote, seja chamada corretamente a ação de cancelamento na integração, assim como ocorre no cancelamento padrão.<br /> <br /> A migração de pacotes ocorra de forma atômica, impedindo que contratos fiquem distribuídos entre titulares diferentes.<br /> <br /> Com a correção, a alteração de titularidade e de pacotes passa a ocorrer de forma consistente, mantendo alinhamento entre os contratos no sistema e os serviços ativos na plataforma integrada.<br /> <br /> ==BUG - Histórico da Integração PlayHub exibindo logs de outros clientes==<br /> <br /> Erro identificado:<br /> Na tela Comercial &gt; Clientes &gt; Histórico &gt; Integrações &gt; Integração PlayHub, a consulta retornava todos os registros da TB_LogIntegracaoPlayHub, incluindo logs de outros clientes, independentemente do cliente selecionado.<br /> Esse comportamento causava:<br /> <br /> Exibição incorreta do histórico de integrações<br /> <br /> Grande volume de registros retornados<br /> <br /> Erros de carregamento na tela em cenários com muitos dados<br /> <br /> A consulta não estava utilizando corretamente o vínculo entre IDContrato e IDCliente para restringir os resultados ao cliente em questão.<br /> <br /> Correção aplicada:<br /> A consulta do histórico foi ajustada para filtrar os registros exclusivamente pelo cliente selecionado, utilizando o relacionamento entre IDContrato e IDCliente.<br /> Com isso, a tela passa a exibir apenas os logs de integração PlayHub relacionados ao cliente consultado, reduzindo o volume de dados, evitando erros de carregamento e garantindo a correta visualização do histórico.<br /> <br /> ==BUG - Duplicidade de registros na TB_InformacaoAdicionalFatura ao gerar remessa==<br /> <br /> Erro identificado:<br /> Foi identificado um problema no fluxo de geração de linha digitável e remessa, onde uma mesma fatura podia gerar dois registros distintos na TB_InformacaoAdicionalFatura.<br /> O cenário ocorria quando:<br /> <br /> A fatura era gerada e a rotina de linha digitável criava o primeiro registro na TB_InformacaoAdicionalFatura.<br /> <br /> Posteriormente, ao gerar a remessa eletrônica (com Pix), o sistema realizava um INSERT de um novo registro para o mesmo IDFatura, em vez de atualizar o registro já existente.<br /> <br /> Esse comportamento causava duplicidade de dados, além de erros em chamadas da stored procedure spuAtualizaRemessaFatura, incluindo falhas de sintaxe SQL em produção após ajustes manuais.<br /> <br /> Correção aplicada:<br /> A lógica da spuAtualizaRemessaFatura foi corrigida para garantir que:<br /> <br /> Quando já existir um registro para o IDFatura na TB_InformacaoAdicionalFatura, o sistema realize UPDATE do registro existente.<br /> <br /> A operação de INSERT ocorra apenas quando não houver registro prévio para a fatura.<br /> <br /> A stored procedure corrigida foi validada em ambiente de homologação e ajustada para evitar erros de sintaxe ao atualizar campos como ChavePix, linha digitável e demais informações retornadas pela remessa.<br /> Com a correção, o fluxo passa a manter apenas um único registro por fatura, garantindo integridade dos dados e estabilidade no processo de geração de remessa e Pix.<br /> <br /> ==BUG - Desconto superior ao valor do extrato na contestação de faturas==<br /> <br /> Erro identificado:<br /> Na tela de Contestação de Faturas, o sistema permitia aplicar um desconto maior que o valor original do extrato. Como consequência, o extrato gerado passava a ter valor negativo, ocasionando erros em etapas posteriores do fluxo, como na geração de notas fiscais.<br /> <br /> Correção aplicada:<br /> Foi implementada uma validação no momento da aplicação do desconto, impedindo que o valor final do extrato seja menor que zero.<br /> Com o ajuste, o sistema permite que o extrato resultante seja igual a 0, porém nunca negativo, garantindo a integridade dos dados e evitando falhas nos processos subsequentes.<br /> <br /> ==BUG - Bloqueio indevido na edição de endereço de contratos em pacote==<br /> <br /> Erro identificado:<br /> Na tela Cliente &gt; Dados pessoais &gt; Endereço, ao iniciar a edição do endereço e optar por “Não” no modal “Deseja apenas corrigir algum erro no cadastro deste endereço?”, o sistema exibia a mensagem “Todos os componentes de um pacote precisam ser selecionados.”, impedindo a continuidade do processo.<br /> O bloqueio ocorria mesmo quando todos os contratos do pacote estavam selecionados, devido a uma validação que comparava a quantidade de planos cadastrados no pacote (que pode mudar ao longo do tempo) com os contratos efetivamente vendidos, gerando inconsistência e travando a edição.<br /> <br /> Esse comportamento afetava pacotes que tiveram alterações posteriores em sua composição, impossibilitando a edição de endereço de contratos vendidos anteriormente.<br /> <br /> Correção aplicada:<br /> A validação do modal foi ajustada para, em casos de pacotes, verificar apenas se todos os contratos vinculados ao mesmo IDContratoPacote foram selecionados, independentemente da quantidade atual de planos cadastrados no pacote.<br /> Com isso, a edição de endereço passa a funcionar corretamente para contratos de pacote, evitando bloqueios indevidos e mantendo o comportamento esperado para contratos que não pertencem a pacotes.<br /> <br /> ==BUG - Refidelização incorreta na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao selecionar “SIM” para refidelizar, a nova fidelidade não estava sendo aplicada corretamente para contratos individuais e pacotes.<br /> Mesmo com a chave FIDELIZACAO_CONTRATOS_FIXA = 1 e sem a permissão de fidelização livre, o sistema não definia a fidelidade para 12 meses a partir da data da alteração, conforme o fluxo esperado. Com isso, as datas de início e vencimento da fidelidade ficavam incorretas.<br /> <br /> Correção aplicada:<br /> O fluxo foi ajustado para que, quando FIDELIZACAO_CONTRATOS_FIXA = 1, ao optar por refidelizar:<br /> <br /> DataInicioFidelidade seja definida como a data/hora da alteração de titularidade<br /> <br /> DataVencimentoFidelidade seja definida para 12 meses após a data de início<br /> <br /> Quando FIDELIZACAO_CONTRATOS_FIXA = 0, o comportamento permanece inalterado, mantendo o fluxo atual.<br /> <br /> ==BUG - Remessa eletrônica não gerada para faturas criadas por contestação==<br /> <br /> Erro identificado:<br /> As faturas geradas por meio de contestação, quando vinculadas a formas de cobrança eletrônica, não estavam tendo a remessa eletrônica gerada automaticamente.<br /> Esse comportamento divergia do fluxo esperado e do padrão já aplicado a outros cenários, como a geração de faturas via negociação, onde a remessa eletrônica é criada de forma automática.<br /> <br /> A inconsistência fazia com que faturas válidas ficassem sem remessa, impactando o processo de cobrança eletrônica.<br /> <br /> Correção aplicada:<br /> O fluxo de geração de faturas por contestação foi ajustado para que, quando a forma de cobrança for eletrônica, a remessa eletrônica seja gerada automaticamente, seguindo o mesmo comportamento já adotado para faturas criadas via negociação.<br /> <br /> Com a correção, o sistema passa a manter padronização no processo de cobrança eletrônica, independentemente da origem da fatura.<br /> <br /> ==BUG - Falha na criação de location para Pix recorrente por limite de descrição==<br /> <br /> Erro identificado:<br /> No fluxo de Pix recorrente, a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX não estava sendo executada em determinados cenários. A causa foi identificada no conteúdo enviado no campo de descrição do plano, que excedia o limite de 35 caracteres exigido pela ação responsável pelo cadastro da autorização de débito recorrente via QR Code.<br /> Como a mesma descrição era reutilizada por outras integrações, o excesso de caracteres impedia a execução correta da ação, resultando na não geração do location para o Pix recorrente.<br /> <br /> Correção aplicada:<br /> Foi criada a chave DESCRICAO_PLANO_LIMIT, que garante o envio da descrição do plano limitada a até 35 caracteres, atendendo ao requisito da ação de Pix recorrente.<br /> Com o ajuste, a geração de location passa a ocorrer corretamente apenas quando a ação de cadastro de autorização de débito recorrente via QR Code é executada, sem impacto nas demais integrações que utilizam a descrição completa.<br /> <br /> ==BUG - Filtro não retornando registros na primeira página da aba Notas==<br /> <br /> Erro identificado:<br /> Na tela Financeiro &gt; Integração &gt; Aba NOTAS, ao aplicar determinados filtros, os registros não eram exibidos na primeira página, mesmo havendo resultados válidos.<br /> No cenário identificado, ao filtrar pelo Modelo de NF, o sistema indicava a existência de milhares de registros, porém a primeira página era carregada vazia. Os dados só passavam a aparecer ao navegar para a última página ou páginas intermediárias, caracterizando falha na paginação associada ao filtro.<br /> <br /> Esse comportamento causava confusão ao usuário, dando a impressão de que o filtro não havia retornado resultados.<br /> <br /> Correção aplicada:<br /> O mecanismo de paginação com filtros foi ajustado para garantir que, sempre que o filtro aplicado possuir registros válidos, os resultados sejam exibidos corretamente a partir da primeira página.<br /> Com a correção, a navegação entre páginas mantém consistência e os registros filtrados passam a ser apresentados de forma adequada desde o carregamento inicial.<br /> <br /> ==BUG - Rotina habilitando contrato já cancelado==<br /> <br /> Erro identificado:<br /> Foi identificado um cenário em que a rotina de habilitação alterava o status de um contrato que havia sido cancelado durante a execução da própria rotina.<br /> O contrato era corretamente selecionado no início da execução por estar com status “HABILITADO EM CONFIANÇA”, porém, antes da atualização final do status pela rotina, o usuário realizou a alteração manual para CANCELADO. Mesmo assim, a rotina prosseguiu e reverteu o status de CANCELADO para HABILITADO, gerando inconsistência no estado do contrato.<br /> <br /> Correção aplicada:<br /> O endpoint utilizado pela rotina foi ajustado para validar novamente o status do contrato no momento da atualização, considerando apenas contratos que não estejam com status CANCELADO.<br /> Com esse ajuste, a rotina não altera contratos que tenham sido cancelados durante sua execução, evitando reativações indevidas e garantindo a integridade do status do contrato.<br /> <br /> ==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> ==BUG - Duplicação de endereço do cliente na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3561 2025-12-16T14:59:11Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Duplicidade de contratos em processos de upgrade/downgrade==<br /> <br /> Erro identificado:<br /> No processo de upgrade/downgrade de contratos, era possível ocorrer a criação de dois ou mais contratos quando a ação era confirmada mais de uma vez pelo teclado (ENTER) nos modais do fluxo.<br /> Esse comportamento gerava duplicidade mesmo sem erros aparentes na execução, resultando em:<br /> <br /> Contratos duplicados ou triplicados para um único upgrade/downgrade<br /> <br /> Em alguns casos, contratos gerados sem todos os vínculos esperados (ex.: ausência de registro em log)<br /> <br /> Inconsistência de dados e necessidade de correções manuais<br /> <br /> O problema foi identificado como relacionado à confirmação repetida da ação via teclado, especialmente pelo uso contínuo da tecla ENTER.<br /> <br /> Correção aplicada:<br /> O fluxo de confirmação foi ajustado para impedir a continuidade do processo apenas com o uso da tecla ENTER, evitando múltiplas submissões da mesma ação.<br /> Com a correção:<br /> <br /> A confirmação via ENTER direto foi desabilitada nos modais do processo de upgrade/downgrade<br /> <br /> O usuário só consegue avançar conscientemente no fluxo, reduzindo o risco de múltiplas execuções<br /> <br /> Permanece possível avançar utilizando TAB + ENTER, mantendo acessibilidade sem permitir duplicidade<br /> <br /> Após o ajuste, o comportamento foi validado em homologação, eliminando os cenários de duplicação de contratos durante upgrade ou downgrade.<br /> <br /> ==BUG - Duplicidade de movimentação de materiais ao falhar fechamento de OS==<br /> <br /> Erro identificado:<br /> No app do técnico, ao executar uma OS do tipo Alteração de Endereço com movimentação de material, quando ocorria erro no fechamento da OS, o sistema realizava a movimentação dos materiais mesmo sem concluir o atendimento.<br /> Em novas tentativas de finalização, os mesmos materiais eram movimentados novamente, gerando duplicidade de registros na TB_Movimento (estoque).<br /> O problema ocorria porque a movimentação era executada antes da confirmação final da atualização do atendimento, fazendo com que falhas no fluxo não impedissem a gravação das movimentações.<br /> <br /> Correção aplicada:<br /> O fluxo de finalização da OS foi ajustado com a reordenação do método de conclusão do atendimento, garantindo que:<br /> <br /> A atualização do atendimento seja concluída primeiro<br /> <br /> A movimentação de materiais seja executada somente após o atendimento ser atualizado com sucesso<br /> <br /> Em caso de erro no fechamento da OS, nenhuma movimentação de material ou equipamento seja registrada<br /> <br /> Com a correção, o sistema evita movimentações duplicadas, garantindo consistência no estoque e integridade no processo de finalização das ordens de serviço.<br /> <br /> ==BUG - Erro e duplicidade no envio de imagens em OS no app do técnico==<br /> <br /> Erro identificado:<br /> No app do técnico, durante a execução de uma OS, ao anexar imagens ocorria erro no momento do envio. Em cenários com múltiplas imagens:<br /> <br /> Apenas parte das imagens era vinculada com sucesso<br /> <br /> Novas tentativas de envio resultavam em duplicidade de registros na TB_AtendimentoDocumento<br /> <br /> O processo falhava devido a deadlock no banco de dados, causado por múltiplas inserções concorrentes durante o envio unitário das imagens<br /> <br /> Esse comportamento comprometia a finalização da OS e gerava inconsistência nos anexos vinculados ao atendimento.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes tanto no app quanto no comercial para garantir consistência e evitar duplicidades:<br /> <br /> No app, o método de envio de imagens foi reescrito para envio em lotes, limitando o processamento a até 6 imagens por vez, reduzindo concorrência e risco de deadlock.<br /> <br /> No comercial, foi criada uma tratativa para não persistir nenhuma imagem no banco caso ocorra erro no processamento, evitando gravações parciais e duplicadas.<br /> <br /> Com esses ajustes, o envio de imagens passou a ser transacional e consistente, garantindo que as imagens sejam anexadas corretamente ou não persistidas em caso de falha.<br /> <br /> ==BUG - Erro ao alterar o estado no cadastro de cidade==<br /> <br /> Erro identificado:<br /> Na tela de cadastro de cidades, ao alterar o estado (UF) de uma cidade já cadastrada e tentar salvar, o sistema retornava erro de NullPointerException, impedindo a conclusão da edição.<br /> O problema ocorria de forma consistente, inclusive em cidades sem vínculos, em diferentes bases e ambientes, indicando falha no tratamento da alteração do estado durante o salvamento.<br /> <br /> Esse comportamento gerava incerteza ao usuário, pois o sistema não informava claramente se a alteração era inválida por regra ou se se tratava de erro técnico.<br /> <br /> Correção aplicada:<br /> O fluxo de salvamento do cadastro de cidades foi ajustado para tratar corretamente a alteração do estado, evitando a ocorrência de exceção durante o processo.<br /> Além disso, foi implementado tratamento adequado para o cenário, garantindo que:<br /> <br /> A alteração seja processada corretamente quando permitida<br /> <br /> Ou, caso a regra não permita a mudança de estado para cidades já cadastradas, o sistema apresente uma mensagem clara e orientativa ao usuário, em vez de erro técnico<br /> <br /> Com o ajuste, o cadastro de cidades passa a ter comportamento previsível e estável ao editar o estado.<br /> <br /> ==BUG - Alteração de titularidade de pacote gerando erro de integração e migração parcial de contratos==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade de pacotes com planos de TV, foram identificadas falhas que causavam inconsistência na migração dos contratos e erros de integração.<br /> <br /> Os principais problemas observados eram:<br /> <br /> A requisição de integração era enviada mais de uma vez durante a alteração de titularidade, ocasionando erro por duplicidade de cadastro (ex.: e-mail já registrado).<br /> <br /> Em caso de erro retornado pela integração, o sistema migrava apenas parte dos contratos do pacote para o novo titular, mantendo outros contratos vinculados ao titular anterior.<br /> <br /> Em cenários de alteração de pacote, contratos de TV cancelados no sistema não tinham o cancelamento enviado à plataforma externa, fazendo com que o serviço permanecesse ativo externamente.<br /> <br /> Esse comportamento resultava em pacotes com contratos vinculados a dois titulares diferentes, além de impedir vendas ou alterações futuras devido a serviços ainda ativos na plataforma.<br /> <br /> Esse conjunto de falhas comprometia a integridade do processo de alteração de titularidade e a consistência entre o sistema e a plataforma integrada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade e alteração de pacote foi ajustado para garantir que:<br /> <br /> As requisições de integração sejam executadas apenas uma vez, evitando envios duplicados.<br /> <br /> Em caso de qualquer erro durante a integração, nenhum contrato do pacote seja migrado, mantendo o pacote íntegro no titular original.<br /> <br /> Sempre que um contrato de TV for cancelado em decorrência de alteração de pacote, seja chamada corretamente a ação de cancelamento na integração, assim como ocorre no cancelamento padrão.<br /> <br /> A migração de pacotes ocorra de forma atômica, impedindo que contratos fiquem distribuídos entre titulares diferentes.<br /> <br /> Com a correção, a alteração de titularidade e de pacotes passa a ocorrer de forma consistente, mantendo alinhamento entre os contratos no sistema e os serviços ativos na plataforma integrada.<br /> <br /> ==BUG - Histórico da Integração PlayHub exibindo logs de outros clientes==<br /> <br /> Erro identificado:<br /> Na tela Comercial &gt; Clientes &gt; Histórico &gt; Integrações &gt; Integração PlayHub, a consulta retornava todos os registros da TB_LogIntegracaoPlayHub, incluindo logs de outros clientes, independentemente do cliente selecionado.<br /> Esse comportamento causava:<br /> <br /> Exibição incorreta do histórico de integrações<br /> <br /> Grande volume de registros retornados<br /> <br /> Erros de carregamento na tela em cenários com muitos dados<br /> <br /> A consulta não estava utilizando corretamente o vínculo entre IDContrato e IDCliente para restringir os resultados ao cliente em questão.<br /> <br /> Correção aplicada:<br /> A consulta do histórico foi ajustada para filtrar os registros exclusivamente pelo cliente selecionado, utilizando o relacionamento entre IDContrato e IDCliente.<br /> Com isso, a tela passa a exibir apenas os logs de integração PlayHub relacionados ao cliente consultado, reduzindo o volume de dados, evitando erros de carregamento e garantindo a correta visualização do histórico.<br /> <br /> ==BUG - Duplicidade de registros na TB_InformacaoAdicionalFatura ao gerar remessa==<br /> <br /> Erro identificado:<br /> Foi identificado um problema no fluxo de geração de linha digitável e remessa, onde uma mesma fatura podia gerar dois registros distintos na TB_InformacaoAdicionalFatura.<br /> O cenário ocorria quando:<br /> <br /> A fatura era gerada e a rotina de linha digitável criava o primeiro registro na TB_InformacaoAdicionalFatura.<br /> <br /> Posteriormente, ao gerar a remessa eletrônica (com Pix), o sistema realizava um INSERT de um novo registro para o mesmo IDFatura, em vez de atualizar o registro já existente.<br /> <br /> Esse comportamento causava duplicidade de dados, além de erros em chamadas da stored procedure spuAtualizaRemessaFatura, incluindo falhas de sintaxe SQL em produção após ajustes manuais.<br /> <br /> Correção aplicada:<br /> A lógica da spuAtualizaRemessaFatura foi corrigida para garantir que:<br /> <br /> Quando já existir um registro para o IDFatura na TB_InformacaoAdicionalFatura, o sistema realize UPDATE do registro existente.<br /> <br /> A operação de INSERT ocorra apenas quando não houver registro prévio para a fatura.<br /> <br /> A stored procedure corrigida foi validada em ambiente de homologação e ajustada para evitar erros de sintaxe ao atualizar campos como ChavePix, linha digitável e demais informações retornadas pela remessa.<br /> Com a correção, o fluxo passa a manter apenas um único registro por fatura, garantindo integridade dos dados e estabilidade no processo de geração de remessa e Pix.<br /> <br /> ==BUG - Desconto superior ao valor do extrato na contestação de faturas==<br /> <br /> Erro identificado:<br /> Na tela de Contestação de Faturas, o sistema permitia aplicar um desconto maior que o valor original do extrato. Como consequência, o extrato gerado passava a ter valor negativo, ocasionando erros em etapas posteriores do fluxo, como na geração de notas fiscais.<br /> <br /> Correção aplicada:<br /> Foi implementada uma validação no momento da aplicação do desconto, impedindo que o valor final do extrato seja menor que zero.<br /> Com o ajuste, o sistema permite que o extrato resultante seja igual a 0, porém nunca negativo, garantindo a integridade dos dados e evitando falhas nos processos subsequentes.<br /> <br /> ==BUG - Bloqueio indevido na edição de endereço de contratos em pacote==<br /> <br /> Erro identificado:<br /> Na tela Cliente &gt; Dados pessoais &gt; Endereço, ao iniciar a edição do endereço e optar por “Não” no modal “Deseja apenas corrigir algum erro no cadastro deste endereço?”, o sistema exibia a mensagem “Todos os componentes de um pacote precisam ser selecionados.”, impedindo a continuidade do processo.<br /> O bloqueio ocorria mesmo quando todos os contratos do pacote estavam selecionados, devido a uma validação que comparava a quantidade de planos cadastrados no pacote (que pode mudar ao longo do tempo) com os contratos efetivamente vendidos, gerando inconsistência e travando a edição.<br /> <br /> Esse comportamento afetava pacotes que tiveram alterações posteriores em sua composição, impossibilitando a edição de endereço de contratos vendidos anteriormente.<br /> <br /> Correção aplicada:<br /> A validação do modal foi ajustada para, em casos de pacotes, verificar apenas se todos os contratos vinculados ao mesmo IDContratoPacote foram selecionados, independentemente da quantidade atual de planos cadastrados no pacote.<br /> Com isso, a edição de endereço passa a funcionar corretamente para contratos de pacote, evitando bloqueios indevidos e mantendo o comportamento esperado para contratos que não pertencem a pacotes.<br /> <br /> ==BUG - Refidelização incorreta na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao selecionar “SIM” para refidelizar, a nova fidelidade não estava sendo aplicada corretamente para contratos individuais e pacotes.<br /> Mesmo com a chave FIDELIZACAO_CONTRATOS_FIXA = 1 e sem a permissão de fidelização livre, o sistema não definia a fidelidade para 12 meses a partir da data da alteração, conforme o fluxo esperado. Com isso, as datas de início e vencimento da fidelidade ficavam incorretas.<br /> <br /> Correção aplicada:<br /> O fluxo foi ajustado para que, quando FIDELIZACAO_CONTRATOS_FIXA = 1, ao optar por refidelizar:<br /> <br /> DataInicioFidelidade seja definida como a data/hora da alteração de titularidade<br /> <br /> DataVencimentoFidelidade seja definida para 12 meses após a data de início<br /> <br /> Quando FIDELIZACAO_CONTRATOS_FIXA = 0, o comportamento permanece inalterado, mantendo o fluxo atual.<br /> <br /> ==BUG - Remessa eletrônica não gerada para faturas criadas por contestação==<br /> <br /> Erro identificado:<br /> As faturas geradas por meio de contestação, quando vinculadas a formas de cobrança eletrônica, não estavam tendo a remessa eletrônica gerada automaticamente.<br /> Esse comportamento divergia do fluxo esperado e do padrão já aplicado a outros cenários, como a geração de faturas via negociação, onde a remessa eletrônica é criada de forma automática.<br /> <br /> A inconsistência fazia com que faturas válidas ficassem sem remessa, impactando o processo de cobrança eletrônica.<br /> <br /> Correção aplicada:<br /> O fluxo de geração de faturas por contestação foi ajustado para que, quando a forma de cobrança for eletrônica, a remessa eletrônica seja gerada automaticamente, seguindo o mesmo comportamento já adotado para faturas criadas via negociação.<br /> <br /> Com a correção, o sistema passa a manter padronização no processo de cobrança eletrônica, independentemente da origem da fatura.<br /> <br /> ==BUG - Falha na criação de location para Pix recorrente por limite de descrição==<br /> <br /> Erro identificado:<br /> No fluxo de Pix recorrente, a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX não estava sendo executada em determinados cenários. A causa foi identificada no conteúdo enviado no campo de descrição do plano, que excedia o limite de 35 caracteres exigido pela ação responsável pelo cadastro da autorização de débito recorrente via QR Code.<br /> Como a mesma descrição era reutilizada por outras integrações, o excesso de caracteres impedia a execução correta da ação, resultando na não geração do location para o Pix recorrente.<br /> <br /> Correção aplicada:<br /> Foi criada a chave DESCRICAO_PLANO_LIMIT, que garante o envio da descrição do plano limitada a até 35 caracteres, atendendo ao requisito da ação de Pix recorrente.<br /> Com o ajuste, a geração de location passa a ocorrer corretamente apenas quando a ação de cadastro de autorização de débito recorrente via QR Code é executada, sem impacto nas demais integrações que utilizam a descrição completa.<br /> <br /> ==BUG - Filtro não retornando registros na primeira página da aba Notas==<br /> <br /> Erro identificado:<br /> Na tela Financeiro &gt; Integração &gt; Aba NOTAS, ao aplicar determinados filtros, os registros não eram exibidos na primeira página, mesmo havendo resultados válidos.<br /> No cenário identificado, ao filtrar pelo Modelo de NF, o sistema indicava a existência de milhares de registros, porém a primeira página era carregada vazia. Os dados só passavam a aparecer ao navegar para a última página ou páginas intermediárias, caracterizando falha na paginação associada ao filtro.<br /> <br /> Esse comportamento causava confusão ao usuário, dando a impressão de que o filtro não havia retornado resultados.<br /> <br /> Correção aplicada:<br /> O mecanismo de paginação com filtros foi ajustado para garantir que, sempre que o filtro aplicado possuir registros válidos, os resultados sejam exibidos corretamente a partir da primeira página.<br /> Com a correção, a navegação entre páginas mantém consistência e os registros filtrados passam a ser apresentados de forma adequada desde o carregamento inicial.<br /> <br /> ==BUG - Rotina habilitando contrato já cancelado==<br /> <br /> Erro identificado:<br /> Foi identificado um cenário em que a rotina de habilitação alterava o status de um contrato que havia sido cancelado durante a execução da própria rotina.<br /> O contrato era corretamente selecionado no início da execução por estar com status “HABILITADO EM CONFIANÇA”, porém, antes da atualização final do status pela rotina, o usuário realizou a alteração manual para CANCELADO. Mesmo assim, a rotina prosseguiu e reverteu o status de CANCELADO para HABILITADO, gerando inconsistência no estado do contrato.<br /> <br /> Correção aplicada:<br /> O endpoint utilizado pela rotina foi ajustado para validar novamente o status do contrato no momento da atualização, considerando apenas contratos que não estejam com status CANCELADO.<br /> Com esse ajuste, a rotina não altera contratos que tenham sido cancelados durante sua execução, evitando reativações indevidas e garantindo a integridade do status do contrato.<br /> <br /> ==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> ==BUG - Duplicação de endereço do cliente na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3560 2025-12-16T14:55:41Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Alteração de titularidade de pacote gerando erro de integração e migração parcial de contratos==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade de pacotes com planos de TV, foram identificadas falhas que causavam inconsistência na migração dos contratos e erros de integração.<br /> <br /> Os principais problemas observados eram:<br /> <br /> A requisição de integração era enviada mais de uma vez durante a alteração de titularidade, ocasionando erro por duplicidade de cadastro (ex.: e-mail já registrado).<br /> <br /> Em caso de erro retornado pela integração, o sistema migrava apenas parte dos contratos do pacote para o novo titular, mantendo outros contratos vinculados ao titular anterior.<br /> <br /> Em cenários de alteração de pacote, contratos de TV cancelados no sistema não tinham o cancelamento enviado à plataforma externa, fazendo com que o serviço permanecesse ativo externamente.<br /> <br /> Esse comportamento resultava em pacotes com contratos vinculados a dois titulares diferentes, além de impedir vendas ou alterações futuras devido a serviços ainda ativos na plataforma.<br /> <br /> Esse conjunto de falhas comprometia a integridade do processo de alteração de titularidade e a consistência entre o sistema e a plataforma integrada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade e alteração de pacote foi ajustado para garantir que:<br /> <br /> As requisições de integração sejam executadas apenas uma vez, evitando envios duplicados.<br /> <br /> Em caso de qualquer erro durante a integração, nenhum contrato do pacote seja migrado, mantendo o pacote íntegro no titular original.<br /> <br /> Sempre que um contrato de TV for cancelado em decorrência de alteração de pacote, seja chamada corretamente a ação de cancelamento na integração, assim como ocorre no cancelamento padrão.<br /> <br /> A migração de pacotes ocorra de forma atômica, impedindo que contratos fiquem distribuídos entre titulares diferentes.<br /> <br /> Com a correção, a alteração de titularidade e de pacotes passa a ocorrer de forma consistente, mantendo alinhamento entre os contratos no sistema e os serviços ativos na plataforma integrada.<br /> <br /> ==BUG - Histórico da Integração PlayHub exibindo logs de outros clientes==<br /> <br /> Erro identificado:<br /> Na tela Comercial &gt; Clientes &gt; Histórico &gt; Integrações &gt; Integração PlayHub, a consulta retornava todos os registros da TB_LogIntegracaoPlayHub, incluindo logs de outros clientes, independentemente do cliente selecionado.<br /> Esse comportamento causava:<br /> <br /> Exibição incorreta do histórico de integrações<br /> <br /> Grande volume de registros retornados<br /> <br /> Erros de carregamento na tela em cenários com muitos dados<br /> <br /> A consulta não estava utilizando corretamente o vínculo entre IDContrato e IDCliente para restringir os resultados ao cliente em questão.<br /> <br /> Correção aplicada:<br /> A consulta do histórico foi ajustada para filtrar os registros exclusivamente pelo cliente selecionado, utilizando o relacionamento entre IDContrato e IDCliente.<br /> Com isso, a tela passa a exibir apenas os logs de integração PlayHub relacionados ao cliente consultado, reduzindo o volume de dados, evitando erros de carregamento e garantindo a correta visualização do histórico.<br /> <br /> ==BUG - Duplicidade de registros na TB_InformacaoAdicionalFatura ao gerar remessa==<br /> <br /> Erro identificado:<br /> Foi identificado um problema no fluxo de geração de linha digitável e remessa, onde uma mesma fatura podia gerar dois registros distintos na TB_InformacaoAdicionalFatura.<br /> O cenário ocorria quando:<br /> <br /> A fatura era gerada e a rotina de linha digitável criava o primeiro registro na TB_InformacaoAdicionalFatura.<br /> <br /> Posteriormente, ao gerar a remessa eletrônica (com Pix), o sistema realizava um INSERT de um novo registro para o mesmo IDFatura, em vez de atualizar o registro já existente.<br /> <br /> Esse comportamento causava duplicidade de dados, além de erros em chamadas da stored procedure spuAtualizaRemessaFatura, incluindo falhas de sintaxe SQL em produção após ajustes manuais.<br /> <br /> Correção aplicada:<br /> A lógica da spuAtualizaRemessaFatura foi corrigida para garantir que:<br /> <br /> Quando já existir um registro para o IDFatura na TB_InformacaoAdicionalFatura, o sistema realize UPDATE do registro existente.<br /> <br /> A operação de INSERT ocorra apenas quando não houver registro prévio para a fatura.<br /> <br /> A stored procedure corrigida foi validada em ambiente de homologação e ajustada para evitar erros de sintaxe ao atualizar campos como ChavePix, linha digitável e demais informações retornadas pela remessa.<br /> Com a correção, o fluxo passa a manter apenas um único registro por fatura, garantindo integridade dos dados e estabilidade no processo de geração de remessa e Pix.<br /> <br /> ==BUG - Desconto superior ao valor do extrato na contestação de faturas==<br /> <br /> Erro identificado:<br /> Na tela de Contestação de Faturas, o sistema permitia aplicar um desconto maior que o valor original do extrato. Como consequência, o extrato gerado passava a ter valor negativo, ocasionando erros em etapas posteriores do fluxo, como na geração de notas fiscais.<br /> <br /> Correção aplicada:<br /> Foi implementada uma validação no momento da aplicação do desconto, impedindo que o valor final do extrato seja menor que zero.<br /> Com o ajuste, o sistema permite que o extrato resultante seja igual a 0, porém nunca negativo, garantindo a integridade dos dados e evitando falhas nos processos subsequentes.<br /> <br /> ==BUG - Bloqueio indevido na edição de endereço de contratos em pacote==<br /> <br /> Erro identificado:<br /> Na tela Cliente &gt; Dados pessoais &gt; Endereço, ao iniciar a edição do endereço e optar por “Não” no modal “Deseja apenas corrigir algum erro no cadastro deste endereço?”, o sistema exibia a mensagem “Todos os componentes de um pacote precisam ser selecionados.”, impedindo a continuidade do processo.<br /> O bloqueio ocorria mesmo quando todos os contratos do pacote estavam selecionados, devido a uma validação que comparava a quantidade de planos cadastrados no pacote (que pode mudar ao longo do tempo) com os contratos efetivamente vendidos, gerando inconsistência e travando a edição.<br /> <br /> Esse comportamento afetava pacotes que tiveram alterações posteriores em sua composição, impossibilitando a edição de endereço de contratos vendidos anteriormente.<br /> <br /> Correção aplicada:<br /> A validação do modal foi ajustada para, em casos de pacotes, verificar apenas se todos os contratos vinculados ao mesmo IDContratoPacote foram selecionados, independentemente da quantidade atual de planos cadastrados no pacote.<br /> Com isso, a edição de endereço passa a funcionar corretamente para contratos de pacote, evitando bloqueios indevidos e mantendo o comportamento esperado para contratos que não pertencem a pacotes.<br /> <br /> ==BUG - Refidelização incorreta na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao selecionar “SIM” para refidelizar, a nova fidelidade não estava sendo aplicada corretamente para contratos individuais e pacotes.<br /> Mesmo com a chave FIDELIZACAO_CONTRATOS_FIXA = 1 e sem a permissão de fidelização livre, o sistema não definia a fidelidade para 12 meses a partir da data da alteração, conforme o fluxo esperado. Com isso, as datas de início e vencimento da fidelidade ficavam incorretas.<br /> <br /> Correção aplicada:<br /> O fluxo foi ajustado para que, quando FIDELIZACAO_CONTRATOS_FIXA = 1, ao optar por refidelizar:<br /> <br /> DataInicioFidelidade seja definida como a data/hora da alteração de titularidade<br /> <br /> DataVencimentoFidelidade seja definida para 12 meses após a data de início<br /> <br /> Quando FIDELIZACAO_CONTRATOS_FIXA = 0, o comportamento permanece inalterado, mantendo o fluxo atual.<br /> <br /> ==BUG - Remessa eletrônica não gerada para faturas criadas por contestação==<br /> <br /> Erro identificado:<br /> As faturas geradas por meio de contestação, quando vinculadas a formas de cobrança eletrônica, não estavam tendo a remessa eletrônica gerada automaticamente.<br /> Esse comportamento divergia do fluxo esperado e do padrão já aplicado a outros cenários, como a geração de faturas via negociação, onde a remessa eletrônica é criada de forma automática.<br /> <br /> A inconsistência fazia com que faturas válidas ficassem sem remessa, impactando o processo de cobrança eletrônica.<br /> <br /> Correção aplicada:<br /> O fluxo de geração de faturas por contestação foi ajustado para que, quando a forma de cobrança for eletrônica, a remessa eletrônica seja gerada automaticamente, seguindo o mesmo comportamento já adotado para faturas criadas via negociação.<br /> <br /> Com a correção, o sistema passa a manter padronização no processo de cobrança eletrônica, independentemente da origem da fatura.<br /> <br /> ==BUG - Falha na criação de location para Pix recorrente por limite de descrição==<br /> <br /> Erro identificado:<br /> No fluxo de Pix recorrente, a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX não estava sendo executada em determinados cenários. A causa foi identificada no conteúdo enviado no campo de descrição do plano, que excedia o limite de 35 caracteres exigido pela ação responsável pelo cadastro da autorização de débito recorrente via QR Code.<br /> Como a mesma descrição era reutilizada por outras integrações, o excesso de caracteres impedia a execução correta da ação, resultando na não geração do location para o Pix recorrente.<br /> <br /> Correção aplicada:<br /> Foi criada a chave DESCRICAO_PLANO_LIMIT, que garante o envio da descrição do plano limitada a até 35 caracteres, atendendo ao requisito da ação de Pix recorrente.<br /> Com o ajuste, a geração de location passa a ocorrer corretamente apenas quando a ação de cadastro de autorização de débito recorrente via QR Code é executada, sem impacto nas demais integrações que utilizam a descrição completa.<br /> <br /> ==BUG - Filtro não retornando registros na primeira página da aba Notas==<br /> <br /> Erro identificado:<br /> Na tela Financeiro &gt; Integração &gt; Aba NOTAS, ao aplicar determinados filtros, os registros não eram exibidos na primeira página, mesmo havendo resultados válidos.<br /> No cenário identificado, ao filtrar pelo Modelo de NF, o sistema indicava a existência de milhares de registros, porém a primeira página era carregada vazia. Os dados só passavam a aparecer ao navegar para a última página ou páginas intermediárias, caracterizando falha na paginação associada ao filtro.<br /> <br /> Esse comportamento causava confusão ao usuário, dando a impressão de que o filtro não havia retornado resultados.<br /> <br /> Correção aplicada:<br /> O mecanismo de paginação com filtros foi ajustado para garantir que, sempre que o filtro aplicado possuir registros válidos, os resultados sejam exibidos corretamente a partir da primeira página.<br /> Com a correção, a navegação entre páginas mantém consistência e os registros filtrados passam a ser apresentados de forma adequada desde o carregamento inicial.<br /> <br /> ==BUG - Rotina habilitando contrato já cancelado==<br /> <br /> Erro identificado:<br /> Foi identificado um cenário em que a rotina de habilitação alterava o status de um contrato que havia sido cancelado durante a execução da própria rotina.<br /> O contrato era corretamente selecionado no início da execução por estar com status “HABILITADO EM CONFIANÇA”, porém, antes da atualização final do status pela rotina, o usuário realizou a alteração manual para CANCELADO. Mesmo assim, a rotina prosseguiu e reverteu o status de CANCELADO para HABILITADO, gerando inconsistência no estado do contrato.<br /> <br /> Correção aplicada:<br /> O endpoint utilizado pela rotina foi ajustado para validar novamente o status do contrato no momento da atualização, considerando apenas contratos que não estejam com status CANCELADO.<br /> Com esse ajuste, a rotina não altera contratos que tenham sido cancelados durante sua execução, evitando reativações indevidas e garantindo a integridade do status do contrato.<br /> <br /> ==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> ==BUG - Duplicação de endereço do cliente na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3559 2025-12-16T14:53:11Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Desconto superior ao valor do extrato na contestação de faturas==<br /> <br /> Erro identificado:<br /> Na tela de Contestação de Faturas, o sistema permitia aplicar um desconto maior que o valor original do extrato. Como consequência, o extrato gerado passava a ter valor negativo, ocasionando erros em etapas posteriores do fluxo, como na geração de notas fiscais.<br /> <br /> Correção aplicada:<br /> Foi implementada uma validação no momento da aplicação do desconto, impedindo que o valor final do extrato seja menor que zero.<br /> Com o ajuste, o sistema permite que o extrato resultante seja igual a 0, porém nunca negativo, garantindo a integridade dos dados e evitando falhas nos processos subsequentes.<br /> <br /> ==BUG - Bloqueio indevido na edição de endereço de contratos em pacote==<br /> <br /> Erro identificado:<br /> Na tela Cliente &gt; Dados pessoais &gt; Endereço, ao iniciar a edição do endereço e optar por “Não” no modal “Deseja apenas corrigir algum erro no cadastro deste endereço?”, o sistema exibia a mensagem “Todos os componentes de um pacote precisam ser selecionados.”, impedindo a continuidade do processo.<br /> O bloqueio ocorria mesmo quando todos os contratos do pacote estavam selecionados, devido a uma validação que comparava a quantidade de planos cadastrados no pacote (que pode mudar ao longo do tempo) com os contratos efetivamente vendidos, gerando inconsistência e travando a edição.<br /> <br /> Esse comportamento afetava pacotes que tiveram alterações posteriores em sua composição, impossibilitando a edição de endereço de contratos vendidos anteriormente.<br /> <br /> Correção aplicada:<br /> A validação do modal foi ajustada para, em casos de pacotes, verificar apenas se todos os contratos vinculados ao mesmo IDContratoPacote foram selecionados, independentemente da quantidade atual de planos cadastrados no pacote.<br /> Com isso, a edição de endereço passa a funcionar corretamente para contratos de pacote, evitando bloqueios indevidos e mantendo o comportamento esperado para contratos que não pertencem a pacotes.<br /> <br /> ==BUG - Refidelização incorreta na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao selecionar “SIM” para refidelizar, a nova fidelidade não estava sendo aplicada corretamente para contratos individuais e pacotes.<br /> Mesmo com a chave FIDELIZACAO_CONTRATOS_FIXA = 1 e sem a permissão de fidelização livre, o sistema não definia a fidelidade para 12 meses a partir da data da alteração, conforme o fluxo esperado. Com isso, as datas de início e vencimento da fidelidade ficavam incorretas.<br /> <br /> Correção aplicada:<br /> O fluxo foi ajustado para que, quando FIDELIZACAO_CONTRATOS_FIXA = 1, ao optar por refidelizar:<br /> <br /> DataInicioFidelidade seja definida como a data/hora da alteração de titularidade<br /> <br /> DataVencimentoFidelidade seja definida para 12 meses após a data de início<br /> <br /> Quando FIDELIZACAO_CONTRATOS_FIXA = 0, o comportamento permanece inalterado, mantendo o fluxo atual.<br /> <br /> ==BUG - Remessa eletrônica não gerada para faturas criadas por contestação==<br /> <br /> Erro identificado:<br /> As faturas geradas por meio de contestação, quando vinculadas a formas de cobrança eletrônica, não estavam tendo a remessa eletrônica gerada automaticamente.<br /> Esse comportamento divergia do fluxo esperado e do padrão já aplicado a outros cenários, como a geração de faturas via negociação, onde a remessa eletrônica é criada de forma automática.<br /> <br /> A inconsistência fazia com que faturas válidas ficassem sem remessa, impactando o processo de cobrança eletrônica.<br /> <br /> Correção aplicada:<br /> O fluxo de geração de faturas por contestação foi ajustado para que, quando a forma de cobrança for eletrônica, a remessa eletrônica seja gerada automaticamente, seguindo o mesmo comportamento já adotado para faturas criadas via negociação.<br /> <br /> Com a correção, o sistema passa a manter padronização no processo de cobrança eletrônica, independentemente da origem da fatura.<br /> <br /> ==BUG - Falha na criação de location para Pix recorrente por limite de descrição==<br /> <br /> Erro identificado:<br /> No fluxo de Pix recorrente, a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX não estava sendo executada em determinados cenários. A causa foi identificada no conteúdo enviado no campo de descrição do plano, que excedia o limite de 35 caracteres exigido pela ação responsável pelo cadastro da autorização de débito recorrente via QR Code.<br /> Como a mesma descrição era reutilizada por outras integrações, o excesso de caracteres impedia a execução correta da ação, resultando na não geração do location para o Pix recorrente.<br /> <br /> Correção aplicada:<br /> Foi criada a chave DESCRICAO_PLANO_LIMIT, que garante o envio da descrição do plano limitada a até 35 caracteres, atendendo ao requisito da ação de Pix recorrente.<br /> Com o ajuste, a geração de location passa a ocorrer corretamente apenas quando a ação de cadastro de autorização de débito recorrente via QR Code é executada, sem impacto nas demais integrações que utilizam a descrição completa.<br /> <br /> ==BUG - Filtro não retornando registros na primeira página da aba Notas==<br /> <br /> Erro identificado:<br /> Na tela Financeiro &gt; Integração &gt; Aba NOTAS, ao aplicar determinados filtros, os registros não eram exibidos na primeira página, mesmo havendo resultados válidos.<br /> No cenário identificado, ao filtrar pelo Modelo de NF, o sistema indicava a existência de milhares de registros, porém a primeira página era carregada vazia. Os dados só passavam a aparecer ao navegar para a última página ou páginas intermediárias, caracterizando falha na paginação associada ao filtro.<br /> <br /> Esse comportamento causava confusão ao usuário, dando a impressão de que o filtro não havia retornado resultados.<br /> <br /> Correção aplicada:<br /> O mecanismo de paginação com filtros foi ajustado para garantir que, sempre que o filtro aplicado possuir registros válidos, os resultados sejam exibidos corretamente a partir da primeira página.<br /> Com a correção, a navegação entre páginas mantém consistência e os registros filtrados passam a ser apresentados de forma adequada desde o carregamento inicial.<br /> <br /> ==BUG - Rotina habilitando contrato já cancelado==<br /> <br /> Erro identificado:<br /> Foi identificado um cenário em que a rotina de habilitação alterava o status de um contrato que havia sido cancelado durante a execução da própria rotina.<br /> O contrato era corretamente selecionado no início da execução por estar com status “HABILITADO EM CONFIANÇA”, porém, antes da atualização final do status pela rotina, o usuário realizou a alteração manual para CANCELADO. Mesmo assim, a rotina prosseguiu e reverteu o status de CANCELADO para HABILITADO, gerando inconsistência no estado do contrato.<br /> <br /> Correção aplicada:<br /> O endpoint utilizado pela rotina foi ajustado para validar novamente o status do contrato no momento da atualização, considerando apenas contratos que não estejam com status CANCELADO.<br /> Com esse ajuste, a rotina não altera contratos que tenham sido cancelados durante sua execução, evitando reativações indevidas e garantindo a integridade do status do contrato.<br /> <br /> ==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> ==BUG - Duplicação de endereço do cliente na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3558 2025-12-16T14:48:27Z

<p>Caio.silva: /* BUG - Erro na geração de nota por impostos nulos na composição */</p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> ==BUG - Duplicação de endereço do cliente na alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3557 2025-12-16T14:47:52Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade em pacotes, quando os contratos do titular anterior utilizavam o mesmo IDEnderecoCliente, o sistema passava a criar múltiplos IDEnderecoCliente distintos para o novo titular.<br /> Com isso, um único endereço existente no cliente original resultava em dois ou mais endereços duplicados no novo cliente, mesmo sendo o mesmo local físico.<br /> <br /> Esse comportamento gerava inconsistência cadastral e duplicidade indevida de endereços vinculados aos contratos.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para reutilizar corretamente o mesmo IDEnderecoCliente no novo titular quando os contratos de origem compartilham o mesmo endereço.<br /> Com a correção, o sistema garante que:<br /> <br /> Um único endereço no titular anterior gere apenas um endereço correspondente no novo titular<br /> <br /> Todos os contratos migrados mantenham a referência correta ao mesmo endereço, evitando duplicidades<br /> <br /> Assim, a integridade dos dados de endereço é preservada durante a alteração de titularidade em pacotes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3556 2025-12-16T14:46:17Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.<br /> <br /> ==BUG - Erro na geração de nota por impostos nulos na composição==<br /> <br /> Erro identificado:<br /> No cadastro de composição, quando os campos de impostos (ex.: COFINS, PIS, ICMS, etc.) não eram informados, os valores eram salvos como NULL na base.<br /> Ao gerar a nota fiscal em cenários que exigiam esses impostos, o processo falhava com NullPointerException, interrompendo a geração da nota.<br /> <br /> Correção aplicada:<br /> O salvamento da composição foi ajustado para que, quando os campos de impostos não forem informados, os valores sejam persistidos como 0 (zero) no banco de dados.<br /> Com isso, a geração de notas fiscais passa a ocorrer normalmente, evitando exceções por valores nulos mesmo quando os impostos não são obrigatórios no cadastro da composição.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3555 2025-12-16T14:45:41Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.<br /> <br /> ==BUG - Rotina de envio não encontra faturas ao validar log de envio==<br /> <br /> Erro identificado:<br /> Na execução da Rotina-EnvioFaturasNotasFiscais, quando o oitavo parâmetro (enviar somente para clientes sem log de envio) era definido como 1, a rotina não retornava nenhuma fatura, mesmo quando existiam faturas elegíveis sem registro na TB_LogEnvioFatura.<br /> Com o mesmo comando, alterando apenas o oitavo parâmetro para 0, as faturas eram encontradas e enviadas corretamente, evidenciando falha na lógica de validação do log.<br /> <br /> Esse comportamento impedia o envio correto de faturas e notas fiscais em execuções que utilizavam o filtro por ausência de log, inclusive em cenários com grande volume de faturas pendentes.<br /> <br /> Correção aplicada:<br /> A lógica de busca da rotina foi ajustada para validar corretamente a existência (ou não) de registros na TB_LogEnvioFatura quando o oitavo parâmetro estiver habilitado.<br /> Com a correção, a rotina passa a:<br /> <br /> Localizar corretamente as faturas sem log de envio quando o parâmetro estiver definido como 1<br /> <br /> Manter o comportamento já existente quando o parâmetro estiver definido como 0<br /> <br /> Após o ajuste, a rotina foi validada, garantindo o envio correto das faturas e notas fiscais em ambos os cenários de execução.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3554 2025-12-16T14:44:51Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.<br /> <br /> ==BUG - Conteúdo cortado na tela inicial do aplicativo Android==<br /> <br /> Erro identificado:<br /> Na tela inicial do aplicativo do cliente (Android), algumas informações estavam sendo exibidas de forma cortada, prejudicando a visualização do conteúdo.<br /> O problema foi replicado em dispositivos específicos, onde a tela não se adaptava corretamente à resolução e versão do sistema operacional, mesmo funcionando normalmente em outros aparelhos e em emulador.<br /> <br /> Correção aplicada:<br /> O layout da tela inicial foi ajustado para garantir responsividade adequada, assegurando que todos os elementos sejam exibidos corretamente em diferentes resoluções e versões do Android.<br /> Quando necessário, foi implementado scroll na tela, evitando o corte de informações e garantindo uma experiência consistente e funcional para todos os usuários.<br /> <br /> ==BUG - Problemas de layout e scroll no aplicativo móvel (iOS e Android)==<br /> <br /> Erro identificado:<br /> Foram identificados problemas de visualização e usabilidade em diferentes telas do aplicativo móvel:<br /> <br /> iOS<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa das informações.<br /> <br /> Nessa mesma tela, o texto “pacote” estava desalinhado e ultrapassando os limites da tela.<br /> <br /> Na tela principal do app (após selecionar o contrato), as informações estavam cortadas na parte superior.<br /> <br /> O nome do aplicativo exibido após a instalação estava com capitalização incorreta.<br /> <br /> Android<br /> <br /> Na tela “Meu plano”, não havia scroll, impedindo a visualização completa dos dados.<br /> <br /> Na tela “Perfil”, a ausência de scroll impedia o acesso ao botão “Sair do app”.<br /> <br /> Esses problemas comprometiam a experiência do usuário em determinados modelos de aparelhos e versões do sistema operacional.<br /> <br /> Correção aplicada:<br /> Foram realizados ajustes de layout e responsividade nas telas afetadas para garantir:<br /> <br /> Implementação correta de scroll sempre que o conteúdo exceder o tamanho da tela.<br /> <br /> Correção de alinhamento e dimensionamento dos textos.<br /> <br /> Adequação da exibição de informações no topo das telas, evitando cortes.<br /> <br /> Ajuste do nome exibido do aplicativo após a instalação.<br /> <br /> Com as correções, as telas passam a se adaptar corretamente a diferentes resoluções, modelos de dispositivos e versões de iOS e Android, garantindo usabilidade e visualização completas.<br /> <br /> ==BUG - Cobrança duplicada após alteração de titularidade==<br /> <br /> Erro identificado:<br /> No processo de alteração de titularidade, ao optar pela opção “Não” no modal “Deseja faturar o valor integral no novo titular do contrato?”, o novo contrato era gerado com o campo UltimoFaturamento nulo.<br /> Como a data de habilitação do contrato anterior é migrada para o novo contrato, isso fazia com que a cobrança do novo titular considerasse um período que já havia sido faturado, gerando cobrança duplicada.<br /> <br /> Correção aplicada:<br /> O fluxo de alteração de titularidade foi ajustado para definir corretamente o UltimoFaturamento do novo contrato, conforme as seguintes regras:<br /> <br /> Quando o UltimoFaturamento do contrato anterior for menor que a data atual, o novo contrato recebe o UltimoFaturamento como um dia anterior à data atual.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for igual à data atual, essa mesma data é atribuída ao UltimoFaturamento do novo contrato.<br /> <br /> Quando o UltimoFaturamento do contrato anterior for maior que a data atual ou nulo, o comportamento permanece inalterado.<br /> <br /> Com esse ajuste, o sistema passa a evitar cobranças de períodos já faturados, garantindo a correta continuidade da cobrança após a alteração de titularidade.<br /> <br /> ==BUG - Inconsistências na criação e registro de débito recorrente via Pix==<br /> <br /> Erro identificado:<br /> Foram identificados problemas no fluxo de criação e registro de débito recorrente Pix, envolvendo integração, persistência de dados e interface:<br /> <br /> Na resposta da ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX, o campo id estava sendo armazenado em formato exponencial (ex.: 7.0722491541282673E18), enquanto o valor correto gerado pela plataforma era um número inteiro completo.<br /> <br /> A ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX estava sendo registrada incorretamente na tabela TB_LogDebitoRecorrente como CONFIRMAR_AUTORIZACAO_DEBITO_RECORRENTE_PIX, gerando inconsistência no histórico das operações.<br /> <br /> Na tela do contrato, ao salvar uma conta de débito, não era possível vincular o tipo de conta de débito, impedindo a configuração correta da cobrança recorrente.<br /> <br /> Correção aplicada:<br /> <br /> O tratamento da resposta da integração foi ajustado para garantir que o campo id seja armazenado corretamente como valor inteiro, sem conversão para notação exponencial.<br /> <br /> O registro de logs foi corrigido para que a ação CRIAR_LOCATION_DEBITO_RECORRENTE_PIX seja gravada com a identificação correta na TB_LogDebitoRecorrente.<br /> <br /> A tela de cadastro de conta de débito no contrato foi ajustada para permitir a seleção e vinculação correta do tipo de conta, concluindo o fluxo de configuração do débito recorrente.<br /> <br /> Com esses ajustes, o processo de débito recorrente via Pix passa a operar de forma consistente, com dados corretos, histórico confiável e configuração completa pelo usuário.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3553 2025-12-16T14:42:22Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.<br /> <br /> ==BUG - Datas incorretas na impressão de NFCOM==<br /> <br /> Erro identificado:<br /> Na impressão de NFCOM, os campos início de período, fim de período e data de vencimento estavam sendo exibidos com um dia anterior ao valor correto.<br /> O problema ocorria mesmo quando os dados estavam corretamente gravados na fatura e na nota, resultando em divergência entre as informações do sistema e o PDF gerado.<br /> Os campos afetados eram $F{dataVencimentoFatura}, $F{inicioPeriodo} e $F{fimPeriodo}.<br /> <br /> Correção aplicada:<br /> Foi realizado o ajuste no processo de geração/impressão da NFCOM para garantir que as datas sejam renderizadas corretamente no PDF, respeitando exatamente os valores armazenados no sistema, sem aplicação indevida de offset de data.<br /> Com a correção, os campos de período e vencimento passam a ser exibidos corretamente na impressão da nota fiscal.<br /> <br /> ==BUG - Falha no envio em lote de cobranças recorrentes por erro individual==<br /> <br /> Erro identificado:<br /> Na tela de geração de cobranças recorrentes de cartão de crédito, ao acionar a opção “Enviar cobranças para adquirente”, quando uma das faturas do lote retornava um erro não esperado pela plataforma, o sistema lançava um NullPointerException.<br /> Esse erro interrompia todo o processamento, impedindo o envio das demais faturas válidas do lote. A situação ocorria quando a resposta da integradora não podia ser interpretada corretamente, mesmo sendo um erro específico de apenas uma fatura (ex.: dados inválidos do cartão).<br /> <br /> Correção aplicada:<br /> O processamento do lote foi ajustado para tratar corretamente erros individuais retornados pela integradora, evitando a geração de exceção não tratada.<br /> Com a correção, uma fatura que retorne erro passa a ser isolada, permitindo que as demais faturas do lote continuem sendo enviadas normalmente, sem impacto no processamento geral das cobranças recorrentes.<br /> <br /> ==BUG - Bloqueio indevido do botão de filtro na movimentação interna==<br /> <br /> Erro identificado:<br /> Na tela Estoque &gt; Movimentações &gt; Movimentação interna &gt; Nova movimentação, quando o Local de origem selecionado não possui EntidadeCustodia = CONTRATO, o campo “Cód. contrato” não é exibido. Nessa situação, o botão de filtrar permanecia bloqueado, impedindo o avanço do processo, mesmo não sendo necessário informar contrato para esse tipo de local.<br /> <br /> Correção aplicada:<br /> O comportamento do botão de filtro foi ajustado para considerar a exibição do campo “Cód. contrato”.<br /> <br /> Quando o campo não estiver disponível na tela, o botão de filtro permanece habilitado.<br /> <br /> Quando o campo estiver disponível, o botão fica desabilitado até o preenchimento do código do contrato, seguindo o funcionamento esperado.<br /> <br /> Com isso, o fluxo de movimentação interna passa a funcionar corretamente em todos os cenários de local de origem.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3552 2025-12-16T14:26:14Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.<br /> <br /> ==BUG - Integração indevida de extrato com emissão pós-pagamento==<br /> <br /> Erro identificado:<br /> Na tela Integração &gt; Pendentes, extratos cuja composição possui a flag EmiteNotaPosPagamento = 1 são exibidos corretamente apenas na aba “Faturamentos com pagamento”, e somente quando a fatura vinculada possui data de pagamento preenchida.<br /> Entretanto, ao utilizar a opção “Integrar de acordo com filtro” na aba “Faturamentos”, esses mesmos extratos estavam sendo indevidamente selecionados pela rotina de integração, mesmo sem atender às condições de pagamento. Ou seja, a validação na tela (SPU) estava correta, mas a rotina de integração ignorava essa regra, enviando extratos indevidos para integração.<br /> <br /> Correção aplicada:<br /> A rotina de integração foi ajustada para respeitar a mesma validação aplicada na tela, desconsiderando extratos com EmiteNotaPosPagamento = 1 que não possuam data de pagamento.<br /> Com isso, esses extratos deixam de ser enviados para integração quando acionada a opção “Integrar de acordo com filtro”, garantindo consistência entre a interface e o processamento automático.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3551 2025-12-16T14:23:36Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ===Seleção de Integradora para Recorrência de Pix===<br /> <br /> Foi ajustado o fluxo de configuração da recorrência de Pix nas formas de cobrança.<br /> <br /> Anteriormente, ao marcar a flag “Utiliza recorrência de Pix” (campo UtilizaRecorrenciaPix na TB_FormaCobranca), não era possível selecionar a integradora Pix responsável pela recorrência, impedindo a configuração completa da funcionalidade.<br /> <br /> Com a correção, foi disponibilizada em tela a seleção da integradora de Pix, permitindo associar corretamente a forma de cobrança à integradora responsável. O valor configurado passa a ser buscado a partir do campo de integradora de remessa eletrônica, seguindo o mesmo padrão já utilizado em outros pontos do sistema.<br /> <br /> ===Download de XML de NFCOM Autorizada na Tela do Cliente===<br /> <br /> Foi implementado um novo botão na tela de notas fiscais do cliente que permite baixar o XML da NFCOM, desde que a nota esteja autorizada.<br /> <br /> Ao acionar o botão, o sistema disponibiliza o arquivo XML correspondente à nota fiscal, facilitando o acesso ao documento eletrônico diretamente pela interface do cliente.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3550 2025-12-16T14:22:42Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ===Seleção de Integradora para Recorrência de Pix===<br /> <br /> Foi ajustado o fluxo de configuração da recorrência de Pix nas formas de cobrança.<br /> <br /> Anteriormente, ao marcar a flag “Utiliza recorrência de Pix” (campo UtilizaRecorrenciaPix na TB_FormaCobranca), não era possível selecionar a integradora Pix responsável pela recorrência, impedindo a configuração completa da funcionalidade.<br /> <br /> Com a correção, foi disponibilizada em tela a seleção da integradora de Pix, permitindo associar corretamente a forma de cobrança à integradora responsável. O valor configurado passa a ser buscado a partir do campo de integradora de remessa eletrônica, seguindo o mesmo padrão já utilizado em outros pontos do sistema.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3549 2025-12-16T14:21:38Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ===Validação de Contratos Cancelados na Alteração de Pacotes===<br /> <br /> Foi implementada uma validação adicional no processo de alteração de pacotes para evitar inconsistências em cenários onde existam contratos cancelados ainda vinculados ao pacote.<br /> <br /> Anteriormente, em cancelamentos realizados por rotinas ou layouts de cancelamento em massa, era possível que um contrato fosse cancelado e permanecesse vinculado ao pacote. Nesses casos, ao alterar o pacote, o sistema permitia a operação e acabava gerando novos contratos com status cancelado, porém sem data de cancelamento, gerando inconsistência de dados.<br /> <br /> Com a correção aplicada, ao clicar em “Alterar pacote”, o sistema passa a:<br /> <br /> Validar se existe algum contrato cancelado vinculado ao pacote<br /> <br /> Bloquear a alteração do pacote caso essa condição seja encontrada<br /> <br /> Exibir uma mensagem ao usuário, informando que a ação não pode ser realizada devido à existência de contrato cancelado no pacote<br /> <br /> Esse ajuste garante maior integridade dos dados e evita a geração de contratos inconsistentes durante a alteração de pacotes.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3548 2025-12-16T14:20:30Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ===Ajuste de Alinhamento dos Campos CFOP e CNAE na Tela de Composição===<br /> <br /> Foi realizada a correção no alinhamento dos campos CFOP e CNAE na tela de cadastro da composição do módulo web.<br /> <br /> O problema ocorria em cenários onde os códigos selecionados possuíam valores extensos, fazendo com que a formatação da tela ficasse desalinhada e prejudicasse a visualização das informações.<br /> <br /> Com o ajuste aplicado, os campos passam a manter o alinhamento correto independentemente do tamanho do conteúdo, garantindo melhor organização visual e usabilidade da tela.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3547 2025-12-16T14:19:42Z

<p>Caio.silva: /* INTEGRAÇÃO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ===Criação de Índice na TB_NotaFiscalNFCom===<br /> <br /> Foi criado um índice na tabela TB_NotaFiscalNFCom para o campo IDNotaFiscal, com o objetivo de otimizar consultas e melhorar a performance nas operações que utilizam esse identificador.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3546 2025-12-16T14:18:49Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ===Correção de Validação de E-mail na Habilitação e Alteração de Contratos de TV===<br /> <br /> Foi corrigida a validação indevida de obrigatoriedade de e-mail nos fluxos de habilitação de contrato/pacote, up/down e alteração de titularidade para integrações de TV que não exigem e-mail obrigatório.<br /> <br /> Antes do ajuste, o sistema bloqueava a habilitação quando o cadastro do cliente não possuía e-mail, mesmo em cenários onde a integração aceita o campo em branco. Esse comportamento ocorria inclusive quando o tipo de integração era alterado, mantendo a exigência de e-mail de forma incorreta.<br /> <br /> Com a correção aplicada:<br /> <br /> A validação de e-mail não é mais impeditiva para integrações que não exigem esse dado<br /> <br /> O campo de e-mail pode ser encaminhado vazio, quando permitido pela integração<br /> <br /> A validação não é executada indevidamente nos processos de habilitação, mudança de plano e alteração de titularidade<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3545 2025-12-16T14:17:04Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ===Ajuste de Alinhamento no Modal de Seleção de Caixa/Saída===<br /> <br /> Foi corrigido o alinhamento dos textos “Caixa” e “Saída livre” no modal exibido durante a venda de um contrato, utilizado para a escolha da caixa/saída.<br /> <br /> O ajuste melhora a organização visual da tela, garantindo um layout mais consistente e facilitando a usabilidade em um fluxo frequentemente utilizado pelos usuários.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3544 2025-12-16T14:15:57Z

<p>Caio.silva: /* INTEGRAÇÃO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ===Ajuste na Geração de Pix Dinâmico para Adesão à Recorrência===<br /> <br /> Foi corrigido o processo de geração de Pix dinâmico na jornada de pagamento, onde a resposta da integração retornava dois códigos “copia e cola” distintos, causando inconsistência na oferta de adesão ao Pix recorrente.<br /> <br /> Durante a requisição, eram retornados os campos emv e pixCopiaeCola. Até então, o sistema armazenava apenas o valor de pixCopiaeCola na tabela TB_InformacaoAdicionalFatura, o que limitava a leitura correta do QR Code para adesão à recorrência, funcionando apenas em aplicativos específicos.<br /> <br /> Com a correção, o processo passa a considerar o campo EMV como base para a geração do QR Code, garantindo que o Pix dinâmico seja compatível com a leitura por diferentes instituições financeiras e permitindo corretamente a oferta de adesão ao Pix recorrente, conforme o padrão esperado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3543 2025-12-16T14:13:31Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Bloqueio de Alteração de Planos em Pacotes com Contratos Ativos===<br /> <br /> Foi corrigido um problema que permitia a alteração de planos dentro de um pacote, mesmo quando já existiam contratos ativos vinculados a esse pacote, o que causava perda de rastreabilidade e inconsistências na aplicação de promoções.<br /> <br /> A correção implementou uma trava na edição de pacotes de plano:<br /> <br /> Quando existir qualquer contrato criado com o pacote e não cancelado, não será permitida a alteração dos planos que compõem o pacote.<br /> <br /> Permanecem liberadas apenas edições que não impactam a composição do pacote, como descrição e características gerais.<br /> <br /> Com esse ajuste, o sistema evita:<br /> <br /> A perda de referência do pacote original<br /> <br /> Inconsistências na proporcionalidade de descontos e promoções<br /> <br /> Erros na aplicação de promoções em contratos que deixaram de pertencer ao pacote após edições indevidas<br /> <br /> A correção foi validada em ambiente de homologação, garantindo que promoções sejam aplicadas corretamente apenas quando a composição do pacote permanece íntegra.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3542 2025-12-16T14:11:56Z

<p>Caio.silva: /* REDES */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ===Ajustes no Processo de Busca de IP e Configuração de Wi-Fi===<br /> <br /> Durante a análise do processo de provisionamento, foi identificado que o comando de BUSCA_IP não retorna de forma confiável o endereço IP atual, não sendo possível obter a informação de Current IP address em diversos testes realizados. O comportamento ocorre mesmo quando o provisionamento do equipamento é concluído com sucesso.<br /> <br /> Também foi avaliado o impacto de performance, com a validação de que o tempo de resposta da chamada não sofreu degradação significativa em relação ao comportamento esperado.<br /> <br /> Considerando que a informação de IP nem sempre está disponível no momento do provisionamento, foi identificado que a estratégia atual de envio das configurações de Wi-Fi por meio dos comandos DEFINIR_CONFIGURACOES_WIFI_ENDPOINT e DEFINIR_CONFIGURACOES_WIFI_ENDPOINT_AUTENTICACAO pode não ser efetiva nesses cenários.<br /> <br /> Como alternativa, foi avaliada a possibilidade de realizar as chamadas de configuração de Wi-Fi fora do fluxo de provisionamento, ainda no aplicativo do técnico, seguindo abordagem semelhante à já utilizada em atividade complementar. Essa solução se apoia no fato de que o IP do cliente é corretamente registrado posteriormente na base de autenticação (campo framedipaddress), permitindo a execução das configurações em um momento mais adequado do processo.<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3541 2025-12-16T14:10:26Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ===Controle na Geração de Notas para Evitar Itens sem Faturamento Vinculado===<br /> <br /> Foi identificado e tratado um problema na geração de notas fiscais relacionado à criação de IdItemNota sem vínculo com faturamento do mês.<br /> <br /> O cenário ocorre quando há tentativa de geração simultânea de notas com o mesmo vencimento, resultando na criação de múltiplas notas com seus respectivos IdItemNota, sendo que um ou mais desses itens acabam sem faturamento mensal vinculado. Essa inconsistência impede a geração posterior da nota, pois o ItemNota do faturamento mensal fica sem o campo IDNota preenchido, levando o sistema a informar que não existe nota disponível para geração.<br /> <br /> Como parte da solução, foi definida a implementação de um controle no processo de geração de notas, evitando a criação de itens inconsistentes e garantindo o correto vínculo entre ItemNota, faturamento mensal e nota fiscal.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3540 2025-12-16T14:08:45Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ===Otimização de Consultas no Processamento de Arquivo Retorno===<br /> <br /> Foi realizada uma otimização no módulo Financeiro para reduzir o alto consumo de CPU e memória identificado durante o processamento de arquivos de retorno bancário.<br /> <br /> A análise apontou que determinadas consultas utilizavam funções como TRIM e SUBSTR sobre campos indexáveis (ex.: NumeroBoleto), o que impactava negativamente a performance do banco de dados durante a execução do processamento de retorno.<br /> <br /> Com o ajuste, as consultas envolvidas no processamento foram refatoradas para eliminar o uso de TRIM/SUBSTR, adotando abordagens mais eficientes e compatíveis com o uso de índices, reduzindo o custo de execução das queries.<br /> <br /> A melhoria mitiga gargalos de performance em cenários de alto volume de processamento, tornando a leitura e a baixa de faturas via retorno mais estáveis e eficientes.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3539 2025-12-16T14:06:13Z

<p>Caio.silva: /* ROTINAS */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ===Integração SAP – Envio de NFCOM Não Integradas===<br /> <br /> Foi criada uma nova rotina de integração com o SAP para envio de notas NFCOM que ainda não foram integradas, identificadas pelo atributo IsIntegrada = 'N' na tabela TB_Nota.<br /> <br /> A rotina realiza o envio utilizando o mesmo JSON atualmente empregado na integração de faturamentos, garantindo compatibilidade com o fluxo já existente. Para atender às particularidades das NFCOM, foram adicionados novos campos ao payload enviado ao SAP:<br /> <br /> U_chaveacesso: chave de acesso da NFCOM<br /> <br /> U_G2_NFCOMSTATUS: finalidade/status da NFCOM<br /> <br /> U_G2_NFCOMORIG: número da NFCOM original (quando aplicável)<br /> <br /> U_G2_NFCOMSUBS: número da NFCOM substituta (quando aplicável)<br /> <br /> Com essa rotina, o sistema passa a garantir o envio automático e padronizado das NFCOM pendentes de integração ao SAP, utilizando o mesmo fluxo de comunicação já consolidado.<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3538 2025-12-16T14:04:58Z

<p>Caio.silva: /* INTEGRAÇÃO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ===Integração SOPHUS – Adequação de Retorno em XML===<br /> <br /> Foi realizada a adequação da integração com a plataforma SOPHUS, considerando as chaves e parâmetros já existentes para consumo do serviço de consulta de score.<br /> <br /> O sistema já utiliza as seguintes chaves de integração:<br /> <br /> MODELO_SCORE_SOPHUS<br /> <br /> CODIGO_ENTIDADE_SPC_SOPHUS<br /> <br /> VERSAO_SPC_SOPHUS<br /> <br /> Também são considerados os produtos configurados conforme o tipo de cliente:<br /> <br /> PRODUTO_SOPHUS_PF para pessoa física<br /> <br /> PRODUTO_SOPHUS_PJ para pessoa jurídica<br /> <br /> Esses parâmetros são utilizados no consumo da ação CONSULTA, responsável pelo encaminhamento da solicitação à plataforma SOPHUS.<br /> <br /> Com a melhoria, o sistema passa a interpretar corretamente o retorno da integração no formato XML, garantindo o processamento adequado das informações devolvidas pela plataforma, conforme o modelo definido no anexo da integração.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3537 2025-12-16T14:03:36Z

<p>Caio.silva: /* ROTINAS */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ===Geração de Linha Digitável para Faturas Já Pagas===<br /> <br /> Foi implementado um novo parâmetro na rotina de geração de linha digitável, permitindo, de forma controlada, a geração da linha digitável (TB_InformacaoAdicionalFatura) também para faturas já pagas.<br /> <br /> Anteriormente, a rotina possuía apenas o parâmetro de data de corte e realizava a busca exclusivamente por faturas não pagas, com remessas já geradas, impedindo a geração da linha digitável em faturas quitadas.<br /> <br /> Com a melhoria, foi adicionado um segundo parâmetro à rotina, com as seguintes regras:<br /> <br /> 0: mantém o comportamento atual, não gerando linha digitável para faturas já pagas<br /> <br /> 1: permite a geração da linha digitável para faturas já pagas<br /> <br /> Caso o segundo parâmetro não seja informado, o sistema considera automaticamente o valor 0, preservando todas as validações já existentes.<br /> <br /> Exemplo de comando da rotina (comportamento atual):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026<br /> <br /> Exemplo de comando da rotina (permitindo faturas pagas):<br /> Rotina-GeraLinhaDigitavel.jar 20-04-2026 1<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3536 2025-12-16T14:02:41Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ===Ajuste na Baixa de Faturas via Arquivo Retorno Bancário===<br /> <br /> Foi realizado um ajuste na regra de identificação de faturas durante o processamento de arquivos de retorno bancário, visando evitar baixas indevidas em cenários onde existam múltiplas faturas com o mesmo NúmeroDocumento.<br /> <br /> Anteriormente, o sistema utilizava também o NumeroDocumento como critério para localizar a fatura a ser baixada. Em casos onde duas ou mais faturas compartilhavam esse mesmo número, era possível ocorrer a baixa incorreta, especialmente quando uma das faturas já se encontrava quitada por outro meio (ex.: webhook).<br /> <br /> Com a correção aplicada, a busca e validação para baixa da fatura deixam de considerar o NumeroDocumento como identificador principal, eliminando ambiguidades em cenários com faturas semelhantes (mesmo contrato, cliente, valor e vencimento).<br /> <br /> O ajuste garante que o processamento do retorno bancário execute a baixa exclusivamente na fatura correta, conforme os identificadores adequados previstos no layout de retorno, evitando impactos financeiros e inconsistências no histórico de pagamentos.<br /> <br /> A correção foi replicada e validada em ambiente de homologação, reproduzindo o cenário reportado e confirmando a eliminação do problema.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3535 2025-12-16T14:01:41Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3534 2025-12-16T14:01:25Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ===Inativação Temporária – Cálculo de Dias e Impressão em Contrato===<br /> <br /> Foram implementadas novas regras de negócio no módulo Comercial para suportar a inativação temporária de contratos.<br /> <br /> Ao selecionar as datas DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim, o sistema passa a calcular automaticamente a quantidade de dias entre os períodos, armazenando o valor no campo correspondente.<br /> <br /> Durante a impressão do contrato, o valor calculado é inserido dinamicamente no termo, antes da geração do arquivo PDF, garantindo que a informação conste corretamente no documento final.<br /> <br /> Para suportar a funcionalidade, foram criados novos campos de data de início e data de fim da inativação temporária no contrato, com recuperação dos valores no momento da impressão, conforme o modelo definido.<br /> <br /> No Adapter, foram adicionados os campos inativacaoTemporariaInicio e inativacaoTemporariaFim ao ModeloContratoDto, viabilizando a integração e o correto preenchimento das informações no documento.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3533 2025-12-16T13:59:15Z

<p>Caio.silva: /* NFCOM – Inclusão de Campos para Controle de Contingência */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3532 2025-12-16T13:58:34Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ===NFCOM – Inclusão de Campos para Controle de Contingência===<br /> <br /> Foram incluídos novos campos na tabela TB_InformacaoAdicionalNota com o objetivo de aprimorar o controle de emissão em contingência das notas fiscais NFCOM.<br /> <br /> Os novos campos adicionados foram:<br /> <br /> DataContingencia (datetime), para registro da data e hora da emissão em contingência<br /> <br /> JustificativaContingência (varchar), para detalhar o motivo da contingência<br /> <br /> tipoEmissao (int, tamanho 1), para identificação do tipo de emissão da nota<br /> <br /> Essa melhoria permite maior rastreabilidade e conformidade fiscal nos cenários de emissão em contingência.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3531 2025-12-16T13:57:38Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ===Geração de Pix Dinâmico para Boletos com Vencimento Futuro===<br /> <br /> Foi criada uma nova rotina para geração de Pix dinâmico, permitindo a adesão do Pix a boletos já gerados, desde que atendam a critérios específicos de cobrança.<br /> <br /> A rotina realiza a consulta, via SPU, dos clientes que possuam:<br /> <br /> Faturas geradas com vencimento futuro e sem pagamento<br /> <br /> Forma de cobrança compatível com as informadas no conf.properties (normalmente diferentes de Pix recorrente)<br /> <br /> Durante a execução da rotina, caso existam dados previamente gerados, os campos ChavePix, Base64 e TxID da tabela TB_InformacaoAdicionalFatura são removidos. Em seguida, é feita uma nova geração desses dados, por meio da ação GERAR_PIX_DINAMICO, utilizando a integradora configurada para a fatura do cliente.<br /> <br /> Como regra adicional, caso a URL informada na ação GERAR_PIX_DINAMICO não possua o parâmetro dataDeVencimento, a rotina será interrompida e o sistema exibirá uma mensagem informando que a ação não pode ser executada. Nesse cenário, o modelo de envio _DATA_VENCIMENTO_ é obrigatório.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3530 2025-12-16T13:55:12Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ===Impressão de NF Modelo 62 com URL de Consulta===<br /> <br /> Foi ajustado o comportamento do sistema ao imprimir notas fiscais do modelo 62, trazendo maior aderência às informações fornecidas pelo emissor.<br /> <br /> Ao clicar no botão “Imprimir NF”, caso a nota seja do modelo 62 e possua o campo URLConsulta preenchido, o sistema passará a disponibilizar o PDF diretamente a partir do link informado, ao invés de gerar um PDF próprio como ocorre atualmente.<br /> <br /> Caso a nota não possua a URLConsulta preenchida, o sistema mantém o comportamento atual, realizando a geração interna do PDF normalmente.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3529 2025-12-16T13:54:09Z

<p>Caio.silva: /* INTEGRAÇÃO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ===Regras de Cancelamento de NF-e com Integração===<br /> <br /> Foram implementadas novas regras de negócio para cancelamento de notas fiscais integradas, com o objetivo de garantir maior controle, consistência e tratamento de contingências no processo.<br /> <br /> Foi criado o campo IsCancelamentoIntegrado na tabela TB_NotaFiscalNFCom, responsável por identificar o status do cancelamento realizado via integração.<br /> <br /> O sistema passou a restringir o cancelamento de notas fiscais que:<br /> <br /> Não sejam do tipo OFFLINE<br /> <br /> Possuam integradora vinculada<br /> <br /> Não estejam com o status AUTORIZADA na TB_InformacaoAdicionalFatura<br /> <br /> As regras já existentes relacionadas ao período de emissão permanecem inalteradas. Da mesma forma, não será permitida a contestação de faturas que possuam ao menos uma nota fiscal nessas mesmas condições.<br /> <br /> Quando a nota fiscal atender aos critérios de cancelamento, não for OFFLINE, possuir integradora e estiver autorizada, o sistema realizará automaticamente a chamada de integração de cancelamento, utilizando a ação CANCELAR_NOTA_FISCAL_NFCOM.<br /> <br /> Após a chamada de integração:<br /> <br /> Em caso de sucesso, o campo IsCancelamentoIntegrado será atualizado para 'S'<br /> <br /> Em caso de erro, o campo será atualizado para 'E'<br /> <br /> Como mecanismo de contingência, foi criada uma rotina que identifica todas as notas fiscais com IsCancelamentoIntegrado = 'E' e situação 'S', realizando novamente a chamada de cancelamento na integradora. Essa rotina garante a reexecução automática do processo caso a integração falhe no momento da aplicação.<br /> <br /> A rotina foi preparada para execução automática via CRON, assegurando a continuidade e confiabilidade do cancelamento integrado.<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3528 2025-12-16T13:52:43Z

<p>Caio.silva: /* COMERCIAL */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ===Nova Régua de Cobrança – Estrutura, Configuração e Execução===<br /> <br /> Foi implementada uma nova régua de cobrança, com reestruturação completa de dados, regras e rotinas, permitindo maior flexibilidade, controle e evolução progressiva em relação ao modelo anterior.<br /> <br /> Na preparação de dados, foi criado o atributo isAtivo na tabela TB_ReguaCobranca e novos atributos na TB_ItemReguaCobranca, incluindo tipo de ação (ex.: SUSPENSAO, CANCELAMENTO, COMUNICACAO, HABILITACAO, entre outros), tipo de contrato, operação, dias de habilitação por confiança e demais parâmetros necessários para a nova lógica. Também foram criadas novas tabelas de apoio e controle, como TB_LogReguaCobranca, TB_ReguaCobrancaOperacao e TB_ReguaCobrancaTecnologia, garantindo rastreabilidade e segmentação por operação e tecnologia.<br /> <br /> No backend, foi criada a nova stored procedure spuHabilitacaoSuspensaoContratoRegua, que passa a considerar exclusivamente as configurações da nova régua de cobrança e seus itens, descartando os atributos antigos de suspensão. Para permitir uma migração progressiva, a procedure antiga (spuHabilitacaoSuspensaoContrato) foi ajustada para ignorar contratos vinculados a operações que já possuam régua de cobrança cadastrada, possibilitando a convivência dos dois modelos.<br /> <br /> Como regra de transição (data de corte), todos os contratos que possuírem faturas em aberto há x dias ou mais, no momento da entrada em produção da funcionalidade, terão o atributo “cancela por inadimplência” automaticamente marcado como NÃO.<br /> <br /> No módulo Financeiro, a tela foi reorganizada para Financeiro → Régua de cobrança, onde usuários com permissão podem cadastrar e manter as réguas, combinando livremente as ações desejadas. A régua pode ser ativada ou desativada a qualquer momento, e todo cadastro ou edição de réguas e itens gera log automático de auditoria.<br /> <br /> Durante o cadastro de uma régua com rotina de execução, o sistema abre um modal dinâmico para configuração dos parâmetros necessários, como dias e horários de execução, quantidade de dias de atraso considerados e modelos de comunicação (e-mail, SMS, app). Apenas rotinas com o campo comandoReguaCobranca preenchido ficam disponíveis para seleção.<br /> <br /> No módulo de Rotinas, foram criadas novas variáveis de apoio, como ID_MODELO_EMAIL, ID_MODELO_SMS, ID_MODELO_AVISO_APP, DIAS_VENCIMENTO e ID_TIPO_CONTRATO, que são utilizadas dinamicamente no cadastro das rotinas da régua. De acordo com as variáveis usadas no comando, o sistema exibe automaticamente os combos correspondentes para configuração.<br /> <br /> Por fim, foi criada uma nova rotina de suspensão e habilitação, que realiza a leitura da nova stored procedure da régua de cobrança, consolidando o novo modelo de execução e garantindo maior controle, padronização e escalabilidade do processo.<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3527 2025-12-16T12:22:03Z

<p>Caio.silva: /* FINANCEIRO */</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ===Edição de extrato financeiro===<br /> <br /> Ajuste para não permitir a edição de extrato financeiro quando o mesmo possuir nota vinculada. Não permitir o cancelamento de fatura com reversão de faturamento quando a mesma possuir algum extrato vinculado a nota fiscal.<br /> <br /> <br /> ===Consulta de Notas Fiscais – Integração SEFAZ e FOCUS===<br /> <br /> Foi implementada uma nova rotina no sistema para consulta de notas fiscais, permitindo a verificação tanto diretamente na SEFAZ quanto por meio da plataforma FOCUS.<br /> <br /> A melhoria inclui a criação de um botão na tela de Rejeições, que possibilita ao usuário acionar manualmente a consulta da nota fiscal, executando a rotina com os parâmetros de integração configurados.<br /> <br /> Para viabilizar essa funcionalidade, foi criada a ação CONSULTAR_NOTA_FISCAL_NFCOM, utilizando como parâmetro principal a chave de acesso da nota fiscal (_CHAVE_ACESSO_NOTA_).<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Out/Nov/Dez_2025&diff=3526 2025-12-16T12:13:12Z

<p>Caio.silva: Criou página com '==BUG - Otimizar consulta para selecionar produto na movimentação interna== Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado. ==BUG - Alteração na composição remove vínculo com o serviço== Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa compo...'</p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=P%C3%A1gina_principal&diff=3525 2025-12-16T12:12:57Z

<p>Caio.silva: /* BUG'S */</p> <hr /> <div><br /> ==== ''Integrações'' ==== <br /> * [[Menu Integrações|Integrações]]&lt;br /&gt;<br /> ==== ''Atualizações:'' ====<br /> <br /> * [[Ano 2021]]<br /> * [[Ano 2022]]<br /> * [[Ano 2023]]<br /> * [[Ano 2024]]<br /> * [[Janeiro/Fevereiro 2025]]<br /> * [[Março/Abril 2025]]<br /> * [[Maio 2025]]<br /> * [[Junho/Julho 2025]]<br /> * [[Agosto/Setembro 2025]]<br /> * [[Out/Nov/Dez 2025]]<br /> <br /> ==== ''BUG'S'' ====<br /> <br /> * [[2022]]<br /> * [[2023]]<br /> * [[2024]]<br /> * [[Bugs Janeiro/Fevereiro 2025|Janeiro/Fevereiro 2025]]<br /> * [[Bugs Março/Abril 2025|Março/Abril 2025]]<br /> * [[Bugs Maio 2025|Maio 2025]]<br /> * [[Bugs Juho/Julho 2025|Junho/Julho 2025]]<br /> * [[Bugs Agosto/Setembro 2025|Agosto/Setembro 2025]]<br /> * [[Bugs Out/Nov/Dez 2025|Out/Nov/Dez 2025]]<br /> <br /> ==== ''MIgração'' ====<br /> * [[Migração]]</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Out/Nov/Dez_2025&diff=3524 2025-12-16T12:12:03Z

<p>Caio.silva: Criou página com '==AUTENTICAÇÃO== ==COMERCIAL== ===Tempo para reprovisionamento=== Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU. Tempo reprovisionamento...'</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> ===Tempo para reprovisionamento===<br /> Para possibilitar o ajuste no tempo de reprovisionamento da ONU em casos de falha por algum motivo, foi criado a chave de configuração '''TEMPO_MINIMO_REPROVISIONAR_ONU_APLICATIVO_TECNICO''' (modulo comercial) onde deverá ser setado o tempo mínimo (em segundo) entre uma tentativa e outra de provisionamento da ONU.<br /> <br /> [[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]<br /> <br /> Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.<br /> <br /> <br /> ===Alteração Wi-fi - ONU Parks===<br /> Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.<br /> <br /> Para possibilitar a alteração das informações de wi-fi via tela de gerenciar conexões através de API, foi criado um novo tipo de integração referenciando a nova tabela ''TB_GerenciadorDispositivoIntegradora'' a partir dela deverão ser pré-configurados a integradora (em modulo integração Integração-&gt; Integradoras), as URLs de autenticação (''em modulo integração -&gt;Integração -&gt;URLs de autenticação'') e URLs (''em modulo integração-&gt;Integração-&gt; URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-&gt; Integração -&gt;Ações de integradoras de gerenciador dispositivo'')<br /> <br /> <br /> [[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]<br /> <br /> <br /> [[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]<br /> <br /> <br /> [[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]<br /> <br /> <br /> [[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]<br /> <br /> '''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .<br /> <br /> <br /> Para utilização da funcionalidade ainda será necessário configurar a chave de configuração (''modulo comercial'') '''ID_INTEGRADORA_GERENCIADOR_DISPOSITIVO''' e a permissão '''ALTERAR DADOS WIFI - CL95''', quando configuradas ficará habilitado o botão &quot;Alterar Wifi&quot; <br /> <br /> [[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]<br /> <br /> <br /> Foi criado também a nova flag '''&quot;Utiliza gerenciador de dispositivos&quot;''' no cadastro de fornecedores de equipamento (''em Comercial-&gt; Tabelas de apoio-&gt; Fornecedor de Equipamento-&gt; Cadastro'')<br /> <br /> [[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]<br /> <br /> <br /> '''Regra:'''<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''marcada''', a alteração de informações do wi-fi só será possível pelo botão &quot;Alterar WIFI&quot; onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag &quot;Utiliza gerenciador de dispositivos&quot; '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;<br /> <br /> ==FINANCEIRO==<br /> <br /> ===Senha em fatura===<br /> Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1). <br /> <br /> <br /> [[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]<br /> <br /> <br /> Caso esteja com valor = 1 todos os envios de faturas no sistema web ou através de rotinas terão o arquivo gerado (.PDF) criptografado com senha, de modo que utilizará os 5 primeiros dígitos do CPF/ CNPJ.<br /> <br /> O processo de envios de faturas seja através do sistema web ou através de rotinas não sofreu alterações, desta forma, estando com a chave “SENHA_PDF_FATURA” configurada com valor =1, após a realização do envio da fatura, ao tentar abrir a fatura será solicitado a senha para abertura:<br /> <br /> <br /> [[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]<br /> <br /> <br /> <br /> ===Novos fields para termo de inativação===<br /> <br /> Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''<br /> <br /> '''Obs''': para implementação consulte suporte técnico.<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ===Integração NFCOM===<br /> <br /> A NFCom (Nota Fiscal de Comunicação) é um novo modelo de nota fiscal eletrônica criado para substituir documentos fiscais usados por empresas de telecomunicações e comunicação, como telefonia, internet e TV por assinatura. Atualmente os modelos 22 e 21. Ela foi desenvolvida para padronizar, modernizar e facilitar a emissão e o controle dessas notas, utilizando um formato eletrônico semelhante ao da NF-e (Nota Fiscal Eletrônica de produtos).<br /> <br /> Com a NFCom, os dados são transmitidos em tempo real à Sefaz (Secretaria da Fazenda), garantindo mais transparência, segurança fiscal e integração entre sistemas.<br /> <br /> '''Configurações:'''<br /> <br /> '''Permissões de usuário:''' Para emissões no Adapter o usuário irá precisar da permissão '''GERAR NOTAS FISCAIS ELETRONICAS - NF07''' atribuída ao seu perfil;<br /> <br /> '''Finalidade de emissão de notas:''' Cadastrar seguindo a codificação oficial do Portal da Nota Fiscal Fatura de Serviço de Comunicação Eletrônica - SVRS (https://dfe-portal.svrs.rs.gov.br/Nfcom/Servicos) <br /> <br /> <br /> [[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]<br /> <br /> <br /> '''ATENÇÃO: Os registros dessa tabela NÃO devem ser alterados a menos que haja publicação de portaria da Sefaz, instrução normativa ou algo que o valha solicitando ajuste.'''<br /> <br /> '''Cadastro de cidades:''' deverá ter informado obrigatoriamente para os municípios os campos : Nome da Cidade no IBGE, Código Cidade no IBGE e Código da UF no IBGE.<br /> <br /> '''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.<br /> <br /> '''Motivo de contestação:''' a funcionalidade de contestação de valores será explicada mais adiante, mas devemos deixar cadastrados os motivos de contestação de acordo com tabela oficial da Confaz.<br /> <br /> '''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.<br /> <br /> '''Modelo de notas fiscais:''' Será necessário realizar o cadastro de um novo modelo de notas fiscais com os seguintes parâmetros a serem observados para NFCom. <br /> <br /> * Código do modelo: 62<br /> <br /> * Série :1<br /> <br /> * Pode cancelar fora do período: não marcar<br /> <br /> * Integrada: SEFAZ<br /> <br /> * Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração<br /> <br /> * Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo<br /> <br /> '''COMPOSIÇÕES FISCAIS:''' <br /> <br /> Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.<br /> <br /> [[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]<br /> <br /> '''Pagina principal''' – mantêm os dados atuais sem alterações relevantes<br /> <br /> '''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo <br /> <br /> * Modelo de nota fiscal: NFCom<br /> <br /> * Grupo composições fiscais: Agrupador utilizado para emissão da fatura unificada no Adapter. As composições que compõe um determinado grupo terão o valor somado no campo da fatura conforme exemplo abaixo:<br /> <br /> <br /> [[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]<br /> <br /> <br /> * CFOP: pode ser informado na composição caso o item possua CFOP especifico, caso seja deixado sem informação, irá considerar para emissão da nota o CFOP informado no cadastro de clientes.<br /> * CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe<br /> * Tipo de serviço: tabela já utilizada na integração com o convenio 115, também conhecida como tabela de utilização, se trata de tabela oficial e não deve ser alterada no sistema.<br /> * Classificação fiscal: Está diretamente relacionada ao tipo de serviço selecionado no combo anterior, também se trata de tabela oficial registrada no convenio do ICMS 115 e será enviada nos itens de NFCom<br /> * Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.<br /> <br /> '''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.<br /> <br /> * Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11<br /> * Código de Situação tributária PIS/COFINS - Informar de acordo com o recolhimento dos impostos informados nas alíquotas no geral por exemplo:<br /> <br /> Se informado alíquota PIS/COFINS então código da situação será geralmente 01<br /> Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08<br /> <br /> [[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]<br /> <br /> '''Dados fiscais – Impostos Estaduais:''' ICMS - Informar a alíquota se houver, se não houver incidência informar para NFCom opção OUTROS. Geralmente ao informar opção outros deve ser informada observação fiscal relativa a não contribuição para o serviço.<br /> <br /> '''Dados fiscais - Impostos municipais'''<br /> Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município<br /> <br /> <br /> [[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]<br /> <br /> <br /> '''Importante'''<br /> <br /> Como pode ser observado as incidências de impostos foram informadas ao cadastrar modelo de nota e também no cadastro da composição fiscal. As informações inseridas no modelo servem apenas de referencia para que o usuário não cometa erros ao realizar o cadastro das composições. Ao cadastrar uma composição onde a informação tributária for diferente do modelo da nota o usuário irá receber o alerta conforme no exemplo abaixo <br /> <br /> [[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]<br /> <br /> No módulo integração iremos realizar o cadastro do tipo de integração Nota Fiscal Eletrônica, pois a mesma servirá para outros modelos de nota além a da NFCom <br /> <br /> '''Obs:''' consulte disponibilidade da integração previa com suporte técnico.<br /> <br /> Assim como para outras integrações, será necessário o cadastro prévio do Tipo de integração, Integradoras, Servidores de integração, certificados, Urls e Ações de integradora de nota fiscal para que realizem integração na plataforma de integração de notas fiscais.<br /> <br /> <br /> [[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]<br /> <br /> Cadastro empresa/responsável pela emissão da nota junto a Sefaz que está relacionada ao tipo, ou a Sefaz do estado onde será emitida a NFCom:<br /> <br /> <br /> [[Arquivo:Integradora de notas.png|500x500px|miniaturadaimagem|centro|Integradora de notas]]<br /> <br /> [[Arquivo:Urls notas.png|500x500px|miniaturadaimagem|centro|Cadastros de urls para a integracao]]<br /> <br /> [[Arquivo:Acoes notas.png|500x500px|miniaturadaimagem|centro|Ações para integração de notas fiscais ]]<br /> <br /> '''Rotina notas eletrônicas'''<br /> <br /> Para realizar a integração das notas fiscais foi criado uma nova rotina que realizará o processo, a mesma deve ser apontada na chave de configuração (modulo integração) criada para NFCom.<br /> <br /> [[Arquivo:Chave nfcom.png|500x500px|miniaturadaimagem|centro|Chave rotina para integração de NFCom]]<br /> <br /> '''OBS: PARA CASOS ONDE A GERAÇÃO DE NOTAS É DE RESPONSABILIDADE DO SAP DO CLIENTE, ESTA ROTINA E INTEGRAÇÃO NÃO É APLICADA''', para esse caso seguirá o processo com as rotinas de integração de faturamento e retorno de notas, onde serão adicionados novos dados referente a composição e fatura.<br /> <br /> Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.<br /> <br /> <br /> <br /> '''PROCESSOS NFCOM'''<br /> <br /> A emissão de notas fiscais integradas exige que o sistema mantenha uma certa integridade de dados obrigatórios na integração. Para realizar um monitoramento pro ativo e possibilitar ajustes diários em erros antes mesmo da emissão de notas fiscais integradas, foi criado no Adapter um painel validador da integridade das informações. Abaixo iremos detalhar as regras de funcionamento.<br /> <br /> Os dados validados nesses painéis são cadastrais, e validam<br /> <br /> * Clientes que tiveram um contrato cadastrado nos últimos 90 dias<br /> * Todas as composições cadastradas<br /> * Possíveis impedimentos de emissão/integração da NFCom<br /> <br /> Como se trata de um pré validador não é necessário que o cliente ou composição tenha faturamento e nota fiscal gerados para indicar possíveis problemas cadastrais.<br /> <br /> <br /> [[Arquivo:Validador fical.png|500x500px|miniaturadaimagem|centro|Pré Validador fiscal]]<br /> <br /> <br /> '''Integridade Cadastral'''<br /> <br /> Responsável por pré validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.<br /> <br /> CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo<br /> <br /> IE: verifica a inscrição estadual informada para os clientes da base e de acordo com o estado (UF) do cliente valida a mascara e quantidade de dígitos informados assim como a validade real da IE. Verifica para clientes pessoa física quem está como IE diferente de ISENTO.<br /> <br /> Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.<br /> <br /> Indicadores IE validos:<br /> 1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido<br /> 2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO<br /> 9 - Não contribuinte - não deve ser preenchido<br /> <br /> CFOP: valida o CFOP informado para o cliente, deve ser respeitado o estado (UF) e tipo de pessoa (física e jurídica) e ainda se o campo está nulo ou em branco.<br /> <br /> Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos<br /> <br /> Numero: não pode ser em branco e nem conter caracteres especiais<br /> <br /> Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE<br /> <br /> Nome IBGE: nome da cidade precisa ser informado e respeitado os parâmetros idênticos ao IBGE (letras maiúsculas e minúsculas, acentos e etc.)<br /> <br /> UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE<br /> <br /> Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos<br /> <br /> E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais<br /> <br /> <br /> '''Dados Fiscais'''<br /> <br /> Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos<br /> <br /> Exemplo:<br /> PIS 1.65 exige COFINS 3.00<br /> PIS 0.65 exige COFINS 7.60<br /> ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS<br /> ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO<br /> <br /> Codificações: realiza uma validação previa das composições para combinar campos de códigos como CFOP, Natureza de operação PIS/COFINS etc.<br /> <br /> Exemplo de erro:<br /> Tipo serviço = 2 COMUNICACAO DE DADOS<br /> Classificação Fiscal = 0101 - Assinatura de serviços de telefonia<br /> <br /> Contábil: também realiza combinações para exigir o preenchimento de dados<br /> <br /> Exemplo:<br /> ICMS 0 exige contas débito e crédito preenchidas<br /> Conta de Contrapartida Crédito obrigatória<br /> <br /> '''Outros Campos'''<br /> <br /> Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.<br /> <br /> Média Correções por dia: valida o dia atual e dias faltantes até o último dia do mês permitido para emissão de notas e divide o total de erros pelos dias faltantes<br /> <br /> Exemplo<br /> Hoje: 03/07/2025<br /> Último dia do mês para emitir notas: 31/07/2025<br /> Diferença de dias: 28 dias<br /> Total de erros: 635<br /> Média de correções por dia: 23<br /> <br /> Risco: Valida o dia atual, quanto mais próximo do último dia de emissão das notas e mais erros possuir maior o risco contabilizado pois pode não haver tempo hábil de efetuar as correções.<br /> <br /> '''Outras Funcionalidades'''<br /> <br /> Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget<br /> <br /> Exemplo:<br /> <br /> [[Arquivo:Erros valida.png|500x500px|miniaturadaimagem|centro|Validador erros]]<br /> <br /> Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros<br /> <br /> [[Arquivo:Erros valida 1.png|500x500px|miniaturadaimagem|centro|Erros Cadastrais]]<br /> <br /> A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.<br /> <br /> <br /> '''Dashboard: Validador de faturamento'''<br /> <br /> <br /> A NFCom possui uma serie de campos obrigatórios para ser emitida, um dos principais problemas encontrados são tentativas de integrar notas fiscais que não possuem código de barras da fatura. Esse painel irá mostrar as três modalidades desse impedimento, não tem fatura gerada ou tem sem remessa e/ou sem linha debitável, ou seja, para integrar uma NFCom a fatura precisa estar gerada e integrada ao banco.<br /> <br /> [[Arquivo:Valid fat.png|500x500px|miniaturadaimagem|centro|Validador Faturamento]]<br /> <br /> <br /> '''Emissão NFCom'''<br /> <br /> Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom<br /> <br /> Os painéis informados acima deverão estar corretamente higienizados para seguir com a emissão da NFCom, caso não estejam o sistema irá criar alertas e/ou impedimentos para a emissão.<br /> <br /> [[Arquivo:Valid fat1.png|500x500px|miniaturadaimagem|centro|Alerta validador]]<br /> <br /> <br /> Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação. Já os cadastrais são alertas prévios de que na NFCom será rejeitada pela Sefaz mas não impede o usuário de continuar com a geração das notas<br /> <br /> [[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]<br /> <br /> <br /> Assim que for finalizada a geração de notas por essa tela, o sistema irá executar automaticamente a integração com a Sefaz, não sendo necessária nenhuma ação por parte do mesmo.<br /> <br /> Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.<br /> <br /> '''Dashboard: NFCom Status'''<br /> <br /> Após a integração ser concluída, ou seja, a rotina ser finalizada no controle de execução, poderá ser realizada a conferencia da NFCom no painel de status.<br /> <br /> Esse painel irá tratar da NFCom já integrada ou seja é um pós validador da nota. Os campos aqui já requerem uma atenção do emissor e possuem regras de negócios diferenciadas. <br /> <br /> Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:<br /> <br /> * Rotina: no início da execução da rotina de notas fiscais eletrônicas o sistema irá realizar uma coleta geral das informações desse painel, mesmo que na execução da rotina tenha apenas uma única nota fiscal, o sistema irá atualizar todo o painel a fim de verificar possíveis alterações. <br /> * Webservice: quando um serviço de integração realiza a chamada do nosso webhook de notas fiscais https://alpha.adapter.net.br/ws/financeiro/webhook/nfcom/atualizar ao final da chamada com sucesso o sistema irá atualizar a nota recebida de acordo com os dados. Ou seja, a cada nota recebida pelo webhook a mesma será atualizada automaticamente no painel.<br /> <br /> '''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz<br /> <br /> '''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz<br /> <br /> '''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz <br /> <br /> '''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.<br /> <br /> '''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter<br /> <br /> '''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota<br /> <br /> '''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota<br /> <br /> '''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota<br /> <br /> '''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante<br /> <br /> <br /> Os dados desse painel se encontram em tabela especifica para monitoramento das notas no módulo BI. As notas que nessa tabela se encontram diferente de Autorizadas serão exibidas na funcionalidade de notas rejeitadas da NFCom para novo envio após ajustes.<br /> <br /> <br /> '''Impressão da DANFE-COM'''<br /> <br /> A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:<br /> <br /> Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.<br /> <br /> IMPORTANTE: se ao clicar nesse botão de impressão ser impressa a fatura e não a nota é porque ela não está integrada/autorizada.<br /> <br /> Fatura unificada: através do link da DANFE-COM na fatura unificada<br /> <br /> '''Relatórios''' <br /> <br /> Para conferencia dos processos de emissão da NFCom, além dos dashboards de acompanhamento com relatórios individualizados por widgets, o Adapter irá disponibilizar os seguintes relatórios<br /> <br /> '''NFCom - XML Item Nota :''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por itens.<br /> <br /> '''NFCom - XML Nota:''' permite a visualização de dados na ordem do XML da Danfe-Com para conferencia de dados. Relatório agrupado por nota.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.<br /> <br /> '''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.<br /> <br /> '''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.<br /> <br /> <br /> '''Contestação'''<br /> <br /> Conceito: Contestação de NFCom é um evento registrado na SEFAZ pelo tomador do serviço (ou por seu representante) para manifestar discordância formal de uma NFCom já autorizada — por exemplo, por cobrança indevida, valores/serviços divergentes ou vínculo indevido. Em virtude dessa exigência o sistema disponibilizou uma nova funcionalidade conforme segue.<br /> <br /> Informações relevantes sobre a NFCom que refletem sobre a contestação<br /> <br /> Ao emitir a NFCom, tudo que impacta o valor da fatura deve constar como item na NFCom, com o tratamento fiscal correto (tributado, isento, não incidência, terceiro, etc.). Ou seja, de acordo com essa regra, uma fatura contenha dados de todos os modelos de nota ainda deverá, mesmo emitindo a nota dos outros modelos declarar esses itens na NFCom. <br /> <br /> Exemplo legado (Anterior a NFCom)<br /> Valor plano: 100,00<br /> <br /> [[Arquivo:Contesta.png|500x500px|miniaturadaimagem|centro|Exemplo contestação]]<br /> <br /> Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano <br /> <br /> '''Exemplo nova regra'''<br /> <br /> [[Arquivo:Contesta1.png|500x500px|miniaturadaimagem|centro|Exemplo nova regra]]<br /> <br /> Nota de débito no valor 20,00<br /> <br /> NFSe 50,00<br /> <br /> NFCom 100,00 de acordo com o valor de fatura<br /> <br /> Ou seja, os itens que são tributados por ISS ou apenas impostos federais não tem o modelo alterado, apenas informados na NFCom em caráter informativo.<br /> <br /> A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação<br /> <br /> * As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz<br /> * Todos os demais modelos de nota deverão estar emitidos antes da integração da NFCom com a Sefaz, pois o valor enviado para a integração é sobre itens de nota e não sobre fato gerador (faturamento mês/extrato)<br /> * Faturas/Faturamentos com notas fiscais já emitidas não podem mais sofrer ajustes diretos (edição de valores, cancelamento etc.). Se tem nota emitida independente de ser NFCom ou não a fatura deve ser contestada.<br /> * A NFCom portanto deve ser o ultimo passo da geração do faturamento a fim de garantir todas as dependências de sua emissão.<br /> <br /> <br /> '''Configurações:''' <br /> <br /> '''Permissão de usuário:''' atribuído de acordo com a alçada de aprovação no provedor, o usuário precisará receber permissão separada de contestar e aprovar ou ambas.<br /> <br /> APROVAR REPROVAR CONTESTACOES - EF15<br /> CONTESTAR EXTRATOS NOTAS - EF14<br /> <br /> '''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .<br /> <br /> '''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz. <br /> <br /> '''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar<br /> <br /> <br /> <br /> Ao clicar na opção serão apresentados os itens da fatura a ser contestada<br /> <br /> IMPORTANTE: se a flag para selecionar o item não aparecer eventualmente é porque o item não possui nota fiscal emitida e não pode ser contestado e pode ter ocorrido alguma falha no sistema.<br /> <br /> [[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]<br /> <br /> <br /> A contestação pode ser realizada:<br /> <br /> * Apenas um item da fatura <br /> * Vários itens da fatura<br /> * Todos os itens da fatura<br /> * Valor integral dos itens (deixar fatura zerada)<br /> * Valor integral de alguns itens e etc.<br /> <br /> Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações<br /> <br /> <br /> [[Arquivo:Extrato contesta.png|500x500px|miniaturadaimagem|centro|Estratos a contestar]]<br /> <br /> <br /> Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores<br /> <br /> Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional<br /> <br /> Confirmar a contestação não tem nenhuma ação no sistema, apenas irá gravar a informação. Se o usuário possuir permissão ele poderá analisar/aprovar o registro <br /> <br /> <br /> Ao clicar em analisar :<br /> <br /> <br /> [[Arquivo:Analise Cont.png|500x500px|miniaturadaimagem|centro|Analisar contestação]]<br /> <br /> <br /> Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.<br /> <br /> <br /> [[Arquivo:Aprov cont.png|500x500px|miniaturadaimagem|centro|Analise contestação]]<br /> <br /> <br /> Ao aprovar terá uma serie de regras de negócios de acordo com os cenários de data de emissão da nota x data de contestação<br /> <br /> a) Contestação de faturas em aberto<br /> <br /> Dentro do mês de emissão, se a contestação da fatura ocorrer dentro do mesmo mês em que a(s) nota(s) foi(ram) emitidas então o comportamento do sistema será:<br /> <br /> * Cancelar a(s) nota(s) contestada(s) independente do modelo <br /> * Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)<br /> * Gerar novos faturamentos com novos valores e vencimento se informado.<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Emitir a(s) nova(s) nota(s) com novo(s) valor(es)<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> Fora do mês de emissão:<br /> <br /> * As notas do tipo ND e NFSe não devem sofrer cancelamento fora do período portanto nada deve ser feito em relação a elas e não devem ser geradas novas a fim de não causar bitributação ao provedor<br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Se a contestação possuir um ou mais itens dos modelos NFCom ou Modelo 22/21 então o sistema deverá gerar uma nova nota de substituição (Finalidade emissão 3) com novos valores informados. Nesse cenário a NFCom deverá conter apenas os itens de NFCom ou modelo 22/21.<br /> * Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida<br /> <br /> b) Contestação de faturas pagas <br /> <br /> * A contestação de faturas pagas não irá gerar efeito de cancelamento e geração de novas notas em nenhum contexto, seja a contestação realizada dentro ou fora do mês <br /> * Emitir uma nova fatura com novo valor e novo vencimento se informado <br /> * Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.<br /> * Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO<br /> * A rotina de controle de créditos de fatura deverá estar configurada para ao executar verificar se o cliente possui fatura em aberto e lançar o valor como desconto contestação nas informações adicionais de fatura <br /> * A rotina também deverá criar um registro de fatura alterada para atualização do valor de fatura no banco da forma de cobrança<br /> * A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=P%C3%A1gina_principal&diff=3523 2025-12-16T12:11:47Z

<p>Caio.silva: /* Atualizações: */</p> <hr /> <div><br /> ==== ''Integrações'' ==== <br /> * [[Menu Integrações|Integrações]]&lt;br /&gt;<br /> ==== ''Atualizações:'' ====<br /> <br /> * [[Ano 2021]]<br /> * [[Ano 2022]]<br /> * [[Ano 2023]]<br /> * [[Ano 2024]]<br /> * [[Janeiro/Fevereiro 2025]]<br /> * [[Março/Abril 2025]]<br /> * [[Maio 2025]]<br /> * [[Junho/Julho 2025]]<br /> * [[Agosto/Setembro 2025]]<br /> * [[Out/Nov/Dez 2025]]<br /> <br /> ==== ''BUG'S'' ====<br /> <br /> * [[2022]]<br /> * [[2023]]<br /> * [[2024]]<br /> * [[Bugs Janeiro/Fevereiro 2025|Janeiro/Fevereiro 2025]]<br /> * [[Bugs Março/Abril 2025|Março/Abril 2025]]<br /> * [[Bugs Maio 2025|Maio 2025]]<br /> * [[Bugs Juho/Julho 2025|Junho/Julho 2025]]<br /> * [[Bugs Agosto/Setembro 2025|Agosto/Setembro 2025]]<br /> * [[Bugs Outubro 2025|Outubro 2025]]<br /> <br /> ==== ''MIgração'' ====<br /> * [[Migração]]</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=P%C3%A1gina_principal&diff=3522 2025-12-16T12:10:37Z

<p>Caio.silva: /* Atualizações: */</p> <hr /> <div><br /> ==== ''Integrações'' ==== <br /> * [[Menu Integrações|Integrações]]&lt;br /&gt;<br /> ==== ''Atualizações:'' ====<br /> <br /> * [[Ano 2021]]<br /> * [[Ano 2022]]<br /> * [[Ano 2023]]<br /> * [[Ano 2024]]<br /> * [[Janeiro/Fevereiro 2025]]<br /> * [[Março/Abril 2025]]<br /> * [[Maio 2025]]<br /> * [[Junho/Julho 2025]]<br /> * [[Agosto/Setembro 2025]]<br /> * [[Outubro 2025]]<br /> <br /> ==== ''BUG'S'' ====<br /> <br /> * [[2022]]<br /> * [[2023]]<br /> * [[2024]]<br /> * [[Bugs Janeiro/Fevereiro 2025|Janeiro/Fevereiro 2025]]<br /> * [[Bugs Março/Abril 2025|Março/Abril 2025]]<br /> * [[Bugs Maio 2025|Maio 2025]]<br /> * [[Bugs Juho/Julho 2025|Junho/Julho 2025]]<br /> * [[Bugs Agosto/Setembro 2025|Agosto/Setembro 2025]]<br /> * [[Bugs Outubro 2025|Outubro 2025]]<br /> <br /> ==== ''MIgração'' ====<br /> * [[Migração]]</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=P%C3%A1gina_principal&diff=3521 2025-12-16T12:10:13Z

<p>Caio.silva: /* Atualizações: */</p> <hr /> <div><br /> ==== ''Integrações'' ==== <br /> * [[Menu Integrações|Integrações]]&lt;br /&gt;<br /> ==== ''Atualizações:'' ====<br /> <br /> * [[Ano 2021]]<br /> * [[Ano 2022]]<br /> * [[Ano 2023]]<br /> * [[Ano 2024]]<br /> * [[Janeiro/Fevereiro 2025]]<br /> * [[Março/Abril 2025]]<br /> * [[Maio 2025]]<br /> * [[Junho/Julho 2025]]<br /> * [[Agosto/Setembro 2025]]<br /> * [[Outubro/Novembro/Dezembro 2025]]<br /> <br /> ==== ''BUG'S'' ====<br /> <br /> * [[2022]]<br /> * [[2023]]<br /> * [[2024]]<br /> * [[Bugs Janeiro/Fevereiro 2025|Janeiro/Fevereiro 2025]]<br /> * [[Bugs Março/Abril 2025|Março/Abril 2025]]<br /> * [[Bugs Maio 2025|Maio 2025]]<br /> * [[Bugs Juho/Julho 2025|Junho/Julho 2025]]<br /> * [[Bugs Agosto/Setembro 2025|Agosto/Setembro 2025]]<br /> * [[Bugs Outubro 2025|Outubro 2025]]<br /> <br /> ==== ''MIgração'' ====<br /> * [[Migração]]</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Outubro_2025&diff=3440 2025-10-22T11:42:56Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.<br /> <br /> ==BUG - Verificação baixa pagamento webhook itau==<br /> <br /> Foi identificado que, ao receber o payload do webhook de cobrança do Itaú, o sistema não conseguia localizar corretamente o número do boleto quando existiam registros com o mesmo número, diferenciando-se apenas pelos zeros à esquerda.<br /> Isso fazia com que a fatura não fosse encontrada durante o processo de baixa.<br /> Correção realizada: ajustada a lógica de busca da fatura para considerar também o valor informado no body do webhook, garantindo a identificação correta do boleto mesmo em casos de números semelhantes.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Outubro_2025&diff=3439 2025-10-22T11:40:02Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;<br /> <br /> ==BUG - Formatação incorreta do número para contato na central do assinante==<br /> <br /> Ajuste visual no número de contato do WhatsApp para quando esse número não possuir DDD.<br /> <br /> ==BUG - Fatura impressa via sistema e via rotina estão divergindo==<br /> <br /> Corrigido cenário onde envio de fatura via e-mail pela rotina, estava enviando o código de barras mesmo quando a forma de cobrança da fatura era cartão recorrente. Neste caso no lugar do código de barras deve enviar o texto &quot;Demonstrativo de conta&quot;.<br /> <br /> ==BUG - Baixa quando NumeroDocumento não está presente no arquivo retorno - ITAÚ CNAB 400==<br /> <br /> Identificado problema no processamento do arquivo retorno ITAÚ CNAB 400: as faturas não eram baixadas quando o campo NumeroDocumento vinha em branco no arquivo.<br /> O sistema dependia desse campo para localizar as faturas.<br /> Correção realizada: ajustado o processo de baixa para permitir que as faturas sejam reconhecidas e baixadas mesmo quando o campo NumeroDocumento no arquivo retorno estiver em branco.<br /> <br /> ==BUG - Usuário sem a permissão CN37 consegue suspender contratos==<br /> <br /> Foi identificado que era possível suspender ou suspender parcialmente contratos mesmo sem a permissão “SUSPENDER CONTRATOS - CN37”.<br /> O comportamento esperado é que esses botões fiquem bloqueados para usuários sem essa permissão, assim como ocorre com outras ações restritas.<br /> Correção realizada: ajustado o sistema para que os botões de suspensão e suspensão parcial fiquem desabilitados quando o usuário não possuir a permissão correspondente.</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Outubro_2025&diff=3438 2025-10-22T11:30:43Z

<p>Caio.silva: Criou página com '==AUTENTICAÇÃO== ==COMERCIAL== ==FINANCEIRO== ==INTEGRAÇÃO== ==INTRANET== ==ESTOQUE== ==OPERACIONAL== ==RELATÓRIOS== ==REDES== ==ROTINAS== ==TELEFONIA== ==APLICATIVOS== ==API's== ==CENTRAL DO ASSINANTE=='</p> <hr /> <div>==AUTENTICAÇÃO==<br /> <br /> ==COMERCIAL==<br /> <br /> ==FINANCEIRO==<br /> <br /> ==INTEGRAÇÃO==<br /> <br /> ==INTRANET==<br /> <br /> ==ESTOQUE==<br /> <br /> ==OPERACIONAL==<br /> <br /> ==RELATÓRIOS==<br /> <br /> ==REDES==<br /> <br /> ==ROTINAS==<br /> <br /> ==TELEFONIA==<br /> <br /> ==APLICATIVOS==<br /> <br /> ==API's==<br /> <br /> ==CENTRAL DO ASSINANTE==</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=P%C3%A1gina_principal&diff=3437 2025-10-22T11:28:50Z

<p>Caio.silva: /* Atualizações: */</p> <hr /> <div><br /> ==== ''Integrações'' ==== <br /> * [[Menu Integrações|Integrações]]&lt;br /&gt;<br /> ==== ''Atualizações:'' ====<br /> <br /> * [[Ano 2021]]<br /> * [[Ano 2022]]<br /> * [[Ano 2023]]<br /> * [[Ano 2024]]<br /> * [[Janeiro/Fevereiro 2025]]<br /> * [[Março/Abril 2025]]<br /> * [[Maio 2025]]<br /> * [[Junho/Julho 2025]]<br /> * [[Agosto/Setembro 2025]]<br /> * [[Outubro 2025]]<br /> <br /> ==== ''BUG'S'' ====<br /> <br /> * [[2022]]<br /> * [[2023]]<br /> * [[2024]]<br /> * [[Bugs Janeiro/Fevereiro 2025|Janeiro/Fevereiro 2025]]<br /> * [[Bugs Março/Abril 2025|Março/Abril 2025]]<br /> * [[Bugs Maio 2025|Maio 2025]]<br /> * [[Bugs Juho/Julho 2025|Junho/Julho 2025]]<br /> * [[Bugs Agosto/Setembro 2025|Agosto/Setembro 2025]]<br /> * [[Bugs Outubro 2025|Outubro 2025]]<br /> <br /> ==== ''MIgração'' ====<br /> * [[Migração]]</div>

Caio.silva https://wiki.adapter.net.br/wiki/index.php?title=Bugs_Outubro_2025&diff=3436 2025-10-13T18:40:22Z

<p>Caio.silva: </p> <hr /> <div>==BUG - Otimizar consulta para selecionar produto na movimentação interna==<br /> <br /> Na tela para selecionar produto foi inserida obrigatoriedade de inserir o código do contrato, só após o preenchimento do mesmo o botão para filtrar poderá ser acionado.<br /> <br /> ==BUG - Alteração na composição remove vínculo com o serviço==<br /> <br /> Ao editar uma composição (clicando no botão salvar na tela Financeiro &gt; Tabelas de apoio &gt; Composição &gt; Composições &gt; Cadastro), caso essa composição tenha vínculo com algum serviço, está sendo perdido esse vínculo.<br /> O vínculo que a composição tem com o serviço pode ser visto na aba 'Vínculos' na tela da composição (IDServico na TB_Composicao).<br /> <br /> ==BUG - Erro visual ao cancelar fatura==<br /> <br /> Vendido um contrato onde é automaticamente gerada uma fatura referente ao serviço. Posteriormente ao tentar cancelar essa fatura em: Cancelar &gt; Deseja reverter o último faturamento? SIM &gt; Selecionar um motivo de cancelamento e confirmar, é gerado um erro na tela. Cancelamento é feito com sucesso. Erro apenas visual.<br /> <br /> ==BUG - Erro ao tentar excluir plano==<br /> <br /> 1 - Ao tentar excluir um plano que possui registro na TB_DadosFinanceiroPlano retorna erro.<br /> Na tela é mostrada a mensagem de erro: &quot;Não foi possível excluir esse plano, pois o mesmo possui contrato vinculado&quot;.<br /> Necessário ajuste para que registro na TB_DadosFinanceiroPlano não impeça exclusão do plano, neste caso o registro deve ser apagado.<br /> <br /> 2 - Outro ponto ajustado é que ao gerar erro citado acima, por exemplos registros desse plano na TB_LogPlano são excluídos. Neste caso deve ser feito um rollback, pois se o plano não pôde ser excluído da TB_LogPlano, não deve ser excluído nenhum outros registro relacionado a esse plano em outras tabelas.<br /> <br /> ==BUG - Erro para atendimento em contrato da tecnologia OUTROS - APP do técnico==<br /> <br /> Em processo no app do técnico, no atendimento de instalação era mostrada uma tela onde estava fixo a palavra 'teste'. Remoção feita. Sem alteração no processo do app.<br /> <br /> ==BUG - Validação de TipoEndereco ao converter plano prospectado==<br /> <br /> Corrigida possibilidade de através de conversão de prospecto, plano prospectado ser criado com apenas endereço de instalação, ou apenas endereço de cobrança. Inserida validação já existente para endereços no momento da venda de um novo contrato. Será apresentada a mensagem: &quot;O cliente deve possuir pelo menos um endereço de PADRÃO ou um endereço de INSTALAÇÃO e um de COBRANÇA.&quot;</div>

Caio.silva