1. Apontar Horários de Trabalho
Endpoint:
POST https://api1.tradingworks.net/v1/timecardcostcenter/addattendance
Headers:
AUTH-TOKEN: sua_chave_privada_restritiva
Condições
Se o CPF existe e o dia não possui vínculo com outra consultoria (leia-se Empregador | Centro de Custo), os horários serão inseridos e atribuindo o Centro de Custo da consultoria como responsável por aquele dia de trabalho.
Se o CPF existe e o dia de trabalho já foi vinculado a outra consultoria (leia-se Empregador | Centro de Custo), retornará erro.
Quando é enviado um CPF que não foi previamente cadastrado, o mesmo é criado de forma automática com o nome de usuário NOME INDEFINIDO.
Exemplo de Requisição
POST https://api1.tradingworks.net/v1/timecardcostcenter/addattendance
Headers
Headers: AUTH-TOKEN: sua_chave_privada_restritiva
Campos:
Campo | Tipo | Requerido | Exemplo | Observações |
PersonalDocument | string | Sim | "123.456.789-12" | Documento do Colaborador. |
BaseDate | date | Sim | "2023-05-01" | Dia de Trabalho. |
In | string | Sim | "10:00" | Horário de entrada, início do expediente. |
Out | string | Sim | "22:00" | Horário de saída, fim do expediente. |
InPause | string | Não | "13:00" | Entrada da pausa. |
OutPause | string | Não | "15:00" | Saída da pausa. |
CostCenterCode | string | Sim | "Centro01" | Código do Centro de Custo. |
LocaleCode | string | Não | "SP" | Código da Localidade. |
Exemplo de Requisição:
[
{
"PersonalDocument":"586.924.550-83",
"BaseDate":"2026-02-04",
"In":"22:00",
"InPause": "01:00",
"OutPause": "02:00",
"Out": "08:00",
"CostCenterCode": "centro02",
"LocaleCode":"SP"
},
{
"PersonalDocument":"123.201.360-95",
"BaseDate":"2026-02-04",
"In":"07:50",
"InPause": "12:00",
"OutPause": "13:00",
"Out": "17:12",
"CostCenterCode": "50"
},
{
"PersonalDocument":"124.984.552-13",
"BaseDate":"2026-02-04",
"In":"08:00",
"Out": "07:00",
"CostCenterCode": "centro02"
"LocaleCode": "20"
},
{
"PersonalDocument":"114.484.522-13",
"BaseDate":"2026-02-04",
"In":"08:00",
"Out": "07:00",
"CostCenterCode": "centro02"
"LocaleCode: "SP"
}
]
Exemplo de resposta
{
"TotalRecords":4,
"ProcessedRecords":1,
"ErrorCount":3,
"Errors":[
{
"PersonalDocument":"114.484.522-13",
"BaseDate":"2026-02-04",
"Error":"CPF inválido"
},
{
"PersonalDocument":"123.201.360-95",
"BaseDate":"2026-02-04",
"Error":"Centro de custo '50' não encontrado ou não pertence ao empregador do usuário."
},
{
"PersonalDocument":"124.984.552-13",
"BaseDate":"2026-02-04",
"Error":"Local '20' não encontrado"
}
]
}