Equatorial Tools

Ferramentas MKOM para processar arquivos Equatorial (REMESSA/RETORNO/MKOne) com segurança operacional.

1) Gerar RETORNO a partir da REMESSA

Gera retorno no layout novo usando os telefones dos Campos 10, 11, 12 e 13 da REMESSA. Aplica percentuais de falha separados entre válidos: Móveis e Fixos. Telefones vazios/zerados/placeholder/fora do padrão ficam como inválidos (02) e não entram nos percentuais. Nome do arquivo sai com data D+1 no nome.

Ex.: 090000
0.05 = 5%
0.40 = 40%
Saída: TXT (layout novo)
Pronto.

2) Montar CSV do MKOne (REMESSA + RETORNO)

Lê o retorno e pega todas as linhas com Titular Contactado. Adiciona 55 no telefone e puxa variáveis da remessa: nome (Campo 5), instalacao (Campo 6), valor (Campo 14), qtdefaturas=1. Remove números duplicados, limita a no máximo 2 telefones por conta/fatura e permite ajustar os nomes das variáveis do CSV.

Variáveis/colunas do CSV MKOne
nome e telefone são fixos e sempre serão gerados. Abaixo você define apenas as variáveis extras, em ordem.
Padrão: Variável 1 = Campo 6 da remessa (instalação), Variável 2 = valor fixo 1 (qtdefaturas), Variável 3 = Campo 14 da remessa (valor). Para novas variáveis, informe o nome e de qual campo da remessa o valor deve ser puxado.
Saída: CSV (;)
Pronto.

3) Unificar retornos antigos e converter para layout novo

Aceita 1 ou vários retornos “antigos” (ou já no novo), unifica todos os detalhes e garante layout novo. Não aplica regra nenhuma. Se o Histórico estiver vazio, preenche conforme o código de retorno (01/02).

Ex.: “EQUATORIAL MARANHÃO” → “EQUATORIAL MARANHAO”
Saída: TXT (layout novo)
Pronto.

4) Gerar Arquivo MKOne - Rio Grande do Sul (XLSX original)

Anexe o XLSX original do cliente e gere um ZIP com: (1) CSV do MKOne (somente registros 01 - Titular Contactado) e (2) XLSX de retorno (arquivo original sem alterar nada, apenas adicionando as colunas: Campanha, Nome da Campanha, Modalidade, Status e Código do retorno). Regras: telefones forçados inválidos (vazio/zerado/placeholder/fixo/fora do padrão) ficam em 02 e não entram no 5%; nos válidos aplica 95% (01) / 5% (02).

Variáveis/colunas do CSV MKOne (RS)
nome e telefone são fixos. Use os campos abaixo apenas para variáveis extras da HSM.
Padrão: Variável 1 = Campo 6 da remessa (instalação), Variável 2 = valor fixo 1 (qtdefaturas), Variável 3 = Campo 14 da remessa (valor). Para novas variáveis, informe o nome e de qual campo da remessa o valor deve ser puxado.
Saída: .zip 

    




    

      
5) Validar Arquivo de Retorno

      

        Valida se o arquivo de retorno está no padrão correto (header, detalhe e trailer).
        Mostra os erros em tela (ex.: Nº Remessa no header sem zeros à esquerda).
      


      

        

          
          
        

        

          
          

            - Header com 5 campos (0;...;Nº Remessa com 6 dígitos;Data)

            - Detalhes com 15 campos (tipo 1)

            - Trailer 9;QTD (igual ao número de detalhes)

            - Nº Remessa no detalhe com 9 dígitos e terminando com o Nº do header

            - Operador (Campo 11) esperado: SMS / APPCHAT
          

        

      


      

        
        
        Saída: diagnóstico em tela
      

      
Pronto.

    





  
6) Relatório diário de envio

      

        Gera um relatório simples para envio à cliente, mostrando somente a quantidade enviada no dia.
        A contagem é baseada nas linhas do RETORNO gerado pelo Equatorial Tools, sem quebrar por status.
      


  

    

      
      
    

    

      
      
    

  


  

    
    
    Saída: dashboard em tela
  


  







  
7) Ajustar retorno por Conta Contrato única

  

    Valida a REMESSA original contra o RETORNO final com SMS e APPCHAT.
    Se uma mesma Conta Contrato aparecer mais de uma vez no retorno,
    mantém apenas uma linha, priorizando Titular Contactado antes de Número Inválido.
    A saída continua no mesmo layout de RETORNO.
  


  

    

      
      
    

    

      
      
    

  


  

    
    
    Saída: TXT + validação em tela
  


  






      
Dicas rápidas

      

        Os percentuais podem ser ajustados conforme necessidade (móveis e fixos).
        Para validar se o servidor subiu, abra /health.