Error codes
The server only sends a code to the pane; the pane shows the matching text in the user's language. This page is for administrators and the helpdesk: from the title shown, find the code, its cause and what to check. The version for users is Error messages and solutions.
The texts can be customized (see Customizing the panel texts): the titles below are the original ones.
Error pages
These errors prevent the pane from being used: it shows a "Sorry, unable to continue" page.
Document and system
| Code | Title shown | Cause | What to check |
|---|---|---|---|
MISSING_DOC_PROPERTIES | Document not recognized | The document has no S2E_SystemKey property. | Does the document come from the target system? See Preparing Word documents. |
UNKNOWN_SYSTEM | Unknown system | The document's system is not declared in the .env. | The value of S2E_SystemKey and the system's block in the .env (see .env variables). |
INVALID_SYSTEM | System misconfigured | The system is declared, but a variable is missing or invalid (environment, path, timeout, icon…). | The logs at startup, which give the cause. |
SYSTEM_MISMATCH | System change detected | The document targets another system than the one of the current session. | Normal behavior: the user signs out to change system. |
CANNOT_READ_CUSTOM_PROPERTIES | An error occurred | Word could not read the document properties. | Close and reopen the pane; update Word. |
Sign-in
| Code | Title shown | Cause | What to check |
|---|---|---|---|
UNAUTHORIZED | Session expired | Expired or invalid session. | The user signs in again. If it keeps happening: OAUTH_COOKIE_MAXAGE, and the token lifetime in the target system. |
SYSTEM_UNAVAILABLE | The target system is temporarily unavailable | The target system does not answer when the pane opens. The session is kept. | The Save2ERP server's access to the target system (network, firewall, certificate); SAP_CALL_TIMEOUT_MS. |
LOGIN_FAILED | Sign-in failed | The OAuth2 sign-in did not succeed (message shown on the sign-in page). | The logs; the OAuth2 client (ID, secret, redirect URI, scope). |
COOKIES_BLOCKED | Cookies blocked | Word on the web: the browser blocks third-party cookies. | The browser's settings or policies (see Cookies). |
License
| Code | Title shown | Cause | What to check |
|---|---|---|---|
LICENSE_MISSING | License missing | No license file on the server. | LICENSE_FILE and whether the file is there. |
LICENSE_INVALID | Invalid license | The file was modified, was not issued by Swiss Computing, or cannot be read. | The logs at startup; reinstall the file you received. |
LICENSE_EXPIRED | License expired | The end of validity date has passed. | Renew the license (see Installing and renewing the license). |
LICENSE_MAX_USERS_REACHED | Maximum number of users reached | All licenses are assigned to active users. | Wait for a seat to be freed (30 days of inactivity) or order more licenses. |
LICENSE_TENANT_MISMATCH | Organization not covered | The user's Microsoft account does not belong to the license's organization. | Is the user signed in to Word with their work account? |
LICENSE_IDENTITY_UNAVAILABLE | Identity verification failed | The pane could not get the Microsoft identity (Office too old, sign-in cancelled, personal account…). | The Office version; the admin consent (see Deploying in Microsoft 365). |
LICENSE_IDENTITY_INVALID | Identity rejected | The Microsoft token was rejected, or the server could not verify it. | The logs; if "Microsoft unreachable from the server", the server's access to login.microsoftonline.com. |
Messages while sending
These errors are shown in red below the buttons; the pane stays usable.
| Code | Title shown | Cause | What to check |
|---|---|---|---|
FILE_ALREADY_EXISTS | Duplicate detected (choice page) | A file with the same name already exists in the object. | Normal behavior (see API contract). |
DOCUMENT_TOO_LARGE | Document too large | The document exceeds the accepted size (about 37 MB). | Reduce the document; check the size accepted by a proxy, if any. |
SYSTEM_ERROR | Target system error | The target system answered with a technical error (5xx) or an unexpected response. | The Save2ERP logs, then those of the target system. |
SYSTEM_UNAVAILABLE | The target system is temporarily unavailable | No response within the configured timeout. | As above, for opening the pane. |
UNAUTHORIZED | Session expired | The session expired and could not be renewed. | The user signs in again. |
| Target system code | Save failed, with the target system's message | Functional error returned by the target system (locked object, insufficient permissions…). | The message shown, which comes from the target system. |
| — | Designer mode active | The document shows the tag labels (S2E_LabelsShown property). | Exit designer mode before saving (see Preparing Word documents). |
Designer mode messages
These errors are shown in red below the buttons, after a click on the designer mode icon or on "Exit designer mode".
| Code | Title shown | Cause | What to check |
|---|---|---|---|
| — | Incomplete document | S2E_TemplateId missing, or S2E_ObjectType / S2E_ObjectKey missing to return to the values. | The document properties (see Preparing Word documents). |
| — | Template not recognised | The document does not have the XML part (namespace and root) of the XML returned by the target system. | The Word template and the S2E_TemplateId ID. |
DESIGNER_MODE_NOT_SUPPORTED | Designer mode unavailable | The target system does not provide the template service. | The service and its path (SAP_TEMPLATE_PATH). |
SYSTEM_ERROR | Target system error | Technical error of the target system, or XML returned unreadable or without a namespace. | The Save2ERP logs (or the pane console for the XML), then those of the target system. |
| Target system code | Display change failed, with the target system's message | Refused by the target system: designer permission, access to the object, unknown template… | The message shown, which comes from the target system. |
Test page
On the /test page, a failed test shows "Test failed" with the HTTP status and the error detail; "Server unreachable" means that the Save2ERP server itself did not answer. The details are in the logs (see Troubleshooting).