Adapter - Contribuições do usuário [pt-br]

Agosto/Setembro 2025

2025-12-18T12:07:50Z

Philip.alves: /* Ajuste Integração Watch (edição de dados pessoais) */

==AUTENTICAÇÃO==

==COMERCIAL==

===Fluxo de alteração de mapeamento e alteração de titularidade no Geogride===

Para mudanças em informações de cliente (alteração de titularidade) será realizado a requisição POST ao endpoint '''''/integracao/atender''''' na plataforma Geogride.

Para quando ocorre alterações na porta que o cliente esta alocado no Adapter, será realizado a requisição DELETE para o endpoint '''''/integracao/atender/{idPorta}/{idCliente}''''' para liberar a porta na plataforma e logo em seguida vinculado o cliente a nova porta através da requisição PUT para o endpoint '''''/clientes/{idCliente}'''''.

[[Arquivo:Altera mapeamento.png|500x500px|miniaturadaimagem|centro|Alteração mapeamento]]

===Nova flag para modelos de E-mail, SMS e Aviso App===
Criado nova flag "Ativo" no cadastro de modelos de E-mail, modelos de SMS e modelos de aviso no APP para exibição ou não no envios do sistema

[[Arquivo:Mod email.png|500x500px|miniaturadaimagem|centro|Modelo de e-mail]]

'''REGRA:'''

Ao selecionar um modelo de email para envio de fatura na aba "Dados Financeiros", serão exibidos todos os modelos cadastrados que estejam com a flag "Ativo" e "E-mail de cobrança" marcados

Ao selecionar um modelo de sms para envio de código de barras na aba "Dados Financeiros", serão exibidos todos os modelos cadastrados que estejam com a flag "Ativo".

Para a tela de "Envios" do cadastro do cliente, ao selecionar um modelo de sms serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "SMS de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".

Ao selecionar um modelo de e-mail serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "E-mail de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".

Ao selecionar um modelo de aviso no App serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "Aviso de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".

Para a tela de envios em massa (''em Intranet -> Envio de comunicados em massa''), ao selecionar um modelo de sms serão carregados todos os modelo que estiverem marcados "Ativo" e foram do tipo de envio MARKETING.

[[Arquivo:Envio massa.png|500x500px|miniaturadaimagem|centro|Envio de comunicado em massa]]

===Aplicação de trial de velocidade no cadastro do contrato===
Para utilização da funcionalidade foi criado uma nova flag '''''Trial na venda''''' no cadastro do plano (Comercial > Tabelas de apoio > Planos > Cadastro) como mostra imagem a seguir.

[[Arquivo:Trial na venda.png|500x500px|miniaturadaimagem|centro|Trial na venda]]

Estando com a flag marcada no plano, ao criar um novo contrato será exibido uma nova seção '''Dados de trial de velocidade''' onde estará disponível para a seleção a velocidade de degustação e o período que ficará disponível esta velocidade.

[[Arquivo:Velocidade trial.png|500x500px|miniaturadaimagem|centro|Seleção velocidade trial ]]

===Filtro de arquivos por contrato===

Implementado no cadastro do cliente na tela de '''"Dados Pessoais"''' no menu lateral de '''"Arquivos"''', os novos filtros de ''"Status do Contrato"'' e ''"Filtrar por contrato"'' para adição de documentos.

[[Arquivo:Filtro arquivos1.png|500x500px|miniaturadaimagem|centro|Novos filtros para adição de arquivos]]

Os novos filtros criados também ficarão disponíveis para filtrar arquivos na tela

[[Arquivo:Filtro arquivos2.png|500x500px|miniaturadaimagem|centro|Seleção de arquivos]]

===Limitação de distância para fechamento de OS===

Para a funcionalidade foi criada uma chave de configuração no módulo comercial '''"DISTANCIA_MAXIMA_TECNICO_CLIENTE_OS"''' (valor informado em metros).
No cadastro de Tipos de atendimento foi criado uma nova flag '''"Verifica local técnico"''' para que seja validado no momento do fechamento do atendimento no App de Técnico

[[Arquivo:Verifica local.png|500x500px|miniaturadaimagem|centro|Tipos de atendimento ]]

'''REGRA:'''

Caso chave seja null, o sistema irá manter a funcionalidade sem controle de distância para fechamento comoé atualmente.

Caso chave não seja igual null e tipo de atendimento tem atributo “Verifica local técnico” desmarcado,o sistema irá manter a funcionalidade sem controle de distância para fechamento como é atualmente.

Caso a chave não seja null e tipo de atendimento tem atributo “Verifica local técnico” marcado, o sistema irá olhar a localização atual do técnico calcular a distância entre o ponto georreferenciado atual do mesmo e o endereço (INSTALAÇÃO se houver, ou PADRÃO). Se a distancia calculada for maior que a informada na chave de configuração, o app de técnico irá apresentar mensagem “Você se encontra muito longe do local apontado para execução dessa OS. Favor volte ao local para ser possível realizar o fechamento” e não realizar o fechamento da OS.

[[Arquivo:Captura de tela 2025-09-23 160348.png|500x500px|miniaturadaimagem|centro|Fechamento atendimento app de técnico ]]

'''OBS:''' Para que não seja comprometida a funcionalidade de alteração de latitude x longitude no cadastro de endereço do contrato, foi criado também a nova chave '''ATUALIZA_LATITUDE_LONGITUDE_NA_ATIVACAO''' onde por default assumirá valor = 1. Caso seja = 0 não ocorrerá a atualização das coordenadas no momento da ativação.

===Token de cancelamento===
Para a funcionalidade foi criado no módulo comercial uma tela para cadastro de tipos de cancelamento (''em Comercial > Tabelas de apoio > Contratos > Tipos de cancelamento''). Para ter acesso a essa tela foi criada a permissão por perfil ('''ALTERAR_TIPOS_CANCELAMENTO CN104''')

[[Arquivo:Tipo cancela.png|500x500px|miniaturadaimagem|centro|Tipos de cancelamento]]

No cadastro o usuário poderá configurar qual Modelo de E-MAIL, SMS ou Modelo de Aviso no APP que será enviado no momento do cancelamento.

[[Arquivo:Captura de tela 2025-09-23 204220.png|500x500px|miniaturadaimagem|centro|Cadastro tipo cancelamento]]

Foram criadas as chaves de configuração (modulo comercial) '''“ENVIA_CHAVE_CANCELAMENTO”''' e '''"UTILIZA_TIPO_CANCELAMENTO"'''(esta definindo se será utilizado ou não os tipos de cancelamento por token). O envio do token só será feito caso a chave ENVIA_CHAVE_CANCELAMENTO seja = 1.

Nos modelos de envio sms, e-mail ou aviso app utilizados no tipo de cancelamento onde será solicitado token para validação do cancelamento, deverá constar a variável $tokenCentral.

Ao realizar o cancelamento do contrato via tela, caso a chave UTILIZA_TIPO_CANCELAMENTO = 1, será solicitado a seleção do tipo de cancelamento como mostra imagem a seguir:

[[Arquivo:Selecao token.png|500x500px|miniaturadaimagem|centro|Seleção do tipo de cancelamento]]

Em seguida será encaminhado para o cliente um token através de sms, e-mail ou aviso no app (conforme previamente configurado no tipo de cancelamento), referente ao processo de cancelamento do contrato. Uma vez recebido de token, o mesmo deverá ser informado no modal para conseguir prosseguir com o processo, no modal ainda será possível cancelar o processo ou reenviar o token para o cliente.

[[Arquivo:Token rec.png|500x500px|miniaturadaimagem|centro|Informar o token recebido]]

O cancelamento só terá sucesso quando for informado na tela o token recebido pelo cliente.

===Filtros ao adicionar/consultar arquivos===

Na tela do Cliente > Dados pessoais > Arquivos, ao adicionar novos arquivos foi criada uma opção (não obrigatória) para filtrar status do contrato e contrato. Ao selecionar algum status ou contrato específico, os arquivos serão vinculados de acordo com essa seleção. Caso opte por 'Todos os status' e 'Todos os contratos' o arquivo não será vinculado a algum contrato específico.

[[Arquivo:Aaaaaaaaaaa.jpg|500x500px|miniaturadaimagem|centro|Possibilidade de filtros de status e contrato]]

Posteriormente também será possível utilizar os mesmos filtros para buscar arquivos por status/contrato

==FINANCEIRO==

===Informações complementares em boletos sem remessa===

Criado a nova chave de configuração '''INFORMACAO_COMPLEMENTAR_FATURA_SEM_REMESSA''' (modulo financeiro) para que seja utilizado (de forma opcional) no campo de observações da fatura(''$F{observacaoFatura'') em caso de impressão do boleto sem remessa.

A chave deverá conter a informação que será impressa no boleto sem remessa como mostra imagem de exemplo a seguir:

[[Arquivo:Sem remessa.png|500x500px|miniaturadaimagem|centro|Informação complementar para boletos sem remessa]]

==INTEGRAÇÃO==

===Integração CardHub (Recarga)===

Para possibilitar esse tipo de integração iniciaremos pela configuração do plano. Na configuração do plano de “TECNOLOGIA MOVEL” na aba “Telefonia” foi criado um novo tipo de integração '''RECARGA'''.

[[Arquivo:Plano recarga.png|500x500px|miniaturadaimagem|centro|Cadastro novo plano]]

[[Arquivo:Config integracao.png|500x500px|miniaturadaimagem|centro|Tipo "Recarga"]]

Ao marcar esse tipo de integração, isso garantirá que nenhuma requisição será encaminhada à integradora ao cadastrar um novo contrato de telefonia móvel.
Com o plano devidamente configurado para o tipo de integração '''Recarga''', ao selecionar o plano no cadastro de um novo contrato, será exibido a mensagem '''O plano selecionado é do tipo RECARGA e não irá possibilitar cadastro e/ou manutenção das linhas'''. Como mostra imagem a seguir:

[[Arquivo:Mensagem selecao.png|500x500px|miniaturadaimagem|centro|Seleção contrato plano tipo recarga]]

Ao salvar o contrato, será salvo o registro na TB_DadosVozContrato porém sem informações relevantes para a linha (como número, portabilidade, etc.), esses dados serão posteriormente populados quando encaminhados da integradora para o CRM Adapter.

[[Arquivo:Dadosvoz salvo.png|500x500px|miniaturadaimagem|centro]]

Para possibilitar o envio de informações da linha pela integradora para o Adapter, foi desenvolvido o novo endpoint abaixo, conforme solicitado:

'''Endpoint''': ''https://URL_BASE/ws/comercial/contratos/telefonia_movel/dados_voz/cadastrar''

'''Body''':
<pre>
{
"idContrato": 37944,
"ICCID": "89552600000020552020",
"msisdn": "5531999993700",
"Status": "ATIVO"
}
</pre>

Obs: para mais informações, consulte/solicite o manual do webserver.

A ideia da integração é que a integradora encaminhe para o CRM Adapter os dados posteriormente através do endpoint informado acima. Uma vez encaminhado a requisição com os dados válidos, serão salvos os registros de número na tabela '''TB_DadosVozContrato''' e também serão salvos os dados de Status, msisdn e ICCID na '''TB_DadosVozIntegracao'''.

Após encaminhado a requisição para o Adapter a informação de número do telefone será mostrada na seção '''Dados de Voz''' do contrato.

[[Arquivo:Dados voz pos.png|500x500px|miniaturadaimagem|centro|Dados voz apos envio dos dados]]

===Ajuste Integração Watch (edição de dados pessoais) ===

Ao editar dados de telefone nos '''Dados Pessoais''' do cliente, será realizada a requisição na integradora por método POST para o endpoint '''''v2/assinantes/editPhone'''''.

Ao editar o dado de e-mail nos '''Dados Pessoais''' do cliente, caso o e-mail que esta sendo editado esteja salvo na Tb_DadosContratoTV, o registro nesta tabela também será atualizado e a requisição POST para o endpoint '''''v2/assinantes/editEmail''''' também será encaminhada à integradora para que seja atualizado.

'''OBS:''' Para que o ajuste seja realiza foi criado a chave no modulo de configurações '''ATUALIZA_DADOS_CLIENTE_INTEGRADORAS''', caso valor seja igual a 1 a atualização será realizada.

===Ajuste em URLs de autenticação===

Adicionado nova flag '''Retorno no header''' no cadastro da URL de autenticação (''em Integração -> URLs de autenticação -> Cadastro'') para que o campo a ser recuperado na requisição de autenticação (onde será utilizado posteriormente nas URLs que farão as interações nas integradoras ), seja um campo presente nos headers do retorno da requisição de autenticação.

[[Arquivo:url_auth.png|500x500px|miniaturadaimagem|centro|App Cliente]]

[[Arquivo:headers.png|500x500px|miniaturadaimagem|centro|Headers de retorno da requisição]]

===Integração MVNO DATORA===

Desenvolvido nova integração para tecnologia "TELEFONIA MOVEL" com a plataforma de telefonia DATORA.

As configurações para possibilitar venda de contrato com tecnologia móvel MVNO integrados a plataforma DATORA se iniciam no cadastro do plano. Ao cadastrar um plano com “TECNOLOGIA MOVEL” na aba “Telefonia” do plano estará disponível para a seleção o “Tipo de integração ” e este deverá esta marcado MVNO, com a opção marcada, será habilitado os campos “Quantidade de linha” onde será informado o número de linhas máximo que o plano suporta e o “Código de produto Integradora” (referenciando o iD do produto na plataforma).

'''OBS:''' ao adicionar a quantidade de linhas maior que 1, será habilitado o campo “Código do produto das linhas adicionais” referenciando o id produto “filho” de linhas adicionais na plataforma, até o momento este desenvolvimento não abrange o produto com linhas adicionais

Na tela a seguir também foi adicionado a flag “Altera titular” onde caso não esteja selecionada, não será permitido a realização da alteração de titularidade do contrato após criado.

[[Arquivo:Mvno datora.png|500x500px|miniaturadaimagem|centro|Configuração plano telefonia móvel]]

Para possibilitar a integração na plataforma DATORA, foram criadas algumas ações cadastrada previamente (''em modulo Integração -> Ações de integradoras de voz-> Cadastro'') que realizarão as chamadas na plataforma DATORA. Na nova integração serão aplicadas as seguintes ações configuradas previamente :

<pre>
LISTAR_NUMEROS_DISPONIVEIS (GET endpoint /msisdns?area_code=_AREA_TELEFONE_&status=AVAILABLEE),
LISTAR_SIMCARDS, CADASTRAR_CONTRATO(GET endpoint /available/random ),
CONSULTAR_CHIP (GET endpoint /account/_NUMERO_TELEFONE_),
CADASTRAR_CLIENTE (POST endpoint /activations/create_customer ),
CONSULTAR_CLIENTE (GET endpoint /manager/v1/clients/documents/_DOCUMENTO_CLIENTE_),
CONSULTAR_CONTRATO (/account/_NUMERO_TELEFONE_),
ATIVAR_SIMCARD (POST endpoint /activations/create_subscription_cart),
TROCAR_LINHA_POR_PORTABILIDADE (POST endpoint /portabilities/Create_portability),
ALTERAR_ENDERECO_CLIENTE (PUT endpoint /clients/_CLIENTE_INTEGRADORA_),
ALTERAR_ENDERECO_CONTRATO (PUT endpoint /clients/_CLIENTE_INTEGRADORA_),
ALTERAR_CLIENTE_CONTRATO(PUT endpoint /clients/_CLIENTE_INTEGRADORA_),
ALTERAR_PRODUTO (PUT endpoint /manager/v1/subscriptions/carts/_CONTRATO_INTEGRADORA_),
BLOQUEAR_SIMCARD (PUT endpoint /accounts/blockers/_NUMERO_TELEFONE_),
BLOQUEAR_SIMCARD_PARCIAL(PUT endpoint /accounts/suspensions/_NUMERO_TELEFONE_),
DESBLOQUEAR_SIMCARD (PUT endpoint /accounts/releases/_NUMERO_TELEFONE_),
CANCELAR_SIMCARD (DELETE endpoint /deleteAccount/_CONTRATO_INTEGRADORA_),
REATIVAR_CONTRATO (PUT endpoint /accounts/releases/_NUMERO_TELEFONE_),
TROCAR_SIMCARD (POST endpoint /accounts/_NUMERO_SIM_CARD_/sim-cards/exchanges),
COMPRAR_DADOS (POST endpoint /recharges/create_recharge_cart ),
ATIVAR_COMPRA_DADOS (POST endpoint /manager/v1/recharges/carts/_CONTRATO_UNICO_INTEGRADORA_/moneys )
</pre>

[[Arquivo:acao_datora.png|500x500px|miniaturadaimagem|centro|Configuração ação integradora voz]]

Onde cada ação ficará a cargo de requisitar um endpoint (citados mais acima) na integradora DATORA.

Ao realizar o cadastro de um novo contrato para o cliente, na seção de “Dados Voz” do contrato que esta sendo cadastrado, ao informar o código de área será chamado ação '''LISTAR NUMEROS DISPONÍVEIS''' onde será exibido no combobox ao lado o resultado da requisição com os número disponíveis para a área de cobertura informada

[[Arquivo:Selecao numero.png|500x500px|miniaturadaimagem|centro|Seleção de número]]

Ao clicar para salvar o novo contrato será exibido o modal para a seleção do tipo de SIMCARD como mostra imagem a seguir:

[[Arquivo:Captura de tela 2025-09-23 103405.png|500x500px|miniaturadaimagem|centro|Seleção tipo simcard]]

Caso selecionado o tipo SIMCARD físico será aberto um novo modal para inserção do simcard e em seguida o contrato no sistema e as chamadas de criação do cliente e do contrato serão realizadas na plataforma de telefonia.'''OBS:''' quando selecionado este tipo de SimCard o contrato só será salvo após o preenchimento da informação.

[[Arquivo:Captura de tela 2025-09-23 103428.png|500x500px|miniaturadaimagem|centro|SimCard Físico ]]

Caso seja selecionado o tipo '''''eSIM''''', serão realizadas as ações já mencionadas '''CADASTRA CLIENTE''', '''LISTAR SIM CARDS DISPONIVEIS''' (onde será atribuído um SIMCARD de forma aleatória que estiver disponível) e por fim a ação de '''CADASTRAR CONTRATO''' .

Na plataforma DATORA será validado no momento do cadastro se o CPF é um documento valida na base da Receita Federal e se os dados pessoais informados estão de acordo com as informações encaminhadas no cadastro. Caso possua dados divergente será retornado a critica como mostra exemplo abaixo:

[[Arquivo:Critica datora.png|500x500px|miniaturadaimagem|centro|Erro ao criar contrato na plataforma]]

Caso o cadastro ocorra com sucesso na plataforma, será encaminhado automaticamente um e-mail de configuração para o novo cliente cadastrado.

Ao habilitar o contrato no Adapter será encaminhado as ações de ATIVAR SIM CARD e um novo email de boas vindas será encaminhado automaticamente da integradora para o e-mail cadastrado do cliente.

'''OBS:''' Algumas ações como consulta saldo, zerar saldo ainda não possuem endpoint definido para a integração. Ações de alteração de titularidade e upgrade/downgrade estão em fase de levantamento da regra de negócio contudo poderão ser realizadas no CRM mas ainda não serão encaminhadas a plataforma DATORA, para mais informações consulte o suporte técnico.

[[Arquivo:Acoes datora.png|500x500px|miniaturadaimagem|centro|Ações dados voz contrato]]

Para a integração há a possibilidade da compra de pacote de dados de telefonia, para que seja possível a compra da dados adicionais é necessário realizar o cadastro prévio (''em Comercial -> Tabelas de apoio -> Pacotes -> Pacotes de dados adicionais -> Cadastro'') como mostra imagem a seguir :

[[Arquivo:Cadastro dados.png|500x500px|miniaturadaimagem|centro]]

Então com o contrato habilitado ao clicar no botão “Compra pacote de dados” serão exibidos todos os pacotes de dados cadastrados previamente disponíveis para a compra

[[Arquivo:Compra dados.png|500x500px|miniaturadaimagem|centro|Compra pacote de dados]]

Quando selecionado o pacote de interesse e confirmado a compra serão chamadas as ações de COMPRAR DADOS e em seguida ATIVAR COMPRA DADOS para de fato efetivar a compra na plataforma.
No CRM Adapter será lançado para o cliente um serviço adicional para o contrato e este será faturado no próximo vencimento.

Para as ações de suspensão, suspensão parcial, habilitação em confiança e habilitação do contrato (reativação do contrato) serão também realizadas as respectivas interações na plataforma de telefonia móvel DATORA.

Ainda na integração com a plataforma, após o contrato salvo há a possibilidade de consulta do status do chip e troca de linha por portabilidade

[[Arquivo:Dados v.png|500x500px|miniaturadaimagem|centro|Dados voz disponiveis no contrato]]

Ao clicar e "Status do SIM Card" será exibido um modal com as informações do simcard:

[[Arquivo:Infor SIMcard.png|500x500px|miniaturadaimagem|centro|Informações do SIMCARD]]

Ao clicar em "Trocar por portabilidade" será exibido um modal para informar o numero a ser realizado a portabilidade

[[Arquivo:Troca portabilidade.png|500x500px|miniaturadaimagem|centro|Troca linha por portabilidade]]

==INTRANET==

===Habilitação em confiança para webservice===

Criado nova chave de configuração (modulo intranet) '''PERMITE_HABILITAR_CONFIANCA''' (valor 0 ou 1), para funcionalidade de habilitação em confiança através de canais digitais usando os endpoints (''/ws/comercial/contrato/habilitar_confianca'' e ''ws/comercial/contrato/ID_CONTRATO/webservice/alterar/status?descricaoStatus=HABILITADO%20EM%20CONFIANCA&acessoCentral=S'' )

OBS: para mais informações de endpoints consulte manual do webserver

===Removido modal de refresh no javascript===

Removido modal de refresh no javascript do navegador quando era salvo as interações no sistema

[[Arquivo:Modal refresh.png|miniaturadaimagem|alt=500x500px||centro|Modal de refresh ]]

==ESTOQUE==

==OPERACIONAL==

==RELATÓRIOS==

==REDES==

==ROTINAS==

==TELEFONIA==

==APLICATIVOS==

===Atualizado nível de API dos Apps Vendas, Cliente e Técnico para Google===

A estrutura básica dos aplicativos não foi alterada. Apenas modificada a compatibilidade com nova API da Google (Android 15).

===Ajuste redefinição de senha e segurança do APP do Cliente/Central do assinante===

Adicionado no App de Cliente e Central do Assinante, novos padrões para redefinição de senha. Criado as novas chaves '''ID_MODELO_EMAIL_RECUPERAR_SENHA''' e '''ID_MODELO_SMS_RECUPERAR_SENHA''' (modulo comercial) para especificação do modelo de email e sms específicos para recuperação de senha nos canais digitais mencionados.

Nos novos modelos de email e sms devem ser utilizados com as variáveis $username$ para nome do cliente e $password$ para senha, o '''Tipo de envio''' deverá ser criado como '''RECUPERACAO_SENHA''' para a funcionalidade.

[[Arquivo:Captura de tela 2025-09-17 093202.png|500x500px|miniaturadaimagem|centro|Modelo de e-mail]]

[[Arquivo:Captura de tela 2025-09-17 093404.png|500x500px|miniaturadaimagem|centro|Modelo SMS]]

<gallery mode="packed" heights="300">
[[Arquivo:Senha app.png|500px|miniaturadaimagem|App Cliente]]

[[Arquivo:Senha central.png|500px|miniaturadaimagem|Central de Assinantes]]
</gallery>

===Cadastro CNI no App de Vendas ===

Adicionado nova flag '''CNI''' no App de vendas para quando o documento cadastrado se tratar de uma Carteira de Identidade Nacional, ao marcar a opção CNI o campo RG ficará desativado.

[[Arquivo:Captura de tela 2025-09-17 211736.png|500x500px|miniaturadaimagem|centro|Cadastro CNI]]

==API's==

===Novas informações do técnico em endpoint de atendimentos===

Adicionado informações do técnico responsável pela visita técnica no retorno do endpoint ''ws/comercial/atendimentos/{idAtendimento}'' (Buscar dados detalhados do atendimento)

Retorno :
<syntaxhighlight lang="json">
{
...
"Contrato": {
"IDContrato": idContrato,
....
},
"IdTecnicoVisita": 151,
"NomeTecnicoVisita": "Fulano da Silva",
"Plano": "INTERNET RESIDENCIAL 600 MBPS",
...
},
"DadosCaixa": {
...
}
</syntaxhighlight>

'''OBS''': para mais informações, solicite o manual do webserver

===Novo endpoint para informações básicas do cliente===

Criado novo endpoint para requisição GET '''''/ws/comercial/cliente/{idCliente: [0-9]+}''''' onde será retornado informações básicas do cliente.Entre os dados de retorno do endpoint, o campo "Ativo" (true ou false) estará relacionado quanto ao cliente possuir ou não contratos ativos na base.

Retorno :

<syntaxhighlight lang="json">
{
"Email": "emailcliente@",
"Empresa": "EMPRESA LTDA",
"NomeCliente": "FULANO DA SILVA",
"TelefoneFixo": "31999999999",
"Ativo": false,
"IDCliente": 1,
"TelefoneMovel": "31999999999",
"Documento": "11111111111",
"Enderecos": [
{
"Logradouro": "RUA ABC",
"UF": "SP",
"Numero": 1,
"Tipo": "PADRAO",
"Complemento": null,
"Condominio": null,
"Referencia": null,
"Bairro": "ABC",
"Cidade": "ABC",
"CEP": "14701220"
},
{
"Logradouro": "RUA ABC",
"UF": "SP",
"Numero": 2,
"Tipo": "PADRAO",
"Complemento": "",
"Condominio": null,
"Referencia": null,
"Bairro": "ABC",
"Cidade": "ABC",
"CEP": "14701320"
}
]
}
</syntaxhighlight>

'''OBS''': para mais informações solicite/consulte o manual do webserver.

==CENTRAL DO ASSINANTE==

===Cadastro de recorrência sem fatura===
Adicionado a possibilidade de cadastro de recorrência na central do assinante e app de cliente, anteriormente era necessário possuir pelo menos uma fatura no contrato que fosse possível o cadastro da recorrência .

[[Arquivo:Recorrencia.png|400x400px|miniaturadaimagem|centro|Cadastro de recorrência central]]

[[Arquivo:Recorrencia app.png|400x400px|miniaturadaimagem|centro|Cadastro de recorrencia app]]

Outubro 2025

2025-12-02T20:45:50Z

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

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

[[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]

Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.

===Alteração Wi-fi - ONU Parks===
Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.

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-> Integradoras), as URLs de autenticação (''em modulo integração ->Integração ->URLs de autenticação'') e URLs (''em modulo integração->Integração-> URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-> Integração ->Ações de integradoras de gerenciador dispositivo'')

[[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]

[[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]

[[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]

[[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]

'''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .

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 "Alterar Wifi"

[[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]

Foi criado também a nova flag '''"Utiliza gerenciador de dispositivos"''' no cadastro de fornecedores de equipamento (''em Comercial-> Tabelas de apoio-> Fornecedor de Equipamento-> Cadastro'')

[[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]

'''Regra:'''

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''marcada''', a alteração de informações do wi-fi só será possível pelo botão "Alterar WIFI" onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;

Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;

==FINANCEIRO==

===Senha em fatura===
Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1).

[[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]

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.

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:

[[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]

===Novos fields para termo de inativação===

Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''

'''Obs''': para implementação consulte suporte técnico.

==INTEGRAÇÃO==

===Integração NFCOM===

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

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.

'''Configurações:'''

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

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

[[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]

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

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

'''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.

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

'''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.

'''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.

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

* Código do modelo: 62

* Série :1

* Pode cancelar fora do período: não marcar

* Integrada: SEFAZ

* Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração

* Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo

'''COMPOSIÇÕES FISCAIS:'''

Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.

[[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]

'''Pagina principal''' – mantêm os dados atuais sem alterações relevantes

'''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo

* Modelo de nota fiscal: NFCom

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

[[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]

* 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.
* CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe
* 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.
* 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
* Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.

'''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.

* Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11
* 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:

Se informado alíquota PIS/COFINS então código da situação será geralmente 01
Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08

[[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]

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

'''Dados fiscais - Impostos municipais'''
Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município

[[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]

'''Importante'''

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

[[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]

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

'''Obs:''' consulte disponibilidade da integração previa com suporte técnico.

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.

[[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]

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

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

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

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:

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

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

[[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]

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.

Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.

'''Dashboard: NFCom Status'''

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.

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.

Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:

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

'''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz

'''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz

'''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz

'''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz

'''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.

'''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter

'''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota

'''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota

'''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota

'''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante

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.

'''Impressão da DANFE-COM'''

A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:

Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.

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.

Fatura unificada: através do link da DANFE-COM na fatura unificada

'''Relatórios'''

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

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

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

'''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.

'''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.

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

'''Configurações:'''

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

APROVAR REPROVAR CONTESTACOES - EF15
CONTESTAR EXTRATOS NOTAS - EF14

'''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .

'''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz.

'''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar

Ao clicar na opção serão apresentados os itens da fatura a ser contestada

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.

[[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]

A contestação pode ser realizada:

* Apenas um item da fatura
* Vários itens da fatura
* Todos os itens da fatura
* Valor integral dos itens (deixar fatura zerada)
* Valor integral de alguns itens e etc.

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

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

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

Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional

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 :

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

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

a) Contestação de faturas em aberto

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

* Cancelar a(s) nota(s) contestada(s) independente do modelo
* Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)
* Gerar novos faturamentos com novos valores e vencimento se informado.
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* Emitir a(s) nova(s) nota(s) com novo(s) valor(es)
* Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida

Fora do mês de emissão:

* 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
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* 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.
* Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida

b) Contestação de faturas pagas

* 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
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO
* 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
* 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
* A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente

==INTRANET==

==ESTOQUE==

==OPERACIONAL==

==RELATÓRIOS==

==REDES==

==ROTINAS==

==TELEFONIA==

==APLICATIVOS==

==API's==

==CENTRAL DO ASSINANTE==

Outubro 2025

2025-12-02T20:43:57Z

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

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

[[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]

Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.

===Alteração Wi-fi - ONU Parks===
Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.

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-> Integradoras), as URLs de autenticação (''em modulo integração ->Integração ->URLs de autenticação'') e URLs (''em modulo integração->Integração-> URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-> Integração ->Ações de integradoras de gerenciador dispositivo'')

[[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]

[[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]

[[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]

[[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]

'''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .

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 "Alterar Wifi"

[[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]

Foi criado também a nova flag '''"Utiliza gerenciador de dispositivos"''' no cadastro de fornecedores de equipamento (''em Comercial-> Tabelas de apoio-> Fornecedor de Equipamento-> Cadastro'')

[[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]

'''Regra:'''

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''marcada''', a alteração de informações do wi-fi só será possível pelo botão "Alterar WIFI" onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;

Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;

==FINANCEIRO==

===Senha em fatura===
Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1).

[[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]

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.

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:

[[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]

===Novos fields para termo de inativação===

Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''

'''Obs''': para implementação consulte suporte técnico.

==INTEGRAÇÃO==

===Integração NFCOM===

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

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.

'''Configurações:'''

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

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

[[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]

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

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

'''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.

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

'''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.

'''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.

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

* Código do modelo: 62

* Série :1

* Pode cancelar fora do período: não marcar

* Integrada: SEFAZ

* Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração

* Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo

'''COMPOSIÇÕES FISCAIS:'''

Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.

[[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]

'''Pagina principal''' – mantêm os dados atuais sem alterações relevantes

'''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo

* Modelo de nota fiscal: NFCom

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

[[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]

* 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.
* CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe
* 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.
* 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
* Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.

'''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.

* Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11
* 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:

Se informado alíquota PIS/COFINS então código da situação será geralmente 01
Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08

[[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]

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

'''Dados fiscais - Impostos municipais'''
Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município

[[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]

'''Importante'''

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

[[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]

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

'''Obs:''' consulte disponibilidade da integração previa com suporte técnico.

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.

[[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]

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

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

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

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:

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

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

[[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]

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.

Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.

'''Dashboard: NFCom Status'''

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.

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.

Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:

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

'''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz

'''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz

'''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz

'''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz

'''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.

'''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter

'''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota

'''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota

'''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota

'''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante

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.

'''Impressão da DANFE-COM'''

A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:

Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.

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.

Fatura unificada: através do link da DANFE-COM na fatura unificada

'''Relatórios'''

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

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

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

'''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.

'''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.

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

'''Configurações:'''

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

APROVAR REPROVAR CONTESTACOES - EF15
CONTESTAR EXTRATOS NOTAS - EF14

'''Motivos de contestação:''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz .

'''Finalidade de emissão :''' devem estar previamente cadastrados e seguindo a codificação oficial da Confaz.

'''Realizar contestação:''' acessar o cadastro de clientes - dados financeiros - faturas - botão contestar

Ao clicar na opção serão apresentados os itens da fatura a ser contestada

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.

[[Arquivo:Btn contesta.png|500x500px|miniaturadaimagem|centro|Contestar fatura]]

A contestação pode ser realizada:

* Apenas um item da fatura
* Vários itens da fatura
* Todos os itens da fatura
* Valor integral dos itens (deixar fatura zerada)
* Valor integral de alguns itens e etc.

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

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

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

Será obrigatório informar o motivo e a observação. A data de novo vencimento é opcional

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

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

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

a) Contestação de faturas em aberto

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

* Cancelar a(s) nota(s) contestada(s) independente do modelo
* Cancelar a fatura e faturamentos mês vinculados a(s) nota(s)
* Gerar novos faturamentos com novos valores e vencimento se informado.
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* Emitir a(s) nova(s) nota(s) com novo(s) valor(es)
* Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida

Fora do mês de emissão:

* 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
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* 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.
* Criar um registro de controle de integração automático para a nota NFCom (se houver) emitida

b) Contestação de faturas pagas

* 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
* Emitir uma nova fatura com novo valor e novo vencimento se informado
* Realizar a integração imediata da nova fatura para casos em que a forma de cobrança do cliente é do tipo eletrônica.
* Lançar o valor contestado no controle de crédito fatura com o tipo de crédito CONTESTAÇÃO
* 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
* 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
* A rotina de integração automática de remessa deverá registrar essa alteração no banco eletronicamente

==INTRANET==

==ESTOQUE==

==OPERACIONAL==

==RELATÓRIOS==

==REDES==

==ROTINAS==

==TELEFONIA==

==APLICATIVOS==

==API's==

==CENTRAL DO ASSINANTE==

Arquivo:Aprov cont.png

2025-12-02T20:41:51Z

Philip.alves:

adapter financeiro

Arquivo:Analise Cont.png

2025-12-02T20:40:42Z

Philip.alves:

adapter financeiro

Arquivo:Extrato contesta.png

2025-12-02T20:35:32Z

Philip.alves:

adapter financeiro

Arquivo:Btn contesta.png

2025-12-02T20:32:16Z

Philip.alves:

adapter financeiro

Outubro 2025

2025-12-02T20:24:22Z

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

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

[[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]

Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.

===Alteração Wi-fi - ONU Parks===
Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.

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-> Integradoras), as URLs de autenticação (''em modulo integração ->Integração ->URLs de autenticação'') e URLs (''em modulo integração->Integração-> URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-> Integração ->Ações de integradoras de gerenciador dispositivo'')

[[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]

[[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]

[[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]

[[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]

'''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .

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 "Alterar Wifi"

[[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]

Foi criado também a nova flag '''"Utiliza gerenciador de dispositivos"''' no cadastro de fornecedores de equipamento (''em Comercial-> Tabelas de apoio-> Fornecedor de Equipamento-> Cadastro'')

[[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]

'''Regra:'''

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''marcada''', a alteração de informações do wi-fi só será possível pelo botão "Alterar WIFI" onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;

Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;

==FINANCEIRO==

===Senha em fatura===
Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1).

[[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]

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.

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:

[[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]

===Novos fields para termo de inativação===

Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''

'''Obs''': para implementação consulte suporte técnico.

==INTEGRAÇÃO==

===Integração NFCOM===

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

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.

'''Configurações:'''

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

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

[[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]

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

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

'''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.

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

'''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.

'''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.

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

* Código do modelo: 62

* Série :1

* Pode cancelar fora do período: não marcar

* Integrada: SEFAZ

* Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração

* Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo

'''COMPOSIÇÕES FISCAIS:'''

Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.

[[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]

'''Pagina principal''' – mantêm os dados atuais sem alterações relevantes

'''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo

* Modelo de nota fiscal: NFCom

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

[[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]

* 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.
* CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe
* 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.
* 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
* Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.

'''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.

* Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11
* 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:

Se informado alíquota PIS/COFINS então código da situação será geralmente 01
Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08

[[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]

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

'''Dados fiscais - Impostos municipais'''
Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município

[[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]

'''Importante'''

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

[[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]

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

'''Obs:''' consulte disponibilidade da integração previa com suporte técnico.

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.

[[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]

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

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

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

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:

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

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

[[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]

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.

Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.

'''Dashboard: NFCom Status'''

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.

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.

Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:

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

'''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz

'''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz

'''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz

'''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz

'''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.

'''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter

'''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota

'''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota

'''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota

'''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante

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.

'''Impressão da DANFE-COM'''

A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:

Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.

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.

Fatura unificada: através do link da DANFE-COM na fatura unificada

'''Relatórios'''

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

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

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

'''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.

'''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.

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

==ESTOQUE==

==OPERACIONAL==

==RELATÓRIOS==

==REDES==

==ROTINAS==

==TELEFONIA==

==APLICATIVOS==

==API's==

==CENTRAL DO ASSINANTE==

Arquivo:Contesta1.png

2025-12-02T20:22:42Z

Philip.alves:

adapter financeiro

Arquivo:Contesta.png

2025-12-02T20:20:31Z

Philip.alves:

adapter financeiro

Outubro 2025

2025-12-02T20:18:10Z

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

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

[[Arquivo:Tempo prov.png|500x500px|miniaturadaimagem|centro|Tempo reprovisionamento]]

Caso o valor da chave esteja vazia será levado em consideracao 300seg (5minutos) entre um provisionamento e outro.

===Alteração Wi-fi - ONU Parks===
Desenvolvido método de alteração das informações de wi-fi do equipamento '''ONU Parks''' onde a alteração é realizada por API REST.

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-> Integradoras), as URLs de autenticação (''em modulo integração ->Integração ->URLs de autenticação'') e URLs (''em modulo integração->Integração-> URLs'' ) e as ações que realizarão a interação na integradora ( ''em modulo integração-> Integração ->Ações de integradoras de gerenciador dispositivo'')

[[Arquivo:Tipo integracao disp.png|500x500px|miniaturadaimagem|centro|Tipo integração gerenciador de dispositivo]]

[[Arquivo:IntegradoraDisp.png|500x500px|miniaturadaimagem|centro|Integradora dispositivo]]

[[Arquivo:UrlsDisp.png|500x500px|miniaturadaimagem|centro|Endpoint de envio para API]]

[[Arquivo:Acao integrad.png|500x500px|miniaturadaimagem|centro|centro|Ação integradora]]

'''OBS:''' para mais detalhes consulte disponibilidade e configuração com suporte técnico .

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 "Alterar Wifi"

[[Arquivo:Altera wi fi.png|500x500px|miniaturadaimagem|centro|Geranciar conexões]]

Foi criado também a nova flag '''"Utiliza gerenciador de dispositivos"''' no cadastro de fornecedores de equipamento (''em Comercial-> Tabelas de apoio-> Fornecedor de Equipamento-> Cadastro'')

[[Arquivo:Captura de tela 2025-11-04 151445.png|500x500px|miniaturadaimagem|centro|alt=Cadastro fornecedor de equipamento]]

'''Regra:'''

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''marcada''', a alteração de informações do wi-fi só será possível pelo botão "Alterar WIFI" onde realizará interação na integradora previamente cadastrado. Os campo SSID Wifi e Senha Wifi estarão desativados para edição;

Caso a permissão e chave mencionada estejam ativa/preenchida e o modelo de fornecedor esteja com a flag "Utiliza gerenciador de dispositivos" '''desmarcada''', os campo SSID Wifi e Senha Wifi estarão liberados para edição;

Caso a permissão e chave mencionada estejam desativada/sem preencher, os campo SSID Wifi e Senha Wifi estarão liberados para edição;

==FINANCEIRO==

===Senha em fatura===
Para a funcionalidade foi criado a chave de configuração (em modulo financeiro) “'''SENHA_PDF_FATURA'''” (valor 0 ou 1).

[[Arquivo:Senha fatura.png|500x500px|miniaturadaimagem|centro|Chave de configuração]]

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.

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:

[[Arquivo:Abre pdf.png|500x500px|miniaturadaimagem|centro|alt=Abertura fatura com senha]]

===Novos fields para termo de inativação===

Foram criados novos fields para retornar a informação de DataInativacaoTemporariaInicio e DataInativacaoTemporariaFim nos modelos de contrato :'''inativacaoTemporariaInicio''' e '''inativacaoTemporariaFim'''

'''Obs''': para implementação consulte suporte técnico.

==INTEGRAÇÃO==

===Integração NFCOM===

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

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.

'''Configurações:'''

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

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

[[Arquivo:Finalidade.png|500x500px|miniaturadaimagem|centro|Finalidade emissão de nota]]

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

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

'''Classificação fiscal:''' para informar o tipo de item, possui codificação oficial do convenio 115 mas será enviado na integração da NFCom.

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

'''Natureza da receita PIS/COFINS:''' com registros oficiais para vinculo no cadastro de composições.

'''CST PIS/COFINS:''' códigos de situação tributária de itens com registros oficiais para vinculo no cadastro de composições.

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

* Código do modelo: 62

* Série :1

* Pode cancelar fora do período: não marcar

* Integrada: SEFAZ

* Integradora: informar quem será a emissora cadastrada mais adiante no módulo integração

* Incidência de impostos: informar cada imposto e respectivas alíquotas para o modelo

'''COMPOSIÇÕES FISCAIS:'''

Deverão ser cadastradas observando os seguintes campos regulamentados pela NFCom.

[[Arquivo:Nf Composicao.png|500x500px|miniaturadaimagem|centro|Cadastro de composição]]

'''Pagina principal''' – mantêm os dados atuais sem alterações relevantes

'''Dados fiscais''' – Gerais: Possui campos importantes para emissão da NFCom e deverão ser preenchidos com dados corretos para cada campo

* Modelo de nota fiscal: NFCom

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

[[Arquivo:Unificada.png|500x500px|miniaturadaimagem|centro|Fatura unificada]]

* 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.
* CNAE: não precisa ser informado para NFCom, apenas para notas eletrônicas de serviço (Prefeituras) NFSe
* 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.
* 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
* Observação fiscal: informar caso haja. Será impressa no campo de informações complementares da NFCom.

'''Dados fiscais – Impostos Federais:''' deverão ser informadas as incidências de acordo com a natureza do serviço.

* Natureza da receita - Informar de acordo com a tabela de receitas, em Telecom é usado geralmente os códigos 01 ou 11
* 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:

Se informado alíquota PIS/COFINS então código da situação será geralmente 01
Se informado alíquota zero para PIS/COFINS código da situação será geralmente 08

[[Arquivo:Imp federal.png|500x500px|miniaturadaimagem|centro|Impostos federais]]

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

'''Dados fiscais - Impostos municipais'''
Não há incidência uma vez que serviço de telecomunicações é tributado pelo estado e não pelo município

[[Arquivo:Icms imp.png|500x500px|miniaturadaimagem|centro|Imposto estadual ICMS]]

'''Importante'''

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

[[Arquivo:Salva comp 2.png|500x500px|miniaturadaimagem|centro|Alerta ao salvar composição]]

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

'''Obs:''' consulte disponibilidade da integração previa com suporte técnico.

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.

[[Arquivo:Tp integracao.png|500x500px|miniaturadaimagem|centro|Tipo integração ]]

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

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

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

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:

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

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

[[Arquivo:Alerta gen nota.png|500x500px|miniaturadaimagem|centro|Alerta geração de notas]]

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.

Caso o usuário deseje acompanhar o andamento, poderá acessar o módulo de rotinas - controle de execução de rotinas.

'''Dashboard: NFCom Status'''

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.

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.

Funcionamento: esse painel será atualizado/alimentado por caminhos distintos de acordo com a regra de negócios:

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

'''Autorizadas :''' Notas fiscais que foram integradas com sucesso e com uso autorizado pela Sefaz

'''Processamento:''' Notas fiscais que estão na fila de integração ainda sem resposta de autorização ou rejeição da Sefaz

'''Sem retorno webhook:''' Notas fiscais que já foram integradas mas não tiveram resposta de autorização ou rejeição da Sefaz

'''Emissão Contingência:''' Notas fiscais que já foram integradas no tipo emissão 2 - Contingência devido a indisponibilidade do ambiente Sefaz

'''Aguardando Sefaz:''' aguardando as informações retornadas da Sefaz como chave, protocolo etc.

'''Dados inválidos:''' quando a integração nem chegou a bater na Sefaz devido a inconsistência de dados do Adapter

'''Erro Sefaz Nota:''' rejeições da Sefaz por alguma inconsistência de dados por nota

'''Erro Sefaz Item:''' rejeições da Sefaz por alguma inconsistência de dados por item nota

'''Erro Sefaz Cancelamento:''' rejeições da Sefaz por alguma inconsistência de dados no cancelamento por nota

'''Sefaz Intermitente:''' quando o serviço oscila, tem demora na resposta mas não consta como inoperante

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.

'''Impressão da DANFE-COM'''

A NFCom, se autorizada ou autorizada em contingência, poderá ser emitida por dois caminhos:

Cadastro do cliente: em dados financeiros notas fiscais botão de imprimir ao lado da NFCom.

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.

Fatura unificada: através do link da DANFE-COM na fatura unificada

'''Relatórios'''

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

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

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

'''FATURAMENTO - Controle Integração NFCOM SEFAZ:''' visualiza erros retornados pela Sefaz.

'''FATURAMENTO - Controle Integração NFCOM Adapter:''' visualiza erros ocorridos antes da integração na Sefaz.

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

==INTRANET==

==ESTOQUE==

==OPERACIONAL==

==RELATÓRIOS==

==REDES==

==ROTINAS==

==TELEFONIA==

==APLICATIVOS==

==API's==

==CENTRAL DO ASSINANTE==

Outubro 2025

2025-12-02T20:14:06Z

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

Arquivo:Alerta gen nota.png

2025-12-02T18:42:43Z

Philip.alves:

adapter bi

Outubro 2025

2025-12-02T18:41:21Z

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

Arquivo:Valid fat1.png

2025-12-02T18:39:42Z

Philip.alves:

adapter bi

Arquivo:Valid fat.png

2025-12-02T18:38:43Z

Philip.alves:

adapter bi

Outubro 2025

2025-12-02T17:57:42Z

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

Arquivo:Erros valida 1.png

2025-12-02T17:56:17Z

Philip.alves:

adapter bi

Arquivo:Erros valida.png

2025-12-02T17:54:42Z

Philip.alves:

adapter bi

Outubro 2025

2025-12-02T17:49:50Z

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

Arquivo:Validador fical.png

2025-12-02T15:02:33Z

Philip.alves:

adapter bi

Outubro 2025

2025-12-02T14:52:51Z

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

Outubro 2025

2025-12-02T14:03:48Z

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

Arquivo:Chave nfcom.png

2025-12-02T14:02:44Z

Philip.alves:

adapter financeiro

Arquivo:Acoes notas.png

2025-12-02T13:58:23Z

Philip.alves:

adapter integracao

Outubro 2025

2025-12-02T13:57:13Z

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

Arquivo:Urls notas.png

2025-12-02T13:56:34Z

Philip.alves:

adapter integracao

Arquivo:Integradora de notas.png

2025-12-02T13:54:29Z

Philip.alves:

Integradora de notas

Arquivo:Tp integracao.png

2025-12-02T13:51:23Z

Philip.alves:

adapter integracao

Outubro 2025

2025-12-01T12:52:04Z

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

Outubro 2025

2025-12-01T12:49:12Z

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

Arquivo:Salva comp 2.png

2025-12-01T12:48:35Z

Philip.alves:

adapter financeiro

Arquivo:Icms imp.png

2025-12-01T12:33:56Z

Philip.alves:

adapter financeiro

Outubro 2025

2025-12-01T12:31:41Z

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

Arquivo:Salva comp.png

2025-12-01T12:31:07Z

Philip.alves:

adapter financeiro

Arquivo:Imp federal.png

2025-12-01T12:28:05Z

Philip.alves:

adapter financeiro

Outubro 2025

2025-12-01T12:26:13Z

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

Arquivo:Unificada.png

2025-12-01T12:23:00Z

Philip.alves:

adapter financeiro

Outubro 2025

2025-12-01T12:20:11Z

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

Arquivo:Nf Composicao.png

2025-12-01T12:17:58Z

Philip.alves:

ADAPTER FINANEIRO

Outubro 2025

2025-12-01T12:16:19Z

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

Outubro 2025

2025-12-01T12:01:40Z

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

Arquivo:Finalidade.png

2025-12-01T12:00:56Z

Philip.alves:

adapterintegracao

Outubro 2025

2025-11-05T11:54:08Z

Philip.alves: /* Alteração Wi-fi - ONU Parks */

Outubro 2025

2025-11-05T11:52:06Z

Philip.alves: /* Alteração Wi-fi - ONU Parks */

Arquivo:Altera wi fi.png

2025-11-05T11:47:40Z

Philip.alves:

adapter comercial

Outubro 2025

2025-11-04T19:43:59Z

Philip.alves: /* Alteração Wi-fi - ONU Parks */

Outubro 2025

2025-11-04T19:43:08Z

Philip.alves: /* Alteração Wi-fi - ONU Parks */

Arquivo:Acao integrad.png

2025-11-04T19:42:44Z

Philip.alves:

adapter integracao

Arquivo:UrlsDisp.png

2025-11-04T19:41:14Z

Philip.alves:

adapter integracao