Replicação de Contrato ISP & IXC

Passo 1: Habilitar Integração e Credenciais

O primeiro passo ocorre dentro das configurações globais da empresa no ISPCloud.

1. Acesse o menu lateral e vá em Configurações > Empresas > Parametros Gerais.
2. Localize a seção de parâmetros de integração (conforme a imagem).
3. No campo “Habilitar replicação IXC?”, selecione a opção Sim.
4. Preencha o campo “API IXC” (Informe a api do ixc)
5. Insira o “Token IXC” gerado no seu painel IXC para autorizar a comunicação. (Informe o token ixc)

Passo 2: Mapeamento de Planos e Subplanos

Após habilitar a integração, você deve vincular os planos do ISPCloud aos seus respectivos IDs no IXC. Isso garante que, ao replicar o contrato, o serviço correto seja selecionado.

1. No menu lateral, acesse Cadastros e selecione a opção Planos/Subplanos.
2. Escolha o plano que deseja integrar e clique em editar.
3. No formulário de edição, localize o campo “ID Externo replicação”.
4. Insira neste campo o ID do plano correspondente que está cadastrado no seu sistema IXC Soft.
5. Clique em salvar para aplicar a alteração.

Dica: Repita esse processo para todos os planos que devem ser replicados. Sem o ID Externo preenchido, a integração não conseguirá identificar o pacote de serviços no destino.

Passo 3: Cadastro de Cliente e Replicação

Este é o passo mais importante, pois é onde os dados do novo assinante são enviados para o IXC.

1. No menu lateral, acesse Cadastrar cliente.
2. Realize o fluxo completo de cadastro, passando obrigatoriamente pelas etapas de:
   • 1 – Consulta de Viabilidade;
   • 2 – Dados Complementares;
   • 3 – Contato;
   • 4 – Endereço de cobrança.

1. Ao chegar na etapa final, clique na aba 5 – Contrato.
2. Preencha os dados do contrato e, antes de finalizar, não esqueça de clicar no botão ‘REPLICAR CONTRATO’ (conforme indicado na sua instrução).

Atenção: É este clique na aba de Contrato que aciona a comunicação com a API do IXC que configuramos no Passo 1. Certifique-se de que todos os dados obrigatórios do contrato estejam preenchidos corretamente para evitar erros de validação no sistema de destino.

Passo 4: Validação e Faturamento no IXC

Após o processo de cadastro no ISPCloud, é fundamental compreender o comportamento da integração no sistema de destino (IXC).

Regra de Replicação

• Status Obrigatório: A replicação é válida somente para contratos com status Ativo. Certifique-se de que a ativação foi concluída com sucesso no ISPCloud para que os dados sejam transmitidos.
• Atenção: Certifique-se de que o plano de venda dentro do IXC esteja vinculado a uma carteira de cobrança padrão. Sem esse vínculo no IXC, a replicação pode apresentar falhas no faturamento.

Bloqueio Automático por Inadimplência

A integração também garante que a situação financeira do cliente no IXC reflita diretamente na navegação pelo ISPCloud.

1. Monitoramento: O sistema ISPCloud realiza uma varredura automática a cada 30 minutos.
2. Verificação de Inadimplência: Durante essa consulta, o ISPCloud busca no IXC todos os clientes que possuem faturas em atraso (inadimplentes).
3. Bloqueio Automático: Caso o cliente esteja inadimplente no IXC, o ISPCloud realiza o bloqueio automático do acesso no sistema ISP, sem necessidade de intervenção manual.

Importante: Para que isso funcione corretamente, o vínculo entre os sistemas deve estar ativo e o cliente deve ter sido replicado seguindo os passos anteriores.