FIT Product Test API

AG-FIT 769

Release	Value
Version	1.0.0
Date	2026-09-01
State	pre-released

Release

Value

Version

1.0.0

Date

2026-09-01

State

pre-released

Description

The Product Test API executes and manages tests for telecommunications products and services. FIT TMF769 models explicit FIT product-test resources instead of a generic characteristic-based payload.

The API manages the ProductTest resource and supports:

creating product tests;
retrieving one product test;
listing product tests;
partially updating a product test;
receiving create, state-change, and attribute-value-change notifications.

Release notes

See Version history for the changes in this and earlier versions.

Sample use cases

Full flow:

Diagnose neu anlegen

POST only:

Reset starten
Device registrieren
Device deregistrieren
Device tauschen
Link senden
Unbekannte Produkt-ID

Managed entity resource models

ProductTest

The ProductTest resource represents a concrete FIT product test request or result.

Lifecycle

Resource model

JSON representation sample

{
  "$schema" : "../schema/fit-tmf769.schema.json",
  "id" : "b9b1727e-faae-497f-8e82-43ebe92de6ce",
  "href" : "https://serverRoot/tmf-api/productTestManagement/v5/productTest/b9b1727e-faae-497f-8e82-43ebe92de6ce",
  "relatedProduct" : {
    "id" : "ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6",
    "@type" : "ProductRef",
    "href" : "https://serverRoot/tmf-api/productInventory/v5/product/ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6"
  },
  "agreement" : [ {
    "@type" : "Agreement",
    "name" : "buyerServiceContract",
    "businessId" : "500012",
    "agreementType" : "buyerServiceContract",
    "engagedParty" : [ {
      "businessId" : "500011",
      "@type" : "Organization"
    } ]
  } ],
  "externalIdentifier" : {
    "id" : "1000222",
    "externalIdentifierType" : "productTestExternalId"
  },
  "measureType" : "standard",
  "state" : "acknowledged",
  "startDateTime" : "2026-07-17T08:00:00+02:00",
  "stateChangeDate" : "2026-07-17T08:00:00+02:00",
  "@type" : "BsaDiagnosis"
}

Notification resource models

The API includes notifications for ProductTest resources.

Reference:

ProductTest create event example

{
  "$schema" : "../schema/fit-tmf769.schema.json",
  "eventId" : "8ee84c91-b402-4f34-bcd3-5f98cbf5d9f0",
  "eventTime" : "2026-07-17T08:00:00+02:00",
  "eventType" : "ProductTestCreateEvent",
  "description" : "ProductTestCreateEvent illustration",
  "event" : {
    "productTest" : {
      "id" : "b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "href" : "https://serverRoot/tmf-api/productTestManagement/v5/productTest/b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "relatedProduct" : {
        "id" : "ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6",
        "@type" : "ProductRef",
        "href" : "https://serverRoot/tmf-api/productInventory/v5/product/ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6"
      },
      "agreement" : [ {
        "@type" : "Agreement",
        "name" : "buyerServiceContract",
        "businessId" : "500012",
        "agreementType" : "buyerServiceContract",
        "engagedParty" : [ {
          "businessId" : "500011",
          "@type" : "Organization"
        } ]
      } ],
      "externalIdentifier" : {
        "id" : "1000222",
        "externalIdentifierType" : "productTestExternalId"
      },
      "measureType" : "standard",
      "state" : "acknowledged",
      "stateChangeDate" : "2026-07-17T08:00:00+02:00",
      "startDateTime" : "2026-07-17T08:00:00+02:00",
      "@type" : "BsaDiagnosis"
    }
  },
  "@type" : "ProductTestCreateEvent"
}

ProductTest attribute-value-change event example

{
  "$schema" : "../schema/fit-tmf769.schema.json",
  "eventId" : "7ab65083-2a70-4b9c-9d46-0fa8331253f1",
  "eventTime" : "2026-07-17T08:00:02+02:00",
  "eventType" : "ProductTestAttributeValueChangeEvent",
  "description" : "ProductTestAttributeValueChangeEvent illustration",
  "event" : {
    "productTest" : {
      "id" : "b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "href" : "https://serverRoot/tmf-api/productTestManagement/v5/productTest/b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "relatedProduct" : {
        "id" : "ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6",
        "@type" : "ProductRef",
        "href" : "https://serverRoot/tmf-api/productInventory/v5/product/ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6"
      },
      "agreement" : [ {
        "@type" : "Agreement",
        "name" : "buyerServiceContract",
        "businessId" : "500012",
        "agreementType" : "buyerServiceContract",
        "engagedParty" : [ {
          "businessId" : "500011",
          "@type" : "Organization"
        } ]
      } ],
      "externalIdentifier" : {
        "id" : "1000222",
        "externalIdentifierType" : "productTestExternalId"
      },
      "measureType" : "standard",
      "state" : "inProgress",
      "stateChangeDate" : "2026-07-17T08:00:02+02:00",
      "stateChangeMessage" : [ {
        "code" : "0000",
        "text" : "Keine Änderung zum Auftrag."
      } ],
      "stateChangeHistory" : [ {
        "state" : "acknowledged",
        "changeDate" : "2026-07-17T08:00:00+02:00"
      } ],
      "startDateTime" : "2026-07-17T08:00:00+02:00",
      "@type" : "BsaDiagnosis",
      "testMeasure" : [ {
        "@type" : "TestMeasure",
        "metricCategory" : "OverallResult",
        "metricName" : "OverallResult",
        "metricValue" : "FEHLER_BEI_DEUTSCHE_TELEKOM"
      }, {
        "@type" : "TestMeasure",
        "metricCategory" : "FTTH_Opt_Pegel",
        "metricName" : "Durchführung",
        "metricValue" : "OK"
      }, {
        "@type" : "TestMeasure",
        "metricCategory" : "FTTH_Opt_Pegel",
        "metricName" : "oltTxPower[ONU 20 (Kunde!)]",
        "metricValue" : "5.9",
        "unitOfMeasure" : "dBm"
      } ]
    }
  },
  "@type" : "ProductTestAttributeValueChangeEvent"
}

ProductTest state-change event example

{
  "$schema" : "../schema/fit-tmf769.schema.json",
  "eventId" : "52f86e24-fd10-4c8d-92d7-f3c94d099f3d",
  "eventTime" : "2026-07-17T08:00:01+02:00",
  "eventType" : "ProductTestStateChangeEvent",
  "description" : "ProductTestStateChangeEvent illustration",
  "event" : {
    "productTest" : {
      "id" : "b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "href" : "https://serverRoot/tmf-api/productTestManagement/v5/productTest/b9b1727e-faae-497f-8e82-43ebe92de6ce",
      "relatedProduct" : {
        "id" : "ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6",
        "@type" : "ProductRef",
        "href" : "https://serverRoot/tmf-api/productInventory/v5/product/ae443f8d-aa6a-41f9-8ec7-8b01e7f666e6"
      },
      "agreement" : [ {
        "@type" : "Agreement",
        "name" : "buyerServiceContract",
        "businessId" : "500012",
        "agreementType" : "buyerServiceContract",
        "engagedParty" : [ {
          "businessId" : "500011",
          "@type" : "Organization"
        } ]
      } ],
      "externalIdentifier" : {
        "id" : "1000222",
        "externalIdentifierType" : "productTestExternalId"
      },
      "measureType" : "standard",
      "state" : "inProgress",
      "stateChangeDate" : "2026-07-17T08:00:01+02:00",
      "stateChangeMessage" : [ {
        "code" : "0000",
        "text" : "Keine Änderung zum Auftrag."
      } ],
      "stateChangeHistory" : [ {
        "state" : "acknowledged",
        "changeDate" : "2026-07-17T08:00:00+02:00"
      } ],
      "startDateTime" : "2026-07-17T08:00:00+02:00",
      "@type" : "BsaDiagnosis"
    }
  },
  "@type" : "ProductTestStateChangeEvent"
}

Authentication

See FIT API authentication for the common authentication requirements for this API.

The current OpenAPI specification does not declare an API-specific security scheme, so the generated API reference does not contain a security-schemes section.

Validation using the conformance profile

The conformance profile defines which attributes, structures, and constraints are applicable to the FIT implementation of TMF769. It can be used to validate ProductTest payloads for compliance with the FIT specification.

The following artifact is provided for validation:

JSON Schema – machine-readable schema for automated validation of JSON payloads.