Dienst · Software-ontwikkeling

KSeF integratie laten maken voor uw ERP.

KSeF — Krajowy System e-Faktur — wordt het verplichte Poolse e-factuur-systeem. Heeft u een Poolse vestiging, een dochterbedrijf in Warschau of B2B-export naar Polen? Dan moeten uw uitgaande facturen via het KSeF-platform lopen. Wij bouwen de technische koppeling vanuit SAP, Microsoft Dynamics, Exact of AFAS naar de KSeF API.

FA(3) XSDIDoc-mappingSandbox & productieDigital signature

Een KSeF-koppeling is geen plug-in, het is een ERP-integratie.

KSeF dwingt een vaste XML-structuur af (FA(3)), eist gekwalificeerde digital signatures voor authenticatie, en kent strikte regels voor pre-validatie, retries en archivering. Een out-of-the-box connector dekt zelden de hele flow — zeker niet als uw factuurdata uit een SAP-IDoc, Dynamics F&O of een eigen middleware komt. De Poolse fiscus wil de factuur live ontvangen, schema-valideren, een UUID toekennen en pas dan accepteren — pas op dat moment geldt de factuur ook juridisch als uitgegeven.

Wij bouwen sinds 2015 maatwerk-integraties voor ERP- en factuur-systemen. Voor KSeF betekent dat: schema-mapping vanuit uw bron-systeem naar FA(3), token-based authenticatie tegen de Ministerstwo Finansów-omgeving, een nette retry- en error-laag, en archivering die voldoet aan de Poolse wettelijke bewaarplicht. Geen fiscaal advies — dat laten we aan uw belastingadviseur — wel de techniek die werkt op de eerste dag dat KSeF mandatory wordt.

Onze rol stopt niet bij "de XML komt door". We denken mee over de gevolgen voor uw debiteuren-administratie, de timing van creditfacturen en correcties, en hoe afgewezen submissions niet stilletjes in een queue blijven hangen. Bouwen aan KSeF is voor een groot deel uitzonderingen afvangen — een gewone factuur is makkelijk, de uitzondering kost u geld als die niet klopt.

Drie smaken KSeF-integratie.

Welke past hangt af van uw factuurvolume, de bron-systemen en hoeveel uitzonderingen u op uw uitgaande factuurstroom heeft. We adviseren welke variant past in het eerste gesprek.

Compact traject · vast sprintbudget

Directe KSeF-koppeling vanuit één ERP

Eén bron-systeem (Exact, AFAS, of een vergelijkbaar pakket), uitgaande facturen vanuit één Poolse entiteit. We bouwen een dunne integratie-laag die factuurdata ophaalt, mapt naar FA(3) XML, ondertekent en submitt aan KSeF. Inclusief sandbox-testing en go-live-begeleiding.

FA(3) mappingSignature flowUUID-handlingStatus-callback
Middelgroot traject · vast sprintbudget

SAP IDoc / EDI-bridge naar KSeF

SAP ECC of S/4HANA als bron, met IDoc INVOIC of een outbound EDI-stroom. We bouwen een middleware-laag (Azure, GCP of on-prem) die IDoc/EDIFACT consumeert, transformeert naar FA(3), KSeF-submission afhandelt en het resultaat als bevestiging of fout terugschrijft. Inclusief operationele monitoring en herzendingen voor afgewezen facturen.

IDoc INVOICEDIFACT-mappingMiddlewareRetry-flow
Groter traject · vast sprintbudget

Multi-entity KSeF-platform met Peppol-overlap

Meerdere Poolse vestigingen, meerdere ERP's, en parallel Peppol voor de rest van de EU. We bouwen een centraal e-invoicing-platform met routing-logica per land en per entiteit, gedeelde archivering, audit-log, en een dashboard waarin uw finance-team afgewezen facturen, openstaande UUID's en signature-status kan inzien.

Multi-ERPPeppol-overlapRouting-engineFinance dashboard

Wat u krijgt aan het einde.

Een productieklare KSeF-integratie, plus alles wat u nodig heeft om hem zelf te beheren en uit te breiden naar nieuwe entiteiten.

  • De integratie-laag zelfProductie + sandbox-environment, gekoppeld aan zowel uw ERP als de KSeF API van het Poolse Ministerstwo Finansów.
  • FA(3) schema-mappingGedocumenteerde mapping van uw IDoc-velden, Exact-XML of AFAS-Profit-velden naar het FA(3) XSD-schema, inclusief fallback-regels voor ontbrekende data.
  • Signature- en token-flowImplementatie van de KSeF-authenticatie via gekwalificeerd certificaat of token, met automatische verlenging en sleutel-rotatie.
  • Archivering & audit-logVersleutelde langetermijn-opslag conform de Poolse wettelijke bewaarplicht van tien jaar, met audit-log voor inspectie door fiscus of accountant.
  • Operations-dashboardInzicht in submitted, accepted, rejected en pending facturen — met één klik herzenden voor afgewezen submissions.
  • Codebase + runbookVolledige source code, build-instructies en een runbook voor incidenten — uw IT-team kan zelf escalaties oppakken.
  • Beheer-contract (optioneel)Monitoring, security-patches, schema-updates wanneer KSeF nieuwe FA-versies uitbrengt, en doorontwikkeling op een vaste maandprijs.

Wanneer een KSeF-integratie de juiste keuze is.

Vier situaties waarin we bedrijven begeleiden. Herkent u er één, dan praten we graag verder over de scope.

Verplichting

Poolse entiteit binnen uw groep

U heeft een dochterbedrijf, sales-office of productievestiging in Polen die B2B-facturen uitschrijft. De Poolse fiscus accepteert binnenkort alleen nog facturen die via KSeF zijn ingediend — uw eigen ERP moet daarheen kunnen praten.

Export-flow

NL-bedrijf met B2B-export naar Polen

U factureert vanuit Nederland aan Poolse B2B-afnemers. Afhankelijk van uw BTW-positie en de afnemer-status valt deze stroom ook onder KSeF. Een hybride opstelling met Peppol voor andere EU-landen en KSeF voor Polen is dan de meest robuuste route.

SAP-landschap

SAP-gebruiker met IDoc-flows

Uw outbound facturen verlopen via IDoc INVOIC of een EDI-stroom. De stap van IDoc naar FA(3)-XML is niet triviaal — we bouwen de mapping en de middleware ertussenin, zodat uw SAP-team niets aan de standaard hoeft te raken.

Schaal

Multi-entity, meerdere ERP's

Uw groep draait deels op SAP, deels op Microsoft Dynamics of Exact, en u heeft meerdere VAT-nummers in Polen. Eén centraal e-invoicing-platform met routing per entiteit voorkomt dat u dezelfde koppeling drie keer bouwt.

Risico

Bestaande connector dekt het niet

U heeft al een KSeF-knop in uw factuurpakket maar de vendor levert geen support voor uw eigen layout, IDoc-velden of correctieflows. Een dunne maatwerk-laag bovenop de connector vangt het verschil op zonder dat u uw hele factuursysteem hoeft te vervangen.

Compliance

Audit-trail tot op factuurniveau

Uw accountant of de Poolse fiscus wil per factuur kunnen zien wanneer hij is ingediend, met welke handtekening, welk UUID is teruggekomen en wie hem heeft ingezien. Een gewone ERP-log is daarvoor te grof; we leveren een dedicated audit-laag.

Hoe een KSeF-traject loopt.

1

Kennismaking & scoping

Een gesprek waarin we vaststellen welke entiteiten via KSeF moeten gaan factureren, welke bron-systemen daar tegenover staan en hoeveel uitzonderingen er op uw factuurstroom zitten (creditfacturen, voorschotten, correcties).

2

Schema-analyse & data-mapping

We leggen uw outbound factuurdata naast het FA(3) XSD-schema. Velden die niet één-op-één matchen krijgen mapping-regels of fallback-waarden. Resultaat: een complete mapping-tabel die u zelf kunt onderhouden.

3

Bouw in sprints, eerst sandbox

Elke sprint een werkende build. We starten in de KSeF-sandbox — exact de plek waar GSC-zoekers naar "ksef sandbox" uitkomen — testen de signature-flow en submission, en lopen samen door rejected scenarios heen voordat we naar productie gaan.

4

Pre-validatie & error-handling

Voor elke factuur draait een pre-validatie tegen het schema, plus de KSeF-business-rules waar we weet van hebben. Zo voorkomen we dat afwijzingen pas zichtbaar worden ná indiening. Afgewezen submissions krijgen een nette retry-flow met audit-log.

5

Go-live & archivering inrichten

Gefaseerde overgang van sandbox naar productie, archivering ingeregeld conform de Poolse bewaarplicht, en kennisoverdracht aan uw finance- en IT-team. Dashboards staan klaar voor inspectie of audit.

6

Beheer & doorontwikkeling

KSeF wijzigt regelmatig (nieuwe FA-versies, aanvullende validaties). We monitoren die wijzigingen, passen het schema aan zodra Polen het publiceert en breiden de koppeling uit als er entiteiten of ERP's bijkomen.

Veelgestelde vragen.

Wat opdrachtgevers meestal willen weten voor we beginnen.

Wanneer wordt KSeF echt verplicht en voor wie?
KSeF is voor B2B-facturen in Polen aangekondigd als verplicht systeem. De Poolse overheid heeft de exacte ingangsdatum een aantal keer verschoven; de meest recente planning is een gefaseerde verplichting vanaf 2026 voor grote belastingplichtigen en daarna voor de rest van het MKB. Wij houden de roadmap in de gaten en plannen uw integratie zo dat hij ruim vóór uw deadline werkend in de sandbox staat. Belangrijk om te beseffen: zodra het mandaat ingaat, accepteert de fiscus geen papieren of PDF-factuur meer als geldig fiscaal document. Wat u verstuurt buiten KSeF om, telt formeel niet — uw afnemer kan de BTW dan niet terugvragen en u staat in feite zonder erkende factuur.
Wat is FA(3) en waarom is dat schema zo strikt?
FA(3) is het XML-schema dat KSeF voorschrijft voor elektronische facturen — een gedetailleerde XSD met verplichte velden voor partijen, factuurregels, BTW-codes en correcties. Strikt omdat de Poolse fiscus de inhoud direct kan valideren en de factuur pas accepteert na schema-validatie. Naast pure schema-checks gelden er ook business-rules: bepaalde combinaties van BTW-tarieven en factuurtypes mogen niet, NIP-nummers moeten valideren tegen het Poolse register, en correctie-facturen verwijzen verplicht naar de originele factuur via UUID. Wij doen die validatie ook aan onze kant, vóór submission, zodat afwijzingen zeldzaam worden.
Hoe koppelen jullie SAP IDoc INVOIC aan KSeF?
Met een middleware-laag tussen SAP en KSeF. De IDoc wordt opgepikt (via RFC, file-port of een EDI-broker), getransformeerd naar FA(3)-XML, ondertekend met het gekwalificeerd certificaat en ingediend bij KSeF. De ontvangst-bevestiging of afwijzing schrijven we terug naar SAP — als IDoc-status, custom Z-tabel of e-mail-notificatie, afhankelijk van wat uw SAP-team prettig vindt. We houden uw SAP-systeem expliciet leeg: geen Z-development binnen SAP, geen aanpassingen aan standaard-IDoc-segmenten. Alle KSeF-specifieke logica zit buiten SAP, in een aparte service die wij beheren of die u na overdracht zelf draait.
Kunnen we eerst veilig testen in een sandbox?
Ja — KSeF heeft een aparte sandbox-omgeving die identiek is aan productie qua API en schema. We bouwen daar als eerste tegen, runnen een volledige end-to-end-test met echte factuurdata, en pas als de signature-flow, submission, callback en error-paden allemaal kloppen schakelen we over naar productie. De overgang zelf is een config-switch, geen code-wijziging. In de sandbox simuleren we ook bewust fout-scenarios: een verkeerd BTW-tarief, een ontbrekend NIP, een timeout op de KSeF-kant, een ingetrokken signature. Pas als die paden netjes worden afgehandeld gaan we live.
Hoe doen we Exact Online of AFAS richting KSeF?
Voor Exact Online bouwen we de koppeling op de Exact Online API; AFAS leveren we via Profit-connectoren of GetConnectoren aan. De integratie-laag tussen uw boekhoudpakket en KSeF leeft als losse service, zodat een upgrade van Exact of AFAS de KSeF-koppeling niet breekt. Zie ook onze Exact Online integratie-pagina voor de Exact-kant. Voor AFAS gebruiken we doorgaans een GetConnector om factuurdata uit te trekken, een UpdateConnector om de KSeF-status terug te schrijven, en een aparte service voor de KSeF-submission zelf. Zo blijft de AFAS-omgeving binnen scope van uw AFAS-consultant en de KSeF-laag binnen onze scope.
Werkt dit naast Peppol voor andere EU-landen?
Ja. Peppol is in opkomst als universeel e-invoicing-netwerk voor de EU, terwijl Polen met KSeF een eigen verplicht systeem heeft. Veel multinationals lopen tegen die parallelle wereld aan. We bouwen routing-logica die per ontvanger-land en BTW-positie kiest tussen Peppol, KSeF of een ander mandaat (bijvoorbeeld SDI in Italië of FacturaE in Spanje). Eén platform, meerdere kanalen, één gedeelde audit-log. Dat scheelt enorm in beheer: één integratie-team, één set monitoring-dashboards, één plek waar de finance-controller kijkt naar afgewezen facturen.
Hoe zit het met archivering en de bewaarplicht?
Poolse fiscale wetgeving eist langjarige archivering van factuurdata; doorgaans tien jaar. We zetten versleutelde opslag op in uw cloud of bij ons, met onveranderbare logging (write-once) en een audit-trail die laat zien wie wanneer welke factuur heeft ingezien of geëxporteerd. Toegang verloopt via uw IdP (Azure AD, Okta, Google Workspace) zodat het binnen uw bestaande security-beleid valt. Naast de FA(3)-XML bewaren we ook de bijbehorende KSeF-UUID, de tijdstempel van acceptatie en — waar relevant — de originele bron-IDoc of API-response, zodat u bij een audit het volledige spoor kunt overleggen.
Wat als KSeF onze factuur afwijst — wie corrigeert wat?
Afwijzingen komen in alle smaken: schema-fouten (een veld dat niet matcht), business-rule-fouten (ongeldig NIP, verkeerd BTW-tarief), of technische fouten aan de KSeF-kant (timeout, onderhoud). Wij scheiden die paden in code: schema-fouten gaan terug naar uw finance-team met een leesbare uitleg, business-rule-fouten triggeren een handmatige review, en technische fouten doen we automatisch opnieuw met exponential backoff. Niets verdwijnt in een logfile waar niemand naar kijkt — alles staat in het ops-dashboard met een actie-knop.
Wat kost een KSeF-integratie?
Dat hangt sterk af van de scope — één ERP en één entiteit is een kort traject, een multi-entity opzet met SAP IDoc-flows en Peppol-overlap is een groter traject. In het eerste gesprek nemen we de scope door en koppelen we daarna een sprintbudget terug. Geen open-eind-uurtjes; vaste budgetten per sprint. We benoemen ook expliciet welke risico's nog niet binnen scope vallen (bijvoorbeeld nieuwe FA-versies die Polen pas later publiceert) en hoe we die in beheer oppakken zonder dat het project oneindig uitloopt.

Praat met ons over uw KSeF-integratie.

Een kennismaking van een half uur, vrijblijvend. We luisteren naar uw factuurstroom, vragen door op uw ERP-landschap, en geven richting over scope, fasering en eventuele Peppol-overlap. Bouwt u op SAP, dan bekijken we ook hoe de IDoc-mapping uitvalt; bouwt u op Exact of AFAS, dan bespreken we de API-laag. Lees ondertussen onze pagina over slimme API-integraties en, als u uw boekhouding op maat wil houden, over accountant-software op maat. Voor bredere ERP-vraagstukken: ERP op maat en enterprise software ontwikkeling.

Edit Content