Skip to main content

Apontamentos totalizados

Descrição​

Retorna a hora/custo totalizado dos apontamentos. Agrupados por dia, mês e total geral.

Exemplo:

[
    {
        "LAAA": [
            {
                "Dia": [
                    {
                        "tresource_name": "LAAA",
                        "ano": "2024",
                        "mes": "1",
                        "dia": "1",
                        "tnote_elapsed_hours": "1,0000",
                        "total_note_cost": "1,00"
                    }
                ],
                "Mês": [
                    {
                        "tresource_name": "LAAA",
                        "ano": "2024",
                        "mes": "1",
                        "tnote_elapsed_hours": "1,0000",
                        "total_note_cost": "1,00"
                    }
                ],
                "Total": [
                    {
                        "tresource_name": "LAAA",
                        "tnote_elapsed_hours": "1,0000",
                        "total_note_cost": "1,00"
                    }
                ]
            }
        ]
    }
]

URL​

/api/v1/companyKey=:companyKey/integrationKey=:integrationKey/apontamento/totalizado[?:params]

Parâmetros possíveis​

ParâmetroDescriçãoExemploObrigatório?
start_timeDefine a data/hora inicial dos dados no formato ISO 8601 (UTC). Deve acompanhar o parâmetro end_timestart_time=2024-03-01T08:00:00ZSim
end_timeDefine a data/hora final dos dados no formato ISO 8601 (UTC). Deve acompanhar o parâmetro start_timeend_time=2024-03-01T09:00:00ZSim
recursoFiltra apenas os resultados onde o nome do leitor for igual ao valor informado. Pode informar um ou mais recursos. Deve-se separar várias tags usando-se vírgularecurso=LAAA,LAABNão

Modificadores de data/hora​

Você pode substituir os parâmetros start_time/end_time por um modificador de data/hora (clique aqui para saber mais). Caso ambos estejam presentes, o primeiro par tem preferência.

Exemplo de consulta​

// buscando os apontamentos entre 08h00 e 09h00 (UTC) do dia 03/01/2024
/apontamento/totalizado?start_time=2024-03-01T08:00:00Z&end_time=2024-03-01T09:00:00Z

// Filtrando os resultados da consulta anterior para somente um recurso
/apontamento/totalizado?start_time=2024-03-01T08:00:00Z&end_time=2024-03-01T09:00:00Z&recurso=LAAA

// Filtrando os resultados da consulta anterior para somente dois recursos
/apontamento/totalizado?start_time=2024-03-01T08:00:00Z&end_time=2024-03-01T09:00:00Z&recurso=LAAA,LAAB

// Usando um modificador de data/hora para consultar a última hora
/apontamento/totalizado?lasthour&recurso=LAAA,LAAB