PT EN

Resumo

URL base: $BUSINESS_API

O objecto

periodobject · opcional
currencystring · opcional
billed_centsinteger (int64) · opcional
collected_centsinteger (int64) · opcional
volume_m3number · opcional
readings_countinteger · opcional
collection_ratenumber · opcional

Percentage of the period's billed amount collected through payments applied to invoices billed in that period, capped at 100. Payments against earlier invoices are in arrears_collected_cents and do not raise this rate.

collected_current_period_centsinteger (int64) · opcional

Part of collected_cents applied to invoices billed in the period

arrears_collected_centsinteger (int64) · opcional

Part of collected_cents applied to invoices billed in earlier periods, or to no invoice

collections_by_hourobject · opcional

Collections for the utility's local today and yesterday, independent of the requested period

Mostrar atributos filhos
timezonestring · opcional
todayobject · opcional
Mostrar atributos filhos
datestring (date) · opcional
total_centsinteger (int64) · opcional
hoursarray of object · opcional

All 24 local hours in order

Mostrar atributos filhos
hourinteger · opcional
collected_centsinteger (int64) · opcional
paymentsinteger · opcional
yesterdayobject · opcional
Mostrar atributos filhos
datestring (date) · opcional
total_centsinteger (int64) · opcional
hoursarray of object · opcional

All 24 local hours in order

Mostrar atributos filhos
hourinteger · opcional
collected_centsinteger (int64) · opcional
paymentsinteger · opcional
read_ratenumber · opcional
open_workobject · opcional
Mostrar atributos filhos
incidentsinteger · opcional
ticketsinteger · opcional
work_ordersinteger · opcional
receivables_by_ageingarray of object · opcional
Mostrar atributos filhos
balance_centsinteger · opcional
bucketstring · opcional
invoicesinteger · opcional
seriesobject · opcional
Mostrar atributos filhos
billed_centsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
collected_centsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
volume_m3array of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
readingsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
Operações
O objecto
{
  "period": {},
  "currency": "MZN",
  "billed_cents": 1,
  "collected_cents": 1,
  "volume_m3": 13.42,
  "readings_count": 1342,
  "collection_rate": 1,
  "collected_current_period_cents": 1,
  "arrears_collected_cents": 1,
  "collections_by_hour": {
    "timezone": "Africa/Maputo",
    "today": {
      "date": "2026-11-19",
      "total_cents": 125000,
      "hours": [
        {
          "hour": 0,
          "collected_cents": 1,
          "payments": 1
        }
      ]
    },
    "yesterday": {
      "date": "2026-11-19",
      "total_cents": 125000,
      "hours": [
        {
          "hour": 0,
          "collected_cents": 1,
          "payments": 1
        }
      ]
    }
  },
  "read_rate": 1,
  "open_work": {
    "incidents": 1,
    "tickets": 1,
    "work_orders": 1
  },
  "receivables_by_ageing": [
    {
      "balance_cents": 125000,
      "bucket": "bucket",
      "invoices": 1
    }
  ],
  "series": {
    "billed_cents": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "collected_cents": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "volume_m3": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "readings": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ]
  }
}

Obter o resumo

Registos

GET /overview

Billed, collected, volume, readings, receivables ageing, collection and read rate, open work, series

Requires business:overview:read. Each returned data group is filtered by its own domain read scope; overview access alone does not grant access to billing, payment, reading, consumption, operations, or support totals.

Parâmetros

periodstring · consulta · opcional

Month as YYYY-MM; defaults to the current month

Devolve

200 Overview

Mostrar atributos
periodobject · opcional
currencystring · opcional
billed_centsinteger (int64) · opcional
collected_centsinteger (int64) · opcional
volume_m3number · opcional
readings_countinteger · opcional
collection_ratenumber · opcional

Percentage of the period's billed amount collected through payments applied to invoices billed in that period, capped at 100. Payments against earlier invoices are in arrears_collected_cents and do not raise this rate.

collected_current_period_centsinteger (int64) · opcional

Part of collected_cents applied to invoices billed in the period

arrears_collected_centsinteger (int64) · opcional

Part of collected_cents applied to invoices billed in earlier periods, or to no invoice

collections_by_hourobject · opcional

Collections for the utility's local today and yesterday, independent of the requested period

Mostrar atributos filhos
timezonestring · opcional
todayobject · opcional
Mostrar atributos filhos
datestring (date) · opcional
total_centsinteger (int64) · opcional
hoursarray of object · opcional

All 24 local hours in order

Mostrar atributos filhos
hourinteger · opcional
collected_centsinteger (int64) · opcional
paymentsinteger · opcional
yesterdayobject · opcional
Mostrar atributos filhos
datestring (date) · opcional
total_centsinteger (int64) · opcional
hoursarray of object · opcional

All 24 local hours in order

Mostrar atributos filhos
hourinteger · opcional
collected_centsinteger (int64) · opcional
paymentsinteger · opcional
read_ratenumber · opcional
open_workobject · opcional
Mostrar atributos filhos
incidentsinteger · opcional
ticketsinteger · opcional
work_ordersinteger · opcional
receivables_by_ageingarray of object · opcional
Mostrar atributos filhos
balance_centsinteger · opcional
bucketstring · opcional
invoicesinteger · opcional
seriesobject · opcional
Mostrar atributos filhos
billed_centsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
collected_centsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
volume_m3array of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional
readingsarray of SeriesPoint · opcional
Mostrar atributos filhos
datestring (date) · opcional
valuenumber · opcional

Permissões business:overview:read · Funções: admin, analyst, field_supervisor, finance, operations, owner, viewer

curl -X GET "$BUSINESS_API/overview" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200
{
  "period": {},
  "currency": "MZN",
  "billed_cents": 1,
  "collected_cents": 1,
  "volume_m3": 13.42,
  "readings_count": 1342,
  "collection_rate": 1,
  "collected_current_period_cents": 1,
  "arrears_collected_cents": 1,
  "collections_by_hour": {
    "timezone": "Africa/Maputo",
    "today": {
      "date": "2026-11-19",
      "total_cents": 125000,
      "hours": [
        {
          "hour": 0,
          "collected_cents": 1,
          "payments": 1
        }
      ]
    },
    "yesterday": {
      "date": "2026-11-19",
      "total_cents": 125000,
      "hours": [
        {
          "hour": 0,
          "collected_cents": 1,
          "payments": 1
        }
      ]
    }
  },
  "read_rate": 1,
  "open_work": {
    "incidents": 1,
    "tickets": 1,
    "work_orders": 1
  },
  "receivables_by_ageing": [
    {
      "balance_cents": 125000,
      "bucket": "bucket",
      "invoices": 1
    }
  ],
  "series": {
    "billed_cents": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "collected_cents": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "volume_m3": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ],
    "readings": [
      {
        "date": "2026-11-19",
        "value": 13.42
      }
    ]
  }
}