Outubro 2025 - Histórico de revisão

Philip.alves: /* Integração NFCOM */

2025-12-02T20:45:50Z

Integração NFCOM

← Edição anterior		Edição das 20h45min de 2 de dezembro de 2025
Linha 447:		Linha 447:

	Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações		Ao marcar o sistema irá apresentar os campos abaixo para preenchimento das informações


	[[Arquivo:Extrato contesta.png\|500x500px\|miniaturadaimagem\|centro\|Estratos a contestar]]		[[Arquivo:Extrato contesta.png\|500x500px\|miniaturadaimagem\|centro\|Estratos a contestar]]


	Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores		Ao informar os valores de desconto o sistema irá automaticamente calcular os novos valores

Linha 456:		Linha 458:
	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		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

	Ao clicar em analisar
			Ao clicar em analisar :


	[[Arquivo:Analise Cont.png\|500x500px\|miniaturadaimagem\|centro\|Analisar contestação]]		[[Arquivo:Analise Cont.png\|500x500px\|miniaturadaimagem\|centro\|Analisar contestação]]


	Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.		Usuário poderá reprovar e apenas ficará registrada a solicitação sem nenhuma ação sobre as notas e faturas do cliente.


	[[Arquivo:Aprov cont.png\|500x500px\|miniaturadaimagem\|centro\|Analise contestação]]		[[Arquivo:Aprov cont.png\|500x500px\|miniaturadaimagem\|centro\|Analise contestação]]


	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		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

Philip.alves: /* Integração NFCOM */

2025-12-02T20:43:57Z

Integração NFCOM

@@ Linha 379: / Linha 379: @@
 '''FATURAMENTO - Total de NF por Serviço (Analítico) :'''  mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.
 '''Contestação'''
@@ Linha 413: / Linha 414: @@
 *    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.
 *    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.
 ==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T20:24:22Z

Integração NFCOM

← Edição anterior		Edição das 20h24min de 2 de dezembro de 2025
Linha 379:		Linha 379:

	'''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.		'''FATURAMENTO - Total de NF por Serviço (Analítico) :''' mantêm a estrutura atual do relatório e inclui novos campos pertinentes a NFCOM.

			'''Contestação'''

			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.

			Informações relevantes sobre a NFCom que refletem sobre a contestação

			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.

			Exemplo legado (Anterior a NFCom)
			Valor plano: 100,00

			[[Arquivo:Contesta.png\|500x500px\|miniaturadaimagem\|centro\|Exemplo contestação]]

			Então seriam emitidas 3 notas de cada modelo com o valor total dos itens do plano

			'''Exemplo nova regra'''

			[[Arquivo:Contesta1.png\|500x500px\|miniaturadaimagem\|centro\|Exemplo nova regra]]

			Nota de débito no valor 20,00

			NFSe 50,00

			NFCom 100,00 de acordo com o valor de fatura

			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.

			A partir desse ponto podemos concluir algumas regras de negócios importantes para o funcionamento correto da NFCom e contestação

			* As faturas devem ser emitidas e transmitidas ao banco antes da integração da NFCom com a Sefaz
			* 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)
			* 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.
			* 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.

	==INTRANET==		==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T20:18:10Z

Integração NFCOM

@@ Linha 331: / Linha 331: @@
 *    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.
 *    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.
 ==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T20:14:06Z

Integração NFCOM

@@ Linha 312: / Linha 312: @@
-Os erros cadastrais de composição são impeditivos de geração das notas, uma vez que podem gerar erros graves de tributação.
+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
-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
+[[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]
 ==INTRANET==

Philip.alves: /* INTEGRAÇÃO */

2025-12-02T18:41:21Z

INTEGRAÇÃO

← Edição anterior		Edição das 18h41min de 2 de dezembro de 2025
Linha 293:		Linha 293:

	A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.		A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.


			'''Dashboard: Validador de faturamento'''


			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.

			[[Arquivo:Valid fat.png\|500x500px\|miniaturadaimagem\|centro\|Validador Faturamento]]


			'''Emissão NFCom'''

			Para emitir NFCom será necessário acessar a funcionalidade módulo financeiro - Nota Fiscal - Nota Fiscal Eletrônica - NFCom

			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.

			[[Arquivo:Valid fat1.png\|500x500px\|miniaturadaimagem\|centro\|Alerta validador]]


			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

	==INTRANET==		==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T17:57:42Z

Integração NFCOM

← Edição anterior		Edição das 17h57min de 2 de dezembro de 2025
Linha 213:		Linha 213:
	'''Integridade Cadastral'''		'''Integridade Cadastral'''

	Responsável por ~~pre~~ validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.		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.

	CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo		CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo

	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.		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.

	Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.		Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.

	Indicadores IE validos:		Indicadores IE validos:
	1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido		1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido
	2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO		2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO
	9 - Não contribuinte - não deve ser preenchido		9 - Não contribuinte - não deve ser preenchido

	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.		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.

	Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos		Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos

	Numero: não pode ser em branco e nem conter caracteres especiais		Numero: não pode ser em branco e nem conter caracteres especiais

	Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE		Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE

	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.)		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.)

	UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE		UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE

	Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos		Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos

	E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais		E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais

	'''
	Dados Fiscais'''		'''Dados Fiscais'''

	Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos		Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos
Linha 272:		Linha 283:

	Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget		Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget
	Exemplo
			Exemplo:

			[[Arquivo:Erros valida.png\|500x500px\|miniaturadaimagem\|centro\|Validador erros]]

			Ao clicar sobre o numero 6 irá apresentar o relatório para analise de todos os erros

			[[Arquivo:Erros valida 1.png\|500x500px\|miniaturadaimagem\|centro\|Erros Cadastrais]]

			A atualização dos campos pode ser realizada no intervalo desejado pelo provedor, bastando realizar a configuração da coleta.

	==INTRANET==		==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T17:49:50Z

Integração NFCOM

← Edição anterior		Edição das 17h49min de 2 de dezembro de 2025
Linha 192:		Linha 192:

	Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.		Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.



			'''PROCESSOS NFCOM'''

			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.

			Os dados validados nesses painéis são cadastrais, e validam

			* Clientes que tiveram um contrato cadastrado nos últimos 90 dias
			* Todas as composições cadastradas
			* Possíveis impedimentos de emissão/integração da NFCom

			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.


			[[Arquivo:Validador fical.png\|500x500px\|miniaturadaimagem\|centro\|Pré Validador fiscal]]


			'''Integridade Cadastral'''

			Responsável por pre validar os dados de clientes obrigatórios nas integrações e formatados por determinados padrões documentados nas secretarias municipais e de estado.

			CPF/CNPJ: indica clientes com números de documento incorretos segundo as regras estabelecidas para a validade do campo
			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.
			Indicador IE: combinado ao IE irá validar se o indicador informado no cadastro do cliente está consistente com a IE informada.
			Indicadores IE validos:
			1 - Contribuinte do ICMS - se informado indicador 1 o campo IE deve estar obrigatoriamente preenchido e valido
			2 - Contribuinte Isento - deve ser preenchido com o literal ISENTO
			9 - Não contribuinte - não deve ser preenchido
			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.
			Endereço: valida o tamanho do nome do logradouro, segundo as regras não pode ser maior que 60 dígitos
			Numero: não pode ser em branco e nem conter caracteres especiais
			Cep: deve ter um número inicial de acordo com o estado (UF) do endereço do cliente segundo as regras do IBGE
			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.)
			UF IBGE: não pode estar em branco e estar de acordo com a tabela de estados do IBGE
			Telefone: não pode estar branco e precisa ter formato dentro da mascara esperada, não pode ter números repetidos seguidos
			E-mail: precisa estar no formato padronizado, não pode ser branco, não pode conter caracteres especiais

			'''
			Dados Fiscais'''

			Impostos: possui uma serie de combinações para validar se os impostos configurados em uma composição fiscal estão corretos

			Exemplo:
			PIS 1.65 exige COFINS 3.00
			PIS 0.65 exige COFINS 7.60
			ICMS 0 com modelo 21, 22 ou 62 exige tipo ICMS = OUTROS
			ICMS 0 fora dos modelos 21, 22 ou 62 exige tipo ICMS = ISENTO

			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.

			Exemplo de erro:
			Tipo serviço = 2 COMUNICACAO DE DADOS
			Classificação Fiscal = 0101 - Assinatura de serviços de telefonia

			Contábil: também realiza combinações para exigir o preenchimento de dados

			Exemplo:
			ICMS 0 exige contas débito e crédito preenchidas
			Conta de Contrapartida Crédito obrigatória

			'''Outros Campos'''

			Total Erros: contabiliza o total de erros encontrados no cadastro de clientes.

			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

			Exemplo
			Hoje: 03/07/2025
			Último dia do mês para emitir notas: 31/07/2025
			Diferença de dias: 28 dias
			Total de erros: 635
			Média de correções por dia: 23

			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.

			'''Outras Funcionalidades'''

			Ao clicar sobre cada tipo de erro no painel o sistema irá baixar um arquivo Excel com os dados daquele widget
			Exemplo

	==INTRANET==		==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T14:52:51Z

Integração NFCOM

← Edição anterior		Edição das 14h52min de 2 de dezembro de 2025
Linha 188:		Linha 188:

	[[Arquivo:Chave nfcom.png\|500x500px\|miniaturadaimagem\|centro\|Chave rotina para integração de NFCom]]		[[Arquivo:Chave nfcom.png\|500x500px\|miniaturadaimagem\|centro\|Chave rotina para integração de NFCom]]

			'''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.

			Ainda para integração foram criadas as spuBuscaNotaIntegracaoNFCom, spuBuscaItemNFCom as tabelas TB_NotaFiscalNFcom, TB_LogNotaFiscalNFCom.

	==INTRANET==		==INTRANET==

Philip.alves: /* Integração NFCOM */

2025-12-02T14:03:48Z

Integração NFCOM

← Edição anterior		Edição das 14h03min de 2 de dezembro de 2025
Linha 175:		Linha 175:

	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:		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:


	[[Arquivo:Integradora de notas.png\|500x500px\|miniaturadaimagem\|centro\|Integradora de notas]]		[[Arquivo:Integradora de notas.png\|500x500px\|miniaturadaimagem\|centro\|Integradora de notas]]

	[[Arquivo:Urls notas.png\|500x500px\|miniaturadaimagem\|centro\|Cadastros de urls para a integracao]]		[[Arquivo:Urls notas.png\|500x500px\|miniaturadaimagem\|centro\|Cadastros de urls para a integracao]]

			[[Arquivo:Acoes notas.png\|500x500px\|miniaturadaimagem\|centro\|Ações para integração de notas fiscais ]]

			'''Rotina notas eletrônicas'''

			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.

			[[Arquivo:Chave nfcom.png\|500x500px\|miniaturadaimagem\|centro\|Chave rotina para integração de NFCom]]

	==INTRANET==		==INTRANET==