ccrz.ccApiOrder.fetchOrderHistory

Calls the ccrz.ccApiOrder.search method for searching order history for specific search terms. Then, this method calls the ccrz.ccApiOrder.fetch method with the order IDs that match the search results, and populates the results with more order details.

Compatibility

This reference applies to:

Release Managed Package Version API Version
B2B Commerce for Visualforce Winter ’21 4.13 12
B2B Commerce for Visualforce Spring ’20 4.12 11
B2B Commerce for Visualforce Summer ’19 4.11 10
B2B Commerce for Visualforce Spring ’19 4.10 9
B2B Commerce for Visualforce Summer ’18 4.9 8

You can still call older versions of the API for this method, which can accept different input keys or return different output keys. Any differences in behavior for older versions aren't documented in this topic.

Note

Signature

global static Map<String, Object> fetchOrderHistory(Map<String, Object>)

Service Layer Classes

Logic Service Provider
ccrz.ccLogicOrderHistory

Inputs (Required)

Map<String, Object> that must include the following required keys:

ccrz.ccApi.API_VERSION
The version of the B2B Commerce for Visualforce API to reference for the method call. We recommend that you use the ccrz.ccApi.CURRENT_VERSION constant whenever possible, and only reference a specific version for compatibility if necessary.

If this key isn't specified, the method returns a ccrz.ccApi.NoApiVersionException.

Note

Include either of the following keys, but not both. If you don't include either key, the method returns a ccrz.ccApi.MissingInputException.

ccrz.ccApiOrder.PARAM_ORDER_ID_LIST
Set<String> of Salesforce IDs for the orders to query.
ccrz.ccService.SEARCHSTRING
String to use for searching order records.

For information about how this method evaluates these parameters, see the reference for the ccrz.ccLogicOrderHistory.fetchHistory logic service provider method.

Inputs (Optional)

The input map can also include the following keys:

ccrz.ccApi.API_SIZING
Map<String, Object> that specifies the scope of data that this method returns, including which fields the method returns for each record that matches the query.
ccrz.ccApiOrder.PARAM_ORDERLIMIT
Integer that specifies the maximum number of order records to query at one time.
ccrz.ccApiOrder.PARAM_ORDER_ITEM_LIMIT
Integer that specifies the maximum number of order item records to query at one time.

Outputs

Map<String, Object> that can include the following keys:

ccrz.ccApi.API_VERSION
Integer that indicates which API version was used for the query.
ccrz.ccApi.SUCCESS
Boolean
Value Usage
true The call completed.
false The call encountered errors.

B2B Commerce for Visualforce doesn't always return an exception for any errors that can occur. When this value is false, consider rolling back the API transaction to a previous savepoint.

Tip

This method's output also includes the output of ccrz.ccApiOrder.search, ccrz.ccApiOrder.fetch, and ccrz.ccApiOrder.fetchOrderItems, if applicable.