Mudanças entre as edições de "Extração de marcações do ponto - API"
De Wiki CGI Software de Gestão
(Criou página com 'Categoria:AdmRH Categoria:Manuais AdmRH '''Para o que é utilizado?'''<br>API usada para extração das marcações do cartão ponto para um período informado.<br><b...') |
|||
(10 edições intermediárias de um usuário não apresentadas) | |||
Linha 2: | Linha 2: | ||
[[Categoria:Manuais AdmRH]] | [[Categoria:Manuais AdmRH]] | ||
− | '''Para o que é utilizado?'''<br>API usada para extração das marcações do cartão ponto para um período informado.<br><br>'''Como utilizar?'''<br> | + | '''Para o que é utilizado?'''<br> |
− | Parâmetros de entrada:<br> | + | API usada para extração das marcações do cartão ponto para um período informado.<br><br> |
− | {| class="wikitable"|-| <center>'''Campo'''</center> || <center>'''Descrição / Comentário sobre os campos'''</center> || <center>'''Exemplo de Preenchimento'''</center> | + | |
− | |-| Data Inicial || Data inicial para extração das marcações do cartão ponto | + | '''Como utilizar?'''<br> |
− | |-| Data Final || Data final para extração das marcações do cartão ponto.|| 11/30/2017 | + | 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.<br><br> |
+ | |||
+ | '''OBS.:''' Será disponibilizado um serviço (WSDL). <br><br> | ||
+ | |||
+ | '''Parâmetros de entrada:'''<br> | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | | <center>'''Campo'''</center> || <center>'''Descrição / Comentário sobre os campos'''</center> || <center>'''Formato'''</center> || <center>'''Exemplo de Preenchimento'''</center> | ||
+ | |||
+ | |- | ||
+ | | 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 | ||
|} <br> | |} <br> | ||
+ | |||
+ | '''XML de retorno:'''<br> | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | | <center>'''ID'''</center> || <center>'''Campo'''</center> || <center>'''Descrição'''</center> || <center>'''Tipo'''</center> || <center>'''Pai'''</center> || <center>'''Formato'''</center> || <center>'''Exemplo de Preenchimento'''</center> | ||
+ | |||
+ | |- | ||
+ | | 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 | ||
+ | |||
+ | |}<br> | ||
+ | |||
+ | '''XML de erro:'''<br> | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | | <center>'''ID'''</center> || <center>'''Campo'''</center> || <center>'''Descrição'''</center> || <center>'''Tipo'''</center> || <center>'''Pai'''</center> || <center>'''Formato'''</center> || <center>'''Exemplo de Preenchimento'''</center> | ||
+ | |||
+ | |- | ||
+ | | 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 | ||
+ | |||
+ | |}<br> |
Edição atual tal como às 10h05min de 23 de novembro de 2017
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:
|
|
|
|
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:
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
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 |