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

Integrate. Verify. Implement.

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

Evaluate the Arratech's unified API in sandbox mode to exchange documents using our Test Peppol Access Point. If you have a self-hosted Access Point and only want to evaluate Arratech's SMP, that is fine too.

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

Sign In
Evaluate. Validate. Integrate.

Arratech Connect API Guide

This guide helps you to become acquainted with the Arratech API in sandbox mode, allowing you use Arratech's Test AP and SMP and create your own instances, create your first participant and to exchanging documents, including validating them.

Tutorial: Get started with Arratech Connect API

  1. Sign up
  2. Get an API client
  3. Configure the environment
    • Set environment variables: Username, Password (that you used when creating your user in step 1)
  4. Run the tutorials
    • Head over to the tutorials at https://dev.arratech.com/docs/tutorials
    • Each of the steps have separate .har collections for each tutorial.
    • Sample API calls include
      • Get your Access Token (needs to be renewed every 60 minutes)
      • List available Access Point and SMP instances (you will only see Arratech Test AP and SMP)
      • Create Peppol receiver (participant) in Arratech's Test SMP
      • Validate a submitted document
      • Submit and receive documents via the Test Peppol Network
      • List and download artefacts (submitted and received invoices, validation results, AS4 requests and receipts).
      • Verify responses to confirm your configuration is correct.
    • Swagger documentation can be found on https://dev.arratech.com/docs/api/swagger
  5. Troubleshooting and support
    • If you encounter errors, re-check environment variables (username, password, Peppol ID, tokens), ensure connectivity.
    • Refer to the API tutorials and troubleshooting guides in the Arratech Docs section on https://dev.arratech.com/docs
    • Common issues include invalid Peppol ID formats, incorrect API keys or expired tokens, and misconfigured environment variables.
    • If you have technical questions or experience any issues, please contact our engineers at support@arratech.com.

Conclusion

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

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

Explore common questions and straightforward explanations.
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.

Introduction to Arratech API · Arratech AB · Arratech AB