Before you begin
Watchdog reads Compello through the Compello GraphQL API, using an application your organization creates in the Visma Developer Portal. You need:- the application’s Client ID and Client secret
- your Visma Tenant ID
- the Compello companies you want to import, for example
SFandSC - the Compello document types that are invoices and credit notes, for example
IFandKN
For the Visma administrator
- In the Visma Developer Portal, create a Service application for Watchdog.
- Request the Compello GraphQL API integration for the application, with the scope Read data via the GraphQL API.
- Wait for Compello support to approve the request.
- Generate a client secret for the application. Note its expiry date: replace the secret in Watchdog before it expires.
Connect in Watchdog
- Open Integrations → Compello and add a connection.
- Enter the Client ID, Client secret and Tenant ID.
- Add each document type that should be imported as an invoice or credit note. Leave out reminders, miscellaneous vouchers and duplicates.
- Select Test Connection, then save the connection.
- Select the companies to import under Data → Import invoices. While invoice import is off, the company accounting data reads is under Data → Accounting data.
Invoices without a file
Compello does not keep an original file for every document. Scanned documents in particular often have only page images. Watchdog skips an invoice that has no file in Compello. The nightly sync tries again for a month after Compello received the invoice, so it is imported once Compello has a file. For older invoices, run a manual sync for their invoice dates.If the connection does not work
- Invalid credentials: check the Client ID, Tenant ID and client secret, and that the secret has not expired.
- Permission denied: the application is not yet approved for the Compello GraphQL API. Ask Compello support.
- Document type not found: compare the codes with Compello. The error lists the document types Compello has.