INTEGRAÇÃO Ahgora PontoWeb X DataSul (Nativa)

Contexto de negócio (Introdução)

O Produto PontoWeb destina-se a realizar a apuração do ponto dos funcionários durante o período apuração. Ao final, temos o resultado para lançar na folha de pagamento.

Para facilitar as rotinhas diárias, ganhar tempo e reduzir riscos operacionais, o PontoWeb e o DataSul pode ser integrados de forma nativa. 

Os dados como cadastro de funcionários, afastamentos, códigos contábeis e sindicatos são enviados ao PontoWeb, para que não seja necessário realizar o cadastro novamente. Já os Resultados Apurados no período de apuração, são integrados/lançados diretamente na Folha de Pagamento.

Com estas integrações ativas, outras funcionalidades ocorrem como: 

• Aplicar escala padrão para a apuração
• Aplicar sindicato para aplicação de regras de apuração
• Uso de hierarquia por líder imediato
• Afastamento por diversos motivos

Sistemas Envolvidos

• DataSul - Folha de Pagamento
• Ahgora PontoWeb - Gestão e apuração de registros de marcação de ponto.

Fluxo das Informações

Os dados possuem o seguinte fluxo:

Layout de Campos 01 - Dados de Funcionários

Dados de Funcionários (Pessoas)

Item

Descrição

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

Exemplos (Json)

[
    {
        "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": "john.doe@abcd.com",
        "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_chefia@mail.com.br",
        "codSindicato": "0001",
        "dataCodSindicato": "2025-10-01",
        "telefone": "999999999",
        "custo_da_hora": "12,00",
        "financeiro": {
            "salario": "2.245,50"
        }
    }
]

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

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

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

Layout de Campos 02 - Dados de Afastamentos

Dados de Afastamentos

Idem

Descrição

Fluxo:

DataSul (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 DataSul:

PontoWeb

DataSul

Campo

Tipo

Descrição

Obrigatório

Regra

Campo

Descrição / Regra

Exemplos (Json)

Request (Chamadas de Solicitação)

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

Deleção

Completo

Simplificado

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

[
    {
        "cod_interno": "w289fdf2",
        "operation": "DEL"
    }
]

Response (Retornos)

Solicitação Bem Sucedida - Code 200

{
    "company": "a133595",
    "message": "Absences Integration on progress",
    "unique": "aabb1122",
    "subunique": "f9422c17"
}

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
}

Layout de Campos 03 - Sindicatos - (EM DESENVOLVIMENTO)

Sindicatos

Idem

Descrição

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

Layout de Campos 04 - Eventos/Rubricas - (EM DESENVOLVIMENTO)

Eventos/Rubricas

Idem

Descrição

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

Layout de Campos 05 - Resultados Apurados

Resultados Apurados

Idem

Descrição

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

PontoWeb

DataSul

Campo

Descrição

Regra

Tabela

Campo

Obrigatório

Descrição / Regra

Código Interno do cadastro de funcionários

x

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

Exemplos (Json)

{
    "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"
                }
            ]
        }
    ]
}

{
    "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"
                }
            ]
        }
    ]
}

Processos

Situações comuns (opcional)

Checklist de suporte da aplicação