Xledger integration

Cardboard offers an integration to Xledger so that the payments and receipts can be pushed from Cardboard to Xledger with one click. This document explains how to set this up and configure the accounting part of Cardboard.

Create Xledger API key

Create an API-key in Xledger to be entered into Cardboard:

1. First, make sure that you have selected "Administrator", not "Accounting Assistant" (Regnskapsassistent), as the current role by selecting it in the role menu in the top right corner.
2. From the top menu, navigate to "Administration" (Administrasjon) > "System Access" (Tilgangskontroll) > "GraphQL" > "API Tokens".
3. Press the green button labeled "Generate new token" and select the following permissions:
   1. Read:
      Common: Currency, ObjectKind, ObjectValue, and Supplier.
      General Ledger: Account and GLImportItem.
      Project management: Project.
   2. Write:
      General Ledger: GLImportItem.

Enter API key into Cardboard

In Cardboard, navigate to Accounting > Settings > Integration. Press the button labeled "Connect to Xledger".

Proceed by entering your newly created API key into the form and press the "Connect to Xledger" button.

Configure Cardboard for accounting

Before pushing payments and receipts from Cardboard to Xledger, you should tell Cardboard how you would like to do your accounting. This includes aspects such as setting supplier numbers for each of your services, the ledger account for your Cardboard assets account, and so on. You can read more about it here.

Here are how Cardboard's accounting settings maps to accounting dimensions in Xledger:

• Department → GL Object 1 (cost center).
• Business unit → GL Object 3.
• Sub unit: GL Object 4.
• Project → Project.

Push payments and receipts to Xledger

Navigate to "Accounting" > "Export" and select the month you would like to do accounting for. Scroll down to the "Ready" section and either...

1. Press the "Push to Xledger" button on the top right in order to push all payments that are ready for export.
2. Press the smaller upward-facing arrow on each single line in order to push a single payment/receipt pair to Xledger.

Payments that are not ready for export will not be exported until they are ready. Reasons for not being ready are...

1. The payment is missing a receipt.
2. The supplier number has not been specified for the subscription.
3. The payment is still reserved and has not been captured by the service provider.

Find payments in Xledger

Select "Voucher Import" (Bilagsimport) from "Task List" (Oppgaveliste) from the left side menu. If this option is not available in your side menu, make sure that you have selected "Accounting Assistant" as the current role in the top right drop-down menu and refresh your browser.

Press the "Find" button in the top left and each exported payment should appear four individual GL records. These can be inspected manually before being posted to your general ledger. When you are ready, select all postings and press "Ready to Process".