CR #1197 — Noventi / azh §302

Open questions

Seventeen questions, grouped by who can answer them. Most already have a recommendation from us — in those cases we need a yes or a different answer, not a discussion.

2026-09-19, extended 22 Sep for CR #1319 · based on the §302 Datenmapping, the §302 e-billing specification, the azhDirekt 2.4 and azhIndex 1.0 interface specifications, and a review of the existing Maptara billing data model.
What we have already settled, so it does not need discussing

The field mapping is complete. All 34 fields across the five blocks — Sendungsebene, Rechnungskopf, Versichertendaten, Kostenträger/Arzt and Positionsdaten — have a confirmed source in Maptara. No new custom fields are required; the data already exists on the patient, the doctor, the prescription document and the invoice lines.

The transport is understood: SFTP to edx.azh.de, directory to_azh/, Begleitdatei plus zipped Datendatei and PDFs, UTF-8, returns via *EPO/*AVO/*NVD/*DIFF files. The XSDs and worked examples have been validated against our data model.

We are not blocked on any of the questions below. They determine scope and correctness, not whether work can begin.

SETTLED — no discussion needed ✓ All 34 fields mapped to a Maptara source ✓ No new custom fields required ✓ Transport, file layout and encoding understood ✓ Schemas validated against our data model Work can begin without any answer below. WHAT THE 17 QUESTIONS DECIDE 6 change the scope 5 confirm a value we propose 4 are detail / UI 2 decide a later phase Where we have a recommendation we will build to it and keep it reversible. If only three are answered 1 · SFTP access — since 4 August 6 · EinlieferungsArt — paper or digital 10 · is the prescription printed from Maptara?
The mapping work is complete; these seventeen questions determine scope and correctness, not whether the work can start. Questions 12–17 concern the §302 e-billing specification (CR #1319).

For NOVENTI / azh Technical counterpart — Steven Mayer / azh support

1 SFTP access and SSH key exchange blocking

We need the edx.azh.de account created and the SSH key exchange arranged. Test access was offered in the ticket description and again in the note of 4 August 2026, and has not yet been taken up on our side.

Why it matters: azhDirekt has no separate test environment. Without the account we can build and validate the submission locally, but we cannot confirm that azh accepts what we produce until we are pointed at a real endpoint. Every day this waits is a day the first real submission moves later.

Our request: create the account and confirm whether SSH key authentication is available — we would prefer key over password for automated submission.

2 Is there any acceptance path before going live? blocking proof

Given there is no test environment, how do we validate a first submission without it being treated as a live claim? Options we can think of: a test Kundennummer, a flagged submission, or an agreed window in which NOVENTI checks and discards what we send.

Why it matters: the alternative is that our first ever §302 submission is also our first real one. For a billing interface that is an uncomfortable place to be, for both sides.

Our suggestion: a test Kundennummer, or an agreed first submission that NOVENTI reviews manually before it enters processing.

3 Sondererfassung1 = Maptara invoice number confirm

The Datenmapping proposes passing the Maptara invoice number (account.move.name) in Sondererfassung1, and notes that formal confirmation from NOVENTI is still outstanding.

Why it matters: one field, trivial to change now, but it is the identifier we would use to reconcile a rejection back to an invoice. If the field has format constraints — length, permitted characters — we need them before the first submission rather than after.

Our request: confirm the field is acceptable for this purpose, and tell us any format constraints.

4 Which LEGS keys apply per Kostenträger? scope

The Datenmapping lists this as open: which Leistungserbringergruppenschlüssel are valid for each Kostenträger.

Why it matters: LEGS is carried on every position line. We can build and test the mechanism without the list, but real submissions will be rejected if the wrong key is sent.

Our request: the mapping of Kostenträger to permitted LEGS keys, or the rule for deriving it.

5 Return files — which are guaranteed, and how quickly? detail

The specification describes four return file types: *EPO.xml, *AVO.xml, *NVD.xml and *DIFF.xml. We would like to know which of these are always produced for a submission, which are conditional, and what the expected turnaround is.

Why it matters: it determines how often Maptara should check for responses, and how long a submission stays in "submitted" before we treat silence as a problem worth surfacing to a user.

For Maptara business Product decisions — these are yours, not NOVENTI's

6 EinlieferungsArt — paper only, or digital documents as well? changes scope

The interface supports paper submission (value 2) and digital document submission (values 1 and 3). The Datenmapping lists this as undecided.

Why it matters: this is the single largest scope question on the list. Paper-only means we transmit structured data and the prescriptions travel physically. Digital means every submission also carries the scanned prescription and supporting PDFs, which brings in document selection, file size handling and the packaging of those documents into the submission.

Our recommendation: start with paper (2) for the first live submissions, and add digital afterwards. It gets §302 billing working sooner and the digital path is an addition rather than a rework.

7 Expected volume per submission scope

The interface permits a maximum of 3 000 Verordnungen per Datendatei. How many invoices do you expect in a typical submission — tens, hundreds, or thousands? And how often would you submit: daily, weekly, monthly?

Why it matters: it tells us whether file splitting is an everyday occurrence that needs to be visible and manageable in the interface, or a safety limit nobody will ever reach.

8 How are invoices chosen for a submission? detail

All open §302 invoices at once, or explicit selection by the user?

Why it matters: it determines whether the user reviews what is about to be sent, or trusts a filter.

Our recommendation: explicit selection, as the Datenmapping also suggests. More control, and it makes the first live submissions far less nerve-racking.

9 Where should the submission action sit? detail

The Datenmapping proposes a manual button rather than automatic submission on invoice posting, which we agree with. Where should it live — in the action menu on a filtered invoice list, on the invoice itself, or in a dedicated §302 view?

Our recommendation: the action menu on a filtered invoice list, so a user selects, reviews and submits in one place.

10 Is the paper prescription printed from Maptara today? scope

The Datenmapping states that the VerordnungsId is printed as a Code 39 barcode onto the paper prescription (Muster 16), from Maptara. We need to know whether that printing already happens today and we are adding a barcode to an existing document, or whether the prescription printing itself is new work.

Why it matters: this is the one item in the specification that was not visible in any earlier planning, and the answer changes what it involves considerably.

11 Are payer-initiated processes in scope? scope

The ECE test plan includes two processes where the Kostenträger starts the conversation: Direktauftrag (the payer creates a delivery order) and Versorgungsanfrage (the payer asks whether we can supply, and requests a cost estimate). Today Maptara only sends and then polls for an answer.

Why it matters: supporting these means Maptara retrieves work that no user initiated, and we need to know what it becomes when it arrives — an order, a case, or something new. That is a business question rather than a technical one, and we would rather ask it than assume.

Our request: confirm whether these are wanted in the current phase. We are designing the interface so they can be added later without rework either way.

For Maptara product — CR #1319 Volker Einicke · the §302 e-billing specification

12 Is direct GKV-DTA required in the same release as azh, or is azh-first acceptable? changes scope

The §302 specification (§2.1) places both routes in Release 1. The azh route is fully specified and in progress. The direct route — EDIFACT ESOL/AUF per Technische Anlage 1 versions 21 and 22, certificate-based encryption, DAVASO validation, Dakota transmission, KOTR payer files — is a separate body of work with its own prerequisites, none of which are yet in hand.

Our recommendation: azh as Release 1, direct DTA as Release 2 on the same technical foundation. October is planned so that Release 2 plugs in rather than starts over.

13 Confirm the integration principle confirm

The specification itself (§4.2, §6.2) states that existing Odoo modules remain leading for pricing, contracts, supplies and approvals, and that the §302 module works from an immutable snapshot of them. We will implement exactly that: the existing claim, batch and provider models are extended; the workflow, field concepts and state names from the specification are adopted; the generated module serves as reference material.

Our request: a yes. This avoids two parallel case models and double data entry.

14 Which customer is the first direct-DTA user, and via which Datenannahmestelle? scope

The direct route cannot be built abstractly. It needs a real Datenannahmestelle, the TA1 test procedure, DAVASO access and payer certificates.

15 Pierenkemper — customer, logistics partner, or both? detail

Named twice in the requirements (picking list for paper logistics; accelerated billing) and nowhere in the specification.

16 The two items marked "mit Michael" scope

Accelerated billing at Pierenkemper, and whether to implement the full §302 parameter set or only the net-price logic. The second decides whether a parameter engine exists at all.

17 Who owns the paper process? detail

The specification (§22.2) makes "fix order → reserve invoice numbers → post in sequence → transfer to e-billing" the leading process. That is an accounting workflow touching invoice numbering and posting order, not an interface one.

If only three get answered

#QuestionConsequence of no answer
1SFTP accountWe can build and validate locally, but nothing is ever confirmed against azh. Outstanding since 4 August.
6EinlieferungsArt — paper or digitalThe largest scope variable on the list. We will proceed on paper-only unless told otherwise.
10Prescription printingDetermines whether the barcode is a small addition or a new document. Currently unknown to us.
How we will proceed while waiting

Where we have made a recommendation above, we will build to it unless told otherwise, and we will keep those choices easy to reverse. Nothing on this list prevents work starting — but questions 1, 6 and 10 will change either the timeline or the scope, so the earlier they are answered the less rework they cause.

Prepared by the Maptara development team. Sources: Maptara_azh_Datenmapping_§302 Schnittstelle neu; Schnittstellenbeschreibung azhDirekt HiMi V2.4; Schnittstellenbeschreibung azhIndex HiMi V1.0; ticket CR #1197 and the ECE test plan under CR #1173.