ERP-NL

Factuurdocumentimport ​

Doel ​

Importeert en controleert factuurdocumenten uit een expliciet gebonden bron.

Functionele beschrijving ​

Deze prototypefunctie ondersteunt lokale tests met fictieve brondata. Zij staat standaard aan op latest en uit op alpha, beta en prod. Bronrechten blijven vereist. De eerste implementatie omvat documentimport; het bron-ERP blijft eigenaar van facturen, ontvangsten, saldi en boekingen. Live bronintegratie en verzending vragen afzonderlijke kwalificatie.

Belangrijkste functionaliteit ​

  • Feature key: ar_source_import
  • Categorie: Debiteuren
  • Onveranderlijke revisies en controleerbare importbewijzen.
  • Voorkomen van dubbele verwerking bij herhaalde import.
  • Afzonderlijke toegang per organisatie en bron.
  • Hervatbare gatewaypagina’s met atomaire opslag en zichtbare quarantaine.
  • Afzonderlijke broninventaris met aantallen, bedragen en controleerbare verschillen.

Proefimport uitvoeren ​

Deze technische proef gebruikt fictieve data en een expliciet ingerichte ICC-bronbinding. Een beheerder bereidt deze voor via het bestaande integratiedefinitiescherm; er is geen algemene importwizard voor eindgebruikers.

Inrichting voorbereiden ​

Open Integratiebeheer → Setup → Integraties. De demo-setup kan een fictieve TEST-connectie en conceptdefinitie demo-ar-invoice-snapshot-v2 voorbereiden. Selecteer expliciet het serviceaccount en controleer bron, juridische entiteit, afzender-/bankresolutie en actualiteit. Gebruik uitsluitend fictieve gegevens. De rol Serviceaccount factuurimport (ar_invoice_import_service) bevat alleen snapshot importeren/lezen; wijs die afzonderlijk toe binnen de organisatie.

Activeer de exacte beoordeelde contractversie en zet daarna de opgeslagen conceptdefinitie bewust op ACTIVE, met de verplichte eigenaarrol. Opslaan of demo-setup activeert een concept niet automatisch. Een actieve definitie of standaardrol vervangt de bronbinding en overige controles niet.

Snapshot aanbieden ​

  1. Laat een bevoegde beheerder controleren dat beide prototypefeatures actief zijn (standaard aan op latest). Controleer de exacte actieve INBOUND-definitie met contract ARInvoiceSnapshot.v2 en de bronbinding. Alleen TEST- of DEVELOPMENT-bronnen zijn toegestaan.
  2. Gebruik een aan die organisatie en bron gebonden serviceaccount met ar_communication.snapshots.import. Lever de canonieke snapshot aan via POST /api/v1/ar-invoice-snapshots?definition_id=<UUID> met een vaste Idempotency-Key. Bewaar de teruggegeven importreferentie.
  3. Lees het bijbehorende importbewijs met ar_communication.snapshots.read. Een identieke herhaling kan dezelfde uitkomst teruggeven; een conflicterende sleutel of revisie geeft 409. Ongeldige inhoud geeft 422 en moet aan de bron worden hersteld, niet met een nieuwe sleutel worden verhuld.
  4. Volg validatie afzonderlijk via GET /api/v1/ar-invoice-imports/{import_id}/validation met dezelfde organisatie, definitie en bronidentiteit en het snapshotleesrecht. Een importbewijs blijft onveranderlijk; validatievoortgang staat apart. De ingeplande opdracht vereist een actieve afzonderlijke validatieworker.

Een identieke herhaling hergebruikt import en validatieopdracht; een nieuwe bronrevisie krijgt eigen bewijs. Bij 429 is de validatiewachtrij vol: volg Retry-After en herhaal met dezelfde identiteit, zonder een dubbele import te forceren. Gebruik het Postman-pakket en de UI-procedure voor de uitvoerbare proef met geëxporteerde testwaarden.

De bron blijft eigenaar van de financiële gegevens. Een geslaagde import verstuurt geen factuur en bewijst geen gekwalificeerde productieverbinding.

Volledige JSON-invoer (#762) ​

De primaire testinrichting demo-ar-invoice-snapshot-v2 verwerkt volledige Invoice/CreditNote-gegevens zonder PDF/XML, bijlagen of afzenderbewijs. De historische v1-inrichting en bewijsbundels blijven intact; v1 is geen ondersteunde nieuwe importroute. Afzender- en bankresolutie zijn beheerd en versiegebonden; bestanden worden alleen gecontroleerd wanneer ze zijn meegeleverd. De interne lezer toont de gestructureerde factuur. PDF-generatie volgt in S5a op dezelfde bevroren data. Deze uitbreiding gebruikt de bestaande featuregrenzen, rechten en workercontroles; zij voegt geen feature key toe en wijzigt geen defaults of grants.

Voor menselijke inzage en de betekenis van validatiestatussen, zie Factuurcommunicatie. Technische bronbinding en menselijke organisatierechten hebben verschillende doelen.

Gerelateerde features ​

Status ​

  • Status: Prototype

Beschikbare releases ​

  • Vanaf release: n.v.t.