E-invoicing reference checker


curl "https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=de_leitweg_id&reference=04011000-1234512345-06" \
  -H "Authorization: Bearer YOUR_API_KEY"

Pick a reference type, paste the value and see whether it is well formed: the form its publisher defines and, where there are check digits, whether they match. Free, in your browser, no signup.

What it checks

The references used in e-invoicing are party identifiers (a VAT or tax number), routing codes (a German Leitweg-ID, an Italian codice destinatario) and an invoice's own identifier (a Polish KSeF number, a Brazilian NF-e access key). A mistyped one is a rejected or misrouted invoice.

The picker lists every type the API checks, grouped by country. For a Peppol participant ID the page can also look the participant up in the Peppol network (registered in the Peppol network at the time of the check, which does not mean it accepts every kind of document).

What the check says

For the Leitweg-ID (routing ID) the check tests the form its publisher defines and the check digits. A value that passes is well formed and its check digits match.

What the check does not say

  • It does not say that the reference was issued, is registered or active, or that a tax authority accepts an invoice that carries it.
  • No live status from a national tax authority is served (Mexico SAT, Romania ANAF, Brazil SEFAZ, Poland KSeF, Italy SdI and the rest).
  • The check runs in your browser: nothing you type is sent to Prometiam, except a Peppol participant ID you choose to look up.
  • Prometiam is not a Peppol access point: it does not send, receive or validate invoices.

The same check by API

GET /einvoicing/check with type=de_leitweg_id and reference returns valid, normalized, basis and, where the value encodes something, parts. One credit a call, errors are free.

curl 'https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=de_leitweg_id&reference=04011000-1234512345-06' \
  -H 'Authorization: Bearer rk_live_...'

Related pages

Sign up · API documentation

The free trial lasts 14 days and includes 500 credits. A card is required and nothing is charged during the trial; it then continues as Starter (EUR 9.99/month) unless you cancel.

Frequently asked questions

Does a pass mean the Leitweg-ID (routing ID) exists?
No. It means the value is well formed and its check digits match. An offline check never says that a reference was issued, is registered or active.
Is this checked with the tax authority?
No. No live status from a national tax authority is served; the check is offline.
Can I do this in code?
Yes: GET /einvoicing/check?type=de_leitweg_id&reference=... with an API key, one credit a call.