Playbook19 min read

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

ItemTreatmentIn OrdoGrid
Closed invoices and credit notesStay in the old tool's export, XML and PDF as issuedNothing to do
Open invoices (unpaid, partly paid, disputed)Move across to follow payments and creditsFactures → Importer, then Record payment
Credit notes still to issue on an old invoiceIssue them in the old tool before T0, or in OrdoGrid afterImport the invoice, then Note de crédit
Drafts and quotes never sentRe-create them: they were never issuedNouvelle facture, Nouveau devis
Supplier invoices received by the old providerStay in its exportNew ones arrive in Peppol → Inbox
Peppol receptionOld provider deregisters, OrdoGrid registersRéception Peppol → Activer la réception
API or ERP connectorNew key, same namespace, stable source IDsAPI 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 exportImport the PDF (Importer)Re-create (Nouvelle facture)
Use forClosed historyOpen items, invoices you may creditNot for issued invoices
EvidenceOriginal XML and PDFA record read from the PDF, kept as the invoice's PDF; no XMLA second, different PDF under the old number
NumberingUntouchedOriginal number kept; counts towards the next proposal if it fits your formatYou type the old number
Payments and creditsFollowed outside OrdoGridRecord payment and Note de crédit workPossible, on a document the customer never received
Main riskLosing access when the old contract endsExtraction errors; resending by mistakeIssuing the same invoice twice

Import open invoices with Importer

You need the owner or administrator role.

  1. 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.
  2. Drop one or more PDFs of up to 10 MB each. OrdoGrid reads them and saves nothing yet.
  3. 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).
  4. Leave Statut on Envoyée (sent). Payée or Partiellement payée here records no money.
  5. 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.
  6. 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.
  7. 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

OptionWhenSet-up in OrdoGrid
Continue the old series (usual choice)You want one unbroken sequence per yearProfil 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 seriesThe old pattern cannot be reproduced, or you want a clean breakKeep 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 showsYour evidenceIn OrdoGrid
UnpaidNo payment on the statementImport with Envoyée
Partly paidA statement line per paymentImport, then one Record payment per payment
Paid, but no payment foundNoneRecord nothing; resolve it with your accountant first, or leave it out
Partly credited in the old toolThe credit note in the old exportOrdoGrid 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, 0208 and any 9925 VAT-number entry, then you click Activer la réception. In between nobody receives, and suppliers must resend. OrdoGrid registers only 0208: plus your enterprise number, not 9925, so in the T-3 notice ask suppliers who address you by your VAT number (9925) to use 0208.
  • 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 stateHow you knowAction
Issued by the old systemIt has a number in the old exportStays there; if open, import it. Never submit it to OrdoGrid
Not yet attemptedNo number anywhereSubmit to OrdoGrid after T0 with a stable external_id
Uncertain (timeout, no answer)The old system's logResolve it there first; reroute only once proven not issued
  1. 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 use default. A replacement key for the same connector needs exactly the same Integration ID, or retries will not find earlier documents.
  2. 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 returns 409 EXTERNAL_ID_REUSED, even when only non-financial fields differ. Also send an Idempotency-Key header: for 24 hours, an identical retry returns the original response.
  3. Check before retrying. GET /api/v1/me confirms company and Integration ID; GET /api/v1/invoices/lookup?external_id=… finds a document after a timeout.
  4. There is no sandbox: the first call creates a real, numbered invoice. More: public API integration.

Cutover runbook: T-14 to T+30

WhenActionEvidence
T-14Inventory: 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 PDFInventory sheet, dated lookup screenshot
T-7Set up Profil entreprise, numbering formats, clients, Autorisation Peppol, Continuer en envoi seul. Agree the cutover date and deregistration time in writingWritten agreements, numbering memo
T-3Tell regular suppliers about the reception switchNotice and recipients
T-1Last invoice from the old tool, number noted; stop its recurring invoices, reminders and payment links. Full export, Invoice Responses included. Freeze connector queuesExport with file count
T0Old provider deregisters, then Activer la réception. Import open items, record proven payments, issue the first invoice with the next free numberLookup screenshot, import summary
T+1First supplier document in Peppol → Inbox; first invoice shows Traité (delivered, not accepted). Open balances match the inventoryReconciliation sheet
T+7Check the old account for late documents; ask senders to resend on PeppolLog of late documents
T+30First month-end in OrdoGrid (month-end reconciliation); final export; close the old account or keep read-only accessFinal 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:

InvoiceCustomerTotalPaid before T0Open 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, Namur12 h × €125.00 = €1,500.00 + €315.00 VAT = €1,815.00none€1,815.00
2026-023, 26 June 2026 (Peppol)Brouwerij Van Damme BV, Ghent8 h × €100.00 = €800.00 + €168.00 VAT = €968.00none€968.00
Total€4,203.00
WhenWhat happensResult
Wed 1 July, 08:00–08:10The old provider confirms removal of the 0208 and 9925 entries; Sofie clicks Activer la réceptionMode : Envoi + réception
Wed 1 JulyShe 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 JulyShe 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 JulyShe 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 & EnvoyerOutbox shows Traité; next proposal 2026-026
Mon 6 JulyVan 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 structuredCredits €242.00, Outstanding €726.00
Mon 6 JulyMaison Dubois pays 2026-021Record payment €1,815.00: Payée
Fri 24 JulyVan Damme pays €726.00Payé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

MomentWhat rollback means
Before the first OrdoGrid invoiceStay 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 failsIf 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 OrdoGridThey 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 systemsTreat it as an incident

Edge cases and common mistakes

SituationRiskWhat to do
The old tool still runs recurring invoices or reminders after T0Two issuers, duplicate numbersSwitch 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 mistakeA duplicate that Peppol does not flagTell 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 PeppolA PDF credit note breaks the format ruleSend 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'importThe record cannot be deletedCorrect 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 linksCash recorded in the wrong systemDeactivate them at T-1, with the recurring invoices and reminders; record in OrdoGrid any payment that still comes in
New legal entity, new enterprise numberNot a migration: a new Peppol IDCréer une nouvelle entreprise and register the new ID

Evidence to keep

  1. 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).
  2. The T-1 inventory and a numbering memo (cutover date, last old and first new number per series) approved by your accountant.
  3. The bank statement line behind every payment recorded on an imported invoice.
  4. The written deregistration agreement with its time, dated lookup screenshots and a Peppol → Statut screenshot showing "Depuis le" (since).
  5. 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