> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How does the Octopus integration work?

**Octopus** is one of the [accounting software packages](https://support.robaws.com/en/article/linking-your-accounting-software-to-robaws-1dheeh7/) that Robaws has a direct integration with.
Thanks to the API integration between Robaws and **Octopus**, these packages work together seamlessly.
You can prepare your entire bookkeeping from Robaws, so that it is taken over one to one in Octopus.

||| An integration with Octopus is chargeable: you pay an additional cost per integration you set up from Robaws. You can find the current prices on the [Robaws pricing page](https://robaws.com/en/price).

*Jump straight to:*
* [What you can do with Octopus](#2-what-you-can-do-with-octopus)
* [Activating the integration](#2-activating-the-integration)
* [Steps before first use](#2-steps-before-first-use)
* [Settings](#2-settings)
* [Exporting invoices to your accountant](https://support.robaws.com/en/article/sending-your-incoming-and-sales-invoices-to-the-accountant-1nskj7t/)
* [Syncing the payment status back to Robaws](https://support.robaws.com/en/article/how-a-payment-in-your-accounting-software-reaches-robaws-1s8ahoh/)
* [Cost centres and cost units](https://support.robaws.com/en/article/cost-centres-and-cost-bearers-m032im/)

## What you can do with Octopus

The integration between Robaws and Octopus supports a great deal, which makes using it very advantageous:

* [Export sales invoices and incoming invoices to Octopus](https://support.robaws.com/en/article/sending-your-incoming-and-sales-invoices-to-the-accountant-1nskj7t/)
* [Sync the payment status of sales invoices and incoming invoices back to Robaws](https://support.robaws.com/en/article/how-a-payment-in-your-accounting-software-reaches-robaws-1s8ahoh/)
* [Export cost centres to Octopus](https://support.robaws.com/en/article/cost-centres-and-cost-bearers-m032im/)

## Activating the integration

You activate the integration via **settings > integrations > Octopus**.
You go through the following steps:

1. Click on 'connect with Octopus'
2. Enter your Octopus credentials and click on 'connect'
3. After logging in, the option to choose a file appears

Once you have completed these steps, the integration between Robaws and Octopus is in place. You can now take the steps described below.

||| If you have several companies, you can set up a separate integration for each company individually by clicking on 'default' in the top left of the settings.

## Steps before first use

Once you have completed the steps above, the integration between Robaws and Octopus is in place. That does not mean you can export sales invoices and incoming invoices straight away.
Before you can use the integration, there are a few crucial steps left to complete:

1. [Importing GL accounts](#4-importing-gl-accounts)
2. [Linking VAT tariffs](#4-linking-vat-tariffs)
3. [Linking journals](#4-linking-journals)

#### Importing GL accounts

As soon as you have activated the integration with Octopus, you can import the GL accounts from Octopus into Robaws. You do this via settings > general > GL account and the **Import from accounting software** action button at the top.
After that, Robaws keeps this list up to date automatically through a daily synchronisation. You can also synchronise the GL accounts again manually at any time, using that same action button.

Once the GL accounts have been imported, you can link them at line level in your sales invoices and incoming invoices. When you export to Octopus, these GL accounts are sent along.
Do you not link a GL account at line level in the invoice? Then Robaws falls back on the default GL account from the Octopus [settings](#2-settings).

![Importing/synchronising GL accounts](https://storage.crisp.chat/users/helpdesk/website/-/e/a/d/f/eadf6dec760ec000/schermafbeelding-2025-12-16-om_1yokhvl.png =800x27)

#### Linking VAT tariffs

To be able to export invoices to Octopus, it is important that the VAT tariffs in Robaws are linked to the correct VAT tariffs in Octopus.
That way Robaws knows which VAT tariff to book on.
It is also important that the VAT tariffs for sales invoices and incoming invoices are split completely. Is that not the case at the moment? Then you will have to correct this in the settings first.

You link a VAT tariff as follows:

* Go to **settings > general > VAT tariffs**
* Open the VAT tariff in Robaws that you want to link to a VAT tariff from Octopus
* Click on the pencil next to 'Octopus'
* Look up the correct VAT tariff from Octopus and click on 'link'

#### Linking journals

In the Octopus settings you can enter default journals for sales and purchase. Do you not deviate from these? Then it is enough to set them in this place.
Do you want to link the Octopus journals to specific journals in Robaws? Then enter the Octopus journal code on the journal in Robaws, via settings > general > journals. This code overrides the default code from the settings.

## Settings

| Setting | Explanation |
| ---- |
| Default sales and purchase journal | Here you can set the default journal for sales invoices and incoming invoices. If you have several journals in Robaws, you can enter this code in the journal concerned in the settings. |
| Default sales and purchase GL account | Default GL account that is fallen back on for sales invoices or incoming invoices. You can assign a different GL account to a customer/supplier/item. You can also set a different GL account manually on an invoice line. |
| Default VAT tariff 0% for sales and purchase | You set the default VAT tariff of 0% via the module settings: under settings > customers for sales and under settings > suppliers for purchase. This is used, among other things, to include financial discounts in the lines. |
| [Sync payment status of sales invoices and incoming invoices](/en/article/how-a-payment-in-your-accounting-software-reaches-robaws-1s8ahoh/) | Here you can set whether you want the payment status for sales invoices or incoming invoices to be synchronised from Octopus to Robaws. |
| Use [cost centres](/en/article/cost-centres-and-cost-bearers-m032im/) for invoice and incoming invoice | Using the projects as cost centres in Octopus. |

|| **Octopus** is an external partner of Robaws. Do you have a question about Octopus itself — for example about your file, your journals or the settings within Octopus? Then contact [Octopus support](https://www.octopus.be/nl/support/).