Skip to main content
Connect Compello to import invoices and credit notes with their original files: the EHF (Peppol BIS Billing 3.0) when Compello has one, otherwise the supplier’s PDF. Watchdog only reads from Compello and never changes documents there.

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 SF and SC
  • the Compello document types that are invoices and credit notes, for example IF and KN

For the Visma administrator

  1. In the Visma Developer Portal, create a Service application for Watchdog.
  2. Request the Compello GraphQL API integration for the application, with the scope Read data via the GraphQL API.
  3. Wait for Compello support to approve the request.
  4. Generate a client secret for the application. Note its expiry date: replace the secret in Watchdog before it expires.
Then send the Client ID, Tenant ID and client secret securely to the person setting up the connection.

Connect in Watchdog

  1. Open Integrations → Compello and add a connection.
  2. Enter the Client ID, Client secret and Tenant ID.
  3. Add each document type that should be imported as an invoice or credit note. Leave out reminders, miscellaneous vouchers and duplicates.
  4. Select Test Connection, then save the connection.
  5. Select the companies to import under Data → Import invoices. While invoice import is off, the company accounting data reads is under Data → Accounting data.
Without a company filter, Watchdog imports from every company the application can read, including test and demo companies. Select the companies before you turn on automatic sync. The connection test checks that every document type exists in Compello. It shows a warning, not an error, when recent documents have no file yet.

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.