Message IconCustomer SupportUser IconContact SalesLock IconLogin
The Arratech logo
Message IconCustomer SupportUser IconContact SalesLock IconLogin
Get StartedGet Demo

Evaluate. Validate. Integrate.

Evaluate. Validate. Integrate.
Try our API in sandbox mode

Try our API in sandbox mode that lets you exchange documents on the Peppol Network with Arratech’s Access Point or with one we host for you.

With this step-by-step guide, we help you to assess integration effort and capabilities with zero guesswork—so your team can swiftly get production-ready.

Sign In
Evaluate. Validate. Integrate.

Arratech API Guide

This guide walks you through the Arratech API, letting you create your own Peppol instances of an Access Point and SMP, to create your first participant and to exchanging documents, including validating them.

Tutorial: Get started with Arratech API

  1. Sign up
  2. Download and Install Insomnia
    • Go to Insomnia’s website: https://insomnia.rest to get the API tool
    • Select the appropriate download for your OS and complete the installation.
  3. Download and Import the Arratech Insomnia Collection
    • Download Arratech’s Insomnia collection
    • Open Insomnia, Select Collections → Import → Choose Files, then select the downloaded YAML.
    • The file includes pre-configured API calls saving you lots of time.
  4. Configure your environment
    • Open the Insomnia folder Arratech Business Portal Portal Tutorials → Environment tab → fill in your credentials that you use when accessing the Arratech Business Portal.
    • Set environment variables: Username, Password
  5. Run the tutorials
    • Start from Tutorial: Getting Started in Insomnia and run the preloaded test requests.
    • Sample API calls include
    • Get your Access Token (needs to be renewed every 60 minutes)
    • List your Access Point and SMP instances
    • Create Peppol receiver (participant) in the Test SMP
    • Validate an invoice
    • Submit and receive invoices via the Test Peppol Network
    • Fetch artefacts (submitted and received invoices, validation results, AS4 receipts).
    • Verify responses to confirm your configuration is correct.
  6. Troubleshooting and support
    • If you encounter errors, re-check environment variables (username, password, Peppol ID, tokens), ensure connectivity, and verify the API endpoint is reachable.
    • Refer to the official tutorials and troubleshooting guides in the Arratech Business Portal: dev.arratech.com/docs/tutorials
    • Common issues include invalid Peppol ID formats, incorrect API keys or expired tokens, and misconfigured environment variables.

Conclusion

Following these steps, you will be able to test, validate, and evaluate the Arratech API using Insomnia.

This setup ensures seamless integration with the Peppol Network, correct handling of Peppol IDs, and smooth usage of Peppol APIs for digital invoicing and secure document exchange.

For more details and to get a demo, get in touch with us.

Get a Demo

FAQs

Browse definitions and improve your knowledge.

What is a Peppol network?

Peppol is a network and set of standards for exchanging electronic business documents, such as invoices, between companies and governments. It ensures that all participants use a common format and are identified by a unique Peppol ID, making cross-border e-invoicing seamless and compliant (for more information go to www.peppol.org).

Why use Arratech API?

Setting up connectivity to the Peppol Network means building a complicated infrastructure to handle:

  • SMP (Service Metadata Publisher) & SML (Service Metadata Locator) communication — Every transaction requires looking up the recipient’s Peppol ID in the SML, then querying the correct SMP to discover capabilities (invoice format, transport profile, etc.).
  • 4-Corner Model compliance — All messages in Peppol flow through four parties: the sender, the sender’s Access Point, the receiver’s Access Point, and the receiver. Developers would need to implement message packaging, encryption, and routing rules for this model.
  • Security & certificates — Participation in Peppol requires PKI certificates for authentication and message signing, plus handling renewals and trust anchors.
  • Standards compliance — Ensuring documents meet EN16931 and local country-specific business rules, which is often non-trivial.
  • With the Arratech API, all of this heavy lifting is already done:
  • We abstract away SMP/SML lookups with simple endpoints—pass a Peppol ID, and our API validates reachability and capabilities for you.
  • The 4-Corner Model routing is fully managed within our infrastructure—you send to Arratech, and we handle secure delivery through the network to the correct receiver.
  • Certificates and trust setup are built into our Access Point services, so you don’t need to manage PKI complexity.
  • Our endpoints enforce Peppol compliance rules automatically, so your test invoices are validated before they ever reach the network.

This means developers can evaluate and integrate using familiar REST calls, without needing to understand the internals of Peppol’s transport layers. You get a streamlined path to production, while still achieving full compliance and interoperability on the Peppol Network.