PATCH/partners/customers/{domainId}/option-product-orders/{optionProductId}

Updates a scheduled task for an option. The updatable fields differ depending on the type of an option.

  • This API operation is available only if a scheduled task exists for an option.

  • If an annual subscription option is canceled, it can be added again starting the following month.

  • Scheduled date (applyDate)

    • If the type is APPLY
      • Application for both a subscription and an option is scheduled: It is the same as the scheduled date for the subscription (from the next day to 31 days later).
      • Both paid plan conversion and application for an option are scheduled: For a Trial subscription, it can be from the next day to the Trial grace period end date; for a Free subscription, it can be from the next day to 60 days later.
      • Application for an option is scheduled while using a paid subscription: It can be from the next day to the subscription renewal date (planEndDate +1 day).
    • If the type is CANCEL
      • Both paid plan conversion and option cancellation are scheduled: It is the same as the scheduled date for the subscription.
      • Cancellation of an option is scheduled while using a paid subscription: It can be from the next day to the option renewal date (planEndDate +1 day).
    • If the type is START_PAID_SERVICE
      • Paid plan conversion is scheduled for both a subscription and a Trial option: It is the same as the scheduled date for the subscription.
      • A Trial option is scheduled to convert to a paid one while using a paid subscription: It can be from the next day to the day after the option’s Trial ends (no grace period).
    • If the type is MODIFY
      • It can be from the next day to the day after the subscription ends.
    • If the type is CHANGE_QUANTITY
      • It can only be the first of the following month. (Note that the first of the following month must fall within the subscription period).
      • You cannot add a scheduled task in the subscription end month.

  • LINE WORKS Options

    • Archive (Talk)
      • Available with the Standard, Standard Trial, Advanced, or Advanced Trial plan.
      • You can schedule an application (APPLY), cancellation (CANCEL), or paid plan conversion (START_PAID_SERVICE).
    • Shared Storage
      • Available with the Standard or Advanced plan.
      • You can schedule an application (APPLY), cancellation (CANCEL), or upgrade (MODIFY).
    • Drive
      • Available with the Standard, Standard Trial, Advanced, or Advanced Trial plan.
      • You can schedule an application (APPLY), cancellation (CANCEL), conversion from trial to paid (START_PAID_SERVICE), or upgrade (MODIFY).
    • Extend contacts
      • Available with the Standard or Advanced plan.
      • You can schedule an application (APPLY), cancellation (CANCEL), or upgrade (MODIFY).

Authorization

oauth2

OAuth 2.0 authentication. For more information, see Authentication and Authorization.

Scope

partner

HTTP Request

PATCHhttps://www.worksapis.com/v1.0/partners/customers/{domainId}/option-product-orders/{optionProductId}

Path Parameters

ParameterTypeDescription
domainId integer 

Domain ID


required
example : 10000001 
optionProductId string 

Option ID

  • ACV2: Archive (Talk)
  • DRV: Drive
  • SSTG2: Shared Storage
  • BCT: Extend contacts

required
Allowed values : ACV2, SSTG2, DRV, BCT 
optionProductId string 

Option ID

  • ACV2: Archive (Talk)
  • DRV: Drive
  • SSTG2: Shared Storage
  • BCT: Extend contacts

required
Allowed values : ACV2, SSTG2, DRV, BCT 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

PropertyTypeDescription
subOptionId string 

Sub option ID

  • LINE WORKS options
    • If the option ID is ACV2
      • ACV200: Archive (Talk) Trial
      • ACV201: Archive (Talk)
    • If the option ID is DRV
      • DRV00: Drive Trial (for STD)
      • DRV01: Drive (for STD)
      • DRV_PS_T: Drive Plus Trial (for STD)
      • DRV_PS: Drive Plus (for STD)
      • DRV_PA_T: Drive Plus Trial (for ADV)
      • DRV_PA: Drive Plus (for ADV)
    • If the option ID is SSTG2
      • SSTG201: Shared Storage (1 TB)
      • SSTG202: Shared Storage (5 TB)
      • SSTG203: Shared Storage (10 TB)
      • SSTG204: Shared Storage (25 TB)
      • SSTG205: Shared Storage (50 TB)
      • SSTG206: Shared Storage (100 TB)
      • SSTG207: Shared Storage (500 TB)
    • If the option ID is BCT
      • BCT01: Extend contacts (up to 250,000 contacts)
      • BCT02: Extend contacts (up to 500,000 contacts)
      • BCT03: Extend contacts (up to 1,500,000 contacts)
      • BCT04: Extend contacts (up to 5,000,000 contacts)

Allowed values : ACV200, ACV201, DRV00, DRV01, DRV_PS_T, DRV_PS, DRV_PA_T, DRV_PA, SSTG201, SSTG202, SSTG203, SSTG204, SSTG205, SSTG206, SSTG207, BCT01, BCT02, BCT03, BCT04 
quantity integer 

Purchased quantity

  • It is available only for addable options.
 
applyDate string 

Scheduled date


required
example : 2021-11-01 

Request Example

Change the scheduled date for adding Drive to 2021-11-01

1{2  "applyDate": "2021-11-01"3}

Response

HTTP 200

OK

PropertyTypeDescription
subscriptionId integer 

Subscription ID

  • It is null if an option is scheduled to be added after a subscription.
  • It is the subscriptionId if an option is scheduled to be added for the subscription currently in use.
 
optionProductId string 

Option ID

  • LINE WORKS options
    • ACV2: Archive (Talk)
    • DRV: Drive
    • SSTG2: Shared Storage
    • BCT: Extend contacts

required
Allowed values : ACV2, DRV, SSTG2, BCT 
subOptionId string 

Sub option ID

  • LINE WORKS options
    • If the option ID is ACV2
      • ACV200: Archive (Talk) Trial
      • ACV201: Archive (Talk)
    • If the option ID is DRV
      • DRV00: Drive Trial (for STD)
      • DRV01: Drive (for STD)
      • DRV_PS_T: Drive Plus Trial (for STD)
      • DRV_PS: Drive Plus (for STD)
      • DRV_PA_T: Drive Plus Trial (for ADV)
      • DRV_PA: Drive Plus (for ADV)
    • If the option ID is SSTG2
      • SSTG201: Shared Storage (1 TB)
      • SSTG202: Shared Storage (5 TB)
      • SSTG203: Shared Storage (10 TB)
      • SSTG204: Shared Storage (25 TB)
      • SSTG205: Shared Storage (50 TB)
      • SSTG206: Shared Storage (100 TB)
      • SSTG207: Shared Storage (500 TB)
    • If the option ID is BCT
      • BCT01: Extend contacts (up to 250,000 contacts)
      • BCT02: Extend contacts (up to 500,000 contacts)
      • BCT03: Extend contacts (up to 1,500,000 contacts)
      • BCT04: Extend contacts (up to 5,000,000 contacts)

required
Allowed values : ACV200, ACV201, DRV00, DRV01, DRV_PS_T, DRV_PS, DRV_PA_T, DRV_PA, SSTG201, SSTG202, SSTG203, SSTG204, SSTG205, SSTG206, SSTG207, BCT01, BCT02, BCT03, BCT04 
type string 

Scheduled task type

  • APPLY: Apply for an option
  • START_PAID_SERVICE: Convert an option to paid
  • CHANGE_QUANTITY: Update the quantity of an option
  • CANCEL: Cancel an option

required
Allowed values : APPLY, START_PAID_SERVICE, CHANGE_QUANTITY, CANCEL 
quantity integer 

Quantity

  • It is 1 if optionProductId is SSTG2 or BCT.
  • It is null if not.

readOnly : true
nullable : true 
applyDate string 

Scheduled date


required
format : date 

Response Example

Example 1

1{2  "subscriptionId": 0,3  "optionProductId": "ACV2",4  "subOptionId": "ACV201",5  "type": "APPLY",6  "quantity": null,7  "applyDate": "2019-08-24"8}