Requirements
Files provided by Swiss Computing
| File | Purpose |
|---|---|
| ZIP archive of the application, or Docker image | The Save2ERP server (see Production installation). |
license.lic | Your company's license (see Installing and renewing the license). |
Manifest (.xml) | Declares the add-in in Microsoft 365, with the address of your server (see Deploying in Microsoft 365). |
Server
- Node.js 22.15 or later, on Windows or Linux. Or Docker: the image already contains Node.js.
- HTTPS with a valid certificate: Word refuses an add-in served over HTTP or with an untrusted certificate. The server can handle its certificate itself, or run behind an HTTPS proxy (see Behind an HTTPS proxy).
- A dedicated host name, for example
save2erp.my-company.com. Two Save2ERP servers must not share the same host name, unlessCOOKIE_PREFIXis used (see .env variables). - A service account that can read the application folder and write to its
logs/anddata/folders. - A single instance per customer: with a limited license, the user register is a local file.
Network
| From | To | Why |
|---|---|---|
| Users' computers (Word) | Save2ERP server, over HTTPS | Pane pages and document upload. |
| Users' computers | Target system's OAuth2 server | User sign-in window. |
| Save2ERP server | Target system's OAuth2 server and REST API | Tokens and document upload. |
| Save2ERP server | login.microsoftonline.com | Microsoft identity check (limited license only). |
If the target system uses a certificate issued by an internal authority, the Save2ERP server must trust it: with Docker, see Docker.
Target system
The target system team must provide:
- an OAuth2 client registered for Save2ERP, with the server's redirect URI (
https://<server>/auth/callback), its ID, its secret and the scope to request; - the REST services that check and save attachments, as described in the API contract;
- Word documents that carry the Save2ERP properties (see Preparing Word documents).
Microsoft 365 and Word
| Requirement | Applies to |
|---|---|
| Word for Windows, Mac or the web, with a Microsoft 365 work account | All users. |
Support for nested app authentication (NestedAppAuth 1.1 API set) | Licenses limited by number of users. Otherwise, the pane shows "Identity verification failed". |
WordApi 1.3 API set | "Open a copy" button, hidden on older versions. |
| Admin consent to the Save2ERP application in Microsoft Entra ID | Limited license (see Deploying in Microsoft 365). |
Word for the web only works if the browser accepts third-party cookies:
| Browser | Word for the web |
|---|---|
| Chrome, Edge | Works with the default settings. Blocked in private browsing, if the user blocks third-party cookies, or by a company policy (BlockThirdPartyCookies). |
| Safari | Not supported: third-party cookies blocked by default. |
| Firefox | Not supported: third-party cookies partitioned by default. |
Word for Windows and Mac are not affected.