Skip to main content

Creating a Peppol ID

First, you need to create a Peppol ID. Below, we explain the steps to create a Peppol ID using the Peppol Connect API.

Prerequisites

Before creating a Peppol ID, please prepare your taxpayer number, company name/business name, address, etc., that match the official site.

For Corporations: National Tax Agency Corporate Number Publication Site

For Businesses: National Tax Agency Invoice System Qualified Invoice Issuer Publication Site

POST /v1/legal_entities

To create a Peppol ID, you need to create a Legal Entity. One Legal Entity can be associated with multiple Peppol IDs.

$ curl -X POST https://api.e-invoice.moneyforward.com/v1/legal_entities \
-d '{"company_name": "", "legal_entity_uuid": "uuid"}'

Obtaining a Peppol ID​

Important

In Peppol Connect, we will verify your taxpayer number, company name/individual name, and address information on the official site. If verification fails, you will not be able to create a Peppol ID.

For Corporations​

POST /v2/legal_entities/{legal_entity_uuid}/participant_identifiers/corporate

Those with a corporate tax number, company name, and address will create a Peppol ID as a corporate user.

$ curl -X POST https://api.e-invoice.moneyforward.com/v2/legal_entities/{legal_entity_uuid}/participant_identifiers/corporate \
-d '{"number": "", "name": "", "address": ""}'

Upon successful creation, a Peppol ID will be returned as follows:

{
"identifier": "0188:your-corporate-tax-number"
}

For Individuals​

POST /v2/legal_entities/{legal_entity_uuid}/participant_identifiers/individual

Create a Peppol ID as an individual user with an individual taxpayer number, individual name, and individual address.

$ curl -X POST https://api.e-invoice.moneyforward.com/v2/legal_entities/{legal_entity_uuid}/participant_identifiers/Individual \
-d '{"number": "", "name": "", "address": ""}'

Upon successful creation, a Peppol ID will be returned as follows:

{
"identifier": "0221:your-individual-tax-number"
}

In the next page, we will explain how to send digital invoices using the created Peppol ID.

Note

  • For those registering a Peppol ID for the first time:

    • If you have never sent or received a Peppol invoice, a new Peppol ID will be automatically created through Money Forward SMP (Service Metadata Publisher).
    • If you want to use the Peppol Connect API but do not want to create a Peppol ID with Money Forward SMP, you need to create a Peppol ID with another SMP and use the Peppol Connect API with the existing Peppol ID.

  • For those with an existing Peppol ID:

    • If the corporate/business information is correctly authenticated, you can use the Peppol Connect API with your existing Peppol ID.