How Do I Resolve Errors From the Service?

If you attempt an operation with the Excel add-in but the service returns an error, review the resolution steps for the error code.

Refer to HTTP response status codes for more information.

Error Typical Cause Resolution Steps
(401) Unauthorized The service does not accept the credentials sent by the add-in. - Verify login credentials and active session.
- Use Network Monitor to confirm which endpoint returned 401.
- Verify the workbook’s authentication method and token flow.
(403) Forbidden The authenticated user is not authorized for the operation. - Use Network Monitor to identify the exact request that failed.
- Save the failing request/response details.
- Work with the service team to verify required roles, data access policies, and operation-level privileges.
(400) Bad Request The request format or values are not accepted by the service. - For download operations, 400 responses are reported in Status Viewer as a failed download with error details (instead of an unexpected exception dialog).
- Inspect the failing request and response payload in Network Monitor.
- Validate workbook configuration for required fields, field types, and expressions.
- Confirm service-specific requirements with the REST service owner (required attributes, valid ranges, and request shape).
(500) Internal Server Error
May also appear as VBAFE-00109.
The service failed while processing a valid request. - Capture the failing request/response with Network Monitor.
- Share the capture with the service team and request server log correlation by timestamp/request ID.
- Retry only after the service team confirms remediation.
(404) Not Found The target endpoint URL is not valid for the deployed service. - Use Network Monitor to identify the failing URL.
- Verify service base URL, path parameters, and business object paths in workbook configuration.
- If needed, update the catalog/workbook configuration. See Manage Catalogs and Business Objects.
- If using Fusion Applications, avoid login-host URLs for REST calls; use the host from the application welcome page.