Migrate to OrdoGrid: cutover plan for invoices, numbering and Peppol
Switch invoicing tools without duplicates: keep the old archive, import open invoices, continue numbering, record proven payments and move Peppol reception.
- Updated
- Content owner
- Migration team
- For
- Business owners and managers · Accountants and bookkeepers · Finance and integration leads
At a glance
Fix one cutover date after which only OrdoGrid issues invoices. Keep closed history in the old tool's XML and PDF export, import only open invoices from their PDFs, continue your number series by typing the next free number, record only payments your bank statement proves, and move Peppol reception by deregistration, because OrdoGrid has no migration key.
Before you begin
- Business if the migration uses the public API; API access is not included in Free or Starter
- Owner or administrator rights in the OrdoGrid company: viewers cannot change numbering formats
- Full access to the old tool and its export of sent and received invoices, XML and PDF
- A list of open invoices with the bank statement line of every payment received
- Your accountant's agreement on the cutover date and the numbering choice
What you will achieve
- One system issuing invoices from a dated cutover, with no number used twice
- Open invoices in OrdoGrid whose balances match your bank evidence
- A tested archive of the old system, kept for at least seven years
- Peppol reception moved with a gap of minutes, not days
On this page
A migration cutover is the dated moment, called T0 below, from which a new system issues your invoices and the old one stops. Four things make it safe: only one system issues at any time, every number is used once, historical invoices stay available in their original form for seven years, and open invoices move across with balances you can prove. Peppol reception moves separately, in a short window agreed with the old provider.
This playbook is for business owners, accountants and integration leads moving to OrdoGrid from another invoicing tool or an ERP connector. It covers data, numbering, open items and the issuing boundary. The Peppol hand-over in detail is in Switch Peppol access point, and numbering rules in invoice numbering in Belgium. Most OrdoGrid screens named here are in French in every interface language; translations are in brackets.
What moves to OrdoGrid and what stays behind
| Item | Treatment | In OrdoGrid |
|---|---|---|
| Closed invoices and credit notes | Stay in the old tool's export, XML and PDF as issued | Nothing to do |
| Open invoices (unpaid, partly paid, disputed) | Move across to follow payments and credits | Factures → Importer, then Record payment |
| Credit notes still to issue on an old invoice | Issue them in the old tool before T0, or in OrdoGrid after | Import the invoice, then Note de crédit |
| Drafts and quotes never sent | Re-create them: they were never issued | Nouvelle facture, Nouveau devis |
| Supplier invoices received by the old provider | Stay in its export | New ones arrive in Peppol → Inbox |
| Peppol reception | Old provider deregisters, OrdoGrid registers | Réception Peppol → Activer la réception |
| API or ERP connector | New key, same namespace, stable source IDs | API keys, field Integration ID |
What the law requires, what we recommend, what OrdoGrid does
What the law requires.
- Numbering. Each invoice carries a sequential number "based on one or several series" that identifies it uniquely (Royal Decree no. 1, art. 5 §1 1°). Credit notes go in the same outgoing-invoice book; a separate credit-note series is a choice. Changing software changes nothing: no number may be issued twice.
- Issue deadline. An invoice must be issued by the 15th of the month after the chargeable event (Royal Decree no. 1, art. 4). A freeze around the cutover must not push invoices past it.
- Retention. Invoices sent and received are kept for seven years from 1 January of the year after their date (art. 60 §3 VAT Code, as amended by the Law of 18 December 2025; art. 315 Income Tax Code 1992 for income tax), and 15 or 25 years under the revision rules for immovable property. Authenticity, integrity and legibility must hold throughout; FPS Finance strongly recommends keeping the original XML.
- Peppol. Since 1 January 2026 the structured e-invoice is the invoice for in-scope Belgian B2B transactions. A credit note correcting a structured invoice must also go through Peppol; a 2026 credit note for a 2025 PDF invoice has no format requirement (FPS Finance specific FAQ, questions 5 and 23). Peppol cannot tell a duplicate from an original (question 4), so preventing double issue is your job.
What we recommend. Cut over on the first day of a month, ideally of a VAT quarter, so the outgoing-invoice book and the VAT return split cleanly. Move only open items, continue the existing series unless your accountant prefers a documented new one, and carry a balance only as far as bank evidence supports it.
What OrdoGrid does. It imports invoice PDFs with AI-assisted extraction, keeping the original number, but not XML files; invoices created through the public API are new documents, not imports. It proposes numbers only from the numbers it holds and takes over Peppol reception only after the old provider has deregistered. It is not a legal archive and has no full data export.
Historical invoices: keep, import or re-create?
| Keep in the old export | Import the PDF (Importer) | Re-create (Nouvelle facture) | |
|---|---|---|---|
| Use for | Closed history | Open items, invoices you may credit | Not for issued invoices |
| Evidence | Original XML and PDF | A record read from the PDF, kept as the invoice's PDF; no XML | A second, different PDF under the old number |
| Numbering | Untouched | Original number kept; counts towards the next proposal if it fits your format | You type the old number |
| Payments and credits | Followed outside OrdoGrid | Record payment and Note de crédit work | Possible, on a document the customer never received |
| Main risk | Losing access when the old contract ends | Extraction errors; resending by mistake | Issuing the same invoice twice |
Import open invoices with Importer
You need the owner or administrator role.
- Open Factures (Invoices) and click Importer. The page Importer des factures runs in three steps: Sélectionner le PDF, Aperçu et validation (preview and check), Confirmation d'import.
- Drop one or more PDFs of up to 10 MB each. OrdoGrid reads them and saves nothing yet.
- Compare each preview with its PDF: number, dates, customer, lines, VAT rate and total, to the cent. Correct with Éditer (edit). When a line is at 0%, the preview asks for Régime TVA des lignes à 0 % (VAT regime for 0% lines). OrdoGrid fills it in from the VAT mention printed on the PDF, such as "Autoliquidation" or "Livraison intracommunautaire", and quotes that mention. If the PDF prints none, the field shows À choisir (to choose) and Confirmer l'import waits until you pick a regime: the import never assumes Franchise de taxe (petites entreprises) (small-business exemption scheme). Reverse charge and the co-contractor regime also need both parties' VAT numbers. Invoices imported before this choice existed were saved under the franchise: before saving a Note de crédit on one of them, set the original invoice's regime under Options de TVA (VAT options).
- Leave Statut on Envoyée (sent). Payée or Partiellement payée here records no money.
- Under Lier à un client (optionnel) (link to a client), check the client OrdoGrid preselects when it finds a single match (VAT number, email or similar name), or pick another with Rechercher / Changer (search / change). If none is linked, OrdoGrid matches the customer's VAT number or creates the client; complete created clients later in Base Clients.
- A number already in OrdoGrid shows Doublon détecté (duplicate found) and is skipped. Click Confirmer l'import; the summary lists Factures importées, Factures en erreur, Doublons ignorés and Clients créés automatiquement.
- On each imported invoice, in Settlement, click Record payment per proven payment: Amount, Method, Occurrence time (UTC) as the bank statement date, Reference from the statement, and tick "I confirm this money has already been received or refunded." Outstanding shows the rest.
An imported invoice then behaves like any sent one: it turns En retard (overdue) from the start of its Échéance (due date) day, and its amounts lock once a payment is recorded.
Numbering at the cutover
| Option | When | Set-up in OrdoGrid |
|---|---|---|
| Continue the old series (usual choice) | You want one unbroken sequence per year | Profil entreprise → Formats de numérotation → Modifier, set Format factures to the old pattern, for example {YYYY}-{###}, then Sauvegarder. Type the next free number in N° on the first invoice |
| Start a new series | The old pattern cannot be reproduced, or you want a clean break | Keep F-{YYYY}-{####} or a prefix that cannot collide with old numbers; record the date, last old and first new number with your accountant |
Do the same for credit notes with Format notes de crédit. How OrdoGrid assigns numbers:
- It proposes the highest number it holds in the same pattern, plus one. Imported invoices count if they fit the pattern; invoices left in the old tool do not.
- The number is committed at the first save, drafts included. A number already in OrdoGrid is refused; one used only in the old tool is not.
- Proposals always continue from the highest number held (per year with
{YYYY}, per month with{MM}), so typing the next free number moves the series on; typing a lower one does not. Gap-free numbering is not enforced. - Only owners and administrators see Modifier. Placeholders:
{YYYY},{YY},{MM}and{####}, where the number of # sets the padding.
Open balances: carry over only what you can prove
- Open item
- An invoice not yet fully settled. Its balance is the original total minus credit notes minus payments that appear on a bank statement; a "paid" label in the old tool is not evidence.
| The old tool shows | Your evidence | In OrdoGrid |
|---|---|---|
| Unpaid | No payment on the statement | Import with Envoyée |
| Partly paid | A statement line per payment | Import, then one Record payment per payment |
| Paid, but no payment found | None | Record nothing; resolve it with your accountant first, or leave it out |
| Partly credited in the old tool | The credit note in the old export | OrdoGrid cannot record a credit note issued elsewhere: follow that balance from the export and your bank |
Settlement shows Invoice total, Payments (including prepayments), Credits and Outstanding. Overpayment is refused; a wrong movement is cancelled with Reverse payment, never edited. Payée (paid) appears only once recorded payments cover the balance.
Peppol: sending moves at once, reception after deregistration
- Your Peppol ID does not change:
0208:plus your ten-digit enterprise number (KBO/BCE, the Crossroads Bank for Enterprises). Check who receives for you on lookup.peppol.org, the tool FPS Finance recommends. - Sending needs no registration. Sign Autorisation Peppol, then on Réception Peppol click Continuer en envoi seul (continue send-only): until the switch you send from OrdoGrid and the old provider keeps receiving.
- Reception has one holder. Each identifier is registered with one publishing service only (SML specification 1.3.0, §2.1). OrdoGrid supports no migration key: the old provider removes every identifier,
0208and any9925VAT-number entry, then you click Activer la réception. In between nobody receives, and suppliers must resend. OrdoGrid registers only0208:plus your enterprise number, not9925, so in the T-3 notice ask suppliers who address you by your VAT number (9925) to use0208. - What stays behind: documents the old provider received, and customers' Invoice Responses to invoices the old tool sent.
Supplier notice, timeline and rollback: Switch Peppol access point.
API and ERP connectors: keep identities across the boundary
Freeze the source queue at T-1 under one named owner and classify each pending order:
| Order state | How you know | Action |
|---|---|---|
| Issued by the old system | It has a number in the old export | Stays there; if open, import it. Never submit it to OrdoGrid |
| Not yet attempted | No number anywhere | Submit to OrdoGrid after T0 with a stable external_id |
| Uncertain (timeout, no answer) | The old system's log | Resolve it there first; reroute only once proven not issued |
- Create the key under API keys → Create key with the narrowest Permissions and an Integration ID such as
erp. It cannot be changed later and survives Rotate; older keys usedefault. A replacement key for the same connector needs exactly the same Integration ID, or retries will not find earlier documents. - Use the source order ID as
external_id. It is unique per company, Integration ID and document type, and no rotation releases it; a different payload under an existing one returns409 EXTERNAL_ID_REUSED, even when only non-financial fields differ. Also send anIdempotency-Keyheader: for 24 hours, an identical retry returns the original response. - Check before retrying.
GET /api/v1/meconfirms company and Integration ID;GET /api/v1/invoices/lookup?external_id=…finds a document after a timeout. - There is no sandbox: the first call creates a real, numbered invoice. More: public API integration.
Cutover runbook: T-14 to T+30
| When | Action | Evidence |
|---|---|---|
| T-14 | Inventory: documents per year, open items with balances, last number per series, Peppol identifiers. Test the old export on an old and a recent invoice, XML and PDF | Inventory sheet, dated lookup screenshot |
| T-7 | Set up Profil entreprise, numbering formats, clients, Autorisation Peppol, Continuer en envoi seul. Agree the cutover date and deregistration time in writing | Written agreements, numbering memo |
| T-3 | Tell regular suppliers about the reception switch | Notice and recipients |
| T-1 | Last invoice from the old tool, number noted; stop its recurring invoices, reminders and payment links. Full export, Invoice Responses included. Freeze connector queues | Export with file count |
| T0 | Old provider deregisters, then Activer la réception. Import open items, record proven payments, issue the first invoice with the next free number | Lookup screenshot, import summary |
| T+1 | First supplier document in Peppol → Inbox; first invoice shows Traité (delivered, not accepted). Open balances match the inventory | Reconciliation sheet |
| T+7 | Check the old account for late documents; ask senders to resend on Peppol | Log of late documents |
| T+30 | First month-end in OrdoGrid (month-end reconciliation); final export; close the old account or keep read-only access | Final export, closure confirmation |
FPS Finance says most Peppol invoices arrive within minutes to a couple of hours; raise delays beyond one working day with your provider.
Worked example: Claes Design BV moves on 1 July 2026
Claes Design BV, a two-person studio in Leuven (enterprise number 0721.456.306, Peppol ID 0208:0721456306), invoiced and received on Peppol through an online tool until 30 June 2026. Its manager, Sofie Claes, cuts over on Wednesday 1 July, the first day of the third VAT quarter, with her accountant Lien Peeters.
The old tool holds invoices 2025-001 to 2025-038 and 2026-001 to 2026-024, credit notes CN-2026-01 and CN-2026-02, and 31 received documents. Fifty-nine closed invoices stay in the export; three open ones move across:
| Invoice | Customer | Total | Paid before T0 | Open at T0 |
|---|---|---|---|---|
| 2025-034, 15 Dec 2025 (PDF) | Bakkerij Wouters BV, Mechelen | €2,000.00 + €420.00 VAT = €2,420.00 | €1,000.00 on 20 Jan 2026 | €1,420.00 |
| 2026-021, 8 June 2026 (Peppol) | Maison Dubois SRL, Namur | 12 h × €125.00 = €1,500.00 + €315.00 VAT = €1,815.00 | none | €1,815.00 |
| 2026-023, 26 June 2026 (Peppol) | Brouwerij Van Damme BV, Ghent | 8 h × €100.00 = €800.00 + €168.00 VAT = €968.00 | none | €968.00 |
| Total | €4,203.00 |
| When | What happens | Result |
|---|---|---|
| Wed 1 July, 08:00–08:10 | The old provider confirms removal of the 0208 and 9925 entries; Sofie clicks Activer la réception | Mode : Envoi + réception |
| Wed 1 July | She imports the three PDFs as Envoyée and records €1,000.00 on 2025-034 (Bank transfer, 20 January 2026, statement reference) | Outstanding €1,420.00; total open €4,203.00, as in the inventory |
| Wed 1 July | She sets Format factures to {YYYY}-{###} and Format notes de crédit to CN-{YYYY}-{##} | OrdoGrid proposes 2026-024, already used by the old tool |
| Thu 2 July | She types 2026-025 in N°: Maison Dubois, 10 h × €125.00 = €1,250.00 + €262.50 VAT = €1,512.50, sent with Envoi électronique via Peppol ticked and Sauvegarder & Envoyer | Outbox shows Traité; next proposal 2026-026 |
| Mon 6 July | Van Damme disputed 2 of the 8 hours. Note de crédit on the imported 2026-023, quantity 2, number CN-2026-03 typed over the proposed CN-2026-01: €200.00 + €42.00 VAT = €242.00, on Peppol because 2026-023 was structured | Credits €242.00, Outstanding €726.00 |
| Mon 6 July | Maison Dubois pays 2026-021 | Record payment €1,815.00: Payée |
| Fri 24 July | Van Damme pays €726.00 | Payée |
| Fri 31 July (T+30) | Still open: 2025-034 (€1,420.00, overdue; Sofie contacts the customer herself) and 2026-025 (€1,512.50, due 1 August) | Final export; old account closed |
The 2025 documents are kept until 31 December 2032 and the 2026 ones until 31 December 2033. The original XML of 2026-021 and 2026-023 exists only in the old export, so Lien files it with the OrdoGrid records.
Rollback: what you can still undo
| Moment | What rollback means |
|---|---|
| Before the first OrdoGrid invoice | Stay on the old tool. If reception already moved, click Libérer la réception (release reception) on Peppol → Statut, as owner or administrator, so the old provider can register you again. Imported invoices remain as records that issue nothing; note them in the inventory |
| Activer la réception fails | If the message says another provider still holds the number, the old provider has not finished deregistering: get its confirmation, then retry. Otherwise retry, then contact OrdoGrid support; if unsolved the same day, the old provider registers you again, which is why its account stays open until T+30 |
| After invoices are issued from OrdoGrid | They stay. Pause, list what each system issued and under which numbers, keep one issuer and correct with credit notes, never by reusing a number |
| A connector sent one order to both systems | Treat it as an incident |
Edge cases and common mistakes
| Situation | Risk | What to do |
|---|---|---|
| The old tool still runs recurring invoices or reminders after T0 | Two issuers, duplicate numbers | Switch them off at T-1. Recreate them in OrdoGrid as recurring invoices with a first invoice after T0, or use Dupliquer each period |
| An imported invoice is sent again by mistake | A duplicate that Peppol does not flag | Tell the customer at once, so it is not booked twice; ask your accountant whether a correcting document is needed |
| Credit note on an invoice the old tool sent on Peppol | A PDF credit note breaks the format rule | Send it on Peppol: from the old tool before closing it, or import the invoice and use Note de crédit |
| Error spotted after Confirmer l'import | The record cannot be deleted | Correct it before any payment is recorded (saving regenerates its PDF; the original stays in your export), or contact support |
| Customers pay through the old tool's payment links | Cash recorded in the wrong system | Deactivate them at T-1, with the recurring invoices and reminders; record in OrdoGrid any payment that still comes in |
| New legal entity, new enterprise number | Not a migration: a new Peppol ID | Créer une nouvelle entreprise and register the new ID |
Evidence to keep
- The old system's full export: XML and PDF of every document sent and received, and every Invoice Response, in storage you control with a backup. If that storage is outside Belgium, full online access from Belgium is required (FPS Finance).
- The T-1 inventory and a numbering memo (cutover date, last old and first new number per series) approved by your accountant.
- The bank statement line behind every payment recorded on an imported invoice.
- The written deregistration agreement with its time, dated lookup screenshots and a Peppol → Statut screenshot showing "Depuis le" (since).
- Old account access: who can log in, until when, and how to retrieve a document afterwards.
OrdoGrid keeps the uploaded PDF as the imported invoice's PDF until an edit is saved, which replaces it with a regenerated one; for documents it sends on Peppol, it keeps the exact XML and PDF with their hashes.
FAQ
Can I import invoices from my old invoicing software into OrdoGrid?
Yes, as PDFs: Factures → Importer reads each file, keeps the original number and lets you check every field before saving. The result is a record of the invoice, not its original XML; XML files and bulk API imports are not supported.
Do I have to move my closed invoices to OrdoGrid?
No. The law requires you to keep them for seven years, not to move them. Keep the old XML and PDF export in your own storage and import only invoices you still need to follow up.
How do I continue my invoice numbering after switching?
Set Format factures under Profil entreprise → Formats de numérotation to the old pattern and type the next free number on your first OrdoGrid invoice; OrdoGrid then proposes the following ones. Do the same for credit notes.
How do I bring across an invoice that is partly paid?
Import its PDF as Envoyée, then record each payment with Record payment, using the bank statement date and reference. Never mark it paid without a payment on the statement.
Can I credit an invoice my old tool sent on Peppol?
Yes: import the invoice, create a Note de crédit from it and send it on Peppol, as FPS Finance requires for credit notes on structured invoices. Integrations can use the public API, which accepts the number of an invoice issued elsewhere.
How long must I keep the old system's archive?
Seven years from 1 January of the year after each invoice's date, and 15 or 25 years for documents tied to VAT revision on immovable property. A change of provider shortens nothing.
Can I rehearse the cutover in a test mode?
No. OrdoGrid has no Peppol test mode and API calls act on real data. Rehearse with the export test, check every import preview, as nothing is saved before Confirmer l'import, and follow your first live invoice end to end.
Sources and references
- FPS Finance — How do I keep invoices received via electronic invoicing? (seven years, original XML)
- Law of 18 December 2025 (Belgian Official Journal 30.12.2025), art. 97: VAT retention back to seven years
- Royal Decree no. 1 on VAT invoicing (consolidated): issue deadline, art. 4; numbering, art. 5 §1 1°
- FPS Finance — FAQ: specific questions about e-invoicing (duplicates, Q4; credit notes, Q5 and Q23)
- FPS Finance — FAQ: general questions about Peppol (0208 registration, lookup, delivery delays)
- OrdoGrid public API reference