Search
Getting Started Invoice sending Invoice sending Consumer Invoicing Printing Email invoicing Invoice Receiving Invoice Receiving Scanning Detect Fraud reporting Integration tools Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Invoicing formats Validation Peppol BIS 3.0 Preview Maventa JSON (table) Preview Maventa JSON (json schema) Account Management Companies and Settings Department Company Users Billing

Department Company

Department Company lets organisations with multiple physical locations or subsidiaries register and manage them as separate accounts while keeping a single parent company registration. Each department operates as its own account with a unique electronic invoicing address (endpoint), while sharing the parent company’s Business Identifier (BID).

This works well for retail chains, schools, municipalities, and logistics companies that need to route invoices to specific locations independently.

The feature is currently in pilot phase and available for approved vendors only. To enable this feature for your vendor, contact Maventa support.

What are Department Companies?

Department Companies are subsidiary accounts created under a parent company. They share the same BID or VAT number with the parent, but have unique electronic address identifiers — specifically Global Location Numbers (GLN) — for routing invoices.

Key characteristics

Departments vs multiple endpoints

How to register departments

Prerequisites

Registration process

  1. Register the parent company with a valid Business Identifier (see Companies and Settings)
  2. Create departments using the REST API
  3. Provide the department name and unique GLN endpoint
  4. For Peppol connectivity, contact Maventa support to register the GLN endpoints

API endpoint

For detailed API documentation, refer to the Swagger documentation

GLN validation

When registering departments, Maventa validates GLN numbers by cross-referencing with the GS1 registry. You can verify GLN ownership beforehand using the Verified by GS1 service

Validate all GLN numbers against GS1 before registration. GLNs may be owned by parent companies but allocated to subsidiaries — collect complete GLN details upfront to avoid delays.

Department account details

Vendor linking

Departments are automatically linked to the creating vendor. If a department needs a different vendor than the parent company, link that vendor to the department account separately after creation.

Invoice routing

Invoices sent to departments must include the correct GLN endpoint in the invoice XML. Maventa’s routing system uses both the BID and the GLN to route invoices to the correct accounts.

Disabling departments

A parent company cannot be disabled while it has active departments. All department accounts must be disabled first. Contact Maventa support for disabling an account.

Service support matrix

Not all Maventa services are available for department accounts.

Sending

Service Supported Notes
Internal Routing Yes Invoices can be sent between Maventa accounts
Operator Network Yes Operator networks supported
Peppol Yes Peppol network supported
Print Yes Works out of the box
B2C (FI/NO/SE) Maybe Depends on the endpoint ID type

Receiving

Service Supported Notes
Internal Routing Yes Receive invoices from internal Maventa accounts
Operator Network Yes Operator network supported
Peppol Yes* Requires manual GLN validation before Peppol registration; automated validation in development
Scanning Maybe Depends on the company country
Detect Yes Fraud detection supported

*Peppol registration for departments must be arranged with Maventa support. See Peppol registration for departments below.

Peppol registration for departments

Departments can be registered to Peppol, but the process currently requires manual validation of the GLN endpoints by Maventa.

Registration process

  1. Create department accounts through the API
  2. Contact Maventa support with the list of GLN numbers requiring Peppol registration
  3. Maventa validates the GLNs and registers them to Peppol
  4. You’ll receive confirmation once registration is complete

Automated validation of GLNs is in development. Once available, departments will be able to register to Peppol directly through the REST API without manual intervention.

Limitations

Best practices

Test before going to production

  • Test thoroughly in the staging environment with sample GLNs
  • Verify Peppol functionality works as expected before enabling in production
  • Confirm all required services are available for your use case
  • Validate GLN numbers against the GS1 registry

Communicate with your customers

  • Clearly explain whether departments or multiple endpoints are right for their situation
  • Document the expected number of departments before registration
  • Set clear expectations about Peppol registration timelines

Manage GLN numbers carefully

  • Validate all GLN numbers against GS1 before submitting for Peppol registration
  • GLNs may be owned by parent companies but allocated to subsidiaries
  • Collect complete GLN details upfront to reduce back-and-forth communication

FAQ

What’s the difference between departments and multiple endpoints?

Departments create separate Maventa accounts with individual inboxes and separate management. Multiple endpoints register different GLNs to a single company account, with all invoices arriving in one inbox. Use departments if you need operational separation; use multiple endpoints if you just need invoice routing differentiation.

Can departments have departments?

No. The feature only supports two levels: parent company and departments. Departments cannot have their own departments.

Do departments go through KYC verification?

No. Departments are automatically trusted based on the parent company’s verification status. They don’t require separate KYC processing.

Can departments use different vendors?

Yes. While departments share the parent’s BID, they can be linked to different vendors than the parent company. Vendor linking must be handled separately after department creation.

What happens if I disable the parent company?

A parent company cannot be disabled if it has active departments. All departments must be disabled first.

Are there charges for using departments?

No. Departments don’t have separate pricing. Your existing pricing and contract terms apply as usual.

Back to top

AI Chat Support 24/7

  • Get help via AI chat available 24/7 whenever it suits you
  • Chat extensively uses Maventa support pages, websites, and blogs in its answers
  • If you need assistance that the AI cannot provide, you can also ask a customer service agent to join the conversation
  • Support requests processed Monday to Friday
Cancel Open chat

Got feedback?

Did you not find what you were looking for? Or was something explained unclearly? Or just want to share your thoughts? We are happy to hear your feedback!

Note: This form is not a way to get support, this is only for feedback for the documentation website. If you need support, please contact Maventa support.

Integration Guide Services & Reach API Specification Changelogs Integration guide Getting Started Invoice sending Consumer Invoicing Printing Email invoicing Invoice Receiving Scanning Detect Fraud reporting Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Validation Peppol BIS 3.0 Maventa JSON (table) Maventa JSON (json schema) Companies and Settings Department Company Users Billing Services and reach Maventa services and reach e-invoicing in Belgium e-invoicing in Denmark e-invoicing in Estonia e-invoicing in Finland Mass Printing Service Amili Kassavirta Amili Perintä Ropo Perintä e-invoicing in France e-invoicing in Germany e-invoicing in Italy e-invoicing in Latvia e-invoicing in the Netherlands e-invoicing in Norway e-invoicing in Poland e-invoicing in Spain e-invoicing in Sweden Api specification API overview Getting Started Common & authentication API Invoices API Documents API Companies & settings API Lookups API Detect API Validator API Receivables API Billing API Scanning API B2CFI API B2CNO API B2CSE API Partner API Getting Started API Methods Overview Account Configuration API Methods Invoice Sending API Methods Invoice Receiving API Methods B2C Norway API Methods B2C Finland API Methods Other API Methods Changelogs Product changelog Developer Changelog
Clear Send

Enter your credentials to Maventa testing environment, to authenticate and try things out with the Swagger UI. This will fetch a Bearer token using OAuth2 with the endpoint POST https://ax-stage.maventa.com/oauth2/token. The token is stored in your browser's session storage (cleared when you close the tab) and used in Swagger calls done from this documentation website. The token is valid for 1 hour.

Never use your production credentials here. This is only for testing the Maventa test environment in the Swagger UI.
Reset All None
eui global company lookup document:receive document:send invoice:receive invoice:send company:read company:write validate receivables:assignments analysis billing:reports partner:invoice_delivery_actions partner:lookups partner:takeovers partner:lyanthe_scan_service fi_bank_message:send fi_bank_message:receive
Cancel Sign In