Mudanças entre as edições de "Extração de marcações do ponto - API"
De Wiki CGI Software de Gestão
| (5 edições intermediárias de um usuário não apresentadas) | |||
| Linha 4: | Linha 4: | ||
'''Para o que é utilizado?'''<br> | '''Para o que é utilizado?'''<br> | ||
API usada para extração das marcações do cartão ponto para um período informado.<br><br> | API usada para extração das marcações do cartão ponto para um período informado.<br><br> | ||
| − | |||
'''Como utilizar?'''<br> | '''Como utilizar?'''<br> | ||
| − | 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> | + | 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 | + | |
| + | '''OBS.:''' Será disponibilizado um serviço (WSDL). <br><br> | ||
'''Parâmetros de entrada:'''<br> | '''Parâmetros de entrada:'''<br> | ||
| Linha 14: | Linha 14: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | | <center>'''Campo'''</center> || <center>'''Descrição / Comentário sobre os campos'''</center> || <center>'''Exemplo de Preenchimento'''</center> | + | | <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 | + | | 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.|| 11/30/2017 | + | | Data Final || Data final para extração das marcações do cartão ponto.|| MM/DD/AAAA || 11/30/2017 |
|} <br> | |} <br> | ||
| Linha 30: | Linha 30: | ||
|- | |- | ||
| − | | 1 | + | | 1 || Ponto || Grupo raiz || Grupo || Raiz || || |
|- | |- | ||
| − | | 2 | + | | 2 || Registro || Grupo de marcações do ponto || Grupo || 1 || || |
|- | |- | ||
| − | | 3 | + | | 3 || codEmp || Código da empresa || Elemento || 2 || inteiro || 1 |
|- | |- | ||
| − | | 4 | + | | 4 || codEmpregado || Código do empregado || Elemento || 2 || inteiro || 10 |
|- | |- | ||
| − | | 5 | + | | 5 || dtPonto || Data da marcação do ponto || Elemento || 2 || DD/MM/AAAA || 23/11/2017 |
|- | |- | ||
| − | | 6 | + | | 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> | |}<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 |
