The Offering entity

Description

An Offering represents a commercial agreement in the inTandem platform, describing the various attributes of the commercial terms, including pricing, type, and additional metadata.

Entity Properties

Example Entity

NameDescriptionTypeRequired
uidThe entity unique identifier.stringNo
created_atTimestamp indicating when the entity was created.string (date-time)No
updated_atTimestamp of the entity's most recent update.string (date-time)No
typeCategory of the offering. Possible values: package, app, addon.stringYes
SKUThe unique code of the associated underlying SKU (e.g., app code name, offering code).stringYes
display_nameThe SKU's display name.stringYes
quantityThe number of items included in the offering. Default: 1.numberYes
payment_typeDefines the billing cycle period. Possible values: monthly, annualy, free, single_charge, external.stringYes
is_activeCurrent status of the directory offering. Default: true.booleanNo
vendorThe business entity or vendor that offers this SKU. Possible values: partner, inTandem. Default: inTandem.stringNo
pricesList of price objects. Each object contains price (number) and currency (string with values USD, EUR, GBP).arrayYes
enable_trialWhether or not this offering supports a trial period. Default: false.booleanNo
trial_typeSpecifies how the trial option is managed. Current value: expire. Future values may include: automatic charge, manually charge, expire. Default: expire.stringNo
trial_periodNumber of days for the trial period. If not specified or set to 0, it indicates no trial period is offered.numberNo
can_purchase_additional_seatsIndicates if a business can purchase additional seats beyond the bundled subscription. Default: true.booleanNo
reporting_tagsA comma-separated list of tags to be used for reporting purposes. Possible values: base, free, connect, limited-core, core, core-trial.stringNo
{
  "uid": "bc33f12d-98ee-428f-9f65-18bba589cb95",
  "created_at": "2024-01-01T09:00:00Z",
  "updated_at": "2024-03-20T12:34:56Z",
  "type": "package",
  "SKU": "premium_10",
  "display_name": "Premium 10",
  "quantity": 1,
  "payment_type": "monthly",
  "status": "active",
  "vendor": "inTandem",
  "prices": [
    {
      "price": 5.00,
      "currency": "USD"
    },
    {
      "price": 5.00,
      "currency": "EUR"
    }
  ],
  "enable_trial": false,
  "trial_type": "expire",
  "trial_period": 14,
  "can_purchase_additional_seats": false,
  "reporting_tags": "core"