manual do sdk para rep...

May/2014

manual do sdk para rep trilobitlayouts

Manual layouts 2


Versão 1.01 - Maio de 2014.

as informações contidas neste manual estão sujeitas a alterações sem prévio aviso e não representam compromisso por parte do fabricante. o software descrito neste manual é fornecido na forma de licença de uso ou na forma de acordo contratual. o software pode ser utilizado ou copiado apenas nos casos explícitos dos termos do contrato. nenhuma parte deste documento pode ser reproduzida ou transmitida em qualquer forma ou por qualquer meio, eletrônico ou mecânico, incluindo fotocópias, gravação ou sistemas de armazenamento e recuperação de informações para qualquer propósito diverso daquele especificado no contrato sem autorização formal.

trilobit® - todos os direitos reservados.

Manual layouts 3


Sumário

1. ApresentAção .................................................................................................................................................................................................... 5

2. empregAdor ...................................................................................................................................................................................................... 6

2.1 Layout do arquivo texto .........................................................................................................................................................62.1.1 Tipos de RegisTRo ...............................................................................................................................................................................................................6

3. empregAdos ....................................................................................................................................................................................................... 7

3.1 Layout do arquivo texto Com CabeçaLho .............................................................................................................................73.1.1 Tipos de RegisTRo ................................................................................................................................................................................................................7

3.2 Layout do arquivo texto Sem CabeçaLho ..............................................................................................................................93.2.1 definição de Campos .......................................................................................................................................................................................................9

3.3 Layout da LiSta ........................................................................................................................................................................ 103.3.1 definição de Campos ....................................................................................................................................................................................................10

3.3.2 ExEmplo .................................................................................................................................................. 10

3.4 Layout do datatabLe ............................................................................................................................................................ 113.4.1 definição de Campos ....................................................................................................................................................................................................11

4. BiometriAs ....................................................................................................................................................................................................... 12

4.1 Layout do arquivo texto Com CabeçaLho .......................................................................................................................... 124.1.1 Tipos de RegisTRo .............................................................................................................................................................................................................12

4.1.2 ExEmplo .................................................................................................................................................. 13

4.2 Layout do arquivo texto Sem CabeçaLho ........................................................................................................................... 144.2.1 definição de Campos ....................................................................................................................................................................................................14

4.2.2 exemplo ..............................................................................................................................................................................................................................14


4.3.2 exemplo ..............................................................................................................................................................................................................................15

4.4 Layout do datatabLe ............................................................................................................................................................. 164.4.1 definição de Campos ....................................................................................................................................................................................................16

4.5 Layout do bytearray ............................................................................................................................................................. 174.5.1 definição de Campos ....................................................................................................................................................................................................17

5. AFd ..................................................................................................................................................................................................................... 18

5.1 Layout do arquivo texto ...................................................................................................................................................... 185.1.1 definição de Campos ....................................................................................................................................................................................................18


5.3 Layout do datatabLe ............................................................................................................................................................. 205.3.1 definição de Campos ....................................................................................................................................................................................................20

6. ConFigurAção .................................................................................................................................................................................................. 21

6.1 Layout do arquivo texto Com CabeçaLho .......................................................................................................................... 216.1.1 Tipos de RegisTRo .............................................................................................................................................................................................................21

6.1.2 exemplo ..............................................................................................................................................................................................................................21

6.2 Layout do arquivo texto Sem CabeçaLho ........................................................................................................................... 226.2.1 definição de Campos ....................................................................................................................................................................................................22

Manual layouts 4


6.2.2 exemplo ..............................................................................................................................................................................................................................22


6.3.2 exemplo ..............................................................................................................................................................................................................................23


7. mApeAmento mrp ............................................................................................................................................................................................ 25


Manual layouts 5


1. ApreSentAção

Este documento apresenta o layout dos arquivos que são gerados e/ou lidos pelos módulos desenvolvidos pela trilobit para envio e recebimento de dados dos equipamentos REP(Registrador Eletrônico de Ponto) da trilobit.

Manual layouts 6


2. empregAdor

2.1 layout do arquivo tExto

2.1.1 tipos de registro

Cabeçalho

Este registro tem o objetivo de identificar o tipo do arquivo gerado.

Campo Tipo ConTeúdo

1 numérico tipo do arquivo. Valor fixo: “1”

Alteração

Este registro tem o objetivo de incluir ou alterar dados do empregador no REP


1 numérico tipo do registro. Valor fixo: “1”.

2 numérico

tipo de identificador do empregador.

Valores Possíveis:

1 = CnPJ

2 = CPF

3 numérico CnPJ ou CPF do empregador.

4 numérico CEI do empregador, quando existir.

5 alfanumérico Razão social ou nome do empregador.

6 alfanumérico local de prestação de serviços.

importAnte: Os campos devem estar separados por ponto e vírgula (;).

exemplo

supondo que o empregador possua os seguintes dados:

Campo Valor

tipo de documento utiliza CPnJ

Documento (CPnJ) 05.741.912/0002-19

CEI não possui.

Razão social tRIloBIt

local de prestação de serviço Rua alVaREnGa, 1377

o arquivo deverá ser gerado da seguinte maneira:

1

1;1;5741912000219;0;TRILOBIT;RUA ALVARENGA, 1377

Manual layouts 7


3. empregAdoS

3.1 layout do arquivo tExto Com CabEçalho


Cabeçalho




inclusão ou Alteração

Este registro tem o objetivo de incluir ou alterar dados de um empregado no REP



2 numérico número do PIs do empregado.

3 alfanumérico nome do empregado.

4 alfanumérico Identificação do empregado. Pode ser o número do crachá ou a matrícula.

5 numérico

Indica se o empregado deve ou não utilizar biometria.

Valores Possíveis:

0 = não utiliza biometria

1 = utiliza biometria


exclusão

Este registro tem o objetivo de excluir dados de um empregado do REP.





Manual layouts 8


exemplo

Para a seguinte lista de empregados:

nº piS nome CraChá poSSui biomeTria

1 02734500480 luCIano 0018141437 nÃo

2 20584051381 lIlIan 0018141438 nÃo

3 99516422412 aDonIs 0018141439 nÃo

4 98730318690 VItoR 0018141440 nÃo

5 71608120765 alEXanDRE 0018141441 nÃo

supondo que os funcionários 1, 2, 4 e 5 devam ser incluídos e/ou alterados no REP e o funcionário 3 deva ser excluído, o arquivo deverá ser gerado da seguinte maneira:

2

1;02734500480;LUCIANO;0018141437;0

1;20584051381;LILIAN;0018141438;0

2;99516422412

1;98730318690;VITOR;0018141440;0

1;71608120765;ALEXANDRE;0018141441;0

Manual layouts 9


3.2 layout do arquivo tExto SEm CabEçalho

3.2.1 definição de Campos





4 numérico


Valores Possíveis:




exemplo



1 02734500480 luCIano 0018141437 nÃo

2 20584051381 lIlIan 0018141438 nÃo

3 99516422412 aDonIs 0018141439 nÃo

4 98730318690 VItoR 0018141440 nÃo

5 71608120765 alEXanDRE 0018141441 nÃo

o arquivo será gerado da seguinte maneira:

02734500480;LUCIANO;0018141437;0

20584051381;LILIAN;0018141438;0

99516422412;ADONIS;0018141439;0

98730318690;VITOR;0018141440;0

71608120765;ALEXANDRE;0018141441;0

Manual layouts 10


3.3 layout da liSta






4 numérico


Valores Possíveis:



importAnte: Os campos são separados pelo caracter separador de campo especificado.

Os registros são separados pelo caracter separador de registro especificado.

3.3.2 exemplo

supondo que os seguintes empregados estejam cadastrados no REP:


1 02734500480 luCIano 0018141437 nÃo

2 20584051381 lIlIan 0018141438 nÃo

3 99516422412 aDonIs 0018141439 nÃo

4 98730318690 VItoR 0018141440 nÃo

5 71608120765 alEXanDRE 0018141441 nÃo

E que seja usado o separador de registro “|” (pipe) e o separador de campo “;” (ponto e vírgula), a lista será gerada da seguinte maneira:

02734500480;LUCIANO;0018141437;0|20584051381;LILIAN;0018141438;0|99516422412;ADONIS;0018141439;0|98730318690;VITOR;0018141440;0|71608120765;ALEXANDRE;0018141441;0

Manual layouts 11


3.4 layout do datatablE






4 numérico


Valores Possíveis:



Manual layouts 12


4. BiometriAS



Cabeçalho




inclusão

Este registro tem o objetivo de incluir a biometria indicada de um empregado no REP




3 alfanuméricoBiometria do empregado. o valor de cada um dos 512 bytes deve ser separado por vírgula (,).


exclusão

Este registro tem o objetivo de excluir toDas as biometrias de um empregado do REP.





Manual layouts 13


4.1.2 exemplo


nº piS biomeTria

1 02734500480 Informação biométrica do empregado.


3 99516422412 EXCluIR toDas.



supondo que os funcionários 1, 2, 4 e 5 tenham apenas uma biometria para ser enviada e o funcionário 3 deva ter toDas as biometrias excluidas, o layout ficaria como o seguinte:

4

1;02734500480;69,48,39,39......................,20

1;20584051381;69,47,39,39......................,238

2;99516422412

1;98730318690;69,42,39,39......................,96

1;71608120765;69,20,39,39......................,151

Manual layouts 14






2 alfanuméricoBiometria do empregado. o valor de cada um dos 512 bytes deve ser separado por vírgula (,).


4.2.2 exemplo


nº piS biomeTria






o arquivo será gerado da seguinte maneira:

02734500480;69,48,39,39......................,20

20584051381;69,47,39,39......................,238

99516422412;69,129,39,39......................,0

98730318690;69,42,39,39......................,96

71608120765;69,20,39,39......................,151

Manual layouts 15


4.3 layout da liSta




2 alfanumérico Biometria do empregado.



Os bytes da biometria são separados pelo caracter separador de bytes especificado.

4.3.2 exemplo

supondo que os seguintes empregados estejam cadastrados no REP:

nº piS biomeTria






E que seja usado o separador de registro “|” (pipe), o separador de campo “;” (ponto e vírgula) e o separador de bytes “,” (vírgula), a lista será gerada da seguinte maneira:

02734500480;69,48,39,39......................,20|20584051381;69,47,39,39......................,238|99516422412;69,129,39,39......................,0|98730318690;69,42,39,39......................,96|71608120765;69,20,39,39......................,151

Manual layouts 16






2 alfanuméricoBiometria do empregado. o valor de cada um dos 512 bytes é separado por vírgula (,).

Manual layouts 17


4.5 layout do bytEarray



1 array de numeros números de PIs dos empregados que possuem biometria.

2 array Multidimensional de Bytes Biometrias dos empregados.

importAnte: O PIS da posição 0 (zero) do array de PIS é relacionado à biometria contida na posição 0 (zero) do array de biometrias e assim por diante.

Manual layouts 18


5. AFd

5.1 layout do arquivo tExto


o arquivo texto do aFD será gerado com base no layout do anexo I da Portaria nº 1.510/2009, de 21 de agosto de 2009.

Manual layouts 19


5.2 layout da liSta


Cada tipo de registro desta lista possui um número de campos específico, baseado no layout do anexo I da Portaria nº 1.510/2009, de 21 de agosto de 2009.

a lista sempre terá os registros “Cabeçalho” e “trailer”, que são definidos na Portaria. Entre estes dois registros serão incluídos os dados de marcações, inclusões, alterações e ajustes feitos no REP.



Manual layouts 20




Cada tipo de registro desta lista possui um número de campos específico, baseado no layout do anexo I da Portaria nº 1.510/2009, de 21 de agosto de 2009.

a lista sempre terá os registros “Cabeçalho” e “trailer”, que são definidos na Portaria. Entre estes dois registros serão incluídos os dados de marcações, inclusões, alterações e ajustes feitos no REP.

importAnte: O DataTable terá sempre 11 colunas do tipo Texto, porém o preenchimento e tipo de dado contido em cada coluna será variável conforme o tipo de registro do AFD.

Manual layouts 21


6. ConFigurAção



Cabeçalho




Alteração

Este registro tem o objetivo de incluir ou alterar dados de um empregado no REP


1 alfanuméricoParâmetro de configuração, conforme tabela eParamsetConfig, contida no documento “Manual_aPI_Reptrilobit.pdf”.

2 alfanumérico novo valor do parâmetro de configuração.


6.1.2 exemplo

supondo as seguintes configurações:

Configuração noVo Valor

Máscara de rede 255.255.255.0

Data do início do horário de verão 18/11/2010

Data do fim do horário de verão 22/03/2011


3

MascaraRede;255.255.255.0

InicioHorarioVerao;20101118000000

FimHorarioVerao;20110322000000

Manual layouts 22








6.2.2 exemplo







MascaraRede;255.255.255.0

InicioHorarioVerao;20101118000000

FimHorarioVerao;20110322000000

Manual layouts 23


6.3 layout da liSta







6.3.2 exemplo






E que seja usado o separador de registro “|” (pipe) e o separador de campo “;” (ponto e vírgula), a lista será gerada da seguinte maneira:

MascaraRede;255.255.255.0|InicioHorarioVerao;20101118000000|FimHorarioVerao;20110322000000

Manual layouts 24







Manual layouts 25


7. mApeAmento mrp




1 numérico nsR

2 alfanuméricoData

Formato: AAAAMMDD

importAnte: o DataTable contém todas as transições de data dentro do intervalo de NSR informado.

centro tecnológicorua alvarenga 1592 butantã

05509-003 são paulo spwww.trilobit.com.br

www.trilobit.com.br

manual do sdk para rep...

Documents

Transcript of manual do sdk para rep...