É possível utilizar a rotina "Geração das Marcações" via API REST. É necessário possuir o fonte TECM910.prw compilado no repositório. O caminho da API é o api/tec/v1/SMTimeTrack/ e a requisição é através de uma operação de POST. A tabela abaixo indica quais propriedades do JSON no POST correspondem com quais parâmetros da rotina: Propriedade | Parâmetro | Tipo | Obrigatório |
---|
employeeFrom | MV_PAR01 | texto | Sim, se não possuir a propriedade employees. | employeeTo | MV_PAR02 | texto | Sim, se não possuir a propriedade employees. | startDate | MV_PAR03 | texto, no formato YYYY-MM-DD | Sim | endDate | MV_PAR04 | texto, no formato YYYY-MM-DD | Sim | operation | MV_PAR05 | numérico (1 ou 2) | Sim | keepShiftBreak | MV_PAR06 | numérico (1 ou 2) | Sim | employees |
| array | Sim, se não possuir as propriedades employeeFrom e employeeTo |
A propriedade "employees" pode ser utilizada para listar quais atendentes (AB9_CODTEC) devem ser considerados.
Exemplo 1 de requisição: { "employees": ["TEC01900000135","TEC01900000136","TEC01900000137"], "startDate": "2019-05-07", "endDate": "2019-05-08", "operation": 1, "keepShiftBreak": 1 }
Exemplo 2 de requisição: { "employeeFrom": "TEC01900000135", "employeeTo": "TEC01900000137", "startDate": "2019-05-07", "endDate": "2019-05-08", "operation": 1, "keepShiftBreak": 1 }
A API pode retornar status 200 - OK caso alguma marcação seja inclusa ou 400 caso nenhuma marcação seja processada. No retorno também existe uma propriedade "message" que exibe o mesmo retorno que seria exibido caso a rotina fosse executada via interface. { "message": "Foram processadas: 4 marcações de entrada e saída." } Saiba mais em: Web Services REST/Server Configuração REST do Protheus FWRestModel - API RESTful dos modelos de dados do Protheus |