Onboarding

Learn about how Monite manages compliance and e-invoicing in supported countries.

Entity onboarding for e-invoicing

To enable an entity to use Monite e-invoicing, you have to onboard this entity. The onboarding process consists of providing a set of required information that will allow the entity issue e-invoices. To onboard an entity, send a POST request to the /einvoicing_connections endpoint:

1curl -X POST 'https://api.sandbox.monite.com/v1/einvoicing_connections' \
2     -H 'X-Monite-Version: 2024-05-25' \
3     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4     -H 'Authorization: Bearer ACCESS_TOKEN' \
5     -H 'Content-Type: application/json' \
6     -d '{
7        "address": {
8            "address_line1": "Flughafenstrasse 52",
9            "address_line2": "Additional information",
10            "city": "Berlin",
11            "country": "DE",
12            "postal_code": "10115",
13            "state": "BE"
14        },
15        "entity_vat_id_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
16    }'

The successful response contains the information of the recently created connection:

1{
2    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3    "created_at": "2025-01-06T10:12:52.746Z",
4    "updated_at": "2025-01-06T10:12:52.746Z",
5    "address": {
6        "address_line1": "Flughafenstrasse 52",
7        "address_line2": "Additional information",
8        "city": "Berlin",
9        "country": "DE",
10        "postal_code": "10115",
11        "state": "BE"
12    },
13    "credentials": [
14        {
15            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
16            "created_at": "2025-01-10T07:12:00.084Z",
17            "updated_at": "2025-01-10T07:12:00.084Z",
18            "einvoicing_connection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
19            "network_credentials_identifier": "12345678",
20            "network_credentials_schema": "NL:KVK"
21        }
22    ],
23    "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
24    "legal_name": "Dare Cronin Gmbh.",
25    "provider_id": "12345",
26    "status": "active"
27}

The entity_vat_id_id is optional. When informed during the request, the system automatically fills the fields network_credentials_identifier and network_credentials_schema with the data found in Monite database.

After completing the onboarding process, the entity will start to automatically receive the e-invoices directly into the accounts payable. These e-invoices will be processed into payables with the payable_origin field set to einvoicing, indicating they were received via the e-invoicing system. For credit notes, the document’s origin is specified in the origin field.

Add new credentials

You can add new credentials by sending a POST request to the /einvoicing_connections/{einvoicing_connection_id}/network_credentials endpoint:

1curl -X POST 'https://api.sandbox.monite.com/v1/einvoicing_connections/{einvoicing_connection_id}/network_credentials' \
2     -H 'X-Monite-Version: 2024-05-25' \
3     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4     -H 'Authorization: Bearer ACCESS_TOKEN' \
5     -H 'Content-Type: application/json' \
6     -d '{
7        "network_credentials_identifier": "12345678",
8        "network_credentials_schema": "NL:KVK"
9     }'

The successful response contains information about the added credential:

1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "created_at": "2025-01-09T10:14:51.909Z",
4  "updated_at": "2025-01-09T10:14:51.909Z",
5  "einvoicing_connection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6  "network_credentials_identifier": "12345678",
7  "network_credentials_schema": "NL:KVK"
8}

Monite does not validate the values inserted in the fields network_credentials_identifier and network_credentials_schema.

List all connections

You can retrieve all currrently established connections of an entity by sending a GET request to the /einvoicing_connections endpoints.

Retrieve a connecton

To retrieve a specific connection by ID, send a GET request to the /einvoicing_connections/{einvoicing_connection_id} endpoint.

Delete a connection

To delete a connection, send a DELETE request to the /einvoicing_connections/{einvoicing_connection_id} endpoint.