automapper-validation 0.1.57

AHB condition expression parsing, evaluation, and EDIFACT validation
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
{
  "generated_at": "2026-03-12T09:51:49Z",
  "ahb_file": "REQOTE_AHB_1_0a_Fehlerkorrektur_20250225.xml",
  "format_version": "FV2504",
  "conditions": {
    "15": {
      "confidence": "high",
      "reasoning": "DTM+76 absence check. DTM elements[0][0] is the qualifier. lacks_qualifier returns True when no DTM with qualifier 76 exists.",
      "description_hash": "cf402ed2",
      "is_external": false
    },
    "16": {
      "confidence": "high",
      "reasoning": "RFF+Z41 absence check in SG1. RFF elements[0][0] is the qualifier. lacks_qualifier returns True when no RFF with qualifier Z41 exists.",
      "description_hash": "78961ba8",
      "is_external": false
    },
    "494": {
      "confidence": "low",
      "reasoning": "Requires comparing 'this DE' value against the document creation timestamp (DTM+137). Without knowing which specific data element/segment this condition is applied to in the current validation context, a generic implementation cannot be written safely. The condition is context-dependent and the field being validated is not specified in the condition text alone.",
      "description_hash": "785470ce",
      "is_external": false
    },
    "23": {
      "confidence": "high",
      "reasoning": "LIN++Z68 presence check in SG27. The notation LIN++Z68 means elements[0] is empty and elements[1][0] is Z68.",
      "description_hash": "1f89f1e0",
      "is_external": false
    },
    "950": {
      "confidence": "high",
      "reasoning": "Format condition: Marktlokations-ID format. Field-level format constraint specifying the expected ID format. Always True as informational annotation.",
      "description_hash": "a9ddfaec",
      "is_external": false
    },
    "38": {
      "confidence": "low",
      "reasoning": "Checks if the product in PIA+5 DE7140 (within SG27) is marked in the Kapitel 4.4 code list column 'Auslöser' with 'Bei Schwellwertunter- / -überschreitung'. This requires external code list membership knowledge with attribute lookup that cannot be determined from the EDIFACT message structure alone.",
      "description_hash": "6762271c",
      "is_external": true
    },
    "509": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation describing Vorgangsnummer origin from IFTSTA CNI DE1490 — always applies unconditionally.",
      "description_hash": "3a807315",
      "is_external": false
    },
    "960": {
      "confidence": "medium",
      "reasoning": "Netzlokations-ID uses the same 11-digit Luhn check digit format as Marktlokations-ID. LOC+Z18 is the standard qualifier for Netzlokation.",
      "description_hash": "0ce0bd80",
      "is_external": false
    },
    "32": {
      "confidence": "high",
      "reasoning": "References the product code list defined in Kapitel 4.5 'Messprodukte für Werte nach Typ 2 aus Backend für LF und NB'. External code list membership check — allowed Messprodukte codes are defined in the AHB chapter, not derivable from message content.",
      "description_hash": "6bdbb7fc",
      "is_external": true
    },
    "2060": {
      "confidence": "medium",
      "reasoning": "LIN with DE1229=Z64 (Erforderliches Produkt Schaltzeitdefinitionen) must appear at most once. Per segment structure reference, DE1229 (Handlung, Code) is at elements[1][0]. Returns True when 0 or 1 such LIN segments exist.",
      "description_hash": "3990882e",
      "is_external": false
    },
    "18": {
      "confidence": "high",
      "reasoning": "IMD++Z55 presence check. The notation IMD++Z55 means elements[0] is empty and elements[1][0] is Z55. has_qualifier checks elements[1][0] == \"Z55\".",
      "description_hash": "607da843",
      "is_external": false
    },
    "31": {
      "confidence": "high",
      "reasoning": "References the product code list defined in Kapitel 4.3 'Konfigurationsprodukte Ad-Hoc-Steuerkanal'. Same pattern — external code list membership check.",
      "description_hash": "87915e25",
      "is_external": true
    },
    "935": {
      "confidence": "high",
      "reasoning": "Format condition: HHMM = 0500. Fixed time value constraint. Always True as informational annotation.",
      "description_hash": "192bd97e",
      "is_external": false
    },
    "2064": {
      "confidence": "medium",
      "reasoning": "LIN with DE1229=Z68 (Erforderliches Produkt Konfigurationserlaubnis für Werte nach Typ 2 aus SMGW) must appear at most once. Per segment structure reference, DE1229 is at elements[1][0]. Returns True when 0 or 1 such LIN segments exist.",
      "description_hash": "01a92450",
      "is_external": false
    },
    "43": {
      "confidence": "low",
      "reasoning": "Checks if PIA+5 DE7140 product code is listed in Kapitel 4.6.2 'Werte nach Typ 2 aus SMGW' column 'Auslöser' with value 'Bei Schwellwertunter- / -überschreitung'. This is a code list membership check against an external reference table — cannot be determined from the EDIFACT message alone.",
      "description_hash": "ac6da87d",
      "is_external": true
    },
    "491": {
      "confidence": "high",
      "reasoning": "Checks if the DTM value (CCYYMMDDHHMM) falls within German winter time (MEZ) as UTC. Directly maps to the is_mez_utc() format validation helper, which is the complement of is_mesz_utc().",
      "description_hash": "5e5e4325",
      "is_external": false
    },
    "42": {
      "confidence": "low",
      "reasoning": "Checks that the Messprodukt code is in the code list from Kapitel 4.6.2 'Werte nach Typ 2 aus SMGW'. This requires access to an external product code list that cannot be determined from the EDIFACT message alone.",
      "description_hash": "b2296bfe",
      "is_external": true
    },
    "490": {
      "confidence": "high",
      "reasoning": "Checks if the DTM value (CCYYMMDDHHMM) falls within German summer time (MESZ) as UTC. Directly maps to the is_mesz_utc() format validation helper, which implements EU DST rules for MESZ (UTC+2). Same pattern as Example 25.",
      "description_hash": "cb594882",
      "is_external": false
    },
    "39": {
      "confidence": "high",
      "reasoning": "Standard EDIFACT COM segment: elements[0] is C076 composite where [0][0]=DE3148 (channel address) and [0][1]=DE3155 (channel qualifier). Checking for EM (electronic mail) is a direct value comparison.",
      "description_hash": "eaf06e02",
      "is_external": false
    },
    "21": {
      "confidence": "high",
      "reasoning": "LIN++Z66 presence check in SG27. The notation LIN++Z66 means elements[0] is empty and elements[1][0] is Z66.",
      "description_hash": "a4358b45",
      "is_external": false
    },
    "33": {
      "confidence": "low",
      "reasoning": "Checks that the Messprodukt code is in the code list from Kapitel 4.4 'Messprodukte mit Konfigurationserlaubnis für Werte nach Typ 2 aus SMGW'. This requires access to an external product code list that is not derivable from the EDIFACT message alone.",
      "description_hash": "27513ce1",
      "is_external": true
    },
    "2063": {
      "confidence": "medium",
      "reasoning": "LIN with DE1229=Z67 (Erforderliches Messprodukt für Werte nach Typ 2 aus Backend) must appear at most once. Per segment structure reference, DE1229 is at elements[1][0]. Returns True when 0 or 1 such LIN segments exist.",
      "description_hash": "bc9b2e65",
      "is_external": false
    },
    "932": {
      "confidence": "high",
      "reasoning": "Format condition: HHMM = 2200. Fixed time value constraint. Always True as informational annotation.",
      "description_hash": "943b98c4",
      "is_external": false
    },
    "27": {
      "confidence": "medium",
      "reasoning": "Checks LOC+172 DE3225 value as a Netzlokation ID by exclusion: it is present but does not match Marktlokation format (11-digit Luhn) nor Messlokation format (33 alphanumeric). Medium confidence because there is no dedicated Netzlokation validator — the logic relies on the three location types being mutually exclusive and exhaustive for this qualifier.",
      "description_hash": "22632a16",
      "is_external": false
    },
    "10": {
      "confidence": "high",
      "reasoning": "Sparte (sector) information for a market participant ID is master data, not derivable from the EDIFACT message content itself. Whether a given MP-ID belongs to the electricity sector requires external lookup.",
      "description_hash": "43bf0d05",
      "is_external": true
    },
    "493": {
      "confidence": "medium",
      "reasoning": "Checks whether the MP-ID in NAD+MR belongs to the gas sector (Sparte Gas). Same reasoning as condition 492 — sector membership requires external registry lookup.",
      "description_hash": "75612dee",
      "is_external": true
    },
    "19": {
      "confidence": "high",
      "reasoning": "LIN++Z64 presence check in SG27. The notation LIN++Z64 means elements[0] is empty and elements[1][0] is Z64. has_qualifier checks elements[1][0] == \"Z64\".",
      "description_hash": "ea0d5689",
      "is_external": false
    },
    "502": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation indicating the field uses the Marktlokation ID. Not a boolean predicate — always returns True.",
      "description_hash": "9727b89c",
      "is_external": false
    },
    "40": {
      "confidence": "high",
      "reasoning": "Same COM segment structure as condition 39. Checks DE3155 qualifier against the four telephony-related codes TE (telephone), FX (fax), AJ, and AL. Direct value comparison in the same C076 composite element.",
      "description_hash": "d9351e4d",
      "is_external": false
    },
    "30": {
      "confidence": "high",
      "reasoning": "References the product code list defined in Kapitel 4.2 'Konfigurationsprodukte Leistungskurvendefinition'. Same pattern as condition 29 — external code list membership check.",
      "description_hash": "b558b9cd",
      "is_external": true
    },
    "503": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation indicating the field uses the Messlokation ID. Not a boolean predicate — always returns True.",
      "description_hash": "d7954b75",
      "is_external": false
    },
    "512": {
      "confidence": "high",
      "reasoning": "Hinweis (informational note): receipt of values after type 2 from SMGW. Documentation hint only, always True.",
      "description_hash": "5df791d3",
      "is_external": false
    },
    "903": {
      "confidence": "high",
      "reasoning": "Format condition: possible value is '1'. Format annotations in AHB are informational constraints on the field value, not dynamic Boolean conditions. Always True (the constraint is applied elsewhere during field validation).",
      "description_hash": "ef3b7862",
      "is_external": false
    },
    "2005": {
      "confidence": "medium",
      "reasoning": "SG27 must appear exactly once per message. LIN is the entry segment for SG27. Counting all LIN segments gives the SG27 instance count. Returns True when exactly one LIN exists.",
      "description_hash": "af782d7f",
      "is_external": false
    },
    "28": {
      "confidence": "high",
      "reasoning": "Condition checks whether the ID in LOC+172 DE3225 belongs to a Steuerbare Ressource. The segment structure provides the ID value (elements[1][0]), but determining whether that ID is registered as a Steuerbare Ressource requires external registry/business context lookup — it cannot be determined from the EDIFACT message content alone.",
      "description_hash": "c2b05a71",
      "is_external": true
    },
    "514": {
      "confidence": "high",
      "reasoning": "Hinweis (informational note): only one piece of information may be transmitted in DE3148. This is a cardinality hint, not a dynamic condition. Always True.",
      "description_hash": "b7cc061b",
      "is_external": false
    },
    "29": {
      "confidence": "high",
      "reasoning": "References the product code list defined in Kapitel 4.1 'Konfigurationsprodukte Schaltzeitdefinition'. Code list membership checks against external AHB chapter code tables cannot be evaluated from message content alone — the allowed product codes are defined externally.",
      "description_hash": "895d62df",
      "is_external": true
    },
    "510": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation about usage of Netzlokation ID — always applies unconditionally.",
      "description_hash": "9592f83e",
      "is_external": false
    },
    "501": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation describing usage context (contact for invoice processing). Not a boolean predicate — always returns True.",
      "description_hash": "d0394b26",
      "is_external": false
    },
    "967": {
      "confidence": "low",
      "reasoning": "Format: X.509 certificate body per BSI TR-03109-4. Validating an X.509 certificate body requires actual ASN.1/DER parsing — none of the available format validation helpers cover certificate validation. This cannot be implemented with the current EvaluationContext API.",
      "description_hash": "a58c2a1e",
      "is_external": false
    },
    "36": {
      "confidence": "medium",
      "reasoning": "Same pattern as condition 35: NAD+MS carries the sender MP-ID but the market role 'NB' (Netzbetreiber) cannot be inferred from the EDIFACT segment alone — requires external role registry.",
      "description_hash": "cbcd3843",
      "is_external": true
    },
    "2066": {
      "confidence": "low",
      "reasoning": "This condition requires looking up a product code (from PIA+5 DE7140 in the same SG27) against an external code list in Kapitel 4.6.2 ('Werte nach Typ 2 aus SMGW') to count how many entries have 'Bei Schwellwertunter- / -überschreitung' in the 'Auslöser' column. The code list content is external to the EDIFACT message and cannot be evaluated from segment data alone.",
      "description_hash": "528ae1cd",
      "is_external": true
    },
    "504": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation about usage of Tranche ID — always applies unconditionally.",
      "description_hash": "066912df",
      "is_external": false
    },
    "507": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation describing origin of the Vorgangsnummer — always applies unconditionally.",
      "description_hash": "c4344499",
      "is_external": false
    },
    "962": {
      "confidence": "high",
      "reasoning": "Format: max. 6 Vorkommastellen — uses validate_max_integer_digits with limit 6, applied to QTY value.",
      "description_hash": "36f7f4e8",
      "is_external": false
    },
    "492": {
      "confidence": "medium",
      "reasoning": "Checks whether the MP-ID in NAD+MR belongs to the electricity sector (Sparte Strom). The sector of a market participant cannot be derived from the EDIFACT message structure — it requires external market participant registry lookup. Delegated to external provider.",
      "description_hash": "bd78e2d8",
      "is_external": true
    },
    "516": {
      "confidence": "high",
      "reasoning": "Hinweis (informational note): a URI IPv6 must be provided. Documentation guidance only, always True.",
      "description_hash": "3a8b5b15",
      "is_external": false
    },
    "35": {
      "confidence": "medium",
      "reasoning": "NAD+MS identifies the sender by MP-ID (elements[0]=MS), but the market role 'LF' (Lieferant) cannot be determined from the NAD segment alone — it requires an external participant role registry lookup. The segment only carries the ID, not the role.",
      "description_hash": "67dbca70",
      "is_external": true
    },
    "934": {
      "confidence": "high",
      "reasoning": "Format condition: HHMM = 0400. Fixed time value constraint. Always True as informational annotation.",
      "description_hash": "d06a46c8",
      "is_external": false
    },
    "939": {
      "confidence": "high",
      "reasoning": "Format condition: string must contain '@' and '.' (email-like format). This is a field-level format constraint, not a dynamic segment condition. Always True as informational annotation.",
      "description_hash": "05a09b9a",
      "is_external": false
    },
    "940": {
      "confidence": "high",
      "reasoning": "Format condition: string must start with '+' followed only by digits (E.164 telephone number format). Field-level format constraint, not a dynamic conditional. Always True as informational annotation.",
      "description_hash": "de8363bc",
      "is_external": false
    },
    "931": {
      "confidence": "high",
      "reasoning": "Format condition: ZZZ = +00 (UTC timezone). This is a fixed-value format constraint on a DTM timezone component. Always True as informational annotation.",
      "description_hash": "825c510c",
      "is_external": false
    },
    "26": {
      "confidence": "high",
      "reasoning": "Checks LOC+172 DE3225 value and validates it as a Messlokation ID (33 alphanumeric characters / Zählpunkt format) using validate_zahlpunkt. Same element positions as condition 25.",
      "description_hash": "8581245d",
      "is_external": false
    },
    "17": {
      "confidence": "high",
      "reasoning": "RFF+Z41 presence check in SG1. RFF elements[0][0] is the qualifier. has_qualifier returns True when any RFF with qualifier Z41 exists.",
      "description_hash": "91c83dc2",
      "is_external": false
    },
    "24": {
      "confidence": "medium",
      "reasoning": "Whether a product should be ordered is a business-intent condition. In a REQOTE context this could theoretically be signalled by presence of PIA+5, but the AHB phrasing 'soll bestellt werden' indicates a business decision or workflow state that cannot be reliably inferred from message structure alone.",
      "description_hash": "504cb828",
      "is_external": true
    },
    "25": {
      "confidence": "high",
      "reasoning": "Checks LOC+172 DE3225 value and validates it as a Marktlokation ID (11 digits with Luhn check) using validate_malo_id. Element positions from schema: elements[0][0]=qualifier(172), elements[1][0]=DE3225(Identifikator).",
      "description_hash": "dda96b7c",
      "is_external": false
    },
    "515": {
      "confidence": "high",
      "reasoning": "Hinweis (informational note): a URI IPv4 must be provided. Documentation guidance only, always True.",
      "description_hash": "c27cdaf6",
      "is_external": false
    },
    "2065": {
      "confidence": "low",
      "reasoning": "This condition requires looking up a product code (from PIA+5 DE7140 in the same SG27) against an external code list in Kapitel 4.4 ('Messprodukte mit Konfigurationserlaubnis für Werte nach Typ 2 aus SMGW') to count how many entries have 'Bei Schwellwertunter- / -überschreitung' in the 'Auslöser' column. The code list content is external to the EDIFACT message and cannot be evaluated from segment data alone.",
      "description_hash": "2fd7e236",
      "is_external": true
    },
    "1": {
      "confidence": "high",
      "reasoning": "DTM+203 absence check. DTM elements[0][0] is the qualifier. lacks_qualifier returns True when no DTM with qualifier 203 exists.",
      "description_hash": "4554ba2c",
      "is_external": false
    },
    "2": {
      "confidence": "high",
      "reasoning": "DTM+469 absence check. DTM elements[0][0] is the qualifier. lacks_qualifier returns True when no DTM with qualifier 469 exists.",
      "description_hash": "21214a46",
      "is_external": false
    },
    "41": {
      "confidence": "low",
      "reasoning": "Checks that the Messprodukt code is in the code list from Kapitel 4.6.1 'Werte nach Typ 2 aus Backend'. This requires access to an external product code list that cannot be determined from the EDIFACT message alone.",
      "description_hash": "3c8c532a",
      "is_external": true
    },
    "20": {
      "confidence": "high",
      "reasoning": "LIN++Z65 presence check in SG27. The notation LIN++Z65 means elements[0] is empty and elements[1][0] is Z65.",
      "description_hash": "3a3e26d7",
      "is_external": false
    },
    "22": {
      "confidence": "high",
      "reasoning": "LIN++Z67 presence check in SG27. The notation LIN++Z67 means elements[0] is empty and elements[1][0] is Z67.",
      "description_hash": "ae126cd5",
      "is_external": false
    },
    "2061": {
      "confidence": "medium",
      "reasoning": "LIN with DE1229=Z65 (Erforderliches Produkt Leistungskurvendefinitionen) must appear at most once. Per segment structure reference, DE1229 is at elements[1][0]. Returns True when 0 or 1 such LIN segments exist.",
      "description_hash": "85aa6c68",
      "is_external": false
    },
    "961": {
      "confidence": "medium",
      "reasoning": "SR-ID (SteuerbareRessource-ID) uses the same 11-digit Luhn check digit format as MaLo-ID. LOC+Z19 is the standard qualifier for SteuerbareRessource.",
      "description_hash": "99d3e1d7",
      "is_external": false
    },
    "37": {
      "confidence": "low",
      "reasoning": "Checks that the Messprodukt-Position-Code is in the code list from Kapitel 4.7 'Art der Werte für Messprodukte nach Typ 2'. This requires access to an external product position code list that cannot be determined from the EDIFACT message alone.",
      "description_hash": "84946022",
      "is_external": true
    },
    "2062": {
      "confidence": "medium",
      "reasoning": "LIN with DE1229=Z66 (Erforderliches Produkt Ad-hoc-Steuerkanal) must appear at most once. Per segment structure reference, DE1229 is at elements[1][0]. Returns True when 0 or 1 such LIN segments exist.",
      "description_hash": "b38072ec",
      "is_external": false
    },
    "906": {
      "confidence": "high",
      "reasoning": "Format condition: max 3 decimal places. This is a field-level format constraint applied during value validation, not a dynamic conditional. Always True.",
      "description_hash": "97bdb0c7",
      "is_external": false
    },
    "508": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation describing value origin from IFTSTA BGM+Z73 — always applies unconditionally.",
      "description_hash": "5d5c40e1",
      "is_external": false
    },
    "500": {
      "confidence": "high",
      "reasoning": "Hinweis: informational annotation describing usage context (technical contact for device takeover). Not a boolean predicate — always returns True.",
      "description_hash": "c6b98d25",
      "is_external": false
    },
    "933": {
      "confidence": "high",
      "reasoning": "Format condition: HHMM = 2300. Fixed time value constraint. Always True as informational annotation.",
      "description_hash": "b5e9c81e",
      "is_external": false
    },
    "951": {
      "confidence": "high",
      "reasoning": "Zählpunktbezeichnung is a 33-character alphanumeric identifier. validate_zahlpunkt checks exactly this format.",
      "description_hash": "f35fc481",
      "is_external": false
    },
    "511": {
      "confidence": "high",
      "reasoning": "Hinweis (informational note): 'Verwendung der ID der Steuerbaren Ressource' — this is a documentation hint, not a conditional check. Always evaluates to True.",
      "description_hash": "9dd0a791",
      "is_external": false
    }
  }
}