Afastamentos (Absences)

Serviço utilizado para cadastrar. alterar e remover afastamentos do Ahgora PontoWeb.

Permitido envio em lote, máximo 1000 registros por requisição, ou 1mb (mega)

Afastamentos (absences)

Item	Descrição
Fluxo:	Cliente → PontoWeb
Rota	https://api.ahgora.com.br/absences
Método:	POST

Afastamentos - Absences
Campo	Tipo	Obrig.	Descrição	Regra
matricula	String	Sim	Matrícula do Funcionário
motivo	String	Sim	Motivo do Afastamento	*String do motivo de afastamento cadastrado no PontoWeb Enviar o Código ou o Motivo, é obrigatória uma das informações
inicio	String	Sim	Data e/ou hora Inicial do Afastamento	YYYY-MM-DDTHH:MM
fim	String	Sim	Data e/ou hora Final do Afastamento	YYYY-MM-DDTHH:MM (Enviando hora final 24:00 corresponde ao dia total)
cod_interno	String	*Sim	Código interno do Afastamento	*Obrigatório para manutenções via integração. Este campo é chave para acessar o registro. A manutenção da ausência depende deste campo, caso o mesmo não seja informado não será possível alterar ou remover a ausência pela integração. Ele deve ser único para todos os afastamentos cadastrados pela integração.
operation	String	Sim	Ação a ser realizada	INS operação para inserção ALT para alterar DEL para remoção da ausência

Exemplos de Requisições (Requests)

Corpo da Requisição - Inclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "INS"
  }
]

Corpo da Requisição - Exclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "DEL"
  }
]

Exemplos de Retornos (Responses)

Resposta quando SUCESSO - Code 200:

{
  "company": "a000101",
  "unique": "bd751350",
  "message": "Absences Integration on progress"
}

Para obter mais detalhe, utilize o serviço Process. Para saber mais entre no link.

ERRO de Validação - Code 400:

{
  "message": "Request format must be an Array",
  "code": 400
}

ERRO de Autenticação - Code 401:

{
  "message": "Unauthorized",
  "code": 401
}

ERRO de Permissão - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Observação: Verificar as permissões do usuário para acessar a rota/serviço.