Passar para o conteúdo principal

API - Vínculo de Centro de Custo

Neste artigo verá o uso do endpoint da API da TWO relacionados ao Vínculo de Centro de Custo.

Escrito por Jorge Luis
Atualizado há mais de 2 semanas

1. Vincular Centro de Custo

Endpoint:

POST https://api1.tradingworks.net/v1/timecardcostcenter/bindcostcenter

Headers:

AUTH-TOKEN: sua_chave_privada_restritiva

Condições

  1. Quando não possui consultoria (leia-se Empregador | Centro de Custo) vinculado ao dia de trabalho, é atribuído o Centro de Custo da consultoria responsável por aquele dia de trabalho.

  2. Quando já possui consultoria (leia-se Empregador | Centro de Custo) vinculado ao dia de trabalho, retorna erro.

Exemplo de Requisição

POST https://api1.tradingworks.net/v1/timecardcostcenter/bindcostcenter


Headers

Headers: AUTH-TOKEN: sua_chave_privada_restritiva


Campos:

Campo

Tipo

Requerido

Exemplo

Observações

BaseDate

date

Sim

"2023-05-01"

Dia de Trabalho.

PersonalDocument

string

Sim

"123.456.789-12"

Documento do Colaborador.

CostCenterCode

string

Sim

"Centro01"

Código do Centro de Custo.

LocaleCode

string

Não

"SP"

Código de Localidade.


Exemplo de Requisição:

[
{
"BaseDate":"2026-02-04",
"PersonalDocument":"586.924.550-83",
"CostCenterCode":"Centro01",
"LocaleCode":"SP"
},
{
"BaseDate":"2026-02-09",
"PersonalDocument":"818.092.450-52",
"CostCenterCode":"centro02"
}
]

Exemplo de resposta

{
"TotalRecords":2,
"ProcessedRecords":1,
"ErrorCount": 1,
"Errors":[
{
"BaseDate":"2026-02-09",
"PersonalDocument":"818.092.450-52",
"Error":"Já existe vínculo com outra consultoria para este colaborador na data informada"
}
]
}


Explicação

Com exemplo de resposta acima, podemos saber que o colaborador com o PersonalDocument final 52 não foi processado, uma vez que ele já consta com vinculo naquele dia de trabalho (BaseDate).


Respondeu à sua pergunta?