API de integração SST: como conectar ERP, folha e eSocial
O RH admite no ERP e alguém redigita no sistema de SST. Veja como a API do Bevart recebe admissões, transferências, afastamentos e desligamentos da folha e devolve ASO e eSocial ao ERP, para empresas, contabilidades e consultorias.
O essencial em 30 segundos
- Cadastro em dobro entre folha e SST gera exame admissional atrasado, S-2240 esquecido e colaborador desligado ainda sendo convocado. A integração elimina a redigitação na origem.
- Pela API, o ERP envia cada movimentação de RH e o colaborador entra no Bevart pelo CPF e pela matrícula, na filial, no setor e no cargo correspondentes aos códigos do próprio ERP.
- O caminho de volta também existe: webhooks avisam o ERP de ASO, recibo e recusa do eSocial, e o eSocial de SST pode ser transmitido pelo Bevart ou pelo ERP, por unidade.
Uma API de integração SST é a ponte que faz o sistema de RH e folha e o sistema de segurança e saúde do trabalho conversarem sozinhos. O RH admite, transfere, afasta ou desliga no ERP; a mesma informação chega ao sistema de SST em segundos, sem planilha, sem e-mail e sem alguém redigitando CPF.
Em empresa pequena, o técnico de segurança dá conta de manter o cadastro na mão. Em grupo com três coligadas, vinte filiais e rotatividade alta, não dá. É por isso que grandes contas perguntam, na primeira reunião, se o software de SST integra com Senior, TOTVS ou SAP. Quem responde "exportamos planilha" perde a conta para quem responde "temos API".
Este artigo explica o que a API do Bevart recebe, o que ela devolve, para quem ela faz diferença e como conectar o seu ERP na prática.
Por que o cadastro em dobro entre folha e SST sai caro
O problema da redigitação não é só o tempo gasto. É o atraso entre o fato e o registro no SST, e o que deixa de acontecer nesse intervalo. A tabela resume onde a falta de integração costuma aparecer.
| Movimentação no RH | Sem integração | Com a API |
|---|---|---|
| Admissão | Colaborador chega ao SST dias depois; o admissional corre atrás da data de início | Entra no Bevart no momento da admissão ou da pré-admissão |
| Mudança de cargo ou setor | O GHE e os riscos continuam os da função antiga | Histórico de funções gravado e S-2240 sinalizado para revisão |
| Afastamento longo | Ninguém lembra do exame de retorno | A resposta indica quando o retorno exige exame |
| Desligamento | Colaborador segue ativo e recebendo convocação | Inativado na data informada, com o aviso sobre o exame demissional |
Some a isso o custo invisível: o técnico que deveria estar no campo gasta horas conferindo lista de ativos com o RH. Em consultoria, esse retrabalho se multiplica pelo número de clientes.
O que a API do Bevart recebe do ERP
O ERP, ou o middleware que conversa com ele, envia cada movimentação para um endpoint da API. O tipo de
movimentação vai no campo evento, com os mesmos nomes usados em fluxos de integração de SST
de mercado.
| Evento enviado | O que acontece no Bevart |
|---|---|
NEW_EMPLOYEE |
Cria o colaborador (inclusive pré-admissão); se estava desligado, readmite |
EMPLOYEE_CHANGE |
Atualiza cargo, setor, filial, centro de custo, posto de trabalho ou dados cadastrais |
LEAVE e VACATION |
Registra afastamento ou férias no histórico do colaborador |
RETURN_FROM_LEAVE |
Encerra o afastamento e indica se há exame de retorno |
DISMISSAL |
Inativa o colaborador e indica se o exame demissional é necessário |
CPF, matrícula e os códigos do próprio ERP
O colaborador é identificado por CPF e matrícula, a mesma chave do eSocial. A lotação chega com os códigos que o ERP já usa: coligada, filial, seção, cargo, centro de custo e posto de trabalho. O Bevart traduz esses códigos para os cadastros dele pelo CNPJ da filial, pelo código interno ou pelo nome, e guarda a correspondência.
Quando um código não bate com nada, o envio não se perde. Ele fica em uma fila de mapeamento; alguém aponta o cadastro correspondente e o Bevart reprocessa sozinho tudo que estava travado. O ERP não precisa reenviar.
Preencher o código interno das unidades, setores e funções do Bevart com os mesmos códigos do ERP, e o CNPJ correto de cada unidade, faz a primeira carga casar quase tudo sem mapeamento manual.
Alertas de exame que já saem na resposta
A NR-7 exige o exame de retorno ao trabalho antes que o empregado reassuma as funções, quando a ausência for de 30 dias ou mais por doença ou acidente, de natureza ocupacional ou não (item 7.5.9). O exame demissional deve ser feito em até 10 dias do término do contrato e pode ser dispensado se o último exame ocupacional tiver menos de 135 dias, nos graus de risco 1 e 2, ou menos de 90 dias, nos graus 3 e 4 (item 7.5.11).
Como o Bevart conhece o motivo do afastamento, o grau de risco da unidade e a data do último ASO, a resposta ao retorno e ao desligamento já informa se o exame é necessário. O RH descobre isso no momento da movimentação, e não na fiscalização.
Quer ligar o seu ERP ao SST sem redigitar cadastro?
No Bevart, a chave de API e o mapeamento de códigos são configurados na tela de Integrações, e o colaborador enviado pelo ERP já entra com filial, setor e cargo.
Criar conta grátisPara quem a integração faz diferença
Contabilidades e escritórios de departamento pessoal
O escritório processa a folha de dezenas de empresas e costuma ser a origem da informação de admissão e desligamento. Sem integração, essa informação vai por e-mail para a consultoria ou a clínica de SST, que redigita. Com a API, o sistema de folha envia a movimentação e o escritório recebe de volta o ASO e o recibo do eSocial para fechar o dossiê do colaborador.
Não é preciso que o sistema de folha tenha um conector pronto com o Bevart. Qualquer sistema que consiga chamar uma API REST ou exportar um arquivo CSV consegue integrar.
Empresas com ERP e estrutura de grupo
Grupos que usam Senior HCM, TOTVS RM, Protheus, Datasul ou SAP trabalham com coligadas, filiais e centros de custo. A API mantém essa estrutura: cada colaborador fica ligado à empresa, filial, setor, cargo, centro de custo e posto de trabalho com os códigos do ERP. Se o mesmo CPF e a mesma matrícula existirem em duas coligadas, o CNPJ da filial desempata.
Consultorias e clínicas de SST que atendem grandes contas
Para quem presta serviço de SST, a integração deixa de ser detalhe técnico e vira critério de contratação. O cliente conecta o ERP uma vez, a base de funcionários se mantém sozinha e a equipe técnica fica no que é SST: GHE, inventário de riscos, exames e documentos. Veja também como o controle de PCMSO e exames ocupacionais depende de uma base de colaboradores atualizada.
eSocial de SST: o Bevart transmite ou o ERP transmite
Algumas empresas querem que a consultoria cuide do eSocial de SST. Outras já centralizam todo o eSocial no ERP e não abrem mão disso. Por isso o modo de envio dos eventos S-2210, S-2220 e S-2240 é escolhido por unidade.
- Transmissão direta. O Bevart assina com o certificado digital A1 da empresa e transmite. O ERP acompanha pelos webhooks de evento aceito, com recibo, ou recusado, com a mensagem.
- Repasse de XML. O Bevart gera o XML no leiaute do eSocial e não transmite. O ERP, como o TOTVS eDocs ou o módulo de eSocial da Senior, baixa o XML pela API, assina, transmite e devolve o recibo.
Deixar o sistema de SST e o ERP transmitindo o mesmo empregador. O eSocial recusa o evento duplicado e a correção vira retificação. No modo repasse, o Bevart deixa de colocar os eventos daquela unidade na fila de propósito.
Nos dois modos, os dados de SST continuam nascendo no mesmo lugar: o ASO do S-2220 e os agentes nocivos do S-2240 saem do inventário de riscos e dos exames cadastrados. Se o envio pelo Bevart é novidade para a sua equipe, o guia do S-2240 no Bevart mostra o fluxo completo.
Como conectar o seu ERP ao Bevart na prática
- Crie uma chave de API por sistema e ambiente. Na tela de Integrações, gere uma chave para homologação e outra para produção, com só as permissões necessárias. A chave aparece uma única vez.
- Faça a carga inicial. Envie os colaboradores ativos em lote, em JSON ou CSV, com até 500 movimentações por chamada. Sistemas legados podem deixar o arquivo em uma pasta SFTP.
- Resolva os mapeamentos. Os códigos que não casaram aparecem em uma lista; aponte o cadastro correspondente e o reprocessamento é automático.
- Ligue as movimentações do dia a dia. O ERP ou o middleware passa a chamar a API a cada admissão, transferência, afastamento e desligamento.
- Cadastre os webhooks. Informe a URL do ERP que recebe os avisos e teste a entrega pela própria tela.
- Escolha o modo do eSocial por unidade e valide um evento de ponta a ponta antes de virar a chave para produção.
O time de TI trabalha a partir da documentação OpenAPI, que pode ser importada em ferramentas como Postman e em plataformas de integração do tipo iPaaS. Reenvios não duplicam cadastro: cada movimentação carrega um identificador do ERP, e o Bevart devolve a mesma resposta quando recebe algo que já processou.
Segurança e LGPD na integração
Integração com folha trafega CPF, data de nascimento e afastamento por doença. Por isso a camada foi desenhada com controles que a área de segurança da informação do cliente costuma pedir:
- chave de API guardada só como hash, com permissões por área, restrição de IP e revogação imediata;
- cada chave acessa apenas os dados da própria conta;
- webhooks assinados com HMAC-SHA256, para o ERP confirmar que o aviso veio do Bevart;
- limite de requisições por minuto por chave;
- conteúdo das movimentações processadas apagado após 180 dias, mantendo apenas o registro de quem enviou o quê e quando.
Se a sua operação ainda está organizando o básico do eSocial antes de pensar em integração, comece pelo eSocial SST para empresas e volte a este guia quando a base estiver de pé.
Perguntas frequentes
O Bevart tem API para integrar com ERP?
Sim. O Bevart tem uma API REST com documentação OpenAPI e webhooks. O ERP envia admissões, transferências, férias, afastamentos e desligamentos, e o Bevart devolve ASO, recibos e recusas do eSocial. Para sistemas legados, há envio em lote por CSV e troca de arquivos por SFTP.
A integração funciona com Senior, TOTVS e SAP?
Sim. A API é genérica e funciona com qualquer ERP ou middleware que consiga chamar uma API REST ou gerar arquivo CSV, incluindo Senior HCM, TOTVS RM, Protheus, Datasul e SAP. Os códigos de coligada, filial, seção, cargo e centro de custo do ERP são mapeados para os cadastros do Bevart.
Contabilidade consegue integrar o sistema de folha com o SST?
Sim. O sistema de folha do escritório envia as movimentações dos clientes para a API ou para a pasta SFTP, e recebe de volta o ASO e o recibo do eSocial. Não é necessário um conector pronto: basta o sistema chamar a API REST ou exportar CSV.
Quem transmite o eSocial quando o ERP está integrado?
Você escolhe por unidade. Na transmissão direta, o Bevart assina com o certificado A1 e transmite. No repasse de XML, o ERP baixa o XML pela API, transmite e devolve o recibo. Os dois nunca devem transmitir o mesmo empregador.
Preciso cadastrar os funcionários de novo no Bevart?
Não. A carga inicial é feita em lote a partir do ERP e, depois, as movimentações chegam automaticamente. Colaboradores já cadastrados com o mesmo CPF e matrícula são atualizados, sem duplicar.
