---
title: "FieldMatrix – API-Referenz · Quittio"
description: "Field metadata of all DTOs, derived from the mapping attributes (single source for profile validation, documentation and coverage reports)."
canonical_url: "https://quittio.dev/docs/api/Quittio/Core/Mapping/FieldMatrix"
locale: de
meta:
  "og:description": "Field metadata of all DTOs, derived from the mapping attributes (single source for profile validation, documentation and coverage reports)."
  "og:image": "https://quittio.dev/og/quittio-de.jpg"
  "og:image:alt": "Quittio: E-Rechnungen für PHP und Laravel. Rechtssicher, validiert, archiviert, mit geprüfter Beispielrechnung."
  "og:image:height": "630"
  "og:image:type": image/jpeg
  "og:image:width": "1200"
  "og:title": "FieldMatrix – API-Referenz · Quittio"
  "twitter:image": "https://quittio.dev/og/quittio-de.jpg"
  "twitter:image:alt": "Quittio: E-Rechnungen für PHP und Laravel. Rechtssicher, validiert, archiviert, mit geprüfter Beispielrechnung."
---

> Index of every page on this site: [llms.txt](https://quittio.dev/llms.txt)

[API reference](https://quittio.dev/docs/api) / [Quittio](https://quittio.dev/docs/api/Quittio) \\ [Core](https://quittio.dev/docs/api/Quittio/Core) \\ [Mapping](https://quittio.dev/docs/api/Quittio/Core/Mapping)

# FieldMatrix

final class in quittio/core

`Quittio\Core\Mapping\FieldMatrix` · [Source](https://github.com/Quittio/quittio/blob/v0.7.1/packages/core/src/Mapping/FieldMatrix.php#L25)

Field metadata of all DTOs, derived from the mapping attributes (single source for profile validation, documentation and coverage reports).

## Methods \#

| Method | Description |
| --- | --- |
| `::businessTerm()` | Business term of a field, resolved for shared structures (Address, Contact, Period) from the business term of the parent field, e.g. BT-55 for the country code of the buyer address (BG-8). |
| `::fields()` | |
| `::level()` | Lowest profile level that carries a field where it is used: its own level (EN 16931 without a Level attribute, EXTENDED for fields of EXTENDED only), raised to the level of the parent field, because a part is written only together with its parent. E.g. the address parts of BASIC WL inside the seller address (BG-5, MINIMUM) stay BASIC WL, the country code (BT-40, MINIMUM) stays MINIMUM; inside the buyer address (BG-8, BASIC WL) the country code (BT-55) is BASIC WL. |

### `businessTerm()`#

```
public static function businessTerm(
    class-string $class,
    string $property,
    string|null $parentTerm,
): ?string
```

static

Business term of a field, resolved for shared structures (Address, Contact, Period) from the business term of the parent field, e.g. BT-55 for the country code of the buyer address (BG-8).

| Parameter | Type | Description |
| --- | --- | --- |
| `$class` | `class-string` | |
| `$property` | `string` | |
| `$parentTerm` | `string\|null` | business term of the parent field (e.g. BG-8), null at the top level |

<dl><dt>Returns</dt>
<dd><code>?string</code></dd>
</dl>

### `fields()`#

```
public static function fields(class-string $class): array<string, FieldDefinition>
```

static

| Parameter | Type | Description |
| --- | --- | --- |
| `$class` | `class-string` | |

<dl><dt>Returns</dt>
<dd><code>array&lt;string, <a href="https://quittio.dev/docs/api/Quittio/Core/Mapping/FieldDefinition">FieldDefinition</a>&gt;</code></dd>
</dl>

### `level()`#

```
public static function level(
    class-string $class,
    string $property,
    ProfileLevel|null $parentLevel = null,
): ProfileLevel
```

static

Lowest profile level that carries a field where it is used: its own level (EN 16931 without a Level attribute, EXTENDED for fields of EXTENDED only), raised to the level of the parent field, because a part is written only together with its parent. E.g. the address parts of BASIC WL inside the seller address (BG-5, MINIMUM) stay BASIC WL, the country code (BT-40, MINIMUM) stays MINIMUM; inside the buyer address (BG-8, BASIC WL) the country code (BT-55) is BASIC WL.

| Parameter | Type | Description |
| --- | --- | --- |
| `$class` | `class-string` | |
| `$property` | `string` | |
| `$parentLevel` | `[ProfileLevel](https://quittio.dev/docs/api/Quittio/Core/Profiles/ProfileLevel)\|null` = `null` | effective level of the parent field, null at the top level |

<dl><dt>Returns</dt>
<dd><code><a href="https://quittio.dev/docs/api/Quittio/Core/Profiles/ProfileLevel">ProfileLevel</a></code></dd>
</dl>

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://quittio.dev/#website","@type":"WebSite","description":"E-Rechnungen für PHP und Laravel: ZUGFeRD, XRechnung und Peppol erstellen, prüfen, lesen und archivieren.","inLanguage":"de-DE","name":"Quittio","url":"https://quittio.dev/","publisher":{"@id":"https://quittio.dev/#identity"},"workTranslation":{"@id":"https://quittio.dev/en#website"}},{"@id":"https://quittio.dev/docs/api/Quittio/Core/Mapping/FieldMatrix#webpage","@type":"WebPage","description":"Field metadata of all DTOs, derived from the mapping attributes (single source for profile validation, documentation and coverage reports).","name":"FieldMatrix – API-Referenz","url":"https://quittio.dev/docs/api/Quittio/Core/Mapping/FieldMatrix","isPartOf":{"@id":"https://quittio.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://quittio.dev/docs/api/Quittio/Core/Mapping/FieldMatrix"]}],"primaryImageOfPage":{"@id":"https://quittio.dev/#logo"}},{"@id":"https://quittio.dev/#identity","@type":"Organization","description":"Open-Source-Bibliothek für E-Rechnungen in PHP und Laravel (ZUGFeRD, XRechnung, Peppol) und Quittio Managed.","email":"kontakt@niklasforst.de","legalName":"Niklas Forst – Softwareentwicklung","name":"Quittio","url":"https://quittio.dev","founder":{"@type":"Person","name":"Niklas Forst","url":"https://quittio.dev/ueber"},"logo":{"@id":"https://quittio.dev/#logo"},"sameAs":["https://github.com/Quittio/quittio","https://packagist.org/packages/quittio/quittio"]},{"@id":"https://quittio.dev/#logo","@type":"ImageObject","caption":"Quittio","contentUrl":"https://quittio.dev/logo.png","inLanguage":"de-DE","url":"https://quittio.dev/logo.png"}]}
```