Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice
outlinetrue

Afastamentos (Absences)


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


Aviso

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


Afastamentos (absences)

Item

Descrição

Fluxo:Cliente → PontoWeb
Rotahttps://api.ahgora.com.br/absences
Método:POST
Afastamentos - Absences
CampoTipoObrig.DescriçãoRegra
matriculaStringSimMatrícula do Funcionário
motivoStringSimMotivo do Afastamento*String do motivo de afastamento cadastrado no PontoWeb
Enviar o Código ou o Motivo, é obrigatória uma das informações
inicioStringSimData e/ou hora Inicial do AfastamentoYYYY-MM-DDTHH:MM
fimStringSimData e/ou hora Final do AfastamentoYYYY-MM-DDTHH:MM (Enviando hora final 24:00 corresponde ao dia total)
cod_internoString*SimCó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 do deste campo 'internalCode', caso o mesmo não seja informado não será possível alterar ou remover a ausência pela integração
Este código é armazenado para servir de chave para alterações no afastamento.
Ele deve ser único para todos os afastamentos cadastrados pela integração.
operationStringSimAção a ser realizadaINS 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:

Bloco de código
languagetext
themeEmacs
linenumberstrue
collapsetrue
[
  {
    "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:

Bloco de código
languagetext
themeEmacs
linenumberstrue
collapsetrue
[
  {
    "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:

Bloco de código
languagetext
themeEmacs
linenumberstrue
collapsetrue
{
  "company": "a000101",
  "unique": "bd751350",
  "message": "Absences Integration on progress"
}
Dica

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


ERRO de Validação - Code 400:

Bloco de código
languagetext
themeEmacs
linenumberstrue
collapsetrue
{
  "message": "Request format must be an Array",
  "code": 400
}


ERRO de Autenticação - Code 401:

Bloco de código
languagetext
themeEmacs
linenumberstrue
collapsetrue
{
  "message": "Unauthorized",
  "code": 401
}