Einvoice Peppol

{
  "can_receive_invoices": true,
  "explain": {
    "mandates": "Peppol B2B e-invoicing is required in Belgium since 2026-01-01. France requires all companies to receive e-invoices from 2026-09-01 (via certified platforms; 0225 ids are French e-invoicing addresses). Germany requires all companies to receive e-invoices since 2025.",
    "name_search": "A name search returns participants whose registered name matches; check the VAT or company number before sending.",
    "not_found": "Not in the Peppol Directory. New registrations can take up to a day to appear, and some access points do not publish to the directory, so this is not proof the company cannot receive Peppol invoices. Ask the company for its Peppol id.",
    "on_peppol": "The company is registered as a receiver on the Peppol network (via a certified access point), so you can send it e-invoices over Peppol using any of the participant ids."
  },
  "more_results": 0,
  "on_peppol": true,
  "participants": [
    {
      "accepts": [
        "invoice",
        "credit note"
      ],
      "can_receive_invoices": true,
      "country": "BE",
      "name": "Colruyt Group NV",
      "other_ids": [],
      "participant_id": "0208:0400378485",
      "registered": "2023-08-30",
      "scheme": "Belgian company number (KBO/BCE)"
    },
    {
      "accepts": [
        "invoice",
        "credit note"
      ],
      "can_receive_invoices": true,
      "country": "BE",
      "name": "Colruyt Group NV",
      "other_ids": [
        "0208:0400378485"
      ],
      "participant_id": "9925:be0400378485",
      "registered": "2022-04-22",
      "scheme": "Belgian VAT"
    }
  ],
  "query": {
    "by": "vat",
    "country": "BE",
    "value": "BE0400378485"
  },
  "source": "Peppol Directory (OpenPeppol)"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://factline.dev/v1/einvoice/peppol?vat=BE0400378485'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://factline.dev/v1/einvoice/peppol?vat=BE0400378485' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.003 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.003" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.003 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ffactline.dev%2Fv1%2Feinvoice%2Fpeppol
const res = await pay("https://factline.dev/v1/einvoice/peppol?vat=BE0400378485");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.003 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.003"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://factline.dev/v1/einvoice/peppol?vat=BE0400378485")
    print(res.status_code, res.text)