changedInput schema / properties / lines / items / properties / pricing / description
Previous value: -"How the usage is priced. flat and volume use tiers; prepaid_credit uses unitPrice and openingBalance."New value: +"How the usage is priced. flat and volume use tiers; prepaid_credit uses unitPrice and openingBalance; hybrid uses baseFee, includedUnits and overageUnitPrice."
addedInput schema / properties / lines / items / properties / pricing / properties / baseFee
Added value: +{
+ "description": "For hybrid: the fixed fee for each month listed. It is the month's revenue and excludes overage.",
+ "minimum": 0,
+ "type": "number"
+}
addedInput schema / properties / lines / items / properties / pricing / properties / cycle
Added value: +{
+ "description": "For hybrid: the cycle length. Only monthly is supported, and it is the default.",
+ "enum": [
+ "monthly"
+ ],
+ "type": "string"
+}
addedInput schema / properties / lines / items / properties / pricing / properties / includedUnits
Added value: +{
+ "description": "For hybrid: the units each month's fee includes.",
+ "minimum": 0,
+ "type": "number"
+}
changedInput schema / properties / lines / items / properties / pricing / properties / model / enum
Previous value: -[
- "flat",
- "volume",
- "prepaid_credit"
-]New value: +[
+ "flat",
+ "volume",
+ "prepaid_credit",
+ "hybrid"
+]
addedInput schema / properties / lines / items / properties / pricing / properties / overageUnitPrice
Added value: +{
+ "description": "For hybrid: the price of each unit above includedUnits in a month.",
+ "minimum": 0,
+ "type": "number"
+}
addedInput schema / properties / lines / items / properties / startDate
Added value: +{
+ "description": "Hybrid only: the date the contract starts, YYYY-MM-DD. The cycles then follow the contract: each starts on the anniversary of this date (the same day each month, or the month's last day when it has no such day). The fee is the revenue of the month a cycle starts in, in full and whether or not anything was used; the overage of a cycle falls in the month it ends in. With a startDate, usage entries carry a date instead of a period.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+}
addedInput schema / properties / lines / items / properties / through
Added value: +{
+ "description": "Hybrid with a startDate only: price every cycle that starts on or before this date, YYYY-MM-DD, including cycles with no usage. Defaults to the date of the last usage entry. To stop a subscription that has ended or isn't being paid, set it to the date it stopped or to the start of the last paid cycle.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+}
changedInput schema / properties / lines / items / properties / usage / description
Previous value: -"The units used in each month, up to 24 months. A month listed twice is refused."New value: +"Without a startDate: the units used in each month, up to 24 months, one entry per month (a month listed twice is refused). With a startDate (hybrid): dated entries, up to 1000, each assigned to the contract cycle its date falls in; the same date may appear more than once and is added up."
addedInput schema / properties / lines / items / properties / usage / items / properties / date
Added value: +{
+ "description": "The day the units were used, YYYY-MM-DD. Only with a startDate, on or after it.",
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+ "type": "string"
+}
changedInput schema / properties / lines / items / properties / usage / items / properties / period / description
Previous value: -"The month, YYYY-MM."New value: +"The month, YYYY-MM. Not used with a startDate."
changedInput schema / properties / lines / items / properties / usage / items / properties / quantity / description
Previous value: -"Units used in that month: not a running total."New value: +"Units used in that month (or on that day): not a running total."
changedInput schema / properties / lines / items / properties / usage / items / required
Previous value: -[
- "period",
- "quantity"
-]New value: +[
+ "quantity"
+]
changedInput schema / properties / lines / items / properties / usage / maxItems
Previous value: -24New value: +1000
changedInput schema / properties / lines / items / properties / usage / minItems
Previous value: -1New value: +0