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. |