Update an order

Notes:

This operation is only available if you have the Orders feature enabled. If you are an existing Zuora Subscribe and Amend customer, we recommend you enable Orders Harmonization to access the Orders feature. With Orders, you can access both existing functions for subscription and billing management and the new features on Zuora Billing.
Update an order is only valid for draft or scheduled orders.
This operation doesn't support auto-refund and invoice write-off during subscription cancellation. Use the "Create an order" operation instead.
You must provide full payload when using the "Update an order" operation. That is, if you want to edit one order action, you need to provide all other order actions in the payload. Otherwise, the other order actions will be removed.

Request

path Parameters

orderNumber

required

string <string>

Order number of a order in which you are to update.

header Parameters

Accept-Encoding	string Include the `Accept-Encoding: gzip` header to compress responses as a gzipped file. It can significantly reduce the bandwidth required for a response. If specified, Zuora automatically compresses responses that contain over 1000 bytes of data, and the response contains a `Content-Encoding` header with the compression algorithm so that your client can decompress it.
Content-Encoding	string Include the `Content-Encoding: gzip` header to compress a request. With this header specified, you should upload a gzipped file for the request payload instead of sending the JSON payload.
Authorization	string The value is in the `Bearer {token}` format where {token} is a valid OAuth token generated by calling Create an OAuth token.
Zuora-Track-Id	string <= 64 characters A custom identifier for tracing the API call. If you set a value for this header, Zuora returns the same value in the response headers. This header enables you to associate your system process identifiers with Zuora API calls, to assist with troubleshooting in the event of an issue. The value of this field must use the US-ASCII character set and must not include any of the following characters: colon (`:`), semicolon (`;`), double quote (`"`), and quote (`'`).
Zuora-Entity-Ids	string An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you should not set this header.
Zuora-Org-Ids	string Comma separated IDs. If you have Zuora Multi-Org enabled, you can use this header to specify which orgs to perform the operation in. If you do not have Zuora Multi-Org enabled, you should not set this header. The IDs must be a sub-set of the user's accessible orgs. If you specify an org that the user does not have access to, the operation fails. If the header is not set, the operation is performed in scope of the user's accessible orgs.

Request Body schema: application/json
required

category	string Default: "NewSales" Category of the order to indicate a product sale or return. Default value is `NewSales`. Enum: "NewSales" "Return"
	object (orderFieldsCustom) Container for custom fields of an Order object.
description	string <= 500 characters A description of the order.
existingAccountNumber	string <= 70 characters The account number that this order will be created under. Note that this actually specifies the invoice owner account of the subscriptions included in this order.
externallyManagedBy	string An enum field on the Subscription object to indicate the name of a third-party store. This field is used to represent subscriptions created through third-party stores. Enum: "Amazon" "Apple" "Google" "Roku"
orderDate required	string <date> The date when the order is signed. All the order actions under this order will use this order date as the contract effective date if the contract effective date field is skipped or its value is left as null.
orderNumber	string <= 100 characters The order number of the new order. If not provided, system will auto-generate a number for this order. Note: Make sure the order number does not contain a slash.
	object (processingOptionsOrders) The container for billing processing options and payment processing options. Note: This field is not supported in draft orders. When you use the "Create an order" operation to create an account, create a subscription, run billing, and collect payment in a single call, if any error occurs during the call, such as a payment processing failure and a tax engine failure, then all the other steps will be rolled back. In this case, neither the invoice will be generated, nor the subscription nor the account will be created. When you use the "Create an order" operation to cancel a subscription with `refund` and `writeOff`, if the `refund` or `writeOff` fails, `cancelSubscription`, `runBilling`, and `collectPayment` still can succeed. When you use the "Create an order" operation, the `collectPayment` and `refund` fields cannot be set to `true` simultaneously. Otherwise, the order will not be proceeded.
reasonCode	string <= 255 characters Values of reason code configured in Billing Settings > Configure Reason Codes through Zuora UI. Indicates the reason when a return order line item occurs.
	object Information of scheduled order.
status	string The status of the order. The default value is `Completed`. The following values are supported: `Draft`: The order is in draft status. `Pending`: The order is in pending status. `Completed`: The order is in completed status. `Scheduled`: The order is in scheduled status and it is only valid if the Scheduled Orders feature is enabled. `Executing`: The scheduled order is executed by a scheduler and it is only valid if the Scheduled Orders feature is enabled. `Failed`: The scheduled order has failed. Enum: "Draft" "Pending" "Completed" "Scheduled"
	Array of objects Each item includes a set of order actions, which will be applied to the same base subscription.

Responses

200

500

Internal Server Error

4XX

Request Errors

put/v1/orders/{orderNumber}

Request samples

Payload
cURL

application/json

{"description": "This is a description for the Order.",
"existingAccountNumber": "A00000001",
"orderDate": "2017-01-01",
"orderNumber": "OM-00001",
"processingOptions": {"applyCreditBalance": true,
"billingOptions": {"creditMemoReasonCode": "Unsatisfactory service",
"targetDate": "2017-08-01"
},
"collectPayment": true,
"electronicPaymentOptions": {"paymentGatewayId": "2c9890186cb7c157016cd18c72370999",
"paymentMethodId": "2c9890186cb7c157016cd18c6f690999"
},
"runBilling": true
},
"subscriptions": [{"orderActions": [{"createSubscription": {"billToContactId": "efbff07e6290dfb8016291003bd00dda",
"invoiceTemplateId": "2c9081a03c638994013c63978baf002b",
"paymentTerm": "Net 30",
"sequenceSetId": "6abcc30846de11e990900242ac1f0003",
"soldToContactId": "efbff07e6290dfb8016291003bd00ddb",
"subscribeToRatePlans": [{"productRatePlanId": "efbff07e6290dfb8016291003bd00dda"
}
],
"subscriptionNumber": "SM-00001",
"terms": {"autoRenew": true,
"initialTerm": {"period": 12,
"periodType": "Month",
"startDate": "2017-01-01",
"termType": "TERMED"
},
"renewalSetting": "RENEW_WITH_SPECIFIC_TERM",
"renewalTerms": [{"period": 12,
"periodType": "Month"
}
]
}
},
"triggerDates": [{"name": "ContractEffective",
"triggerDate": "2017-01-01"
}
],
"type": "CreateSubscription"
}
]
},
{"orderActions": [{"createSubscription": {"subscribeToRatePlans": [{"productRatePlanId": "efbff07e6290dfb8016291003bd00dda"
}
],
"subscriptionNumber": "SM-00002",
"terms": {"autoRenew": true,
"initialTerm": {"period": 12,
"periodType": "Month",
"startDate": "2017-02-01",
"termType": "TERMED"
},
"renewalSetting": "RENEW_WITH_SPECIFIC_TERM",
"renewalTerms": [{"period": 12,
"periodType": "Month"
}
]
}
},
"triggerDates": [{"name": "ServiceActivation",
"triggerDate": "2017-02-01"
}
],
"type": "CreateSubscription"
}
]
},
{"orderActions": [{"createSubscription": {"subscribeToRatePlans": [{"productRatePlanId": "efbff07e6290dfb80162910024c80dd5"
}
],
"subscriptionNumber": "SM-00003",
"terms": {"autoRenew": true,
"initialTerm": {"period": 12,
"periodType": "Month",
"startDate": "2017-01-01",
"termType": "TERMED"
},
"renewalSetting": "RENEW_WITH_SPECIFIC_TERM",
"renewalTerms": [{"period": 12,
"periodType": "Month"
}
]
}
},
"triggerDates": [{"name": "ServiceActivation",
"triggerDate": "2017-03-01"
},
{"name": "CustomerAcceptance",
"triggerDate": "2017-04-01"
}
],
"type": "CreateSubscription"
}
]
},
{"orderActions": [{"createSubscription": {"subscribeToRatePlans": [{"chargeOverrides": [{"productRatePlanChargeId": "efbff07e6290dfb80162910024d80dd7",
"startDate": {"triggerEvent": "SpecificDate"
}
}
],
"productRatePlanId": "efbff07e6290dfb80162910024c80dd5",
"uniqueToken": "Sugar-free Monthly"
}
],
"subscriptionNumber": "SM-00004",
"terms": {"autoRenew": true,
"initialTerm": {"period": 12,
"periodType": "Month",
"startDate": "2017-01-01",
"termType": "TERMED"
},
"renewalSetting": "RENEW_WITH_SPECIFIC_TERM",
"renewalTerms": [{"period": 12,
"periodType": "Month"
}
]
}
},
"triggerDates": [{"name": "ServiceActivation",
"triggerDate": "2017-03-01"
},
{"name": "CustomerAcceptance",
"triggerDate": "2017-04-01"
}
],
"type": "CreateSubscription"
}
]
},
{"orderActions": [{"suspend": {"suspendPeriods": 2,
"suspendPeriodsType": "Week",
"suspendPolicy": "FixedPeriodsFromToday"
},
"triggerDates": [{"name": "ContractEffective",
"triggerDate": "2018-01-01"
},
{"name": "ServiceActivation",
"triggerDate": "2018-01-01"
},
{"name": "CustomerAcceptance",
"triggerDate": "2018-01-01"
}
],
"type": "Suspend"
}
],
"subscriptionNumber": "SM-00005"
},
{"orderActions": [{"resume": {"extendsTerm": true,
"resumePolicy": "SpecificDate",
"resumeSpecificDate": "2018-10-01"
},
"triggerDates": [{"name": "ContractEffective",
"triggerDate": "2018-01-01"
},
{"name": "ServiceActivation",
"triggerDate": "2018-01-01"
},
{"name": "CustomerAcceptance",
"triggerDate": "2018-01-01"
}
],
"type": "Resume"
}
],
"subscriptionNumber": "SM-00006"
}
]
}

Response samples

application/json

{"accountNumber": "A00000001",
"invoiceNumbers": ["INV00000001"
],
"orderNumber": "OM-00002",
"paidAmount": "300",
"paymentNumber": "P-00000002",
"status": "Pending",
"subscriptions": [{"status": "Pending Activation",
"subscriptionNumber": "SM-00001"
},
{"status": "Pending Acceptance",
"subscriptionNumber": "SM-00002"
},
{"status": "Active",
"subscriptionNumber": "SM-00003"
},
{"status": "Pending Acceptance",
"subscriptionNumber": "SM-00004"
},
{"status": "Suspended",
"subscriptionNumber": "SM-00005"
},
{"status": "Active",
"subscriptionNumber": "SM-00006"
}
],
"success": true
}

Update an order

path Parameters

header Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required