E-Invoicing

E-Invoicing

Send invoices electronically via the Peppol network. Requires supplier onboarding (KYC) before documents can be sent. Currently powered by Flowin (Wolters Kluwer).

Endpoints

IntroductionPOST/e-invoicing/supplierPOST/e-invoicing/customer-searchPOST/e-invoicing/send/:documentType/:documentIdPOST/e-invoicing/submissions/:id/retryPOST/e-invoicing/webhooks/flowinGET/e-invoicing/settingsGET/e-invoicing/supplierGET/e-invoicing/submissionsGET/e-invoicing/submissions/:idPATCH/e-invoicing/settingsPATCH/e-invoicing/supplier

The E-Invoicing object

object

Attributes

idstring

Other attributesExpand all

entity_idstring

environmentstring

flowin_supplier_idstring

providerstring

statusstring

reject_reasonstring

peppol_registeredboolean

peppol_participant_idstring

peppol_scheme_idstring

company_namestring

vat_numberstring

company_numberstring

ibanstring

addressstring

citystring

post_codestring

country_codestring

contact_emailstring

contact_phonestring

kyc_id_document_urlstring

kyc_business_register_urlstring

metadataobject

onboarded_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

---

Register supplier

POST/e-invoicing/supplier

Register the entity as an e-invoicing supplier with Flowin. This starts the KYC/onboarding process.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

company_namestringrequired

Legal company name as registered

country_codestringrequired

ISO 3166-1 alpha-2 country code

Other parametersExpand all

vat_numberstringoptional

company_numberstringoptional

ibanstringoptional

addressstringoptional

citystringoptional

post_codestringoptional

contact_emailstring<email>optional

contact_phonestringoptional

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/e-invoicing/supplier" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme SAS",
    "vat_number": "FR12345678901",
    "company_number": "12345678901234",
    "iban": "FR7630006000011234567890189",
    "address": "123 Rue de la Paix",
    "city": "Paris",
    "post_code": "75001",
    "country_code": "FR",
    "contact_email": "billing@acme.fr",
    "contact_phone": "+33612345678"
  }'

Response

Returns

idstring

Other parametersExpand all

entity_idstring

environmentstring

flowin_supplier_idstring

providerstring

statusstring

reject_reasonstring

peppol_registeredboolean

peppol_participant_idstring

peppol_scheme_idstring

company_namestring

vat_numberstring

company_numberstring

ibanstring

addressstring

citystring

post_codestring

country_codestring

contact_emailstring

contact_phonestring

kyc_id_document_urlstring

kyc_business_register_urlstring

metadataobject

onboarded_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sup_1234567890",
  "entity_id": "ent_1234567890",
  "environment": "sandbox",
  "flowin_supplier_id": "fl_sup_abc123",
  "provider": "flowin",
  "status": "pending",
  "peppol_registered": false,
  "company_name": "Acme SAS",
  "vat_number": "FR12345678901",
  "company_number": "12345678901234",
  "country_code": "FR",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T10:00:00.000Z"
}

---

Search Peppol customer

POST/e-invoicing/customer-search

Check if a recipient is registered on the Peppol network and can receive e-invoices.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

peppol_idstringrequired

Peppol participant ID to search for

scheme_idstringrequired

Peppol scheme ID

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/e-invoicing/customer-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "peppol_id": "98765432109876",
    "scheme_id": "0009"
  }'

Response

Returns

dataarray of objectsShow child attributes

json

Copy

{
  "data": [
    {
      "peppol_id": "98765432109876",
      "scheme_id": "0009",
      "name": "Client Corp SARL",
      "country_code": "FR",
      "registered": true
    }
  ]
}

---

Send e-invoice

POST/e-invoicing/send/:documentType/:documentId

Send a document as an e-invoice via the Peppol network. Generates UBL XML and submits to Flowin.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

documentTypestringrequired

Type of document to send

Possible values: "invoice", "credit_note"

documentIdstringrequired

Document ID

Body parameters

recipient_peppol_idstringrequired

Recipient's Peppol participant ID

recipient_scheme_idstringrequired

Recipient's Peppol scheme ID

Other parametersExpand all

recipient_namestringoptional

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/e-invoicing/send/:documentType/:documentId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_peppol_id": "0009:98765432109876",
    "recipient_scheme_id": "0009",
    "recipient_name": "Client Corp SARL"
  }'

Response

Returns

idstring

Other parametersExpand all

entity_idstring

supplier_idstring

environmentstring

document_idstring

document_typestring

flowin_document_idstring

transmission_idstring

recipient_peppol_idstring

recipient_scheme_idstring

recipient_namestring

statusstring

error_messagestring

metadataobject

submitted_atstring<date-time>

delivered_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sub_1234567890",
  "entity_id": "ent_1234567890",
  "document_id": "inv_1234567890",
  "document_type": "invoice",
  "status": "submitted",
  "recipient_peppol_id": "0009:98765432109876",
  "recipient_name": "Client Corp SARL",
  "submitted_at": "2026-03-01T10:00:00.000Z",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T10:00:00.000Z"
}

---

Retry failed submission

POST/e-invoicing/submissions/:id/retry

Retry a failed or rejected e-invoice submission.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

idstring<resource-id>required

Unique resource identifier

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/e-invoicing/submissions/:id/retry" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"

Response

Returns

idstring

Other parametersExpand all

entity_idstring

supplier_idstring

environmentstring

document_idstring

document_typestring

flowin_document_idstring

transmission_idstring

recipient_peppol_idstring

recipient_scheme_idstring

recipient_namestring

statusstring

error_messagestring

metadataobject

submitted_atstring<date-time>

delivered_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sub_1234567890",
  "entity_id": "ent_1234567890",
  "document_id": "inv_1234567890",
  "document_type": "invoice",
  "status": "submitted",
  "recipient_peppol_id": "0009:98765432109876",
  "recipient_name": "Client Corp SARL",
  "submitted_at": "2026-03-01T11:00:00.000Z",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T11:00:00.000Z"
}

---

Flowin webhook receiver

POST/e-invoicing/webhooks/flowin

Internal endpoint for receiving status updates from Flowin. Not intended for direct API use.

Request

Body parameters

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/e-invoicing/webhooks/flowin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "submission.status_changed",
    "submission_id": "fl_sub_abc123",
    "status": "delivered",
    "timestamp": "2026-03-01T10:05:00.000Z"
  }'

---

Get e-invoicing settings

GET/e-invoicing/settings

Get the current e-invoicing settings for the entity.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/e-invoicing/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"

Response

Returns

enabledboolean

providerstring

auto_sendboolean

default_scheme_idstring

json

Copy

{
  "enabled": true,
  "provider": "flowin",
  "auto_send": false,
  "default_scheme_id": "0009"
}

---

Get supplier status

GET/e-invoicing/supplier

Get the current e-invoicing supplier onboarding status for this entity.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/e-invoicing/supplier" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"

Response

Returns

idstring

Other parametersExpand all

entity_idstring

environmentstring

flowin_supplier_idstring

providerstring

statusstring

reject_reasonstring

peppol_registeredboolean

peppol_participant_idstring

peppol_scheme_idstring

company_namestring

vat_numberstring

company_numberstring

ibanstring

addressstring

citystring

post_codestring

country_codestring

contact_emailstring

contact_phonestring

kyc_id_document_urlstring

kyc_business_register_urlstring

metadataobject

onboarded_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sup_1234567890",
  "entity_id": "ent_1234567890",
  "environment": "sandbox",
  "flowin_supplier_id": "fl_sup_abc123",
  "provider": "flowin",
  "status": "active",
  "peppol_registered": true,
  "company_name": "Acme SAS",
  "vat_number": "FR12345678901",
  "company_number": "12345678901234",
  "country_code": "FR",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T12:00:00.000Z",
  "onboarded_at": "2026-03-01T11:00:00.000Z"
}

---

List submissions

GET/e-invoicing/submissions

List e-invoice submissions with pagination.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Query parameters

limitintegeroptional

Number of results per request.

Default: 10

next_cursorstringoptional

Cursor to fetch the next page of results. Use the value from pagination.next_cursor in the previous response.

prev_cursorstringoptional

Cursor to fetch the previous page of results. Use the value from pagination.prev_cursor in the previous response.

include_total_countbooleanoptional

Whether to include the total count of items in pagination.total.
Default is true.
When false, pagination.total returns -1 for better performance.

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/e-invoicing/submissions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"

Response

Returns

dataarray of objectsShow child attributes

paginationobjectShow child attributes

Pagination metadata including cursors and result counts

json

Copy

{
  "data": [
    {
      "id": "einv_sub_1234567890",
      "entity_id": "ent_1234567890",
      "document_id": "inv_1234567890",
      "document_type": "invoice",
      "status": "delivered",
      "recipient_peppol_id": "0009:98765432109876",
      "recipient_name": "Client Corp SARL",
      "submitted_at": "2026-03-01T10:00:00.000Z",
      "delivered_at": "2026-03-01T10:05:00.000Z",
      "created_at": "2026-03-01T10:00:00.000Z",
      "updated_at": "2026-03-01T10:05:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

---

Get submission detail

GET/e-invoicing/submissions/:id

Get detailed submission status including UBL XML.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

idstring<resource-id>required

Unique resource identifier

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/e-invoicing/submissions/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"

Response

Returns

idstring

Other parametersExpand all

entity_idstring

supplier_idstring

environmentstring

document_idstring

document_typestring

flowin_document_idstring

transmission_idstring

recipient_peppol_idstring

recipient_scheme_idstring

recipient_namestring

statusstring

error_messagestring

ubl_xmlstring

metadataobject

submitted_atstring<date-time>

delivered_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sub_1234567890",
  "entity_id": "ent_1234567890",
  "document_id": "inv_1234567890",
  "document_type": "invoice",
  "status": "delivered",
  "recipient_peppol_id": "0009:98765432109876",
  "recipient_name": "Client Corp SARL",
  "ubl_xml": "...",
  "submitted_at": "2026-03-01T10:00:00.000Z",
  "delivered_at": "2026-03-01T10:05:00.000Z",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T10:05:00.000Z"
}

---

Update e-invoicing settings

PATCH/e-invoicing/settings

Update e-invoicing settings for the entity. Only sandbox entities can enable e-invoicing unless live mode is explicitly enabled.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

enabledbooleanoptional

auto_sendbooleanoptional

default_scheme_idstringoptional

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X PATCH "https://eu.spaceinvoices.com/e-invoicing/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_send": true
  }'

Response

Returns

enabledboolean

providerstring

auto_sendboolean

default_scheme_idstring

json

Copy

{
  "enabled": true,
  "provider": "flowin",
  "auto_send": true,
  "default_scheme_id": "0009"
}

---

Update supplier data

PATCH/e-invoicing/supplier

Update supplier onboarding data (company details). Only allowed before onboarding is complete.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

company_namestringoptional

vat_numberstringoptional

company_numberstringoptional

ibanstringoptional

addressstringoptional

citystringoptional

post_codestringoptional

country_codestringoptional

contact_emailstring<email>optional

contact_phonestringoptional

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X PATCH "https://eu.spaceinvoices.com/e-invoicing/supplier" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme SAS Renamed"
  }'

Response

Returns

idstring

Other parametersExpand all

entity_idstring

environmentstring

flowin_supplier_idstring

providerstring

statusstring

reject_reasonstring

peppol_registeredboolean

peppol_participant_idstring

peppol_scheme_idstring

company_namestring

vat_numberstring

company_numberstring

ibanstring

addressstring

citystring

post_codestring

country_codestring

contact_emailstring

contact_phonestring

kyc_id_document_urlstring

kyc_business_register_urlstring

metadataobject

onboarded_atstring<date-time>

created_atstring<date-time>

updated_atstring<date-time>

json

Copy

{
  "id": "einv_sup_1234567890",
  "entity_id": "ent_1234567890",
  "environment": "sandbox",
  "flowin_supplier_id": "fl_sup_abc123",
  "provider": "flowin",
  "status": "pending",
  "peppol_registered": false,
  "company_name": "Acme SAS Renamed",
  "vat_number": "FR12345678901",
  "company_number": "12345678901234",
  "country_code": "FR",
  "created_at": "2026-03-01T10:00:00.000Z",
  "updated_at": "2026-03-01T13:00:00.000Z"
}

---