Serienidentitäten über die API integrieren

Diese Seite richtet sich an Integratoren, die seriennummerngeführte Wareneingänge, Tracking-Auswertungen oder externe Lagerclients anbinden. Nach der Integration senden Clients nicht nur eine sichtbare Seriennummer, sondern immer den fachlichen Seriennummern-Namensraum.

Ressourcen

Lesen Sie Ressourcen-Metadaten, bevor Sie Felder oder Pfade fest verdrahten. Die relevanten Ressourcen liegen unter /api/v1/inventory:

RessourceZweck
serial-namespacesNamensräume für Hersteller-, Lieferanten- oder interne Seriennummern pflegen.
serial-identitiesErzeugte Serienidentitäten lesen. Clients legen sie nicht direkt an.
serial-identity-claimsNicht eindeutig auflösbare Seriennummern-Beobachtungen prüfen und bearbeiten.
trackingBestandstracking mit optionaler serialIdentityId lesen.

Seriennummer im Wareneingang senden

Senden Sie bei seriennummerngeführten Wareneingangspositionen serialAssignments. Jeder Eintrag enthält den Namensraum und die sichtbare Seriennummer:

json
{
  "quantityAccepted": "2",
  "targetBinId": "019f0000-0000-7000-8000-000000000001",
  "serialAssignments": [
    {
      "serialNamespaceId": "019f0000-0000-7000-8000-000000000010",
      "serialNumber": "SN-10001"
    },
    {
      "serialNamespaceId": "019f0000-0000-7000-8000-000000000010",
      "serialNumber": "SN-10002"
    }
  ]
}

Für Chargen bleibt trackingNumbers der richtige Vertrag. Verwenden Sie serialAssignments nur für trackingType=serial_number.

Fehler behandeln

Behandeln Sie diese Fälle als fachliche Eingabefehler:

  • serialNamespaceId fehlt bei einer seriennummerngeführten Position.
  • Die Anzahl der Seriennummern passt nicht zur akzeptierten Menge.
  • Dieselbe Seriennummer existiert bereits im gleichen Namensraum.
  • Der Namensraum gehört zu einer anderen Variante, ist inaktiv oder liegt in einem anderen Mandanten.

Zeigen Sie Benutzern eine fachliche Meldung. Geben Sie keine technischen Datenbankstatuscodes, Tabellennamen, Indexnamen oder rohe Treibertexte aus.

Eindeutigkeit

Workspace normalisiert Seriennummern für die Eindeutigkeitsprüfung. Die technische Identität ist:

text
Mandant + Seriennummern-Namensraum + normalisierte Seriennummer

Nutzen Sie keine sichtbare Seriennummer allein als Primärschlüssel in externen Clients.