event_idRequiredUnique event reference
REVENUE CONTROL / BROWSER-LOCAL
MeterProof accepts UTF-8, comma-delimited RFC 4180 CSV. Plain decimals are limited to 24 significant digits and 9 decimal places; XLSX, exponent/locale-formatted numbers and semicolon delimiters are refused rather than reinterpreted.
IMPORT-READY STARTER KIT
Download all three files, run them unchanged, then replace the rows with your own exports.
| Column | Required | Meaning |
|---|---|---|
event_id | yes | Unique event reference |
customer_id | yes | Exact customer join key |
meter | yes | Exact meter join key |
quantity | yes | Non-negative decimal |
event_at | yes | ISO-8601 timestamp with offset |
ingested_at | no | Timestamp used to classify late arrival |
source_ref | no | Your source-system reference, retained in the local ledger |
event_idRequiredUnique event reference
customer_idRequiredExact customer join key
meterRequiredExact meter join key
quantityRequiredNon-negative decimal
event_atRequiredISO-8601 timestamp with offset
ingested_atnoTimestamp used to classify late arrival
source_refnoYour source-system reference, retained in the local ledger
| Column | Required | Meaning |
|---|---|---|
price_id | yes | Stable price rule |
customer_id | no | Blank default or exact override |
meter | yes | Exact meter join key |
currency | yes | Uppercase ISO 4217 code |
effective_from | yes | Inclusive timestamp |
effective_to | no | Exclusive timestamp |
pricing_model | yes | flat, graduated or volume |
tier_start | yes | Inclusive start of the contiguous tier range |
tier_end | no | Exclusive tier end; blank for the open final tier |
unit_price_minor | yes | Decimal minor units per usage unit |
included_quantity | no | Applied once per effective revision |
minimum_amount_minor | no | Integer revision minimum |
price_idRequiredStable price rule
customer_idnoBlank default or exact override
meterRequiredExact meter join key
currencyRequiredUppercase ISO 4217 code
effective_fromRequiredInclusive timestamp
effective_tonoExclusive timestamp
pricing_modelRequiredflat, graduated or volume
tier_startRequiredInclusive start of the contiguous tier range
tier_endnoExclusive tier end; blank for the open final tier
unit_price_minorRequiredDecimal minor units per usage unit
included_quantitynoApplied once per effective revision
minimum_amount_minornoInteger revision minimum
| Column | Required | Meaning |
|---|---|---|
invoice_id | yes | Invoice reference |
line_id | yes | Unique invoice-line reference |
customer_id | yes | Exact customer join key |
meter | yes | Exact meter join key |
period_start | yes | Inclusive UTC billing-period timestamp |
period_end | yes | Exclusive UTC billing-period timestamp |
quantity | yes | Invoice quantity |
amount_minor | yes | Signed integer minor units |
currency | yes | Uppercase ISO 4217 code |
price_id | no | Checked against the effective price |
invoice_idRequiredInvoice reference
line_idRequiredUnique invoice-line reference
customer_idRequiredExact customer join key
meterRequiredExact meter join key
period_startRequiredInclusive UTC billing-period timestamp
period_endRequiredExclusive UTC billing-period timestamp
quantityRequiredInvoice quantity
amount_minorRequiredSigned integer minor units
currencyRequiredUppercase ISO 4217 code
price_idnoChecked against the effective price