manual do sdk para rep trilobit layouts

Transcrição

1 May/2014

2 Versão Maio de 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 2

3 Sumário 1. Apresentação Empregador Layout do Arquivo Texto Tipos de Registro Empregados Layout do Arquivo Texto Com Cabeçalho Tipos de registro Layout do Arquivo Texto Sem Cabeçalho Definição de Campos Layout da Lista Definição de Campos Exemplo Layout Do DataTable Definição de Campos Biometrias Layout do Arquivo Texto Com Cabeçalho Tipos de registro Exemplo Layout do Arquivo Texto Sem Cabeçalho Definição de Campos Exemplo Layout da Lista Definição de Campos Exemplo Layout do DataTable Definição de Campos Layout do ByteArray Definição de Campos AFD Layout do Arquivo Texto Definição de Campos Layout da Lista Definição de Campos Layout do DataTable Definição de Campos Configuração Layout do Arquivo Texto Com Cabeçalho Tipos de registro Exemplo Layout do Arquivo Texto Sem Cabeçalho Definição de Campos...22 Manual Layouts 3

4 6.2.2 Exemplo Layout da Lista Definição de Campos Exemplo Layout Do DataTable Definição de Campos Mapeamento MRP Layout Do DataTable Definição de Campos...25 Manual Layouts 4

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 5

6 2. Empregador 2.1 Layout do Arquivo Texto Tipos de Registro Cabeçalho Este registro tem o objetivo de identificar o tipo do arquivo gerado. 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. Tipo de identificador do empregador. 2 Numérico 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) / 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; ;0;TRILOBIT;RUA ALVARENGA, 1377 Manual Layouts 6

7 3. Empregados 3.1 Layout do Arquivo Texto Com Cabeçalho Tipos de registro Cabeçalho Este registro tem o objetivo de identificar o tipo do arquivo gerado. 1 Numérico Tipo do arquivo. Valor fixo: 2 Inclusão ou Alteração Este registro tem o objetivo de incluir ou alterar dados de um empregado no REP 1 Numérico Tipo do registro. Valor fixo: 1. 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. Indica se o empregado deve ou não utilizar biometria. 5 Numérico Valores Possíveis: 0 = Não utiliza biometria 1 = Utiliza biometria IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;). Exclusão Este registro tem o objetivo de excluir dados de um empregado do REP. 1 Numérico Tipo do registro. Valor fixo: 2. 2 Numérico Número do PIS do empregado. IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;). Manual Layouts 7

8 Exemplo Para a seguinte lista de empregados: Nº PIS Nome Crachá Possui biometria LUCIANO NÃO LILIAN NÃO ADONIS NÃO VITOR NÃO ALEXANDRE 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; ;LUCIANO; ;0 1; ;LILIAN; ;0 2; ; ;VITOR; ;0 1; ;ALEXANDRE; ;0 Manual Layouts 8

9 3.2 Layout do Arquivo Texto Sem Cabeçalho Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Nome do empregado. 3 Alfanumérico Identificação do empregado. Pode ser o número do crachá ou a matrícula. Indica se o empregado deve ou não utilizar biometria. 4 Numérico Valores Possíveis: 0 = Não utiliza biometria 1 = Utiliza biometria IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;). Exemplo Para a seguinte lista de empregados: Nº PIS Nome Crachá Possui biometria LUCIANO NÃO LILIAN NÃO ADONIS NÃO VITOR NÃO ALEXANDRE NÃO O arquivo será gerado da seguinte maneira: ;LUCIANO; ; ;LILIAN; ; ;ADONIS; ; ;VITOR; ; ;ALEXANDRE; ;0 Manual Layouts 9

10 3.3 Layout da Lista Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Nome do empregado. 3 Alfanumérico Identificação do empregado. Pode ser o número do crachá ou a matrícula. Indica se o empregado deve ou não utilizar biometria. 4 Numérico Valores Possíveis: 0 = Não utiliza biometria 1 = Utiliza biometria IMPORTANTE: Os campos são separados pelo caracter separador de campo especificado. Os registros são separados pelo caracter separador de registro especificado Exemplo Supondo que os seguintes empregados estejam cadastrados no REP: Nº PIS Nome Crachá Possui biometria LUCIANO NÃO LILIAN NÃO ADONIS NÃO VITOR NÃO ALEXANDRE 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: ;LUCIANO; ; ;LILIAN; ; ;ADONIS; ; ;VITOR; ; ;ALEX ANDRE; ;0 Manual Layouts 10

11 3.4 Layout Do DataTable Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Nome do empregado. 3 Alfanumérico Identificação do empregado. Pode ser o número do crachá ou a matrícula. Indica se o empregado deve ou não utilizar biometria. 4 Numérico Valores Possíveis: 0 = Não utiliza biometria 1 = Utiliza biometria Manual Layouts 11

12 4. Biometrias 4.1 Layout do Arquivo Texto Com Cabeçalho Tipos de registro Cabeçalho Este registro tem o objetivo de identificar o tipo do arquivo gerado. 1 Numérico Tipo do arquivo. Valor fixo: 4 Inclusão Este registro tem o objetivo de incluir a biometria indicada de um empregado no REP 1 Numérico Tipo do registro. Valor fixo: 1. 2 Numérico Número do PIS do empregado. 3 Alfanumérico Biometria do empregado. O valor de cada um dos 512 bytes deve ser separado por vírgula (,). IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;). Exclusão Este registro tem o objetivo de excluir TODAS as biometrias de um empregado do REP. 1 Numérico Tipo do registro. Valor fixo: 2. 2 Numérico Número do PIS do empregado. IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;). Manual Layouts 12

13 4.1.2 Exemplo Para a seguinte lista de empregados: Nº PIS Biometria Informação biométrica do empregado Informação biométrica do empregado EXCLUIR TODAS Informação biométrica do empregado Informação biométrica do empregado. 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; ;69,48,39,39...,20 1; ;69,47,39,39...,238 2; ; ;69,42,39,39...,96 1; ;69,20,39,39...,151 Manual Layouts 13

14 4.2 Layout do Arquivo Texto Sem Cabeçalho Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Biometria do empregado. O valor de cada um dos 512 bytes deve ser separado por vírgula (,). IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;) Exemplo Para a seguinte lista de empregados: Nº PIS Biometria Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado. O arquivo será gerado da seguinte maneira: ;69,48,39,39..., ;69,47,39,39..., ;69,129,39,39..., ;69,42,39,39..., ;69,20,39,39...,151 Manual Layouts 14

15 4.3 Layout da Lista Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Biometria do empregado. IMPORTANTE: Os campos são separados pelo caracter separador de campo especificado. Os registros são separados pelo caracter separador de registro especificado. Os bytes da biometria são separados pelo caracter separador de bytes especificado Exemplo Supondo que os seguintes empregados estejam cadastrados no REP: Nº PIS Biometria Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado Informação biométrica do empregado. 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: ;69,48,39,39..., ;69,47,39,39..., ;69,129,39,39...., ;69,42,39,39..., ;69,20,39,3 9...,151 Manual Layouts 15

16 4.4 Layout do DataTable Definição de Campos 1 Numérico Número do PIS do empregado. 2 Alfanumérico Biometria do empregado. O valor de cada um dos 512 bytes é separado por vírgula (,). Manual Layouts 16

17 4.5 Layout do ByteArray Definição de Campos 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 17

18 5. AFD 5.1 Layout do Arquivo Texto Definição de Campos 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 Manual Layouts 18

19 5.2 Layout da Lista Definição de Campos 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 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: Os campos são separados pelo caracter separador de campo especificado. Os registros são separados pelo caracter separador de registro especificado. Manual Layouts 19

20 5.3 Layout do DataTable Definição de Campos 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 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 20

21 6. Configuração 6.1 Layout do Arquivo Texto Com Cabeçalho Tipos de registro Cabeçalho Este registro tem o objetivo de identificar o tipo do arquivo gerado. 1 Numérico Tipo do arquivo. Valor fixo: 3 Alteração Este registro tem o objetivo de incluir ou alterar dados de um empregado no REP 1 Alfanumérico Parâ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. IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;) Exemplo Supondo as seguintes configurações: Configuração Novo valor Máscara de rede 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 O arquivo deverá ser gerado da seguinte maneira: 3 MascaraRede; InicioHorarioVerao; FimHorarioVerao; Manual Layouts 21

22 6.2 Layout do Arquivo Texto Sem Cabeçalho Definição de Campos 1 Alfanumérico Parâ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. IMPORTANTE: Os campos devem estar separados por ponto e vírgula (;) Exemplo Supondo as seguintes configurações: Configuração Novo valor Máscara de rede 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 O arquivo deverá ser gerado da seguinte maneira: MascaraRede; InicioHorarioVerao; FimHorarioVerao; Manual Layouts 22

23 6.3 Layout da Lista Definição de Campos 1 Alfanumérico Parâ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. IMPORTANTE: Os campos são separados pelo caracter separador de campo especificado. Os registros são separados pelo caracter separador de registro especificado Exemplo Supondo as seguintes configurações: Configuração Novo valor Máscara de rede 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 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; InicioHorarioVerao; FimHorari overao; Manual Layouts 23

24 6.4 Layout Do DataTable Definição de Campos 1 Alfanumérico Parâ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. Manual Layouts 24

25 7. Mapeamento MRP 7.1 Layout Do DataTable Definição de Campos 1 Numérico NSR 2 Alfanumérico Data Formato: AAAAMMDD IMPORTANTE: o DataTable contém todas as transições de data dentro do intervalo de NSR informado. Manual Layouts 25

26 centro tecnológico rua alvarenga 1592 butantã são paulo sp