Páginas filhas
  • 7. Documentação de XML de exceção -HCM X SURICATO

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Exemplo de XML de Exceção:

Image Added


Dados utilizados da API

Por ser uma estrutura única para todos os produtos, há dados que existem em um produto (RM e/ou Protheus) e não existe no Datasul, desta forma cada produto utilizará os campos pertinentes aos seus ambientes.

CAMPOS DATASUL

PROPRIEDADES

...

DESCRIÇÃO

...

Informação referente a Matrícula do Funcionário no Produto TOTVS Datasul

...

Chave única do Beneficiário, concatenação dos campos de  chave única existente na tabela "Beneficiário" (prestdor_contrat_benefic.cdn_empresa | prestdor_contrat_benefic.cdn_estab | prestdor_contrat_benefic.cdn_funcionario)

...

BenefitsVendorCode

...

Informação referente ao Código do Prestador de Serviço do benefício do Funcionário no Produto TOTVS Datasul

...

BenefitVendorInternalId

...

Identificador Interno do Fornecedor de Benefícios

...

BenefitVendorSegmentCode

...

Código do tipo de segmento do fornecedor do Benefício: 1 - Assistência Médica | 2 - Assistência Odontológica

...

BenefitCode

...

Código do Benefício informado no TOTVS Datasul

...

BenefitInternalId

...

Identificador Interno do Benefício

...

BeginDate

...

Data de início do benefício ao Funcionário, no formato DataTime

...

FinalDate

...

Data de fim do benefício ao Funcionário, no formato DataTime

...

ContractNumberCode

...

Código do Contrato referente ao benefício relacionado ao Funcionário

...

ContractNumberInternalId

...

Identificador interno do Contrato

...

EmployeeCode

...

Código do Funcionário relacionado ao benefício

...

EmployeeInternalId

...

Identificador interno do Funcionário

...

RegistryType

...

Código do Dependente dentro do Datasul HCM. Quando for o títular (funcionário), o código será 0 (zero)

...

DegreeOfRelatedness

...

Grau de parentesco do dependente com o Titular: 1 - Filho | 2 - Conjugue | 3 - Pais | 4 - Companheiro | 5 - Dependente Econômico | 6 - Consignado | 7 - Outros 

...

Name

...

Nome do Dependente do Funcionário no FP1760. Se for o títular (funcionário) será buscado o nome da Pessoa Física no FP1440

...

BenefitCPF

...

CPF do Dependente no FP1760. Se for o títular (funcionário) será buscado o CPF da Pessoa Física no FP1440

...

MotherName

...

Nome da mãe do Dependente no FP1760. Se for o títular (funcionário) será buscado o Nome da Mãe da Pessoa Física no FP1440

...

Gender

...

Gênero (sexo) do Dependente no FP1760. Se for o títular (funcionário) será buscado o Sexo da Pessoa Física no FP1440

...

MaritalState

...

Estado Civil do Dependente no FP1760. Se for o títular (funcionário) será buscado o Estado Civil da Pessoa Física no FP1440. As opções são: 1 - Solteiro | 2 - Casado | 3 - Divorciado | 4 - Viúvo 

...

Birth

...

Data de Nascimento do Dependente do Funcionário no FP1760. Se for o títular (funcionário) será buscado o Data de Nascimento da Pessoa Física no FP1440

...

IdentityNumber

...

Carteira de Identidade no FP1440, quando títular (funcionário)

...

IdentityNumberEmitterAgency

...

Orgão Emissor no FP1440, quando títular (funcionário)

...

MedicalAssistanceCard

...

Número da Carteira de Saúde do Dependente no FP0520

...

DentalAssistanceCardCode

...

Número do Cartão de Assistência Odontológica no FP0520

...

FoodCardsCode

...

Número do Cartão para Alimentação

...

MealCardsCode

...

Número do Cartão para Refeição

...

SUSCardCode

...

Número do Cartão SUS do títular (funcionário)

...

BornAlive

...

Para o Datasul será um valor fixo (1), pois não se cadastra um dependente quando ele não Nasce Vivo

...

BeneficiaryWeight

...

Peso no FP1440

DO XML

DESCRIÇÃO

Valor Fixo - 2 direction

Opções: 

  • 0 entra
  • 1 sai
  • 2 ambos 

autoriz_hora_extra_compens.dat_inic_mpe


endDate

Informação referente a data e hora final.

Formato:

  • Ano com 4 dígitos 
  • - (Fixo)
  • Mês com 2 dígitos 
  • - (Fixo)
  • Dia com 2 dígitos
  • T23:59:59 (Fixo)

Exemplo:"2021-05-14T23:59:59"

Estes campos são gravados na também na movto_integr_tsa_chave.cod_chave_tsa - Data do Campo "Cod Chave TSA" do FP8870. A data corresponde a quarta posição do campo movto_integr_tsa_chave.cod_chave_tsa.

Exemplo: 3;302;100;2021-05-14;20:00;1

autoriz_hora_extra_compens.num_horar_term_mpeendTime

Corresponde à hora de fim da autorização de hora extra/compensação.

Formato:

  • Ano com 4 dígitos 
  • - (Fixo)
  • Mês com 2 dígitos 
  • - (Fixo)
  • Dia com 2 dígitos
  • T (Fixo)
  • Hora com 2 dígitos
  • : (Fixo)
  • Minutos com 2 dígitos
  • :00 (Fixo)

Exemplo:"2021-05-14T22:00:00"

autoriz_hora_extra_compens.num_horar_inic_mpe

initialTime

Corresponde à hora de início da autorização de hora extra/compensação.

Formato:

  • Ano com 4 dígitos 
  • - (Fixo)
  • Mês com 2 dígitos 
  • - (Fixo)
  • Dia com 2 dígitos
  • T (Fixo)
  • Hora com 2 dígitos
  • : (Fixo)
  • Minutos com 2 dígitos
  • :00 (Fixo)

Exemplo:"2021-05-14T18:00:00"

Valor Fixo - 0 pairTypeEste campo recebe o valor fixo 0 (zero).
tip_dia_horar_turno_trab.idi_sit_dia_trab 

exceptionType

Se tip_dia_horar_turno_trab.idi_sit_dia_trab for igual a 1 - "Dia Trabalhado", então ExceptionType será igual a "0 - permissão"

Senão, ExceptionType será igual a "1 - restrição".

movto_integr_tsa_chave.cod_chave_tsa - Data do Campo "Cod Chave TSA" do FP8870.

externalKey

Campo completo referente ao código da Chave do TSA do FP8870.

Exemplo: 3;302;100;2021-05-14;20:00;1

Formato:

  • Empresa - autoriz_hora_extra_compens.cdn_empresa
  • ; (fixo) 
  • Estabelecimento - autoriz_hora_extra_compens.cdn_estab
  • ; (fixo)
  • Matrícula do funcionário - autoriz_hora_extra_compens.cdn_funcionario
  • ; (fixo)
  • Data inicial - autoriz_hora_extra_compens.dat_inic_mpe 
  • ; (fixo)
  • hora de início da autorização de hora extra/ compensação - autoriz_hora_extra_compens.num_horar_inic_mpe
  • Origem - 

    1 - Autorização - Irá se tratar de autorização quando existir registro na tabela autoriz_hora_extra_compens.

    6 - Iteração calendário - Irá se tratar de autorização quando existir registro na tabela det_calend_func.

    7 - Alteração de Jornada - Irá se tratar de autorização quando existir registro na tabela alter_jorn_trab.

autoriz_hora_extra_compens.dat_inic_mpe



initialDate

Informação referente a data e hora inicial.

Formato:

  • Ano com 4 dígitos 
  • - (Fixo)
  • Mês com 2 dígitos 
  • - (Fixo)
  • Dia com 2 dígitos
  • T00:00:00 (Fixo)

Exemplo:"2021-05-14T00:00:00"

Estes campos são gravados na também na movto_integr_tsa_chave.cod_chave_tsa - Data do Campo "Cod Chave TSA" do FP8870. A data corresponde a quarta posição do campo movto_integr_tsa_chave.cod_chave_tsa.

Exemplo: 3;302;100;2021-05-14;20:00;1


movto_integr_tsa_chave.cod_chave_tsa - Data do Campo "Cod Chave TSA" do FP8870.


origin

Informação referente a origem. A origem corresponde a última posição do campo movto_integr_tsa_chave.cod_chave_tsa.

Exemplo:  3;302;100;2021-05-14;20:00;1

Opções: 

1 - Autorização - Irá se tratar de autorização quando existir registro na tabela autoriz_hora_extra_compens.

6 - Iteração calendário - Irá se tratar de autorização quando existir registro na tabela det_calend_func.

7 - Alteração de Jornada - Irá se tratar de autorização quando existir registro na tabela alter_jorn_trab.


autoriz_hora_extra_compens.cdn_empresa
autoriz_hora_extra_compens.cdn_estab
autoriz_hora_extra_compens.cdn_funcionario

userExternalKey

Informação referente ao código de usuário externo.

Formato:

  • Empresa
  • ; (fixo)
  • Estabelecimento
  • ; (fixo)
  • Matrícula do funcionário

Exemplo: 3;302;100

Estes campos são gravados na também na movto_integr_tsa_chave.cod_chave_tsa - Data do Campo "Cod Chave TSA" do FP8870. 

O código de usuário externo corresponde as três primeiras posições do campo movto_integr_tsa_chave.cod_chave_tsa. Exemplo:  3;302;100;2021-05-14;20:00;1

...

BeneficiaryTall

...