maiven gateway · online··
manifest · 2d ago
Sign in
Back to catalog
MAIVENmodelmarts

mart_returns

beta
mart table

Per-return case — disposition, reason, processing cycle time, and value, per client.

Definition

One row per return (grain return_id). Carries disposition (restock/repair/recycle/scrap), reason (∈ {damaged, wrong_item, late_delivery, no_longer_needed, quality_defect}), cycle_time_days, units_returned, return_value, the parent order_id/site_id, and client_id. This is the per-return table the returns_rate metric aggregates over; read rows to name which returns and why. Client-scoped via the client_account_manager row policy on client_id. reason is a controlled enum, not free text — return narratives are not exposed here (that stays out of the structured layer entirely).

Watch out for
  • highReading a return count as a return rate

    These are raw return rows — a rate needs a shipped-order denominator. Use the returns_rate metric for the rate.

  • highAssuming full visibility

    Row policy scopes to the caller's client_id.

  • mediumTreating disposition as reason

    disposition is what happened to the goods (restock/scrap…); reason is why they came back (damaged/wrong_item/late_delivery/ no_longer_needed/quality_defect) — different columns.

Questions this answers
  • “Which returns for this client were scrapped last month?”
  • “List the longest-to-process returns.”
  • “Show damaged-goods returns by site.”
12 of 12
Column
Type
Description
Tests · PII
return_id
String
PK — grain of this mart.
2 tests
client_id
String
Multi-tenant key. The client_account_manager row policy filters on this.
order_id
Nullable(String)
Parent order FK.
site_id
Nullable(String)
Handling site FK.
client_segment
String
Owning-client segment; unknown when unmapped.
site_region
String
EU / UK / NA / APAC / unknown.
disposition
Nullable(String)
restock / repair / recycle / scrap.
reason
Nullable(String)
damaged / wrong_item / late_delivery / no_longer_needed / quality_defect (the return_reason enum; alias of raw return_reason).
return_date
Nullable(Date)
Date the return was received.
cycle_time_days
Nullable(UInt16)
Days to process the return.
units_returned
Nullable(Int32)
Units in the return (passthrough).
return_value
Nullable(Decimal(18, 2))
Value of returned goods (alias of raw return_value_eur).