| Name | Type | Description | Notes |
|---|---|---|---|
| created | DateTime | { "description" : "The UTC DateTime when the object was created.", "verbs":[] } | [optional] |
| changed_by | String | { "description" : "ID of the user who last updated the entity.", "verbs":[] } | [optional] |
| updated | DateTime | { "description" : "The UTC DateTime when the object was last updated.", "verbs":[] } | [optional] |
| metadata | DynamicMetadata | { "description" : "Add metadata.", "verbs":["POST"] } | [optional] |
| id | String | {"description":"","verbs":["GET"]} | |
| version_id | String | {"description":"","verbs":["GET"]} | [optional] |
| crm_id | String | {"description":"","verbs":["POST","PUT","GET"]} | [optional] |
| account_id | String | {"description":"","verbs":["POST","GET"]} | |
| organization_id | String | {"description":"Organization associated with the subscription.","verbs":[]} | |
| product_id | String | {"description":"","verbs":["GET"]} | |
| product_rate_plan_id | String | {"description":"Identifier of the rate-plan being billed for.","verbs":["POST","PUT","GET"]} | |
| parent_id | String | {"description":"","verbs":["GET"]} | [optional] |
| name | String | {"description":"User definable friendly name for the subscription.","verbs":["POST","PUT","GET"]} | |
| description | String | {"description":"","verbs":["POST","PUT","GET"]} | [optional] |
| type | String | {"default":"dependent on product", "description":"","verbs":["POST","GET"]} | [optional] |
| state | String | {"PUT_description":"A <span class=\"label label-default\">Provisioned</span> subscription can be updated to either <span class=\"label label-default\">Trial</span> or <span class=\"label label-default\">AwaitingPayment</span>, this will start the subscription. Any updates to the state of a non-<span class=\"label label-default\">Provisioned</span> will be ignored. To cancel or otherwise amend a subscription please use the explict amendment calls.", "description":"A <span class=\"label label-default\">Provisioned</span> subscription will not begin until marked as <span class=\"label label-default\">Trial</span> or <span class=\"label label-default\">AwaitingPayment</span>. Trial subscriptions transition to <span class=\"label label-default\">AwaitingPayment</span> when the trial period is over. On subscription renewal the state becomes <span class=\"label label-default\">AwaitingPayment</span>. Once outstanding invoices are paid the state changes to <span class=\"label label-default\">Paid</span>. A subscription is set as either <span class=\"label label-default\">Failed</span> or left as <span class=\"label label-default\">AwaitingPayment</span>, depending on the rate-plan configuration. If a subscription is non-recurring or fixed-term and ends naturally, it will be marked as <span class=\"label label-default\">Expired</span>. If all payment attempts have failed a subscription is marked as <span class=\"label label-default\">Cancelled</span> if it has been manually ended. Once a subscription is marked as <span class=\"label label-default\">Failed</span>, <span class=\"label label-default\">Expired</span>, or <span class=\"label label-default\">Cancelled</span> no invoices other than a final invoice will be issued. Note: Updating account card details will not lead to BillForward automatically retrying payment, manual payment attempts can be made.","verbs":["POST","PUT","GET"]} | |
| current_period_start | DateTime | {"description":"Start of the current invoice period. At the end of this period, a new new invoice will be generated","verbs":["POST","GET"]} | [optional] |
| current_period_end | DateTime | {"description":"End of the current period invoiced for. This can be manually updated to extend trials or delay invoice generation.","verbs":["PUT","GET"]} | [optional] |
| contract_start | DateTime | {"description":"start of the contracted period. This will be after a trial, if one exists","verbs":["GET"]} | [optional] |
| subscription_end | DateTime | {"description":"When a subscription will end. This may be in the future if the cancellation is at the end of the current period.","verbs":["GET"]} | [optional] |
| current_period_end_explicit | DateTime | {"description":"Override for the initial subscription period. Allows periods to align to a date or time regardless of purchase date/time.","verbs":["POST","PUT","GET"]} | [optional] |
| initial_period_start | DateTime | {"description":"Start of the first successful period","verbs":["GET"]} | |
| successful_periods | Integer | {"description":"Number of paid-for periods billing, excluding trials, since the subscription started.","verbs":["GET"]} | [optional] |
| total_periods | Integer | {"description":"Total number of subscription periods.","verbs":["GET"]} | [optional] |
| trial_end | DateTime | {"description":"The end time of the trial period, if one existed","verbs":["GET"]} | |
| dunning | BOOLEAN | { "default":"false", "description":"Are there outstanding invoices which are currently in dunning.","verbs":["GET", "PUT", "POST"]} | [optional] [default to false] |
| locked | String | {"description":"If the subscription is locked, it will not be processed by the system","verbs":[]} | [optional] |
| managed_by | String | {"description":"Which system is responsible for managing the subscription.","verbs":[]} | [optional] |
| version_start | DateTime | {"description":"When the current version of the subscription started.","verbs":["GET"]} | |
| version_end | DateTime | {"description":"When the current version of the subscription ended, null indicates current version.","verbs":["GET"]} | [optional] |
| version_number | Integer | {"description":"Incremental version number of the subscription, starts at 1.","verbs":["GET"]} | |
| credit_enabled | BOOLEAN | { "default":"true", "description":"Can credit-notes be used to pay outstanding invoices for this subscription.","verbs":["GET", "PUT", "POST"]} | [optional] [default to false] |
| aggregate_all_subscriptions_on_account | BOOLEAN | { "default":"true", "description":"Whether the subscription will aggregate all other subscriptions on the account.","verbs":["GET", "PUT", "POST"]} | [optional] [default to false] |
| pricing_component_values | Array<PricingComponentValue> | {"description":"The quantities for each pricing component of the rate-plan. Values should be set for all pricing components of the rate-plan apart from the usage components. Usage components should be added when the usage is known, this is often after the end of the current billing cycle.","verbs":["GET", "POST"]} | [optional] |
| payment_method_subscription_links | Array<PaymentMethodSubscriptionLink> | [optional] | |
| fixed_terms | Array<FixedTerm> | {"description":"List of fixed terms that have been or are applied to the subscription","verbs":["GET"]} | [optional] |
| current_time | DateTime | {"description":"The current time — from the point of view of the subscription.","verbs":["GET"]} | |
| time_offset | Integer | {"description":"How far in the future is the entity (in seconds) compared to the BillForward server's time.","verbs":["GET"]} | [optional] |
| payment_terms | Integer | [optional] | |
| purchase_order | String | { "default": " ", "description":"Purchase order associated with the subscription. If specified this is copied to any invoices issued for this subscription.","verbs":["POST"]} | [optional] |
| failed_payment_behaviour | String | {"default":"None","description":"The action that should be taken, should an invoice for some subscription to this rate plan remain unpaid despite the dunning period's being exceeded.<br><span class=\"label label-default\">CancelSubscription</span> — Demotes the subscription to the `Failed` state as soon as the dunning period is exceeded.<br><span class=\"label label-default\">None</span> — The subscription is allowed to continue in the `AwaitingPayment` state indefinitely even if the dunning period is exceeded.For slow payment cycles — or when manual invoice remediation is common — <span class=\"label label-default\">None</span> is recommended.<br>In a heavily-automated SaaS environment, automatic cancellation via <span class=\"label label-default\">CancelSubscription</span> is recommended.","verbs":["POST","PUT","GET"]} | [optional] |
This repository was archived by the owner on Oct 17, 2023. It is now read-only.