@endevops/peppol-schema 0.1.3 → 0.1.5

package/dist/{index-BBzPjq7o.d.ts → index-XG-N6PcG.d.ts}

@@ -1,4 +1,3 @@
-import { i as ApplicationResponseTypeCodesKeys, s as CreditNoteTypeCodesKeys, t as VatDateCodesKeys } from "./vat-dates.generated-CxFvt7m3.js";
 import { DateTime, Schema } from "effect";
 //#region src/schemas/utils/opaque.d.ts
 /**
@@ -20,115 +19,36 @@ declare const PeppolIsoDateString_base: OpaqueSchema<PeppolIsoDateString, Schema
  */
 declare class PeppolIsoDateString extends PeppolIsoDateString_base {}
 //#endregion
-//#region src/schemas/fields/peppol-amount-schema.d.ts
-declare const PeppolAmount_base: OpaqueSchema<PeppolAmount, Schema.Struct<{
-  /**
-   * @name \@currencyID
-   */
-  readonly currencyId: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">;
-  /**
-   * @name #text (value)
-   */
-  readonly value: Schema.Finite;
-}>>;
+//#region src/schemas/utils/peppol-base-64-schema.d.ts
+declare const PeppolBase64_base: Schema.String;
 /**
- * @summary Monetary amount with mandatory currency
+ * @description RFC 4648 base64 string (PEM / MIME / XML line endings tolerated). Effect port of `base64Schema` (`z.string().check(z.refine(...))`): strips CRLF /
+ * LF line endings before testing the quantum regex.
  *
- * @name cbc:* (+ @currencyID)
+ * @example
+ *   ```ts
+ *   const value = 'SGVsbG8=';
+ *   ```;
  */
-declare class PeppolAmount extends PeppolAmount_base {}
-interface PeppolAmountEncoded extends Schema.Codec.Encoded<typeof PeppolAmount> {}
+declare class PeppolBase64 extends PeppolBase64_base {}
 //#endregion
-//#region src/schemas/fields/peppol-allowance-charge-schema.d.ts
-declare const PeppolTaxCategoryTaxSchemeId_base: OpaqueSchema<PeppolTaxCategoryTaxSchemeId, Schema.Struct<{
-  /**
-   * @description Mandatory element. Use "VAT"
-   *
-   * @name `cbc:ID`
-   */
-  readonly id: Schema.withDecodingDefaultType<Schema.String, never>;
-}>>;
-declare class PeppolTaxCategoryTaxSchemeId extends PeppolTaxCategoryTaxSchemeId_base {}
-declare const BaseAllowanceCharge_base: OpaqueSchema<BaseAllowanceCharge, Schema.Struct<{
-  readonly amount: typeof PeppolAmount;
-  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
-  readonly chargeIndicator: Schema.Boolean;
-  readonly allowanceChargeReason: Schema.optional<Schema.String>;
-  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
-  /**
-   * @summary TAX CATEGORY
-   *
-   * @name cac:TaxCategory
-   */
-  readonly taxCategory: Schema.optional<Schema.Struct<{
-    readonly id: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
-    readonly percent: Schema.optional<Schema.Finite>;
-    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
-  }>>;
-}>>;
-declare class BaseAllowanceCharge extends BaseAllowanceCharge_base {}
-declare const PeppolAllowance_base: OpaqueSchema<PeppolAllowance, Schema.Struct<{
-  readonly amount: typeof PeppolAmount;
-  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
-  readonly allowanceChargeReason: Schema.optional<Schema.String>;
-  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
-  /**
-   * @summary TAX CATEGORY
-   *
-   * @name cac:TaxCategory
-   */
-  readonly taxCategory: Schema.optional<Schema.Struct<{
-    readonly id: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
-    readonly percent: Schema.optional<Schema.Finite>;
-    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
-  }>>;
-  /**
-   * @name cbc:AllowanceChargeReasonCode
-   */
-  readonly allowanceChargeReasonCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAllowanceChargeReasonCode">>;
-  /**
-   * @name cbc:ChargeIndicator
-   *
-   * @value `false`
-   */
-  readonly chargeIndicator: Schema.Literal<false>;
-}>>;
-declare class PeppolAllowance extends PeppolAllowance_base {}
-declare const PeppolCharge_base: OpaqueSchema<PeppolCharge, Schema.Struct<{
-  readonly amount: typeof PeppolAmount;
-  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
-  readonly allowanceChargeReason: Schema.optional<Schema.String>;
-  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
-  /**
-   * @summary TAX CATEGORY
-   *
-   * @name cac:TaxCategory
-   */
-  readonly taxCategory: Schema.optional<Schema.Struct<{
-    readonly id: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
-    readonly percent: Schema.optional<Schema.Finite>;
-    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
-  }>>;
-  /**
-   * @name cbc:AllowanceChargeReasonCode
-   */
-  readonly allowanceChargeReasonCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolChargeReasonCode">>;
-  /**
-   * @name cbc:ChargeIndicator
-   *
-   * @value `true`
-   */
-  readonly chargeIndicator: Schema.Literal<true>;
-}>>;
-declare class PeppolCharge extends PeppolCharge_base {}
+//#region src/schemas/values/mime-codes-schema.d.ts
+declare const PeppolMimeCode_base: OpaqueSchema<PeppolMimeCode, Schema.brand<Schema.Literals<readonly ["text/csv", "application/pdf", "image/png", "image/jpeg", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.oasis.opendocument.spreadsheet"]>, "PeppolMimeCode">>;
 /**
- * @summary Allowance/Charge
+ * @description A MIME media type from the PEPPOL MIME code list.
  *
- * @name cac:AllowanceCharge
+ * @example
+ *   ```ts
+ *   'text/csv';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL001: Attachment (MIME) type MUST come from the allowed list.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/MimeCode/
+ * @see {@link mimeCodesKeys}
  */
-declare const peppolAllowanceChargeSchema: Schema.Union<readonly [typeof PeppolAllowance, typeof PeppolCharge]>;
-type PeppolAllowanceCharge = Schema.Schema.Type<typeof peppolAllowanceChargeSchema>;
-type PeppolAllowanceChargeEncoded = Schema.Codec.Encoded<typeof peppolAllowanceChargeSchema>;
+declare class PeppolMimeCode extends PeppolMimeCode_base {}
 //#endregion
 //#region src/schemas/fields/peppol-binary-object-schema.d.ts
 declare const PeppolBinaryObject_base: OpaqueSchema<PeppolBinaryObject, Schema.Struct<{
@@ -142,7 +62,7 @@ declare const PeppolBinaryObject_base: OpaqueSchema<PeppolBinaryObject, Schema.S
    *
    * @name `#text` (Base64 content)
    */
-  readonly content: Schema.Union<readonly [Schema.String, Schema.String]>;
+  readonly content: Schema.Union<readonly [typeof PeppolBase64, Schema.String]>;
   /**
    * @description The mime code of the attached document.
    *
@@ -153,7 +73,7 @@ declare const PeppolBinaryObject_base: OpaqueSchema<PeppolBinaryObject, Schema.S
    *
    * @name `@mimeCode`
    */
-  readonly mimeCode: Schema.brand<Schema.Literals<readonly ["text/csv", "application/pdf", "image/png", "image/jpeg", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.oasis.opendocument.spreadsheet"]>, "PeppolMimeCode">;
+  readonly mimeCode: typeof PeppolMimeCode;
   /**
    * @description The file name of the attached document.
    *
@@ -167,12 +87,35 @@ declare const PeppolBinaryObject_base: OpaqueSchema<PeppolBinaryObject, Schema.S
   readonly filename: Schema.String;
 }>>;
 /**
+ * @description An attached document embedded in the Invoice as a Base64 encoded binary object, together with its MIME type and file name. Wraps the
+ * `cbc:EmbeddedDocumentBinaryObject` element.
+ *
+ * @example
+ *   ```ts
+ *   { content: 'aHR0cHM6Ly90ZXN0LXZlZmEuZGlmaS5uby9wZXBwb2xiaXM=', mimeCode: 'text/csv', filename: 'Hours - spent.csv' }
+ *   ```;
+ *
  * @summary Binary object for attachments
  *
  * @name cbc:EmbeddedDocumentBinaryObject (+ @mimeCode, @filename)
  */
 declare class PeppolBinaryObject extends PeppolBinaryObject_base {}
 //#endregion
+//#region src/schemas/values/additional-document-reference-code-schema.d.ts
+declare const PeppolAdditionalDocumentReferenceCode_base: OpaqueSchema<PeppolAdditionalDocumentReferenceCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAdditionalDocumentReferenceCode">>;
+/**
+ * @description An additional document reference code from the PEPPOL subset of UNCL 1153 (invoiced object identifier scheme).
+ *
+ * @example
+ *   ```ts
+ *   'AAA';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1153/
+ * @see {@link additionalDocumentReferenceCodesKeys}
+ */
+declare class PeppolAdditionalDocumentReferenceCode extends PeppolAdditionalDocumentReferenceCode_base {}
+//#endregion
 //#region src/schemas/fields/peppol-additional-document-reference-schema.d.ts
 declare const PeppolAttachmentExternalReference_base: OpaqueSchema<PeppolAttachmentExternalReference, Schema.Struct<{
   /**
@@ -188,6 +131,17 @@ declare const PeppolAttachmentExternalReference_base: OpaqueSchema<PeppolAttachm
    */
   readonly uri: Schema.String;
 }>>;
+/**
+ * @description A reference to a supporting document that is stored outside the Invoice, identified by a URI. Wraps the `cac:ExternalReference` element of an
+ * attachment group.
+ *
+ * @example
+ *   ```ts
+ *   { uri: 'http://www.example.com/index.html' }
+ *   ```;
+ *
+ * @see {@link PeppolAttachment}
+ */
 declare class PeppolAttachmentExternalReference extends PeppolAttachmentExternalReference_base {}
 declare const PeppolAttachment_base: OpaqueSchema<PeppolAttachment, Schema.Struct<{
   /**
@@ -210,26 +164,39 @@ declare const PeppolAttachment_base: OpaqueSchema<PeppolAttachment, Schema.Struc
    */
   readonly externalReference: Schema.optional<typeof PeppolAttachmentExternalReference>;
 }>>;
+/**
+ * @description The attachment of a supporting document to the Invoice, either embedded as a Base64 binary object or referenced by URI. Wraps the `cac:Attachment`
+ * element of an additional supporting document.
+ *
+ * @example
+ *   ```ts
+ *   {
+ *     embeddedDocumentBinaryObject: {
+ *       content: 'aHR0cHM6Ly90ZXN0LXZlZmEuZGlmaS5uby9wZXBwb2xiaXM=',
+ *       mimeCode: 'text/csv',
+ *       filename: 'Hours - spent.csv'
+ *     }
+ *   }
+ *   ```;
+ *
+ * @see {@link PeppolAdditionalDocumentReference}
+ */
 declare class PeppolAttachment extends PeppolAttachment_base {}
 declare const PeppolId_base: OpaqueSchema<PeppolId, Schema.Struct<{
-  /**
-   * @description An identifier for an object on which the invoice is based (with DocumentTypeCode=130), given by the Seller, the identifier for the supporting
-   * document or the project reference identifier (DocumentTypeCode=50).
-   *
-   * @summary Invoiced object identifier, Supporting document reference or project reference
-   *
-   * @name `#text`
-   */
   readonly id: Schema.String;
-  /**
-   * @description The identification scheme identifier of the Invoiced object identifier.
-   *
-   * @summary Scheme identifier
-   *
-   * @name `@schemeID`
-   */
-  readonly schemeId: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAdditionalDocumentReferenceCode">>;
+  readonly schemeId: Schema.optional<typeof PeppolAdditionalDocumentReferenceCode>;
 }>>;
+/**
+ * @description The identifier of an additional supporting document, an invoiced object reference or a project reference, together with an optional identification
+ * scheme identifier.
+ *
+ * @example
+ *   ```ts
+ *   { id: '9873242' }
+ *   ```;
+ *
+ * @see {@link PeppolAdditionalDocumentReference}
+ */
 declare class PeppolId extends PeppolId_base {}
 declare const PeppolAdditionalDocumentReference_base: OpaqueSchema<PeppolAdditionalDocumentReference, Schema.Struct<{
   readonly schemeId: Schema.optional<Schema.String>;
@@ -249,64 +216,383 @@ declare const PeppolAdditionalDocumentReference_base: OpaqueSchema<PeppolAdditio
  */
 declare class PeppolAdditionalDocumentReference extends PeppolAdditionalDocumentReference_base {}
 //#endregion
-//#region src/schemas/fields/peppol-billing-reference-schema.d.ts
-declare const PeppolInvoiceDocumentReference_base: OpaqueSchema<PeppolInvoiceDocumentReference, Schema.Struct<{
-  /**
-   * @description The identification of an Invoice that was previously sent by the seller.
-   *
-   * @example
-   *   `inv123`;
-   *
-   * @summary Preceding invoice number
-   *
-   * @name `cbc:ID`
-   */
-  readonly id: Schema.String;
+//#region src/schemas/values/currency-code-schema.d.ts
+declare const PeppolCurrencyCode_base: OpaqueSchema<PeppolCurrencyCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">>;
+/**
+ * @description An ISO 4217 currency code from the PEPPOL codelist.
+ *
+ * @example
+ *   ```ts
+ *   'AED';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL007: Currency codes MUST be valid ISO 4217 codes.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO4217/
+ * @see {@link currencyCodesKeys}
+ */
+declare class PeppolCurrencyCode extends PeppolCurrencyCode_base {}
+/**
+ * @description An ISO 4217 currency code as defined by the PEPPOL subset.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO4217/
+ */
+type PeppolCurrencyCodeEncoded = Schema.Codec.Encoded<typeof PeppolCurrencyCode>;
+//#endregion
+//#region src/schemas/fields/peppol-amount-schema.d.ts
+declare const PeppolAmount_base: OpaqueSchema<PeppolAmount, Schema.Struct<{
   /**
-   * @description The date when the preceding invoice was issued. Shall be provided in case the preceding invoice identifier is not unique.
-   *
-   * @example
-   *   `2017-09-15`;
-   *
-   * @summary Preceding invoice issue date
-   *
-   * @format `YYYY-MM-DD`
-   *
-   * @name `cbc:IssueDate`
+   * @name \@currencyID
    */
-  readonly issueDate: Schema.optional<typeof PeppolIsoDateString>;
-}>>;
-declare class PeppolInvoiceDocumentReference extends PeppolInvoiceDocumentReference_base {}
-declare const PeppolBillingReference_base: OpaqueSchema<PeppolBillingReference, Schema.Struct<{
+  readonly currencyId: typeof PeppolCurrencyCode;
   /**
-   * @example
-   *   inv123;
-   *
-   * @summary INVOICE DOCUMENT REFERENCE
-   *
-   * @name `cac:InvoiceDocumentReference`
+   * @name #text (value)
    */
-  readonly invoiceDocumentReference: typeof PeppolInvoiceDocumentReference;
+  readonly value: Schema.Finite;
 }>>;
 /**
- * @summary PRECEDING INVOICE REFERENCE (0..n)
+ * @description A monetary amount paired with the currency it is expressed in. Wraps a `cbc:*` amount element whose `@currencyID` attribute names the currency and
+ * whose text is the value.
  *
- * @name cac:BillingReference
+ * @example
+ *   ```ts
+ *   { currencyId: 'EUR', value: 4500.0 }
+ *   ```;
+ *
+ * @summary Monetary amount with mandatory currency
+ *
+ * @name cbc:* (+ @currencyID)
  */
-declare class PeppolBillingReference extends PeppolBillingReference_base {}
+declare class PeppolAmount extends PeppolAmount_base {}
+/**
+ * @description Encoded form of {@link PeppolAmount} produced by the Effect Schema codec. Fields mirror the decoded shape.
+ *
+ * @see {@link PeppolAmount}
+ */
+interface PeppolAmountEncoded extends Schema.Codec.Encoded<typeof PeppolAmount> {}
 //#endregion
-//#region src/schemas/fields/peppol-address-schema.d.ts
-declare const PeppolAddressLine_base: OpaqueSchema<PeppolAddressLine, Schema.Struct<{
+//#region src/schemas/values/allowance-charge-reason-code-schema.d.ts
+declare const PeppolAllowanceChargeReasonCode_base: OpaqueSchema<PeppolAllowanceChargeReasonCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAllowanceChargeReasonCode">>;
+/**
+ * @description An allowance or charge reason code from the PEPPOL subset of UNCL 5189 (D.16B).
+ *
+ * @example
+ *   ```ts
+ *   '41';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL002: Document allowance reason code MUST be according to the subset of UNCL 5189 D.16B.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5189/
+ * @see {@link allowanceChargeReasonCodesKeys}
+ */
+declare class PeppolAllowanceChargeReasonCode extends PeppolAllowanceChargeReasonCode_base {}
+//#endregion
+//#region src/schemas/values/charge-reason-code-schema.d.ts
+declare const PeppolChargeReasonCode_base: OpaqueSchema<PeppolChargeReasonCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolChargeReasonCode">>;
+/**
+ * @description A charge reason code from the PEPPOL subset of UNCL 7161 (D.16B).
+ *
+ * @example
+ *   ```ts
+ *   'AA';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL003: Charge reason code MUST be according to UNCL 7161 D.16B.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7161/
+ * @see {@link chargeReasonCodesKeys}
+ */
+declare class PeppolChargeReasonCode extends PeppolChargeReasonCode_base {}
+//#endregion
+//#region src/schemas/values/duty-tax-fee-category-schema.d.ts
+declare const PeppolDutyTaxFeeCategoryCode_base: OpaqueSchema<PeppolDutyTaxFeeCategoryCode, Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">>;
+/**
+ * @description A duty, tax or fee category code from the PEPPOL subset of UNCL 5305 (VAT category code).
+ *
+ * @example
+ *   ```ts
+ *   'AE';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-17 / BR-CL-18: VAT category code MUST be a valid UNCL 5305 code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/
+ * @see {@link dutyTaxFeeCategoriesKeys}
+ */
+declare class PeppolDutyTaxFeeCategoryCode extends PeppolDutyTaxFeeCategoryCode_base {}
+/**
+ * @description The encoded form of {@link PeppolDutyTaxFeeCategoryCode}, a string literal union.
+ */
+type PeppolDutyTaxFeeCategoryCodeEncoded = Schema.Codec.Encoded<typeof PeppolDutyTaxFeeCategoryCode>;
+//#endregion
+//#region src/schemas/fields/peppol-allowance-charge-schema.d.ts
+declare const PeppolTaxCategoryTaxSchemeId_base: OpaqueSchema<PeppolTaxCategoryTaxSchemeId, Schema.Struct<{
   /**
-   * @description An additional address line in an address that can be used to give further details supplementing the main line.
-   *
-   * @summary Address line 3
+   * @description Mandatory element. Use "VAT"
    *
-   * @name `cbc:Line`
+   * @name `cbc:ID`
    */
-  readonly line: Schema.String;
+  readonly id: Schema.withDecodingDefaultType<Schema.String, never>;
 }>>;
-declare class PeppolAddressLine extends PeppolAddressLine_base {}
+/**
+ * @description The identifier of the tax scheme that applies to a document level allowance or charge. Defaults to `VAT` when the value is absent.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'VAT' }
+ *   ```;
+ *
+ * @see {@link PeppolTaxCategory}
+ */
+declare class PeppolTaxCategoryTaxSchemeId extends PeppolTaxCategoryTaxSchemeId_base {}
+declare const BaseAllowanceCharge_base: OpaqueSchema<BaseAllowanceCharge, Schema.Struct<{
+  readonly amount: typeof PeppolAmount;
+  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
+  readonly chargeIndicator: Schema.Boolean;
+  readonly allowanceChargeReason: Schema.optional<Schema.String>;
+  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
+  /**
+   * @summary TAX CATEGORY
+   *
+   * @name cac:TaxCategory
+   */
+  readonly taxCategory: Schema.optional<Schema.Struct<{
+    readonly id: typeof PeppolDutyTaxFeeCategoryCode;
+    readonly percent: Schema.optional<Schema.Finite>;
+    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
+  }>>;
+}>>;
+/**
+ * @description Shared fields for a document level allowance or charge. Combines the common line allowance and charge fields with the tax category that applies to
+ * the document level amount.
+ *
+ * @example
+ *   ```ts
+ *   {
+ *     amount: { value: 25, currencyId: 'EUR' },
+ *     chargeIndicator: true,
+ *     allowanceChargeReason: 'Insurance',
+ *     taxCategory: { id: 'S', percent: 25, taxSchemeId: { id: 'VAT' } }
+ *   }
+ *   ```;
+ *
+ * @see {@link PeppolAllowanceCharge}
+ */
+declare class BaseAllowanceCharge extends BaseAllowanceCharge_base {}
+declare const PeppolAllowance_base: OpaqueSchema<PeppolAllowance, Schema.Struct<{
+  readonly amount: typeof PeppolAmount;
+  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
+  readonly allowanceChargeReason: Schema.optional<Schema.String>;
+  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
+  /**
+   * @summary TAX CATEGORY
+   *
+   * @name cac:TaxCategory
+   */
+  readonly taxCategory: Schema.optional<Schema.Struct<{
+    readonly id: typeof PeppolDutyTaxFeeCategoryCode;
+    readonly percent: Schema.optional<Schema.Finite>;
+    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
+  }>>;
+  /**
+   * @name cbc:AllowanceChargeReasonCode
+   */
+  readonly allowanceChargeReasonCode: Schema.optional<typeof PeppolAllowanceChargeReasonCode>;
+  /**
+   * @name cbc:ChargeIndicator
+   *
+   * @value `false`
+   */
+  readonly chargeIndicator: Schema.Literal<false>;
+}>>;
+/**
+ * @description A document level allowance, marked by a `cbc:ChargeIndicator` of `false`. Adds an allowance reason code to the shared document level allowance and
+ * charge fields.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 200, currencyId: 'EUR' }, chargeIndicator: false, allowanceChargeReasonCode: '95' }
+ *   ```;
+ *
+ * @see {@link PeppolAllowanceCharge}
+ */
+declare class PeppolAllowance extends PeppolAllowance_base {}
+declare const PeppolCharge_base: OpaqueSchema<PeppolCharge, Schema.Struct<{
+  readonly amount: typeof PeppolAmount;
+  readonly baseAmount: Schema.optional<typeof PeppolAmount>;
+  readonly allowanceChargeReason: Schema.optional<Schema.String>;
+  readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
+  /**
+   * @summary TAX CATEGORY
+   *
+   * @name cac:TaxCategory
+   */
+  readonly taxCategory: Schema.optional<Schema.Struct<{
+    readonly id: typeof PeppolDutyTaxFeeCategoryCode;
+    readonly percent: Schema.optional<Schema.Finite>;
+    readonly taxSchemeId: typeof PeppolTaxCategoryTaxSchemeId;
+  }>>;
+  /**
+   * @name cbc:AllowanceChargeReasonCode
+   */
+  readonly allowanceChargeReasonCode: Schema.optional<typeof PeppolChargeReasonCode>;
+  /**
+   * @name cbc:ChargeIndicator
+   *
+   * @value `true`
+   */
+  readonly chargeIndicator: Schema.Literal<true>;
+}>>;
+/**
+ * @description A document level charge, marked by a `cbc:ChargeIndicator` of `true`. Adds a charge reason code to the shared document level allowance and charge
+ * fields.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 25, currencyId: 'EUR' }, chargeIndicator: true, allowanceChargeReasonCode: 'AA' }
+ *   ```;
+ *
+ * @see {@link PeppolAllowanceCharge}
+ */
+declare class PeppolCharge extends PeppolCharge_base {}
+declare const PeppolAllowanceCharge_base: Schema.Union<readonly [typeof PeppolAllowance, typeof PeppolCharge]>;
+/**
+ * @description A document level allowance or charge, selected by the `cbc:ChargeIndicator` value: `false` selects an allowance, `true` selects a charge.
+ *
+ * @summary Allowance/Charge
+ *
+ * @name cac:AllowanceCharge
+ */
+declare class PeppolAllowanceCharge extends PeppolAllowanceCharge_base {}
+/**
+ * @description Encoded form of {@link PeppolAllowanceCharge} produced by the Effect Schema codec.
+ *
+ * @see {@link PeppolAllowanceCharge}
+ */
+type PeppolAllowanceChargeEncoded = Schema.Codec.Encoded<typeof PeppolAllowanceCharge>;
+//#endregion
+//#region src/schemas/fields/peppol-billing-reference-schema.d.ts
+declare const PeppolInvoiceDocumentReference_base: OpaqueSchema<PeppolInvoiceDocumentReference, Schema.Struct<{
+  /**
+   * @description The identification of an Invoice that was previously sent by the seller.
+   *
+   * @example
+   *   `inv123`;
+   *
+   * @summary Preceding invoice number
+   *
+   * @name `cbc:ID`
+   */
+  readonly id: Schema.String;
+  /**
+   * @description The date when the preceding invoice was issued. Shall be provided in case the preceding invoice identifier is not unique.
+   *
+   * @example
+   *   `2017-09-15`;
+   *
+   * @summary Preceding invoice issue date
+   *
+   * @format `YYYY-MM-DD`
+   *
+   * @name `cbc:IssueDate`
+   */
+  readonly issueDate: Schema.optional<typeof PeppolIsoDateString>;
+}>>;
+/**
+ * @description A reference to an Invoice that was previously sent by the Seller, carrying the preceding invoice number and, when the number is not unique, its
+ * issue date. Wraps the `cac:InvoiceDocumentReference` element.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'inv123', issueDate: '2017-09-15' }
+ *   ```;
+ *
+ * @see {@link PeppolBillingReference}
+ */
+declare class PeppolInvoiceDocumentReference extends PeppolInvoiceDocumentReference_base {}
+declare const PeppolBillingReference_base: OpaqueSchema<PeppolBillingReference, Schema.Struct<{
+  /**
+   * @example
+   *   inv123;
+   *
+   * @summary INVOICE DOCUMENT REFERENCE
+   *
+   * @name `cac:InvoiceDocumentReference`
+   */
+  readonly invoiceDocumentReference: typeof PeppolInvoiceDocumentReference;
+}>>;
+/**
+ * @description A reference to a preceding Invoice, used when the Invoice corrects or replaces an earlier one. Wraps the `cac:BillingReference` element.
+ *
+ * @summary PRECEDING INVOICE REFERENCE (0..n)
+ *
+ * @name cac:BillingReference
+ */
+declare class PeppolBillingReference extends PeppolBillingReference_base {}
+//#endregion
+//#region src/schemas/values/icd-codes-schema.d.ts
+declare const PeppolIcdCode_base: OpaqueSchema<PeppolIcdCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">>;
+/**
+ * @description An ISO 6523 ICD code from the PEPPOL codelist.
+ *
+ * @example
+ *   ```ts
+ *   '0002';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-10 / BR-CL-11 / BR-CL-21: Identifier scheme MUST be a valid ISO 6523 ICD code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ICD/
+ * @see {@link icdCodesKeys}
+ */
+declare class PeppolIcdCode extends PeppolIcdCode_base {}
+//#endregion
+//#region src/schemas/values/peppol-country-code-schema.d.ts
+declare const PeppolCountryCodeValue_base: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCountryCodeValue">;
+/**
+ * @description A two character ISO 3166-1 alpha-2 country code from the PEPPOL codelist. The literal union enforces the length.
+ *
+ * @example
+ *   ```ts
+ *   'AD';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-14 / BR-CL-15: Country code MUST be a valid ISO 3166-1 alpha-2 code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO3166/
+ * @see {@link countryCodesKeys}
+ */
+declare class PeppolCountryCodeValue extends PeppolCountryCodeValue_base {}
+//#endregion
+//#region src/schemas/fields/peppol-address-schema.d.ts
+declare const PeppolAddressLine_base: OpaqueSchema<PeppolAddressLine, Schema.Struct<{
+  /**
+   * @description An additional address line in an address that can be used to give further details supplementing the main line.
+   *
+   * @summary Address line 3
+   *
+   * @name `cbc:Line`
+   */
+  readonly line: Schema.String;
+}>>;
+/**
+ * @description An additional address line that supplements the main address line. Wraps the `cac:AddressLine` element, whose `cbc:Line` value carries the text.
+ *
+ * @example
+ *   ```ts
+ *   { line: 'Building 23' }
+ *   ```;
+ *
+ * @see {@link PeppolAddress}
+ */
+declare class PeppolAddressLine extends PeppolAddressLine_base {}
 declare const PeppolCountryCode_base: OpaqueSchema<PeppolCountryCode, Schema.Struct<{
   /**
    * @description A code that identifies the country.
@@ -318,8 +604,18 @@ declare const PeppolCountryCode_base: OpaqueSchema<PeppolCountryCode, Schema.Str
    *
    * @name `cbc:IdentificationCode`
    */
-  readonly identificationCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCountryCode">;
+  readonly identificationCode: typeof PeppolCountryCodeValue;
 }>>;
+/**
+ * @description The country of an address, expressed as a two-letter ISO 3166-1 alpha-2 code. Wraps the `cac:Country` element and its `cbc:IdentificationCode`.
+ *
+ * @example
+ *   ```ts
+ *   { identificationCode: 'GB' }
+ *   ```;
+ *
+ * @see {@link PeppolAddress}
+ */
 declare class PeppolCountryCode extends PeppolCountryCode_base {}
 declare const PeppolAddress_base: OpaqueSchema<PeppolAddress, Schema.Struct<{
   /**
@@ -393,6 +689,9 @@ declare const PeppolAddress_base: OpaqueSchema<PeppolAddress, Schema.Struct<{
   readonly addressLine: Schema.optional<typeof PeppolAddressLine>;
 }>>;
 /**
+ * @description The postal address of a party, used for the seller, buyer, payee and delivery locations. Carries the street lines, city, postal zone, country
+ * subdivision, country code and optional additional address lines.
+ *
  * @summary Postal address
  *
  * @name `cac:PostalAddress`
@@ -410,6 +709,16 @@ declare const PeppolDeliveryPartyPartyName_base: OpaqueSchema<PeppolDeliveryPart
    */
   readonly name: Schema.String;
 }>>;
+/**
+ * @description The name of the party to which the goods and services are delivered. Wraps the `cac:PartyName` element of the delivery party.
+ *
+ * @example
+ *   ```ts
+ *   { name: 'Delivery party Name' }
+ *   ```;
+ *
+ * @see {@link PeppolDeliveryParty}
+ */
 declare class PeppolDeliveryPartyPartyName extends PeppolDeliveryPartyPartyName_base {}
 declare const PeppolDeliveryParty_base: OpaqueSchema<PeppolDeliveryParty, Schema.Struct<{
   /**
@@ -419,6 +728,16 @@ declare const PeppolDeliveryParty_base: OpaqueSchema<PeppolDeliveryParty, Schema
    */
   readonly partyName: typeof PeppolDeliveryPartyPartyName;
 }>>;
+/**
+ * @description The party to which the goods and services are delivered, when it differs from the Buyer. Wraps the `cac:DeliveryParty` element.
+ *
+ * @example
+ *   ```ts
+ *   { partyName: { name: 'Delivery party Name' } }
+ *   ```;
+ *
+ * @see {@link PeppolDelivery}
+ */
 declare class PeppolDeliveryParty extends PeppolDeliveryParty_base {}
 declare const PeppolDeliveryLocation_base: OpaqueSchema<PeppolDeliveryLocation, Schema.Struct<{
   /**
@@ -433,7 +752,7 @@ declare const PeppolDeliveryLocation_base: OpaqueSchema<PeppolDeliveryLocation,
    */
   readonly id: Schema.optional<Schema.Struct<{
     readonly id: Schema.String;
-    readonly schemeId: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">>;
+    readonly schemeId: Schema.optional<typeof PeppolIcdCode>;
   }>>;
   /**
    * @description A groupd of business terms providing infomation about the address to which goods and services invoiced were or are delivered.
@@ -444,6 +763,17 @@ declare const PeppolDeliveryLocation_base: OpaqueSchema<PeppolDeliveryLocation,
    */
   readonly address: Schema.optional<typeof PeppolAddress>;
 }>>;
+/**
+ * @description The location at which the goods and services are delivered, identified by an identifier and an optional address. Wraps the `cac:DeliveryLocation`
+ * element.
+ *
+ * @example
+ *   ```ts
+ *   { id: { id: '9483759475923478', schemeId: '0088' }, address: { cityName: 'Stockholm', countryCode: { identificationCode: 'SE' } } }
+ *   ```;
+ *
+ * @see {@link PeppolDelivery}
+ */
 declare class PeppolDeliveryLocation extends PeppolDeliveryLocation_base {}
 declare const PeppolDelivery_base: OpaqueSchema<PeppolDelivery, Schema.Struct<{
   /**
@@ -470,13 +800,42 @@ declare const PeppolDelivery_base: OpaqueSchema<PeppolDelivery, Schema.Struct<{
    */
   readonly deliveryParty: Schema.optional<typeof PeppolDeliveryParty>;
 }>>;
+/**
+ * @description Information about the delivery of the goods and services, such as the actual delivery date, the delivery location and the delivery party. Wraps the
+ * `cac:Delivery` element.
+ *
+ * @example
+ *   ```ts
+ *   { actualDeliveryDate: '2017-11-01', deliveryLocation: { id: { id: '9483759475923478' } } }
+ *   ```;
+ *
+ * @see {@link PeppolDeliveryLocation}
+ */
 declare class PeppolDelivery extends PeppolDelivery_base {}
 //#endregion
+//#region src/schemas/values/vat-date-code-schema.d.ts
+declare const PeppolVatDateCode_base: OpaqueSchema<PeppolVatDateCode, Schema.Literals<readonly ["3", "35", "432"]>>;
+/**
+ * @description A VAT date code from the PEPPOL subset of UNCL 2005 (invoice period description code).
+ *
+ * @example
+ *   ```ts
+ *   '3';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL006: Invoice period description code must be according to UNCL 2005 D.16B.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL2005/
+ * @see {@link vatDateCodesKeys}
+ */
+declare class PeppolVatDateCode extends PeppolVatDateCode_base {}
+//#endregion
 //#region src/schemas/fields/peppol-invoice-period-schema.d.ts
 declare const PeppolInvoicePeriod_base: OpaqueSchema<PeppolInvoicePeriod, Schema.Struct<{
   readonly endDate: Schema.optional<typeof PeppolIsoDateString>;
   readonly startDate: Schema.optional<typeof PeppolIsoDateString>;
-  readonly descriptionCode: Schema.optional<Schema.Literals<readonly ["3", "35", "432"]>>;
+  readonly descriptionCode: Schema.optional<typeof PeppolVatDateCode>;
 }>>;
 /**
  * @description A group of business terms providing information on the invoice period. Also called delivery period. If the group is used, the invoiceing period
@@ -640,6 +999,8 @@ declare const PeppolOrderReference_base: OpaqueSchema<PeppolOrderReference, Sche
   readonly salesOrderId: Schema.optional<Schema.String>;
 }>>;
 /**
+ * @description A reference to the purchase order or sales order that the invoice relates to.
+ *
  * @summary ORDER AND SALES ORDER REFERENCE
  *
  * @name cac:OrderReference
@@ -661,6 +1022,17 @@ declare const PeppolContact_base: OpaqueSchema<PeppolContact, Schema.Struct<{
    */
   readonly telephone: Schema.optional<Schema.String>;
 }>>;
+/**
+ * @description A contact point for a party, such as the person responsible for receiving the Invoice. Wraps the `cac:Contact` element with an optional name,
+ * telephone number and electronic mail address.
+ *
+ * @example
+ *   ```ts
+ *   { name: 'Lisa Johnson', telephone: '23434234', electronicMail: 'lj@buyer.se' }
+ *   ```;
+ *
+ * @see {@link PeppolPartySchema}
+ */
 declare class PeppolContact extends PeppolContact_base {}
 //#endregion
 //#region src/schemas/fields/peppol-identifier-schema.d.ts
@@ -675,6 +1047,14 @@ declare const PeppolIdentifier_base: OpaqueSchema<PeppolIdentifier, Schema.Struc
   readonly schemeId: Schema.optional<Schema.String>;
 }>>;
 /**
+ * @description A generic identifier paired with an optional identification scheme identifier. Wraps a `cbc:ID` element and its optional `@schemeID` attribute, and
+ * is reused across document references.
+ *
+ * @example
+ *   ```ts
+ *   { id: '99887766', schemeId: '0088' }
+ *   ```;
+ *
  * @summary Identifier with optional scheme
  *
  * @name `cbc:ID (+ optional @schemeID)`
@@ -682,7 +1062,7 @@ declare const PeppolIdentifier_base: OpaqueSchema<PeppolIdentifier, Schema.Struc
 declare class PeppolIdentifier extends PeppolIdentifier_base {}
 //#endregion
 //#region src/schemas/fields/peppol-party-legal-entity-schema.d.ts
-declare const PeppolPartyLegalEntity_base$1: OpaqueSchema<PeppolPartyLegalEntity$1, Schema.Struct<{
+declare const PeppolPartyLegalEntity_base: OpaqueSchema<PeppolPartyLegalEntity, Schema.Struct<{
   /**
    * @example
    *   987654321;
@@ -705,11 +1085,20 @@ declare const PeppolPartyLegalEntity_base$1: OpaqueSchema<PeppolPartyLegalEntity
    */
   readonly registrationName: Schema.String;
 }>>;
-declare class PeppolPartyLegalEntity$1 extends PeppolPartyLegalEntity_base$1 {}
-type PeppolPartyLegalEntitySchema = PeppolPartyLegalEntity$1;
+/**
+ * @description The legal entity details of a party, including the registered name and optional company identifiers.
+ *
+ * @example
+ *   ```ts
+ *   { registrationName: 'SupplierOfficialName Ltd', companyId: { id: 'GB983294' } }
+ *   ```;
+ *
+ * @see {@link PeppolPartySchema}
+ */
+declare class PeppolPartyLegalEntity extends PeppolPartyLegalEntity_base {}
 //#endregion
 //#region src/schemas/fields/peppol-party-tax-scheme-schema.d.ts
-declare const PeppolTaxSchemeId_base$1: OpaqueSchema<PeppolTaxSchemeId$1, Schema.Struct<{
+declare const PeppolPartyTaxSchemeId_base: OpaqueSchema<PeppolPartyTaxSchemeId, Schema.Struct<{
   /**
    * @description Mandatory element. For Seller VAT identifier (BT-31), use value “VAT”, for the seller tax registration identifier (BT-32), use != "VAT"
    *
@@ -717,7 +1106,7 @@ declare const PeppolTaxSchemeId_base$1: OpaqueSchema<PeppolTaxSchemeId$1, Schema
    */
   readonly id: Schema.withDecodingDefaultType<Schema.String, never>;
 }>>;
-declare class PeppolTaxSchemeId$1 extends PeppolTaxSchemeId_base$1 {}
+declare class PeppolPartyTaxSchemeId extends PeppolPartyTaxSchemeId_base {}
 declare const PeppolPartyTaxScheme_base: OpaqueSchema<PeppolPartyTaxScheme, Schema.Struct<{
   /**
    * @description The Seller's VAT identifier (also known as Seller VAT identification number) or the local identification (defined by the Seller’s address) of
@@ -735,16 +1124,35 @@ declare const PeppolPartyTaxScheme_base: OpaqueSchema<PeppolPartyTaxScheme, Sche
    *
    * @name `cac:TaxScheme`
    */
-  readonly taxSchemeId: typeof PeppolTaxSchemeId$1;
+  readonly taxSchemeId: typeof PeppolPartyTaxSchemeId;
 }>>;
 /**
+ * @description The Seller tax registration details, combining a tax identifier such as a VAT number with the tax scheme.
+ *
  * @name cac:PartyTaxScheme (0..2)
  */
 declare class PeppolPartyTaxScheme extends PeppolPartyTaxScheme_base {}
-type PeppolPartyTaxSchema = PeppolPartyTaxScheme;
+//#endregion
+//#region src/schemas/values/electronic-codes-schema.d.ts
+declare const PeppolElectronicAddressCode_base: OpaqueSchema<PeppolElectronicAddressCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolElectronicAddressCode">>;
+/**
+ * @description An electronic address scheme (EAS) code from the PEPPOL Electronic Address Identifier Scheme codelist.
+ *
+ * @example
+ *   ```ts
+ *   '0002';
+ *   ```;
+ *
+ * @validations
+ * - PEPPOL-EN16931-CL008: Electronic address identifier scheme MUST be from the codelist "Electronic Address Identifier Scheme".
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/
+ * @see {@link electronicAddressCodesKeys}
+ */
+declare class PeppolElectronicAddressCode extends PeppolElectronicAddressCode_base {}
 //#endregion
 //#region src/schemas/fields/peppol-party-base-schema.d.ts
-declare const PeppolPartyName_base$1: OpaqueSchema<PeppolPartyName$1, Schema.Struct<{
+declare const PeppolPartyName_base: OpaqueSchema<PeppolPartyName, Schema.Struct<{
   /**
    * @description A name by which the Buyer/Seller is known, other than Buyer/Seller name (also known as Business name).
    *
@@ -755,25 +1163,55 @@ declare const PeppolPartyName_base$1: OpaqueSchema<PeppolPartyName$1, Schema.Str
    */
   readonly name: Schema.String;
 }>>;
-declare class PeppolPartyName$1 extends PeppolPartyName_base$1 {}
-declare const PeppolPartyIdentification_base$1: OpaqueSchema<PeppolPartyIdentification$1, Schema.Struct<{
-  /**
-   * @description An identifier of the Buyer/seller.
-   *
+/**
+ * @description A name by which the Buyer or Seller is known, other than its registered name.
+ *
+ * @example
+ *   ```ts
+ *   { name: 'SupplierTradingName Ltd.' }
+ *   ```;
+ *
+ * @see {@link PeppolPartySchema}
+ */
+declare class PeppolPartyName extends PeppolPartyName_base {}
+declare const PeppolPartyIdentification_base: OpaqueSchema<PeppolPartyIdentification, Schema.Struct<{
+  /**
+   * @description An identifier of the Buyer/seller.
+   *
    * @summary Buyer/seller identifier
    *
    * @name `cbc:ID`
    */
   readonly id: Schema.Struct<{
     readonly id: Schema.String;
-    readonly schemeId: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">>;
+    readonly schemeId: Schema.optional<typeof PeppolIcdCode>;
   }>;
 }>>;
-declare class PeppolPartyIdentification$1 extends PeppolPartyIdentification_base$1 {}
+/**
+ * @description An identifier of the Buyer or Seller, with an optional identification scheme.
+ *
+ * @example
+ *   ```ts
+ *   { id: { id: '99887766', schemeId: '0088' } }
+ *   ```;
+ *
+ * @see {@link PeppolPartySchema}
+ */
+declare class PeppolPartyIdentification extends PeppolPartyIdentification_base {}
 declare const PeppolPartyEndpointId_base: OpaqueSchema<PeppolPartyEndpointId, Schema.Struct<{
   readonly id: Schema.String;
-  readonly schemeId: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolElectronicAddressCode">;
+  readonly schemeId: typeof PeppolElectronicAddressCode;
 }>>;
+/**
+ * @description The Buyer or Seller electronic address to which the application level response to the invoice may be delivered.
+ *
+ * @example
+ *   ```ts
+ *   { id: '9482348239847239874', schemeId: '0088' }
+ *   ```;
+ *
+ * @see {@link PeppolPartySchema}
+ */
 declare class PeppolPartyEndpointId extends PeppolPartyEndpointId_base {}
 declare const PeppolPartySchema_base: OpaqueSchema<PeppolPartySchema, Schema.Struct<{
   /**
@@ -795,7 +1233,7 @@ declare const PeppolPartySchema_base: OpaqueSchema<PeppolPartySchema, Schema.Str
    *
    * @name `cac:PartyIdentification`
    */
-  readonly partyIdentification: Schema.optional<typeof PeppolPartyIdentification$1>;
+  readonly partyIdentification: Schema.optional<typeof PeppolPartyIdentification>;
   /**
    * @example
    *   Seller Business Name AS
@@ -804,7 +1242,7 @@ declare const PeppolPartySchema_base: OpaqueSchema<PeppolPartySchema, Schema.Str
    *
    * @name cac:PartyName
    */
-  readonly partyName: Schema.optional<typeof PeppolPartyName$1>;
+  readonly partyName: Schema.optional<typeof PeppolPartyName>;
   /**
    * @name cac:PostalAddress
    */
@@ -821,13 +1259,15 @@ declare const PeppolPartySchema_base: OpaqueSchema<PeppolPartySchema, Schema.Str
   /**
    * @name cac:PartyLegalEntity
    */
-  readonly partyLegalEntity: typeof PeppolPartyLegalEntity$1;
+  readonly partyLegalEntity: typeof PeppolPartyLegalEntity;
   /**
    * @name cac:Contact
    */
   readonly contact: Schema.optional<typeof PeppolContact>;
 }>>;
 /**
+ * @description The common party substructure shared by the supplier, customer, and other party roles.
+ *
  * @summary Party common substructure
  *
  * @name cac:Party
@@ -835,11 +1275,11 @@ declare const PeppolPartySchema_base: OpaqueSchema<PeppolPartySchema, Schema.Str
 declare class PeppolPartySchema extends PeppolPartySchema_base {}
 //#endregion
 //#region src/schemas/fields/peppol-payee-party-schema.d.ts
-declare const PeppolPartyName_base: OpaqueSchema<PeppolPartyName, Schema.Struct<{
+declare const PeppolPayeePartyName_base: OpaqueSchema<PeppolPayeePartyName, Schema.Struct<{
   readonly name: Schema.String;
 }>>;
-declare class PeppolPartyName extends PeppolPartyName_base {}
-declare const PeppolPartyLegalEntity_base: OpaqueSchema<PeppolPartyLegalEntity, Schema.Struct<{
+declare class PeppolPayeePartyName extends PeppolPayeePartyName_base {}
+declare const PeppolPayeePartyLegalEntity_base: OpaqueSchema<PeppolPayeePartyLegalEntity, Schema.Struct<{
   /**
    * @description An identifier issued by an official registrar that identifies the payee as a legal entity or person.
    *
@@ -852,11 +1292,11 @@ declare const PeppolPartyLegalEntity_base: OpaqueSchema<PeppolPartyLegalEntity,
    */
   readonly companyId: Schema.optional<Schema.Struct<{
     readonly id: Schema.String;
-    readonly schemeId: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">>;
+    readonly schemeId: Schema.optional<typeof PeppolIcdCode>;
   }>>;
 }>>;
-declare class PeppolPartyLegalEntity extends PeppolPartyLegalEntity_base {}
-declare const PeppolPartyIdentification_base: OpaqueSchema<PeppolPartyIdentification, Schema.Struct<{
+declare class PeppolPayeePartyLegalEntity extends PeppolPayeePartyLegalEntity_base {}
+declare const PeppolPayeePartyIdentification_base: OpaqueSchema<PeppolPayeePartyIdentification, Schema.Struct<{
   /**
    * @description This element is used for both the identification of the Payee, or the unique banking reference identifier of Payee (assigned by the Payee
    * bank.) For payee identification use ICD code list, for SEPA bank assigned creditor reference, use SEPA.
@@ -870,20 +1310,20 @@ declare const PeppolPartyIdentification_base: OpaqueSchema<PeppolPartyIdentifica
     readonly schemeId: Schema.optional<Schema.String>;
   }>>;
 }>>;
-declare class PeppolPartyIdentification extends PeppolPartyIdentification_base {}
+declare class PeppolPayeePartyIdentification extends PeppolPayeePartyIdentification_base {}
 declare const PeppolPayeeParty_base: OpaqueSchema<PeppolPayeeParty, Schema.Struct<{
   /**
    * @summary PARTY IDENTIFICATION
    *
    * @name `cac:PartyIdentification`
    */
-  readonly partyIdentification: Schema.optional<typeof PeppolPartyIdentification>;
+  readonly partyIdentification: Schema.optional<typeof PeppolPayeePartyIdentification>;
   /**
    * @summary PARTY LEGAL ENTITY
    *
    * @name `cac:PartyLegalEntity`
    */
-  readonly partyLegalEntity: Schema.optional<typeof PeppolPartyLegalEntity>;
+  readonly partyLegalEntity: Schema.optional<typeof PeppolPayeePartyLegalEntity>;
   /**
    * @description The name of the payee.
    *
@@ -894,7 +1334,7 @@ declare const PeppolPayeeParty_base: OpaqueSchema<PeppolPayeeParty, Schema.Struc
    *
    * @name `cac:PartyName`
    */
-  readonly partyName: typeof PeppolPartyName;
+  readonly partyName: typeof PeppolPayeePartyName;
 }>>;
 /**
  * @description A group of business terms providing information about the Payee, i.e. the role that received the payment. Shall be used wwhen the payee is
@@ -906,6 +1346,24 @@ declare const PeppolPayeeParty_base: OpaqueSchema<PeppolPayeeParty, Schema.Struc
  */
 declare class PeppolPayeeParty extends PeppolPayeeParty_base {}
 //#endregion
+//#region src/schemas/values/payment-means-code-schema.d.ts
+declare const PeppolPaymentMeansCodeValue_base: OpaqueSchema<PeppolPaymentMeansCodeValue, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolPaymentMeansCodeValue">>;
+/**
+ * @description A payment means code from the PEPPOL subset of UNCL 4461.
+ *
+ * @example
+ *   ```ts
+ *   '1';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-16: Payment means code MUST be a valid UNCL 4461 code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4461/
+ * @see {@link paymentMeansCodesKeys}
+ */
+declare class PeppolPaymentMeansCodeValue extends PeppolPaymentMeansCodeValue_base {}
+//#endregion
 //#region src/schemas/fields/peppol-payment-means-schema.d.ts
 declare const PeppolPaymentMandatePayerFinancialAccountId_base: OpaqueSchema<PeppolPaymentMandatePayerFinancialAccountId, Schema.Struct<{
   /**
@@ -920,6 +1378,16 @@ declare const PeppolPaymentMandatePayerFinancialAccountId_base: OpaqueSchema<Pep
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description The account to be debited by a direct debit.
+ *
+ * @example
+ *   ```ts
+ *   { id: '12345676543' }
+ *   ```;
+ *
+ * @see {@link PeppolPaymentMandate}
+ */
 declare class PeppolPaymentMandatePayerFinancialAccountId extends PeppolPaymentMandatePayerFinancialAccountId_base {}
 declare const PeppolPaymentMandate_base: OpaqueSchema<PeppolPaymentMandate, Schema.Struct<{
   /**
@@ -942,6 +1410,16 @@ declare const PeppolPaymentMandate_base: OpaqueSchema<PeppolPaymentMandate, Sche
    */
   readonly payerFinancialAccountId: Schema.optional<typeof PeppolPaymentMandatePayerFinancialAccountId>;
 }>>;
+/**
+ * @description A group of business terms to specify a direct debit, including the mandate reference and the debited account.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'MandateReference', payerFinancialAccountId: { id: '12345676543' } }
+ *   ```;
+ *
+ * @see {@link PeppolPaymentMeans}
+ */
 declare class PeppolPaymentMandate extends PeppolPaymentMandate_base {}
 declare const PeppolPayeeFinancialAccountFinancialInstitutionBranch_base: OpaqueSchema<PeppolPayeeFinancialAccountFinancialInstitutionBranch, Schema.Struct<{
   /**
@@ -957,6 +1435,16 @@ declare const PeppolPayeeFinancialAccountFinancialInstitutionBranch_base: Opaque
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description The payment service provider where the payee payment account is held, such as a BIC or national clearing code.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'BIC324098' }
+ *   ```;
+ *
+ * @see {@link PeppolPayeeFinancialAccount}
+ */
 declare class PeppolPayeeFinancialAccountFinancialInstitutionBranch extends PeppolPayeeFinancialAccountFinancialInstitutionBranch_base {}
 declare const PeppolPayeeFinancialAccount_base: OpaqueSchema<PeppolPayeeFinancialAccount, Schema.Struct<{
   /**
@@ -988,6 +1476,16 @@ declare const PeppolPayeeFinancialAccount_base: OpaqueSchema<PeppolPayeeFinancia
    */
   readonly name: Schema.optional<Schema.String>;
 }>>;
+/**
+ * @description The payment account to which payment should be made, such as an IBAN or BBAN, including the financial institution branch.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'IBAN32423940', name: 'AccountName' }
+ *   ```;
+ *
+ * @see {@link PeppolPaymentMeans}
+ */
 declare class PeppolPayeeFinancialAccount extends PeppolPayeeFinancialAccount_base {}
 declare const PeppolCardAccount_base: OpaqueSchema<PeppolCardAccount, Schema.Struct<{
   /**
@@ -1017,6 +1515,16 @@ declare const PeppolCardAccount_base: OpaqueSchema<PeppolCardAccount, Schema.Str
    */
   readonly primaryAccountNumberId: Schema.String;
 }>>;
+/**
+ * @description The card used for payment, including the card holder name and the primary account number.
+ *
+ * @example
+ *   ```ts
+ *   { networkId: 'VISA', primaryAccountNumberId: '1234' }
+ *   ```;
+ *
+ * @see {@link PeppolPaymentMeans}
+ */
 declare class PeppolCardAccount extends PeppolCardAccount_base {}
 declare const PeppolPaymentMeansCode_base: OpaqueSchema<PeppolPaymentMeansCode, Schema.Struct<{
   /**
@@ -1029,7 +1537,7 @@ declare const PeppolPaymentMeansCode_base: OpaqueSchema<PeppolPaymentMeansCode,
    *
    * @name `#text`
    */
-  readonly code: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolPaymentMeansCode">;
+  readonly code: typeof PeppolPaymentMeansCodeValue;
   /**
    * @description The means, expressed as text, for how a payment is expected to be or has been settled.
    *
@@ -1042,6 +1550,16 @@ declare const PeppolPaymentMeansCode_base: OpaqueSchema<PeppolPaymentMeansCode,
    */
   readonly name: Schema.optional<Schema.String>;
 }>>;
+/**
+ * @description The means by which a payment is expected to be or has been settled, expressed as a UNCL 4461 code and optional text.
+ *
+ * @example
+ *   ```ts
+ *   { code: '30', name: 'Credit transfer' }
+ *   ```;
+ *
+ * @see {@link PeppolPaymentMeans}
+ */
 declare class PeppolPaymentMeansCode extends PeppolPaymentMeansCode_base {}
 declare const PeppolPaymentMeans_base: OpaqueSchema<PeppolPaymentMeans, Schema.Struct<{
   /**
@@ -1129,6 +1647,8 @@ declare const PeppolPaymentTerms_base: OpaqueSchema<PeppolPaymentTerms, Schema.S
   readonly note: Schema.String;
 }>>;
 /**
+ * @description A textual description of the payment terms that apply to the amount due for payment.
+ *
  * @summary PAYMENT TERMS
  *
  * @name cac:PaymentTerms
@@ -1148,12 +1668,252 @@ declare const PeppolTaxRepresentative_base: OpaqueSchema<PeppolTaxRepresentative
   readonly partyTaxScheme: typeof PeppolPartyTaxScheme;
 }>>;
 /**
+ * @description The party acting as the Seller tax representative, including its name, postal address, and tax scheme.
+ *
  * @summary SELLER TAX REPRESENTATIVE PARTY
  *
  * @name cac:TaxRepresentativeParty
  */
 declare class PeppolTaxRepresentative extends PeppolTaxRepresentative_base {}
-type PeppolTaxRepresentativeParty = PeppolTaxRepresentative;
+//#endregion
+//#region src/schemas/values/application-response-type-code-schema.d.ts
+declare const PeppolApplicationResponseTypeCode_base: OpaqueSchema<PeppolApplicationResponseTypeCode, Schema.Literals<readonly ["AB", "AP", "RE"]>>;
+/**
+ * @description An application response type code from the PEPPOL subset of UNCL 4343.
+ *
+ * @example
+ *   ```ts
+ *   'AB';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343/
+ * @see {@link applicationResponseTypeCodesKeys}
+ */
+declare class PeppolApplicationResponseTypeCode extends PeppolApplicationResponseTypeCode_base {}
+//#endregion
+//#region src/schemas/values/credit-note-type-code-schema.d.ts
+declare const PeppolCreditNoteTypeCode_base: OpaqueSchema<PeppolCreditNoteTypeCode, Schema.Literals<readonly ["81", "83", "381", "396", "532"]>>;
+/**
+ * @description A credit note type code from the PEPPOL subset of UNCL 1001 (credit note).
+ *
+ * @example
+ *   ```ts
+ *   '81';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-cn/
+ * @see {@link creditNoteTypeCodesKeys}
+ */
+declare class PeppolCreditNoteTypeCode extends PeppolCreditNoteTypeCode_base {}
+//#endregion
+//#region src/schemas/values/peppol-document-type-code-schema.d.ts
+declare const PeppolDocumentTypeCode_base: OpaqueSchema<PeppolDocumentTypeCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolDocumentTypeCode">>;
+/**
+ * @description A document type code from the PEPPOL subset of UNCL 1001.
+ *
+ * @example
+ *   ```ts
+ *   '1';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001/
+ * @see {@link documentTypeCodesKeys}
+ */
+declare class PeppolDocumentTypeCode extends PeppolDocumentTypeCode_base {}
+//#endregion
+//#region src/schemas/values/peppol-document-type-schema.d.ts
+declare const PeppolDocumentType_base: OpaqueSchema<PeppolDocumentType, Schema.TemplateLiteral<readonly [Schema.Literals<readonly ["busdox-docid-qns", "peppol-doctype-wildcard"]>, Schema.Literal<"::">, Schema.String]>>;
+/**
+ * @description A full PEPPOL document type identifier in `<scheme>::<value>` form. The scheme prefix and value must both be known.
+ *
+ * @see {@link documentTypesTable}
+ */
+declare class PeppolDocumentType extends PeppolDocumentType_base {}
+//#endregion
+//#region src/schemas/values/document-type-schemes-schema.d.ts
+declare const PeppolDocumentTypeScheme_base: OpaqueSchema<PeppolDocumentTypeScheme, Schema.Literals<[string, ...string[]]>>;
+/**
+ * @description A PEPPOL document type scheme, for example `busdox-docid-qns` or `peppol-doctype-wildcard`.
+ *
+ * @example
+ *   ```ts
+ *   'busdox-docid-qns';
+ *   ```;
+ *
+ * @see {@link documentTypesScheme}
+ */
+declare class PeppolDocumentTypeScheme extends PeppolDocumentTypeScheme_base {}
+//#endregion
+//#region src/schemas/values/document-type-values-schema.d.ts
+declare const PeppolDocumentTypeValue_base: OpaqueSchema<PeppolDocumentTypeValue, Schema.String>;
+/**
+ * @description The value part of a PEPPOL document type identifier (the portion after the scheme prefix) from the known document type table.
+ *
+ * @see {@link documentTypesTable}
+ */
+declare class PeppolDocumentTypeValue extends PeppolDocumentTypeValue_base {}
+//#endregion
+//#region src/schemas/values/invoice-status-code-schema.d.ts
+declare const PeppolInvoiceStatusCodes_base: OpaqueSchema<PeppolInvoiceStatusCodes, Schema.brand<Schema.Literals<readonly ["AB", "AP", "RE", "IP", "UQ", "CA", "PD"]>, "PeppolInvoiceStatusCodes">>;
+/**
+ * @description An invoice status code from the PEPPOL subset of UNCL 4343 (T111).
+ *
+ * @example
+ *   ```ts
+ *   'AB';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343-T111/
+ * @see {@link invoiceStatusCodesKeys}
+ */
+declare class PeppolInvoiceStatusCodes extends PeppolInvoiceStatusCodes_base {}
+//#endregion
+//#region src/schemas/values/invoice-type-code-schema.d.ts
+declare const PeppolInvoiceTypeCode_base: OpaqueSchema<PeppolInvoiceTypeCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolInvoiceTypeCode">>;
+/**
+ * @description An invoice type code from the PEPPOL subset of UNCL 1001.
+ *
+ * @example
+ *   ```ts
+ *   '71';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/
+ * @see {@link invoiceTypeCodesKeys}
+ */
+declare class PeppolInvoiceTypeCode extends PeppolInvoiceTypeCode_base {}
+//#endregion
+//#region src/schemas/values/item-classification-codes-schema.d.ts
+declare const PeppolItemClassificationCode_base: OpaqueSchema<PeppolItemClassificationCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolItemClassificationCode">>;
+/**
+ * @description An item classification code from the PEPPOL subset of UNCL 7143.
+ *
+ * @example
+ *   ```ts
+ *   'AA';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-13: Item classification scheme MUST be a valid UNTDID 7143 code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7143/
+ * @see {@link itemClassificationCodesKeys}
+ */
+declare class PeppolItemClassificationCode extends PeppolItemClassificationCode_base {}
+//#endregion
+//#region src/schemas/values/op-status-action-schema.d.ts
+declare const PeppolOpStatusAction_base: OpaqueSchema<PeppolOpStatusAction, Schema.brand<Schema.Literals<readonly ["NOA", "PIN", "NIN", "CNF", "CNP", "CNA", "OTH"]>, "PeppolOpStatusAction">>;
+/**
+ * @description An OpenPeppol operation status action code from the OPStatusAction codelist.
+ *
+ * @example
+ *   ```ts
+ *   'NOA';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusAction/
+ * @see {@link opStatusActionKeys}
+ */
+declare class PeppolOpStatusAction extends PeppolOpStatusAction_base {}
+//#endregion
+//#region src/schemas/values/op-status-reason-schema.d.ts
+declare const PeppolOpStatusReason_base: OpaqueSchema<PeppolOpStatusReason, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolOpStatusReason">>;
+/**
+ * @description An OpenPeppol operation status reason code from the OPStatusReason codelist.
+ *
+ * @example
+ *   ```ts
+ *   'NON';
+ *   ```;
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusReason/
+ * @see {@link opStatusReasonKeys}
+ */
+declare class PeppolOpStatusReason extends PeppolOpStatusReason_base {}
+//#endregion
+//#region src/schemas/values/participant-identifier-code-schema.d.ts
+declare const PeppolParticipantIdentifierCode_base: OpaqueSchema<PeppolParticipantIdentifierCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolParticipantIdentifierCode">>;
+/**
+ * @description A PEPPOL participant identifier scheme from the participant identifier schemes codelist.
+ *
+ * @example
+ *   ```ts
+ *   '0002';
+ *   ```;
+ *
+ * @see {@link participantIdentifierSchemesKeys}
+ */
+declare class PeppolParticipantIdentifierCode extends PeppolParticipantIdentifierCode_base {}
+//#endregion
+//#region src/schemas/values/peppol-process-schema.d.ts
+declare const PeppolProcess_base: OpaqueSchema<PeppolProcess, Schema.TemplateLiteral<readonly [Schema.Literals<readonly ["cenbii-procid-ubl", "oioubl-procid-ubl"]>, Schema.Literal<"::">, Schema.String]>>;
+/**
+ * @description A full PEPPOL business process identifier in `<scheme>::<value>` form from the known processes table.
+ *
+ * @example
+ *   ```ts
+ *   'cenbii-procid-ubl::urn:fdc:peppol.eu:2017:poacc:billing:01:1.0';
+ *   ```;
+ *
+ * @see {@link processes}
+ */
+declare class PeppolProcess extends PeppolProcess_base {}
+/**
+ * @description A PEPPOL business process identifier key as defined by the processes codelist.
+ *
+ * @see {@link processes}
+ */
+type PeppolProcesses = Schema.Codec.Encoded<typeof PeppolProcess>;
+//#endregion
+//#region src/schemas/values/process-from-document-type-schema.d.ts
+/**
+ * @description Validates a business process identifier (`<scheme>::<value>`) against the processes allowed for a given document type.
+ *
+ * @param documentType - The PEPPOL document type scheme whose allowed processes should be used.
+ * @param error - The custom error message to use when validation fails. Defaults to `'invalid process type for document type'`.
+ *
+ * @returns An Effect schema that matches only processes allowed for the given document type.
+ *
+ * @see {@link PeppolProcess}
+ * @see {@link documentTypesProcessIds}
+ */
+declare function processFromDocumentTypeSchema(documentType: PeppolDocumentType, error?: string): Schema.String | typeof PeppolProcess;
+//#endregion
+//#region src/schemas/values/quantity-unit-codes-schema.d.ts
+declare const PeppolQuantityUnitCode_base: OpaqueSchema<PeppolQuantityUnitCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolQuantityUnitCode">>;
+/**
+ * @description A unit of measure code from the PEPPOL subset of UN/ECE Recommendation 20.
+ *
+ * @example
+ *   ```ts
+ *   '10';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-23: Unit of measure code MUST be a valid UN/ECE Rec 20 code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNECERec20/
+ * @see {@link quantityUnitCodesKeys}
+ */
+declare class PeppolQuantityUnitCode extends PeppolQuantityUnitCode_base {}
+//#endregion
+//#region src/schemas/values/vatex-code-schema.d.ts
+declare const PeppolVatexCode_base: OpaqueSchema<PeppolVatexCode, Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolVatexCode">>;
+/**
+ * @description A VAT exemption reason code from the CEF VATEX codelist.
+ *
+ * @example
+ *   ```ts
+ *   'VATEX-EU-79-C';
+ *   ```;
+ *
+ * @validations
+ * - BR-CL-22: VAT exemption reason code MUST be a valid CEF VATEX code.
+ *
+ * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/vatex/
+ * @see {@link vatexCodesKeys}
+ */
+declare class PeppolVatexCode extends PeppolVatexCode_base {}
 //#endregion
 //#region src/schemas/fields/peppol-tax-category-schema.d.ts
 declare const PeppolTaxSchemeId_base: OpaqueSchema<PeppolTaxSchemeId, Schema.Struct<{
@@ -1162,6 +1922,16 @@ declare const PeppolTaxSchemeId_base: OpaqueSchema<PeppolTaxSchemeId, Schema.Str
    */
   readonly id: Schema.withDecodingDefaultType<Schema.String, never>;
 }>>;
+/**
+ * @description The tax scheme identifier for a tax category, defaulting to `VAT` when the element is absent.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'VAT' }
+ *   ```;
+ *
+ * @see {@link PeppolTaxCategory}
+ */
 declare class PeppolTaxSchemeId extends PeppolTaxSchemeId_base {}
 declare const PeppolTaxCategory_base: OpaqueSchema<PeppolTaxCategory, Schema.Struct<{
   /**
@@ -1171,7 +1941,7 @@ declare const PeppolTaxCategory_base: OpaqueSchema<PeppolTaxCategory, Schema.Str
    *
    * @name `cbc:ID`
    */
-  readonly id: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
+  readonly id: typeof PeppolDutyTaxFeeCategoryCode;
   /**
    * @description The VAT rate, represented as percentage that applies to the invoiced item.
    *
@@ -1198,7 +1968,7 @@ declare class PeppolTaxCategory extends PeppolTaxCategory_base {}
 //#endregion
 //#region src/schemas/fields/peppol-tax-subtotal-category-schema.d.ts
 declare const PeppolTaxSubTotalCategory_base: OpaqueSchema<PeppolTaxSubTotalCategory, Schema.Struct<{
-  readonly id: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
+  readonly id: typeof PeppolDutyTaxFeeCategoryCode;
   readonly percent: Schema.optional<Schema.Finite>;
   readonly taxSchemeId: typeof PeppolTaxSchemeId;
   /**
@@ -1222,6 +1992,9 @@ declare const PeppolTaxSubTotalCategory_base: OpaqueSchema<PeppolTaxSubTotalCate
  * @name cac:TaxCategory
  */
 declare class PeppolTaxSubTotalCategory extends PeppolTaxSubTotalCategory_base {}
+/**
+ * @description The encoded form of {@link PeppolTaxSubTotalCategory}, accepted by the decoder before branded code values are applied.
+ */
 interface PeppolTaxSubTotalCategoryEncoded extends Schema.Codec.Encoded<typeof PeppolTaxSubTotalCategory> {}
 //#endregion
 //#region src/schemas/fields/peppol-tax-subtotal-schema.d.ts
@@ -1246,6 +2019,8 @@ declare const PeppolTaxSubTotal_base: OpaqueSchema<PeppolTaxSubTotal, Schema.Str
   readonly taxableAmount: typeof PeppolAmount;
 }>>;
 /**
+ * @description A VAT breakdown line for a single tax category, giving the taxable amount and the tax amount.
+ *
  * @summary VAT breakdown (TaxSubtotal)
  *
  * @name cac:TaxSubtotal
@@ -1253,7 +2028,7 @@ declare const PeppolTaxSubTotal_base: OpaqueSchema<PeppolTaxSubTotal, Schema.Str
 declare class PeppolTaxSubTotal extends PeppolTaxSubTotal_base {}
 //#endregion
 //#region src/schemas/fields/peppol-tax-totals-base-schema.d.ts
-declare const PeppolTaxTotalsBase_base: OpaqueSchema<PeppolTaxTotalsBase, Schema.Struct<{
+declare const PeppolTaxTotal_base: OpaqueSchema<PeppolTaxTotal, Schema.Struct<{
   /**
    * @example
    *   200;
@@ -1267,12 +2042,13 @@ declare const PeppolTaxTotalsBase_base: OpaqueSchema<PeppolTaxTotalsBase, Schema
   readonly taxSubtotals: Schema.optional<Schema.$Array<typeof PeppolTaxSubTotal>>;
 }>>;
 /**
+ * @description The total tax amount for the document, with an optional breakdown into tax subtotals.
+ *
  * @summary TAX TOTAL
  *
  * @name cac:TaxTotal (1..2)
  */
-declare class PeppolTaxTotalsBase extends PeppolTaxTotalsBase_base {}
-type PeppolTaxTotal = PeppolTaxTotalsBase;
+declare class PeppolTaxTotal extends PeppolTaxTotal_base {}
 //#endregion
 //#region src/schemas/peppol-billing-base-schema.d.ts
 declare const PeppolContractDocumentReference_base: OpaqueSchema<PeppolContractDocumentReference, Schema.Struct<{
@@ -1288,6 +2064,16 @@ declare const PeppolContractDocumentReference_base: OpaqueSchema<PeppolContractD
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description Wraps the `cac:ContractDocumentReference` element: an identifier of a contract that the billing document references.
+ *
+ * @example
+ *   ```ts
+ *   { id: '123Contractref' }
+ *   ```;
+ *
+ * @see {@link PeppolBillingBase}
+ */
 declare class PeppolContractDocumentReference extends PeppolContractDocumentReference_base {}
 declare const PeppolOriginatorDocumentReference_base: OpaqueSchema<PeppolOriginatorDocumentReference, Schema.Struct<{
   /**
@@ -1302,6 +2088,16 @@ declare const PeppolOriginatorDocumentReference_base: OpaqueSchema<PeppolOrigina
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description Wraps the `cac:OriginatorDocumentReference` element: the identification of the call for tender or lot the invoice relates to.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'PPID-123' }
+ *   ```;
+ *
+ * @see {@link PeppolBillingBase}
+ */
 declare class PeppolOriginatorDocumentReference extends PeppolOriginatorDocumentReference_base {}
 declare const PeppolReceiptDocumentReference_base: OpaqueSchema<PeppolReceiptDocumentReference, Schema.Struct<{
   /**
@@ -1316,6 +2112,16 @@ declare const PeppolReceiptDocumentReference_base: OpaqueSchema<PeppolReceiptDoc
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description Wraps the `cac:ReceiptDocumentReference` element: an identifier of a referenced receiving advice.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'rec98' }
+ *   ```;
+ *
+ * @see {@link PeppolBillingBase}
+ */
 declare class PeppolReceiptDocumentReference extends PeppolReceiptDocumentReference_base {}
 declare const PeppolDespatchDocumentReference_base: OpaqueSchema<PeppolDespatchDocumentReference, Schema.Struct<{
   /**
@@ -1330,6 +2136,16 @@ declare const PeppolDespatchDocumentReference_base: OpaqueSchema<PeppolDespatchD
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description Wraps the `cac:DespatchDocumentReference` element: an identifier of a referenced despatch advice.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'desp98' }
+ *   ```;
+ *
+ * @see {@link PeppolBillingBase}
+ */
 declare class PeppolDespatchDocumentReference extends PeppolDespatchDocumentReference_base {}
 declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Struct<{
   /**
@@ -1413,7 +2229,7 @@ declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Str
    *
    * @name `cbc:DocumentCurrencyCode`
    */
-  readonly documentCurrencyCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">;
+  readonly documentCurrencyCode: typeof PeppolCurrencyCode;
   /**
    * @description The currency used for VAT accounting and reporting purposes as accepted or required in the country of the Seller. Shall be used in combination
    * with the Invoice total VAT amount in accounting currency (BT-111), when the VAT accounting currency code differs from the Invoice currency
@@ -1426,7 +2242,7 @@ declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Str
    *
    * @name `cbc:TaxCurrencyCode`
    */
-  readonly taxCurrencyCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">>;
+  readonly taxCurrencyCode: Schema.optional<typeof PeppolCurrencyCode>;
   /**
    * @description A textual value that specifies where to book the relevant data into the Buyer's financial accounts.
    *
@@ -1566,7 +2382,7 @@ declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Str
    *
    * @name cac:AllowanceCharge
    */
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolAllowance, typeof PeppolCharge]>>>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolAllowanceCharge>>;
   /**
    * @description When tax currency code is provided, two instances of the tax total must be present, but only one with tax subtotal.
    *
@@ -1574,7 +2390,7 @@ declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Str
    *
    * @name cac:TaxTotal
    */
-  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotalsBase>;
+  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotal>;
   /**
    * @summary DOCUMENT TOTALS
    *
@@ -1585,8 +2401,8 @@ declare const PeppolBillingBase_base: OpaqueSchema<PeppolBillingBase, Schema.Str
 /**
  * @description Base schema for a billing document.
  *
- * @see {@link creditNoteSchema} - the credit note schema
- * @see {@link invoiceSchema} - the invoice schema
+ * @see {@link PeppolCreditNote} - the credit note schema
+ * @see {@link PeppolInvoice} - the invoice schema
  */
 declare class PeppolBillingBase extends PeppolBillingBase_base {}
 //#endregion
@@ -1604,6 +2420,17 @@ declare const BaseLineAllowanceCharge_base: OpaqueSchema<BaseLineAllowanceCharge
    */
   readonly multiplierFactorNumeric: Schema.optional<Schema.Finite>;
 }>>;
+/**
+ * @description Shared fields for an allowance or charge applied to an Invoice line. Extends the price level allowance and charge fields with the reason text and
+ * the multiplier factor used to calculate the amount.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 200, currencyId: 'EUR' }, chargeIndicator: false, allowanceChargeReason: 'Discount' }
+ *   ```;
+ *
+ * @see {@link PeppolLineAllowanceCharge}
+ */
 declare class BaseLineAllowanceCharge extends BaseLineAllowanceCharge_base {}
 declare const PeppolLineAllowance_base: OpaqueSchema<PeppolLineAllowance, Schema.Struct<{
   readonly amount: typeof PeppolAmount;
@@ -1619,7 +2446,7 @@ declare const PeppolLineAllowance_base: OpaqueSchema<PeppolLineAllowance, Schema
   /**
    * @name cbc:AllowanceChargeReasonCode
    */
-  readonly allowanceChargeReasonCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAllowanceChargeReasonCode">>;
+  readonly allowanceChargeReasonCode: Schema.optional<typeof PeppolAllowanceChargeReasonCode>;
   /**
    * @name cbc:ChargeIndicator
    *
@@ -1627,6 +2454,17 @@ declare const PeppolLineAllowance_base: OpaqueSchema<PeppolLineAllowance, Schema
    */
   readonly chargeIndicator: Schema.Literal<false>;
 }>>;
+/**
+ * @description An allowance applied to an Invoice line, marked by a `cbc:ChargeIndicator` of `false`. Adds an allowance reason code to the shared line allowance
+ * and charge fields.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 200, currencyId: 'EUR' }, chargeIndicator: false, allowanceChargeReasonCode: '95' }
+ *   ```;
+ *
+ * @see {@link PeppolLineAllowanceCharge}
+ */
 declare class PeppolLineAllowance extends PeppolLineAllowance_base {}
 declare const PeppolLineCharge_base: OpaqueSchema<PeppolLineCharge, Schema.Struct<{
   readonly amount: typeof PeppolAmount;
@@ -1642,7 +2480,7 @@ declare const PeppolLineCharge_base: OpaqueSchema<PeppolLineCharge, Schema.Struc
   /**
    * @name cbc:AllowanceChargeReasonCode
    */
-  readonly allowanceChargeReasonCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolChargeReasonCode">>;
+  readonly allowanceChargeReasonCode: Schema.optional<typeof PeppolChargeReasonCode>;
   /**
    * @name cbc:ChargeIndicator
    *
@@ -1650,12 +2488,39 @@ declare const PeppolLineCharge_base: OpaqueSchema<PeppolLineCharge, Schema.Struc
    */
   readonly chargeIndicator: Schema.Literal<true>;
 }>>;
-declare class PeppolLineCharge extends PeppolLineCharge_base {}
-declare const peppolLineAllowanceChargeSchema: Schema.Union<readonly [typeof PeppolLineAllowance, typeof PeppolLineCharge]>;
-type PeppolLineAllowanceCharge = typeof peppolLineAllowanceChargeSchema.Type;
-type PeppolLineAllowanceChargeEncoded = typeof peppolLineAllowanceChargeSchema.Encoded;
-//#endregion
-//#region src/schemas/fields/peppol-invoice-line-period-schema.d.ts
+/**
+ * @description A charge applied to an Invoice line, marked by a `cbc:ChargeIndicator` of `true`. Adds a charge reason code to the shared line allowance and charge
+ * fields.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 25, currencyId: 'EUR' }, chargeIndicator: true, allowanceChargeReasonCode: 'AA' }
+ *   ```;
+ *
+ * @see {@link PeppolLineAllowanceCharge}
+ */
+declare class PeppolLineCharge extends PeppolLineCharge_base {}
+declare const PeppolLineAllowanceCharge_base: Schema.Union<readonly [typeof PeppolLineAllowance, typeof PeppolLineCharge]>;
+/**
+ * @description An allowance or charge applied to an Invoice line, selected by the `cbc:ChargeIndicator` value: `false` selects an allowance, `true` selects a
+ * charge.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 25, currencyId: 'EUR' }, chargeIndicator: true, allowanceChargeReasonCode: 'AA', allowanceChargeReason: 'Advertising' }
+ *   ```;
+ *
+ * @see {@link PeppolLineAllowance}
+ */
+declare class PeppolLineAllowanceCharge extends PeppolLineAllowanceCharge_base {}
+/**
+ * @description Encoded form of {@link PeppolLineAllowanceCharge} produced by the Effect Schema codec.
+ *
+ * @see {@link PeppolLineAllowanceCharge}
+ */
+type PeppolLineAllowanceChargeEncoded = Schema.Codec.Encoded<typeof PeppolLineAllowanceCharge>;
+//#endregion
+//#region src/schemas/fields/peppol-invoice-line-period-schema.d.ts
 declare const PeppolInvoiceLinePeriod_base: OpaqueSchema<PeppolInvoiceLinePeriod, Schema.Struct<{
   /**
    * @description The date when the Invoice period for this Invoice line ends. Format ="YYYY-MM-DD"
@@ -1684,6 +2549,17 @@ declare const PeppolInvoiceLinePeriod_base: OpaqueSchema<PeppolInvoiceLinePeriod
    */
   readonly startDate: Schema.optional<typeof PeppolIsoDateString>;
 }>>;
+/**
+ * @description The period relevant for an Invoice line, given by an optional start date and end date. Wraps the `cac:InvoicePeriod` element as used on a line; the
+ * document level period extends this shape in {@link PeppolInvoicePeriod}.
+ *
+ * @example
+ *   ```ts
+ *   { startDate: '2017-10-01', endDate: '2017-10-31' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoicePeriod}
+ */
 declare class PeppolInvoiceLinePeriod extends PeppolInvoiceLinePeriod_base {}
 //#endregion
 //#region src/schemas/fields/peppol-item-classification-schema.d.ts
@@ -1703,7 +2579,7 @@ declare const PeppolItemClassification_base: OpaqueSchema<PeppolItemClassificati
    *
    * @name `@listID`
    */
-  readonly listId: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolItemClassificationCode">;
+  readonly listId: typeof PeppolItemClassificationCode;
   /**
    * @description The identification scheme version identifier of the Item classification identifier.
    *
@@ -1747,6 +2623,16 @@ declare const PeppolAdditionalItemProperties_base: OpaqueSchema<PeppolAdditional
    */
   readonly value: Schema.String;
 }>>;
+/**
+ * @description An additional property of the item, expressed as an attribute name and value pair.
+ *
+ * @example
+ *   ```ts
+ *   { name: 'Colour', value: 'Blue' }
+ *   ```;
+ *
+ * @see {@link PeppolLineItem}
+ */
 declare class PeppolAdditionalItemProperties extends PeppolAdditionalItemProperties_base {}
 declare const PeppolCommodityClassifications_base: OpaqueSchema<PeppolCommodityClassifications, Schema.Struct<{
   /**
@@ -1761,6 +2647,16 @@ declare const PeppolCommodityClassifications_base: OpaqueSchema<PeppolCommodityC
    */
   readonly itemClassification: typeof PeppolItemClassification;
 }>>;
+/**
+ * @description A code classifying the item by its type or nature, identified by a scheme such as CPV.
+ *
+ * @example
+ *   ```ts
+ *   { itemClassification: { id: '09348023', listId: 'STI' } }
+ *   ```;
+ *
+ * @see {@link PeppolItemClassification}
+ */
 declare class PeppolCommodityClassifications extends PeppolCommodityClassifications_base {}
 declare const PeppolOriginCountryCode_base: OpaqueSchema<PeppolOriginCountryCode, Schema.Struct<{
   /**
@@ -1770,8 +2666,18 @@ declare const PeppolOriginCountryCode_base: OpaqueSchema<PeppolOriginCountryCode
    *
    * @name `cbc:IdentificationCode`
    */
-  readonly identificationCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCountryCode">;
+  readonly identificationCode: typeof PeppolCountryCodeValue;
 }>>;
+/**
+ * @description The country from which the item originates, identified by an ISO 3166-1 country code.
+ *
+ * @example
+ *   ```ts
+ *   { identificationCode: 'NO' }
+ *   ```;
+ *
+ * @see {@link PeppolLineItem}
+ */
 declare class PeppolOriginCountryCode extends PeppolOriginCountryCode_base {}
 declare const PeppolStandardItemIdentification_base: OpaqueSchema<PeppolStandardItemIdentification, Schema.Struct<{
   /**
@@ -1783,9 +2689,19 @@ declare const PeppolStandardItemIdentification_base: OpaqueSchema<PeppolStandard
    */
   readonly id: Schema.Struct<{
     readonly id: Schema.String;
-    readonly schemeId: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">;
+    readonly schemeId: typeof PeppolIcdCode;
   }>;
 }>>;
+/**
+ * @description An item identifier based on a registered scheme, such as a GTIN or EAN.
+ *
+ * @example
+ *   ```ts
+ *   { id: { id: '21382183120983', schemeId: '0088' } }
+ *   ```;
+ *
+ * @see {@link PeppolIdentifier}
+ */
 declare class PeppolStandardItemIdentification extends PeppolStandardItemIdentification_base {}
 declare const PeppolSellersItemIdentification_base: OpaqueSchema<PeppolSellersItemIdentification, Schema.Struct<{
   /**
@@ -1800,6 +2716,16 @@ declare const PeppolSellersItemIdentification_base: OpaqueSchema<PeppolSellersIt
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description An identifier assigned by the Seller for the item.
+ *
+ * @example
+ *   ```ts
+ *   { id: '987323' }
+ *   ```;
+ *
+ * @see {@link PeppolLineItem}
+ */
 declare class PeppolSellersItemIdentification extends PeppolSellersItemIdentification_base {}
 declare const PeppolBuyersItemIdentification_base: OpaqueSchema<PeppolBuyersItemIdentification, Schema.Struct<{
   /**
@@ -1814,6 +2740,16 @@ declare const PeppolBuyersItemIdentification_base: OpaqueSchema<PeppolBuyersItem
    */
   readonly id: Schema.String;
 }>>;
+/**
+ * @description An identifier assigned by the Buyer for the item.
+ *
+ * @example
+ *   ```ts
+ *   { id: '12345' }
+ *   ```;
+ *
+ * @see {@link PeppolLineItem}
+ */
 declare class PeppolBuyersItemIdentification extends PeppolBuyersItemIdentification_base {}
 declare const PeppolLineItem_base: OpaqueSchema<PeppolLineItem, Schema.Struct<{
   /**
@@ -1880,12 +2816,13 @@ declare const PeppolLineItem_base: OpaqueSchema<PeppolLineItem, Schema.Struct<{
   readonly additionalItemProperties: Schema.optional<Schema.$Array<typeof PeppolAdditionalItemProperties>>;
 }>>;
 /**
+ * @description The item details for an invoice or credit note line, including its name, identifiers, classification, and line VAT category.
+ *
  * @summary Item details on invoice/credit-note line
  *
  * @name cac:Item
  */
 declare class PeppolLineItem extends PeppolLineItem_base {}
-type PeppolItem = PeppolLineItem;
 //#endregion
 //#region src/schemas/fields/peppol-line-price-allowance-charge-schema.d.ts
 declare const PriceAllowanceCharge_base: OpaqueSchema<PriceAllowanceCharge, Schema.Struct<{
@@ -1910,12 +2847,32 @@ declare const PriceAllowanceCharge_base: OpaqueSchema<PriceAllowanceCharge, Sche
    */
   readonly chargeIndicator: Schema.Boolean;
 }>>;
+/**
+ * @description A price level allowance or charge applied to the item price, expressed as an amount and a charge indicator.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 200, currencyId: 'EUR' }, chargeIndicator: false }
+ *   ```;
+ *
+ * @see {@link PeppolLinePriceAllowanceCharge}
+ */
 declare class PriceAllowanceCharge extends PriceAllowanceCharge_base {}
 declare const PeppolLinePriceAllowanceCharge_base: OpaqueSchema<PeppolLinePriceAllowanceCharge, Schema.Struct<{
   readonly amount: typeof PeppolAmount;
   readonly baseAmount: Schema.optional<typeof PeppolAmount>;
   readonly chargeIndicator: Schema.Literal<false>;
 }>>;
+/**
+ * @description A price level allowance on the item price. Only allowances are allowed at price level, so the charge indicator is fixed to false.
+ *
+ * @example
+ *   ```ts
+ *   { amount: { value: 200, currencyId: 'EUR' }, chargeIndicator: false }
+ *   ```;
+ *
+ * @see {@link PeppolLinePrice}
+ */
 declare class PeppolLinePriceAllowanceCharge extends PeppolLinePriceAllowanceCharge_base {}
 //#endregion
 //#region src/schemas/fields/peppol-quantity-schema.d.ts
@@ -1923,13 +2880,15 @@ declare const PeppolQuantity_base: OpaqueSchema<PeppolQuantity, Schema.Struct<{
   /**
    * @name `@unitCode`
    */
-  readonly unitCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolQuantityUnitCode">>;
+  readonly unitCode: Schema.optional<typeof PeppolQuantityUnitCode>;
   /**
    * @name `#text (value)`
    */
   readonly value: Schema.Finite;
 }>>;
 /**
+ * @description A quantity value with an optional unit of measure code.
+ *
  * @summary Quantity with optional unit code
  *
  * @name `cbc:* (+ @unitCode)`
@@ -1956,6 +2915,8 @@ declare const PeppolLinePrice_base: OpaqueSchema<PeppolLinePrice, Schema.Struct<
   readonly priceAmount: typeof PeppolAmount;
 }>>;
 /**
+ * @description The price details of an invoice or credit note line, including the price amount and any price level allowance.
+ *
  * @summary Price details on invoice line
  *
  * @name cac:Price
@@ -1966,6 +2927,16 @@ declare class PeppolLinePrice extends PeppolLinePrice_base {}
 declare const PeppolOrderLineReference_base: OpaqueSchema<PeppolOrderLineReference, Schema.Struct<{
   readonly lineId: Schema.String;
 }>>;
+/**
+ * @description A reference to the order line that the Invoice line fulfils. Wraps the `cac:OrderLineReference` element and its `cbc:LineID`.
+ *
+ * @example
+ *   ```ts
+ *   { lineId: '123' }
+ *   ```;
+ *
+ * @see {@link PeppolBaseLine}
+ */
 declare class PeppolOrderLineReference extends PeppolOrderLineReference_base {}
 declare const PeppolBaseLine_base: OpaqueSchema<PeppolBaseLine, Schema.Struct<{
   /**
@@ -1990,7 +2961,7 @@ declare const PeppolBaseLine_base: OpaqueSchema<PeppolBaseLine, Schema.Struct<{
    *
    * @cardinality 0..n
    */
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolLineAllowance, typeof PeppolLineCharge]>>>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolLineAllowanceCharge>>;
   /**
    * @summary Line object identifier
    *
@@ -2090,7 +3061,7 @@ declare class PeppolBaseLine extends PeppolBaseLine_base {}
 //#region src/schemas/fields/peppol-invoice-line-schema.d.ts
 declare const PeppolInvoiceLine_base: OpaqueSchema<PeppolInvoiceLine, Schema.Struct<{
   readonly accountingCost: Schema.optional<Schema.String>;
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolLineAllowance, typeof PeppolLineCharge]>>>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolLineAllowanceCharge>>;
   readonly documentReference: Schema.optional<Schema.$Array<Schema.Struct<{
     readonly id: Schema.String;
     readonly schemeId: Schema.optional<Schema.String>;
@@ -2115,21 +3086,38 @@ declare const PeppolInvoiceLine_base: OpaqueSchema<PeppolInvoiceLine, Schema.Str
    */
   readonly invoicedQuantity: Schema.Struct<{
     readonly value: Schema.Finite;
-    readonly unitCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolQuantityUnitCode">;
+    readonly unitCode: typeof PeppolQuantityUnitCode;
   }>;
 }>>;
 /**
+ * @description A line of the Invoice, extending the common line fields with the invoiced quantity. Wraps the `cac:InvoiceLine` element.
+ *
  * @summary Invoice line
  *
  * @name cac:InvoiceLine
  */
 declare class PeppolInvoiceLine extends PeppolInvoiceLine_base {}
+/**
+ * @description Encoded form of {@link PeppolInvoiceLine} produced by the Effect Schema codec. Fields mirror the decoded structure.
+ *
+ * @see {@link PeppolInvoiceLine}
+ */
 interface PeppolInvoiceLineEncoded extends Schema.Codec.Encoded<typeof PeppolInvoiceLine> {}
 //#endregion
 //#region src/schemas/peppol-invoice-schema.d.ts
 declare const PeppolProjectReference_base: OpaqueSchema<PeppolProjectReference, Schema.Struct<{
   readonly id: Schema.String;
 }>>;
+/**
+ * @description Wraps the `cac:ProjectReference` element on an invoice: an identifier of the project the invoice relates to.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'project-123' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoice}
+ */
 declare class PeppolProjectReference extends PeppolProjectReference_base {}
 declare const PeppolInvoice_base: OpaqueSchema<PeppolInvoice, Schema.Struct<{
   readonly customizationId: Schema.withDecodingDefaultType<Schema.String, never>;
@@ -2138,8 +3126,8 @@ declare const PeppolInvoice_base: OpaqueSchema<PeppolInvoice, Schema.Struct<{
   readonly issueDate: typeof PeppolIsoDateString;
   readonly note: Schema.optional<Schema.String>;
   readonly taxPointDate: Schema.optional<typeof PeppolIsoDateString>;
-  readonly documentCurrencyCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">;
-  readonly taxCurrencyCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">>;
+  readonly documentCurrencyCode: typeof PeppolCurrencyCode;
+  readonly taxCurrencyCode: Schema.optional<typeof PeppolCurrencyCode>;
   readonly accountingCost: Schema.optional<Schema.String>;
   readonly buyerReference: Schema.optional<Schema.String>;
   readonly invoicePeriod: Schema.optional<typeof PeppolInvoicePeriod>;
@@ -2157,8 +3145,8 @@ declare const PeppolInvoice_base: OpaqueSchema<PeppolInvoice, Schema.Struct<{
   readonly delivery: Schema.optional<typeof PeppolDelivery>;
   readonly paymentMeans: Schema.optional<Schema.$Array<typeof PeppolPaymentMeans>>;
   readonly paymentTerms: Schema.optional<typeof PeppolPaymentTerms>;
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolAllowance, typeof PeppolCharge]>>>;
-  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotalsBase>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolAllowanceCharge>>;
+  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotal>;
   readonly legalMonetaryTotal: typeof PeppolLegalMonetaryTotal;
   /**
    * @example
@@ -2183,7 +3171,7 @@ declare const PeppolInvoice_base: OpaqueSchema<PeppolInvoice, Schema.Struct<{
    *
    * @name cbc:InvoiceTypeCode
    */
-  readonly invoiceTypeCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolInvoiceTypeCode">;
+  readonly invoiceTypeCode: typeof PeppolInvoiceTypeCode;
   /**
    * @summary PROJECT REFERENCE
    *
@@ -2191,12 +3179,30 @@ declare const PeppolInvoice_base: OpaqueSchema<PeppolInvoice, Schema.Struct<{
    */
   readonly projectReference: Schema.optional<typeof PeppolProjectReference>;
 }>>;
+/**
+ * @description UBL `Invoice` for PEPPOL BIS Billing 3.0. Extends {@link PeppolBillingBase} with the due date, type code, lines and project reference.
+ *
+ * @example
+ *   ```ts
+ *   {
+ *     customizationId: 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0',
+ *     profileId: 'urn:fdc:peppol.eu:2017:poacc:billing:01:1.0',
+ *     id: '33445566',
+ *     issueDate: '2017-11-01',
+ *     documentCurrencyCode: 'EUR',
+ *     invoiceTypeCode: '380'
+ *   }
+ *   ```;
+ *
+ * @see {@link PeppolBillingBase}
+ * @see {@link PeppolCreditNote}
+ */
 declare class PeppolInvoice extends PeppolInvoice_base {}
 //#endregion
 //#region src/schemas/fields/peppol-credit-note-line-schema.d.ts
 declare const PeppolCreditNoteLine_base: OpaqueSchema<PeppolCreditNoteLine, Schema.Struct<{
   readonly accountingCost: Schema.optional<Schema.String>;
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolLineAllowance, typeof PeppolLineCharge]>>>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolLineAllowanceCharge>>;
   readonly documentReference: Schema.optional<Schema.$Array<Schema.Struct<{
     readonly id: Schema.String;
     readonly schemeId: Schema.optional<Schema.String>;
@@ -2211,13 +3217,18 @@ declare const PeppolCreditNoteLine_base: OpaqueSchema<PeppolCreditNoteLine, Sche
   readonly price: typeof PeppolLinePrice;
   readonly creditedQuantity: Schema.Struct<{
     readonly value: Schema.Finite;
-    readonly unitCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolQuantityUnitCode">;
+    readonly unitCode: typeof PeppolQuantityUnitCode;
   }>;
 }>>;
 /**
  * @description Credit note line is identical to Invoice line except the quantity element name.
  */
 declare class PeppolCreditNoteLine extends PeppolCreditNoteLine_base {}
+/**
+ * @description Encoded form of {@link PeppolCreditNoteLine} produced by the Effect Schema codec. Fields mirror the decoded structure.
+ *
+ * @see {@link PeppolCreditNoteLine}
+ */
 interface PeppolCreditNoteLineEncoded extends Schema.Codec.Encoded<typeof PeppolCreditNoteLine> {}
 //#endregion
 //#region src/schemas/peppol-credit-note-schema.d.ts
@@ -2228,8 +3239,8 @@ declare const PeppolCreditNote_base: OpaqueSchema<PeppolCreditNote, Schema.Struc
   readonly issueDate: typeof PeppolIsoDateString;
   readonly note: Schema.optional<Schema.String>;
   readonly taxPointDate: Schema.optional<typeof PeppolIsoDateString>;
-  readonly documentCurrencyCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">;
-  readonly taxCurrencyCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">>;
+  readonly documentCurrencyCode: typeof PeppolCurrencyCode;
+  readonly taxCurrencyCode: Schema.optional<typeof PeppolCurrencyCode>;
   readonly accountingCost: Schema.optional<Schema.String>;
   readonly buyerReference: Schema.optional<Schema.String>;
   readonly invoicePeriod: Schema.optional<typeof PeppolInvoicePeriod>;
@@ -2247,8 +3258,8 @@ declare const PeppolCreditNote_base: OpaqueSchema<PeppolCreditNote, Schema.Struc
   readonly delivery: Schema.optional<typeof PeppolDelivery>;
   readonly paymentMeans: Schema.optional<Schema.$Array<typeof PeppolPaymentMeans>>;
   readonly paymentTerms: Schema.optional<typeof PeppolPaymentTerms>;
-  readonly allowanceCharges: Schema.optional<Schema.$Array<Schema.Union<readonly [typeof PeppolAllowance, typeof PeppolCharge]>>>;
-  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotalsBase>;
+  readonly allowanceCharges: Schema.optional<Schema.$Array<typeof PeppolAllowanceCharge>>;
+  readonly taxTotals: Schema.$Array<typeof PeppolTaxTotal>;
   readonly legalMonetaryTotal: typeof PeppolLegalMonetaryTotal;
   /**
    * @description CREDIT NOTE LINE.
@@ -2264,7 +3275,7 @@ declare const PeppolCreditNote_base: OpaqueSchema<PeppolCreditNote, Schema.Struc
    *
    * @name cbc:CreditNoteTypeCode
    */
-  readonly creditNoteTypeCode: Schema.Literals<readonly ["81", "83", "381", "396", "532"]>;
+  readonly creditNoteTypeCode: typeof PeppolCreditNoteTypeCode;
 }>>;
 /**
  * @description Main UBL Credit Note schema (camelCase properties) Effect port of `creditNoteSchema` (`z.extend(billingBaseSchema, ...)` →
@@ -2286,6 +3297,16 @@ declare const PeppolMessageLevelResponseParty_base: OpaqueSchema<PeppolMessageLe
    */
   readonly endpointId: Schema.optional<typeof PeppolIdentifier>;
 }>>;
+/**
+ * @description Party used as `cac:SenderParty` or `cac:ReceiverParty` on a message level response, holding the party's electronic address.
+ *
+ * @example
+ *   ```ts
+ *   { endpointId: { id: '7300010000001', schemeId: '0088' } }
+ *   ```;
+ *
+ * @see {@link PeppolMessageLevelResponse}
+ */
 declare class PeppolMessageLevelResponseParty extends PeppolMessageLevelResponseParty_base {}
 //#endregion
 //#region src/schemas/peppol-document-response-document-reference-schema.d.ts
@@ -2308,7 +3329,7 @@ declare const PeppolDocumentResponseDocumentReference_base: OpaqueSchema<PeppolD
    *
    * @name `cbc:DocumentTypeCode`
    */
-  readonly documentTypeCode: Schema.optional<Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolDocumentTypeCode">>;
+  readonly documentTypeCode: Schema.optional<typeof PeppolDocumentTypeCode>;
   /**
    * @description The version of the document that has been identifier with the document identifier.
    *
@@ -2321,8 +3342,17 @@ declare const PeppolDocumentResponseDocumentReference_base: OpaqueSchema<PeppolD
    */
   readonly versionId: Schema.optional<Schema.String>;
 }>>;
+/**
+ * @description Wraps `cac:DocumentReference` inside a message level response: identifies the business document the response is based on.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'EnvelopeID-12345', versionId: '2' }
+ *   ```;
+ *
+ * @see {@link PeppolMessageLevelResponseDocumentResponse}
+ */
 declare class PeppolDocumentResponseDocumentReference extends PeppolDocumentResponseDocumentReference_base {}
-type PeppolMessageLevelDocumentResponseDocumentReference = PeppolDocumentResponseDocumentReference;
 //#endregion
 //#region src/schemas/peppol-document-response-document-schema.d.ts
 declare const PeppolDocumentResponseDocument_base: OpaqueSchema<PeppolDocumentResponseDocument, Schema.Struct<{
@@ -2337,7 +3367,7 @@ declare const PeppolDocumentResponseDocument_base: OpaqueSchema<PeppolDocumentRe
    *
    * @name `cbc:ResponseCode`
    */
-  readonly responseCode: Schema.Literals<readonly ["AB", "AP", "RE"]>;
+  readonly responseCode: typeof PeppolApplicationResponseTypeCode;
   /**
    * @description Used to meake any comments or instructions relevant to the response. The use of this element requires manual assessment by the receiver.
    *
@@ -2346,16 +3376,17 @@ declare const PeppolDocumentResponseDocument_base: OpaqueSchema<PeppolDocumentRe
   readonly description: Schema.optional<Schema.String>;
 }>>;
 /**
+ * @description Wraps `cac:Response` inside a message level response: the overall response code and an optional textual note.
+ *
  * @summary Response information
  *
  * @name `cac:Response`
  *
  * @cardinality (1..1)
  *
- * @see {@link messageLevelResponseDocumentResponseSchema}
+ * @see {@link PeppolMessageLevelResponseDocumentResponse}
  */
 declare class PeppolDocumentResponseDocument extends PeppolDocumentResponseDocument_base {}
-type PeppolMessageLevelResponseDocumentResponseDocument = PeppolDocumentResponseDocument;
 //#endregion
 //#region src/schemas/peppol-document-response-line-response-content-schema.d.ts
 declare const PeppolStatus_base: OpaqueSchema<PeppolStatus, Schema.Struct<{
@@ -2368,6 +3399,16 @@ declare const PeppolStatus_base: OpaqueSchema<PeppolStatus, Schema.Struct<{
    */
   readonly statusReasonCode: Schema.Literals<readonly ["BV", "BW", "SV"]>;
 }>>;
+/**
+ * @description Wraps `cac:Status` inside a line response: the coded reason for an issue found in the document.
+ *
+ * @example
+ *   ```ts
+ *   { statusReasonCode: 'SV' }
+ *   ```;
+ *
+ * @see {@link PeppolDocumentResponseLineResponseContent}
+ */
 declare class PeppolStatus extends PeppolStatus_base {}
 declare const PeppolDocumentResponseLineResponseContent_base: OpaqueSchema<PeppolDocumentResponseLineResponseContent, Schema.Struct<{
   /**
@@ -2381,7 +3422,7 @@ declare const PeppolDocumentResponseLineResponseContent_base: OpaqueSchema<Peppo
    *
    * @name `cbc:ResponseCode`
    */
-  readonly responseCode: Schema.Literals<readonly ["AB", "AP", "RE"]>;
+  readonly responseCode: typeof PeppolApplicationResponseTypeCode;
   /**
    * @description The description of the issued identifier in the transaction document.
    *
@@ -2398,6 +3439,16 @@ declare const PeppolDocumentResponseLineResponseContent_base: OpaqueSchema<Peppo
    */
   readonly status: typeof PeppolStatus;
 }>>;
+/**
+ * @description A response to a particular line in the business document: the line response code, a description of the issue and its coded status.
+ *
+ * @example
+ *   ```ts
+ *   { responseCode: 'RE', description: 'Validation gives error [CL-T77-R0002]', status: { statusReasonCode: 'SV' } }
+ *   ```;
+ *
+ * @see {@link PeppolDocumentResponseLineResponse}
+ */
 declare class PeppolDocumentResponseLineResponseContent extends PeppolDocumentResponseLineResponseContent_base {}
 //#endregion
 //#region src/schemas/peppol-document-response-line-response-schema.d.ts
@@ -2415,6 +3466,16 @@ declare const PeppolLineReference_base: OpaqueSchema<PeppolLineReference, Schema
    */
   readonly lineId: Schema.String;
 }>>;
+/**
+ * @description Wraps `cac:LineReference` inside a line response: an XPath pointing at the element that caused the reported issue.
+ *
+ * @example
+ *   ```ts
+ *   { lineId: '/Invoice/cac:InvoiceLine[1]' }
+ *   ```;
+ *
+ * @see {@link PeppolDocumentResponseLineResponse}
+ */
 declare class PeppolLineReference extends PeppolLineReference_base {}
 declare const PeppolDocumentResponseLineResponse_base: OpaqueSchema<PeppolDocumentResponseLineResponse, Schema.Struct<{
   /**
@@ -2430,8 +3491,20 @@ declare const PeppolDocumentResponseLineResponse_base: OpaqueSchema<PeppolDocume
    */
   readonly response: typeof PeppolDocumentResponseLineResponseContent;
 }>>;
+/**
+ * @description Wraps `cac:LineResponse` inside a message level response: pairs a line reference with the response for that line.
+ *
+ * @example
+ *   ```ts
+ *   {
+ *     lineReference: { lineId: '/Invoice/cac:InvoiceLine[1]' },
+ *     response: { responseCode: 'RE', description: 'Invalid tax category', status: { statusReasonCode: 'SV' } }
+ *   }
+ *   ```;
+ *
+ * @see {@link PeppolMessageLevelResponseDocumentResponse}
+ */
 declare class PeppolDocumentResponseLineResponse extends PeppolDocumentResponseLineResponse_base {}
-type PeppolMessageLevelDocumentResponseLineResponse = PeppolDocumentResponseLineResponse;
 //#endregion
 //#region src/schemas/peppol-message-level-response-document-response-schema.d.ts
 declare const PeppolMessageLevelResponseDocumentResponse_base: OpaqueSchema<PeppolMessageLevelResponseDocumentResponse, Schema.Struct<{
@@ -2460,6 +3533,16 @@ declare const PeppolMessageLevelResponseDocumentResponse_base: OpaqueSchema<Pepp
    */
   readonly lineResponse: Schema.$Array<typeof PeppolDocumentResponseLineResponse>;
 }>>;
+/**
+ * @description Wraps `cac:DocumentResponse` inside a message level response: the response, the document reference and any per-line responses.
+ *
+ * @example
+ *   ```ts
+ *   { response: { responseCode: 'RE' }, documentReference: { id: 'EnvelopeID-12345' }, lineResponse: [] }
+ *   ```;
+ *
+ * @see {@link PeppolMessageLevelResponse}
+ */
 declare class PeppolMessageLevelResponseDocumentResponse extends PeppolMessageLevelResponseDocumentResponse_base {}
 //#endregion
 //#region src/schemas/utils/peppol-xsd-time-schema.d.ts
@@ -2467,6 +3550,11 @@ declare const PeppolXsdTime_base: OpaqueSchema<PeppolXsdTime, Schema.decodeTo<Sc
 /**
  * @description XSD `time` lexical value (`HH:MM:SS` with optional fractional seconds and timezone). Effect port of `xsdTime` (`z.string().check(z.regex(...))`):
  * keeps the value as a plain string and only validates the shape.
+ *
+ * @example
+ *   ```ts
+ *   const value = '12:30:45+01:00';
+ *   ```;
  */
 declare class PeppolXsdTime extends PeppolXsdTime_base {}
 //#endregion
@@ -2558,11 +3646,29 @@ declare const PeppolMessageLevelResponse_base: OpaqueSchema<PeppolMessageLevelRe
    */
   readonly documentResponse: typeof PeppolMessageLevelResponseDocumentResponse;
 }>>;
+/**
+ * @description UBL `ApplicationResponse` message level response for PEPPOL BIS Billing 3.0 (profile `urn:fdc:peppol.eu:poacc:bis:mlr:3`).
+ *
+ * @example
+ *   ```ts
+ *   {
+ *     customizationId: 'urn:fdc:peppol.eu:poacc:trns:mlr:3',
+ *     profileId: 'urn:fdc:peppol.eu:poacc:bis:mlr:3',
+ *     id: '23',
+ *     issueDate: '2017-11-01',
+ *     senderParty: {},
+ *     receiverParty: {},
+ *     documentResponse: { response: { responseCode: 'RE' }, documentReference: { id: 'EnvelopeID-12345' }, lineResponse: [] }
+ *   }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponse}
+ */
 declare class PeppolMessageLevelResponse extends PeppolMessageLevelResponse_base {}
 //#endregion
 //#region src/schemas/peppol-invoice-response-status-reason-code-schema.d.ts
 declare const PeppolInvoiceResponseStatusReasonCodeReason_base: OpaqueSchema<PeppolInvoiceResponseStatusReasonCodeReason, Schema.Struct<{
-  readonly value: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolOpStatusReason">;
+  readonly value: typeof PeppolOpStatusReason;
   /**
    * @description List identifier for clarification.
    *
@@ -2572,9 +3678,19 @@ declare const PeppolInvoiceResponseStatusReasonCodeReason_base: OpaqueSchema<Pep
    */
   readonly listId: Schema.Literal<"OPStatusReason">;
 }>>;
+/**
+ * @description Status clarification reason (`cbc:StatusReasonCode` with `@listId="OPStatusReason"`), a value from the OPStatusReason code list.
+ *
+ * @example
+ *   ```ts
+ *   { value: 'REF', listId: 'OPStatusReason' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseStatusReasonCode}
+ */
 declare class PeppolInvoiceResponseStatusReasonCodeReason extends PeppolInvoiceResponseStatusReasonCodeReason_base {}
 declare const PeppolInvoiceResponseStatusReasonCodeAction_base: OpaqueSchema<PeppolInvoiceResponseStatusReasonCodeAction, Schema.Struct<{
-  readonly value: Schema.brand<Schema.Literals<readonly ["NOA", "PIN", "NIN", "CNF", "CNP", "CNA", "OTH"]>, "PeppolOpStatusAction">;
+  readonly value: typeof PeppolOpStatusAction;
   /**
    * @description List identifier for clarification.
    *
@@ -2584,9 +3700,29 @@ declare const PeppolInvoiceResponseStatusReasonCodeAction_base: OpaqueSchema<Pep
    */
   readonly listId: Schema.Literal<"OPStatusAction">;
 }>>;
+/**
+ * @description Status clarification action (`cbc:StatusReasonCode` with `@listId="OPStatusAction"`), a value from the OPStatusAction code list.
+ *
+ * @example
+ *   ```ts
+ *   { value: 'PIN', listId: 'OPStatusAction' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseStatusReasonCode}
+ */
 declare class PeppolInvoiceResponseStatusReasonCodeAction extends PeppolInvoiceResponseStatusReasonCodeAction_base {}
-declare const peppolInvoiceResponseStatusReasonCodeSchema: Schema.Union<readonly [typeof PeppolInvoiceResponseStatusReasonCodeAction, typeof PeppolInvoiceResponseStatusReasonCodeReason]>;
-type PeppolInvoiceResponseStatusReasonCode = typeof peppolInvoiceResponseStatusReasonCodeSchema.Type;
+declare const PeppolInvoiceResponseStatusReasonCode_base: Schema.Union<readonly [typeof PeppolInvoiceResponseStatusReasonCodeAction, typeof PeppolInvoiceResponseStatusReasonCodeReason]>;
+/**
+ * @description Union of the accepted status clarification reasons and actions on an invoice response.
+ *
+ * @example
+ *   ```ts
+ *   { value: 'REF', listId: 'OPStatusReason' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponseStatus}
+ */
+declare class PeppolInvoiceResponseStatusReasonCode extends PeppolInvoiceResponseStatusReasonCode_base {}
 //#endregion
 //#region src/schemas/peppol-invoice-response-document-actual-response-status-schema.d.ts
 declare const PeppolInvoiceResponseCondition_base: OpaqueSchema<PeppolInvoiceResponseCondition, Schema.Struct<{
@@ -2613,6 +3749,16 @@ declare const PeppolInvoiceResponseCondition_base: OpaqueSchema<PeppolInvoiceRes
    */
   readonly description: Schema.optional<Schema.String>;
 }>>;
+/**
+ * @description Wraps `cac:Condition` inside a status: a detail code and its optional value that further explains the clarification.
+ *
+ * @example
+ *   ```ts
+ *   { attributeId: 'BT-75', description: 'EU123456789' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponseStatus}
+ */
 declare class PeppolInvoiceResponseCondition extends PeppolInvoiceResponseCondition_base {}
 declare const PeppolInvoiceResponseDocumentActualResponseStatus_base: OpaqueSchema<PeppolInvoiceResponseDocumentActualResponseStatus, Schema.Struct<{
   /**
@@ -2622,7 +3768,7 @@ declare const PeppolInvoiceResponseDocumentActualResponseStatus_base: OpaqueSche
    *
    * @name `cbc:StatusReasonCode`
    */
-  readonly statusReasonCode: Schema.optional<Schema.Union<readonly [typeof PeppolInvoiceResponseStatusReasonCodeAction, typeof PeppolInvoiceResponseStatusReasonCodeReason]>>;
+  readonly statusReasonCode: Schema.optional<typeof PeppolInvoiceResponseStatusReasonCode>;
   /**
    * @description The description of the clarification given for the invoice status.
    *
@@ -2641,11 +3787,40 @@ declare const PeppolInvoiceResponseDocumentActualResponseStatus_base: OpaqueSche
    */
   readonly condition: Schema.optional<Schema.$Array<typeof PeppolInvoiceResponseCondition>>;
 }>>;
+/**
+ * @description Wraps `cac:Status` inside an invoice response: an optional clarification code and description plus any condition details.
+ *
+ * @example
+ *   ```ts
+ *   { statusReasonCode: { value: 'REF', listId: 'OPStatusReason' }, statusReason: 'TAX reference not found' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponse}
+ */
 declare class PeppolInvoiceResponseDocumentActualResponseStatus extends PeppolInvoiceResponseDocumentActualResponseStatus_base {}
-type InvoiceResponseDocumentActualResponseStatus = PeppolInvoiceResponseDocumentActualResponseStatus;
 //#endregion
 //#region src/schemas/peppol-invoice-response-document-actual-response-schema.d.ts
+/**
+ * @description Response codes that require a clarification in `cac:Status`: `UQ`, `RE` and `CA`.
+ *
+ * @example
+ *   ```ts
+ *   withStatusCodes; // Schema.Literals(['UQ', 'RE', 'CA'])
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponseWithStatus}
+ */
 declare const withStatusCodes: Schema.Literals<readonly ["UQ", "RE", "CA"]>;
+/**
+ * @description Response codes that do not require a clarification in `cac:Status`: `AB`, `AP`, `IP` and `PD`.
+ *
+ * @example
+ *   ```ts
+ *   withoutStatusCodes; // Schema.Literals(['AB', 'AP', 'IP', 'PD'])
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponseWithoutStatus}
+ */
 declare const withoutStatusCodes: Schema.Literals<readonly ["AB", "AP", "IP", "PD"]>;
 declare const PeppolInvoiceResponseDocumentActualResponseWithoutStatus_base: OpaqueSchema<PeppolInvoiceResponseDocumentActualResponseWithoutStatus, Schema.Struct<{
   /**
@@ -2675,6 +3850,16 @@ declare const PeppolInvoiceResponseDocumentActualResponseWithoutStatus_base: Opa
    */
   readonly status: Schema.optional<Schema.$Array<typeof PeppolInvoiceResponseDocumentActualResponseStatus>>;
 }>>;
+/**
+ * @description Invoice response for statuses that do not require a clarification; the `cac:Status` group is optional.
+ *
+ * @example
+ *   ```ts
+ *   { responseCode: 'AP', effectiveDate: '2018-08-02' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponse}
+ */
 declare class PeppolInvoiceResponseDocumentActualResponseWithoutStatus extends PeppolInvoiceResponseDocumentActualResponseWithoutStatus_base {}
 declare const PeppolInvoiceResponseDocumentActualResponseWithStatus_base: OpaqueSchema<PeppolInvoiceResponseDocumentActualResponseWithStatus, Schema.Struct<{
   /**
@@ -2707,115 +3892,153 @@ declare const PeppolInvoiceResponseDocumentActualResponseWithStatus_base: Opaque
    */
   readonly status: Schema.$Array<typeof PeppolInvoiceResponseDocumentActualResponseStatus>;
 }>>;
+/**
+ * @description Invoice response for statuses that require a clarification; at least one `cac:Status` group is mandatory.
+ *
+ * @example
+ *   ```ts
+ *   { responseCode: 'RE', status: [{ statusReason: 'TAX reference not found' }] }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentActualResponse}
+ */
 declare class PeppolInvoiceResponseDocumentActualResponseWithStatus extends PeppolInvoiceResponseDocumentActualResponseWithStatus_base {}
-declare const peppolInvoiceResponseDocumentActualResponseSchema: Schema.Union<readonly [typeof PeppolInvoiceResponseDocumentActualResponseWithStatus, typeof PeppolInvoiceResponseDocumentActualResponseWithoutStatus]>;
-type InvoiceResponseDocumentActualResponse = typeof peppolInvoiceResponseDocumentActualResponseSchema.Type;
-//#endregion
-//#region src/schemas/utils/peppol-base-64-schema.d.ts
+declare const PeppolInvoiceResponseDocumentActualResponse_base: Schema.Union<readonly [typeof PeppolInvoiceResponseDocumentActualResponseWithStatus, typeof PeppolInvoiceResponseDocumentActualResponseWithoutStatus]>;
 /**
- * @description RFC 4648 base64 string (PEM / MIME / XML line endings tolerated). Effect port of `base64Schema` (`z.string().check(z.refine(...))`): strips CRLF /
- * LF line endings before testing the quantum regex.
+ * @description Union of the invoice response variants selected by `cbc:ResponseCode`: one that requires a clarification and one that does not.
+ *
+ * @example
+ *   ```ts
+ *   { responseCode: 'AP', effectiveDate: '2018-08-02' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentResponse}
  */
-declare const peppolBase64Schema: Schema.String;
-type Base64 = typeof peppolBase64Schema.Type;
+declare class PeppolInvoiceResponseDocumentActualResponse extends PeppolInvoiceResponseDocumentActualResponse_base {}
 //#endregion
 //#region src/schemas/utils/format-quantity-with-unit.d.ts
-declare function formatQuantityWithUnit(value: number, code: string, locale?: string, unitDisplay?: 'short' | 'narrow' | 'long'): string;
-//#endregion
-//#region src/schemas/values/credit-note-type-code-schema.d.ts
 /**
- * @description A credit note type code as defined by the PEPPOL subset of UNCL 1001 (credit note).
+ * @description Formats a quantity and its unit code for a locale. Uses `Intl.NumberFormat` for mapped codes, otherwise the code list name.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-cn/
- */
-type PeppolCreditNoteTypeCode = CreditNoteTypeCodesKeys;
-/**
- * @description Validates a credit note type code against the PEPPOL subset of UNCL 1001 (credit note).
+ * @example
+ *   ```ts
+ *   formatQuantityWithUnit(5, 'KGM', 'en-US', 'long'); // '5 kilograms'
+ *   formatQuantityWithUnit(10, 'EA'); // '10 each'
+ *   ```;
  *
- * @param error - The custom error message to use when validation fails.
+ * @param value - The numeric quantity to format.
+ * @param code - The UN/ECE Rec 20 unit code to render, for example `KGM` or `MTR`.
+ * @param locale - BCP 47 locale tag passed to `Intl.NumberFormat`. Defaults to `'en-US'`.
+ * @param unitDisplay - `Intl` unit display style: `'short'`, `'narrow'`, or `'long'`. Defaults to `'short'`.
  *
- * @returns An Effect schema that accepts only valid credit note type codes.
+ * @returns The formatted quantity and unit, for example `'5 kilograms'`. Falls back to `<number> <name>` when the code has no `Intl` unit or `Intl`
+ *   rejects the unit.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-cn/
+ * @see {@link quantityUnitCodeToIntlUnit}
  */
-declare const creditNoteTypeCodeSchema: Schema.Literals<readonly ["81", "83", "381", "396", "532"]>;
+declare function formatQuantityWithUnit(value: number, code: string, locale?: string, unitDisplay?: 'short' | 'narrow' | 'long'): string;
 //#endregion
 //#region src/schemas/utils/get-credit-note-type-code-description.d.ts
-declare function getCreditNoteTypeCodeDescription(code: PeppolCreditNoteTypeCode): string;
-//#endregion
-//#region src/schemas/values/invoice-type-code-schema.d.ts
 /**
- * @description An invoice type code as defined by the PEPPOL subset of UNCL 1001 (invoice).
+ * @description Returns the human-readable description of a PEPPOL credit note type code (UNCL1001 subset).
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/
+ * @example
+ *   ```ts
+ *   getCreditNoteTypeCodeDescription('381'); // 'Credit note'
+ *   ```;
+ *
+ * @param code - A valid {@link PeppolCreditNoteTypeCode}, for example `'381'`.
+ *
+ * @returns The description registered for the code, for example `'Credit note'`.
  */
-type PeppolInvoiceTypeCode = typeof invoiceTypeCodeSchema.Type;
+declare function getCreditNoteTypeCodeDescription(code: PeppolCreditNoteTypeCode): string;
+//#endregion
+//#region src/schemas/utils/get-invoice-type-code-description.d.ts
 /**
- * @description Validates an invoice type code against the PEPPOL subset of UNCL 1001 (invoice).
+ * @description Returns the human-readable description of a PEPPOL invoice type code (UNCL1001 subset).
  *
- * @param error - The custom error message to use when validation fails.
+ * @example
+ *   ```ts
+ *   getInvoiceTypeCodeDescription('380'); // 'Commercial invoice'
+ *   ```;
  *
- * @returns An Effect schema that accepts only valid invoice type codes.
+ * @param code - A valid {@link PeppolInvoiceTypeCode}, for example `'380'`.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/
+ * @returns The description registered for the code, for example `'Commercial invoice'`.
  */
-declare const invoiceTypeCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolInvoiceTypeCode">;
-//#endregion
-//#region src/schemas/utils/get-invoice-type-code-description.d.ts
 declare function getInvoiceTypeCodeDescription(code: PeppolInvoiceTypeCode): string;
 //#endregion
 //#region src/schemas/utils/is-valid-credit-note-type-code.d.ts
-declare function isValidCreditNoteTypeCode(code: string): code is PeppolCreditNoteTypeCode;
-//#endregion
-//#region src/schemas/utils/is-valid-invoice-type-code.d.ts
-declare function isValidInvoiceTypeCode(code: string): code is PeppolInvoiceTypeCode;
-//#endregion
-//#region src/schemas/values/peppol-process-schema.d.ts
 /**
- * @description A PEPPOL business process identifier key as defined by the processes codelist.
+ * @description Type guard for PEPPOL credit note type codes (UNCL1001 subset).
  *
- * @see {@link processes}
+ * @example
+ *   ```ts
+ *   isValidCreditNoteTypeCode('381'); // true
+ *   isValidCreditNoteTypeCode('UNKNOWN'); // false
+ *   ```;
+ *
+ * @param code - The string to test.
+ *
+ * @returns `true` when `code` is a known credit note type code, narrowing it to {@link PeppolCreditNoteTypeCode}; otherwise `false`.
  */
-type PeppolProcesses = typeof peppolProcessSchema.Encoded;
+declare function isValidCreditNoteTypeCode(code: string): code is PeppolCreditNoteTypeCode;
+//#endregion
+//#region src/schemas/utils/is-valid-invoice-type-code.d.ts
 /**
- * @description Validates a full PEPPOL business process identifier (`<scheme>::<value>`) against the known processes.
+ * @description Type guard for PEPPOL invoice type codes (UNCL1001 subset).
  *
- * @param error - The custom error message to use when validation fails. Defaults to `'invalid peppol process identifier'`.
+ * @example
+ *   ```ts
+ *   isValidInvoiceTypeCode('380'); // true
+ *   isValidInvoiceTypeCode('UNKNOWN'); // false
+ *   ```;
  *
- * @returns An Effect schema that matches a valid `scheme::value` process identifier.
+ * @param code - The string to test.
  *
- * @see {@link processes}
+ * @returns `true` when `code` is a known invoice type code, narrowing it to {@link PeppolInvoiceTypeCode}; otherwise `false`.
  */
-declare const peppolProcessSchema: Schema.TemplateLiteral<readonly [Schema.Literals<readonly ["cenbii-procid-ubl", "oioubl-procid-ubl"]>, Schema.Literal<"::">, Schema.String]>;
+declare function isValidInvoiceTypeCode(code: string): code is PeppolInvoiceTypeCode;
 //#endregion
 //#region src/schemas/utils/is-valid-process.d.ts
-declare function isValidProcess(code: string): code is PeppolProcesses;
-//#endregion
-//#region src/schemas/values/quantity-unit-codes-schema.d.ts
-/**
- * @description A unit of measure code as defined by the PEPPOL subset of UN/ECE Recommendation 20.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNECERec20/
- */
-type PeppolQuantityUnitCode = typeof quantityUnitCodesSchema.Type;
 /**
- * @description Validates a unit of measure code against the PEPPOL subset of UN/ECE Recommendation 20.
- *
- * @param error - The custom error message to use when validation fails.
+ * @description Type guard for PEPPOL business process identifiers of the form `<scheme>::<value>`.
  *
- * @returns An Effect schema that accepts only valid quantity unit codes.
+ * @example
+ *   ```ts
+ *   isValidProcess('cenbii-procid-ubl::urn:fdc:peppol.eu:2017:poacc:billing:01:1.0'); // true
+ *   isValidProcess('cenbii-procid-ubl::urn:not:a:process'); // false
+ *   ```;
  *
- * @validations
- * - BR-CL-23: Unit of measure code MUST be a valid UN/ECE Rec 20 code.
+ * @param code - The process identifier to test.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNECERec20/
+ * @returns `true` when `code` appears in {@link processesList}, narrowing it to {@link PeppolProcesses}; otherwise `false`.
  */
-declare const quantityUnitCodesSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolQuantityUnitCode">;
+declare function isValidProcess(code: string): code is PeppolProcesses;
 //#endregion
 //#region src/schemas/utils/quantity-unit-code-to-intl-unit.d.ts
+/**
+ * @description String union of `Intl.NumberFormat` unit identifiers for base units such as length, area, volume, mass, and temperature.
+ */
 type BaseIntlUnit = 'acre' | 'bit' | 'byte' | 'celsius' | 'centimeter' | 'degree' | 'fahrenheit' | 'fluid-ounce' | 'foot' | 'gallon' | 'gigabit' | 'gigabyte' | 'gram' | 'hectare' | 'inch' | 'kilobit' | 'kilobyte' | 'kilogram' | 'kilometer' | 'liter' | 'megabit' | 'megabyte' | 'meter' | 'mile' | 'mile-scandinavian' | 'milliliter' | 'millimeter' | 'ounce' | 'percent' | 'petabyte' | 'pound' | 'stone' | 'terabit' | 'terabyte' | 'yard';
+/**
+ * @description String union of `Intl.NumberFormat` unit identifiers for time units, used on their own and as the denominator of a rate.
+ */
 type TimeIntlUnit = 'nanosecond' | 'microsecond' | 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+/**
+ * @description Any `Intl.NumberFormat` unit identifier supported by this module: a {@link BaseIntlUnit}, a {@link TimeIntlUnit}, or a rate such as
+ * `'kilometer-per-hour'`.
+ */
 type IntlUnit = BaseIntlUnit | TimeIntlUnit | `${BaseIntlUnit}-per-${TimeIntlUnit}`;
+/**
+ * @description Maps UN/ECE Rec 20 quantity unit codes to `Intl.NumberFormat` unit identifiers. Unmapped codes are omitted.
+ *
+ * @example
+ *   ```ts
+ *   quantityToIntlUnitMap.KGM; // 'kilogram'
+ *   quantityToIntlUnitMap.KMH; // 'kilometer-per-hour'
+ *   ```;
+ */
 declare const quantityToIntlUnitMap: {
   CMT: "centimeter";
   MTR: "meter";
@@ -2881,14 +4104,35 @@ declare const quantityToIntlUnitMap: {
   '4U': "pound-per-hour";
   '4M': IntlUnit;
 };
+/**
+ * @description Looks up the `Intl.NumberFormat` unit identifier for a UN/ECE Rec 20 quantity unit code.
+ *
+ * @example
+ *   ```ts
+ *   quantityUnitCodeToIntlUnit('KGM'); // 'kilogram'
+ *   quantityUnitCodeToIntlUnit('EA'); // undefined
+ *   ```;
+ *
+ * @param code - A quantity unit code, typed as {@link PeppolQuantityUnitCode} but accepting any string.
+ *
+ * @returns The matching {@link IntlUnit}, or `undefined` when the code has no `Intl` unit mapping.
+ *
+ * @see {@link quantityToIntlUnitMap}
+ */
 declare function quantityUnitCodeToIntlUnit(code: PeppolQuantityUnitCode | (string & {})): IntlUnit | undefined;
 //#endregion
 //#region src/schemas/utils/peppol-vat-regex-schema.d.ts
+declare const PeppolVatRegex_base: OpaqueSchema<PeppolVatRegex, Schema.Union<readonly [Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String]>>;
 /**
  * @description EU VAT identification number (one member per member-state prefix/pattern). Effect port of `vatRegexSchema` (`z.union([...])` of
  * `z.string().check(...)` members): each member keeps its original prefix + pattern checks as `Schema.String.check` filters.
+ *
+ * @example
+ *   ```ts
+ *   const value = 'DE123456789';
+ *   ```;
  */
-declare const peppolVatRegexSchema: Schema.Union<readonly [Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String, Schema.String]>;
+declare class PeppolVatRegex extends PeppolVatRegex_base {}
 //#endregion
 //#region src/schemas/peppol-invoice-response-schema.d.ts
 declare const PeppolInvoiceResponseDocumentResponsePartyName_base: OpaqueSchema<PeppolInvoiceResponseDocumentResponsePartyName, Schema.Struct<{
@@ -2902,6 +4146,16 @@ declare const PeppolInvoiceResponseDocumentResponsePartyName_base: OpaqueSchema<
    */
   readonly name: Schema.String;
 }>>;
+/**
+ * @description Wraps `cac:PartyName` for the seller or buyer on an invoice response: the party's legal or trading name.
+ *
+ * @example
+ *   ```ts
+ *   { name: 'Seller Business Name AS' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentResponseParty}
+ */
 declare class PeppolInvoiceResponseDocumentResponsePartyName extends PeppolInvoiceResponseDocumentResponsePartyName_base {}
 declare const PeppolInvoiceResponseParty_base: OpaqueSchema<PeppolInvoiceResponseParty, Schema.Struct<{
   readonly endpointId: Schema.optional<typeof PeppolIdentifier>;
@@ -2910,7 +4164,17 @@ declare const PeppolInvoiceResponseParty_base: OpaqueSchema<PeppolInvoiceRespons
     readonly registrationName: Schema.String;
   }>;
 }>>;
-declare class PeppolInvoiceResponseParty extends PeppolInvoiceResponseParty_base {}
+/**
+ * @description Party used for the sender and receiver of an invoice response. Extends {@link PeppolMessageLevelResponseParty}.
+ *
+ * @example
+ *   ```ts
+ *   { partyLegalEntity: { registrationName: 'Seller Business Name AS' } }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponse}
+ */
+declare class PeppolInvoiceResponseParty extends PeppolInvoiceResponseParty_base {}
 declare const PeppolInvoiceResponseSenderParty_base: OpaqueSchema<PeppolInvoiceResponseSenderParty, Schema.Struct<{
   readonly endpointId: Schema.optional<typeof PeppolIdentifier>;
   readonly partyIdentification: Schema.optional<typeof PeppolIdentifier>;
@@ -2919,6 +4183,16 @@ declare const PeppolInvoiceResponseSenderParty_base: OpaqueSchema<PeppolInvoiceR
   }>;
   readonly contact: Schema.optional<typeof PeppolContact>;
 }>>;
+/**
+ * @description Sender party of an invoice response. Extends {@link PeppolInvoiceResponseParty} with optional `cac:Contact` details.
+ *
+ * @example
+ *   ```ts
+ *   { partyLegalEntity: { registrationName: 'Seller Business Name AS' } }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponse}
+ */
 declare class PeppolInvoiceResponseSenderParty extends PeppolInvoiceResponseSenderParty_base {}
 declare const PeppolInvoiceResponseDocumentResponseParty_base: OpaqueSchema<PeppolInvoiceResponseDocumentResponseParty, Schema.Struct<{
   /**
@@ -2937,7 +4211,6 @@ declare const PeppolInvoiceResponseDocumentResponseParty_base: OpaqueSchema<Pepp
  * @description Party schema used under `cac:DocumentReference/(cac:IssuerParty|cac:RecipientParty)`
  */
 declare class PeppolInvoiceResponseDocumentResponseParty extends PeppolInvoiceResponseDocumentResponseParty_base {}
-type PeppolInvoiceDocumentResponseParty = PeppolInvoiceResponseDocumentResponseParty;
 declare const PeppolInvoiceResponseDocumentReference_base: OpaqueSchema<PeppolInvoiceResponseDocumentReference, Schema.Struct<{
   /**
    * @description An identifier for the invoice that the status applies to. The invoice identifier must be of the main invoice number that appears in the invoice
@@ -2968,8 +4241,18 @@ declare const PeppolInvoiceResponseDocumentReference_base: OpaqueSchema<PeppolIn
    *
    * @summary Identifier type code
    */
-  readonly documentTypeCode: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolDocumentTypeCode">;
+  readonly documentTypeCode: typeof PeppolDocumentTypeCode;
 }>>;
+/**
+ * @description Wraps `cac:DocumentReference` inside an invoice response: identifies the invoice the status applies to.
+ *
+ * @example
+ *   ```ts
+ *   { id: 'inv-99876', issueDate: '2018-08-01', documentTypeCode: '380' }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponseDocumentResponse}
+ */
 declare class PeppolInvoiceResponseDocumentReference extends PeppolInvoiceResponseDocumentReference_base {}
 declare const PeppolInvoiceResponseDocumentResponse_base: OpaqueSchema<PeppolInvoiceResponseDocumentResponse, Schema.Struct<{
   /**
@@ -2979,7 +4262,7 @@ declare const PeppolInvoiceResponseDocumentResponse_base: OpaqueSchema<PeppolInv
    *
    * @cardinality (1..1)
    */
-  readonly response: Schema.Union<readonly [typeof PeppolInvoiceResponseDocumentActualResponseWithStatus, typeof PeppolInvoiceResponseDocumentActualResponseWithoutStatus]>;
+  readonly response: typeof PeppolInvoiceResponseDocumentActualResponse;
   /**
    * @summary Document reference
    *
@@ -2999,6 +4282,16 @@ declare const PeppolInvoiceResponseDocumentResponse_base: OpaqueSchema<PeppolInv
    */
   readonly recipientParty: Schema.optional<typeof PeppolInvoiceResponseDocumentResponseParty>;
 }>>;
+/**
+ * @description Wraps `cac:DocumentResponse` inside an invoice response: the response, the referenced invoice and optional parties.
+ *
+ * @example
+ *   ```ts
+ *   { response: { responseCode: 'AP', effectiveDate: '2018-08-02' }, documentReference: { id: 'inv-99876', documentTypeCode: '380' } }
+ *   ```;
+ *
+ * @see {@link PeppolInvoiceResponse}
+ */
 declare class PeppolInvoiceResponseDocumentResponse extends PeppolInvoiceResponseDocumentResponse_base {}
 declare const PeppolInvoiceResponse_base: OpaqueSchema<PeppolInvoiceResponse, Schema.Struct<{
   readonly customizationId: Schema.String;
@@ -3041,455 +4334,140 @@ declare const PeppolInvoiceResponse_base: OpaqueSchema<PeppolInvoiceResponse, Sc
 declare class PeppolInvoiceResponse extends PeppolInvoiceResponse_base {}
 //#endregion
 //#region src/schemas/peppol-document-schema.d.ts
-declare const isPeppolInvoice: <I>(input: I) => input is I & PeppolInvoice;
-declare const isPeppolCreditNote: <I>(input: I) => input is I & PeppolCreditNote;
-declare const isPeppolMessageLevelResponse: <I>(input: I) => input is I & PeppolMessageLevelResponse;
-declare const isPeppolInvoiceResponse: <I>(input: I) => input is I & PeppolInvoiceResponse;
-/**
- * @description Union of every supported PEPPOL business document. Members discriminate cleanly: invoice vs credit note via `invoiceLines`/`creditNoteLines`,
- * message-level vs invoice response via the `profileId` literal.
- */
-declare const peppolDocumentSchema: Schema.decodeTo<Schema.Union<readonly [typeof PeppolInvoice, typeof PeppolCreditNote, typeof PeppolMessageLevelResponse, typeof PeppolInvoiceResponse]>, Schema.String, never, never>;
-type PeppolDocumentEncoded = Schema.Codec.Encoded<typeof peppolDocumentSchema>;
-type PeppolDocumentDecoded = Schema.Schema.Type<typeof peppolDocumentSchema>;
-/**
- * @description This defines the types of documents that are sent/received through the peppol network.
- */
-type PeppolDocument = PeppolInvoice | PeppolCreditNote;
-/**
- * @description This defines the types of message that are sent/received through the peppol network.
- */
-type PeppolMessage = PeppolMessageLevelResponse | PeppolInvoiceResponse;
-type PeppolAllDocuments = PeppolDocument | PeppolMessage;
-type PeppolDocumentLine = PeppolInvoiceLine | PeppolCreditNoteLine;
-//#endregion
-//#region src/schemas/fields/default-customization-id.d.ts
-declare const DEFAULT_CUSTOMIZATION_ID: 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0';
-//#endregion
-//#region src/schemas/fields/default-profile-id.d.ts
-declare const DEFAULT_PROFILE_ID: 'urn:fdc:peppol.eu:2017:poacc:billing:01:1.0';
-//#endregion
-//#region src/schemas/fields/peppol-reference-schema.d.ts
-declare const PeppolReferenceId_base: OpaqueSchema<PeppolReferenceId, Schema.Struct<{
-  readonly id: Schema.String;
-}>>;
-declare class PeppolReferenceId extends PeppolReferenceId_base {}
-declare const peppolReferenceSchema: Schema.Union<readonly [typeof PeppolReferenceId, Schema.Undefined]>;
-type PeppolReferenceSchema = typeof peppolReferenceSchema.Type;
-//#endregion
-//#region src/schemas/values/additional-document-reference-code-schema.d.ts
-/**
- * @description Additional document reference.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1153/
- * @see {@link additionalDocumentReferenceCodesKeys}
- */
-type PeppolAdditionalDocumentReferenceCode = typeof additionalDocumentReferenceCodeSchema.Type;
-/**
- * @description Validates an additional document reference code against the PEPPOL subset of UNCL 1153 (reference qualifiers).
- *
- * @param error - The custom error message to use when validation fails. Defaults to the generic message.
- *
- * @returns An Effect schema that accepts only valid additional document reference codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1153/
- * @see {@link additionalDocumentReferenceCodesKeys}
- */
-declare const additionalDocumentReferenceCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAdditionalDocumentReferenceCode">;
-//#endregion
-//#region src/schemas/values/allowance-charge-reason-code-schema.d.ts
-/**
- * @description An allowance or charge reason code as defined by the PEPPOL subset of UNCL 5189.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5189/
- */
-type PeppolAllowanceChargeReasonCode = typeof allowanceChargeReasonCodeSchema.Type;
-/**
- * @description Validates an allowance or charge reason code against the PEPPOL subset of UNCL 5189 (D.16B).
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid allowance/charge reason codes.
- *
- * @validations
- * - PEPPOL-EN16931-CL002: Document allowance reason code MUST be according to the subset of UNCL 5189 D.16B.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5189/
- */
-declare const allowanceChargeReasonCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolAllowanceChargeReasonCode">;
-//#endregion
-//#region src/schemas/values/application-response-type-code-schema.d.ts
-/**
- * @description An application response type code as defined by the PEPPOL subset of UNCL 4343.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343/
- */
-type PeppolApplicationResponseTypeCode = ApplicationResponseTypeCodesKeys;
-/**
- * @description Validates an application response type code against the PEPPOL subset of UNCL 4343.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid application response type codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343/
- */
-declare const applicationResponseTypeCodeSchema: Schema.Literals<readonly ["AB", "AP", "RE"]>;
-//#endregion
-//#region src/schemas/values/charge-reason-code-schema.d.ts
-/**
- * @description A charge reason code as defined by the PEPPOL subset of UNCL 7161.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7161/
- */
-type PeppolChargeReasonCode = typeof chargeReasonCodeSchema.Type;
-/**
- * @description Validates a charge reason code against the PEPPOL subset of UNCL 7161 (D.16B).
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid charge reason codes.
- *
- * @validations
- * - PEPPOL-EN16931-CL003: Charge reason code MUST be according to UNCL 7161 D.16B.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7161/
- */
-declare const chargeReasonCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolChargeReasonCode">;
-//#endregion
-//#region src/schemas/values/peppol-country-code-schema.d.ts
-/**
- * @description Validates a two character ISO 3166-1 alpha-2 country code against the PEPPOL codelist. All codes in the codelist are exactly 2 characters, so the
- * literals union implies the length check.
- *
- * @validations
- * - BR-CL-14 / BR-CL-15: Country code MUST be a valid ISO 3166-1 alpha-2 code.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO3166/
- */
-declare const peppolCountryCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCountryCode">;
-//#endregion
-//#region src/schemas/values/currency-code-schema.d.ts
-/**
- * @description An ISO 4217 currency code as defined by the PEPPOL subset.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO4217/
- */
-type PeppolCurrencyCode = Schema.Schema.Type<typeof currencyCodeSchema>;
-/**
- * @description An ISO 4217 currency code as defined by the PEPPOL subset.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO4217/
- */
-type PeppolCurrencyCodeEncoded = Schema.Codec.Encoded<typeof currencyCodeSchema>;
-/**
- * @description Validates an ISO 4217 currency code against the PEPPOL codelist.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid currency codes.
- *
- * @validations
- * - PEPPOL-EN16931-CL007: Currency codes MUST be valid ISO 4217 codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ISO4217/
- */
-declare const currencyCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolCurrencyCode">;
-//#endregion
-//#region src/schemas/values/peppol-document-type-code-schema.d.ts
-/**
- * @description A document type code as defined by the PEPPOL subset of UNCL 1001 (document/message name code).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001/
- */
-type PeppolDocumentTypeCode = typeof peppolDocumentTypeCodeSchema.Type;
-/**
- * @description Validates a document type code against the PEPPOL subset of UNCL 1001.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid document type codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001/
- */
-declare const peppolDocumentTypeCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolDocumentTypeCode">;
-//#endregion
-//#region src/schemas/values/peppol-document-type-schema.d.ts
-/**
- * @description One of the PEPPOL document type schemes (e.g. `busdox-docid-qns`, `peppol-doctype-wildcard`).
- *
- * @see {@link documentTypesTable}
- */
-type PeppolDocumentType = typeof peppolDocumentTypeSchema.Type;
-/**
- * @description Validates a full PEPPOL document type identifier (`<scheme>::<value>`) against the known document type table. The scheme prefix must be a known key
- * and the full identifier must exist in the document type table (checked via a filter).
- *
- * @param error - The custom error message to use when validation fails. Defaults to `'invalid peppol document type'`.
- *
- * @returns An Effect schema that matches a valid `scheme::value` document type identifier.
- *
- * @see {@link documentTypesTable}
- */
-declare const peppolDocumentTypeSchema: Schema.TemplateLiteral<readonly [Schema.Literals<readonly ["busdox-docid-qns", "peppol-doctype-wildcard"]>, Schema.Literal<"::">, Schema.String]>;
-//#endregion
-//#region src/schemas/values/document-type-schemes-schema.d.ts
 /**
- * @description Validates a PEPPOL document type scheme (e.g. `busdox-docid-qns`, `peppol-doctype-wildcard`).
- *
- * @param error - The error message to use when validation fails. Defaults to `'invalid Peppol document type scheme'`.
- *
- * @returns An Effect schema that accepts only valid document type schemes.
- *
- * @see {@link documentTypesScheme}
- */
-declare const documentTypeSchemesSchema: Schema.Literals<[string, ...string[]]>;
-//#endregion
-//#region src/schemas/values/document-type-values-schema.d.ts
-/**
- * @description Validates the value part of a PEPPOL document type identifier (the portion after the scheme prefix) against the known document type table.
- *
- * @param error - The error message to use when validation fails. Defaults to `'invalid Peppol document type value'`.
+ * @description Type guard that returns `true` when a decoded value is a {@link PeppolInvoice}.
  *
- * @returns An Effect schema that accepts only valid document type values.
- *
- * @see {@link documentTypesTable}
- */
-declare const documentTypeValuesSchema: Schema.String;
-//#endregion
-//#region src/schemas/values/duty-tax-fee-category-schema.d.ts
-/**
- * @description A duty, tax or fee category code as defined by the PEPPOL subset of UNCL 5305 (VAT category code).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/
- */
-type PeppolDutyTaxFeeCategoryCode = typeof peppolDutyTaxFeeCategorySchema.Type;
-type PeppolDutyTaxFeeCategoryCodeEncoded = typeof peppolDutyTaxFeeCategorySchema.Encoded;
-/**
- * @description Validates a duty, tax or fee category code against the PEPPOL subset of UNCL 5305 (VAT category code).
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid duty/tax/fee category codes.
- *
- * @validations
- * - BR-CL-17 / BR-CL-18: VAT category code MUST be a valid UNCL 5305 code.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/
- */
-declare const peppolDutyTaxFeeCategorySchema: Schema.brand<Schema.Literals<readonly ["AE", "E", "S", "Z", "G", "O", "K", "L", "M", "B"]>, "PeppolDutyTaxFeeCategoryCode">;
-//#endregion
-//#region src/schemas/values/electronic-codes-schema.d.ts
-/**
- * @description An electronic address scheme (EAS) code, identifying the scheme of an electronic address (e.g. `0088` for GLN).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/
- */
-type PeppolElectronicAddressCode = typeof electronicCodesSchema.Type;
-/**
- * @description Validates an electronic address scheme (EAS) code against the PEPPOL Electronic Address Identifier Scheme codelist.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid electronic address scheme codes.
- *
- * @validations
- * - PEPPOL-EN16931-CL008: Electronic address identifier scheme MUST be from the codelist "Electronic Address Identifier Scheme".
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/
- */
-declare const electronicCodesSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolElectronicAddressCode">;
-//#endregion
-//#region src/schemas/values/icd-codes-schema.d.ts
-/**
- * @description An ISO 6523 ICD (International Code Designator) code identifying an identifier scheme.
+ * @example
+ *   ```ts
+ *   isPeppolInvoice(doc); // true for a UBL Invoice
+ *   ```;
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ICD/
+ * @see {@link PeppolDocumentSchema}
  */
-type PeppolIcdCode = typeof icdCodesSchema.Type;
+declare const isPeppolInvoice: <I>(input: I) => input is I & PeppolInvoice;
 /**
- * @description Validates an ISO 6523 ICD code against the PEPPOL codelist.
- *
- * @param error - The custom error message to use when validation fails. Defaults to `'Invalid ICD code provided'`.
+ * @description Type guard that returns `true` when a decoded value is a {@link PeppolCreditNote}.
  *
- * @returns An Effect schema that accepts only valid ICD codes.
- *
- * @validations
- * - BR-CL-10 / BR-CL-11 / BR-CL-21: Identifier scheme MUST be a valid ISO 6523 ICD code.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/ICD/
- */
-declare const icdCodesSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolIcdCode">;
-//#endregion
-//#region src/schemas/values/invoice-status-code-schema.d.ts
-/**
- * @description An invoice status code as defined by the PEPPOL subset of UNCL 4343 (T111).
+ * @example
+ *   ```ts
+ *   isPeppolCreditNote(doc); // true for a UBL CreditNote
+ *   ```;
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343-T111/
+ * @see {@link PeppolDocumentSchema}
  */
-type PeppolInvoiceStatusCodes = typeof invoiceStatusCodeSchema.Type;
+declare const isPeppolCreditNote: <I>(input: I) => input is I & PeppolCreditNote;
 /**
- * @description Validates an invoice status code against the PEPPOL subset of UNCL 4343 (T111).
- *
- * @param error - The custom error message to use when validation fails.
+ * @description Type guard that returns `true` when a decoded value is a {@link PeppolMessageLevelResponse}.
  *
- * @returns An Effect schema that accepts only valid invoice status codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4343-T111/
- */
-declare const invoiceStatusCodeSchema: Schema.brand<Schema.Literals<readonly ["AB", "AP", "RE", "IP", "UQ", "CA", "PD"]>, "PeppolInvoiceStatusCodes">;
-//#endregion
-//#region src/schemas/values/item-classification-codes-schema.d.ts
-/**
- * @description An item classification code as defined by the PEPPOL subset of UNCL 7143.
+ * @example
+ *   ```ts
+ *   isPeppolMessageLevelResponse(doc); // true for an MLR ApplicationResponse
+ *   ```;
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7143/
+ * @see {@link PeppolDocumentSchema}
  */
-type PeppolItemClassificationCode = typeof itemClassificationCodesSchema.Type;
+declare const isPeppolMessageLevelResponse: <I>(input: I) => input is I & PeppolMessageLevelResponse;
 /**
- * @description Validates an item classification code against the PEPPOL subset of UNCL 7143.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid item classification codes.
- *
- * @validations
- * - BR-CL-13: Item classification scheme MUST be a valid UNTDID 7143 code.
+ * @description Type guard that returns `true` when a decoded value is a {@link PeppolInvoiceResponse}.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL7143/
- */
-declare const itemClassificationCodesSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolItemClassificationCode">;
-//#endregion
-//#region src/schemas/values/mime-codes-schema.d.ts
-/**
- * @description A MIME media type code (e.g. `application/pdf`) as used for attached documents.
+ * @example
+ *   ```ts
+ *   isPeppolInvoiceResponse(doc); // true for an invoice response ApplicationResponse
+ *   ```;
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/MimeCode/
+ * @see {@link PeppolDocumentSchema}
  */
-type PeppolMimeCode = typeof mimeCodesSchema.Type;
+declare const isPeppolInvoiceResponse: <I>(input: I) => input is I & PeppolInvoiceResponse;
+declare const PeppolDocumentSchema_base: Schema.decodeTo<Schema.Union<readonly [typeof PeppolInvoice, typeof PeppolCreditNote, typeof PeppolMessageLevelResponse, typeof PeppolInvoiceResponse]>, Schema.String, never, never>;
 /**
- * @description Validates a MIME media type against the PEPPOL MIME code list.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid MIME types.
+ * @description Union of every supported PEPPOL business document. Members discriminate cleanly: invoice vs credit note via `invoiceLines`/`creditNoteLines`,
+ * message-level vs invoice response via the `profileId` literal. Decodes and encodes XML strings by dispatching on the root element;
+ * `ApplicationResponse` is split on `cbc:ProfileID`.
  *
- * @validations
- * - PEPPOL-EN16931-CL001: Attachment (MIME) type MUST come from the allowed list.
+ * @example
+ *   ```ts
+ *   const doc = Schema.decodeUnknownSync(PeppolDocumentSchema)(xml); // decoded document union
+ *   ```;
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/MimeCode/
+ * @see {@link PeppolDocumentDecoded}
+ * @see {@link PeppolDocumentEncoded}
  */
-declare const mimeCodesSchema: Schema.brand<Schema.Literals<readonly ["text/csv", "application/pdf", "image/png", "image/jpeg", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.oasis.opendocument.spreadsheet"]>, "PeppolMimeCode">;
-//#endregion
-//#region src/schemas/values/op-status-action-schema.d.ts
+declare class PeppolDocumentSchema extends PeppolDocumentSchema_base {}
 /**
- * @description An OpenPeppol operation status action code (e.g. the outcome of a message response).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusAction/
+ * @description Encoded form of {@link PeppolDocumentSchema}: the XML string representation.
  */
-type PeppolOpStatusAction = typeof opStatusActionSchema.Type;
+type PeppolDocumentEncoded = Schema.Codec.Encoded<typeof PeppolDocumentSchema>;
 /**
- * @description Validates an OpenPeppol operation status action code against the OPStatusAction codelist.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid operation status action codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusAction/
+ * @description Decoded form of {@link PeppolDocumentSchema}: the union of supported document classes.
  */
-declare const opStatusActionSchema: Schema.brand<Schema.Literals<readonly ["NOA", "PIN", "NIN", "CNF", "CNP", "CNA", "OTH"]>, "PeppolOpStatusAction">;
-//#endregion
-//#region src/schemas/values/op-status-reason-schema.d.ts
+type PeppolDocumentDecoded = Schema.Schema.Type<typeof PeppolDocumentSchema>;
 /**
- * @description An OpenPeppol operation status reason code (e.g. the reason for a message response outcome).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusReason/
+ * @description This defines the types of documents that are sent/received through the peppol network.
  */
-type PeppolOpStatusReason = typeof opStatusReasonSchema.Type;
+type PeppolDocument = PeppolInvoice | PeppolCreditNote;
 /**
- * @description Validates an OpenPeppol operation status reason code against the OPStatusReason codelist.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid operation status reason codes.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/OPStatusReason/
+ * @description This defines the types of message that are sent/received through the peppol network.
  */
-declare const opStatusReasonSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolOpStatusReason">;
-//#endregion
-//#region src/schemas/values/participant-identifier-code-schema.d.ts
+type PeppolMessage = PeppolMessageLevelResponse | PeppolInvoiceResponse;
 /**
- * @description A PEPPOL participant identifier scheme, identifying the scheme of a participant identifier (e.g. EAS codes).
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/
+ * @description Every document type supported by {@link PeppolDocumentSchema}: the billing documents and the response messages.
  */
-type PeppolParticipantIdentifierCode = typeof participantIdentifierCodeSchema.Type;
+type PeppolAllDocuments = PeppolDocument | PeppolMessage;
 /**
- * @description Validates a PEPPOL participant identifier scheme against the participant identifier schemes list.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid participant identifier schemes.
+ * @description A line from either a {@link PeppolInvoice} or a {@link PeppolCreditNote}.
  */
-declare const participantIdentifierCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolParticipantIdentifierCode">;
+type PeppolDocumentLine = PeppolInvoiceLine | PeppolCreditNoteLine;
 //#endregion
-//#region src/schemas/values/payment-means-code-schema.d.ts
+//#region src/schemas/fields/default-customization-id.d.ts
 /**
- * @description Validates a payment means code against the PEPPOL subset of UNCL 4461.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid payment means codes.
- *
- * @validations
- * - BR-CL-16: Payment means code MUST be a valid UNCL 4461 code.
+ * @description The default PEPPOL BIS Billing 3.0 customization identifier, which identifies the EN 16931 compliant billing rule set. Used as the decoding default
+ * for the `customizationId` field of {@link PeppolBillingBase}.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4461/
+ * @example
+ *   ```ts
+ *   DEFAULT_CUSTOMIZATION_ID; // 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'
+ *   ```;
  */
-declare const paymentMeansCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolPaymentMeansCode">;
+declare const DEFAULT_CUSTOMIZATION_ID: 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0';
 //#endregion
-//#region src/schemas/values/process-from-document-type-schema.d.ts
+//#region src/schemas/fields/default-profile-id.d.ts
 /**
- * @description Validates a business process identifier (`<scheme>::<value>`) against the processes allowed for a given document type.
- *
- * @param documentType - The PEPPOL document type scheme whose allowed processes should be used.
- * @param error - The custom error message to use when validation fails. Defaults to `'invalid process type for document type'`.
+ * @description The default PEPPOL BIS Billing 3.0 profile identifier, which identifies the billing process the document follows. Used as the decoding default for
+ * the `profileId` field of {@link PeppolBillingBase}.
  *
- * @returns An Effect schema that matches only processes allowed for the given document type.
- *
- * @see {@link peppolProcessSchema}
- * @see {@link documentTypesProcessIds}
+ * @example
+ *   ```ts
+ *   DEFAULT_PROFILE_ID; // 'urn:fdc:peppol.eu:2017:poacc:billing:01:1.0'
+ *   ```;
  */
-declare function processFromDocumentTypeSchema(documentType: PeppolDocumentType, error?: string): Schema.String | Schema.TemplateLiteral<readonly [Schema.Literals<readonly ["cenbii-procid-ubl", "oioubl-procid-ubl"]>, Schema.Literal<"::">, Schema.String]>;
+declare const DEFAULT_PROFILE_ID: 'urn:fdc:peppol.eu:2017:poacc:billing:01:1.0';
 //#endregion
-//#region src/schemas/values/vatex-code-schema.d.ts
+//#region src/schemas/fields/peppol-reference-schema.d.ts
+declare const PeppolReferenceId_base: OpaqueSchema<PeppolReferenceId, Schema.Struct<{
+  readonly id: Schema.String;
+}>>;
 /**
- * @description A VAT exemption reason code as defined by the CEF VATEX codelist.
+ * @description A reference identifier, such as an order or sales order reference.
  *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/vatex/
+ * @example
+ *   ```ts
+ *   { id: '123' }
+ *   ```;
  */
-type PeppolVatexCode = typeof vatexCodeSchema.Type;
+declare class PeppolReferenceId extends PeppolReferenceId_base {}
 /**
- * @description Validates a VAT exemption reason code against the CEF VATEX codelist.
- *
- * @param error - The custom error message to use when validation fails.
- *
- * @returns An Effect schema that accepts only valid VAT exemption reason codes.
+ * @description A schema for an optional reference identifier, accepting either {@link PeppolReferenceId} or `undefined`.
  *
- * @validations
- * - BR-CL-22: VAT exemption reason code MUST be a valid CEF VATEX code.
- *
- * @see https://docs.peppol.eu/poacc/billing/3.0/codelist/vatex/
+ * @example
+ *   ```ts
+ *   peppolReferenceSchema; // Schema.Union([PeppolReferenceId, Schema.Undefined])
+ *   ```;
  */
-declare const vatexCodeSchema: Schema.brand<Schema.Literals<[string, ...string[]]>, "PeppolVatexCode">;
-//#endregion
-//#region src/schemas/values/vat-date-code-schema.d.ts
-type PeppolVatDateCode = VatDateCodesKeys;
+declare const peppolReferenceSchema: Schema.Union<readonly [typeof PeppolReferenceId, Schema.Undefined]>;
 /**
- * @validations
- * - PEPPOL-EN16931-CL006: Invoice period description code must be according to UNCL 2005 D.16B.
+ * @description The decoded type of {@link peppolReferenceSchema}, either a {@link PeppolReferenceId} or `undefined`.
  */
-declare const vatDateCodeSchema: Schema.Literals<readonly ["3", "35", "432"]>;
+type PeppolReferenceSchema = Schema.Schema.Type<typeof peppolReferenceSchema>;
 //#endregion
-export { PeppolDocumentLine as $, PeppolPayeeFinancialAccount as $n, PeppolLineReference as $t, PeppolDocumentTypeCode as A, PeppolInvoiceLinePeriod as An, PeppolAttachmentExternalReference as Ar, getCreditNoteTypeCodeDescription as At, PeppolAllowanceChargeReasonCode as B, PeppolOriginatorDocumentReference as Bn, PeppolAmount as Br, withStatusCodes as Bt, PeppolDutyTaxFeeCategoryCode as C, PeppolCommodityClassifications as Cn, PeppolAddress as Cr, PeppolProcesses as Ct, documentTypeSchemesSchema as D, PeppolSellersItemIdentification as Dn, PeppolInvoiceDocumentReference as Dr, getInvoiceTypeCodeDescription as Dt, documentTypeValuesSchema as E, PeppolOriginCountryCode as En, PeppolBillingReference as Er, isValidCreditNoteTypeCode as Et, peppolCountryCodeSchema as F, PeppolLineCharge as Fn, PeppolAllowanceCharge as Fr, peppolBase64Schema as Ft, PeppolReferenceSchema as G, PeppolTaxSubTotalCategory as Gn, PeppolInvoiceResponseStatusReasonCode as Gt, PeppolAdditionalDocumentReferenceCode as H, PeppolTaxTotal as Hn, PeppolIsoDateString as Hr, InvoiceResponseDocumentActualResponseStatus as Ht, PeppolChargeReasonCode as I, peppolLineAllowanceChargeSchema as In, PeppolAllowanceChargeEncoded as Ir, InvoiceResponseDocumentActualResponse as It, DEFAULT_CUSTOMIZATION_ID as J, PeppolTaxSchemeId as Jn, peppolInvoiceResponseStatusReasonCodeSchema as Jt, peppolReferenceSchema as K, PeppolTaxSubTotalCategoryEncoded as Kn, PeppolInvoiceResponseStatusReasonCodeAction as Kt, chargeReasonCodeSchema as L, PeppolBillingBase as Ln, PeppolCharge as Lr, PeppolInvoiceResponseDocumentActualResponseWithStatus as Lt, PeppolCurrencyCode as M, PeppolLineAllowance as Mn, PeppolBinaryObject as Mr, creditNoteTypeCodeSchema as Mt, PeppolCurrencyCodeEncoded as N, PeppolLineAllowanceCharge as Nn, BaseAllowanceCharge as Nr, formatQuantityWithUnit as Nt, PeppolDocumentType as O, PeppolStandardItemIdentification as On, PeppolAdditionalDocumentReference as Or, PeppolInvoiceTypeCode as Ot, currencyCodeSchema as P, PeppolLineAllowanceChargeEncoded as Pn, PeppolAllowance as Pr, Base64 as Pt, PeppolDocumentEncoded as Q, PeppolCardAccount as Qn, PeppolDocumentResponseLineResponse as Qt, PeppolApplicationResponseTypeCode as R, PeppolContractDocumentReference as Rn, PeppolTaxCategoryTaxSchemeId as Rr, PeppolInvoiceResponseDocumentActualResponseWithoutStatus as Rt, electronicCodesSchema as S, PeppolBuyersItemIdentification as Sn, PeppolDeliveryPartyPartyName as Sr, isValidProcess as St, peppolDutyTaxFeeCategorySchema as T, PeppolLineItem as Tn, PeppolCountryCode as Tr, isValidInvoiceTypeCode as Tt, additionalDocumentReferenceCodeSchema as U, PeppolTaxTotalsBase as Un, PeppolInvoiceResponseCondition as Ut, allowanceChargeReasonCodeSchema as V, PeppolReceiptDocumentReference as Vn, PeppolAmountEncoded as Vr, withoutStatusCodes as Vt, PeppolReferenceId as W, PeppolTaxSubTotal as Wn, PeppolInvoiceResponseDocumentActualResponseStatus as Wt, PeppolDocument as X, PeppolTaxRepresentativeParty as Xn, PeppolXsdTime as Xt, PeppolAllDocuments as Y, PeppolTaxRepresentative as Yn, PeppolMessageLevelResponse as Yt, PeppolDocumentDecoded as Z, PeppolPaymentTerms as Zn, PeppolMessageLevelResponseDocumentResponse as Zt, PeppolInvoiceStatusCodes as _, PeppolLinePrice as _n, PeppolLegalMonetaryTotal as _r, TimeIntlUnit as _t, processFromDocumentTypeSchema as a, PeppolDocumentResponseDocumentReference as an, PeppolPayeeParty as ar, peppolDocumentSchema as at, icdCodesSchema as b, PriceAllowanceCharge as bn, PeppolDeliveryLocation as br, PeppolQuantityUnitCode as bt, participantIdentifierCodeSchema as c, PeppolCreditNote as cn, PeppolPartyName$1 as cr, PeppolInvoiceResponseDocumentReference as ct, PeppolOpStatusAction as d, PeppolInvoice as dn, PeppolPartyTaxScheme as dr, PeppolInvoiceResponseDocumentResponsePartyName as dt, PeppolMessageLevelDocumentResponseLineResponse as en, PeppolPayeeFinancialAccountFinancialInstitutionBranch as er, PeppolMessage as et, opStatusActionSchema as f, PeppolProjectReference as fn, PeppolPartyLegalEntity$1 as fr, PeppolInvoiceResponseParty as ft, itemClassificationCodesSchema as g, PeppolOrderLineReference as gn, PeppolOrderReference as gr, IntlUnit as gt, PeppolItemClassificationCode as h, PeppolBaseLine as hn, PeppolContact as hr, BaseIntlUnit as ht, vatexCodeSchema as i, PeppolMessageLevelResponseDocumentResponseDocument as in, PeppolPaymentMeansCode as ir, isPeppolMessageLevelResponse as it, peppolDocumentTypeCodeSchema as j, BaseLineAllowanceCharge as jn, PeppolId as jr, PeppolCreditNoteTypeCode as jt, peppolDocumentTypeSchema as k, PeppolItemClassification as kn, PeppolAttachment as kr, invoiceTypeCodeSchema as kt, PeppolOpStatusReason as l, PeppolCreditNoteLine as ln, PeppolPartySchema as lr, PeppolInvoiceResponseDocumentResponse as lt, mimeCodesSchema as m, PeppolInvoiceLineEncoded as mn, PeppolIdentifier as mr, peppolVatRegexSchema as mt, vatDateCodeSchema as n, PeppolStatus as nn, PeppolPaymentMandatePayerFinancialAccountId as nr, isPeppolInvoice as nt, paymentMeansCodeSchema as o, PeppolMessageLevelDocumentResponseDocumentReference as on, PeppolPartyEndpointId as or, PeppolInvoiceDocumentResponseParty as ot, PeppolMimeCode as p, PeppolInvoiceLine as pn, PeppolPartyLegalEntitySchema as pr, PeppolInvoiceResponseSenderParty as pt, DEFAULT_PROFILE_ID as q, PeppolTaxCategory as qn, PeppolInvoiceResponseStatusReasonCodeReason as qt, PeppolVatexCode as r, PeppolDocumentResponseDocument as rn, PeppolPaymentMeans as rr, isPeppolInvoiceResponse as rt, PeppolParticipantIdentifierCode as s, PeppolMessageLevelResponseParty as sn, PeppolPartyIdentification$1 as sr, PeppolInvoiceResponse as st, PeppolVatDateCode as t, PeppolDocumentResponseLineResponseContent as tn, PeppolPaymentMandate as tr, isPeppolCreditNote as tt, opStatusReasonSchema as u, PeppolCreditNoteLineEncoded as un, PeppolPartyTaxSchema as ur, PeppolInvoiceResponseDocumentResponseParty as ut, invoiceStatusCodeSchema as v, PeppolQuantity as vn, PeppolInvoicePeriod as vr, quantityToIntlUnitMap as vt, PeppolDutyTaxFeeCategoryCodeEncoded as w, PeppolItem as wn, PeppolAddressLine as wr, peppolProcessSchema as wt, PeppolElectronicAddressCode as x, PeppolAdditionalItemProperties as xn, PeppolDeliveryParty as xr, quantityUnitCodesSchema as xt, PeppolIcdCode as y, PeppolLinePriceAllowanceCharge as yn, PeppolDelivery as yr, quantityUnitCodeToIntlUnit as yt, applicationResponseTypeCodeSchema as z, PeppolDespatchDocumentReference as zn, peppolAllowanceChargeSchema as zr, peppolInvoiceResponseDocumentActualResponseSchema as zt };
-//# sourceMappingURL=index-BBzPjq7o.d.ts.map
+export { PeppolDocumentResponseDocument as $, PeppolAmountEncoded as $n, PeppolDocumentType as $t, isValidProcess as A, PeppolVatDateCode as An, PeppolContractDocumentReference as At, withoutStatusCodes as B, PeppolBillingReference as Bn, PeppolVatexCode as Bt, PeppolInvoiceResponseSenderParty as C, PeppolPartyTaxSchemeId as Cn, PeppolInvoiceLinePeriod as Ct, TimeIntlUnit as D, PeppolOrderReference as Dn, PeppolLineAllowanceChargeEncoded as Dt, IntlUnit as E, PeppolContact as En, PeppolLineAllowanceCharge as Et, formatQuantityWithUnit as F, PeppolAddress as Fn, PeppolTaxSubTotal as Ft, PeppolInvoiceResponseStatusReasonCodeReason as G, PeppolAllowanceChargeEncoded as Gn, PeppolParticipantIdentifierCode as Gt, PeppolInvoiceResponseDocumentActualResponseStatus as H, BaseAllowanceCharge as Hn, processFromDocumentTypeSchema as Ht, PeppolInvoiceResponseDocumentActualResponse as I, PeppolAddressLine as In, PeppolTaxSubTotalCategory as It, PeppolMessageLevelResponseDocumentResponse as J, PeppolDutyTaxFeeCategoryCode as Jn, PeppolItemClassificationCode as Jt, PeppolMessageLevelResponse as K, PeppolCharge as Kn, PeppolOpStatusReason as Kt, PeppolInvoiceResponseDocumentActualResponseWithStatus as L, PeppolCountryCode as Ln, PeppolTaxSubTotalCategoryEncoded as Lt, isValidCreditNoteTypeCode as M, PeppolDeliveryLocation as Mn, PeppolOriginatorDocumentReference as Mt, getInvoiceTypeCodeDescription as N, PeppolDeliveryParty as Nn, PeppolReceiptDocumentReference as Nt, quantityToIntlUnitMap as O, PeppolLegalMonetaryTotal as On, PeppolLineCharge as Ot, getCreditNoteTypeCodeDescription as P, PeppolDeliveryPartyPartyName as Pn, PeppolTaxTotal as Pt, PeppolStatus as Q, PeppolAmount as Qn, PeppolDocumentTypeScheme as Qt, PeppolInvoiceResponseDocumentActualResponseWithoutStatus as R, PeppolCountryCodeValue as Rn, PeppolTaxCategory as Rt, PeppolInvoiceResponseParty as S, PeppolPartyTaxScheme as Sn, PeppolItemClassification as St, BaseIntlUnit as T, PeppolIdentifier as Tn, PeppolLineAllowance as Tt, PeppolInvoiceResponseStatusReasonCode as U, PeppolAllowance as Un, PeppolProcess as Ut, PeppolInvoiceResponseCondition as V, PeppolInvoiceDocumentReference as Vn, PeppolQuantityUnitCode as Vt, PeppolInvoiceResponseStatusReasonCodeAction as W, PeppolAllowanceCharge as Wn, PeppolProcesses as Wt, PeppolLineReference as X, PeppolChargeReasonCode as Xn, PeppolInvoiceStatusCodes as Xt, PeppolDocumentResponseLineResponse as Y, PeppolDutyTaxFeeCategoryCodeEncoded as Yn, PeppolInvoiceTypeCode as Yt, PeppolDocumentResponseLineResponseContent as Z, PeppolAllowanceChargeReasonCode as Zn, PeppolDocumentTypeValue as Zt, PeppolInvoiceResponse as _, PeppolPartyEndpointId as _n, PeppolCommodityClassifications as _t, DEFAULT_CUSTOMIZATION_ID as a, PeppolCardAccount as an, PeppolId as ar, PeppolInvoice as at, PeppolInvoiceResponseDocumentResponseParty as b, PeppolPartySchema as bn, PeppolSellersItemIdentification as bt, PeppolDocumentDecoded as c, PeppolPaymentMandate as cn, PeppolMimeCode as cr, PeppolInvoiceLineEncoded as ct, PeppolDocumentSchema as d, PeppolPaymentMeansCode as dn, PeppolLinePrice as dt, PeppolDocumentTypeCode as en, PeppolCurrencyCode as er, PeppolDocumentResponseDocumentReference as et, PeppolMessage as f, PeppolPaymentMeansCodeValue as fn, PeppolQuantity as ft, isPeppolMessageLevelResponse as g, PeppolPayeePartyName as gn, PeppolBuyersItemIdentification as gt, isPeppolInvoiceResponse as h, PeppolPayeePartyLegalEntity as hn, PeppolAdditionalItemProperties as ht, DEFAULT_PROFILE_ID as i, PeppolPaymentTerms as in, PeppolAttachmentExternalReference as ir, PeppolCreditNoteLineEncoded as it, isValidInvoiceTypeCode as j, PeppolDelivery as jn, PeppolDespatchDocumentReference as jt, quantityUnitCodeToIntlUnit as k, PeppolInvoicePeriod as kn, PeppolBillingBase as kt, PeppolDocumentEncoded as l, PeppolPaymentMandatePayerFinancialAccountId as ln, PeppolBase64 as lr, PeppolBaseLine as lt, isPeppolInvoice as m, PeppolPayeePartyIdentification as mn, PriceAllowanceCharge as mt, PeppolReferenceSchema as n, PeppolApplicationResponseTypeCode as nn, PeppolAdditionalDocumentReference as nr, PeppolCreditNote as nt, PeppolAllDocuments as o, PeppolPayeeFinancialAccount as on, PeppolAdditionalDocumentReferenceCode as or, PeppolProjectReference as ot, isPeppolCreditNote as p, PeppolPayeeParty as pn, PeppolLinePriceAllowanceCharge as pt, PeppolXsdTime as q, PeppolTaxCategoryTaxSchemeId as qn, PeppolOpStatusAction as qt, peppolReferenceSchema as r, PeppolTaxRepresentative as rn, PeppolAttachment as rr, PeppolCreditNoteLine as rt, PeppolDocument as s, PeppolPayeeFinancialAccountFinancialInstitutionBranch as sn, PeppolBinaryObject as sr, PeppolInvoiceLine as st, PeppolReferenceId as t, PeppolCreditNoteTypeCode as tn, PeppolCurrencyCodeEncoded as tr, PeppolMessageLevelResponseParty as tt, PeppolDocumentLine as u, PeppolPaymentMeans as un, PeppolIsoDateString as ur, PeppolOrderLineReference as ut, PeppolInvoiceResponseDocumentReference as v, PeppolPartyIdentification as vn, PeppolLineItem as vt, PeppolVatRegex as w, PeppolPartyLegalEntity as wn, BaseLineAllowanceCharge as wt, PeppolInvoiceResponseDocumentResponsePartyName as x, PeppolElectronicAddressCode as xn, PeppolStandardItemIdentification as xt, PeppolInvoiceResponseDocumentResponse as y, PeppolPartyName as yn, PeppolOriginCountryCode as yt, withStatusCodes as z, PeppolIcdCode as zn, PeppolTaxSchemeId as zt };
+//# sourceMappingURL=index-XG-N6PcG.d.ts.map