Skip to content

Requirements ​

Files provided by Swiss Computing ​

FilePurpose
ZIP archive of the application, or Docker imageThe Save2ERP server (see Production installation).
license.licYour 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, unless COOKIE_PREFIX is used (see .env variables).
  • A service account that can read the application folder and write to its logs/ and data/ folders.
  • A single instance per customer: with a limited license, the user register is a local file.

Network ​

FromToWhy
Users' computers (Word)Save2ERP server, over HTTPSPane pages and document upload.
Users' computersTarget system's OAuth2 serverUser sign-in window.
Save2ERP serverTarget system's OAuth2 server and REST APITokens and document upload.
Save2ERP serverlogin.microsoftonline.comMicrosoft 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 ​

RequirementApplies to
Word for Windows, Mac or the web, with a Microsoft 365 work accountAll 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 IDLimited license (see Deploying in Microsoft 365).

Word for the web only works if the browser accepts third-party cookies:

BrowserWord for the web
Chrome, EdgeWorks with the default settings. Blocked in private browsing, if the user blocks third-party cookies, or by a company policy (BlockThirdPartyCookies).
SafariNot supported: third-party cookies blocked by default.
FirefoxNot supported: third-party cookies partitioned by default.

Word for Windows and Mac are not affected.