ATENÇÃO: Este POST é da área de desenvolvimento, com o intuito de tornar público conhecimentos, regras, dicas sobre essa ferramenta.

Isso não deve ser passado para clientes. As Informações daqui podem ser usadas para criar manuais, vídeos entre outras focado na apresentação para o cliente.

História e Usabilidade

A integração com a TOTVS para cliente funciona da seguinte maneira, um agendador executa o cron saveClientes.cron.php de 6 em 6 horas, chamando a URL http://ec2-18-230-112-29.sa-east-1.compute.amazonaws.com:8051/wsConsultaSQL/IwsConsultaSQL, que pega os clientes e verifica se inclui ou atualiza pelo campo CGC ou COD no webservice que equivalem a CNPJ_CPF ou CODIGO do cliente no CRM.

Para projetos, o agendado executa o cron saveContratos.cron.php de 6 em 6 horas, chamando a URL http://18.230.112.29:8051/RMSRestDataServer/rest/ImbVendaContratoData, pega os contratos, empreendimentos, blocos e unidades e verifica se inclui ou atualiza pelos os seguintes campos, para contrato é NUM_VENDA ou NUM_UNID e NUM_SUB_UNID juntos por um traço (NUM_UNID – NUM_SUB_UNID) no webservice, equivalem a NUM_VENDA e CODIGO do projeto no CRM, para empreendimento utilizamos o CODIGO do empreendimento cadastrado no CRM, para buscar essa informação a gente utiliza o campo COD_PESS_EMPR do webservice, para os blocos é utilizado o campo NUM_UNID do webservice que equivale a CODIGO do bloco no CRM, por último para a unidade utilizamos o campo NUM_SUB_UNID do webservice que equivale a CODIGO da unidade no CRM.

Manual de Integração Totvs – Cobrança e Clientes

1. Objetivo

Deve ser possível realizar a importação de parcelas da cobrança e de clientes, telefones, endereços e contratos da base Totvs.

2. Pré-Requisitos

• Cobrança: Deve ser habilitada a flag de desenvolvimento da ocorrência 178604. Habilitar a configuração proprietária HABILITA_INTEGRACAO_TOTVS. No arquivo .INI do ambiente devem-se configurar as variáveis ‘integracao_totvs_url’ com a URL da API Totvs e ‘integracao_totvs_token’ com o token de acesso da API.
• Clientes e Contratos: Deve ser habilitada a flag de desenvolvimento da ocorrência 178604. No arquivo .INI do ambiente devem-se configurar as variáveis ‘integracao_totvs_url’ com a URL da API Totvs e ‘integracao_totvs_token’ com o token de acesso da API.

3. Desenvolvimento Feito

3.1. Acertos e Criação de Classes

• Cobrança: Foram adicionados alguns acertos para criar a tabela SISTEMA_COB_ENTRADA.
• Clientes e Contratos: Criação da classe Integracao_Totvs, que realiza o tratamento dos filtros, requisição da API Totvs, depara dos campos e salvamento na tabela CRM_SYNC_ENTRADA.

3.2. CRON de Integração

Os CRONs que deverão ser configurados para rodar em um período de 24 horas às 20 horas (Incluindo aos finais de semana) . Ele chamará o arquivo sistema/cron/integracao_Totvs.php e __beta/cobranca/cron/cron_cobranca.php

Exemplo de URL:

• Cobrança: https://teste.multidadosti.com.br/sistema/cron/integracao_Totvs.php?modulo=cobranca&data_ini=2024-01-01&data_fim=2024-06-13
• Clientes e Contratos: https://teste.multidadosti.com.br/sistema/cron/integracao_Totvs.php?modulo=contratos&data_ini=2024-01-01&data_fim=2024-06-13

Filtros aceitos:

• Cobrança:
  • Módulo: cobranca.
  • data_ini: aaaa-mm-dd & data_fim: aaaa-mm-dd. Consulta as parcelas atualizadas nesse período.
  • Todos: Traz todas as parcelas e ignora os filtros se este for passado.
• Clientes e Contratos:
  • Módulo: clientes ou contratos.
  • Filtros para o módulo específico:
    • Contratos e Clientes:
      • data_ini: aaaa-mm-dd & data_fim: aaaa-mm-dd. Consulta os contratos e clientes atualizados nesse período.
    • Contratos:
      • codigo_cliente: 123. Retorna os projetos de um cliente específico.
      • codigo_contrato: 321. Retorna o contrato com o código especificado.
    • Clientes:
      • codigo_cliente: 123. Retorna o cliente específico com o código especificado.

3.3. Client_Vars

• Cobrança e Clientes e Contratos: A variável integra_totvs_{$modulo}_dh_ult_importacao é responsável por definir a data inicial ao rodar o cron. Ao finalizar com sucesso e não ser uma importação personalizada, essa variável receberá o valor da data final, mantendo as datas atualizadas.
• A variável integra_totvs_maximo_dias_a_frente permite configurar o máximo de dias à frente da data inicial caso não tenha sido definida uma data final na busca.

Funcionamento dos Campos de Data durante Execuções do CRON:

A data inicial será a data final da execução anterior, e a data final, caso não seja passada, será ‘x’ dias à frente da data inicial. Esses ‘x’ dias podem ser configurados na client_vars integra_totvs_maximo_dias_a_frente, sendo o valor padrão 50 dias por questões de performance. A data final máxima será o dia atual (HOJE).

3.4. Tela de Testes

Cobrança: Essa integração foi adicionada na tela de testar integração, onde é possível visualizar o retorno da API, realizar consultas e visualizar o depara.

3.5. Changelog

Clientes e Contratos: Foi criado um changelog interno detalhando as modificações feitas para essa integração.

4. De-Para dos Campos:

Cobrança:

<

Contratos

Clientes: