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

De Wiki CGI Software de Gestão
Edição feita às 09h59min de 23 de novembro de 2017 por Csc (Discussão | contribs)

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 no IIS.

Parâmetros de entrada:

Campo
Descrição / Comentário sobre os campos
Exemplo de Preenchimento
Data Inicial Data inicial para extração das marcações do cartão ponto. 11/01/2017
Data Final Data final para extração das marcações do cartão ponto. 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