API - Colaboradores
Objetivo
Descrever métodos de acesso à API de Colaboradores ( Employees).
Listar
Endpoint
https://api1.tradingworks.net/v1/employees
Método
GET
Headers
AUTH-TOKEN = Sua Chave privada
Novo/edição de colaborador
Endpoint
https://api1.tradingworks.net/v1/employees
Método
POST
Parâmetros
EmployeeNumberIsPK - Indica que o sistema irá validar o EmployeeNumber para confirmações de existência do colaborador. O padrão é o Email
Exemplo:
https://api1.tradingworks.net/v1/employees?EmployeeNumberIsPK=true
AudityID - Para fins de auditoria, indica o EmployeeID do colaborador com nível EXECUTIVO para gravar nos logs de auditoria. Se não informado, será usado o primeiro colaborador com nível EXECUTIVO encontrado, o mais antigo cadastrado.
Exemplo:
https://api1.tradingworks.net/v1/employees?AudityID=456734
Headers
AUTH-TOKEN = Sua Chave privada Content-Type = application/json
Dados
| Campo | Tipo | Requerido | Exemplo | Observações |
|---|---|---|---|---|
| EmployeeNumber |
string (50) |
Não* | "45783" | Número de matrícula do colaborador.
Obrigatório caso parâmetro EmployeeNumberIsPK = true. |
| FirstName |
string (250) |
Sim* | "José" | Primeiro nome do colaborador.
Obrigatório se FullName não informado. |
| MiddleName |
string (250) |
Não | "Machado" | Nome do meio do colaborador. |
| LastName |
string (250) |
Sim* | "Silva" | Último nome do colaborador.
Obrigatório se FullName não informado. |
| FullName |
string (750) |
Sim* | "José Machado Silva" | Nome completo do colaborador.
Obrigatório quando FirstName e LastName vazios |
| NickName |
string (30) |
Não | "José" | Nome reduzido para apresentação em algumas telas. |
|
string (250) |
Sim* | "nome@empresa.com" | E-mail do colaborador.
Opcional caso seja usado o PIN. |
|
| PIN |
int |
Sim* | "2330" | Número para autenticação no app ou quiosque. Geralmente igual à matrícula.
Opcional caso seja usado o e-mail. |
| ActivateApp |
boolean |
Não | True
False - padrão |
Indica que deve gerar código de ativação para o colaborador (AppCode1 e AppCode2) para que ele possa ativar o aplicativo de celular.
PIN ou EmployeeNumber obrigatório. |
| AppCode1 |
string (7) |
Leitura | AAA1111 | Código 1 para ativação do aplicativo. |
| AppCode2 |
string (7) |
Leitura | AAA1111 | Código 2 para ativação do aplicativo. |
| ActivateAppV1 |
boolean |
Não | True
False - padrão |
OBSOLETO - apenas para o aplicativo antigo, versão 1.
Indica que deve gerar código de ativação para o colaborador (AppCode1 e AppCode2) para que ele possa ativar o aplicativo de celular. PIN ou EmployeeNumber obrigatório. |
| ManagerNumber |
string (50) |
Não | "453" | Número da matrícula do gestor.
Para indicar o gestor podem ser usados o ManagerNumber ou ManagerFullName. |
| ManagerFullName |
string (750) |
Não | "Roberto Moraes" | Nome completo do gestor.
Para indicar o gestor podem ser usados o ManagerNumber ou ManagerFullName. |
| EmployerImportRef |
string (50) |
Sim | "67" | Código de vinculação do empregador.
Para indicar o empregador também podem ser usados o EmployerName ou EmployerVAT. |
| EmployerName |
string (250) |
Não | "Industrias Runidas ltda." | Razão social do empregador.
Para indicar o empregador podem ser usados o EmployerImportRef, EmployerName ou EmployerVAT. |
| EmployerVAT |
string (50) |
Não | "14.122.321/0001-09" | CNPJ do empregador.
Para indicar o empregador podem ser usados o EmployerImportRef, EmployerName ou EmployerVAT. |
| NeedAttendance |
boolean |
Não | true (padrão) | Indica que o colaborador deve registrar o ponto.
Para indicar o empregador podem ser usados o EmployerName ou EmployerVAT. |
| Department |
string (100) |
Não | "Financeiro" | Nome do departamento que o colaborador está inserido. |
| AttendanceRule |
string (50) |
Não | "SEG-SEX 08:00 - 17:00" | Nome da regra de ponto a ser associada.
Ela deve estar previamente criada. Erro caso não exista. |
| LocalHoliday |
string (50) |
Não | "Rio de Janeiro" | Nome do calendário de feriados locais a ser aplicado.
Ele deve estar previamente criada. Erro caso não exista. |
| AccessLevel |
string (50) |
Não | SOLICITANTE
COLABORADOR - padrão COORDENADOR GESTOR EXECUTIVO |
Limita o que este colaborador pode fazer dentro do sistema. |
| ManagerRestricted |
boolean |
Não | FALSE - padrão | Aplicável apenas para AccessLevel GESTOR, onde seus acessos são restringidos ao time sob sua supervisão direta. |
| LicenseType |
string (50) |
Não | PONTO - padrão ATIVIDADES | Tipo de acesso e visão dos módulos do sistema. |
| TimeZone |
string (60) |
Não | 'E. South America Standard Time' - padrão | Lista UTC dos fusos horários. Ver lista aqui. |
| OnlyAttendance |
boolean |
Não | TRUE - padrão | Para clientes com ambientes mistos de controle de ponto e controle de atividades. Se ativo, o colaborador não vê opções de ver atividades. |
| AdmissionDate |
date |
Não | "2016-12-03" | Data de admissão. |
| StatusEmployeeID |
integer |
Não | "1" | 1 - Ativo - padrão
2 - Inativo |
| TerminationDate |
date |
Não | "2019-04-23" | Data de desligamento. |
| PersonalDocument |
string (30) |
Não | "123.177.788-84" | Número do CPF. |
| SocialSecurity |
string (30) |
Não | "120.23362.88-7" | Número do PIS. |
| WorkDocument |
string (30) |
Não | "233.212.111/455 SP" | Número da carteira de trabalho. |
| Gender |
string (1) |
Não | "M" - masculino "F" - feminino | Sexo. |
| JobTitle |
string (50) |
Não | "Analista financeiro" | Cargo odo colaborador. |
| BirthDate |
date |
Não | "1983-03-30" | Data de nascimento. |
| PhoneNumber |
string (50) |
Não | "11-3222-3332 R45" | Número de telefone. |
| MobileNumber |
string (50) |
Não | "11-9-8822-2221" | Número do telefone celular. |
| Address1 |
string (500) |
Não | "Rua José Bonifácio" | Nome do logradouro. |
| Address2 |
string (100) |
Não | "Condomínio Alcântara" | Complemento do endereço. |
| AddressNumber |
string (10) |
Não | "341" | Número do logradouro. |
| Region |
string (100) |
Não | "Jardim das Flores" | Bairo ou similar. |
| City |
string (100) |
Não | "São Paulo" | Nome da cidade. |
| State |
string (100) |
Não | "SP" | Nome ou sigla do estado. |
| ZipCode |
string (15) |
Não | "04663-009" | CEP do endereço. |
| Country |
string (100) |
Não | "Brasil" | Nome do país. |
Exemplo
[
{
"FullName": "Roberto Moraes",
"Email": "rmoraes@empresa.com.br",
"EmployeeNumber": "3342",
"AccessLevel": "gestor",
"ActivateApp": "true"
},
{
"FullName": "José Machado Silva",
"Email": "jmsilva@empresa.com.br",
"EmployeeNumber": "45783",
"PIN": "45783",
"Manager": "Roberto Moraes",
"ActivateApp": "true"
}
]