API - Justificativa e Férias | Central de Ajuda TWO

1. Incluir ou Remover Justificativa/Férias

Endpoint:

POST https://api1.tradingworks.net/v1/allowances/add

Headers:

AUTH-TOKEN: sua_chave_privada Content-Type: application/json

Campos

Campo	Tipo	Requerido	Exemplo	Observações
EmployeeNumber	string	Sim	"240341"	Matrícula do colaborador.
EmployerImportRef	string	Opcional	"8888"	Código do empregador. Use se houver duplicidade de matrícula; caso contrário, pode ser omitido.
FromDate	date	Sim	"2017-04-23"	Data de início da justificativa ou férias.
ToDate	date	Não	"2017-05-01"	Data de término do evento.
AllowanceTypeCode	string	Sim	"LIC_MED"	Código de justificativa (conforme cadastro interno). Use REMOVER para excluir, F, FÉRIAS ou FERIAS para inserir férias.
AllowanceHours	string	Não	"04:00"	Para especificar horas exatas. Se omitido, abona todo o dia.
AllowanceNote	string	Não	"Consulta médica"	Observação adicional que aparecerá na folha de ponto.

Exemplos de Requisição

[
  {
    "EmployeeNumber": 240341,
    "FromDate": "2017-04-15",
    "ToDate": "2017-04-25",
    "AllowanceTypeCode": "LIC_MED",
    "AllowanceNote": "Consulta médica"
  },
  {
    "EmployeeNumber": 23412,
    "FromDate": "2017-04-28",
    "AllowanceTypeCode": "Afastamento",
    "AllowanceNote": "Acidente de trabalho, afastado até segunda ordem"
  },
  {
    "EmployeeNumber": 240341,
    "FromDate": "2017-04-15",
    "ToDate": "2017-04-20",
    "AllowanceTypeCode": "REMOVER"
  },
  {
    "EmployeeNumber": 240341,
    "FromDate": "2017-04-15",
    "ToDate": "2017-04-20",
    "AllowanceTypeCode": "F"
  },
  {
    "EmployeeNumber": 240341,
    "FromDate": "2017-04-15",
    "ToDate": "2017-04-15",
    "AllowanceTypeCode": "Abono",
    "AllowanceHours": "04:00"
  }
]

Dicas e Observações Importantes

Use o parâmetro AllowanceTypeCode com:
- REMOVER → para apagar justificativas existentes no período.
- F, FÉRIAS ou FERIAS → para marcar férias.
Se AllowanceHours não for informado, o dia será totalmente abonado.
A API ignora duplicações — se uma justificativa já existe para o período, nenhuma ação adicional será realizada.