Integrando o HCM com plataformas de medicina do trabalho

O problema

Quem trabalha com o módulo HCM do Datasul sabe que uma das integrações mais solicitadas pelos clientes é com plataformas de medicina do trabalho, como SOC e FapOnline.

O desafio é que cada plataforma tem seu próprio layout de arquivo e regras de validação — e qualquer campo fora do padrão causa rejeição silenciosa.

A solução

Após implementar essa integração em vários clientes na TOTVS, aprendi que o segredo está em três pontos:

1. Validar os dados antes de gerar o arquivo — não confie que o ERP sempre vai ter os dados completos
2. Logar tudo — crie uma tabela de auditoria para cada envio
3. Tratar os retornos — as plataformas devolvem arquivos de retorno que precisam ser processados

Exemplo em Progress 4GL

DEFINE VARIABLE cArquivo AS CHARACTER NO-UNDO.
DEFINE VARIABLE iLinha   AS INTEGER   NO-UNDO.

FOR EACH funcionario NO-LOCK
  WHERE funcionario.ativo = TRUE:

  cArquivo = cArquivo + 
    funcionario.cpf + ";" +
    funcionario.nome + ";" +
    STRING(funcionario.dt-admissao, "99/99/9999") + "~n".

  iLinha = iLinha + 1.
END.

Conclusão

Com esses cuidados, a integração funciona de forma estável e auditável. Em um próximo post vou mostrar como tratar os arquivos de retorno do SOC.