Rateio


Endpoint de resultados de Rateio para Dashboard.

Opções de filtros

Por Empresa

Method URI Headers Authorization
POST /api/v3/dashboards/apportionment/company Content-Type:application/json Authorization: Bearer {token}

Attributes

id: (int, required) - "ID da empresa".
properties: (array, required) - "Dados de Rateio." ('total_value' ou 'equipments_value')
initial_date: (int, timestamp) - "Timestamp do início do período (Obrigatório se não enviar initial_date_syntax)."
final_date: (int, timestamp) - "Timestamp do final do período (Obrigatório se não enviado final_date_syntax)."
initial_date_syntax: (string) - "Sintaxe relativa de tempo para o início do período."
final_date_syntax: (string) - "Sintaxe relativa de tempo para o final do período."
final_date_syntax_number: (int) - "Quantidade de uma sintaxe relativa de tempo. Ex. 1"
order: (string) - "Tipo de ordenação, aplicada ao horário." ('asc' ou 'desc')
order_by: (string) - "Campo usado na ordenação. Padrão date" ('date','total_value' ou 'equipments_value')
limit: (int) - "Quantidade limite de registros"
aggregate: (string) - "Agregar os dados no período informado em (aggregation_interval e aggregation_interval_number) ou em 1 hora como default. Ex. max" 
aggregation_interval: (string) - "Intervalo para agregação dos dados. Ex. hours"
aggregation_interval_number: (int) - "Quantidade do intervalo de uma agregação. Ex. 1"
aggregation_timezone: (int) - "Timezone aplicado nos registros e na data inicial da requisição."
summarize_by: (string) - "Sumarização dos dados. Ex. sum"
group_by: (string) - "Agrupar por entidade. Ex. cost_center"


Response

{success} Response 200 (application/json)

{
    "series": [
        {
            "entity": "company",
            "entity_name": "Empresa 1",
            "property": "total_value",
            "data": [
                {
                    "timestamp": 1717210800,
                    "value": 168.08,
                    "origem": null
                },
                {
                    "timestamp": 1714532400,
                    "value": 523,
                    "origem": null
                }
            ]
        }
    ],
    "summary": [
        {
            "entity": "company",
            "entity_name": "Empresa 1",
            "property": "total_value",
            "data": {
                "timestamp": 1717210800,
                "value": 691.08,
                "origem": null
            }
        }
    ]
}


Response - Agrupado por Centro de Custo

{success} Response 200 (application/json)

{
    "series": [
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1",
            "property": "total_value",
            "data": []
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 2",
            "property": "total_value",
            "data": [
                {
                    "timestamp": 1714532400,
                    "value": 261.5,
                    "origem": null
                },
                {
                    "timestamp": 1717210800,
                    "value": 84.54,
                    "origem": null
                }
            ]
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 3",
            "property": "total_value",
            "data": [
                {
                    "timestamp": 1714532400,
                    "value": 261.5,
                    "origem": null
                },
                {
                    "timestamp": 1717210800,
                    "value": 83.54,
                    "origem": null
                }
            ]
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1 - Rateio 2",
            "property": "total_value",
            "data": []
        }
    ],
    "summary": [
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1",
            "property": "total_value",
            "data": {
                "timestamp": null,
                "value": null,
                "origem": null
            }
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 2",
            "property": "total_value",
            "data": {
                "timestamp": 1717210800,
                "value": 346.04,
                "origem": null
            }
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 3",
            "property": "total_value",
            "data": {
                "timestamp": 1717210800,
                "value": 345.04,
                "origem": null
            }
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1 - Rateio 2",
            "property": "total_value",
            "data": {
                "timestamp": null,
                "value": null,
                "origem": null
            }
        }
    ]
}

{warning} Response 422 (application/json)

{
    "initial_date": [
        "O campo data inicial é obrigatório quando initial date syntax não está presente."
    ],
    "initial_date_syntax": [
        "O campo initial date syntax é obrigatório quando data inicial não está presente."
    ]
}

{primary} Response 204 (application/json).

Quando os critérios de parâmetros não contiver registros a serem retornados.

Por Equipamento

Method URI Headers Authorization
POST /api/v3/dashboards/apportionment/equipment Content-Type:application/json Authorization: Bearer {token}

Attributes

id: (int, required) - "ID do equipamento".
properties: (array, required) - "Dados de Rateio." ('total_value')
initial_date: (int, timestamp) - "Timestamp do início do período (Obrigatório se não enviar initial_date_syntax)."
final_date: (int, timestamp) - "Timestamp do final do período (Obrigatório se não enviado final_date_syntax)."
initial_date_syntax: (string) - "Sintaxe relativa de tempo para o início do período."
final_date_syntax: (string) - "Sintaxe relativa de tempo para o final do período."
final_date_syntax_number: (int) - "Quantidade de uma sintaxe relativa de tempo. Ex. 1"
order: (string) - "Tipo de ordenação, aplicada ao horário." ('asc' ou 'desc')
order_by: (string) - "Campo usado na ordenação. Padrão date" ('date','total_value' ou 'equipments_value')
limit: (int) - "Quantidade limite de registros"
aggregate: (string) - "Agregar os dados no período informado em (aggregation_interval e aggregation_interval_number) ou em 1 hora como default. Ex. max" 
aggregation_interval: (string) - "Intervalo para agregação dos dados. Ex. hours"
aggregation_interval_number: (int) - "Quantidade do intervalo de uma agregação. Ex. 1"
aggregation_timezone: (int) - "Timezone aplicado nos registros e na data inicial da requisição."
summarize_by: (string) - "Sumarização dos dados. Ex. sum"
group_by: (string) - "Agrupar por entidade. Ex. cost_center"


Response

{success} Response 200 (application/json)

{
    "series": [
        {
            "entity": "equipment",
            "entity_name": "Equipamento 1",
            "property": "value",
            "data": [
                {
                    "timestamp": 1717210800,
                    "value": 33.54,
                    "origem": null
                },
                {
                    "timestamp": 1717210800,
                    "value": 33.54,
                    "origem": null
                },
                {
                    "timestamp": 1714532400,
                    "value": 211.5,
                    "origem": null
                },
                {
                    "timestamp": 1714532400,
                    "value": 211.5,
                    "origem": null
                }
            ]
        }
    ],
    "summary": [
        {
            "entity": "equipment",
            "entity_name": "Equipamento 1",
            "property": "value",
            "data": {
                "timestamp": 1717210800,
                "value": 490.08,
                "origem": null
            }
        }
    ]
}


Response - Agrupado por Centro de Custo

{success} Response 200 (application/json)

{
    "series": [
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1",
            "property": "total_value",
            "data": [
                {
                    "timestamp": 1714532400,
                    "value": 261.5,
                    "origem": null
                },
                {
                    "timestamp": 1717210800,
                    "value": 84.54,
                    "origem": null
                }
            ]
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 2",
            "property": "total_value",
            "data": [
                {
                    "timestamp": 1714532400,
                    "value": 261.5,
                    "origem": null
                },
                {
                    "timestamp": 1717210800,
                    "value": 83.54,
                    "origem": null
                }
            ]
        }
    ],
    "summary": [
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 1",
            "property": "total_value",
            "data": {
                "timestamp": 1717210800,
                "value": 346.04,
                "origem": null
            }
        },
        {
            "entity": "cost_center",
            "entity_name": "Centro de Custo 2",
            "property": "total_value",
            "data": {
                "timestamp": 1717210800,
                "value": 345.04,
                "origem": null
            }
        }
    ]
}

{warning} Response 422 (application/json)

{
    "initial_date": [
        "O campo data inicial é obrigatório quando initial date syntax não está presente."
    ],
    "initial_date_syntax": [
        "O campo initial date syntax é obrigatório quando data inicial não está presente."
    ]
}

{primary} Response 204 (application/json).

Quando os critérios de parâmetros não contiver registros a serem retornados.