Registar uma leitura estimada
RegistosPOST /reading-estimates
Estimates remain marked as estimates and require the same validation and acceptance process as observations.
Corpo application/json
meter_idassignment_idOptional in-progress assignment that authorizes this field reading and supplies route/cycle provenance.
valueunitmeasured_atclient_reading_ididempotency_keyevidence_idsestimate_reason
Devolve
202 Estimated reading submitted for validation or review
Mostrar atributos
meter_serialThe meter's serial number; present on consumer reading listings
connection_idconnection_holder_nameDisplay name of the customer who holds the referenced connection. Omitted when unknown.
previous_valueraw_consumptionAdvance since previous_value in the meter unit; a plausible decrease is treated as a rollover.
raw_consumption_microlitreshas_rolloversourceum de
mobile_reader,customer_self_reading,ami_interval,office_estimateplausibility_statusum de
passed,flagged_high,flagged_negative,flagged_zero,verified_manualphoto_evidenceis_billedidtenant_idmeter_idmeter_holder_nameDisplay name of the customer who holds the account the meter is installed on. Omitted when unknown.
account_idaccount_numberNumber of the referenced account, e.g. CTA-000044. Omitted when unknown.
account_holder_nameDisplay name of the customer who holds the referenced account. Omitted when unknown.
route_idcycle_idassignment_idvalueunitmeasured_atreceived_atmethodum de
manual,consumer,remote,imported,estimatedsubmitted_bysource_idexternal_idclient_reading_ididempotency_keystatusum de
submitted,validating,accepted,review_required,rejected,supersededevidence_idsestimate_reasonreview_reasonreview_reason_codeStable code of the plausibility check that sent the reading to review (reading_review.below_reset_baseline, reading_review.earlier_than_latest, reading_review.earlier_or_lower, reading_review.zero_with_recent_usage, reading_review.above_three_month_average); clients word it and fall back to review_reason.
rejection_reasonreviewed_byreviewed_atsupersedes_idsuperseded_by_idcorrection_reasoncreated_at
Permissões business:readings:estimate · Funções: admin, operations, owner
curl -X POST "$BUSINESS_API/reading-estimates" \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"assignment_id": "ass_2bVAYnXSmDHuMvxsMpR2Q93SOVR",
"value": "value",
"unit": "unit",
"measured_at": "2026-11-19T09:30:00Z",
"client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
"idempotency_key": "idempotency key",
"evidence_ids": [
"evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
],
"estimate_reason": "estimate reason"
}'
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/reading-estimates", {
method: "POST",
headers: {
Authorization: "Bearer sk_test_...",
"Content-Type": "application/json"
},
body: JSON.stringify({
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"assignment_id": "ass_2bVAYnXSmDHuMvxsMpR2Q93SOVR",
"value": "value",
"unit": "unit",
"measured_at": "2026-11-19T09:30:00Z",
"client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
"idempotency_key": "idempotency key",
"evidence_ids": [
"evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
],
"estimate_reason": "estimate reason"
})
});
const data = await res.json();
import requests
res = requests.post(
"$BUSINESS_API/reading-estimates",
headers={
"Authorization": "Bearer sk_test_..."
},
json={
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"assignment_id": "ass_2bVAYnXSmDHuMvxsMpR2Q93SOVR",
"value": "value",
"unit": "unit",
"measured_at": "2026-11-19T09:30:00Z",
"client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
"idempotency_key": "idempotency key",
"evidence_ids": [
"evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
],
"estimate_reason": "estimate reason"
}
)
data = res.json()
body := strings.NewReader(`{
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"assignment_id": "ass_2bVAYnXSmDHuMvxsMpR2Q93SOVR",
"value": "value",
"unit": "unit",
"measured_at": "2026-11-19T09:30:00Z",
"client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
"idempotency_key": "idempotency key",
"evidence_ids": [
"evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
],
"estimate_reason": "estimate reason"
}`)
req, _ := http.NewRequest("POST", "$BUSINESS_API/reading-estimates", body)
req.Header.Set("Authorization", "Bearer sk_test_...")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"meter_serial": "meter serial",
"connection_id": "con_2wuJTWy9FOCTPGA3noGbHegbLaU",
"connection_holder_name": "Ana Matsinhe",
"previous_value": "previous value",
"raw_consumption": "raw consumption",
"raw_consumption_microlitres": 1342,
"has_rollover": true,
"source": "mobile_reader",
"plausibility_status": "passed",
"photo_evidence": "photo evidence",
"is_billed": true,
"id": "rdg_2o0xXwujnSgR9QIvVEWblWSv7u0",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"meter_holder_name": "Ana Matsinhe",
"account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
"account_number": "ACC-2026-000142",
"account_holder_name": "Ana Matsinhe",
"route_id": "rte_2Tzu6NZioJBSiX9CSX5qObtq4Zt",
"cycle_id": "cyc_2o6Z32az1oKF1ykfNkmdxACDLcy",
"assignment_id": "ass_2bVAYnXSmDHuMvxsMpR2Q93SOVR",
"value": "value",
"unit": "unit",
"measured_at": "2026-11-19T09:30:00Z",
"received_at": "2026-11-19T09:30:00Z",
"method": "manual",
"submitted_by": "submitted by",
"source_id": "sou_2fjWEpPCsLRCQBV64hz26xd8MF9",
"external_id": "ext_29hSSzf2mTlOMhPS6LZmabb6s5h",
"client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
"idempotency_key": "idempotency key",
"status": "submitted",
"evidence_ids": [
"evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
],
"estimate_reason": "estimate reason",
"review_reason": "review reason",
"review_reason_code": "REV-2026-000142",
"rejection_reason": "rejection reason",
"reviewed_by": "reviewed by",
"reviewed_at": "2026-11-19T09:30:00Z",
"supersedes_id": "sup_2ZzC0N30W7dG4lhc0j9MWD38E9H",
"superseded_by_id": "sup_2CCzv2SV1C8FhKeH3QOr5AY7LOi",
"correction_reason": "correction reason",
"created_at": "2026-11-19T09:30:00Z"
}