Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.
ccrz.ccApiOrder.cancel
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 |
Signature
global static Map<String, Object> cancel(Map<String, Object>)
Service Layer Classes
- Logic Service Provider
- ccrz.ccLogicOrderCancel
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.
Include one of the following keys. If none of these keys are included, the method returns a ccrz.ccApi.MissingInputException.
- ccrz.ccApiOrder.PARAM_ORDER_ENCID
- Encrypted ID of the order to cancel.
- ccrz.ccApiOrder.PARAM_ORDER_ENCID_LIST
- Set<String> that includes the encrypted ID of only one order to cancel.
- ccrz.ccApiOrder.PARAM_ORDER_ID
- Salesforce ID of the order to cancel.
- ccrz.ccApiOrder.PARAM_ORDER_ID_LIST
- Set<String> that includes the Salesforce ID of only one order to cancel.
Inputs (Optional)
The input map can also include the following keys:
- ccrz.ccApi.API_SIZING
-
Map<String, Object> that describes options
for sizing and scoping the method's return data. This method supports
ccrz.ccApi.SZ_REFETCH => TRUE, which specifies
that this method invokes ccrz.ccApiOrder.fetch for returning the canceled
order.
ccrz.ccApi.SIZING => new Map<String, Object>{ ccrz.ccApiOrder.ENTITYNAME => new Map<String, Object>{ ccrz.ccApi.SZ_REFETCH => TRUE } }
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. - ccrz.ccApiOrder.ORDERLIST
- List<Map<String, Object>>, where the Map<String, Object> represents the canceled ccrz__E_Order__c record.
Example
Cancel an order by Salesforce ID.
Map<String, Object> orderCancelData = new Map<String, Object>{
ccrz.ccApi.API_VERSION => ccrz.ccApi.CURRENT_VERSION,
ccrz.ccApiOrder.PARAM_ORDER_ID => 'order_ID'
};
try {
Map<String, Object> orderCancelResults = ccrz.ccApiOrder.cancel(orderCancelData);
System.debug((Boolean) orderCancelResults.get(ccrz.ccApi.SUCCESS));
} catch (Exception e) {
// Error handling...
}