Layout de Campos e Fluxo das Informações

 

Os dados possuem o seguinte fluxo:

ID

Descrição

Origem

Destino

01

Dados de Funcionários

RM

PontoWeb

02

Dados de Afastamentos

RM

PontoWeb

03

Sindicatos

RM

PontoWeb

04

Eventos/Rubricas

RM

PontoWeb

05

Resultados Apurados

PontoWeb

RM



Layout de Campos 01 - Dados de Funcionários


Dados de Funcionários (Pessoas)

Item

Descrição

Fluxo:RM (Cliente) → PontoWeb
URL API:https://api.ahgora.com.br/people
Método:POST


Campos do PontoWeb que são integrados e sua origem no RM:

CampoTipoDescriçãoObrigatórioRegra
CampoDescrição / Regra
matriculaAlfaIdentificação do colaboradorXCampo chave
Enviar sempre a matrícula atual
Concatenar dados 
sem separador

PFUNC.CODICOLIGADA + PFUNC.CHAPAConcatenar Coligada + Chapa
Chapa do Funcionário.
Quando for chefe externo preencher o código do chefe externo.
Não pode haver matrícula repetida na mesma coligada.
matricula_anteriorstring
*X
  1. Sempre será enviada a matricula corrente no campo "matricula";
  2. Quando houver transferência entre CNPJ com troca de matricula, a nova matrícula deverá ser enviada no campo "matricula" e a antiga deverá ser enviada em um campo "matricula_anterior";
  3. Para novas alterações cadastrais dessa matrícula alterada, os envios seguintes não deverão conter o campo "matricula_anterior" preenchida, pode ser enviada em branco, ou não ser enviado;
  4. Não enviar datas de demissão e uma nova admissão para a nova matrícula;
  5. Concatenar dados sem separador.

PFUNC.CHAPAORIGEMPreencher com a chapa do registro demitido.
Este campo deve ser preenchido quando houver transferência do tipo "5" e o funcionário ativo tiver uma nova chapa.
nomeStringNome do FuncionárioX

Nome de Registrodo Colaborador ou Nome Social, quando for utilizado.

Para Nome Social é obrigatório tambem o envio dos 2 campos: "nome_registro" e  "checkbox_nome_social"


PPESSOA.NOMENome do Funcionário, ou nome do chefe externo.
É permitido acentuação e caracteres especiais.

nome_registro

StringNome de Registro*X

*Obrigatório para envios com Nome Social

Nome de Registro do Colaborador




checkbox_nome_social

BoleanoAtivar a flag de uso do nome Social*X

*Obrigatório para envios com Nome Social

Esperado:
"true" ou "false"




pisStringPIS do Funcionário*XCampo chave
*Quando não existir PIS, deve ser informado o campo “sem_pis” : “true“

PFUNC.PISPASEPNúmero do PIS do Funcionário.
Enviar somente números.
Quando não houver, deverá preencher o campo "
sem_pis" com "true".
sem_pisBoleano
*X*Obrigatório para envios sem PIS
Esperado:
"true" ou "false"

PFUNC.PISPASEPPreencher com "true" quando não tiver o PIS cadastrado e "false" quando tiver PIS cadastrado.
matricula_esocialStringMatrícula do E-Social
Obrigatório para múltiplos vínculos
PFUNC.MATRICULAESOCIALMatrícula do eSocial
codInternoString

Concatenar dados com separador
Separado por pipe

PFUNC.CHAPAChapa do Funcionário.
Enviar concatenado com separador pipe "|"
Concatenado 
Coligada + Chapa
Quando for chefe externo preencher o código do chefe externo.
Não pode haver matrícula repetida na mesma coligada.
dataAdmissaoDateData em que o Funcionário foi AdmitidoX(DD/MM/AAAA)
PFUNC.DATAADMISSAOData de Admissão. DD/MM/AAAA
Para o chefe externo deverá ser a data de início.
dataDemissaoDateData de Demissão*X(DD/MM/AAAA)
*Quando for demissão, obrigatório

PFUNC.DATADEMISSAOData de Demissão. DD/MM/AAAA
Transferência do tipo "5" não é considerado como demissão, mandar esse campo em branco para esse tipo.
Para o chefe externo deverá ser a data fim
localizacoesArrayLocalizações do funcionário
Manter campo aberto para que o cliente consiga enviar informação que mais se adequa
Exclusões não são efetuadas pela integração devido a regra do produto, podem ser efetuadas manualmente no PontoWeb.
Pode agregar ou substituir, depende da configuração aplicada no PontoWeb.

Consultar FAQ

Fórmula na tela do processo

Menu RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora | Aba Fórmula para Localizações.

Trata-se de um campo flexível, definido pelo usuário, que oferece maior liberdade e precisão na manipulação de dados e relatórios.
escala_padraoStringCódigo da escala/ turno do funcionário

Código da Escala existente no PontoWeb para atribuição.
Concatenar dados 
sem separador


Consultar FAQ



PFHSTHOR.CODHORARIO
Horário do Funcionário - Histórico Horário
Preencher com o último existente no histórico de horário.
Enviar concatenado 
Coligada + Código da escala
lastChangeDefaultScheduleDateData da alteração de escala/turno

Data da alteração relacionado ao campo "escala_padrao".


Consultar FAQ


PFHSTHOR.DTMUDANCA

Data da Mudança do Horário do Funcionário.
Preencher com o último existente no histórico de horário.

Verificar a necessidade de habilitar parâmetro para não enviar este campo vazio (Sanitizar)

ctpsStringCarteira de Trabalho


PPESSOA.CARTEIRATRAB
PPESSOA.SERIECARTTRAB
PPESSOA.UFCARTTRAB
Carteira de Trabalho
Concatenar os 3 campos (número, série e UF), separando os campos com barra "/". Exemplo: 9999/999/MG
cargoStringTítulo do Cargo
Padrão: dado enviado para eSocial (Cod + Descrição)
PHSTFCO.CODFUNCAOFunção do Funcionário - Histórico de Função
Preencher com o último existente no histórico de função.
Concatena o Código + Descrição, separando com traço "-". Exemplo: 001-ANALISTA DE SISTEMAS
dataCargoDateData de Alteração de Cargo


PHSTFCO.DTMUDANCAData da Mudança da Função do Funcionário.
Preencher com o último existente no histórico de função.
departamentoStringDescrição do departamento do Funcionário


PFUNC.CODSECAOSeção do funcionário
Concatenar o Código + Descrição, separando com traço "-". Exemplo: 01.01.03-DEPARTAMENTO PESSOAL
sexoStringGênero do Funcionário
"F"eminino, "M"asculino ou "O"utros
PPESSOA.SEXOSexo do Funcionário.
Preencher com F ou M.
emailStringE-mail do Funcionário
Único por funcionário
PPESSOA.EMAILEmail do funcionário.
Múltiplos vínculos ter um email por funcionário, não pode ser repetido.
cpfStringCPF do Funcionário*X*Obrigatório, se não for enviado PIS
juntamente com o campo “sem_pis” : “true“

PPESSOA.CPFCPF do Funcionário.
Preencher sem caracteres. Exemplo: 11122233344.
Para chefe externo busca também o CPF
rgStringRG do Funcionário
sem SSP e sem data emissão
PPESSOA.CARIDENTIDADECarteira de Identidade.
Preencher apenas com o RG, podendo ter caracteres.
Exemplo: M-7.7777
cnpjStringCNPJ da filial do Funcionário


PSECAO.CGC (JOIN) PFUNC.CODSECAOCNPJ da Seção do funcionário.
Preencher apenas com números, sem caracteres.
dataCnpjDateData da atribuição do CNPJ da empresa ao funcionário
(DD/MM/AAAA)
PFUNC.DTTRANSFERENCIAData da Transferência entre filiais ou coligada.
centroCustoStringCódigo do centro de custo do funcionário
Concatenar dados sem separador
PSECAO.NROCENCUSTOCONTConcatenar Coligada + Código do Centro de Custo da Seção do Funcionário
regimeTrabalhoStringRegime de Trabalho do Funcionário*X*Obrigatório quando possuir fluxo de Resultados
Uma das opções (descrição):
- CLT - estatutario
- estagiario - temporario
- rda - comissionado
- terceirizado - menoraprendiz
- intermitente - horista
- pensaovitalicia - folhaconfidencial
- autonomo - conselheiro
- pensaovitalicia

DE/PARA NO PARAMETRIZADOR DO RMBuscar a descrição do DE/PARA que será criado no parametrizador do RM, para PFUNC.CATEGORIAESOCIAL X TABELA AHGORA.
Preencher com a Descrição.
dataNascimentoStringData de Nascimento do Funcionário
(DD/MM/AAAA)
PPESSOA.DTNASCIMENTOData de nascimento. DD/MM/AAAA
carga_horariaStringDefinição de carga horária
Se definida, apenas escalas com a mesma quantidade de carga horária poderá ser aplicada para este funcionário
Quantidade de horas mensais

PFUNC.JORNADA_MENSALJornada Mensal do Funcionário.
Preencher com a quantidade de horas mensais. Exemplo: 220
bate_pontoObjetoPonto Obrigatório
Opções:
- "Ponto Obrigatorio" para quem deve registrar o ponto;
- "Ponto Livre" para quem não precisa registrar o ponto.

Orientações:
1. se enviar o campo "bate_ponto" e "data_troca_elegibilidade_ponto" (tem que enviar os dois) vai verificar:
2. se o valor da string "bate_ponto" for "Ponto Obrigatorio" (exatamente assim) e a data enviada em "data_troca_elegibilidade_ponto" for válida vai inserir no funcionário o histórico de ponto obrigatório "true" para data enviada em "data_troca_elegibilidade_ponto"
3. caso o valor da string "bate_ponto" for diferente e a data enviada em "data_troca_elegibilidade_ponto" for válida vai inserir no funcionário o histórico de ponto obrigatório "false" para data enviada em "data_troca_elegibilidade_ponto"

CAMPO NOVOEnviar "'true" ou "false".
data_troca_elegibilidade_pontoObjetoData de troca da elegibilidade do registro de ponto
Data relacionada ao dado do campo "bate_ponto"
CAMPO NOVOEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar o ponto.
matricula_chefiaStringMatrícula Chefia Imediata
Campo chave para Montagem da Hierarquia
PFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa do chefe do funcionário ou código do chefe externo.
nome_chefiaStringNome Chefia Imediata
Montagem da Hierarquia
PFUNC.NOMENome do chefe do Funcionário, ou nome do chefe externo.
É permitido acentuação e caracteres especiais.
email_chefiaStringe-mail Chefia Imediata
Montagem da Hierarquia
PPESSOA.EMAILEmail do chefe do funcionário ou email do chefe externo do funcionário.
codSindicatoPerson StringCódigo do Sindicato
Verificar o ID do campo
Concatenar dados sem separador
ID: 67195a38e36202ec150fcc50

PFUNC.CODSINDICATOCódigo do Sindicato do funcionário, igual cadastro na Folha RM
dataCodSindicatoDateData da alteração do código do sindicato
Este campo é relacionado a troca da informação do campo "codSindicato"
PFSINDIC.DTMUDANCAData da mudança do Sindicato do Funcionário.
telefoneStringTelefone


PPESSOA.TELEFONE2Número do Telefone Celular. Permite caracteres especiais.
custo_da_horaStringDefine o custo hora do funcionário, utilizado para cálculos financeiros.



Salário hora
financeiroObjeto
Indica os campos financeiros

Este campo está relacionados ao campos: salario, beneficios e vr

Isso é apenas uma estrutura de envio.
financeiro": {
"salario": "2.245,50",
"beneficios": {
"vr": "235,50"
salarioStringValor do salário do colaborador
(2.245,50 ou 2245,50)
Este campo é opcional e para clientes que utilizam o módulo financeiro


Caso o colaborar for mensalista, enviar o salário mensal
Caso o colaborar for horista, enviar o salário da hora


Exemplos de Requisições (Requests)


Corpo da Requisição:

[
    {
        "matricula": "0123456",
        "matricula_anterior": "1234567",
        "nome": "John Doe",
        "pis": "44799198333",
        "sem_pis": true,
        "matricula_esocial": "44799198333",
        "codInterno": "01|001|1234",
        "dataAdmissao": "2020-10-10",
        "dataDemissao": "2020-10-10",
        "localizacoes": [
            "TESTES 1",
            "TESTES 2"
        ],
        "escala_padrao": "006",
        "lastChangeDefaultSchedule": "2020-08-05",
        "ctps": "2413892",
        "cargo": "Human Resources Chief",
        "dataCargo": "2025-10-01",
        "departamento": "Human Resources",
        "sexo": "M",
        "email": "[email protected]",
        "cpf": "000.000.000-00",
        "rg": "012345",
        "cnpj": "48.603.081/0001-40",
        "dataCnpj": "2022-09",
        "centroCusto": "00000001",
        "regimeTrabalho": "CLT",
        "dataNascimento": "1990-10-25",
        "carga_horaria": "40",
        "bate_ponto": "Ponto Obrigatorio",
        "data_troca_elegibilidade_ponto": "2025-10-01",
        "matricula_chefia": "00001",
        "nome_chefia": "Nome Chefia",
        "email_chefia": "[email protected]",
        "codSindicato": "0001",
        "dataCodSindicato": "2025-10-01",
        "telefone": "999999999",
        "custo_da_hora": "12,00",
        "financeiro": {
            "salario": "2.245,50"
        }
    }
]


Exemplos de Retornos (Responses)


Resposta quando SUCESSO - Code 200:

{
    "company": "a133595",
    "message": "Employee's Integration on progress",
    "unique": "aabb1122",
    "subunique": "f9422c17"
}

Para obter mais detalhe, utilize o serviço Process. Para saber mais entre no link.


ERRO de Validação - Code 400:

{
  "message": "Request format must be an Array",
  "code": 400
}


ERRO de Autenticação - Code 401:

{
  "message": "Unauthorized",
  "code": 401
}


ERRO de Permissão - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Observação: Verificar as permissões do usuário para acessar a rota/serviço.



Layout de Campos 02 - Dados de Afastamentos


Dados de Afastamentos

Idem

Descrição

Fluxo:

RM (Cliente) → PontoWeb

URL API:

https://api.ahgora.com.br/absences

Tipo de Requisição:

POST


Campos do PontoWeb que são integrados e sua origem no RM:

PontoWeb


RM

Campo

Tipo

Descrição

Obrigatório

Regra


Campo

Descrição / Regra

matricula

String

Identificação do colaborador

X

Campo chave

Enviar sempre a matrícula atual

Concatenar dados sem separador


PFHSTAFT.CHAPA

PFUFERIASPER.CHAPA

Matrícula do Funcionário
Enviar concatenado 
Coligada + Chapa

motivo

String

Motivo do Afastamento

X

Enviar o Código ou String, é obrigatória uma das informações.
Cadastro prévio no PW exatamente iguais ao sistema de origem
Concatenar dados 
sem separador


PFHSTAFT.TIPO ou

F quando for férias

Tipo de Afastamento
Enviar concatenado 
Coligada + Código Afastamento

inicio

String

Data e/ou hora Inicial do Afastamento

X

YYYY-MM-DDTHH:MM (0000)

Somente afastamentos em dias


PFHSTAFT.DTINICIO

PFUFERIASPER.DATAINICIO

Data início do afastamento

Hora início: (00:00)

Hora Final: (24:00)

fim

String

Data e/ou hora Final do Afastamento

X

YYYY-MM-DDTHH:MM (Enviando hora final 2400 corresponde ao dia total)

Se data fim vazio, trocar para 31/12/2050


PFHSTAFT.DTFINAL

PFUFERIASPER.DATAFIM

Data fim do afastamento

Sem data fim, enviar vazio

cod_interno

String

Código interno do Afastamento

X

A manutenção da ausência depende do campo 'internalCode', caso o mesmo não seja informado não será possível alterar ou remover a ausência pela integração

Este código é armazenado para servir de chave para alterações no afastamento


CHAVE

Sequência Afastamento

Informar a chave única para identificar. Concatenar informações (empresa, filial, matrícula e Sequência).

operation

String

Ação a ser realizada

X

DEL para remoção da ausência (é possível remover enviando somente 2 campos: "cod_interno" e "operation"



Obrigatório o envio do DEL quando for exclusão de informação


Exemplos de Requisições (Requests)


Corpo da Requisição - Inclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "INS"
  }
]


Corpo da Requisição - Alteração:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "ALT",
    "ignora_bloqueio"= "1"
  }
]


Corpo da Requisição - Exclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "DEL"
  }
]



Exemplos de Retornos (Responses)


Resposta quando SUCESSO - Code 200:

{
  "company": "a000101",
  "message": "Absences's Integration on progress",
  "unique": "bd751350",
  "subunique": "dc8ab430"
}

Para obter mais detalhe, utilize o serviço Process. Para saber mais entre no link.


ERRO de Validação - Code 400:

{
  "message": "Request format must be an Array",
  "code": 400
}


ERRO de Autenticação - Code 401:

{
  "message": "Unauthorized",
  "code": 401
}


ERRO de Permissão - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Observação: Verificar as permissões do usuário para acessar a rota/serviço.



Layout de Campos 03 - Sindicatos


Sindicatos

Idem

Descrição

Fluxo:RM (Cliente) → PontoWeb
Tipo de Requisição:GET
Tipo de Autenticação:Basic
Usuário:Usuário criada para autenticar este serviço na Folha
Senha:Senha do usuário
Endereço:https://xxxxxxxxxxxxxxx:9999
Endpoint Base (fixo):api/rh/v1/ahgora/sindicatos


Campos do RM que são integrados e sua origem no PontoWeb:

PontoWeb


RM

Campo

Descrição

Regra


Campo

Obrigatório

Descrição / Regra

nameNomeNome do sindicato
descxNome do sindicato
codCódigoCódigo do sindicato
codxCódigo do sindicato
cnpjsCNPJCNPJ que está atrelado ao sindicato
cnpjxCNPJ que está atrelado ao sindicato


Exemplos de Requisições (Requests)


Corpo da Requisição Consulta na Folha - Sucesso:

{
    "items": [
        {
            "cod": "1",
            "cnpj": "53.113.791/0001-22",
            "desc": "SIND.TR.IND.MET.MEC.M.E.MARILI"
        },
        {
            "cod": "25",
            "cnpj": "95.432.225/0001-23",
            "desc": "SINDICATO DOS ESTATISTICOS"
        }
    ]   

Corpo da Requisição Consulta na Folha - Erro:

"errors": [
            {
                "mensagem": "CNPJ inexistente.",
                "cnpj": "05.510.667/0001-58"
            }
        ]


Exemplos de Retornos (Responses)


Resposta quando SUCESSO - Code 200:

"successes": [
            {
                "name": "SIND.TR.IND.MET.MEC.M.E.MARILI",
                "cod": "1",
                "company": "a962934",
                "cnpjs": [
                    "53.113.791/0001-22",
                    "95.432.225/0001-23"
                ]
            },  


ERRO de Autenticação - Code 401:

{
    "error": "Unauthorized",
    "code": 401,
    "msg": "Token usuario invalido"
}


ERRO na Formatação do Envio - Code 422:

{
    "code": 422,
    "error": true,
    "msg": "syndicates is not an array"
}



Layout de Campos 04 - Eventos/Rubricas


Eventos/Rubricas

Idem

Descrição

Fluxo:RM (Cliente) → PontoWeb
Tipo de Requisição:GET
Tipo de Autenticação:Basic
Usuário:Usuário criada para autenticar este serviço na Folha
Senha:Senha do usuário
Endereço:https://xxxxxxxxxxxxxxx:9999
Endpoint Base (fixo):api/rh/v1/ahgora/verbas


Campos do RM que são integrados e sua origem no PontoWeb:

PontoWeb


RM

Campo

Descrição

Regra


Campo

Obrigatório

Descrição / Regra

cnpjCNPJCNPJ que está atrelado a rubrica
cnpjxCNPJ que está atrelado a rubrica
hourNomeNome da rubrica
descxNome da rubrica
accountingCodeCódigoCódigo da rubrica
codxCódigo da rubrica
typeEventTipo - Valor esperado

Informa o tipo da rubrica e se o valor esperado é em valor ou horas

EX:
Vencimento - Hora
Desconto - Valor


categoria

Informa o tipo da rubrica e se o valor esperado é em valor ou horas

EX:
Vencimento - Hora
Desconto - Valor

internalCode


-



codigoRescisaoCódigoCódigo da rubrica de rescisão

-



offCycleCodeCódigoCódigo da rubrica de off cycle
-

deletefalsefixo "false"
-


Exemplos de Requisições (Requests)


Corpo da Requisição Consulta na Folha - Sucesso:

{
    "response": [
        {
            "items": [
                {
                    "categoria": "Vencimento - Valor",
                    "cod": "630",
                    "cnpj": "53.113.791/0001-22",
                    "desc": "Outros Ganhos"
                }
            ]
        }
    ]
}
   


Corpo da Requisição Consulta na Folha - Erro:

"errors": [
            {
                "mensagem": "CNPJ inexistente.",
                "cnpj": "05.510.667/0001-58"
            }
        ]


Exemplos de Retornos (Responses)


Resposta quando SUCESSO - Code 200:

{
    "code": 200,
    "error": false,
    "message": "Códigos contábeis importados com sucesso"
}


ERRO de Autenticação - Code 401:

{
    "error": "Unauthorized",
    "code": 401,
    "msg": "Token usuario invalido"
}


ERRO na Formatação do Envio - Code 422:

{
    "code": 422,
    "error": true,
    "message": "Erro ao importar códigos contábeis",
    "data": {
        "erros": [
            {
                "cnpj": "5",
                "error": "CNPJ não encontrado"
            },
            {
                "cnpj": null,
                "error": "CNPJ não encontrado"
            }
        ],
        "codigos importados": []
    }
}

Layout de Campos 05 - Resultados Apurados


Resultados Apurados

Idem

Descrição

Fluxo:PontoWeb → RM (Cliente)
Tipo de Requisição:POST
Tipo de Autenticação:Basic
Usuário:Usuário criada para autenticar este serviço na Folha
Senha:Senha do usuário
Endereço:https://xxxxxxxxxxxxxxx:9999
Endpoint Base (fixo):api/rh/v1/ahgora/results



Campos do RM que são integrados e sua origem no PontoWeb:

PontoWeb


RM

Campo

Descrição

Regra


Tabela

Campo

Obrigatório

Descrição / Regra

matricula

Identificação do colaborador

Pode ser alfanumérica
Campo matrícula


PFMOVTEMP

CHAPA

x

Matrícula do Funcionário
Recebe concatenado Coligada + Chapa (matrícula)

anocom

Ano da competência

Padrão AAAA


PFMOVTEMP

ANOCOMP

x

Concatenar AnoMes (AAAAMM)

mescom

Mês da competência

Padrão MM
Ex. Janeiro enviar 01


PFMOVTEMP

MESCOMP

x

Ex. jan 01

campoAdicional


Pode ser informado o Período / Envelope na tela do integrador "Campo Adicional"

Informação do campo adicional no PW
Não é obrigatório
Quando não tiver dados deve ser enviado vazio? ou não enviar?


-

-


Número do Pagamento

rubrica

Código do Evento / Rubrica

Cadastrado no PW utilizando sindicado ou configuração de parâmetro de cod por CNPJ


PFMOVTEMP

CODEVENTO

x

Código da Verba

Enviar concatenado Coligada + Código Rubrica

referencia

Referência em horas ou dias

Configurar no fluxo o parâmetro para envio das horas em Sexagesimal.
Horas sexagesimal (separador ",")
Ex: 1h30min, enviar 1,30
Dias em número inteiro
Ex: 3 dias, enviar 3


PFMOVTEMP

PFMOVTEMP

HORA

REF

x

Horas sexagesimal (separador ",")
Ex: 1h30min, enviar 1,30
Dias em número inteiro
Ex: 3 dias, enviar 3

datafalta

Somente para envio de evento de falta, enviar as datas sequenciais, data dia-a-dia

Envio de altas dia-a-dia formato (AAAAMMDD)


-

-


Envio de evento de falta, envio da data em período sequencial deve ser enviada a data dia-a-dia

codfuncionario

Código Interno do cadastro de funcionários

Dados exatamente como está cadastrado no funcionário




x

Matrícula do Funcionário
Enviar concatenado com separador pipe "|"
Coligada + Chapa (matrícula)


Exemplos de Requisições (Requests)


Corpo da Requisição:

{
    "items": [
        {
            "matricula": "0101000001",
            "anocom": "2024",
            "mescom": "07",
            "campoAdicional": "1",
            "codfuncionario": "01|01|000001",
            "resultados": [
                {
                    "rubrica": "001",
                    "referencia": "10,45",
                    "datafalta": ""
                },
                {
                    "rubrica": "002",
                    "referencia": "1",
                    "datafalta": "20240722"
                },
                {
                    "rubrica": "002",
                    "referencia": "1",
                    "datafalta": "20240723"
                }
            ]
        }
    ]
}


Exemplos de Retornos (Responses)


Resposta quando SUCESSO - Code 200:

{
    "response": [
        {
            "resultados": [
                {
                    "matricula": "0101000001",
                    "rubrica": "001",
                    "status": "S",
                    "mensagem": "Operação realizada com sucesso!",
                    "referencia": "10,45",
                    "datafalta": ""
                },
                {
                    "matricula": "0101000001",
                    "rubrica": "002",
                    "status": "S",
                    "mensagem": "Operação realizada com sucesso!",
                    "referencia": "1",
                    "datafalta": "20240722"
                },
                {
                    "matricula": "0101000001",
                    "rubrica": "002",
                    "status": "S",
                    "mensagem": "Operação realizada com sucesso!",
                    "referencia": "1",
                    "datafalta": "20240723"
                }
            ]
        }
    ]
}


ERRO de Negócio - Code 200:

{
    "response": [
        {
            "resultados": [
                {
                    "matricula": "0101000001",
                    "rubrica": "001",
                    "status": "E",
                    "mensagem": "Verba não encontrada na base de dados.",
                    "referencia": "10,45",
                    "datafalta": ""
                },
                {
                    "matricula": "0101000001",
                    "rubrica": "002",
                    "status": "E",
                    "mensagem": "Verba não encontrada na base de dados.",
                    "referencia": "1",
                    "datafalta": "20240722"
                },
                {
                    "matricula": "0101000001",
                    "rubrica": "002",
                    "status": "E",
                    "mensagem": "Verba não encontrada na base de dados.",
                    "referencia": "1",
                    "datafalta": "20240723"
                }
            ]
        }
    ]
}


ERRO Outros

{
    "code": "FE006",
    "message": "Falha ao abrir uma conexão socket com Licence Server no endereço BH-ENG-licenseserver.bh01.local:5555. Verificar se a rede está conectada e/ou o Licence Server está ativo.",
    "detailedMessage": " em TOTVS.Licence.LSCloud.LSCloudClientSocket.JDBIEFJDGLPICBBAHNBGLAMEELCOMLELLFNE()\r\n em TOTVS.Licence.LSCloud.LSCloudClientSocket.LSGetLicense(LSRequest json)\r\n em RM.Lib.Server.RMSLicenseServerCloud.GDKBNFBJILOKFAAHBBGGEBEONJCMNLMBMHFF(String , Int32 , Int32 , Int32 , Int32 , Int32 , String , String , RMSHardwareInfo , Boolean )\r\n em RM.Lib.Server.RMSLicenseServerCloud.GetLicense(String clientIP, Int32 clientPort, Int32 MDIThreadId, Int32 threadId, Int32 slotId, Int32 coligada, String usuario, String actionName, RMSHardwareInfo workstationInfo, Boolean userIsFullDeterminado)\r\n em RM.Lib.LicenceServer.RMSLicenseClientCloudWeb.GDKBNFBJILOKFAAHBBGGEBEONJCMNLMBMHFF(Int32 , String , Int32 , String , Int32 , Nullable`1 )\r\n em RM.Lib.LicenceServer.RMSLicenseClientCloudWeb.GetLicense(Int32 coligada, String usuario, Int32 slotId, String actionName)\r\n em RM.Lib.RMSLicence.GetLicence(Int32 coligada, String usuario, Int32 slotId, String actionName)\r\n em RM.Lib.Server.LicenseServer.RMSLicenseServerInspector.GetLicense(Int32 coligada, String usuario, Int32 slot, String actionName)\r\n em RM.Lib.RMSLicenseConsumeRule.ConsumeOrIgnoreLicense(RMSConsumeOrIgnoreLicenseArgs args)\r\n em RM.Lib.Server.LicenseServer.RMSLicenseServerInspector.AfterReceiveRequest(Message& request, IClientChannel channel, InstanceContext instanceContext)\r\n em System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.AfterReceiveRequestCore(MessageRpc& rpc)\r\n em System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage2(MessageRpc& rpc)\r\n em System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage11(MessageRpc& rpc)\r\n em System.ServiceModel.Dispatcher.MessageRpc.Process(Boolean isOperationContextSet)",
    "helpUrl": null,
    "details": [
        {
            "code": "FE006",
            "message": "Este host não é conhecido",
            "detailedMessage": " em System.Net.Dns.GetAddrInfo(String name)\r\n em System.Net.Dns.InternalGetHostByName(String hostName, Boolean includeIPv6)\r\n em System.Net.Dns.GetHostAddresses(String hostNameOrAddress)\r\n em System.Net.Sockets.TcpClient.Connect(String hostname, Int32 port)\r\n em TOTVS.Licence.LSCloud.LSCloudClientSocket.JDBIEFJDGLPICBBAHNBGLAMEELCOMLELLFNE()",
            "helpUrl": null,
            "details": []
        }
    ]
}