JSON file - product catalog

URL to download product data

https://deante.pl/api/products?key=API_KEY

Definition of file components

enum Brand{
    Deante
    Neo
}

enum ImageType{
    packshot
    additionalPackshot
    decor
}

enum ProductType{
    product
    set
}

enum FileType{
    instruction
    technicalDrawing
    model3d
    warrantyCard
    declaration
    hygienicCertificate
}

interface Image {
    src: String
    type: ImageType
}

interface File {
    src: String
    type: FileType
}

interface PackageValue {
    value: Number
    unit: 'mm' | 'g'
}

interface Category {
    id: String
    name: String
    main?: Boolean
}

interface Designer {
    name: String
    description: String
}

interface Property {
    name: String
    value: String | Number
    scope: String
}

interface Feature {
    name: String
    description: String
    image: String
}

interface Product {
    id: String                      // "BQA_021M"
    brand: Brand                    // "Deante"
    producer: String                // "Deante"
    productType: ProductType        // "product"
    url: String                     // "https://deante.pl/produkt/agawa-bateria-umywalkowa-BQG_020M"
    name: String                    // "Washbasin tap, tall"
    collection: String              // "ARNIKA"
    finishes: String[]              // [ "chrom", "nero" ]
    ean: String                     // "5908212092057"
    cn: String                     // "84818011"
    prices: Object typeof {
        currency: String            // "PLN"
        netPrice: Number            // 649.59 - Net price
        grossPrice: Number          // 799.99 - Gross price
        vat: Number                 // 23 - Percentage value
        hasPromotion: Boolean       // hasPromotion === false => promotion: null
        promotion?: Object typeof {
            netPrice: Number        // 568.29 - Promotional net price
            grossPrice: Number      // 699.00 - Promotional gross price
        }
    },
    categories: Category[]
    images: Image[]
    videos: String[]
    files: File[]
    description: String
    package: Object typeof {{
        height: PackageValue
        width: PackageValue
        depth: PackageValue
        weight: PackageValue
    }
    isDesigned: Boolean             // isDesigned === false => designers: null
    designers?: Designer[]
    properties: Property[]
    features: Feature[]
    warranty: Number
    recommendedProducts: String[]
}

Available fields

Product.id

Deante product code. Serves as a universal product identifier.

Product.brand

Product brand. enum Brand field type. Only Deante and Neo values are available.

Product.producer

Product producer. field with producer name.

Product.productType

Product type. Determines whether the object represents a single product or a set consisting of several products.

Product.url

Link to product sheet at deante.pl

Product.name

Deante product name. Describes the type of product and its most important features.

Product.collection

Deante product series. All products in the series are stylistically consistent. This feature can be used to create recommendations for customers visiting the online store.

Product.finishes

Deante product finishes. Defines a list of main product colors.

Product.ean

EAN-13 barcode. A unique barcode printed on the product box.

Product.cn

CN code. Product customs code.

Product.prices

Field nameField typeDescription
currencyStringCurrency in which the price is sent (default: PLN)
netPriceNumberNet price
grossPriceNumberGross price
vatNumberPercentage value of VAT
hasPromotionBooleanIndication of whether the product is currently on promotion (default: false)
promotionObject | NullOptional Object containing promotional prices (default: null)
promotion.netPriceNumberPromotional net price
promotion.grossPriceNumberPromotional gross price

Product.categories

Product categories. A list of all objects of class Category, specifying to which category the product is assigned.

Category

Field nameField typeDescription
idStringFull category path, acting as an identifier
nameStringCategory name
mainBooleanValue indicating whether the category is the main category of the product (default: false)

Product.images

Product photos. A list of all objects of class Image, specifying pictures representing the product.

Image

Field nameField typeDescription
srcStringURL to a resource in the https://media.deante.pl domain
typeImageTypeenum ImageType field type, specifying the type of image.

ImageType

Available values:

  • packshot - Main image
  • additionalPackshot - Additional image
  • decor - Arranged image

Product.videos

Product videos. A list of product videos - YouTube platform.

Product.files

Files for download. A list of all objects of class File, storing information about the file.

File

Field nameField typeDescription
srcStringURL to a resource in the https://pc21.deante.pl domain
typeFileTypeenum FileType field type, specifying the type of file.

FileType

Available values:

  • instruction - Instructions for the product. It may present various information, such as how to install or care for it.
  • technicalDrawing - Technical drawing, showing the exact dimensions of the product
  • model3d - 3D model of the product. Deante provides models in various file formats, such as: .3ds, .dwg, .skp, .obj, .dxf, .gsm, .blend, .stp, .rfa, .fbx, .stl, .ifc
  • warrantyCard - Warranty card, describing the exact terms of the product warranty
  • declaration - Declaration of performance
  • hygienicCertificate - Hygienic certificate

Product.description

Product description. Describes the general features of the product, presenting them in a way that is less technical and more readable to the average user

Product.package

Packaging data. Includes information about the dimensions as well as the gross weight of the package (with the product inside).

Field nameField typeDescription
heightPackageValuePackage height
widthPackageValuePackage width
depthPackageValuePackage depth
weightPackageValueGross weight

PackageValue

Field nameField typeDescription
valueNumberNumerical value for a given field
unitStringSpecifies the unit describing the value field. Available values are: mm - millimeters | g - grams.

Product.isDesigned

Field of type TRUE | FALSE, indicating whether the product is a design product

Product.designers

Designer list. Stores all objects of type Designer, describing all designers who have designed the product. The value of the field is strictly dependent on the isDesigned field, and takes the value null when isDesigned has the value FALSE.

Designer

Field nameField typeDescription
nameStringName of the designer
descriptionStringDescription of the designer

Product.properties

Product properties. A list of all objects of class Property, specifying various properties of a product. All available product properties can be found here

Property

Field nameField typeDescription
nameStringName of product property
valueString | NumberValue of product property
scopeStringDefines to which group of characteristics a property belongs

Product.features

Product features. A list of all objects of class Feature, specifying special marketing features that distinguish a product.

Feature

Field nameField typeDescription
nameStringName of the product feature
descriptionStringDescription of the product feature
imageStringURL to a resource in the https://media.deante.pl domain

Product.warranty

Product warranty. Specifies how many years the product warranty is valid for.

Product.recommendedProducts

Related products. A list of codes for related products, or recommended products complete with a particular product.

Last modifed at : 0