Produkt-Daten¶

Die Product-Service API bietet vielseitige Endpunkte zur Verwaltung von Produkten, Marken und zugehörigen Metadaten. Sie unterstützt komplexe Workflows, von der Produkterstellung bis hin zur Verknüpfung von Medien, Marken und Preismodellen.

Struktur der Produktdaten¶

Produkte enthalten Schlüsselattribute wie Produktnummer, Titel, EAN und detaillierte Beschreibungen. Zusätzliche Informationen wie Herstellerteilenummern und Medienquellen werden durch ProductMedia und ProductImages ergänzt, um das Produkt visuell darzustellen.

Bestands- und Bestellinformationen wie Mindest- und Höchstmengen werden über die OrderDetails verwaltet.

Produktdaten Beispiel

{
        "id": "664dc56308f6ee6ec7032892",
        "createdAt": 1716446669973,
        "updatedAt": 1716446892395,
        "productNr": "12940115156",
        "title": "In-Ear Kopfhörer SoundSport Free wireless – Limited Edition",
        "ean": "0017817798525",
        "longDescription": "Starke, zuverlässige Bluetooth®-VerbindungSicher, bequem und leichtNaturgetreuer, kraftvoller SpitzenklangSchweiß- und wetterresistent (Schutzklasse IPX4)Bose Connect App mit Suchfunktion für die komplett kabellosen EarbudsAkkulaufzeit von bis zu 5 StundenTransportetui mit Ladefunktion sorgt für eine zusätzliche Wiedergabedauer von bis zu 10 StundenKlar verständliche Telefonate aufgrund des dualen Mikrofonsystems",
        "supplierId": "664dc39608f6ee6ec703286e",
        "brandId": "664dbbbe9c7e79240f0d688f",
        "manufacturerId": "66ebfc92eded7c4a68475f6b",
        "price": {}, // siehe Preis API
        "additionalData": {
            "Herstellerteilenummer": "827770-0030"
        },
        "features": null,
        "productMedia": [
            {
                "mimeType": "image/jpeg",
                "source": "https://cdn.expert.de/ad/62/1c/36858e6e1b33644eb4e5d8af70f2da65a7/Abbildung_1149482.jpeg_1000x1000_90-0.jpeg",
                "title": "zoom",
                "type": "zoom"
            }        
        ],
        "productImages": {
            "primaryImageUrl": "https://cdn.expert.de/ad/62/1c/36858e6e1b33644eb4e5d8af70f2da65a7/Abbildung_1149482.jpeg_1000x1000_90-0.jpeg",
            "manufacturerImageUrl": null
        },
        "orderDetails": {
            "contentUnitsPerOrderUnit": 0.0,
            "priceQuantity": 0,
            "minQuantity": 0,
            "maxQuantity": 3,
            "quantityInterval": 1
        },
        "customPriceCalculation": false,
        "active": true
}   

Die API ermöglicht es, Produkte mit Marken zu verknüpfen, um die Hersteller-Identität zu stärken.

Marken-Integration¶

Jedes Produkt kann einer Marke zugeordnet werden. Marken umfassen Informationen wie Name, Logo und weitere Details, die für die Identifikation eines Produkts essenziell sind.

Die Brand-Entität in der API hilft dabei, die Markeninformationen eines Produkts klar zu strukturieren und die visuelle Darstellung durch Logos und Metadaten zu unterstützen.

Brand Beispiel

{
    "id": "664dbbbe9c7e79240f0d688f",
    "supplierId": "664dc39608f6ee6ec703286e",
    "createdAt": 0,
    "updatedAt": 0,
    "name": "BOSE",
    "email": null,
    "phoneNr": null,
    "logoUrl": "https://cdn.expert.de/ef/bd/62/e034d60b58d36547234f15d861f61f8076/Markenlogo%20BOSE.png"
}

Preisinformationen werden dynamisch durch die Preis-API geliefert und bieten so Flexibilität in der Preisgestaltung und Kalkulation.

classDiagram
    class Product {
        +String id
        +String productNr
        +String title
        +String ean
        +String longDescription
        +String supplierId
        +String brandId
        +boolean customPriceCalculation
        +boolean active
        +int minQuantity
        +int maxQuantity
        +int quantityInterval
    }

    class Brand {
        +String id
        +String name
        +String email
        +String phoneNr
        +String logoUrl
    }

    class Price {
        // Attributes from the Price API
    }

    class ProductMedia {
        +String mimeType
        +String source
        +String title
        +String type
    }

    class ProductImages {
        +String primaryImageUrl
        +String manufacturerImageUrl
    }

    class OrderDetails {
        +double contentUnitsPerOrderUnit
        +int priceQuantity
        +int minQuantity
        +int maxQuantity
        +int quantityInterval
    }

    Product -- Brand : "gehört zu"
    Product -- Price : "hat"
    Product --o ProductMedia : "hat"
    Product --o ProductImages : "hat"
    Product -- OrderDetails : "enthält"

Aktualisierung der Daten¶

Die Aktualisierung der Daten im Shop passiert aktuell in Echzeit und die Daten der Suche werden nur nach Absprache aktualisiert.

Route- und Endpunktdokumentation¶

Route: /productservice