Extração de marcações do ponto - API

De Wiki CGI Software de Gestão
Ir para: navegação, pesquisa


Para o que é utilizado?
API usada para extração das marcações do cartão ponto para um período informado.

Como utilizar?
A comunicação será baseado em webservices no padrão SOAP, com troca de mensagens em XML. Onde serão passados dois parâmetros de entrada e retornado um XML com os dados solicitados.

OBS.: Será disponibilizado um serviço (WSDL).

Parâmetros de entrada:

Campo
Descrição / Comentário sobre os campos
Formato
Exemplo de Preenchimento
Data Inicial Data inicial para extração das marcações do cartão ponto MM/DD/AAAA 11/01/2017
Data Final Data final para extração das marcações do cartão ponto. MM/DD/AAAA 11/30/2017

XML de retorno:

ID
Campo
Descrição
Tipo
Pai
Formato
Exemplo de Preenchimento
1 Ponto Grupo raiz Grupo Raiz
2 Registro Grupo de marcações do ponto Grupo 1
3 codEmp Código da empresa Elemento 2 inteiro 1
4 codEmpregado Código do empregado Elemento 2 inteiro 10
5 dtPonto Data da marcação do ponto Elemento 2 DD/MM/AAAA 23/11/2017
6 hrExtra50 Número de horas extras a 50 % no dia (Normal e Noturnas) Elemento 2 decimal 10,30 - 8,45
6 hrExtra100 Número de horas extras a 100 % no dia (Normal e Noturnas) Elemento 2 decimal 8,15 - 5,38
7 Marcacao Grupo das horas das marcações do ponto Grupo 2
8 hrMovto Hora da marcação do ponto Elemento 7 decimal 07,00 - 11,30 - 13,10 - 17,52

XML de erro:

ID
Campo
Descrição
Tipo
Pai
Formato
Exemplo de Preenchimento
1 Erro Grupo raiz Grupo Raiz
2 Código Código do erro Elemento 1 inteiro 01 - 02
3 Descrição Descrição do erro Elemento 1 caracter Sem marcações - Data inicial inválida - Data final inválida