Order
An order, with its billing terms and what has been billed on it so far.
- autoType: boolean | null
Post Invoices requiredWhether the order's invoices are posted as soon as the billing run makes them. Null or false, they wait as drafts for you to post.
- autoType: boolean | null
Send Billing Emails requiredWhether invoices are emailed to the billing contacts when posted, with payment reminders once they fall due. Null or false, no emails.
- autoType: boolean | null
Send Payment Emails requiredWhether a receipt is emailed when an invoice is paid in full, stating the amount of the payment that settled it. None is sent when nothing was paid: an invoice with a total of zero or less, or one Stripe settled from the customer's Stripe balance. Null or false, no receipt.
- billedType: number
Amount No Tax requiredTotal of the order's posted invoices before tax; drafts and voided invoices aren't counted. Decimal amount in major units.
- billedType: number
Tax requiredTax on the order's posted invoices; drafts and voided invoices aren't counted. Decimal amount in major units.
- billedType: string | nullFormat: date-time
Through requiredHow far the billing run has got with the order, at midnight UTC: the latest cycle boundary (a cycle's start, or the order's end) it has billed, making an invoice when anything was due. Charges due after it go on the order's next invoice; for an ended order, anything owed after its final invoice goes on a true-up invoice, for up to 90 days after its end, or after its end date last moved. Null until the first.
- billingType: integer
Anchor min:1max:31requiredThe day of the month the order's billing cycles start, as set in its terms, else its start date's day.
- billingType: array of string
Contact Ids requiredThe contacts (
con_…) who receive this order's invoices, each a contact of the customer or of the billing customer. Contacts are managed with the Contacts operations, such as Create a contact. - billingType: string | null
Customer Id requiredAnother customer who pays for this order, when it isn't the customer it is for. The order's invoices are made out to them.
- billingType: integer | null
Frequency Custom Months min:1max:60requiredMonths in each billing period when
billingFrequencyOverrideiscustom, as set in the order's terms; null when not set, in which case acustomoverride bills every month. - billingType: boolean
Frequency Overridden requiredWhether
billingFrequencyOverrideis set. - createdType: stringFormat: date-time
At requiredthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- creationType: "draft" or "active"enum
State requireddraftuntil the order is activated, thenactive, which it stays after the order ends. - currencyType: stringrequired
ISO 4217 code the order is priced and billed in.
- customerType: string
Id requiredThe customer the order is for.
- endType: string | nullFormat: date-time
Date requiredThe day the order ends, at midnight UTC, or null when it runs until ended. An order billed through a Stripe subscription (bought on Stripe Checkout) has the subscription cancelled in Stripe once this day comes, with the unused part of its fee credited and usage so far billed. For 90 days after an order ends, or after its end date last moved (by a backdated activation, a new
endDatesent with Update an order or anupdateOrderTermamendment, not by other changes such as a new name; so an order a backdated activation ends on an earlier day is credited however far back that day is), anything still owed for it once its final invoice is made (usage sent late, a credit correction) is billed on an invoice of its own, dated when the billing run makes it. - estimatedType: number
Tax requiredEstimated tax on what is still to be billed. Decimal amount in major units.
- idType: stringrequired
The order's Spondo Billing ID.
- metadataType: nullablerequiredProperties: 1
Your own key-value data, kept with the record and returned as sent.
- nameType: stringrequired
The order's name. Defaults to its products' names joined with " + ".
- numberType: integerrequired
The order's sequential number in your account.
- orderType: number
Amount requiredThe order's recurring amount per month: its recurring and per-seat fees times their quantities, with longer billing frequencies spread over their months. Usage and one-time charges aren't included. Decimal amount in major units.
- paymentType: string | nullenum
Terms requiredWhen the order's invoices fall due, counted from when each is posted; null for 14 days.
valuesDueOnReceiptNet15Net30Net45Net60Net90null - pendingType: number
Billing Amount requiredWhat the order's next invoice holds so far: the charges due by its next billing date (its next cycle start, or its end) that haven't been invoiced yet, with usage to date, after discounts and before tax. When the current cycle hasn't been invoiced yet (an order just activated), its invoice comes first and isn't counted here. 0 for draft, paused and ended orders (an ended order's next invoice, if any, is a true-up). Decimal amount in major units.
- purchaseType: string | null
Order Reference requiredYour customer's purchase order reference, shown on the order's invoices.
- showType: boolean | null
Bank Details requiredWhether the order's invoices show your bank details, or null for your account's default.
- showType: boolean | null
Payment Link requiredWhether the order's invoices show a payment link, or null for your account's default.
- startType: stringFormat: date-time
Date requiredThe day the order starts, at midnight UTC.
- statusType: stringenumrequired
Where the order is in its life.
draft: not yet activated.active: activated and before its end date.paused: billing paused.ended: cancelled (for example replaced by a newer order on the same product) or on or after its end date, the first day it doesn't run.valuesdraftactivepausedended - subscriptionType: object | null
Terms requiredProperties: 1Your subscription terms for the order (term length, renewal), kept with the order and returned as sent.
- totalType: number
Amount requiredThe order's total recurring amount per month, as
orderAmount. Decimal amount in major units. - totalType: number
Billed Amount requiredTotal of the order's posted invoices including tax; drafts and voided invoices aren't counted. Decimal amount in major units.
- updatedType: stringFormat: date-time
At requiredthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- versionType: integerrequired
Starts at 1 and goes up by one with each amendment. Previews and amendments must send the current version.
- billingType: string
Frequency Override Bill the order's recurring and seat-based charges at this frequency (
monthly,quarterly,semiAnnually,annual, orcustomfor everybillingFrequencyCustomMonthsmonths) instead of each charge's own. Present only when set.