API : Product Update

This request will update a product - either a master product or a reseller product which inherits from a master product.

The platform works with 2 levels of products:

• Master products - These are ADMIN defined base products that defines all the details of a product. A master product cannot be assigned to a customer but must be inherited by a reseller product. A master product can be inherited multiple times.
• Reseller products - A product that is based on a master product and on which the reseller can control the name, product code, price, certain settings, if the product may only be applied by the reseller and if it can only be used on a specific customer. A Reseller product can be used on the resellers direct customers (not sub-resellers customers).

When a master product is updated, all inherited products are also updated to reflect the changes.

When a reseller product is updated, only a small subset of the settings can be changed.

When updating a full product object can be passed or as little as a single property can be passed/updated. Properties that cannot be updated are simply ignored, properties that should not be changed should not be sent.

{
  "price": 249.00,
  "applyByResellerOnly": true
}

{
  "cost": 150.00,
  "wholesale": 180.00,
  "price": 250.00,
  "options": {
    "replaceWholesale": true
  }
}

See Product Get for examples of more types.

Note that properties holding no value may be omitted from the object.

{
  "_id": "650000000000000000000010",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "SIP_RATEPLAN",
  "productCode": "SR0123A",
  "name": "SIP account, flatrate DK",
  "unitType": "MONTHS",
  "recurrence": "MONTHLY",
  "recurrenceFullMonth": true,
  "cost": 150.00,
  "wholesale": 180.00,
  "price": 250.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "invoiceFromFirstNumber": false,
  "subscription": {
    "minutes": { "homeland": 1800, "euNordic": 0, "restOfEurope": 0, "world1": 0, "world2": 0, "world3": 0 },
    "free": { "ownSip": true, "ownMvno": false, "onNetSip": false, "onNetMvno": false }
  },
  "ratePercentDiscount": null,
  "override": {
    "connectionFee": 0.00,
    "connectionFeeOnCallAttempt": true
  }
}

{
  "_id": "650000000000000000000011",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "MVNO_RATEPLAN",
  "productCode": "MRFREE25G",
  "name": "Free voice, SMS, MMS, 25GB data & 5 hours EU",
  "unitType": "MONTHS",
  "recurrence": "MONTHLY",
  "recurrenceFullMonth": true,
  "cost": 150.00,
  "wholesale": 180.00,
  "price": 250.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "pbxProduct": false,
  "dataSharingSimsIncluded": 0,
  "smartWatchIncluded": false,
  "network": "BOTH",
  "subscription": {
    "minutes": { "homeland": 44640, "euNordic": 0, "restOfEurope": 0, "world1": 0, "world2": 0, "world3": 0 },
    "free": { "ownSip": true, "ownMvno": true, "onNetSip": false, "onNetMvno": false, "smsMms": true },
    "roaming": [
      { "_id": "650000000000000000000040", "minutes": 3000 }
    ],
    "data": 25600,
    "dataRoamLikeHome": 8192
  },
  "sms": {
    "nationalCost": 0.10,
    "nationalWholesale": 0.15,
    "nationalPrice": 0.20,
    "internationalCost": 0.50,
    "internationalWholesale": 1.00,
    "internationalPrice": 1.50
  },
  "mms": {
    "nationalCost": 0.50,
    "nationalWholesale": 0.75,
    "nationalPrice": 1.00,
    "internationalCost": 2.50,
    "internationalWholesale": 4.00,
    "internationalPrice": 5.00
  },
  "data": {
    "nationalCost": 0.50,
    "nationalWholesale": 1.00,
    "nationalPrice": 1.50
  }
}

{
  "_id": "650000000000000000000012",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "DSL",
  "productCode": "DSL5/5F",
  "name": "ADSL 5/5Mbit flex",
  "unitType": "MONTHS",
  "recurrence": "MONTHLY",
  "recurrenceFullMonth": true,
  "cost": 150.00,
  "wholesale": 180.00,
  "price": 250.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "dslSpeed": "5120/512FL"
}

{
  "_id": "650000000000000000000013",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "FIBER",
  "productCode": "F2432",
  "name": "Redundant cityring fiber",
  "unitType": "MONTHS",
  "recurrence": "MONTHLY",
  "recurrenceFullMonth": true,
  "cost": 1500.00,
  "wholesale": 1800.00,
  "price": 2500.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false
}

{
  "_id": "650000000000000000000014",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "NUMBER_RENT",
  "productCode": "NUM01",
  "name": "Number rent",
  "unitType": "MONTHS",
  "recurrence": "QUARTERLY",
  "cost": 0.00,
  "costExtra": 0.00,
  "cost100": 0.00,
  "wholesale": 20.00,
  "wholesaleExtra": 2.50,
  "wholesale100": 350.00,
  "price": 25.00,
  "priceExtra": 5.00,
  "price100": 500.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false
}

{
  "_id": "650000000000000000000015",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "PBX_USER",
  "productCode": "PBXUSER02",
  "name": "Small user package",
  "unitType": "MONTHS",
  "recurrence": "QUARTERLY",
  "recurrenceFullMonth": false,
  "cost": 0.00,
  "wholesale": 20.00,
  "price": 25.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "includedProducts": [
    { "_id": "650000000000000000000031", "amount": 1 },
    { "_id": "650000000000000000000032", "amount": 2 }
  ],
  "communicatorAccess": true,
  "recordingAccess": true,
  "extensionAccess": true,
  "sipPhoneAccess": true
}

{
  "_id": "650000000000000000000016",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "MVNO_DATA_TOP_UP",
  "productCode": "TOPUP5G",
  "name": "Data top-up 5 GB",
  "unitType": "UNITS",
  "recurrence": "NONE",
  "cost": 49,
  "wholesale": 49,
  "price": 59,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "mvnoTopUp": {
    "data": 5368709120
  }
}

{
  "_id": "650000000000000000000017",
  "start": "2022-01-01T00:00:00.000Z",
  "end": null,
  "type": "EXTERNAL_LICENSE",
  "productCode": "OFFICE_365_E3",
  "name": "Office 365 E3 2022",
  "unitType": "UNITS",
  "recurrence": "NONE",
  "recurrenceFullMonth": false,
  "cost": 0.00,
  "wholesale": 20.00,
  "price": 25.00,
  "reseller": "650000000000000000000020",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "externalLicense": {
    "platformId": "ALSO",
    "also": {
      "provisioningId": "123456-abcdef-123456",
      "bindingPeriod": "MONTHLY"
    }
  }
}

{
  "_id": "650000000000000000000018",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "MVNO_ROW_ROAMING",
  "productCode": "ROW5GB",
  "name": "Rest of World roaming: 5 GB",
  "unitType": "UNITS",
  "recurrence": "NONE",
  "recurrenceFullMonth": false,
  "cost": 0.00,
  "wholesale": 20.00,
  "price": 25.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false,
  "soc": "ABCDE18GJH"
}

{
  "_id": "650000000000000000000019",
  "start": "2014-01-01T00:00:00.000Z",
  "end": null,
  "type": "OTHER",
  "productCode": "NUMSER",
  "name": "Number series, 10 premium numbers",
  "unitType": "UNITS",
  "recurrence": "NONE",
  "cost": 1000.00,
  "wholesale": 1200.00,
  "price": 1400.00,
  "reseller": "650000000000000000000020",
  "inheritFrom": "650000000000000000000030",
  "inheritByCustomers": [],
  "applyByResellerOnly": false
}