{"openapi":"3.1.2","info":{"title":"devacc ERiC workflow API","version":"0.2.0","description":"Headless ERiC preparation, validation and SaaS-delegated test review. SaaS users keep their own login and interface; machine OAuth/DPoP authenticates transport while a registered partner authority signs closed actor status and exact decisions. Partner-asserted evidence does not prove direct observation of a user action. Test reviews never authorize filing; separately bound test-transmission consents remain blocked from dispatch until independent qualification. Direct browser software-certificate intake supports encrypted custody and private local inspection; no transmission endpoint is enabled."},"servers":[{"url":"https://api.d0.eu/eric/v1"}],"paths":{"/products/{productId}/notices":{"get":{"operationId":"GetUserNotices","summary":"GetUserNotices","description":"Returns the pinned ERiC user notices for SaaS presentation before native use. The SaaS must offer acknowledgement for Appendix 2. Retrieval alone is not evidence that a notice was presented or acknowledged.","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Pinned ERiC user notices","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserNoticeBundle"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/profiles":{"post":{"operationId":"CreateProfile","summary":"CreateProfile","security":[{"dpop":["eric.products.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileInput"}}}}}},"/products/{productId}/profiles/{version}":{"get":{"operationId":"GetProfile","summary":"GetProfile","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"version","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ProfileVersion"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/drafts":{"post":{"operationId":"CreateDraft","summary":"CreateDraft","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftInput"}}}}}},"/products/{productId}/drafts/{draftId}":{"put":{"operationId":"ReviseDraft","summary":"ReviseDraft","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"draftId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftRevisionInput"}}}}},"get":{"operationId":"GetDraft","summary":"GetDraft","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"draftId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/drafts/{draftId}/revisions/{revision}":{"get":{"operationId":"GetDraftRevision","summary":"GetDraftRevision","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"draftId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/preparations":{"post":{"operationId":"CreatePreparation","summary":"CreatePreparation","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Preparation"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreparationInput"}}}}}},"/products/{productId}/preparations/{preparationId}":{"get":{"operationId":"GetPreparation","summary":"GetPreparation","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"preparationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Preparation"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/preparations/{preparationId}/artifacts/{kind}":{"get":{"operationId":"GetPreparationArtifact","summary":"GetPreparationArtifact","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"preparationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["payload.xml","review.html","review.json","manifest.json"]}}],"responses":{"200":{"description":"Successful operation","content":{"application/xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/html":{"schema":{"type":"string"}}},"headers":{"Content-Digest":{"description":"SHA-256 of exact returned bytes, RFC 9530.","schema":{"type":"string"}},"Content-Disposition":{"description":"Private attachment filename.","schema":{"type":"string"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/validations":{"post":{"operationId":"CreateValidation","summary":"CreateValidation","security":[{"dpop":["eric.validate"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"202":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation"}}},"headers":{"Location":{"description":"Canonical polling URL.","schema":{"type":"string"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationInput"}}}}}},"/products/{productId}/validations/{validationId}":{"get":{"operationId":"GetValidation","summary":"GetValidation","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"validationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/validations/{validationId}/artifacts/{kind}":{"get":{"operationId":"GetValidationArtifact","summary":"GetValidationArtifact","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"validationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["evidence.json","version.xml","result.xml","diagnostics.json"]}}],"responses":{"200":{"description":"Successful operation","content":{"application/xml":{"schema":{"type":"string"}},"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ValidationDiagnostics"},{"type":"object","additionalProperties":true,"description":"Existing evidence.json result envelope."}]}}},"headers":{"Content-Digest":{"description":"SHA-256 of exact returned bytes, RFC 9530.","schema":{"type":"string"}},"Content-Disposition":{"description":"Private attachment filename.","schema":{"type":"string"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Returns retained validation evidence. diagnostics.json is a versioned read projection bound to the frozen preparation and result. Check status before using findings: unavailable is not an empty successful validation. Empty locations mean a global finding. Native text is untrusted plain text; render it escaped. Existing evidence.json and XML bytes are unchanged."}},"/products/{productId}/preparations/{preparationId}/delegated-reviews":{"post":{"operationId":"CreateDelegatedReview","summary":"Create delegated test review","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"preparationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful delegated test review operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedReviewOpened"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedReviewInput"}}}}}},"/products/{productId}/delegated-reviews/{reviewId}":{"get":{"operationId":"GetDelegatedReview","summary":"Get delegated test review","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"reviewId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"200":{"description":"Successful delegated test review operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedReview"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/delegated-reviews/{reviewId}/confirmations":{"post":{"operationId":"ConfirmDelegatedReview","summary":"Confirm delegated test review","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"reviewId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful delegated test review operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedReview"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedDecisionInput"}}}}}},"/products/{productId}/delegated-reviews/{reviewId}/revocations":{"post":{"operationId":"RevokeDelegatedReview","summary":"Revoke delegated test review","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"reviewId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful delegated test review operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedReview"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedDecisionInput"}}}}}},"/products/{productId}/modules/ustva-2026/field-catalog":{"get":{"operationId":"GetUStVAFieldCatalog","summary":"Read the pinned UStVA 2026 final-field catalog","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAFieldCatalog"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Field shapes, labels, units and provenance; does not assert tax plausibility, enabled transmission or complete tax-calculation rules."}},"/products/{productId}/utilities":{"post":{"operationId":"CreateUtility","summary":"Enqueue a qualified credential-free local utility","security":[{"dpop":["eric.validate"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"202":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityJob"}}},"headers":{"Location":{"description":"Canonical polling URL.","schema":{"type":"string"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityInput"}}}}}},"/products/{productId}/utilities/{utilityId}":{"get":{"operationId":"GetUtility","summary":"Read local utility status and exact terminal result","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"utilityId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityJob"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/credential-intakes":{"post":{"operationId":"CreateCredentialIntake","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialIntake"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"dpop":["eric.credentials.manage"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialIntakeInput"}}}}}},"/products/{productId}/credentials/{credentialId}":{"get":{"operationId":"GetSoftwareCredential","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"credentialId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"X-ERIC-Credential-Origin","in":"header","required":true,"schema":{"type":"string","maxLength":512}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoftwareCredential"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"dpop":["eric.credentials.manage"]}]}},"/products/{productId}/credentials/{credentialId}/revoke":{"post":{"operationId":"RevokeSoftwareCredential","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"credentialId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"},{"name":"X-ERIC-Credential-Origin","in":"header","required":true,"schema":{"type":"string","maxLength":512}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoftwareCredential"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"dpop":["eric.credentials.manage"]}]}},"/products/{productId}/modules/ustva-2026/derived-rules":{"get":{"operationId":"GetUStVADerivedRules","summary":"Read pinned UStVA 2026 aggregation and formula rules","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVADerivedRules"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Exact source-pinned rule artifact for the restricted derived mode. Mapping confirmation remains a SaaS assertion; neither metadata nor compilation establishes tax plausibility or filing authority."}},"/products/{productId}/preparations/{preparationId}/filing-consents":{"post":{"operationId":"CreateFilingConsent","summary":"Create filing consent","description":"Preparation-specific partner-asserted consent for authorized test transmission only. Requires fresh v3/v4 filings.approve actor status. Transmission eligibility remains blocked; no native job or dispatch is created. With X-ERIC-Replay-Only: true, the same exact request and idempotency key only recover a previously committed 201 response under current machine, actor, authority and optional human grants. An unused key or changed request conflicts without creating a consent. Historical mandate or ownership revocation does not block this read-only recovery.","security":[{"dpop":["eric.filings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"preparationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/FilingHumanAuthorization"},{"$ref":"#/components/parameters/Idempotency"},{"name":"X-ERIC-Replay-Only","in":"header","required":false,"schema":{"type":"string","enum":["true"]}}],"responses":{"201":{"description":"Immutable consent evidence; not transmission eligibility.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingConsentOpened"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingConsentInput"}}}}}},"/products/{productId}/filing-consents/{consentId}":{"get":{"operationId":"GetFilingConsent","summary":"Get filing consent","description":"Preparation-specific partner-asserted consent for authorized test transmission only. Requires fresh v3/v4 filings.approve actor status. Transmission eligibility remains blocked; no native job or dispatch is created.","security":[{"dpop":["eric.filings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"consentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/FilingHumanAuthorization"}],"responses":{"200":{"description":"Immutable consent evidence; not transmission eligibility.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingConsent"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/filing-consents/{consentId}/confirmations":{"post":{"operationId":"ConfirmFilingConsent","summary":"Confirm filing consent","description":"Preparation-specific partner-asserted consent for authorized test transmission only. Requires fresh v3/v4 filings.approve actor status. Transmission eligibility remains blocked; no native job or dispatch is created.","security":[{"dpop":["eric.filings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"consentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/FilingHumanAuthorization"},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Immutable consent evidence; not transmission eligibility.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingConsent"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDecisionInput"}}}}}},"/products/{productId}/filing-consents/{consentId}/revocations":{"post":{"operationId":"RevokeFilingConsent","summary":"Revoke filing consent","description":"Preparation-specific partner-asserted consent for authorized test transmission only. Requires fresh v3/v4 filings.approve actor status. Transmission eligibility remains blocked; no native job or dispatch is created.","security":[{"dpop":["eric.filings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"consentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/FilingHumanAuthorization"},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Immutable consent evidence; not transmission eligibility.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingConsent"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDecisionInput"}}}}}},"/products/{productId}/credential-operations/{intakeId}":{"get":{"operationId":"GetCredentialOperation","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"intakeId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"X-ERIC-Credential-Origin","in":"header","required":true,"schema":{"type":"string","maxLength":512}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialOperation"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"dpop":["eric.credentials.manage"]}]}},"/products/{productId}/retrieval-artifacts/{artifactId}":{"get":{"operationId":"GetRetrievalArtifact","summary":"Read preserved retrieval artifact metadata","description":"Read an already published test-retrieval preservation. Requires current retrieval authority for the original machine, authority version and actor; a newer authorized actor revision is allowed. Remote mandate, qualification and credential expiry or rotation do not remove historical access. This does not query, download from ELSTER, decrypt, publish or acknowledge a mailbox item.","security":[{"dpop":["eric.retrievals.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"200":{"description":"Authenticated metadata for the exact preserved bytes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalArtifact"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/retrieval-artifacts/{artifactId}/{kind}":{"get":{"operationId":"GetRetrievalArtifactContent","summary":"Download exact preserved content or provenance","description":"Read an already published test-retrieval preservation. Requires current retrieval authority for the original machine, authority version and actor; a newer authorized actor revision is allowed. Remote mandate, qualification and credential expiry or rotation do not remove historical access. This does not query, download from ELSTER, decrypt, publish or acknowledge a mailbox item. Content is returned as application/octet-stream without format inference; provenance.json is the original authenticated preservation JSON. Both are attachments with no-store and nosniff.","security":[{"dpop":["eric.retrievals.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["content","provenance.json"]}}],"responses":{"200":{"description":"Exact authenticated artifact bytes","headers":{"Content-Digest":{"description":"SHA-256 of exact response bytes as sha-256=:base64:.","schema":{"type":"string"}},"Content-Length":{"description":"Exact byte count, including zero-length plaintext.","schema":{"type":"integer","format":"int64","minimum":0}},"Content-Disposition":{"description":"Fixed safe attachment filename.","schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/retrieval-artifacts/{artifactId}/archive-acknowledgement":{"post":{"operationId":"CreateRetrievalArchiveAcknowledgement","summary":"Record the client archive assertion for a preserved artifact","description":"Assert that the SaaS client archived the exact content and provenance bytes at its opaque archive reference. One immutable receipt per artifact; matching assertions, including with a new Idempotency-Key or newer authorized actor revision, return the first receipt. Changed digests or reference conflict. Fresh original retrieval authority and authentic source bytes are required before every write or replay. This is a client assertion, not verification of external storage, an ELSTER mailbox acknowledgement or permission to delete evidence. No remote address is fetched.","security":[{"dpop":["eric.retrievals.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/Idempotency"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalArchiveAcknowledgementInput"}}}},"responses":{"201":{"description":"First immutable client assertion, including exact and semantic replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalArchiveAcknowledgement"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/mappings":{"post":{"operationId":"CreateUStVAMapping","summary":"Create a UStVA source mapping","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Creates revision 1 of a caller-classified source mapping. Confirmation is a separate delegated decision.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingInput"}}}}}},"/products/{productId}/mappings/{mappingId}":{"put":{"operationId":"ReviseUStVAMapping","summary":"Create a new UStVA mapping revision","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingRevisionInput"}}}}},"get":{"operationId":"GetUStVAMapping","summary":"Read the latest UStVA mapping revision","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/mappings/{mappingId}/revisions/{revision}":{"get":{"operationId":"GetUStVAMappingRevision","summary":"Read a specific UStVA mapping revision","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/mappings/{mappingId}/revisions/{revision}/confirmations":{"post":{"operationId":"ConfirmUStVAMapping","summary":"Confirm a UStVA mapping revision","security":[{"dpop":["eric.mappings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReceipt"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingDecisionInput"}}}}}},"/products/{productId}/mappings/{mappingId}/revisions/{revision}/withdrawals":{"post":{"operationId":"WithdrawUStVAMapping","summary":"Withdraw a UStVA mapping confirmation","security":[{"dpop":["eric.mappings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReceipt"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UStVAMappingDecisionInput"}}}}}},"/products/{productId}/ebilanz-mappings":{"post":{"operationId":"CreateEBilanzMapping","summary":"Create an E-Bilanz source mapping","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Creates revision 1 of a caller-classified source mapping. Confirmation is a separate delegated decision.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingInput"}}}}}},"/products/{productId}/ebilanz-mappings/{mappingId}":{"put":{"operationId":"ReviseEBilanzMapping","summary":"Create a new E-Bilanz mapping revision","security":[{"dpop":["eric.write"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"$ref":"#/components/parameters/Idempotency"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingRevisionInput"}}}}},"get":{"operationId":"GetEBilanzMapping","summary":"Read the latest E-Bilanz mapping revision","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/ebilanz-mappings/{mappingId}/revisions/{revision}":{"get":{"operationId":"GetEBilanzMappingRevision","summary":"Read a specific E-Bilanz mapping revision","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingRevision"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/ebilanz-mappings/{mappingId}/revisions/{revision}/confirmations":{"post":{"operationId":"ConfirmEBilanzMapping","summary":"Confirm an E-Bilanz mapping revision","security":[{"dpop":["eric.mappings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReceipt"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingDecisionInput"}}}}}},"/products/{productId}/ebilanz-mappings/{mappingId}/revisions/{revision}/withdrawals":{"post":{"operationId":"WithdrawEBilanzMapping","summary":"Withdraw an E-Bilanz mapping confirmation","security":[{"dpop":["eric.mappings.manage"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"name":"mappingId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/MappingID"}},{"name":"revision","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Revision"}},{"$ref":"#/components/parameters/Idempotency"},{"$ref":"#/components/parameters/DelegatedActorStatus"}],"responses":{"201":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReceipt"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingDecisionInput"}}}}}},"/products/{productId}/modules/ebilanz-6.9/mapping-catalog":{"get":{"operationId":"GetEBilanzMappingCatalog","summary":"Read pinned E-Bilanz 6.9 monetary mapping metadata","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzMappingCatalog"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Requires the existing eric.read product/tenant binding. Returns a bounded deterministic mapping-target/dimension catalog with explicit applicability limits; the complete preparation must still validate. Missing private taxonomy configuration returns 503. No query overrides or runtime resource fetches."}},"/products/{productId}/retrieval-decryptions":{"post":{"operationId":"CreateRetrievalDecryption","description":"Queue local decryption of one already published authenticated download; no remote retrieval is initiated. Requires the original delegated retrieval principal and verified pre-use notice delivery.","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"$ref":"#/components/parameters/Idempotency"}],"security":[{"dpop":["eric.retrievals.manage"]}],"responses":{"202":{"description":"Local decryption metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalDecryption"}}},"headers":{"Location":{"description":"Canonical relative job URL for polling","schema":{"type":"string"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalDecryptionInput"}}}}}},"/products/{productId}/retrieval-decryptions/{decryptionId}":{"get":{"operationId":"GetRetrievalDecryption","description":"Read bounded local job metadata under fresh delegated retrieval authority. Returns no credentials, native result or plaintext. Completed processing does not publish an artifact.","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"decryptionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"security":[{"dpop":["eric.retrievals.manage"]}],"responses":{"200":{"description":"Local decryption metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalDecryption"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{productId}/retrieval-decryptions/{decryptionId}/preservation":{"post":{"operationId":"CreateRetrievalPreservation","description":"Publish a completed local decryption under fresh original delegated retrieval authority after authenticating its frozen source and native result. Publication never acknowledges the ELSTER mailbox. The preserved artifact ID equals this job ID.","parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/DelegatedActorStatus"},{"name":"decryptionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}},{"$ref":"#/components/parameters/Idempotency"}],"security":[{"dpop":["eric.retrievals.manage"]}],"responses":{"201":{"description":"Local decryption metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalDecryption"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalPreservationInput"}}}}}},"/products/{productId}/modules/ebilanz-6.9/form-plan":{"post":{"operationId":"PlanEBilanzForm","summary":"Plan source-backed fields for an explicit E-Bilanz annual case","security":[{"dpop":["eric.read"]}],"parameters":[{"$ref":"#/components/parameters/Tenant"},{"name":"productId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzFormPlan"}}}},"default":{"description":"Fail-closed problem response","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"description":"Stateless read-authorized planning, with existing product/tenant DPoP binding and strict case selector. No Idempotency-Key, domain write, outbox, draft, job, native execution or filing authority. Missing pinned taxonomy returns 503. Unsupported cases, malformed selectors and over-limit bodies fail closed. All final values and NIL decisions remain caller-supplied; complete preparation applies authoritative semantic checks.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EBilanzFormPlanInput"}}}}}}},"components":{"securitySchemes":{"dpop":{"type":"oauth2","description":"PS256 access token plus mandatory ES256 DPoP proof. Discovery at https://api.d0.eu/.well-known/oauth-protected-resource/eric.","flows":{"clientCredentials":{"tokenUrl":"https://auth.d0.eu/oauth2/token","scopes":{"eric.read":"eric.read","eric.write":"eric.write","eric.validate":"eric.validate","eric.products.manage":"eric.products.manage","eric.credentials.manage":"Manage scoped software credentials through signed actor permission and direct browser intake.","eric.filings.manage":"Manage scoped test-transmission consent through fresh signed actor permission. No transmission endpoint is enabled.","eric.retrievals.manage":"Queue and inspect local decryption of published downloads, preserve completed results, read preserved artifacts and assert client archival with fresh delegated retrieval authority.","eric.mappings.manage":"Manage delegated UStVA mapping confirmations and withdrawals."}}}}},"schemas":{"EBilanzFormPlanInput":{"type":"object","additionalProperties":false,"properties":{"reporting_start":{"type":"string","format":"date","description":"Explicit current reporting duration start inside fiscal year, required only for UB/LZB/ZW/UJ."},"reporting_end":{"type":"string","format":"date","description":"Explicit current reporting duration end inside fiscal year, required only for UB/LZB/ZW/UJ."},"ub_income_statement":{"type":"boolean","description":"UB-only explicit GuV/BVV component choice, including explicit false. Omit for all other statement types."},"tax_statement_type":{"type":"string","enum":["SB","EB"],"description":"MU annual tax statement selection: SB special or EB supplementary, distinct from opening statement_type EB. Omit for other legal forms."},"corporation_tax_option":{"type":"boolean","description":"Explicit section 1a KStG case assertion, bound to the GCD option. Omitted/false retains the ordinary case; true currently permits eligible domestic annual AO/GKV or UKV core reports without EV/MicroBilG. Filing remains denied."},"micro_bilg_prepared":{"type":"boolean","description":"Explicit MicroBilG preparation assertion for eligible corporation GKV cases."},"result_appropriation":{"type":"boolean","description":"Select annual corporation balance-profit presentation with EV."},"legal_form":{"type":"string","enum":["EU","EUF","EUN","GmbH","UG","AG","OHG","KG","GKG","AGKG","GOHG","AGOHG","GBR","PG","ASG","soPG","EWI","Other.MUN","MU"]},"income_statement_format":{"type":"string","enum":["GKV","UKV"],"default":"GKV"},"fiscal_start":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"closing_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"statement_type":{"type":"string","enum":["E","EB","UBandE","LSB","LAB","UB","LZB","ZW","UJ"],"default":"E"},"revision_status":{"type":"string","enum":["E","B","G","BG","I","sK"],"default":"E"},"fiscal_end":{"type":"string","format":"date","description":"Defaults to closing_date for existing cases; UB/LZB/ZW/UJ require explicit fiscal_end. Opening reports have closing_date equal fiscal_start; their fiscal_end may be later."},"accounting_standard":{"type":"string","enum":["AO","HAOE","HGBM"],"default":"AO"}},"required":["legal_form","fiscal_start","closing_date"],"description":"Read-only case selector, at most 1 KiB. No business facts, taxonomy overrides, native work or durable draft. Actual calendar dates and ordering are checked by the service."},"Problem":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"integer"}},"required":["type","title","status"]},"EBilanzFormPlan":{"type":"object","additionalProperties":false,"properties":{"entry_schema":{"type":"string","format":"uri","description":"Selected pinned fiscal taxonomy entry schema; MicroBilG has a distinct entry point even for opening reports."},"schema_version":{"type":"string","enum":["ebilanz-form-plan-v7","ebilanz-form-plan-v8","ebilanz-form-plan-v9","ebilanz-form-plan-v10","ebilanz-form-plan-v11","ebilanz-form-plan-v12","ebilanz-form-plan-v13","ebilanz-form-plan-v14","ebilanz-form-plan-v15","ebilanz-form-plan-v16","ebilanz-form-plan-v17","ebilanz-form-plan-v18","ebilanz-form-plan-v19","ebilanz-form-plan-v20"]},"procedure":{"type":"string","enum":["Bilanz_6.9"]},"taxonomy_version":{"type":"string","enum":["6.9"]},"taxonomy_archive_sha256":{"$ref":"#/components/schemas/Digest"},"technical_guides_archive_sha256":{"$ref":"#/components/schemas/Digest"},"semantic_rule_version":{"type":"string"},"case":{"type":"object","additionalProperties":false,"properties":{"reporting_start":{"type":"string","format":"date","description":"Explicit current reporting duration start inside fiscal year, required only for UB/LZB/ZW/UJ."},"reporting_end":{"type":"string","format":"date","description":"Explicit current reporting duration end inside fiscal year, required only for UB/LZB/ZW/UJ."},"ub_income_statement":{"type":"boolean","description":"UB-only explicit GuV/BVV component choice, including explicit false. Omit for all other statement types."},"tax_statement_type":{"type":"string","enum":["SB","EB"]},"tax_statement_type_label":{"type":"string"},"corporation_tax_option":{"type":"boolean","description":"Explicit section 1a KStG case assertion, bound to the GCD option. Omitted/false retains the ordinary case; true currently permits eligible domestic annual AO/GKV or UKV core reports without EV/MicroBilG. Filing remains denied."},"micro_bilg_prepared":{"type":"boolean"},"result_appropriation":{"type":"boolean"},"legal_form":{"type":"string","enum":["EU","EUF","EUN","GmbH","UG","AG","OHG","KG","GKG","AGKG","GOHG","AGOHG","GBR","PG","ASG","soPG","EWI","Other.MUN","MU"]},"legal_form_label":{"type":"string"},"income_statement_format":{"type":"string","enum":["GKV","UKV"]},"income_statement_format_label":{"type":"string"},"fiscal_start":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"closing_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"required_components":{"type":"array","items":{"type":"string","enum":["B","GuV","GuVMicroBilG","EV","BVV","SGE","SGEP","BAL","KS","STU","KKE"]}},"account_details_required":{"type":"boolean"},"account_detail_modes":{"type":"array","items":{"type":"string","enum":["provided","unavailable_with_footnote"]}},"statement_type":{"type":"string","enum":["E","EB","UBandE","LSB","LAB","UB","LZB","ZW","UJ"],"default":"E"},"revision_status":{"type":"string","enum":["E","B","G","BG","I","sK"],"default":"E"},"fiscal_end":{"type":"string","format":"date","description":"Defaults to closing_date for existing cases; UB/LZB/ZW/UJ require explicit fiscal_end. Opening reports have closing_date equal fiscal_start; their fiscal_end may be later."},"statement_type_label":{"type":"string"},"revision_status_label":{"type":"string"},"accounting_standard":{"type":"string","enum":["AO","HAOE","HGBM"],"default":"AO"},"accounting_standard_label":{"type":"string"}},"required":["micro_bilg_prepared","result_appropriation","legal_form","legal_form_label","income_statement_format","income_statement_format_label","fiscal_start","closing_date","required_components","account_details_required","account_detail_modes","statement_type","revision_status","fiscal_end","statement_type_label","revision_status_label","accounting_standard","accounting_standard_label"]},"case_bindings":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormBinding"}},"contexts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzContext"},"minItems":2,"maxItems":2},"fields":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormField"}},"presentation_edges":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormEdge"}},"calculation_edges":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormCalculation"}},"dimension_sets":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzMappingDimensionSet"}},"bal":{"type":"object","additionalProperties":false,"properties":{"required_when":{"type":"string","enum":["row_contains_value"]},"required_fields":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"}},"asset_axis":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"tax_axis":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"bases":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormBasis"}},"value_edges":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormEdge"}},"asset_edges":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormEdge"}},"calculation_edges":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormCalculation"}}},"required":["required_when","required_fields","asset_axis","tax_axis","bases","value_edges","asset_edges","calculation_edges"]},"limits":{"type":"array","items":{"type":"string"}},"period_rules":{"type":"object","additionalProperties":false,"properties":{"reporting_period_binding":{"type":"string","enum":["within_fiscal_year"]},"fiscal_start_min":{"type":"string","format":"date"},"fiscal_start_max":{"type":"string","format":"date"},"fiscal_end_min":{"type":"string","format":"date"},"fiscal_end_max":{"type":"string","format":"date"},"closing_date_binding":{"type":"string","enum":["fiscal_start","fiscal_end","within_fiscal_year"]},"self_employment_same_calendar_year":{"type":"boolean","const":true},"maximum_months":{"type":"integer","const":12}},"required":["fiscal_start_min","fiscal_start_max","fiscal_end_min","fiscal_end_max","closing_date_binding","self_employment_same_calendar_year","maximum_months"]},"reconciliation":{"$ref":"#/components/schemas/EBilanzFormReconciliation"},"partnership":{"$ref":"#/components/schemas/EBilanzFormPartnership"}},"required":["entry_schema","schema_version","procedure","taxonomy_version","taxonomy_archive_sha256","technical_guides_archive_sha256","semantic_rule_version","case","case_bindings","contexts","fields","presentation_edges","calculation_edges","dimension_sets","bal","limits","period_rules"],"description":"Deterministic 4 MiB-bounded form metadata for one supported case. No financial source values, raw archives or inferred tax decisions. This is not preparation, native validation, approval or transmission qualification."},"EBilanzFormPartnership":{"type":"object","additionalProperties":false,"properties":{"shareholder_tuple":{"type":"string"},"shareholder_id":{"type":"string"},"shareholder_group":{"type":"string"},"partner_axis":{"type":"string"},"tax_axis":{"type":"string"},"tax_member":{"type":"string"},"equity_axis":{"type":"string"},"equity_member_root":{"type":"string"},"kke_partner_groups":{"type":"array","items":{"type":"string"}},"kke_equity_member_roots":{"type":"object","additionalProperties":{"type":"string"},"description":"Source-backed active shareholder-group QName to permitted valued KKE equity-member root QName (6.9 B.19.1). Present in v9 through current v12 plans; absent from earlier historical plans."},"required_kke_fields":{"type":"array","items":{"type":"string"}}},"required":["shareholder_tuple","shareholder_id","shareholder_group","partner_axis","tax_axis","tax_member","equity_axis","equity_member_root","kke_partner_groups","required_kke_fields"],"description":"OHG/KG/GKG/AGKG/GOHG/AGOHG/GBR/PG/ASG/soPG AO/HAOE/HGBM GKV/UKV annual or AO/HAOE opening GHB shareholder/KKE linkage. KKE supports tax values only; commercial and transition columns remain unsupported. Typed partner-axis values equal the declared shareholder ID. Required cells apply to each selected concrete equity member and its source presentation ancestors; clients supply all final amounts and NIL decisions. Preparation enforces complete equations."},"EBilanzFormReconciliation":{"type":"object","additionalProperties":false,"properties":{"root_concept":{"type":"string"},"kind_concept":{"type":"string"},"kind_choices":{"type":"array","items":{"type":"string"}},"requires_nonzero":{"type":"boolean"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFormTransferEntry"}}},"required":["root_concept","kind_concept","kind_choices","requires_nonzero","entries"]},"EBilanzFormTransferEntry":{"type":"object","additionalProperties":false,"properties":{"concept":{"type":"string"},"target_concept":{"type":"string"},"current_delta_concept":{"type":"string"},"previous_delta_concept":{"type":"string"},"targets":{"type":"array","items":{"type":"string"}}},"required":["concept","target_concept","current_delta_concept","targets"]},"EBilanzFormCalculation":{"type":"object","additionalProperties":false,"properties":{"from":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"to":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"weight":{"type":"integer"},"network":{"type":"string"}},"required":["from","to","weight","network"]},"EBilanzFormEdge":{"type":"object","additionalProperties":false,"properties":{"from":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"to":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"component":{"type":"string","enum":["B","GuV","GuVMicroBilG","EV","BVV","SGE","SGEP","BAL","KKE"]}},"required":["from","to","component"]},"EBilanzFormBasis":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","enum":["tax","commercial","transition"]},"columns":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"minItems":1,"maxItems":3}},"required":["name","columns"]},"EBilanzMappingDimensionSet":{"type":"object","additionalProperties":false,"required":["id","axes"],"properties":{"id":{"$ref":"#/components/schemas/Digest"},"axes":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzMappingAxis"},"maxItems":16}}},"EBilanzMappingAxis":{"type":"object","additionalProperties":false,"required":["name","label","kind","members"],"properties":{"name":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string","enum":["explicit","typed"]},"typed_domain":{"type":"string"},"members":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzMappingMember"}}}},"EBilanzMappingMember":{"type":"object","additionalProperties":false,"required":["name","label","value_legal_forms"],"properties":{"name":{"type":"string"},"label":{"type":"string"},"value_legal_forms":{"type":"array","items":{"type":"string","enum":["EU","EUF","EUN","GmbH","UG","AG","OHG","KG","GKG","AGKG","GOHG","AGOHG","GBR","PG","ASG","soPG","EWI","Other.MUN","MU"]},"maxItems":19},"valid_since":{"type":"array","items":{"type":"string"}},"valid_through":{"type":"array","items":{"type":"string"}},"fiscal_valid_since":{"type":"string"},"fiscal_valid_through":{"type":"string"},"tax_prohibited_nonzero":{"type":"boolean"}},"description":"Member from a pinned effective dimension domain. Legal-form, date and tax-value restrictions must be respected; independent members do not establish complete BAL or filing validity."},"Digest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"EBilanzFormField":{"type":"object","additionalProperties":false,"properties":{"concept":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"label":{"type":"string"},"kind":{"type":"string","enum":["monetary","text","date","boolean","year","language","tuple","abstract","qname","positive_integer"]},"period":{"type":"string","enum":["","instant","duration"]},"allowed_states":{"type":"array","items":{"type":"string","enum":["value","nil","tuple"]},"maxItems":3},"required":{"type":"boolean"},"required_state":{"type":"string","enum":["value","nil","tuple"]},"required_when":{"type":"string","enum":["account_details_unavailable","kke_coordinate"]},"fiscal_requirement":{"type":"string"},"components":{"type":"array","items":{"type":"string","enum":["B","GuV","GuVMicroBilG","EV","BVV","SGE","SGEP","BAL","STU","KKE"]}},"pattern":{"type":"string"},"tuple":{"$ref":"#/components/schemas/EBilanzFormTuple"},"dimension_set_ids":{"type":"array","items":{"$ref":"#/components/schemas/Digest"}},"valid_since":{"type":"array","items":{"type":"string"}},"valid_through":{"type":"array","items":{"type":"string"}},"fiscal_valid_since":{"type":"string"},"fiscal_valid_through":{"type":"string"},"selection_value":{"type":"string","enum":[""],"description":"Exact empty lexical marker for a caller-selected string choice item; supplied only after explicit selection, never for a NIL fact."},"value_literal":{"type":"string","enum":["siehe Fußnote","false","true"],"description":"Exact current-case lexical value when reported with state value. The explanation pointer additionally requires explicit source footnote text; the corporate-tax option is bound to the selected case."},"footnote_required":{"type":"boolean","enum":[true],"description":"A nonblank plain-text footnote is required when this item is reported with state value; no default explanation is supplied."},"repeatable":{"type":"boolean","description":"Official repeatable top-level tuple; each occurrence has independent child identities."}},"required":["concept","label","kind","period","allowed_states","required","components","dimension_set_ids"],"description":"Explicit source-derived field metadata. Required describes ordinary presence. Required_state describes explicit current case constraints; optional selection/ancestor/BAL constraints still apply. No amount or NIL default is returned."},"EBilanzFormTuple":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["choice","sequence"]},"children":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"}},"required_children":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"}},"many":{"type":"boolean"},"selected_member":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"children_state":{"type":"string","enum":["nil"]},"repeatable_children":{"type":"array","items":{"type":"string"},"description":"Sequence children whose official xs:element maxOccurs is unbounded; other sequence children remain singletons."}},"required":["mode","children","required_children","many"]},"EBilanzContext":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"dimensions":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzDimension"},"minItems":0,"maxItems":16},"start_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"end_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"}},"required":["id","start_date","end_date"]},{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"dimensions":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzDimension"},"minItems":0,"maxItems":16},"instant":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"}},"required":["id","instant"]}],"description":"Exactly one instant or duration period. The module verifies date equality, semantic uniqueness and official dimensions."},"EBilanzDimension":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"member":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"}},"required":["name","member"]},{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"typed_value":{"type":"string","minLength":1,"maxLength":80}},"required":["name","typed_value"]}]},"EBilanzFormBinding":{"type":"object","additionalProperties":false,"properties":{"tuple_path":{"type":"array","maxItems":4,"items":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"description":"Exact outermost-to-innermost tuple ancestry for this binding, excluding the leaf. Explicit empty array means root fact. Present in v17; omitted historical bindings retain their original interpretation."},"concept":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"value_from":{"type":"string","enum":["fiscal_start","closing_date","tax_number","tax_office","literal_false","literal_true","company_name","street","postcode","city","fiscal_end"]}},"required":["concept","value_from"]},"ID":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"RetrievalPreservationInput":{"type":"object","additionalProperties":false,"properties":{}},"RetrievalDecryption":{"type":"object","additionalProperties":false,"required":["id","product_id","download_id","status","created_at","preserved"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"download_id":{"$ref":"#/components/schemas/ID"},"status":{"type":"string","enum":["queued","running","completed","failed"]},"created_at":{"type":"string","format":"date-time"},"preserved":{"type":"boolean"},"artifact_id":{"$ref":"#/components/schemas/ID"}}},"RetrievalDecryptionInput":{"type":"object","additionalProperties":false,"required":["download_id"],"properties":{"download_id":{"$ref":"#/components/schemas/ID"}}},"EBilanzMappingCatalog":{"type":"object","additionalProperties":false,"required":["schema_version","procedure","taxonomy_version","taxonomy_archive_sha256","semantic_rule_version","scope","targets","dimension_sets","limits"],"properties":{"schema_version":{"type":"string","enum":["ebilanz-mapping-metadata-v1"]},"procedure":{"type":"string","enum":["Bilanz_6.9"]},"taxonomy_version":{"type":"string","enum":["6.9"]},"taxonomy_archive_sha256":{"$ref":"#/components/schemas/Digest"},"semantic_rule_version":{"type":"string"},"scope":{"type":"object","additionalProperties":false,"required":["legal_forms","accounting_standard","income_statement_format","annual"],"properties":{"legal_forms":{"type":"array","items":{"type":"string","enum":["EU","GmbH","OHG","KG","GKG","AGKG","GOHG","AGOHG","GBR","PG","ASG","soPG","EWI","Other.MUN","MU"]},"maxItems":2},"accounting_standard":{"type":"string","enum":["AO"]},"income_statement_format":{"type":"string","enum":["GKV"]},"annual":{"type":"boolean","enum":[true]}}},"targets":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzMappingTarget"}},"dimension_sets":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzMappingDimensionSet"}},"limits":{"type":"array","items":{"type":"string"}}},"description":"Deterministic projection of the configured pinned taxonomy for mapping discovery, bounded to 4 MiB. Raw archives and private source facts are never returned. This is an offline candidate scope, not native qualification, filing approval, or transmission authority."},"EBilanzMappingTarget":{"type":"object","additionalProperties":false,"required":["concept","label","period","nillable","components","value_legal_forms","dimension_set_ids"],"properties":{"concept":{"type":"string"},"label":{"type":"string"},"period":{"type":"string","enum":["instant","duration"]},"nillable":{"type":"boolean"},"components":{"type":"array","items":{"type":"string","enum":["B","GuV","BVV","SGE","SGEP","BAL","KKE"]},"maxItems":5},"value_legal_forms":{"type":"array","items":{"type":"string","enum":["EU","EUF","EUN","GmbH","UG","AG","OHG","KG","GKG","AGKG","GOHG","AGOHG","GBR","PG","ASG","soPG","EWI","Other.MUN","MU"]},"maxItems":19},"dimension_set_ids":{"type":"array","items":{"$ref":"#/components/schemas/Digest"}},"valid_since":{"type":"array","items":{"type":"string"}},"valid_through":{"type":"array","items":{"type":"string"}},"fiscal_valid_since":{"type":"string"},"fiscal_valid_through":{"type":"string"},"fiscal_requirement":{"type":"string"}},"description":"Discoverable monetary target; value_legal_forms is permission for a non-NIL value, not proof of complete filing validity. Date boundaries, declared components, source context, ancestors, calculations and BAL relationships remain subject to preparation validation. Empty dimension_set_ids means an ordinary context without dimensions; otherwise use one complete referenced axis set."},"EBilanzMappingDecisionInput":{"type":"object","additionalProperties":false,"properties":{"signed_decision":{"type":"string","minLength":1,"maxLength":16384,"description":"Compact EdDSA JWS from the registered product approval authority, bound to the exact mapping revision, challenge, statement and requested action."}},"required":["signed_decision"]},"DecisionReceipt":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"mapping_id":{"$ref":"#/components/schemas/MappingID"},"revision":{"$ref":"#/components/schemas/Revision"},"action":{"type":"string","enum":["confirm","withdraw"]},"evidence_type":{"type":"string","enum":["partner_asserted"]},"mapping_sha256":{"$ref":"#/components/schemas/Digest"},"created_at":{"type":"string","format":"date-time"}},"required":["id","mapping_id","revision","action","evidence_type","mapping_sha256","created_at"]},"Revision":{"type":"integer","format":"int64","minimum":1,"maximum":2147483647},"MappingID":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"EBilanzMappingRevision":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/MappingID"},"product_id":{"$ref":"#/components/schemas/ID"},"revision":{"$ref":"#/components/schemas/Revision"},"document":{"$ref":"#/components/schemas/EBilanzMappingDocument"},"mapping_sha256":{"$ref":"#/components/schemas/Digest"},"challenge":{"type":"string","pattern":"^[0-9a-f]{64}$"},"statement_version":{"type":"string","enum":["eric.ebilanz-mapping-confirmation.v1"]},"statement":{"type":"string"},"status":{"type":"string","enum":["unconfirmed","confirmed","withdrawn"]}},"required":["id","product_id","revision","document","mapping_sha256","challenge","statement_version","statement","status"]},"EBilanzMappingDocument":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ebilanz-6.9-mapping-v1"]},"source_namespace":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"procedure":{"type":"string","enum":["Bilanz_6.9"]},"taxonomy_archive_sha256":{"$ref":"#/components/schemas/Digest"},"entries":{"type":"array","minItems":1,"maxItems":256,"items":{"$ref":"#/components/schemas/EBilanzMappingEntry"}}},"required":["schema_version","source_namespace","procedure","taxonomy_archive_sha256","entries"],"description":"Confirmed one-to-one classification of final monetary facts. The private pinned taxonomy validates each concept, period kind and dimension; no inferred tax treatment or account aggregation. Maximum document size 64 KiB."},"EBilanzMappingEntry":{"type":"object","additionalProperties":false,"properties":{"source_key":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"concept":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"context_kind":{"type":"string","enum":["instant","duration"]},"dimensions":{"type":"array","minItems":0,"maxItems":16,"items":{"$ref":"#/components/schemas/EBilanzDimension"}}},"required":["source_key","concept","context_kind","dimensions"]},"EBilanzMappingRevisionInput":{"type":"object","additionalProperties":false,"properties":{"expected_revision":{"$ref":"#/components/schemas/Revision"},"document":{"$ref":"#/components/schemas/EBilanzMappingDocument"}},"required":["expected_revision","document"]},"EBilanzMappingInput":{"type":"object","additionalProperties":false,"properties":{"document":{"$ref":"#/components/schemas/EBilanzMappingDocument"}},"required":["document"]},"UStVAMappingDecisionInput":{"type":"object","additionalProperties":false,"properties":{"signed_decision":{"type":"string","minLength":1,"maxLength":16384,"description":"Compact EdDSA JWS from the registered product approval authority, bound to the exact mapping revision, challenge, statement and requested action."}},"required":["signed_decision"]},"UStVAMappingRevision":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/MappingID"},"product_id":{"$ref":"#/components/schemas/ID"},"revision":{"$ref":"#/components/schemas/Revision"},"document":{"$ref":"#/components/schemas/UStVAMappingDocument"},"mapping_sha256":{"$ref":"#/components/schemas/Digest"},"challenge":{"type":"string","pattern":"^[0-9a-f]{64}$"},"statement_version":{"type":"string","enum":["eric.mapping-confirmation.v1"]},"statement":{"type":"string"},"status":{"type":"string","enum":["unconfirmed","confirmed","withdrawn"]}},"required":["id","product_id","revision","document","mapping_sha256","challenge","statement_version","statement","status"]},"UStVAMappingDocument":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-mapping-v1"]},"source_namespace":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"procedure":{"type":"string","enum":["UStVA_2026"]},"rule_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"rules_sha256":{"$ref":"#/components/schemas/Digest"},"entries":{"type":"array","minItems":1,"maxItems":256,"items":{"$ref":"#/components/schemas/UStVAMappingEntry"}}},"required":["schema_version","source_namespace","procedure","rule_version","rules_sha256","entries"]},"UStVAMappingEntry":{"type":"object","additionalProperties":false,"properties":{"source_key":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"group":{"type":"string","enum":["Kz21","Kz35","Kz37","Kz39","Kz41","Kz42","Kz43","Kz44","Kz45","Kz46","Kz48","Kz49","Kz50","Kz59","Kz60","Kz61","Kz62","Kz63","Kz64","Kz65","Kz66","Kz67","Kz69","Kz73","Kz76","Kz77","Kz81","Kz84","Kz86","Kz87","Kz89","Kz90","Kz91","Kz93","Kz94","Kz95"]}},"required":["source_key","group"]},"UStVAMappingRevisionInput":{"type":"object","additionalProperties":false,"properties":{"expected_revision":{"$ref":"#/components/schemas/Revision"},"document":{"$ref":"#/components/schemas/UStVAMappingDocument"}},"required":["expected_revision","document"]},"UStVAMappingInput":{"type":"object","additionalProperties":false,"properties":{"document":{"$ref":"#/components/schemas/UStVAMappingDocument"}},"required":["document"]},"RetrievalArchiveAcknowledgement":{"type":"object","additionalProperties":false,"required":["id","artifact_id","product_id","acknowledged_at","evidence_type","content_sha256","provenance_sha256","archive_reference"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"artifact_id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"acknowledged_at":{"type":"string","format":"date-time"},"evidence_type":{"type":"string","enum":["client_asserted"]},"content_sha256":{"$ref":"#/components/schemas/Digest"},"provenance_sha256":{"$ref":"#/components/schemas/Digest"},"archive_reference":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque client archive locator, at most 1024 UTF-8 bytes without control characters or surrounding whitespace. Stored encrypted; never fetched by the service."}}},"RetrievalArchiveAcknowledgementInput":{"type":"object","additionalProperties":false,"required":["content_sha256","provenance_sha256","archive_reference"],"properties":{"content_sha256":{"$ref":"#/components/schemas/Digest"},"provenance_sha256":{"$ref":"#/components/schemas/Digest"},"archive_reference":{"type":"string","minLength":1,"maxLength":1024,"description":"Opaque client archive locator, at most 1024 UTF-8 bytes without control characters or surrounding whitespace. Stored encrypted; never fetched by the service."}}},"RetrievalArtifact":{"type":"object","additionalProperties":false,"required":["id","product_id","purpose","preserved_at","content_media_type","content_bytes","content_sha256","provenance_media_type","provenance_bytes","provenance_sha256"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"purpose":{"type":"string","enum":["authorized_test_retrieval"]},"preserved_at":{"type":"string","format":"date-time"},"content_media_type":{"type":"string","enum":["application/octet-stream"]},"content_bytes":{"type":"integer","format":"int64","minimum":0,"maximum":4194304},"content_sha256":{"$ref":"#/components/schemas/Digest"},"provenance_media_type":{"type":"string","enum":["application/json"]},"provenance_bytes":{"type":"integer","format":"int64","minimum":1,"maximum":8192},"provenance_sha256":{"$ref":"#/components/schemas/Digest"}}},"CredentialOperation":{"type":"object","additionalProperties":false,"required":["intake_id","credential_id","source_version_id","version_id","job_id","status","qualification"],"properties":{"intake_id":{"$ref":"#/components/schemas/ID"},"credential_id":{"$ref":"#/components/schemas/ID"},"source_version_id":{"$ref":"#/components/schemas/ID"},"version_id":{"$ref":"#/components/schemas/ID"},"job_id":{"$ref":"#/components/schemas/ID"},"status":{"type":"string","enum":["queued","running","completed","failed","revoked"]},"qualification":{"type":"string","enum":["unqualified"]}},"description":"Safe CEZ PIN-change operation state. Current credential metadata continues to describe the old version until this operation publishes successfully. No PIN, certificate, body hash or native properties are exposed."},"FilingDecisionInput":{"type":"object","additionalProperties":false,"properties":{"decision_jws":{"type":"string","minLength":1,"maxLength":16384,"description":"Closed eric-filing-decision+jwt JWS from the registered SaaS authority, binding exact consent hash, challenge, purpose, actor, action and expiry."}},"required":["decision_jws"]},"FilingConsent":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"preparation_id":{"$ref":"#/components/schemas/ID"},"mandate_id":{"$ref":"#/components/schemas/ID"},"binding_sha256":{"$ref":"#/components/schemas/Digest"},"binding_json":{"type":"string","maxLength":65536,"description":"Exact UTF-8 immutable binding JSON conforming to FilingBinding. Hash the decoded string bytes; do not reserialize."},"purpose":{"type":"string","enum":["authorized_test_transmission"]},"evidence_type":{"type":"string","enum":["partner_asserted"]},"transmission_eligibility":{"type":"string","enum":["blocked"]},"status":{"type":"string","enum":["pending","confirmed","revoked","expired"]},"expires_at":{"type":"string","format":"date-time"},"statement_version":{"enum":["eric.test-transmission-consent.v1"],"type":"string"},"statement":{"enum":["Ich autorisiere ausschließlich die TEST-Übermittlung der unveränderten, vollständig geprüften Vorbereitung mit dem hier gebundenen Verfahren, Zeitraum und Zertifikat. Dies ist keine Produktionsübermittlung und keine steuerliche Einreichung. Die Ausführung bleibt bis zur unabhängigen technischen Qualifikation gesperrt."],"type":"string"},"review_html":{"type":"string","description":"Complete exact frozen review. Display all contents in a script-free sandbox before consent."},"review_json":{"type":"string","description":"Exact UTF-8 review.json bytes as a string."},"manifest_json":{"type":"string","description":"Exact UTF-8 manifest.json bytes as a string."}},"required":["id","product_id","preparation_id","mandate_id","binding_sha256","binding_json","purpose","evidence_type","transmission_eligibility","status","expires_at","statement_version","statement","review_html","review_json","manifest_json"]},"FilingConsentInput":{"type":"object","additionalProperties":false,"properties":{"mandate_id":{"$ref":"#/components/schemas/ID"}},"required":["mandate_id"]},"FilingConsentOpened":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"preparation_id":{"$ref":"#/components/schemas/ID"},"mandate_id":{"$ref":"#/components/schemas/ID"},"binding_sha256":{"$ref":"#/components/schemas/Digest"},"binding_json":{"type":"string","maxLength":65536,"description":"Exact UTF-8 immutable binding JSON conforming to FilingBinding. Hash the decoded string bytes; do not reserialize."},"purpose":{"type":"string","enum":["authorized_test_transmission"]},"evidence_type":{"type":"string","enum":["partner_asserted"]},"transmission_eligibility":{"type":"string","enum":["blocked"]},"status":{"type":"string","enum":["pending","confirmed","revoked","expired"]},"expires_at":{"type":"string","format":"date-time"},"statement_version":{"enum":["eric.test-transmission-consent.v1"],"type":"string"},"statement":{"enum":["Ich autorisiere ausschließlich die TEST-Übermittlung der unveränderten, vollständig geprüften Vorbereitung mit dem hier gebundenen Verfahren, Zeitraum und Zertifikat. Dies ist keine Produktionsübermittlung und keine steuerliche Einreichung. Die Ausführung bleibt bis zur unabhängigen technischen Qualifikation gesperrt."],"type":"string"},"review_html":{"type":"string","description":"Complete exact frozen review. Display all contents in a script-free sandbox before consent."},"review_json":{"type":"string","description":"Exact UTF-8 review.json bytes as a string."},"manifest_json":{"type":"string","description":"Exact UTF-8 manifest.json bytes as a string."},"challenge":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Returned on creation and its exact idempotent retry. Retain server-side until the signed decision."}},"required":["id","product_id","preparation_id","mandate_id","binding_sha256","binding_json","purpose","evidence_type","transmission_eligibility","status","expires_at","statement_version","statement","review_html","review_json","manifest_json","challenge"]},"UStVADerivedRules":{"type":"object","additionalProperties":false,"required":["version","projection","tax_policy","formula","sources","groups"],"properties":{"version":{"type":"string"},"projection":{"type":"string"},"tax_policy":{"type":"string"},"formula":{"type":"string"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/UStVADerivedRuleSource"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/UStVADerivedRuleGroup"}}}},"UStVADerivedRuleGroup":{"type":"object","additionalProperties":false,"required":["group","base_field","tax_field","tax_required","result_sign"],"properties":{"group":{"type":"string"},"base_field":{"type":"string"},"tax_field":{"type":"string"},"tax_required":{"type":"boolean"},"result_sign":{"type":"integer","enum":[-1,0,1]}}},"UStVADerivedRuleSource":{"type":"object","additionalProperties":false,"required":["sha256"],"properties":{"url":{"type":"string"},"archive_sha256":{"$ref":"#/components/schemas/Digest"},"member":{"type":"string"},"sha256":{"$ref":"#/components/schemas/Digest"},"locator":{"type":"string"}}},"SoftwareCredential":{"type":"object","additionalProperties":false,"required":["id","version_id","job_id","status","qualification","credential_kind"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"version_id":{"$ref":"#/components/schemas/ID"},"job_id":{"$ref":"#/components/schemas/ID"},"status":{"type":"string","enum":["queued","running","inspected","failed","revoked","created"]},"qualification":{"type":"string","enum":["unqualified"]},"credential_kind":{"type":"string","enum":["software","cez"],"description":"Known CEZ are encryption-only. software identifies uploaded custody and is not evidence of ELSTER usability. version_id can be reserved while CEZ creation is pending."}},"description":"Opaque custody metadata only. A generated CEZ reaches created after encrypted bundle persistence. Inspected uploads remain unqualified. No secrets or native properties are returned."},"CredentialIntakeInput":{"type":"object","additionalProperties":false,"required":["origin","action"],"properties":{"origin":{"type":"string","maxLength":512},"action":{"type":"string","enum":["create","rotate","create-cez","change-cez-pin"]},"credential_id":{"$ref":"#/components/schemas/ID"},"expected_version_id":{"$ref":"#/components/schemas/ID"}},"description":"Reserve direct-browser custody. create and create-cez require no credential IDs; rotate and change-cez-pin require credential_id and expected_version_id. PIN changes admit only generated CEZ; ordinary CEZ rotation remains unavailable."},"CredentialIntake":{"type":"object","additionalProperties":false,"required":["intake_id","credential_id","version_id","job_id","expires_at","capability","upload_url"],"properties":{"intake_id":{"$ref":"#/components/schemas/ID"},"credential_id":{"$ref":"#/components/schemas/ID"},"version_id":{"$ref":"#/components/schemas/ID"},"job_id":{"$ref":"#/components/schemas/ID"},"expires_at":{"type":"string","format":"date-time"},"capability":{"type":"string","maxLength":24576},"upload_url":{"type":"string"}}},"UtilityJob":{"type":"object","additionalProperties":false,"required":["id","product_id","operation","status","attempts"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"operation":{"type":"string","enum":["check-iban","check-bic","check-tax-number","check-bufa","check-ewaz","check-idnr","check-widnr","format-tax-number","format-ewaz","convert-tax-number","convert-ewaz","tax-office-states","test-tax-offices","tax-offices","tax-office","field-choices"]},"status":{"type":"string","enum":["queued","running","completed","failed"]},"attempts":{"type":"integer","minimum":0},"result":{"$ref":"#/components/schemas/UtilityResult"}}},"UtilityResult":{"type":"object","additionalProperties":false,"required":["outcome"],"properties":{"outcome":{"type":"string","enum":["succeeded","rejected","failed"]},"failure":{"type":"string"},"response":{"$ref":"#/components/schemas/UtilityResponse"}}},"UtilityResponse":{"type":"object","additionalProperties":false,"required":["protocol","operation","request_sha256","sdk_release","sdk_archive_sha256","native_code","version_xml"],"properties":{"protocol":{"type":"integer","enum":[1]},"operation":{"type":"string","enum":["check-iban","check-bic","check-tax-number","check-bufa","check-ewaz","check-idnr","check-widnr","format-tax-number","format-ewaz","convert-tax-number","convert-ewaz","tax-office-states","test-tax-offices","tax-offices","tax-office","field-choices"]},"request_sha256":{"$ref":"#/components/schemas/Digest"},"sdk_release":{"type":"string","enum":["44.3.6.0"]},"sdk_archive_sha256":{"$ref":"#/components/schemas/Digest"},"native_code":{"type":"integer","minimum":0},"version_xml":{"type":"string","format":"byte","maxLength":5592408,"description":"Base64 of the exact SDK bytes."},"result_xml":{"type":"string","format":"byte","maxLength":5592408,"description":"Base64 of the exact SDK bytes."},"result_text":{"type":"string","format":"byte","maxLength":5592408,"description":"Base64 of the exact SDK bytes."}}},"UtilityInput":{"description":"Closed qualified local utility inputs. No XML, configuration, paths, credentials or transmission. Identifier results establish formal validity only; reference fetches do not establish tax validity.","oneOf":[{"type":"object","additionalProperties":false,"required":["operation","iban"],"properties":{"operation":{"type":"string","enum":["check-iban"]},"iban":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-bic"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-tax-number"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-bufa"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-ewaz"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-idnr"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["check-widnr"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["format-tax-number"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["format-ewaz"]},"value":{"type":"string","minLength":1,"maxLength":64}}},{"type":"object","additionalProperties":false,"required":["operation","value","state"],"properties":{"operation":{"type":"string","enum":["convert-tax-number"]},"value":{"type":"string","minLength":1,"maxLength":64},"state":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[0-9]{2}$"},"tax_office":{"type":"string","pattern":"^[0-9]{4}$"}}},{"type":"object","additionalProperties":false,"required":["operation","value","state"],"properties":{"operation":{"type":"string","enum":["convert-ewaz"]},"value":{"type":"string","minLength":1,"maxLength":64},"state":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","enum":["tax-office-states"]}}},{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","enum":["test-tax-offices"]}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["tax-offices"]},"value":{"type":"string","minLength":2,"maxLength":2}}},{"type":"object","additionalProperties":false,"required":["operation","value"],"properties":{"operation":{"type":"string","enum":["tax-office"]},"value":{"type":"string","minLength":4,"maxLength":4}}},{"type":"object","additionalProperties":false,"required":["operation","procedure"],"properties":{"operation":{"type":"string","enum":["field-choices"]},"value":{"type":"string","minLength":1,"maxLength":64},"procedure":{"type":"string","enum":["ESt_2025"]}}}]},"UStVAFieldCatalog":{"type":"object","additionalProperties":false,"required":["version","archive_sha256","schema_member","schema_sha256","periods","fields"],"properties":{"version":{"type":"string"},"archive_sha256":{"type":"string"},"schema_member":{"type":"string"},"schema_sha256":{"type":"string"},"periods":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"$ref":"#/components/schemas/UStVAFieldDefinition"}}}},"UStVAFieldDefinition":{"type":"object","additionalProperties":false,"required":["code","label","schema_type","kind","unit"],"properties":{"code":{"type":"string"},"label":{"type":"string"},"schema_type":{"type":"string"},"unit":{"type":"string"},"kind":{"type":"string","enum":["integer","decimal","choice","text","date"]},"whole_digits":{"type":"integer","minimum":1},"nonnegative":{"type":"boolean"},"choices":{"type":"array","items":{"type":"string"}},"choice_labels":{"type":"object","additionalProperties":{"type":"string"}},"max_length":{"type":"integer","minimum":1}}},"DelegatedDecisionInput":{"type":"object","additionalProperties":false,"required":["decision_jws"],"properties":{"decision_jws":{"type":"string","minLength":1,"maxLength":16384,"description":"Compact EdDSA JWS from the registered product approval authority; exact action and frozen review tuple are signed."}}},"DelegatedReview":{"type":"object","additionalProperties":false,"required":["id","product_id","preparation_id","draft_id","revision","profile_version","manifest_sha256","manifest_id","payload_sha256","review_html_sha256","review_json_sha256","statement_version","purpose","status","expires_at","statement","evidence_type","authority_id","authority_version","actor_id"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"preparation_id":{"$ref":"#/components/schemas/ID"},"draft_id":{"$ref":"#/components/schemas/ID"},"revision":{"type":"integer","format":"int64","minimum":1},"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"manifest_id":{"type":"string","pattern":"^[0-9a-f]{64}$"},"payload_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"review_html_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"review_json_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"statement_version":{"type":"string","enum":["eric.test-review.v1"]},"purpose":{"type":"string","enum":["test_review_only"]},"status":{"type":"string","enum":["pending","confirmed","revoked","expired"]},"expires_at":{"type":"string","format":"date-time"},"statement":{"type":"string"},"evidence_type":{"type":"string","enum":["partner_asserted"]},"authority_id":{"$ref":"#/components/schemas/ID"},"authority_version":{"type":"integer","format":"int64","minimum":1},"actor_id":{"type":"string","minLength":1,"maxLength":128}},"description":"SaaS-signed own-login assertion; ERiC did not observe the user reading or clicking. Test review only, never filing consent."},"ProfileVersion":{"type":"string","pattern":"^[1-9][0-9]{0,9}$"},"DelegatedReviewInput":{"type":"object","additionalProperties":false,"required":["purpose"],"properties":{"purpose":{"type":"string","enum":["test_review_only"]}}},"DelegatedReviewOpened":{"type":"object","additionalProperties":false,"required":["id","product_id","preparation_id","draft_id","revision","profile_version","manifest_sha256","manifest_id","payload_sha256","review_html_sha256","review_json_sha256","statement_version","purpose","status","expires_at","statement","challenge","review_html","review_json","manifest_json","evidence_type","authority_id","authority_version","actor_id"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"preparation_id":{"$ref":"#/components/schemas/ID"},"draft_id":{"$ref":"#/components/schemas/ID"},"revision":{"type":"integer","format":"int64","minimum":1},"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"manifest_id":{"type":"string","pattern":"^[0-9a-f]{64}$"},"payload_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"review_html_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"review_json_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"statement_version":{"type":"string","enum":["eric.test-review.v1"]},"purpose":{"type":"string","enum":["test_review_only"]},"status":{"type":"string","enum":["pending","confirmed","revoked","expired"]},"expires_at":{"type":"string","format":"date-time"},"statement":{"type":"string"},"challenge":{"type":"string","pattern":"^[0-9a-f]{64}$"},"review_html":{"type":"string","description":"The complete exact UTF-8 frozen HTML review. Render all of it in a sandbox without scripts, then show the accompanying statement separately."},"review_json":{"type":"string","description":"Exact UTF-8 review.json artifact; hash the decoded string bytes, without reparsing or reserializing."},"manifest_json":{"type":"string","description":"Exact UTF-8 manifest.json artifact; hash the decoded string bytes, without reparsing or reserializing."},"evidence_type":{"type":"string","enum":["partner_asserted"]},"authority_id":{"$ref":"#/components/schemas/ID"},"authority_version":{"type":"integer","format":"int64","minimum":1},"actor_id":{"type":"string","minLength":1,"maxLength":128}},"description":"SaaS-signed own-login assertion; ERiC did not observe the user reading or clicking. Test review only, never filing consent."},"ValidationDiagnostics":{"type":"object","additionalProperties":false,"required":["schema","status","validation_id","preparation_id","procedure","payload_sha256","review_sha256","request_sha256","source_schema","findings"],"properties":{"schema":{"type":"string","enum":["eric.validation-diagnostics.v1"]},"status":{"type":"string","enum":["available","unavailable"]},"reason":{"type":"string","enum":["native_result_unavailable","unsupported_result","projection_limit"]},"validation_id":{"type":"string"},"preparation_id":{"type":"string"},"procedure":{"type":"string"},"payload_sha256":{"type":"string"},"review_sha256":{"type":"string","description":"SHA-256 of frozen review.json, to which all review_path pointers refer."},"request_sha256":{"type":"string"},"result_sha256":{"type":"string"},"source_schema":{"type":"string"},"native_code":{"type":"integer"},"findings":{"type":"array","maxItems":4096,"items":{"$ref":"#/components/schemas/ValidationDiagnosticFinding"}}},"description":"Additive read projection, never approval or submission authority. Findings preserve native order. Parsing is bounded to 4 MiB UTF-8 XML, 4096 findings, 64 semantic indices per finding and 64 KiB per string; findings JSON is capped at 3 MiB and the complete projection at 4 MiB. Unsupported or oversized evidence is unavailable, never truncated. Raw result.xml remains separately readable."},"ValidationDiagnosticFinding":{"type":"object","additionalProperties":false,"required":["kind","ticket","locations"],"properties":{"kind":{"type":"string","enum":["error","hint"]},"ticket":{"type":"string","description":"Exact native Nutzdatenticket; never normalized numerically."},"field_identifier":{"type":"string"},"multiple_line_index":{"type":"string"},"form_sequence":{"type":"string"},"form_line":{"type":"string"},"sub_area":{"type":"string"},"private_id":{"type":"string"},"rule_name":{"type":"string"},"code":{"type":"string","description":"Exact FachlicheFehlerId or FachlicheHinweisId string, when supplied."},"text":{"type":"string"},"semantic_indices":{"type":"array","maxItems":64,"items":{"$ref":"#/components/schemas/DiagnosticSemanticIndex"}},"locations":{"type":"array","items":{"$ref":"#/components/schemas/DiagnosticLocation"},"description":"Proven frozen review/source locations only. An empty array means global or ambiguous; no location is inferred from text."}}},"DiagnosticLocation":{"type":"object","additionalProperties":false,"required":["review_path"],"properties":{"review_path":{"type":"string","description":"JSON pointer into the immutable preparation review.json. A finding may reference several contributing inputs."},"concept":{"type":"string"},"context":{"type":"string"},"fact_id":{"type":"string"},"source_ref":{"type":"string"},"source_version":{"type":"string"}}},"DiagnosticSemanticIndex":{"type":"object","additionalProperties":false,"required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}},"Validation":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"preparation_id":{"$ref":"#/components/schemas/ID"},"status":{"type":"string","enum":["queued","running","completed","failed"]},"attempts":{"type":"integer","minimum":0},"outcome":{"type":"string","enum":["valid","rejected","failed"]},"native_code":{"type":"integer"}},"required":["id","product_id","preparation_id","status","attempts"]},"ValidationInput":{"type":"object","additionalProperties":false,"properties":{"preparation_id":{"$ref":"#/components/schemas/ID"}},"required":["preparation_id"]},"Preparation":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"draft_id":{"$ref":"#/components/schemas/ID"},"revision":{"$ref":"#/components/schemas/Revision"},"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"manifest_id":{"$ref":"#/components/schemas/Digest"},"payload_sha256":{"$ref":"#/components/schemas/Digest"},"status":{"type":"string","enum":["prepared"]}},"required":["id","product_id","draft_id","revision","profile_version","manifest_id","payload_sha256","status"]},"PreparationInput":{"type":"object","additionalProperties":false,"properties":{"draft_id":{"$ref":"#/components/schemas/ID"},"revision":{"$ref":"#/components/schemas/Revision"}},"required":["draft_id","revision"]},"Draft":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/ID"},"product_id":{"$ref":"#/components/schemas/ID"},"revision":{"$ref":"#/components/schemas/Revision"},"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"input":{"$ref":"#/components/schemas/PreparationModuleInput"}},"required":["id","product_id","revision","profile_version","input"]},"PreparationModuleInput":{"oneOf":[{"$ref":"#/components/schemas/UStVAInput"},{"$ref":"#/components/schemas/EBilanzInput"},{"$ref":"#/components/schemas/EBilanzMappedInput"}],"x-go-type":"json.RawMessage"},"EBilanzMappedInput":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ebilanz-core-6.9-mapped-v1"]},"source_snapshot_sha256":{"$ref":"#/components/schemas/Digest"},"mapping_id":{"$ref":"#/components/schemas/MappingID"},"mapping_revision":{"$ref":"#/components/schemas/Revision"},"draft":{"$ref":"#/components/schemas/EBilanzMappedMetadata"},"source_facts":{"type":"array","minItems":1,"maxItems":256,"items":{"$ref":"#/components/schemas/EBilanzMappedFact"}}},"required":["schema_version","source_snapshot_sha256","mapping_id","mapping_revision","draft","source_facts"],"x-go-type":"json.RawMessage","description":"Public source-key-mapped E-Bilanz input, at most 512 KiB. Names an exact confirmed revision. Compiler-private snapshots and caller-supplied confirmation are rejected."},"EBilanzMappedFact":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"context":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"unit":{"type":"string","enum":["EUR"]},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"source_ref":{"type":"string","minLength":1,"maxLength":160},"source_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_key":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"state":{"type":"string","enum":["value"]},"value":{"type":"string","maxLength":21,"pattern":"^(0\\.00|-?[1-9][0-9]*\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"footnote":{"type":"string","minLength":1,"maxLength":16384,"description":"Optional plain-text footnote on this item, never interpreted as markup. At most 16 KiB of UTF-8 per note, 128 notes and 128 KiB total per preparation. Blank-only text and non-XML characters fail semantic validation. Line breaks are preserved in the rendered footnote. Tuple footnotes are unsupported."}},"required":["id","context","unit","sources","source_ref","source_version","source_key","state","value"]},{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"context":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"unit":{"type":"string","enum":["EUR"]},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"source_ref":{"type":"string","minLength":1,"maxLength":160},"source_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_key":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"state":{"type":"string","enum":["nil"]},"footnote":{"type":"string","minLength":1,"maxLength":16384,"description":"Optional plain-text footnote on this item, never interpreted as markup. At most 16 KiB of UTF-8 per note, 128 notes and 128 KiB total per preparation. Blank-only text and non-XML characters fail semantic validation. Line breaks are preserved in the rendered footnote. Tuple footnotes are unsupported."}},"required":["id","context","unit","sources","source_ref","source_version","source_key","state"]}],"description":"One final monetary fact per source key. sources must contain source_ref. The confirmed mapping supplies the concept and exact dimensions; only value or NIL is accepted."},"EBilanzMappedMetadata":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ebilanz-core-6.9-v1"]},"source_revision":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"tax_number":{"type":"string","minLength":13,"maxLength":13,"pattern":"^[0-9]{4}0[0-9]{8}$"},"tax_office":{"type":"string","minLength":4,"maxLength":4,"pattern":"^[0-9]{4}$"},"supplier":{"type":"string","minLength":1,"maxLength":512},"closing_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"contexts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzContext"},"minItems":2,"maxItems":256},"facts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFact"},"minItems":0,"maxItems":5000},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzAccount"},"minItems":0,"maxItems":5000}},"required":["schema_version","source_revision","tax_number","tax_office","supplier","closing_date","contexts","facts"],"description":"Explicit E-Bilanz metadata, contexts, GCD facts and account details accompanying mapped monetary facts. The service supplies mapping_version. Explicit facts cannot override mapped target cells or identifiers."},"EBilanzAccount":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"number":{"type":"string","minLength":1,"maxLength":80},"label":{"type":"string","minLength":1,"maxLength":160},"balance":{"type":"string","minLength":4,"maxLength":21,"pattern":"^(0\\.00|-?[1-9][0-9]*\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"fact_id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"source":{"type":"string","minLength":1,"maxLength":160}},"required":["id","number","label","balance","fact_id","source"]},"EBilanzFact":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"concept":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"context":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"unit":{"type":"string","enum":["EUR"]},"state":{"type":"string","enum":["value"]},"value":{"type":"string","minLength":0,"maxLength":4096},"footnote":{"type":"string","minLength":1,"maxLength":16384,"description":"Optional plain-text footnote on this item, never interpreted as markup. At most 16 KiB of UTF-8 per note, 128 notes and 128 KiB total per preparation. Blank-only text and non-XML characters fail semantic validation. Line breaks are preserved in the rendered footnote. Tuple footnotes are unsupported."}},"required":["id","concept","sources","context","state","value"]},{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"concept":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"context":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z_][A-Za-z0-9._-]{0,79}$"},"unit":{"type":"string","enum":["EUR"]},"state":{"type":"string","enum":["nil"]},"footnote":{"type":"string","minLength":1,"maxLength":16384,"description":"Optional plain-text footnote on this item, never interpreted as markup. At most 16 KiB of UTF-8 per note, 128 notes and 128 KiB total per preparation. Blank-only text and non-XML characters fail semantic validation. Line breaks are preserved in the rendered footnote. Tuple footnotes are unsupported."}},"required":["id","concept","sources","context","state"]},{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"concept":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"state":{"type":"string","enum":["tuple"]},"children":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFact"},"minItems":1,"maxItems":5000}},"required":["id","concept","sources","state","children"]},{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"concept":{"type":"string","minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9._-]*:[A-Za-z_][A-Za-z0-9._-]*$"},"sources":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"minItems":1,"maxItems":100,"uniqueItems":true},"state":{"type":"string","enum":["nil"]}},"required":["id","concept","sources","state"]}],"description":"Closed value, nil item, populated tuple or nil tuple shapes. Nil tuples omit context, unit, value and children. Official concept/type/nillability, total fact count 5000 and tuple depth 4 are enforced by the pinned module."},"EBilanzInput":{"type":"object","additionalProperties":false,"properties":{"corporation_tax_option":{"type":"boolean","description":"Explicit section 1a KStG case assertion, bound to the GCD option. Omitted/false retains the ordinary case; true currently permits eligible domestic annual AO/GKV or UKV core reports without EV/MicroBilG. Filing remains denied."},"micro_bilg_prepared":{"type":"boolean","description":"Explicit customer assertion that this corporation's statements were prepared under MicroBilG. True selects the fiscal-microbilg entry schema; absent or false selects the ordinary fiscal schema."},"schema_version":{"type":"string","enum":["ebilanz-core-6.9-v1"]},"source_revision":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"mapping_version":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z][A-Za-z0-9._:-]{0,79}$"},"tax_number":{"type":"string","minLength":13,"maxLength":13,"pattern":"^[0-9]{4}0[0-9]{8}$"},"tax_office":{"type":"string","minLength":4,"maxLength":4,"pattern":"^[0-9]{4}$"},"supplier":{"type":"string","minLength":1,"maxLength":512},"closing_date":{"type":"string","format":"date","pattern":"^202[5-7]-[0-9]{2}-[0-9]{2}$"},"contexts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzContext"},"minItems":2,"maxItems":256},"facts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzFact"},"minItems":1,"maxItems":5000},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/EBilanzAccount"},"minItems":0,"maxItems":5000}},"required":["schema_version","source_revision","mapping_version","tax_number","tax_office","supplier","closing_date","contexts","facts"],"description":"Final reported facts and explicitly mapped Kontensalden under pinned E-Bilanz 6.9 artifacts. No caller-supplied profile, runtime, catalog or procedure overrides. Official semantic/taxonomy relationships, byte bounds and source mapping consistency are validated by the module; this shape is not qualification evidence."},"UStVAInput":{"oneOf":[{"$ref":"#/components/schemas/UStVAInputV1"},{"$ref":"#/components/schemas/UStVAInputV2"},{"$ref":"#/components/schemas/UStVADerivedInput"},{"$ref":"#/components/schemas/UStVAMappedInput"}],"x-go-type":"json.RawMessage"},"UStVAMappedInput":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-mapped-v1"]},"source_snapshot_sha256":{"$ref":"#/components/schemas/Digest"},"mapping_id":{"$ref":"#/components/schemas/MappingID"},"mapping_revision":{"$ref":"#/components/schemas/Revision"},"draft":{"$ref":"#/components/schemas/UStVADerivedMetadata"},"facts":{"type":"array","minItems":1,"maxItems":256,"items":{"$ref":"#/components/schemas/UStVAMappedFact"}}},"required":["schema_version","source_snapshot_sha256","mapping_id","mapping_revision","draft","facts"],"x-go-type":"json.RawMessage","description":"Public source-key-mapped UStVA input. The referenced confirmed mapping revision binds each source_key to a pinned group. Never supply final form fields or compiler-private representations."},"UStVAMappedFact":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_ref":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_key":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"base":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,12}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"tax":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,12}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"}},"required":["id","source_ref","source_version","source_key"],"anyOf":[{"required":["base"]},{"required":["tax"]}],"description":"Mapped fact input. The confirmed source mapping determines which base/tax fields are valid for its source_key; values remain caller-classified exact EUR amounts."},"UStVADerivedMetadata":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-v2"]},"source_revision":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"creation_date":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"year":{"type":"integer","enum":[2026]},"tax_office":{"type":"string","pattern":"^[0-9]{4}$"},"tax_number":{"type":"string","pattern":"^[0-9]{4}0[0-9]{8}$"},"supplier":{"$ref":"#/components/schemas/Supplier"},"taxpayer":{"$ref":"#/components/schemas/TaxpayerV2"},"period":{"type":"string","enum":["01","02","03","04","05","06","07","08","09","10","11","12","41","42","43","44"]},"correction":{"type":"boolean"},"economic_id":{"type":"string","pattern":"^DE[0-9]{9}$"}},"required":["schema_version","source_revision","creation_date","year","period","tax_office","tax_number","supplier","taxpayer"],"x-go-type":"json.RawMessage","description":"Reporting metadata for classified facts. Final fields and month are forbidden; period is explicit."},"TaxpayerV2":{"type":"object","additionalProperties":false,"properties":{"designation":{"type":"string","minLength":1,"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":60},"first_name":{"type":"string","minLength":1,"maxLength":30},"street":{"type":"string","minLength":1,"maxLength":33},"house_number":{"type":"string","pattern":"^[0-9]{1,9}$"},"postal_code":{"type":"string","pattern":"^[0-9]{5}$"},"city":{"type":"string","minLength":1,"maxLength":34},"name_prefix":{"type":"string","minLength":1,"maxLength":20},"name_suffix":{"type":"string","minLength":1,"maxLength":20},"house_number_suffix":{"type":"string","minLength":1,"maxLength":15},"address_supplement":{"type":"string","minLength":1,"maxLength":40},"foreign_postal_code":{"type":"string","minLength":1,"maxLength":13},"country":{"type":"string","minLength":1,"maxLength":20},"po_box_city":{"type":"string","minLength":1,"maxLength":34},"po_box":{"type":"string","minLength":1,"maxLength":10},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":70},"po_box_postal_code":{"type":"string","pattern":"^[0-9]{5}$"},"large_recipient_postal_code":{"type":"string","pattern":"^[0-9]{5}$"}},"required":["name"]},"Supplier":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":45},"street":{"type":"string","minLength":1,"maxLength":30},"house_number":{"type":"string","minLength":1,"maxLength":9},"postal_code":{"type":"string","minLength":1,"maxLength":12},"city":{"type":"string","minLength":1,"maxLength":30},"country":{"type":"string","minLength":1,"maxLength":20},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":70}},"required":["name","street","house_number","postal_code","city","country","phone","email"]},"UStVADerivedInput":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-derived-v1"]},"source_snapshot_sha256":{"$ref":"#/components/schemas/Digest"},"mapping_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"mapping_sha256":{"$ref":"#/components/schemas/Digest"},"draft":{"$ref":"#/components/schemas/UStVADerivedMetadata"},"facts":{"type":"array","minItems":1,"maxItems":256,"items":{"$ref":"#/components/schemas/UStVADerivedFact"}}},"required":["schema_version","source_snapshot_sha256","mapping_version","mapping_sha256","draft","facts"],"x-go-type":"json.RawMessage","description":"Restricted derived EUR mode. Aggregate exact cents before whole-euro projection; fractional aggregate bases fail. Preserve supplied tax cents and derive Kz83 using pinned form rules. Kz50/Kz37 are informational and never counted again in Kz83. Final fields and control/text/date Kennziffer fields are unsupported. Test-marked and unvalidated; no filing permission."},"UStVADerivedFact":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_ref":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"source_version":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"group":{"type":"string","enum":["Kz21","Kz35","Kz37","Kz39","Kz41","Kz42","Kz43","Kz44","Kz45","Kz46","Kz48","Kz49","Kz50","Kz59","Kz60","Kz61","Kz62","Kz63","Kz64","Kz65","Kz66","Kz67","Kz69","Kz73","Kz76","Kz77","Kz81","Kz84","Kz86","Kz87","Kz89","Kz90","Kz91","Kz93","Kz94","Kz95"]},"base":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,12}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$","description":"Exact caller-confirmed EUR amount; no rate calculation."},"tax":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,12}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$","description":"Exact caller-confirmed EUR amount; no rate calculation."}},"required":["id","source_ref","source_version","group"],"oneOf":[{"properties":{"group":{"type":"string","enum":["Kz21","Kz41","Kz42","Kz43","Kz44","Kz45","Kz48","Kz49","Kz60","Kz77","Kz87","Kz90","Kz91"]}},"required":["base"],"not":{"required":["tax"]}},{"properties":{"group":{"type":"string","enum":["Kz35","Kz46","Kz73","Kz76","Kz81","Kz84","Kz86","Kz89","Kz93","Kz94","Kz95"]}},"required":["base","tax"]},{"properties":{"group":{"type":"string","enum":["Kz59","Kz61","Kz62","Kz63","Kz64","Kz65","Kz66","Kz67","Kz69"]}},"required":["tax"],"not":{"required":["base"]}},{"properties":{"group":{"type":"string","enum":["Kz37","Kz39"]},"tax":{"type":"string","pattern":"^(0\\.00|[1-9][0-9]{0,12}\\.[0-9]{2}|0\\.(0[1-9]|[1-9][0-9]))$"}},"required":["tax"],"not":{"required":["base"]}},{"properties":{"group":{"type":"string","enum":["Kz50"]},"base":{"type":"string","pattern":"^(0\\.00|[1-9][0-9]{0,12}\\.[0-9]{2}|0\\.(0[1-9]|[1-9][0-9]))$"}},"required":["base"],"not":{"required":["tax"]}}],"x-go-type":"json.RawMessage","description":"Caller-confirmed annual group and exact amounts. Kz37/Kz39 tax and Kz50 base must be nonnegative per fact. Kz50 and Kz37 are additional informational reductions already reflected in the main groups; they do not affect Kz83. No classification inference; source references need not identify Accounting records."},"UStVAInputV2":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-v2"]},"source_revision":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"creation_date":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"year":{"type":"integer","enum":[2026]},"tax_office":{"type":"string","pattern":"^[0-9]{4}$"},"tax_number":{"type":"string","pattern":"^[0-9]{4}0[0-9]{8}$"},"supplier":{"$ref":"#/components/schemas/Supplier"},"taxpayer":{"$ref":"#/components/schemas/TaxpayerV2"},"fields":{"$ref":"#/components/schemas/UStVAFieldsV2"},"period":{"type":"string","enum":["01","02","03","04","05","06","07","08","09","10","11","12","41","42","43","44"]},"correction":{"type":"boolean"},"economic_id":{"type":"string","pattern":"^DE[0-9]{9}$"}},"required":["schema_version","source_revision","creation_date","year","period","tax_office","tax_number","supplier","taxpayer","fields"],"x-go-type":"json.RawMessage","description":"Final reported values, not automatic tax calculation. Every payload remains test-marked. Schema and native plausibility are separate checks."},"UStVAFieldsV2":{"type":"object","additionalProperties":false,"properties":{"Kz21":{"type":"string","description":"Nicht steuerbare sonstige Leistungen gemäß § 18b Satz 1 Nummer 2 UStG (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz22":{"type":"string","description":"Belege (z.B. Verträge, Rechnungen) werden gesondert eingereicht (flag)","enum":["1"]},"Kz26":{"type":"string","description":"Das SEPA-Lastschriftmandat soll ausnahmsweise (z. B. wegen Verrechnungswünschen) für diesen Voranmeldungszeitraum nicht verwendet werden. Ein ggf. verbleibender Restbetrag ist gesondert zu entrichten. (flag)","enum":["1"]},"Kz29":{"type":"string","description":"Verrechnung des Erstattungsbetrags erwünscht / Erstattungsbetrag ist abgetreten (Teilen Sie bitte die Verrechnungswünsche dem Finanzamt gesondert mit). (flag)","enum":["1"]},"Kz35":{"type":"string","description":"zu anderen Steuersätzen (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz36":{"type":"string","description":"zu anderen Steuersätzen (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz37":{"type":"string","description":"Minderung der abziehbaren Vorsteuerbeträge (in der Zeile $Kz66.Vordruckzeile$ aus Rechnungen von anderen Unternehmen (§ 15 Absatz 1 Satz 1 Nummer 1 UStG) sowie in den Zeilen $Kz63.Vordruckzeile$ und $Kz59.Vordruckzeile$ enthalten) (EUR)","pattern":"^(0\\.00|[1-9][0-9]{0,10}\\.[0-9]{2}|0\\.(0[1-9]|[1-9][0-9]))$"},"Kz39":{"type":"string","description":"Abzug der festgesetzten Sondervorauszahlung für Dauerfristverlängerung (in der Regel nur in der letzten Voranmeldung des Besteuerungszeitraums auszufüllen) (EUR)","pattern":"^(0\\.00|[1-9][0-9]{0,10}\\.[0-9]{2}|0\\.(0[1-9]|[1-9][0-9]))$"},"Kz41":{"type":"string","description":"Innergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) an Abnehmer mit Umsatzsteuer-Identifikationsnummer (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz42":{"type":"string","description":"Lieferungen des ersten Abnehmers bei innergemeinschaftlichen Dreiecksgeschäften (§ 25b UStG) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz43":{"type":"string","description":"Weitere steuerfreie Umsätze mit Vorsteuerabzug (z. B. Ausfuhrlieferungen, Umsätze nach § 4 Nummer 2 bis 7 UStG, Umsätze nach Verordnungen der EU) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz44":{"type":"string","description":"Innergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) neuer Fahrzeuge an Abnehmer ohne Umsatzsteuer-Identifikationsnummer (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz45":{"type":"string","description":"Übrige nicht steuerbare Umsätze (Leistungsort nicht im Inland) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz46":{"type":"string","description":"Sonstige Leistungen nach § 3a Absatz 2 UStG eines im übrigen Gemeinschaftsgebiet ansässigen Unternehmers (§ 13b Absatz 1 UStG) (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz47":{"type":"string","description":"Sonstige Leistungen nach § 3a Absatz 2 UStG eines im übrigen Gemeinschaftsgebiet ansässigen Unternehmers (§ 13b Absatz 1 UStG) (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz48":{"type":"string","description":"Steuerfreie Umsätze ohne Vorsteuerabzug (z. B. Umsätze nach § 4 Nummer 8 bis 29 oder § 19 Absatz 1 UStG) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz49":{"type":"string","description":"Innergemeinschaftliche Lieferungen (§ 4 Nummer 1 Buchstabe b UStG) neuer Fahrzeuge außerhalb eines Unternehmens (§ 2a UStG) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz50":{"type":"string","description":"Minderung der Bemessungsgrundlage (in den Zeilen $Kz81.Vordruckzeile$ bis $Kz76.Vordruckzeile$ enthalten) (whole EUR)","pattern":"^(0|[1-9][0-9]{0,12})$"},"Kz59":{"type":"string","description":"Vorsteuerabzug für innergemeinschaftliche Lieferungen neuer Fahrzeuge außerhalb eines Unternehmens (§ 2a UStG) sowie von Kleinunternehmern im Sinne des § 19 Absatz 1 UStG (§ 15 Absatz 4a UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz60":{"type":"string","description":"Steuerpflichtige Umsätze des leistenden Unternehmers, für die der Leistungsempfänger die Steuer nach § 13b Absatz 5 UStG schuldet (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz61":{"type":"string","description":"Vorsteuerbeträge aus dem innergemeinschaftlichen Erwerb von Gegenständen (§ 15 Absatz 1 Satz 1 Nummer 3 UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz62":{"type":"string","description":"Entstandene Einfuhrumsatzsteuer (§ 15 Absatz 1 Satz 1 Nummer 2 UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz63":{"type":"string","description":"Vorsteuerbeträge, die nach allgemeinen Durchschnittssätzen berechnet sind (§ 23a UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz64":{"type":"string","description":"Berichtigung des Vorsteuerabzugs (§ 15a UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz65":{"type":"string","description":"Steuer infolge des Wechsels der Besteuerungsform sowie Nachsteuer auf versteuerte Anzahlungen und ähnlichem wegen Steuersatzänderung (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz66":{"type":"string","description":"Vorsteuerbeträge aus Rechnungen von anderen Unternehmern (§ 15 Absatz 1 Satz 1 Nummer 1 UStG), aus Leistungen im Sinne des § 27 Absatz 40a UStG und aus innergemeinschaftlichen Dreiecksgeschäften (§ 25b Absatz 5 UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz67":{"type":"string","description":"Vorsteuerbeträge aus Leistungen im Sinne des § 13b UStG (§ 15 Absatz 1 Satz 1 Nummer 4 UStG) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz69":{"type":"string","description":"In Rechnungen unrichtig oder unberechtigt ausgewiesene Steuerbeträge (§ 14c UStG) sowie Steuerbeträge, die nach § 6a Absatz 4 Satz 2, § 17 Absatz 1 Satz 7, § 25b Absatz 2 UStG oder von einem Auslagerer oder Lagerhalter nach § 27 Absatz 40a UStG geschuldet werden. (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz70":{"type":"string","description":"Wechsel von der Kleinunternehmer-Regelung (§ 19 UStG) zur Regelbesteuerung\nDatum des Wechsels (date); compiler also checks real calendar dates","pattern":"^(0[1-9]|[12][0-9]|3[01])\\.(0[1-9]|1[0-2])\\.[0-9]{4}$"},"Kz73":{"type":"string","description":"Umsätze, die unter das GrEStG fallen (§ 13b Absatz 2 Nummer 3 UStG) (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz74":{"type":"string","description":"Umsätze, die unter das GrEStG fallen (§ 13b Absatz 2 Nummer 3 UStG) (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz76":{"type":"string","description":"Umsätze, für die eine Steuer nach § 24 UStG zu entrichten ist (Sägewerkserzeugnisse, Getränke und alkoholische Flüssigkeiten, z. B. Wein) (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz77":{"type":"string","description":"Lieferungen land- und forstwirtschaftlicher Betriebe nach § 24 UStG an Abnehmer mit Umsatzsteuer-Identifikationsnummer (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz80":{"type":"string","description":"Umsätze, für die eine Steuer nach § 24 UStG zu entrichten ist (Sägewerkserzeugnisse, Getränke und alkoholische Flüssigkeiten, z. B. Wein) (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz81":{"type":"string","description":"zum Steuersatz von 19 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz83":{"type":"string","description":"Verbleibende Umsatzsteuer-Vorauszahlung beziehungsweise verbleibender Überschuss (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz84":{"type":"string","description":"Andere Leistungen (§ 13b Absatz 2 Nummer 1, 2, 4 bis 12 UStG) (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz85":{"type":"string","description":"Andere Leistungen (§ 13b Absatz 2 Nummer 1, 2, 4 bis 12 UStG) (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz86":{"type":"string","description":"zum Steuersatz von 7 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz87":{"type":"string","description":"zum Steuersatz von 0 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz89":{"type":"string","description":"zum Steuersatz von 19 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz91":{"type":"string","description":"Steuerfreie innergemeinschaftliche Erwerbe von bestimmten Gegenständen und Anlagegold (§§ 4b und 25c UStG) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz93":{"type":"string","description":"zum Steuersatz von 7 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz90":{"type":"string","description":"zum Steuersatz von 0 Prozent (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz94":{"type":"string","description":"neuer Fahrzeuge (§ 1b Absatz 2 und 3 UStG) von Lieferern ohne Umsatzsteuer-Identifikationsnummer zum allgemeinen Steuersatz (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz95":{"type":"string","description":"zu anderen Steuersätzen (Bemessungsgrundlage) (whole EUR)","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz96":{"type":"string","description":"neuer Fahrzeuge (§ 1b Absatz 2 und 3 UStG) von Lieferern ohne Umsatzsteuer-Identifikationsnummer zum allgemeinen Steuersatz (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz98":{"type":"string","description":"zu anderen Steuersätzen (Steuer) (EUR)","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz500":{"type":"string","description":"In dieser Steueranmeldung (choice)","enum":["1","2","3","4"]},"Kz500_Begruendung":{"type":"string","description":"Ergänzende Angaben zur Steueranmeldung (text)","minLength":1,"maxLength":180}},"required":["Kz83"]},"UStVAInputV1":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["ustva-2026-v1"]},"source_revision":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"creation_date":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"year":{"type":"integer","enum":[2026]},"month":{"type":"string","pattern":"^(0[1-9]|1[0-2])$"},"tax_office":{"type":"string","pattern":"^[0-9]{4}$"},"tax_number":{"type":"string","pattern":"^[0-9]{4}0[0-9]{8}$"},"supplier":{"$ref":"#/components/schemas/Supplier"},"taxpayer":{"$ref":"#/components/schemas/Taxpayer"},"fields":{"$ref":"#/components/schemas/Fields"}},"required":["schema_version","source_revision","creation_date","year","month","tax_office","tax_number","supplier","taxpayer","fields"],"x-go-type":"json.RawMessage"},"Fields":{"type":"object","additionalProperties":false,"properties":{"Kz81":{"type":"string","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz86":{"type":"string","pattern":"^(0|-?[1-9][0-9]{0,12})$"},"Kz66":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"},"Kz83":{"type":"string","pattern":"^(0\\.00|-?[1-9][0-9]{0,10}\\.[0-9]{2}|-?0\\.(0[1-9]|[1-9][0-9]))$"}},"required":["Kz83"]},"Taxpayer":{"type":"object","additionalProperties":false,"properties":{"designation":{"type":"string","minLength":1,"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":60},"first_name":{"type":"string","minLength":1,"maxLength":30},"street":{"type":"string","minLength":1,"maxLength":33},"house_number":{"type":"string","pattern":"^[0-9]{1,9}$"},"postal_code":{"type":"string","pattern":"^[0-9]{5}$"},"city":{"type":"string","minLength":1,"maxLength":34}},"required":["designation","name","first_name","street","house_number","postal_code","city"]},"DraftRevisionInput":{"type":"object","additionalProperties":false,"properties":{"expected_revision":{"$ref":"#/components/schemas/Revision"},"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"input":{"$ref":"#/components/schemas/PreparationModuleInput"}},"required":["expected_revision","profile_version","input"]},"DraftInput":{"type":"object","additionalProperties":false,"properties":{"profile_version":{"$ref":"#/components/schemas/ProfileVersion"},"input":{"$ref":"#/components/schemas/PreparationModuleInput"}},"required":["profile_version","input"]},"Profile":{"type":"object","additionalProperties":false,"properties":{"product_id":{"$ref":"#/components/schemas/ID"},"version":{"$ref":"#/components/schemas/ProfileVersion"},"manufacturer_id":{"type":"string"},"product_name":{"type":"string","minLength":1,"maxLength":50},"product_version":{"type":"string","minLength":1,"maxLength":50},"registration_evidence_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"verified":{"type":"boolean"}},"required":["product_id","version","manufacturer_id","product_name","product_version","registration_evidence_sha256","verified"]},"ProfileInput":{"type":"object","additionalProperties":false,"properties":{"version":{"$ref":"#/components/schemas/ProfileVersion"},"manufacturer_id":{"type":"string","pattern":"^[0-9]{5}$"},"product_name":{"type":"string","minLength":1,"maxLength":50},"product_version":{"type":"string","minLength":1,"maxLength":50},"registration_evidence_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["version","manufacturer_id","product_name","product_version","registration_evidence_sha256"]},"UserNoticeBundle":{"type":"object","additionalProperties":false,"description":"Pinned ERiC notices for the SaaS to present before native use. The SaaS offers acknowledgement for Appendix 2. A read of this endpoint is not evidence of presentation or acknowledgement.","required":["schema_version","version","sdk_release","documentation_archive_sha256","license_document_sha256","license_member","notices"],"properties":{"schema_version":{"type":"string","enum":["eric.user-notices.v1"]},"version":{"type":"string","minLength":1},"sdk_release":{"type":"string","minLength":1},"documentation_archive_sha256":{"$ref":"#/components/schemas/Digest"},"license_document_sha256":{"$ref":"#/components/schemas/Digest"},"license_member":{"type":"string","minLength":1},"notices":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/UserNotice"}}}},"UserNotice":{"type":"object","additionalProperties":false,"description":"A notice that the SaaS presents before native use. When acknowledgement_offered is true, offer the user an acknowledgement action; retrieval is not presentation or acknowledgement evidence.","required":["id","title","text","sha256","acknowledgement_offered","source_section"],"properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"text":{"type":"string"},"sha256":{"$ref":"#/components/schemas/Digest"},"acknowledgement_offered":{"type":"boolean"},"source_section":{"type":"string","minLength":1}}}},"parameters":{"Tenant":{"name":"X-ERIC-Tenant","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ID"}},"Idempotency":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}},"DelegatedActorStatus":{"name":"X-ERIC-Actor-Status","in":"header","required":true,"description":"Fresh signed SaaS actor status JWS, bound to the registered authority and this machine client. Not included in mutation idempotency hashes.","schema":{"type":"string","maxLength":16384}},"FilingHumanAuthorization":{"name":"X-ERIC-Human-Authorization","in":"header","required":false,"description":"Exactly one Bearer human access token for ebilanz.app. Required for immutable combined_human_required authority versions; rejected for legacy versions. Independently verified alongside the machine DPoP credential, with exact operator binding and current action-specific local human permission through commit. Credentials are never returned.","schema":{"type":"string","minLength":1,"maxLength":16384}}}},"x-d0-environment":"production","x-d0-resource":"https://api.d0.eu/eric"}