Automation MCP Server Features Blog Pricing Contact
Peppol International · A-NZ · Singapore · Japan · Malaysia

Peppol PINT API:
one model, every jurisdiction

PINT is how Peppol left Europe. Where BIS Billing is bound to EN 16931, PINT is the international model that jurisdictions specialise: Australia and New Zealand, Singapore, Japan and Malaysia each have their own billing specification on the same shared core. InvoiceXML creates and validates PINT documents, and reads the CustomizationID to tell you exactly which jurisdiction you are looking at.

POST /v1/validate/ubl · a received PINT file
curl -X POST https://api.invoicexml.com/v1/validate/ubl \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"
200 OK · jurisdiction recognised
{
  "valid": true,
  "data": {
    "profile": "pint",
    "customizationId": "urn:peppol:pint:billing-1@aunz-1"
  }
}
The model

Shared, aligned, distinct

EN 16931 was written for Europe, so OpenPeppol built PINT to carry the rest of the world without fragmenting into incompatible national formats. Every PINT invoice is layered:

sharedDefined identically everywhere, so any receiver can process it.
alignedGeneric in the core, specialised by each jurisdiction.
distinctLocal requirements that exist only in that jurisdiction.

The jurisdiction is declared in one place: the CustomizationID (PINT calls it ibt-024), of the form urn:peppol:pint:billing-1@{jurisdiction}-1. Read that field and you know the rule set.

ibt-024 · the specification identifier
<cbc:CustomizationID>
  urn:peppol:pint:billing-1@aunz-1
</cbc:CustomizationID>

# the jurisdiction suffix decides the rules
@aunz-1   Australia & New Zealand
@sg-1     Singapore
@jp-1     Japan
@my-1     Malaysia
Jurisdictions

The PINT billing specifications

Each jurisdiction has its own specification identifier. We recognise all of them on validation today; the jurisdiction-specific rule packs are rolling out behind the same endpoint.

Jurisdiction CustomizationID (ibt-024) Local programme On InvoiceXML
Australia & New Zealand urn:peppol:pint:billing-1@aunz-1 ATO and MBIE, shared A-NZ specification Detected today, rule pack rolling out
Singapore urn:peppol:pint:billing-1@sg-1 IMDA InvoiceNow, the GST e-invoicing route Detected today, rule pack rolling out
Japan urn:peppol:pint:billing-1@jp-1 Digital Agency, JP PINT Detected today, rule pack rolling out
Malaysia urn:peppol:pint:billing-1@my-1 MDEC Peppol, alongside the LHDN MyInvois clearance Detected today, rule pack rolling out
European Union urn:peppol:pint:billing-1@en16931-2017@eu-3 EU PINT, the European profile of the model For EU billing, see Peppol BIS
The model and the network sit on the Peppol hub, the UBL 2.1 syntax on the UBL hub. A CustomizationID we hold no dedicated rule pack for still validates against the base PINT and EN 16931 rules, with an explicit PROFILE-DETECTION notice naming what it recognised, never a false rejection.
Validation response

It names the jurisdiction for you

You should not have to parse a URN to know whether an invoice is Singaporean or Japanese. The verdict reads ibt-024 and reports the recognised jurisdiction in data, alongside any findings in the same shape every profile uses.

data.profileAlways pint for the international model.
customizationIdThe exact jurisdiction, straight from the document.
PROFILE-DETECTIONAn honest notice when a jurisdiction pack is still rolling out.

Detect first, route with confidence, never on a guess from the country code.

200 · Singapore recognised
{
  "valid": true,
  "data": {
    "profile": "pint",
    "customizationId": "urn:peppol:pint:billing-1@sg-1"
  },
  "warnings": [
    {
      "rule": "PROFILE-DETECTION",
      "layer": "cius",
      "message": "Recognised PINT Singapore (sg-1).
        Validated against the base PINT and
        EN 16931 rules; the SG jurisdiction
        rule pack is rolling out."
    }
  ]
}
Where PINT applies

The international picture

Each jurisdiction runs its own programme and its own timeline. PINT is the common thread that keeps them interoperable.

Australia & New Zealand
A-NZ PINT, governed jointly by the ATO and MBIE.
aunz-1
Singapore
InvoiceNow on Peppol, the GST e-invoicing route under IMDA and IRAS.
sg-1
Japan
JP PINT, maintained by the Digital Agency; voluntary and actively encouraged.
jp-1
Malaysia
Peppol PINT via MDEC, alongside the LHDN MyInvois clearance model.
my-1

Malaysia is the one to read carefully: the national mandate runs on LHDN's MyInvois clearance model, while Peppol PINT is the interoperability layer on top. The two are distinct, and we keep them that way. See the Mandate Map for each country's timeline.

Rule packs, rolling out

Each jurisdiction ships on its own clock. One endpoint absorbs it.

PINT specifications move per jurisdiction: A-NZ, Singapore, Japan and Malaysia each publish on their own release calendar. We track every one, vendor the artifacts as they become mandatory, and slot the jurisdiction rule packs in behind the same pint profile. Detection is live now; the per-jurisdiction validation deepens without you changing a line.

Read the versioning policy and the exact artifact versions running now
Jurisdiction rule packs
Detect now, enforce next

Every PINT jurisdiction is recognised on validation today. The A-NZ, Singapore, Japan and Malaysia rule packs land behind the same endpoint as each is finalised.

aunz sg jp my Rolling out
FAQ

Questions teams ask before they go international

01What is Peppol PINT?
PINT (Peppol International) is the international model for billing. It exists because EN 16931 was written for the EU, and countries joining Peppol from outside Europe need an invoice that stays interoperable while carrying their own local requirements. PINT splits the invoice into shared, aligned, and distinct content so each jurisdiction can specialise without breaking the common core.
02How is PINT different from Peppol BIS?
Peppol BIS Billing 3.0 is the European billing specification, bound tightly to EN 16931. PINT is the international model that jurisdictions outside the EU specialise: Australia and New Zealand, Singapore, Japan and Malaysia each have their own PINT billing specification, identified by a CustomizationID of the form urn:peppol:pint:billing-1@{jurisdiction}-1.
03Which jurisdictions does PINT cover?
Today: Australia-New Zealand (aunz), Singapore (sg), Japan (jp) and Malaysia (my), each with its own specification identifier, plus an EU PINT. The list grows as more Peppol authorities adopt the model.
04What does InvoiceXML support today?
You can create with profile pint and validate any PINT document. On validation we read the CustomizationID (ibt-024) and recognise the jurisdiction. Validation runs the base PINT rules today; the jurisdiction-specific rule packs (A-NZ, Singapore, Japan, Malaysia) are rolling out and slot in behind the same endpoint with no integration change.
05How do I create a PINT invoice?
Post your invoice JSON to the create endpoint with options.profile set to pint. You get UBL 2.1 back, stamped and validated against the PINT model before it reaches you.
06Can you tell which jurisdiction a received file is?
Yes. The CustomizationID names it, and the validate verdict reports the recognised jurisdiction in data, so you route and process on a value you can trust rather than guessing from the supplier's country.
Start free today

Ready to automate your invoices?

Validate, convert and embed compliant e-invoices through one API. Start your 30-day free trial. No credit card required.

GDPR Compliant No credit card required Setup in minutes
Peppol UBL
Factur-X
EN 16931
142 / 142 passed
Compliant
PDF/A-3 embedded