Base de conhecimento
Encontre respostas para suas dúvidas em quatro fontes de conhecimento diferentes ao mesmo tempo, simplificando o processo de pesquisa.

RH - RM - FOP - Cadastro de Atestado via WebService/API utilizando o DataServer SmtAtestadoNovoData

time.png Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como cadastrar um atestado pelo DataServer SmtAtestadoNovoData, através de API / Web Service?

Ambiente
TOTVS RH - TOTVS RH (Linha RM) - TOTVS Folha de Pagamento - A partir da versão 12.1.24

Solução
Antes de cadastrar um novo atestado, recomenda-se consultar os dados de um funcionário já existente. Isso retorna um JSON pronto, que pode ser utilizado como base para o cadastro de um novo.

Além disso, é necessário aplicar um filtro por ID, pois, caso o GET seja executado sem filtros, todos os funcionários serão retornados por padrão. 

As Primary Keys da tabela VATESTADO são CODPESSOA, SEQATESTADO, DTINICIO, CODTPATESTADO
 

Clique aqui para consultar o comando e verificar quais são as Primary Keys

Isso pode impactar o desempenho e resultar em alguns campos sendo carregados como nulos. Portanto, a aplicação de um filtro por ID é essencial para garantir que todos os campos sejam retornados corretamente, com as informações completas para nossa base.


 

Clique aqui para obter um JSON exemplo
{
        "CODPESSOA": 1,
        "SEQATESTADO": 4,
        "DTINICIO": "2026-11-16T00:00:00-03:00",
        "DTFINAL": "2026-11-17T00:00:00-03:00",
        "HORAINICIO": 0,
        "HORAFINAL": 0,
        "DIASATESTADO": "2",
        "CODTPATESTADO": "01",
        "DTPREVFINAL": null,
        "CID": null,
        "AVALRETORNO": null,
        "OBSERVACOES": null,
        "DATAPERICIA": null,
        "NOMEMEDICO": null,
        "REGCONSELHO": null,
        "CHAPARESPABONO": null,
        "CODENTIDADE": null,
        "CODCOLIGADA": 1,
        "NOMETPATESTADO": null,
        "OCUPACIONAL": 0,
        "CODMEDICO": null,
        "IDATESTADO": 12,
        "IDATESTADOPAI": null,
        "ACIDENTETRANSITO": "0",
        "TIPOACIDENTETRANSITO": null,
        "CODPREATESTADO": null,
        "CODORGAOCLASSE": null,
        "CODUFREGISTRO": null,
        "VCHAPAATESTADO": [
            {
                "id": "1$_$3$_$1$_$00001$_$16/11/2026 00:00:00",
                "parent_id": "1$_$3$_$2026-11-16$_$01",
                "CODPESSOA": 1,
                "SEQATESTADO": 4,
                "CODCOLIGADA": 1,
                "CHAPA": "00001",
                "NUMHORAS": null,
                "MOTIVOAFAST": "3",
                "DTINICIO": "2026-11-16T00:00:00-03:00",
                "CODTPATESTADO": "01",
                "DESCMOTIVOAFAST": "Acidente medio no trabalho",
                "RETORNOAUTOMATICO": -1,
                "NUMPROCESSO": null,
                "TIPOPROCESSO": null,
                "ORIGEMALTERACAO": null,
                "CODAFAST": "P",
                "DESCAFASTAMENTO": "Af.Previdência",
                "DTFINAL": "2026-11-17T00:00:00-03:00",
                "CODABONO": null,
                "DESCABONO": null
            }
        ]
    }

Diferente do GET, no POST não é necessário informar o ID nem aplicar um filtro.

Ao finalizar a estrutura do JSON, certifique-se de incluir a chave de fechamento corretamente e garantir que não haja uma vírgula antes dessa chave, evitando erros de formatação.

Segue um exemplo abaixo:

 

Da forma que foi feito no exemplo deste documento, também foi preenchido o HISTÓRICO DE AFASTAMENTO do colaborador em questão:

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _