## Dúvidas Frequentes

Bem-vindo à nossa página de Perguntas Frequentes (FAQ)! Aqui, você encontrará respostas rápidas e claras para as dúvidas mais comuns. Estamos comprometidos em fornecer as informações necessárias para tornar sua experiência mais fácil e satisfatória. Explore as perguntas abaixo para obter soluções imediatas ou entre em contato conosco se precisar de mais assistência.

---
## Financeiro

### Erro: Não gerado. A Soma das Parcelas é diferente do valor da saída

**Causa do Erro**: O erro 'Não gerado. A Soma das Parcelas é diferente do valor da saída' ao gerar boletos ocorre quando há discrepâncias nos descontos e acréscimos aplicados aos produtos. Isso geralmente acontece quando o percentual de desconto ou acréscimo está incorreto.

> [!EXAMPLE]  Exemplo
>  Se um produto custa 10 reais e possui um desconto de 2 reais, o percentual de desconto deve ser de 20%. Se esse percentual estiver errado, pode resultar em vendas não finalizadas.

<details>
<summary>Passo a passo: Como Corrigir o Erro</summary>
1. Verifique os descontos e acréscimos aplicados aos produtos.
2. Delete os descontos e acréscimos incorretos.
3. Insira novamente os descontos e acréscimos com os percentuais corretos.
</details>

Após realizar esses ajustes, os boletos devem ser gerados corretamente.

---
#### Dúvida: O que fazer quando o sistema não está bloqueando os clientes?

Se o sistema não está bloqueando os clientes, isso pode ocorrer por alguns motivos. Verifique as seguintes configurações:

> [!NOTA] Acesso ao Contrato
> Caminho: Menu Sistema > Cadastros > Contratos

1. Edite o tipo de cobrança e verifique o campo 'Bloquear ao atrasar Nº de dias' para garantir que os dias configurados para bloqueio estejam corretos.

2. Na 'Aba Contrato', verifique a opção 'Forçar Status Acesso'. Esta deve estar configurada como 'NÃO' ou 'Padrão', caso o padrão seja 'NÃO', conforme configurado nos parâmetros do sistema.
   
3. Na 'Aba Status de Acesso', certifique-se de que a opção 'Bloqueio automático' está configurada como 'SIM'. Além disso, verifique o campo 'Não bloquear até'. Se este campo estiver preenchido com uma data futura, o sistema não bloqueará o cliente até essa data, independentemente de outras condições ou pendências financeiras.
   
3. Acesse a 'Aba Contrato, e verifique a opção 'Forçar Status Acesso'. Esta deve estar configurada como 'NÃO' ou 'Padrão', caso o padrão seja 'NÃO', conforme configurado nos parâmetros do sistema.

---
#### Dúvida: Como funciona a renegociação?
   
A renegociação pode ser feita quando o cliente tem um título em atraso e deseja fazer um novo acordo com uma nova data de vencimento do boleto. Após a renegociação, o boleto renegociado será cancelado e ficará registrado no menu 'Financeiro' com o status "renegociado", contabilizando-se como recebido. Por outro lado, o novo boleto gerado a partir da renegociação aparecerá na aba 'Financeiro Avulso' com o status "a receber" e ficara disponível para pagamento. 


>[!info] Observação 
>É importante ressaltar que, caso o boleto não seja pago dentro do período estipulado no campo  "Bloquear ao atrasar renegociados  Nº de dias", localizado no  tipo de cobrança do cliente, o contrato será bloqueado.

--- 
#### Dúvida: Como funciona a rotina de troca de plano de venda em massa?

Esta funcionalidade permite a troca de planos de contrato para múltiplos clientes simultaneamente, otimizando o processo de atualização de contratos em larga escala.

> [!NOTA] Acesso a Rotina
> Caminho: Relatórios → Relatórios provedor → Relatórios contratos → Relatórios contratos → Rotinas

Funcionamento:
 - Todos os contratos vinculados ao plano antigo selecionado serão modificados para o novo plano, sem opção de seleção individual;
 - A troca de plano não cancelará financeiros já gerados;
 - A troca de plano incluirá automaticamente a mudança da conexão do login.

>[!info] Observação 
>Se existir um desconto adicional referente ao plano antigo com valor maior que o novo plano selecionado:
>- O sistema emitirá um aviso durante a rotina;
>  - A troca será realizada normalmente;
>  - O provedor deverá ajustar manualmente o desconto após a troca, se necessário.

---
## Fiscal/Contábil 
### Nota Fiscal Modelo 21 Numeração Faltando

**Causa do Erro**: O erro “Nota Fiscal Modelo 21 - Numeração Faltando” pode ocorrer devido às seguintes situações:

1. Existência de lacunas na sequência numérica das notas fiscais modelo 21/22 emitidas no período selecionado; 
2. Notas fiscais foram deletadas sem o devido ajuste na numeração; 
3. Notas Fiscais emitidas com data de emissão retroativa, ou futura; 
4. Houve um salto na numeração durante a emissão das notas.

<details>
<summary>Passo a passo: Como Corrigir Erro</summary>

Para corrigir o erro, é necessário analisar o relatório de notas fiscais emitidas no período e verificar se não houve emissão de notas fiscais com datas de meses anteriores ou futuros. Siga as etapas abaixo:

1. Consulte a numeração que está faltando: [[consultar nota fiscal com o id ou numeracao|Consultar Nota Fiscal com o ID ou Numeração]]
2. Caso as notas fiscais tenham sido emitidas com uma data fora do mês atual, ajuste a data de emissão. Para realizar esse procedimento, acesse o link: [[ajuste de data de emissao em nota fiscal 21 e 22|Ajuste de Data de Emissão em Nota Fiscal 21 e 22]]
3. Se a numeração correspondente à nota fiscal não existir no sistema, isso pode indicar que a nota foi deletada, causando uma quebra na sequência. Nesse caso, é necessário emitir uma nota fiscal avulsa para substituir a numeração faltante. Acesse os links: 
	- [[emissao nota fiscal modelo 21 e 22 - avulsa|Geração Nota Fiscal Modelo 21 e 22 - Avulsa]]
	- [[ajuste de numeracao em notas fiscais modelo 21 e 22|Ajuste de Numeração em Notas Fiscais Modelo 21 e 22]]

</details>

---
### Emissão Nota Fiscal Modelo 21 e 22 - Avulsa

A emissão avulsa é utilizada para gerar notas fiscais individuais, geralmente para transações únicas ou que não estão vinculadas a contratos recorrentes.

<details>
<summary>Passo a passo: Emissão Nota Fiscal Avulsa - Modelo 21 e 22 </summary>

1. Acesse o menu Sistema > Saídas > Vendas;
2. Clique no botão **Novo**; 
3. Preencha os campos da aba **Geral**: 
	- **Tipo de documento:** informe o tipo de documento configurado para o modelo 21 ou 22; 
	- **Cliente**: Selecione o cliente em que está emitindo a nota; 
	- **Condição de pagamento**: Selecione a forma escolhida pelo cliente para o pagamento do serviço;
	- **Filial**: Selecione a filial configurada para emissão das notas fiscais; 
	- **Data de emissão**: Informe a data em que a nota está sendo gerada.
	- **Data de saída**: Defina a data desejada para a saída dos produtos ou serviços.
4. Siga para a aba **Frete/Comissão** e preencha o campo **Vendedor**;
5. Após preencher os campos, clique no botão **Salvar**; 
6. Navegue para a aba **Produto** e clique no botão **Novo**; 
7. Em seguida, preencha os campos: 
    - **Produto:** Selecione o produto que está sendo movimentado; 
    - **Quantidade**: Informe a quantidade do produto;
    - **Valor unitário:** Informe o valor unitário de cada produto. 
8. Clique no botão **Salvar** para registrar as informações preenchidas.
9. Após incluir todos os produtos, clique no botão **Finalizar Saída**;
10. Selecione a opção **Validar e Finalizar** para concluir.

</details>

---
### Erros Comuns na Validação das Notas Modelo 21 e 22 (Convênio 115)
Erros na validação do Convênio 115, relacionados às notas fiscais modelo 21 e 22, são comuns. Aqui, listamos os principais erros e como resolvê-los de forma simples e rápida.
#### Como Identificar os Erros 
Para identificar possíveis erros que possam ocorrer durante a validação das Notas Fiscais modelos 21 e 22, disponibilizamos uma funcionalidade que permite verificar os arquivos antes do download.

<details>
<summary>Validar Notas Modelo 21 e 22 Antes de Baixar Arquivos do Convênio 115</summary>

1. Acesse o menu Relatórios > Relatórios fiscais > Relatórios notas modelo 21/22/62;
2. Selecione a opção “Relatórios notas modelo 21/22/62”;
3. Preencha os campos obrigatórios:
	- **Filial**: Informe a filial utilizada para emissão das Notas Fiscais;
	- **Mês**: Informe o mês em que as notas foram emitidas e informadas no campo data de emissão;
	- **Ano**: Informe o ano referente a emissão.
4. Certifique-se de que o parâmetro “Identificação da estrutura do convênio” esteja selecionado como “Normal”.
5. Após preencher os filtros, clique no botão **“Download”**;
6. Em seguida, clique em **“Validar convênio ICMS 115”**.

</details>

---

<details>
<summary>Como identificar o erro e o número da nota onde ele está ocorrendo</summary>

Ao validar os arquivos no validador da SEFAZ, um arquivo de log de erros é gerado automaticamente. Para identificar os erros, siga as instruções abaixo:

1. Localize e abra o arquivo de **Log de erro** gerado pelo validador;
2. Localize a primeira Linha de Erro que fica abaixo da linha (registro; tipo de ocorrência; arquivo; código do erro; valor lido; documento fiscal);
3. Identifique o código do erro, 4º campo após o ponto e vírgula (`;`).
4. Consulte a tabela de erros, acesse o link: [Tabela de Erro - Convênio 115](https://portal.fazenda.sp.gov.br/servicos/nf-comunicacao-energia/Downloads/TabErros_CAT79_03_v3_00d.pdf);
5. Na coluna Código do erro, busque pelo código identificado no arquivo Log de erros (Exemplo:146);
6. Verifique a informação da coluna Descrição do Erro;
7. Para identificar a numeração da nota fiscal, verifique os últimos números apresentados na linha do erro.

</details>

---
### Como Solucionar os Erros 
#### Erro 146 - IE não informada, inválida, ou preenchimento incorreto

**Causa do Erro**: O erro 146 pode ocorrer devido a informação da Inscrição Estadual no cadastro dos cliente que possui o Tipo Pessoa Jurídica. As causas incluem:

1. Campo de Inscrição Estadual (IE) deixado em branco no cadastro do cliente de pessoa Jurídica.
2. Inscrição Estadual informada com formato inválido.
3. Inscrição Estadual não correspondente ao estado do cliente.
4. Cliente isento de Inscrição Estadual, mas não marcado como tal no sistema.

<details>
<summary>Passo a passo: Como Corrigir Erro</summary>

1. Realize a consulta do CNPJ do cliente no site da [SINTEGRA](http://www.sintegra.gov.br/);
2. Acesse o menu Sistema > Cadastros > Clientes;
3. Localize o cliente vinculado a Nota Fiscal;
4. Clique no botão **Editar**;
5. No campo **IE/RG** informe o código da inscrição estadual, ou preencha com a informação **ISENTO** (em caixa alta) caso o cliente não seja contribuinte;
6. Em seguida, clique no botão **Salvar**.

</details>

---
#### Erro 121 - Número do documento fiscal fora de seqüência

**Causa do Erro**: O erro 121 ocorre quando há inconsistências na sequência numérica das Notas Fiscais modelo 21 e 22. Esse problema pode ser causado por irregularidades na numeração, deixando-a fora de ordem. As principais razões para esse erro são:

- Emissão de Notas Fiscais com datas retroativas ou futuras;
- Numeração duplicada no Sistema.

<details>
<summary>Passo a passo: Como Corrigir Erro</summary>

Passo 1: Analisar Erro

1. Aba o arquivo de erros gerado pelo validador;
2. Na linha em que apresenta o erro 121, os últimos numero da linha representa a numeração da Nota fiscal;

Corrigir Erro - Nota Fiscal com Data Retroativa ou Futura

1. Acesse o menu Sistema > Saídas > Vendas;
2. No campo de busca altere para opção **NF**;
3. Informe a numeração que está fora de ordem;
4. Selecione a nota fiscal que irá ajustar, e clique em **Alterar**;
5. Selecione a opção **Venda**;
6. Altere o campo “Status” para **Aberto**;
7. Em seguida, clique em **Salvar**.
8. Feche a tela atual, e clique no botão **Editar**;
9. Localize o campo **Data de emissão** e **Data de Saída**, e**Localize o campo **Data de emissão**** informe uma data referente ao mês que as demais numerações pertencem.
10. Após os ajuste, clique em **Salvar**;
11. Em seguida, clique em **Finalizar Saída**;
12. Para concluir, clique em **Validar e Finalizar**.

Corrigir Erro - Nota Fiscal com Numeração duplicada no Sistema.

1. Acesse o menu Sistema > Saídas > Vendas;
2. No campo de busca altere para opção **NF**;
3. Informe a numeração duplicada;
4. Selecione uma das Venda, é clique em **Alterar**;
5. Selecione a opção **Venda**;
6. Altere o campo “Status” para **Aberto**;
7. Em seguida, clique em **Salvar**.
8. Feche a tela atual, e clique no botão **Editar**;
9. Em seguida, clique em **Finalizar Saída**;
10. Localize e clique no botão **Tributos**;
11. Preencha o campo **Número** com a próxima numeração que deve ser utilizada. (**Exemplo:** Se a última numeração utilizada foi “2”, a nota que está sendo ajustada deverá receber o número “3”.)
12. Feche a tela atual, e clique em **Validar e Finalizar**.

Ajuste Contador de Notas

1. Acesse Menu Configurações > Configurações de Documentos > Número de Documento;
2. Selecione o registro referente ao modelo notas ajustado;
3. Clique em **Editar**;
4. Preencha o campo **Próximo número de NF** com numeração seguinte a utilizada na nota fiscal ajustada anteriormente.
5. Em seguida, clique em **Salvar**

</details>

--- 
#### Erro 254-Total deve ser igual à soma - BC + Isentas + Outras

**Causa do Erro**: O erro 254 ocorre quando há uma diferença entre o valor total da nota fiscal e a soma dos valores de base de cálculo (BC), isentas e outras.

<details>
<summary>Passo a passo: Como Corrigir Erro</summary>

Passo 1: Analisar Nota Fiscal

1. Acesse o menu Sistema > Saídas > Vendas;
2. No campo de busca altere para opção **NF**;
3. Informe a numeração que está fora de ordem;
4. Selecione a nota fiscal que irá ajustar, e clique em **Editar**;
5. Siga para a aba **Produtos**;
6. Selecione um dos produtos, e clique em **Editar**;
7. Localize e clique no botão **Tributos**;
8. Na aba **ICMS** verifique os valores nos campos **Base de Cálculo**, **Valor Isento** e **Outros Valores** (Observação: Os valores dos campos devem corresponder ao valor do produto informado).
9. Quando o valor dos tributos não corresponde ao valor total, é necessário ajustar.

Passo 2: Ajustar Nota Fiscal

1. Acesse o menu Sistema > Saídas > Vendas;
2. No campo de busca altere para opção **NF**;
3. Informe a numeração duplicada;
4. Selecione uma das Venda, é clique em **Alterar**;
5. Selecione a opção **Venda**;
6. Altere o campo “Status” para **Aberto**;
7. Feche a tela atual, e clique no botão **Editar**;
8. Siga para a aba **Produtos**;
9. Selecione um dos produtos, e clique no botão **Deletar**;
10. Inclua o produto novamente, e verifique os valores dos tributos;
11. Clique em **Salvar** para aplicar as alterações;
12. Baixe novamente os três arquivos da nota fiscal, garantindo que você tenha as versões atualizadas;
13. Utilize um validador adequado para validar os arquivos, verificando se as informações estão corretas e se não há mais erros.

</details>

---
#### Erro 304 - Logradouro inválido preenchimento incorreto, ou contém menos de 3 caracteres

**Causa do Erro**: O erro 304 ocorre, principalmente, por dois motivos: preenchimento incorreto do campo de logradouro ou inserção de menos de três caracteres nesse campo.

<details>
<summary>Passo a passo: Como Corrigir Erro</summary>

1. Acesse o Menu Sistema > Cadastros > Clientes;
2. Localize e selecione o cliente que apresentou o erro na Nota fiscal;
3. Em seguida, clique em **Editar**;
4. Siga até a aba **Endereço**;
5. Revise e corrija as informações do campo **Endereço** e **Bairro** contenha mais de 3 caracteres;
6. Após ajustar os campos, clique no botão **Salvar**.

</details>

>[!TIP] Dica 
> Se, ao validar os arquivos, forem apresentados erros não mencionados nesta página, consulte a pasta: **Guia de Erros > Fiscal > Erros Arquivos Fiscais > Erros Arquivo Convênio 115.** 

---

## Carteira de cobrança

### Baixas de Pagamento

#### Pagamento sem Baixa Recebida no Sistema

Se deparou com a situação de clientes pagando suas faturas e as mesmas não tiveram suas liquidações no Sistema? Veja abaixo algumas dicas para solucionar este impasse.

O primeiro passo é comparar as informações entre os dados do comprovante de pagamento e a sua fatura em aberto, de modo a validar a assertividade do pagamento:

1. Acesse o menu "Sistema";
2. Vá em "Cadastros";
3. Clique em "Clientes";
4. Busque o cliente desejado, selecione-o e clique no botão "Editar";
5. Navegue até a aba "Financeiro";
6. Localize a respectiva fatura em aberto no Sistema, selecione-a e clique em "Editar";
7. Navegue até a aba "Informações" da cobrança.

Verifique as informações dos campos "Nosso número" e "Linha digitável", e valide se elas estão de acordo com oquê foi impresso no comprovante de pagamento e/ou nos dados de recebimento presente em seu sistema bancário.

Se as informações forem compatíveis significará que a devida cobrança foi paga e não se trata de um pagamento errôneo, mas que pode refletir algum problema de comunicação entre Sistema e Servidor, requerendo demais validações para encontrar o problema e regularizar a situação. Recomenda-se que entre em contato com o Suporte Financeiro para auxílio especializado.

> [!CAUTION] Atenção!
> Se os dados do comprovante de pagamento não corresponderem aos de emissão da fatura, significa que a cobrança vigente não foi paga da forma esperada, e que um pagamento errado ocorreu.
> - **Exemplo**: boleto errado, transferência Pix avulsa, etc.

---

#### Título não Encontrado no Retorno

**Ao processar retorno bancário apareceu um título com status Não Encontrado, como localizar?**

Para verificar a qual boleto essa movimentação pertence e o motivo de não ter sido encontrada pelo sistema no momento do processamento do retorno, siga os passos abaixo:

1. Acesse o menu "Sistema";
2. Selecione "Financeiro";
3. Vá na pasta "Arquivos de boletos";
4. Clique em "Retorno bancário em lote";
5. Localize e selecione o retorno desejado e clique no botão "Editar".

Na aba "Registros", filtre pelo status "Não encontrado", selecione o título que deseja procurar e copie o número presente na coluna "Nosso número".
Com este número, você irá buscá-lo no módulo de **Contas a Receber**, conforme os passos:

1. Acesse o menu "Sistema";
2. Selecione "Receber";
3. Clique em "Contas a receber";
4. Clique no botão "limpar" para remover os filtros pré-definidos;
5. No campo "NN Imp." insira o **Nosso número** que foi copiado anteriormente, e pressione o botão "OK" para buscar.

Caso apareça o registro buscado, selecione e edite seu registro para verificar a carteira de cobrança ao qual está vinculado. Se houve uma troca de carteira de cobrança do boleto, ele não será encontrado pelo Sistema no processamento do retorno, e precisará ser recebido de forma manual.

> [!CAUTION] Atenção!
> Se possuir uma carteira de cobrança do tipo API utilizando o mesmo convênio que a carteira de remessa e retorno, é normal que essa situação ocorra, pois o banco encaminha todas as movimentações realizadas para o convênio nos arquivos de retorno disponibilizados, e quando seu processamento é realizado no Sistema, o mesmo não acata as instruções e retorna com mensagem de erro, de modo que ele não seja processado de forma duplicada.

Caso nesta busca do contas a receber não seja retornado nenhum registro, você pode fazer uma busca pelos **Logs Gateway** do Sistema. Para isso, siga os passos:

1. Acesse o menu "Configurações";
2. Selecione "Logs";
3. Clique em "Logs dos usuários";
4. Filtre por "Campos" e insira o **Nosso número** da cobrança;
5. Pressione a tecla **Enter** do seu computador para realizar a busca.

Busque pela informação "fn_areceber" presente na coluna denominada "Tabela". Esse será o log referente ao boleto que gerou o **Nosso número** buscado. Copie o número apresentado na coluna "Registro ID", este dado é o **ID do boleto** no Sistema.

Ainda nos "Logs dos Usuários", remova os filtros de busca anteriormente aplicados, e utilize o filtro "Registro ID", inserindo o número de **ID do boleto**. Valide o último log que na coluna "Tabela", possua a informação "fn_areceber".
Se na coluna "Tipo" a ação for igual à "excluiu", significa que o boleto foi excluído do Sistema, portanto, não foi encontrado pelo processamento do arquivo. Ainda nesta tela, na coluna "Operador ID", será possível verificar o usuário que realizou a ação de exclusão.

> [!CAUTION] Atenção!
> A exclusão de um boleto ocorre quando a venda em que ele está vinculado for excluída do Sistema, esse tipo de processo não é recomendado, pois, desta forma o Sistema não terá como enviar o log para o pedido de baixa do boleto na instituição financeira, e o mesmo permanecerá com seu status inalterado.<hr>
> Para mais informações, verifique em [[titulo nao encontrado|Título Não Encontrado]].

---
### Juros, Multas, Desconto e Instruções de Impressão de Faturas

#### Juros, Multas e Desconto

**Como configurar os Juros e Multa em uma Carteira de Cobrança?**

Quando necessário, seja por adequação à alguma norma ou simples ajuste, a alteração dos parâmetros de **Juros** e **Multa** em uma carteira de cobrança pode ser realizada conforme os seguintes passos:

1. Acesse o menu "Sistema";
2. Selecione "Cadastros";
3. Vá em "Financeiro";
4. Clique em "Carteira de cobrança";
5. Selecione o registro de carteira desejado, e clique no botão "Editar";
6. Navegue até a aba "Juros/Multas/Desconto".

Nesta aba, modifique os valores dos campos, preenchendo-os conforme necessidade e sempre estando conforme as exigências da **Anatel**.
Você terá as seguintes opções de parâmetros:
- **Juros %**: Para inserir uma porcentagem de juros sobre o valor da cobrança.
- **Juros R$**: Para inserir um valor fixo de juros em reais.
- **Multa %**: Para inserir uma porcentagem de multa sob o valor da cobrança.
- **Multa R$**: Para inserir um valor fixo de juros em reais.

E para configurar os valores de **Desconto**, utilize os parâmetros:
- **Desconto até o vencimento R$**: Para inserir um valor fixo de desconto em Reais.
- **Desconto até o vencimento %**: Para inserir uma porcentagem de desconto sob o valor da fatura.

Ajustados os parâmetros necessários, finalize as alterações clicando no botão "Salvar".

> [!CAUTION] Aviso!
> Certifique-se de preencher apenas um formato para cada tipo de parâmetro.
> - **Exemplo**: se preencher os valores de Juros no parâmetro "Juros %", não deve preenchê-lo também em "Juros R$". <hr>
> **Para mais informações, verifique em [[juros, multas e desconto|Juros, Multas e Desconto]]**.

---

## Integrações gerais

### Erros de E-mail SMTP

>[!Caution] Atenção:
>As mensagens de erro, quando apresentadas em log, são mensagens de retorno enviadas pelo seu provedor de e-mails. O sistema IXC apresenta estas informações através da integração entre as plataformas, servindo como uma ponte para viabilizar o disparo de mensagens de e-mail.

>[!INFO] Importante:
>Para a validação de erros de E-mail SMTP, é de suma importância que os Logs de E-mail sejam consultados. Portanto, recomendamos que o processo de validação de falha seja efetuado da seguinte forma:
>
>1. Acesse menu Configurações > Logs > Logs de e-mail;
>2. Selecione um e-mail que esteja com o status de "Falha";
>3. Clique em "Visualizar" para identificar o erro no campo "Mensagem de erro". Confira qual mensagem está sendo exibida e corrija conforme as orientações para cada erro, conforme descrito a seguir.

<details>
<summary>Erro SMTP: "Could not authenticate"</summary>
Essa mensagem indica que há um erro nos dados de login e senha do servidor de envios de e-mail. Verifique os dados e atualize-os, se necessário, no servidor de envios de e-mail cadastrado no IXC em menu Configurações > Integrações > E-mail SMTP. 
</details>

<details>
<summary>Erro SMTP: "Could not connect to SMTP host"</summary>
Este erro indica que o IXC não conseguiu encontrar o servidor de envios de e-mail cadastrado. Verifique os campos "servidor de saída (SMTP)" e "porta". 

1. Acesse menu Configurações > Integrações > E-mail SMTP;
2. Verifique o campo "Servidor de saída" e o campo "Porta";
3. Se necessário, confirme os dados com o provedor do serviço de e-mail. Lembre-se de que o IXC está autenticando e suporta somente o protocolo **SMTP**.
</details>

<details>
<summary>Erro SMTP: "Data not accepted"</summary>
Essa mensagem pode indicar que a conta de e-mail utilizada para enviar as mensagens está com o armazenamento cheio, impedindo o disparo das mensagens. 

Verifique o armazenamento de sua conta de e-mail. Se necessário, solicite ao provedor de e-mail a possibilidade de adquirir mais armazenamento, libere espaço em sua conta ou ajuste o e-mail no sistema para outra conta.

>[!info] Guia instrutivo
>Para alterar a conta de e-mail no sistema, acesse: [[e-mail smtp|Cadastro de E-mail SMTP]]

Além do armazenamento cheio, essa mensagem também pode indicar que o IP do provedor foi listado em uma blacklist, o que impede o envio de e-mails. Nesse caso, o ideal é entrar em contato com o seu servidor de envios de e-mail para mais orientações sobre como proceder.

</details>

<details>
<summary>Erro SMTP: "The following recipients failed: [endereço de e-mail]: The mail server could not deliver mail to [endereço de e-mail]. The account or domain may not exist, they may be blacklisted, or missing the proper dns entries. Fim!"</summary>
Tradução: "Os seguintes destinatários falharam: [e-mail destinatário]: O servidor de e-mail não conseguiu entregar o e-mail para [endereço de e-mail]. A conta ou o domínio podem não existir, podem estar em blacklist ou podem estar faltando as entradas de DNS adequadas. Fim!"

Este erro indica que o IXC não conseguiu encontrar o e-mail do destinatário, podendo ser um endereço de e-mail inválido, inexistente, estar bloqueado para recebimento de mensagens.

A recomendação é de validação do e-mail do destinatário, portanto, acesse o cadastro do cliente e altere o endereço de e-mail por um endereço correto, conforme orienta os passos abaixo:

1. Acesse o cadastro do cliente através do caminho: Sistema > Cadastros > Clientes;
2. Acesse a aba "Contato" e localize o campo "E-mail principal";
3. Confirme o e-mail correto junto do cliente e verifique se existe algum erro de digitação. Corrija o dado informado e clique em "Salvar" para validar as modificações. Se necessário, reenvie o disparo que retornou falha.
</details>

<details>
<summary>Erro SMTP: "Recipient address rejected"</summary>
Este erro indica que o servidor de e-mail não conseguiu encontrar o e-mail do destinatário, podendo ser um endereço inexistente ou inválido.

Assim como o erro anterior, a recomendação é de validação do e-mail do destinatário, portanto, acesse o cadastro do cliente e altere o endereço de e-mail por um endereço correto, conforme orienta os passos abaixo:

1. Acesse o cadastro do cliente através do caminho: Sistema > Cadastros > Clientes;
2. Acesse a aba "Contato" e localize o campo "E-mail principal";
3. Confirme o e-mail correto junto do cliente e verifique se existe algum erro de digitação. Corrija o dado informado e clique em "Salvar" para validar as modificações. Se necessário, reenvie o disparo que retornou falha.
</details>

<details>
<summary>Erro SMTP: "Recipient address rejected: you are sending too many mails, slow down"</summary>
Este erro está relacionado ao excesso de envios de mensagens. Significa que a conta de e-mail/IP está ultrapassando o limite contratado, isto é, enviando a mais do que realmente foi contratado ou que a conta suporta.

Para solucionar este erro, é necessário validar junto ao seu provedor de e-mails o limite de envios permitido e ajustar esta quantidade no sistema. 

1. Após conferir o limite de envios suportados pela conta de e-mail, acesse, no sistema IXC, o cadastro da integração acessando menu Configurações > Integrações > E-mail SMTP;
2. No campo "Limite de e-mails por hora", insira a quantidade exata permitida por hora. Caso não tenha essa quantidade exata, verifique o limite de envios por dia e fragmente em horas para incluir a informação neste campo;
3. No campo "Limite de e-mails por dia", indique a quantidade exata permitida por dia;
4. Clique em "Salvar" para concluir as modificações. Se necessário, reenvie as mensagens que retornaram falha.

</details>

<details>
<summary>Alteração do Domínio no Envio</summary>
A alteração de domínio, quando o cliente recebe a mensagem, ocorre devido a uma configuração específica diretamente na plataforma utilizada. Nesses casos, é necessário entrar em contato com o provedor do serviço de e-mail para obter as orientações adequadas e realizar o ajuste do domínio, permitindo assim a utilização do domínio próprio nos disparos de mensagens.

</details>

### Erros de Envio de SMS

>[!Caution] Atenção:
>As mensagens de erro, quando apresentadas em log, são mensagens de retorno enviadas pelo seu Gateway SMS. O sistema IXC apresenta estas informações através da integração entre as plataformas, servindo como uma ponte para viabilizar o disparo de mensagens de SMS.
>
>Consulte sempre os [[log sms|Logs de SMS]] para monitorar o status dos envios de mensagens.

<details>
<summary>Erro de Envio SMS</summary>
Os erros de envio de mensagens de SMS estão atreladas à algumas causas principais que precisam ser verificadas:
- Dados de integração e/ou configuração incorretos;
- Serviço bloqueado pela plataforma;
- Créditos expirados (quando a plataforma trabalha com uso de créditos);
- Número de destino inválido/incorreto.

Para solucionar erros no envio, siga as seguintes verificações:

1. Confira os dados da integração acessando menu Configurações > Integrações > Gateway SMS;
2. Selecione o Gateway SMS e edite-o. Confira os dados de autenticação, como Usuário, Senha ou Token e verifique se as informações estão corretas. Se necessário, consulte a plataforma contratada;
3. Verifique se o seu serviço está devidamente ativo na plataforma, se existe alguma restrição de uso ou bloqueio;
4. Se utiliza créditos, verifique se existe saldo suficiente para efetuar os disparos;
5. Verifique se o número de telefone que deve receber as mensagens está correto. Se estiver enviando a um cliente, acesse o cadastro através do caminho: menu Sistema > Cadastros > Clientes. Selecione o cliente em questão, acesse a aba Contato e verifique se o campo "Telefone celular" está preenchido. Se estiver, confira também se o número está correto. Ajuste se necessário.

</details>

### Como Realizar Envios de E-mail e SMS

<details>
<summary>Como enviar E-mail ou SMS em massa para todos os clientes?</summary>
Para enviar e-mails ou SMS em massa para todos os clientes, você pode utilizar uma das três opções de relatórios disponíveis: Relatório de Clientes, Relatório de Contratos ou Relatório de Status Logins.  
  
Para utilizar o Relatório de Clientes:  
1. Acesse "Relatórios > Relatórios de Cadastros > Relatório de clientes".  
2. Aplique os filtros desejados para selecionar a cartela de clientes que receberão as mensagens. Confira os clientes filtrados clicando em "Imprimir relatório > Imprimir".  
3. Vincule a mensagem no campo "Mensagem E-mail Marketing" para e-mails ou "Mensagem SMS" para SMS.  
4. Clique em "E-mail > Enviar e-mail (marketing)" ou "SMS > Enviar SMS" para enviar as mensagens.  
  
Para utilizar o Relatório de Contratos:  
5. Acesse "Relatórios > Relatórios Provedor > Relatório Contratos".  
6. Aplique os filtros desejados, como Status do contrato, Endereço ou Plano de venda.  
7. Confira os clientes filtrados clicando em "Detalhados > Detalhado".  
8. Acesse a aba "Envios CRM" e vincule a mensagem no campo "E-mail Marketing" para e-mails ou "Mensagem SMS" para SMS.  
9. Clique em "Envios CRM > Enviar E-mail" ou "Enviar SMS" para enviar as mensagens.  
  
Para utilizar o Relatório de Status Logins:  
6. Acesse "Relatórios > Relatórios Provedor > Relatório Conexões > Relatório de Status Logins".  
7. Aplique os filtros desejados, como Login ativo, Autenticação, Plano de velocidade ou Concentrador.  
8. Confira os clientes filtrados clicando em "Imprimir Status Logins > Imprimir Analítico".  
9. Vincule a mensagem no campo "CRM > E-mail Marketing" para e-mails ou "Mensagem SMS" para SMS.  
10. Clique em "CRM > Enviar E-mail" ou "Enviar SMS" para enviar as mensagens.
</details>

<details>
<summary>É possível automatizar o envio de faturas e cobranças no sistema?</summary>
Sim, é possível automatizar o envio de faturas e cobranças no sistema utilizando a ferramenta CRM de cobrança. Esta ferramenta permite parametrizar o envio de cobranças a partir da geração de boletos de uma determinada carteira de cobrança, possibilitando o envio de mensagens por e-mail, SMS, WhatsApp (com integração ao Opa!Suite) e notificações push. Os envios podem ser programados para ocorrer antes e após o vencimento. 

>[!TIP] Guia instrutivo
>>Para configurar o CRM de cobrança, acesse o material de instruções: [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]]

</details>

<details>
<summary>Como enviar boletos em massa?</summary>
Nessa situação será necessário realizar o envio manualmente, para isso, siga os passos abaixo:

1. Acesse o relatório de Emissão de Boletos através do caminho: menu Relatórios > Relatórios financeiros > Relatórios de Saída > Emissão de boletos;
2. No primeiro campo, selecione a carteira de cobrança referente aos boletos que deseja enviar;
3. Em seguida, preencha a data de vencimento, somente dos boletos que deseja que os clientes recebam;
4. Escolha uma das opções de envio: Enviar por SMS ou Enviar por E-mail.

Atenção: para que o envio funcione corretamente, é necessário haver um servidor de e-mail SMTP previamente configurado em menu Configurações > Parâmetros > Parâmetros Financeiro > campo "Servidor de e-mail para vários boletos e faturas" para envios de e-mail e para envios de SMS, o campo "SMS para envio de boletos" deve estar preenchido.

</details>

<details>
<summary>Como enviar boletos para um cliente?</summary>
Nessa situação, poderá utilizar o financeiro do cliente para efetuar o disparo, siga os passos abaixo:

1. Acesse o cadastro do cliente através do caminho: Sistema > Cadastros > Clientes > Editar;
2. Em seguida, acesse a aba Financeiro. Selecione um ou mais boletos que deseja enviar ao cliente;
3. Clique em "Imprimir boletos" > e selecione "Enviar por E-mail"/"Enviar SMS". Certifique-se de que o cliente possui o número de telefone cadastrado e e-mail, conforme o envio realizado.

Atenção: para que o envio funcione corretamente, é necessário haver um servidor de e-mail SMTP previamente configurado em menu Configurações > Parâmetros > Parâmetros Financeiro > campo "Servidor de e-mail boletos e faturas" para envios de e-mail e para envios de SMS, o campo "SMS para envio de boletos" deve estar preenchido.

</details>

### Dúvidas Frequentes e Erros Watch TV

<details>
<summary>Como conseguir a URL de retorno?</summary>
A URL de retorno é um dado fundamental no processo de integração, ela será utilizada para a geração do arquivo JSON, que uma vez inserido no IXC, estabelece a comunicação entre as plataformas. Este dado consiste em um endereço web utilizado como ponto de retorno no cenário de integração entre sistemas e segue a seguinte estrutura: sistema.com.br/retorno/watch/

Portanto, para coletar a URL de retorno, você irá utilizar a URL do seu sistema IXC + /retorno + /watch + /

Ao aplicar na prática, a sua URL ficará semelhante ao exemplo:
`https://seuprovedor.com.br/retorno/watch/`

Envie este dado para a plataforma da Watch e eles lhe retornarão com o arquivo JSON para efetuar a integração no sistema.

Consulte o nosso material instrutivo para realizar a integração e para questões de usabilidade da plataforma no sistema: [[integracoes tv - watch tv|Integração Watch TV]] 

</details>

<details>
<summary>Como configurar o envio de e-mail de ativação para clientes do plano Watch TV?</summary>
Para configurar o envio de e-mail de ativação para clientes do plano Watch TV, é importante saber que essa configuração é realizada diretamente pela plataforma Watch TV. O sistema IXC não é responsável pelo envio de e-mails de ativação. Ele apenas permite a ativação do login, a gestão do contrato e o controle de acesso dos usuários. Portanto, qualquer configuração relacionada ao envio de e-mails de ativação deve ser tratada diretamente com a plataforma Watch TV.
</details>

<details>
<summary>Erro "Não autorizado"</summary>
Geralmente esse problema está relacionado a comunicação com a plataforma da Watch. Este erro está relacionado a instabilidades de dados, normalmente diretamente ligado ao arquivo JSON, arquivo este fundamental para a comunicação entre as plataformas. Para resolver o erro "Não autorizado" durante o cadastro de Usuário TV Watch, é necessário solicitar um novo arquivo JSON à plataforma.

A atualização do arquivo JSON renova as credenciais de autenticação, restabelecendo a comunicação entre os sistemas. Siga as etapas a seguir para a correção:

1. Copie o link de acesso ao seu sistema IXC;
2. Remova o sufixo `/adm.php` ou `/login.php`, mantendo apenas a estrutura base do domínio (ex.: `https://seudominio.com.br`);
3. Acrescente ao final do link a seguinte estrutura: `/retorno/watch/`;
4. A URL de retorno final terá a seguinte forma: `https://seudominio.com.br/retorno/watch/`.

Após coletar a URL de retorno, encaminhe-a para a equipe Watch para a geração do JSON. A equipe da Watch lhe enviará o arquivo para restabelecer a comunicação entre as plataformas. Ao receber o documento, faça o download em seu computador para realizar o upload no sistema IXC e prossiga com as demais etapas:

1. Acesse o menu Configurações > Integrações > Integrações TV > selecione a integração com a plataforma Watch TV e clique em Editar;
2. Em seguida, clique no botão Arquivo localizado do lado direito do campo Arquivo JSON. O sistema exibirá os arquivos salvos em sua máquina, selecione o arquivo JSON fornecido e clique em Salvar. O sistema deve gerar um novo token e será exibido no campo Token acesso, indicando sucesso na comunicação entre as plataformas.
</details>

<details>
<summary>Erro "'Solicitação Inválida: Ticket não encontrado' ao deletar o usuário TV Watch"</summary>
O erro "Solicitação Inválida: Ticket não encontrado" ocorre quando o ticket preenchido no campo "Token Assinante", no usuário TV no IXC não foi encontrado na plataforma, geralmente decorrente de deleções de ticket diretamente na plataforma. Para solucionar esse erro, será necessário criar um novo ticket na plataforma BackOffice da Watch, e vinculá-lo ao IXC. Para isso, você precisará de acesso ao sistema da Watch Brasil.

1. Acesse a plataforma BackOffice da Watch, e clique no ícone de "Ações" (botão mais à direita do campo), no plano que o cliente possui no IXC.
2. Clique em "Adicionar Ticket" (na parte superior direita da tela);
3. Preencha o campo "E-mail" com o e-mail preenchido no campo "login" no usuário TV no IXC;
4. Preencha o campo "Identificador de integração" com o ID do contrato, presente no campo "ID do contrato" no usuário TV no IXC;
5. Preencha o campo "Telefone" com o telefone do cliente preenchido no campo "Telefone celular", no cadastro do cliente > aba "Contato";
6. Clique em "Salvar"
7. Nessa tela, procure pelo e-mail do login que acabou de cadastrar;
8. Copie a informação presente no campo "Ticket";

Depois, retorne ao IXC provedor, e siga os passos:

9. No usuário TV que estava retornando o erro, procure o campo "API" > Selecione como "Ignorar API e alterar apenas no IXC"
10. Procure o campo "Token Assinante", e preencha com o Ticket do login que criou na plataforma;
11. Clique em "Salvar";

Feito isso, o erro deve ser solucionado, e você poderá seguir com as alterações necessárias no usuário TV.

</details>

<details>
<summary>Erro "P0001: [API_PHONE_IS_NOT_CELLPHONE]"</summary>
Este erro está relacionado a um número de telefone inválido no cadastro do cliente. Quando o ticket do cliente é ativo no IXC, o sistema envia informações dos dados cadastrais do cliente, incluindo o "Telefone celular", na aba Contato do Cadastro do cliente. Portanto, é necessário verificar se o número do telefone do cliente está na estrutura esperada - (DDD) 9 XXXX-YYYY - ou se é um número válido.

1. Acesse o cadastro do cliente através do caminho: Sistema > Cadastro > Cliente;
2. Acesse a aba Contato e localize o campo "Telefone celular" para efetuar o ajuste;
3. Após corrigir o número de telefone, clique em "Salvar" para validar as modificações e realize a criação do usuário TV.
</details>

<details>
<summary>Erro "P0001: [API_EMAIL_ALREADY_IN_TICKET]"</summary>
Este erro está relacionado à validação do dado cadastral de e-mail do cliente. Foi identificado que o e-mail do cliente já está registrado no banco de dados da Watch TV, mesmo que não seja proveniente do cadastro em seu backoffice. Neste caso, pode optar por três possíveis soluções:
- Cadastrar o usuário TV em outro e-mail fornecido pelo cliente;
- Solicitar ao cliente a entrar em contato com a empresa fornecedora para a deleção do ticket;
- Solicitar à Watch TV a deleção do ticket na plataforma para a reativação em outro backoffice;
</details>

<details>
<summary>Erro "P0002: [EMAIL_CAN_NOT_BE_CREATED]"</summary>
Este erro indica que não há tickets disponíveis para o produto que será ativo no usuário TV. Neste caso, para confirmar este dado, pode-se validar através da comunicação dos pacotes com o sistema. Para realizar esta validação, siga as etapas a seguir:

1. Acesse menu Sistema > Cadastros > Produtos;
2. Localize o produto que deseja ativar no cliente e edite-o;
3. Em seguida, acesse a aba TV e clique em "Buscar pacote";
4. Verifique se o ID do pacote correspondente ao produto cadastrado possui tickets disponíveis. Neste cenário, deve constar o número "0" para averiguar a falta de tickets.

Após confirmar este dado, entre em contato com a equipe da Watch para regularizar a quantidade de tickets disponíveis. Uma vez regularizado, poderá ativar novos usuários TV normalmente.
</details>

### Assinatura Digital - IXC Assina
A integração IXC Assina, de assinatura digital, é uma funcionalidade que permite o envio de links de assinaturas digitais de documentos, promovendo validade jurídica, autenticidade, integridade dos dados e confiabilidade no processo de assinatura.

>[!TIP] Guia instrutivo
>Para mais informações sobre assinatura digital e a integração IXC Assina, acesse os materiais abaixo:
>- [[integracoes de assinatura digital|Integrações de Assinatura Digital]]
>- [[ixc assina|IXC Assina]]

<details>
<summary>A assinatura do contrato pelo IXC Assina ainda consta como pendente, o que fazer?</summary>
Se a assinatura do contrato pelo IXC Assina ainda consta como pendente, pode ser que o status da assinatura ainda não tenha sido atualizado. Para ajustar o status da assinatura, é possível forçar uma atualização através de uma ação manual, conforme descreve os passos abaixo:

1. Acesse o Contrato do cliente através do caminho: menu Sistema > Cadastros > Contratos > Editar;
2. Navegue até  a aba "Histórico Assinatura Digital";
3. Selecione o documento com o status de "Pendente" e clique em "Visualizar";
4. Clique no botão "Sincronizar Assinatura".

Ao clicar em 'Sincronizar Assinatura', o sistema buscará a informação da assinatura dentro da plataforma parceira, ZapSign.

É importante verificar se o documento já foi realmente assinado. Caso não esteja, envie novamente ao cliente o link para assinatura.
</details>

<details>
<summary>O que fazer quando ocorre erro ao comunicar com o Gateway de Assinatura Digital?</summary>
Esse erro pode estar relacionado a dados divergentes na integração de assinatura digital. Para validar, siga os passos abaixo:

1. Acesse sua conta ZapSign;
2. Clique em "Configurações";
3. Após, clique em "Integrações" e na aba "API ZapSign" ;
4. Copie o token API ZapSign gerado;
5. Após isso, acesse seu IXC;
6. Acesse o menu "Configurações";
7. Clique em "Integrações" > "Integrações de assinatura digital" ;
8. No campo "Token integração" vincule o token copiado anteriormente;
9. Clique em "Salvar".

Realize o teste novamente e confirme se agora está gerando corretamente o link de assinatura digital. Caso o erro continue, valide também:

1. Se o parâmetro está ativado no contrato do cliente em "Utilizar Integração de Assinatura Digital" = "Sim";
2. Clique com o botão direito do mouse no IXC, e clique em "Sobre" e valide se o módulo IXC Assina está ativo;
3. Verifique se o contrato está com o Status Acesso = "Aguardando Assinatura";
4. Tente imprimir o "Modelo para impressão" vinculado no contrato, para validar se o documento está correto para geração do link de assinatura digital.
</details>

---
## Estoque e Patrimônio 
#### Como ajustar o saldo negativo do produto?
<details> <summary>Saldo Negativo</summary>
Para corrigir o saldo negativo de um produto, siga as etapas descritas abaixo utilizando a entrada de compra ou o inventário:

1. Realize uma Entrada compra
- Identifique o almoxarifado negativo:
    - Acesse: Menu Sistema -> Cadastros -> Produtos
    - Clique no botão Editar do produto desejado.
    - Na aba Saldo por almoxarifados, verifique o saldo.
      
-  Criação da entrada:
    - Acesse: Menu Sistema -> Entradas -> Compras
    - Clique em **Nova entrada manual**.
    - Na tela exibida, preencha os campos obrigatórios manualmente e clique em **Salvar**.
    
>[!warning] Atenção
>No campo **Tipo de documento**, insira uma opção que tenha a configuração **Atualiza estoque** como **Sim**, para que o saldo do produto seja ajustado.
    
- Inserção dos produtos para ajuste de saldo:
    -  Navegue até a aba **Produtos** e clique no botão **Novo**.
    - No campo **Produto**, busque e selecione o item com saldo negativo.
    - **Almoxarifado Origem**: Escolha o almoxarifado que está com saldo negativo.
    -  **Quantidade**: Insira a quantidade necessária para corrigir o saldo negativo.
    
- Após salvar, o ajuste estará concluído. Se necessário, insira mais produtos. E após finalizar, clique em **Finalizar entrada** e depois **Validar e finalizar**.

2. Realize um inventário
- Acesse o menu Sistema:
    - Selecione a opção **Estoque**.
    - Em seguida, selecione **Inventário** e clique no botão **Novo**.
      
-  Preencha as informações no Inventário:
    - Na tela Inventário, insira os dados necessários.
    - Clique no botão **Salvar**.
      
- Adicione os itens ao inventário:
    - Acesse a aba **Itens** e clique no botão **Novo**.
    - Na tela Produtos do Inventário, insira o produto que se encontra com o valor negativo.
    - No campo Novo estoque, informe qual será o novo saldo deste produto.
        - Exemplo: Insira o valor "0" para zerar o saldo ou "10" para que o saldo do produto fique com o valor informado.

 >[!warning] Informações Importantes:
 >- O campo **Valor da movimentação** exibirá o montante necessário para o produto alcançar o novo custo médio informado. Isso garante que o sistema realize o cálculo de custo médio precisamente.
 >- O campo **Estoque atual do produto** informa somente o saldo do almoxarifado e filial especificados no inventário.
 >- Só é possível inserir um produto no mesmo dia da criação do inventário.
 >- Não é possível excluir um produto do inventário se houver movimentações entre a data de inclusão e a data de exclusão.</details>
#### Ajuste do produto para finalizar uma saída venda. 
<details> <summary>Erro ao contabilizar. Custo médio do produto não pode ser 0!</summary>
Esse erro ocorre porque o produto possui saldo, mas o cálculo do custo do produto não foi registrado. Para corrigir esse erro e finalizar a nota fiscal, é necessário realizar um inventário do item.

Para realizar o procedimento, siga os passos abaixo:
1. Acesse o menu **Sistema** e selecione a opção **Estoque**. Em seguida, escolha **Inventário**.
2. Clique em **Novo** para iniciar um novo inventário.
3. Preencha os campos necessários com as informações relevantes, como **Filial** e **Almoxarifado**. Clique em **Salvar**.
4. Navegue até a aba **Itens** e clique no botão **Novo**.
5. No campo **Produto**, localize e selecione o produto que será ajustado.
6. No campo **Novo estoque**, informe a quantidade correta do estoque conforme a contagem física.
7. Marque como **Sim** o campo **Alterar custo médio** e insira o valor correto a ser considerado.
8. Após concluir o inventário, salve as alterações realizadas.

Ao realizar o inventário do item, você estará atualizando o estoque e registrando corretamente a entrada do produto, permitindo que a nota fiscal seja concluída sem erros relacionados ao estoque.

 >[!warning] Informações Importantes:
 >- O campo **Valor da movimentação** exibirá o montante necessário para o produto alcançar o novo custo médio informado. Isso garante que o sistema realize o cálculo de custo médio precisamente.
 >- Só é possível inserir um produto no mesmo dia da criação do inventário.
 >- Não é possível excluir um produto do inventário se houver movimentações entre a data de inclusão e a data de exclusão.
 
Após salvar as alterações realizadas no inventário, você pode retornar à saída e finalizar o processo.
</details>

---
## Ordem de serviço
#### Não consigo visualizar ordem de serviço com o meu usuário, o que pode ser?
<details> <summary>Visualizar ordem de serviço</summary>
Este impedimento na visualização de informações está relacionado a alguns filtros aplicados dentro do cadastro do usuário e pode ser resolvido seguindo os seguintes passos:

1. Acesse o menu Configurações.
2. Selecione a opção Usuários.
3. Acesse a opção Usuários.
4. Selecione o usuário e clique no botão Editar.
Observação: Se não puder acessar as configurações de usuário, peça ajuda a um administrador do sistema para fazer a alteração necessária.

Após realizar a edição do usuário, vá até a aba Parâmetros e localize a seção chamada '.Ordem de serviço'.

Nessa sessão, possuímos alguns filtros que podem interferir o usuário a visualizar ordens de serviço, conforme o seu acesso, sendo eles:

Filtra setor OS:
Se o campo estiver marcado como 'Sim', o usuário será limitado a visualizar apenas as ordens de serviço do setor atribuído ao seu Colaborador/Responsável. Isso significa que o usuário não terá acesso às ordens de serviço de outros setores dos quais não faz parte. Caso o campo esteja marcado como 'Não', o usuário em questão terá acesso às ordens de serviço de todos os setores.
- Os setores vinculados ao colaborador ficam localizados na aba 'Setores' do colaborador.

Filtra colaborador OS:
Se o campo estiver marcado como 'Sim', o usuário será limitado a visualizar as ordens de serviço somente quando estiver designado como colaborador/responsável na ordem de serviço. Ele não terá acesso às demais ordens de serviço que já estão destinadas a outros colaboradores. Se o campo estiver marcado como 'Não', o usuário terá acesso às ordens de serviço independentemente de quem esteja designado para elas.

Mostrar OS sem colaborador:
Se o campo estiver marcado como 'Sim', o usuário em questão terá acesso à visualização das ordens de serviço que ainda não foram designadas a algum colaborador/responsável. Se o campo estiver marcado como 'Não', as ordens de serviço que estão em aberto e não possui um colaborador/responsável preenchido na mesma não serão habilitadas para visualização.

Após compreender como os filtros funcionam, vamos aplicá-los de acordo com o nível de acesso que o usuário terá para acessar ou visualizar as ordens de serviços geradas no sistema.
</details>

#### Como extrair um relatório das O.S. que um técnico realizou?
<details> <summary>Relatório de ordem de serviço realizadas por determinado técnico</summary>

Através do relatório de O.S é possível verificar todas as ordens de serviço que um colaborador realizou. Para extrair estes dados, siga os passos abaixo:
1. Acesse o menu Relatórios;
2. Relatórios de Ordem de Serviço;
3. Clique no botão Novo.
4. Após abrir a tela do relatório, preencha o campo 'Descrição' e escolha um Modelo de impressão, por exemplo, 'Detalhado por colaborador'.
5. Para buscar somente as O.S finalizadas por um determinado colaborador, é necessário filtrar o colaborador na aba Principal.
6. Para filtrar um período específico, acesse a aba Datas e horário e preencha o campo Data fechamento. Caso deseje determinar alguma data específica, altere a opção para Data fixa e preencha os campos, caso contrário, mantenha selecionado a opção Período dinâmico e selecione uma das opções disponíveis.
7. Ao imprimir o relatório, será apresentado todas as O.S que foram feitas pelo colaborador filtrado e dentro do período escolhido.

</details>

---
## Redes e  Instalação
### Tráfego em Tempo Real
O **tráfego em tempo real** é uma métrica crucial para monitorar a usabilidade do cliente. Esta informação está disponível na **aba Diagnóstico do login**.

<details>
<summary>Correção de Falha na Coleta de Tráfego (Concentradores Huawei)</summary>

Se a coleta de tráfego falhar em concentradores Huawei, siga este procedimento:

1. Acesse o concentrador Huawei
2. Localize o domain de autenticação PPPoE/IPoE
3. Altere o parâmetro `accounting dual-stack` para `identical`:

```
HUAWEI> system-view
[~HUAWEI] aaa
[~HUAWEI-aaa] domain *nomedominio*
[~HUAWEI-aaa-domain] accounting dual-stack identical
[*HUAWEI-aaa-domain] commit
[~HUAWEI-aaa-domain] display this included-default
```

1. Reconecte o login do cliente e verifique a tela de velocidade em tempo real

### Verificação de Falha de Conexão com o Concentrador

Se persistir o erro "Falha ao conectar-se com o concentrador":

1. Acesse: **Sistema > Provedor > Concentradores (NAS)**
2. Edite o concentrador correspondente
3. Execute o **Teste de conexão**
4. Se falhar, revise login, senha e porta de acesso do concentrador
5. Contate o suporte técnico se o problema persistir
</details>

#### Cadastro de Login
<details>
<summary>Configuração de um Novo Login no IXC</summary>

1. Acesse **Sistema > Provedor > Logins**
2. Selecione o contrato em **Cadastros > Contratos**
3. Clique em **"Editar"**
4. Na aba **"Login"**, clique em **"Novo"**
5. Preencha os campos obrigatórios (autenticação, cliente, plano, login, senha)
6. Vincule o **plano de velocidade** ao contrato
7. Clique em **"Salvar"**

Para adicionar outro acesso ao mesmo contrato, repita o processo.

</details>

#### Como atualizar o Sistema?
<details>
<summary>Passo a Passo: Atualização do Sistema</summary>

1. Clique com o botão direito em qualquer lugar da interface
2. Selecione **"Atualizar Software"**
3. Escolha **"TIMELINE"** (versão mais recente)
4. Clique em **"Atualizar"**
5. Aguarde a conclusão

Para verificar a versão atual:
1. Vá até a **Dashboard**
2. Clique com o botão direito e selecione **"Sobre"**
3. Verifique a versão na tela **"Sobre a IXCSoft"**

> [!IMPORTANTE]
> Realize atualizações em momentos de baixo uso do sistema para evitar impactos operacionais.

</details>

#### Dúvidas sobre autorização de ONU
<details>
<summary>Como autorizar ONU</summary>ok
Para realizar a autorização de uma ONU, siga as etapas abaixo:  

2. Acesse o Menu Sistema -> Provedor -> Autorizar ONUs.  

3. Consulte as ONUs disponíveis, utilize a grid de visualização para buscar ONUs de acordo com sua necessidade:  
     - Consultar todas, o sistema buscará as ONUs em todas as OLTs ativas.  
     - Consultar por OLT, o sistema filtrará a busca apenas na OLT selecionada.  

4. autorizar a ONU  
   - localize a ONU desejada pelo MAC ou Serial, selecione-a e clique na opção autorizar ONU’s.  
   - na aba perfil de cliente fibra ONU, preencha os seguintes campos com os dados do cliente:  
     - projeto  
     - caixa FTTH  
     - porta FTTH  
     - hardware  
     - contrato  
     - login  
     - perfil  
     - VLAN  
  Após preencher as informações, clique em salvar. Em seguida, clique em integração OLT e gravar no dispositivo para que o sistema acesse a OLT e realize a autorização da ONU ou ONT.  
  </details>

---
## Família Inmap
## Inmap Sales
#### O Sales possui alguma integração com o Opa Suite ?
<details>
<summary>Integração do Inmap Sales com o Opa Suite</summary>
O módulo do Inmap Sales possui algumas integrações com o Opa! Suite, sendo elas:
- Disparo de campanhas pelo Opa! Suite (WhatsApp). 
Possibilitando o envio direto de suas campanhas no WhatsApp de seus clientes de forma intuitiva.

- Geração de Lead pelo fluxo de mensagens do OPA.
Automação de captação de leads através da validação de CPF/CNPJ no fluxo de atendimento do BOT com a visualização dos cadastros ja no Kanban e Mapa do Inmap Sales.

Estas são algumas das possibilidades de integrações. Para saber mais, contate o time Opa! Suite para orientações e configurações.
</details>

#### Como enviar propostas de negociação para as prospecções no Sistema?
<details>
<summary>Envio de propostas de negociação</summary>
Para enviar Propostas de Negociação para as Prospecções no IXC-Provedor, siga estes passos:

1 - Acessar a Prospecção:
- Vá até Menu Sistema ➜ CRM ➜ Prospecções.
- Selecione a prospecção desejada e clique em Editar.
- Acesse a aba Propostas e clique em Novo para criar uma nova proposta.

2 - Preencher Campos da Proposta:
- E-mail Destinatário: (Insira o e-mail para envio da proposta)
- Modelo de E-mail: (Selecione um modelo de e-mail pré-configurado)
- Assunto: (O assunto será preenchido automaticamente, podendo ser editado)
- Data e Validade: (Informe as datas de início e validade da proposta)
- Responsável: (Escolha quem será responsável pelo envio)
- Assinatura: (Decida se deseja incluir a assinatura do responsável)

3 - Verificar E-mail da Proposta:
- Na aba E-mail, revise a estrutura do conteúdo que será enviado.
 
4 - Anexar Arquivos (Opcional):
- Na aba Anexos, clique em Novo para adicionar um anexo.
- Escolha o arquivo e insira uma descrição para ele. Em seguida, clique em Salvar.

5 - Salvar e Enviar a Proposta:
- Após preencher os campos, clique em Salvar.
- Em seguida, clique em Enviar e-mail.

6 - Acompanhar o Status das Propostas:
- Na lista de propostas, utilize os filtros para encontrar propostas específicas e monitorar o status de envio.
</details>

#### Como verificar os logins atrelados a uma caixa de atendimento pelo mapa no Inmap Sales?
<details>
<summary>Logins atrelados à caixas de atendimento</summary>
Para verificar os logins vinculados a uma caixa de atendimento pelo mapa do Inmap Sales, siga estes passos:

1 - Acesse Menu Sistema -> Inmap -> Sales -> Acessar as Opções de Mapa:
- No menu lateral, selecione a opção de mapa representada pelo ícone de um 'Globo'.

2 - Habilitar a Visualização das Caixas
- Ative a opção para exibir as caixas de atendimento no mapa.

3 - Visualizar Informações da Caixa
- Ao passar o cursor sobre uma caixa de atendimento, você verá informações como o número de portas e a quantidade de logins ativos e inativos vinculados à caixa.

4 - Detalhar Logins por Porta
- No menu que aparecer, utilize a opção "Listar Portas" para visualizar detalhes sobre os logins e ONUs ocupando cada porta da caixa de atendimento.

Lembre-se de que essas informações exibidas, dependem da correta vinculação entre a Caixa de atendimento e as Portas de cada login.
</details>

## Inmap Fiberdocs
####  Como excluir um elemento do projeto pelo mapa do Fiberdocs?
<details>
<summary>Exclusão de elementos</summary>
Para realizar a exclusão de elemento no Fiberdocs, siga os passos abaixo:

1 - Acessar o Fiberdocs:
- Menu Sistema ➜ Inmap ➜ Fiberdocs.

2 - Selecionar o projeto:
- Selecione o projeto ao qual o elemento pertence.

3 - Identificar o elemento:
- Localize o elemento dentro do projeto.

4 - Habilitar o modo de edição:
- Ative o modo de edição clicando no ícone de lápis.

5 - Selecionar o elemento:
- Após localizar o elemento, clique sobre ele. Em seguida, clique com o botão direito do mouse.

6 - Excluir o elemento:
- Selecione a opção "Remover" no menu.

7 - Confirmar a exclusão:
- Uma mensagem de confirmação aparecerá. Clique em "Deletar" para confirmar a exclusão.

Importante:
- Verifique se o elemento que deseja excluir não possui nenhuma conexão com outro elemento no mapa de conexões ou no editor de fusão.
- Certifique-se de que o modo de edição está habilitado antes de tentar excluir qualquer elemento.
</details>

#### Como bloquear a permissão de edição de CTO no sistema Inmap Fiberdocs?
<details>
<summary>Permissão para editar CTO</summary>
Para bloquear a alteração das Caixa de Atendimento/CTO, é possível efetuar o bloqueio no botão de "Salvar" do registro das Caixa de Atendimento, e desta forma, impedir a alteração do registro das Caixas de Atendimento. O caminho para esse bloqueio é:

1 - Acessar o grupo de usuários
- Menu Configurações -> Usuários -> Grupo de Usuários -> Editar um Grupo de Usuários

2 - Localizar Permissão
- Acessar a aba de permissões e localizar a permissão Sistema > Inmap > Elementos > Caixa de atendimento

3 - Alterar Permissão
- Alternar o botão de "Salvar" para o status Bloqueado.
</details>

#### Como posso ver os logins que tiveram uma queda de conexão no Fiberdocs?
<details>
<summary>Identificação dos logins que tiveram queda</summary>
Para visualizar os logins que tiveram uma queda de conexão no Fiberdocs, você pode seguir estas etapas:

1 - Acesse Menu Sistema ➜ Inmap ➜ Fiberdocs.

2 - Utilize a opção de Filtros ou a Árvore de elementos.

3 - Selecione o projeto desejado ➜ Habilite para visualizar os logins.

4 - Em Filtros, acesse o menu de Logins e marque a opção Colorir logins por: Status de acesso.

5 - Na Árvore de elementos, as cores dos logins serão alteradas de forma que está parametrizado no sistema.

As cores representam os seguintes status:
Vermelho: Logins Offline
Verde: Logins Online
Amarelo: Logins Sem Status
Cinza: Logins com cadastros Inativos
</details>

## Inmap Service
#### Meu técnico consegue requisitar um material no service ?
<details>
<summary>Requisitar materiais pelo Inmap Service</summary>
Sim, o técnico pode solicitar materiais através do aplicativo Inmap Service. No menu “Materiais” do aplicativo, o técnico tem acesso a diversas funcionalidades relacionadas ao estoque, incluindo a opção de realizar requisições.
O processo envolve acessar a seção “Requisições” no menu “Materiais”, onde o técnico pode solicitar os itens necessários para o seu trabalho. Além disso, o aplicativo permite que o técnico verifique seu próprio estoque, acompanhe a quantidade de produtos em seu almoxarifado e, se necessário, faça transferências para outro almoxarifado.
</details>

#### Como criar uma rota com múltiplas ordens de serviço para o técnico no Inmap Service?
<details>
<summary>Criação de rota com múltiplas ordens de serviço</summary>
Para criar uma rota de agendamento para o técnico com diversas ordens de serviço, utilizaremos do "Modo Agendamento" do Service, siga os passos a seguir :

Para criar uma rota, primeiro, aplique um filtro para ver as ordens não agendadas conforme deseja, usaremos o exemplo das ordens de Instalação.

- Clique no mapa com o botão direito do mouse em um local onde não tenha nenhum elemento.

- Selecione a opção "Iniciar modo agendamento", nesse momento, já será possível ver linhas que representam as rotas conforme as ordens já agendadas para os técnicos.

- Clique com o botão esquerdo do mouse nas ordens de serviço não agendadas conforme a ordem que deseja que esse técnico percorra.

- Após definir a rota, no canto inferior direito, clique na opção de "agendar", com o ícone de um calendário.

- Será aberto o Agendamento de Serviços, e na lateral esquerda, as Ordens de serviço vão ser listadas na ordem que foram selecionadas no mapa.

- Arraste as ordens de serviço para a coluna e linha que correspondem ao colaborador com data/hora que quer agendar essa OS.

Dessa forma será feito a rota e o agendamento para o técnico seguindo a ordem selecionada no mapa.
</details>

#### Para que serve a visão de veículos no Inmap Service?
<details>
<summary>Visão veículos</summary>
A visão dos veículos no Service permite rastrear a frota em tempo real, otimizando rotas, alocando técnicos de forma eficiente e monitorando a produtividade. 

Para estar visualizando seus veículos no Inmap Service siga os passos abaixo:
1 - Acesse o Inmap Service:
- Faça login no sistema com suas credenciais.

2 - Ative a visão de veículos:
Habilite o filtro de veículos no menu que contém um ícone de 'Globo'

3 - Localize o veículo:
- Clique com o botão direito do mouse sobre o veículo no mapa.

4 - Exibir rota:
- Selecione a opção "Exibir rota".

5 - Escolha o período de tempo:
Escolha entre "Hoje", "3 Dias" ou "7 Dias" para visualizar a rota dentro do período selecionado.

Importante: 
- O veículo precisa ter um dispositivo de rastreamento instalado e configurado.
- O IMEI do rastreador deve estar corretamente cadastrado no sistema.
- É necessário que as configurações de integração com a plataforma de rastreamento estejam corretas.

Caso tenha problemas com a integração de seu rastreador com o sistema, entre em contato com nossa equipe de suporte de integrações gerais para auxílio.
</details>