Unbundle Multiple

Unbundle one or more bundles of service appointments. This resource accepts one or more bundle IDs. This endpoint is available in version 54.0 and later of the Salesforce API.

URI: <host>/bundleflow/api/v1.0/unbundleMultiple
Format: JSON
HTTP Method: POST
Authentication: Authorization: Bearer <token>
Headers: sf_api_version—Salesforce API version. Minimum version is 53.0.; Authorization—Authorization token.; Content-Type—File format. Valid value is JSON.; Referer—Org domain URL.

Request Body

Properties

Field		Type	Description
user		String	Optional. User name of user sending the request.
initiate		String	Type of bundle request. Valid value: `manual`
saRequestPayloads		Array	IDs of bundle service appointment to unbundle.
	serviceAppointmentId	String	ID of a bundle service appointment.

Example

JSON Example

This example shows a request to unbundle two bundles.

1{
2   "user":"Misha",
3   "initiate":"manual",
4   "saRequestPayloads":[
5      {
6         "serviceAppointmentId":"08px000000NzdLFAAZ"
7      },
8      {
9         "serviceAppointmentId":"08px000000NzdH8AAJ"
10      }
11   ]
12}

Response Body

Properties

The response body is an array of objects with these fields. Each object contains response details for a bundle service appointment you requested to unbundle.

Field			Type	Description
headers			Object	For future use.
body			Object	Details of unbundling the service appointment bundle.
	bundle id		String	ID of the bundle that is unbundled. If the unbundling fails, it’s `null`.
	responsePayloads		Array	Response details of unbundling the service appointments. If it’s successful, the payload is `null`. If the unbundling fails, the payload shows error details.
		status	String	Failure status of unbundling the service appointments. Output: `FAIL`
		messageCode	Number	Error code. The error codes are listed in Error Responses.
		message	String	Error message.
	status		String	Status of unbundling the service appointments. Output: `SUCCESS` or `FAIL`
	messageCode		Number	Success or error code of unbundling the bundle. 0 means success. The error codes are listed in Error Responses.
	message		String	Success or error message of unbundling the bundle.
statusCode			String	Success or error code of the request.
statusCodeValue			Number	Success or error code number of the request. 0 means success. The error codes are listed in Error Responses.

Example

JSON Example: Successful Response

This example shows a successful response of unbundling two service appointment bundles.

1{
2    "httpStatus": 200,
3    "statusDescription": "OK",
4    "responsePayload": "[ {\n  \"headers\" : { },\n  \"body\" : {\n    \"bundleId\" : \"08px000000OAph4AAD\",\n    \"responsePayloads\" : null,\n    \"status\" : \"SUCCESS\",\n    \"messageCode\" : \"NONE\",\n    \"message\" : \"Success\"\n  },\n  \"statusCode\" : \"OK\",\n  \"statusCodeValue\" : 200\n} ]",
5    "messageCode": "NONE"
6}

Example

JSON Example: Fail Response

This example shows the output of a request where the user entered a service appointment ID instead of a bundle ID. The request only works with bundle IDs, so the response status is FAIL.

1[
2  {
3    "httpStatus": 200,
4    "statusDescription": "OK",
5    "responsePayload": "[ {\n  \"headers\" : { },\n  \"body\" : {\n    \"bundleId\" : null,\n    \"responsePayloads\" : [ {\n      \"status\" : \"FAIL\",\n      \"messageCode\" : \"GET_BUNDLE_INFO_FAILURE\",\n      \"message\" : \"Try again later.\",\n      \"messageParams\" : [ ]\n    } ],\n    \"status\" : \"FAIL\",\n    \"messageCode\" : \"ERROR_UNBUNDLING\",\n    \"message\" : \"We couldn't unbundle the service appointment.\",\n    \"messageAdditionalInfo\" : \"(bundleSaRef)\\n  errorCode: NOT_FOUND\\n  message:   Provided external ID field does not exist or is not accessible: 123\"\n  },\n  \"statusCode\" : \"OK\",\n  \"statusCodeValue\" : 200\n} ]",
6    "messageCode": "NONE"
7    "messageAdditionalInfo": "(bundleSaRef)\n  errorCode: NOT_FOUND\n  message:   Provided external ID field does not exist or is not accessible: 123"
8}

Table 1. **Error Responses**
Code	Name	Message
0	NONE	<Service Appointment ID#>: Success.
1	UNSUPPORTED_VERSION	Ask your admin to check the API version, then try again.
2	SA_PAYLOAD_SHOULD_CONTAIN_ADD_ACTIONS_ONLY	Create bundles using add actions only.
3	EMPTY_BUNDLE_POLICY	Enter an ID for the bundlePolicyId.
4	EMPTY_BUNDLE_INITIATE	Specify manual or auto for the initiate entry.
5	EMPTY_BUNDLE_SERVICE_APPOINTMENT	Add a bundle service appointment.
6	SA_PAYLOAD_DUPLICATED_SAS	Remove duplicate service appointment IDs.
7	SA_IS_BUNDLE	<Service Appointment ID#>: Is already a bundle service appointment.
8	SA_ALREADY_BUNDLED	<Service Appointment ID#>: Is a bundle member service appointment in another bundle.
9	STATUS_FORBIDDEN	<Service Appointment ID#>: Can’t be bundled in the current status.
10	SA_PAYLOAD_SHOULD_NOT_CONTAIN_MIX_ACTIONS	Send separate requests for add and remove actions.
11	SA_IS_NOT_BUNDLE	Select a bundle service appointment and try again.
12	EXCEEDED_BUNDLE_MEMBERS_LIMIT	You reached the maximum number of service appointments for this bundle. Remove some of them and try again.
13	SA_PAYLOAD_SHOULD_CONTAIN_ONLY_BUNDLE_MEMBERS	To remove bundle members from a bundle, include only service appointments that are bundle members.
14	ERROR_IN_BASIC_VALIDATIONS	We couldn’t bundle the service appointments.
15	ERROR_IN_LIMIT_VALIDATIONS	N/A
16	ERROR_IN_CRITERIA_VALIDATIONS	N/A
17	ERROR_IN_SERVICE_TERRITORY_VALIDATIONS	Confirm or revise the service territories of the selected service appointments. Or ask your admin for help.
18	ERROR_IN_RESTRICTION_VALIDATIONS	Confirm or revise the selected service appointments. Or ask your admin to check the restriction policies.
19	EXCEEDED_BUNDLE_DURATION_LIMIT	N/A
20	EMPTY_BODY	Fill in the request.
21	SA_IS_NOT_BUNDLED	<Service Appointment ID#>: Can’t remove a service appointment that isn’t in the bundle.
22	ERROR_IN_AGGREGATION	Confirm or revise the selected service appointments. Or ask your admin to check the aggregation policies.
23	ERROR_IN_PROPAGATION	Confirm or revise the selected service appointments. Or ask your admin to check the propagation policies.
24	GET_POLICY_FAILURE	Ask your admin to check the bundle policies, then try again.
25	GET_CONFIG_FAILURE	Ask your admin to check the bundle config, then try again.
26	GET_BUNDLE_INFO_FAILURE	Try again later.
27	ERROR_IN_LOGIC	We couldn’t bundle the service appointments.
28	EMPTY_BUNDLE_MEMBERS	Add bundle member service appointments.
29	EMPTY_BUNDLE_PARENT_WORK_ORDER_ID	Add the work order ID for the bundle service appointment.
30	UNBUNDLE_REQUEST_ASSIGNED_RESOURCES_NOT_COMPATiBLE	To unbundle a scheduled bundle, send assigned resources for each service appointment.
31	EMPTY_OLD_VALUES	To update a bundle, send the current values.
32	EMPTY_NEW_VALUES	To update a bundle, send the new values.
33	SA_PAYLOAD_SHOULD_CONTAIN_AT_LEAST_ONE_ADD_OR_REMOVE_ACTION	To update a bundle, send at least one add or remove action.
34	FORBIDDEN_FIELDS_IN_POLICY_OBJECT	Confirm or revise the selected service appointments. Or ask your admin to check the field names selected in the related policies.
35	EMPTY_SERVICE_TERRITORY	Add a Service Territory ID.
36	EMPTY_START_TIME	Add the interval’s start time.
37	EMPTY_END_TIME	Add the interval’s end time.
38	ERROR_IN_BUNDLE_POLICY_RFC	Confirm or revise the selected service appointments. Or ask your admin to check the recordset filter criteria in the bundle policy.
39	ERROR_IN_TIME_ZONE_VALIDATION	Select service appointments that are in the same time zone. Or ask your admin for help.
40	ERROR_IN_LOGIC_UNBUNDLE	We couldn’t unbundle the service appointment.
41	ERROR_CREATING_BUNDLE	We couldn’t bundle the service appointments.
42	ERROR_ADDING_TO_BUNDLE	We couldn’t add the service appointment to the bundle.
43	ERROR_REMOVING_FROM_BUNDLE	We couldn’t remove the service appointment from the bundle.
44	ERROR_UNBUNDLING	We couldn’t unbundle the service appointment.
58	ERROR_IN_MSW_VALIDATIONS	We can’t bundle service appointments with dependencies. Remove the dependencies and try again.
-500	http error	Hmm… Something went wrong. Try again.

Field Service Developer Guide

Unbundle Multiple

Request Body

Example

Response Body

Example

Example