ProductsUp-Connect

ProductsUp-Connect

1.0.0OAS 3.0

This API is tailor-made to fit the need of ProductsUp. ProductsUp is an application that helps to fully integrate automatic advertisement on social media.
Our API returns Discounts enhanced with Product- and BoSS fields. It enables ProductsUp to create images for the advertisements, without pulling from different sources.

API Base URL
  • Server 1:https://api.migros.ch

    URL of upstream

Security
Kong-Api-Key (apiKey)

Kong key-auth authentication

Additional Information
Contact MGB-UDP-Business-Services (arg_mgb-udp-business-services@mgb.ch)

Enhanced-Discount Data

Get all ProductsUp relevant discounts with the enhanced fields

This endpoint retrieves discounts with the following filters and adds additional Products and BoSS fields:

  • Only current discounts
  • Must be a national discount
  • Must be of the distribution-channel SMVM
  • Has to be one of the following roles: 2000000001: M: High-Performer,
    2000000002: M: Wochenangebot Typ I, 2000000003: M: Wochenangebot Typ II
  • Must be of type: 001: SA Sonderangebot, 002: SE Sellout,
    003: LIQU Liquidationsangebot or 005: GRAB Angebot CHF beim Kauf ab X Stück
  • The reduction type has to be one of the following: 01: Relativer Rabatt or
    06: Rabattpreis = CHF (We will only map discounts of reduction type 06
    if it is also a “Vitamin Franken” promotion (AdvertisementTypeId “4”))
  • Has to be a bundle discount
  • The main product of the discount has to be of the BoSS-World 04: FLEISCH/GEFLUEGEL/FISCH,
    05: FRUECHTE/GEMUESE, 09: BEAUTY SELFCARE WORLD or 15: HAUSHALT
get
https://api.migros.ch/migros/marketing/promotions/v1/public/productsup/discounts

Response

application/json

List of Enhanced-Discounts

EnhancedDiscount is a discount with additional Product and BoSS information.

additionalDescriptionDestring

AdditionalDescriptionDE holds additional information about the discount in german

Example:(ohne Mehrfach- und Sonderpackungen)

additionalDescriptionFrstring

AdditionalDescriptionFR holds additional information about the discount in french

Example:(excepté les emballages multiples et spéciaux)

additionalDescriptionItstring

AdditionalDescriptionIT holds additional information about the discount in italian

Example:(confezioni multiple e speciali escluse)

advertisementTypeIdstring

AdvertisementTypeID describes how the discount should be visualized

Example:2

amountstring

Amount is the relative reduction amount to the price (e.g. 20%)

Example:20%

bossWorldNamestring

BoSSWorldName holds the BoSS-World name of the discounted product

Example:FOOD

brandNameDestring

BrandNameDE holds the brand-name of the discounted product in german

Example:I am

brandNameFrstring

BrandNameFR holds the brand-name of the discounted product in french

Example:I am

brandNameItstring

BrandNameIT holds the brand-name of the discounted product in italian

Example:I am

descriptionDestring

DescriptionDE is a short text about the Discount in german

Example:I am-, Kétec-, Schwarzkopf- und Syoss-Colorationen-Sortiment

descriptionFrstring

DescriptionFR is a short text about the Discount in french

Example:Tout l’assortiment de colorations I am, Kétec, Schwarzkopf et Syoss

descriptionItstring

DescriptionIT is a short text about the Discount in italian

Example:Tutte le colorazioni per capelli I am, Kétec, Schwarzkopf e Syoss

discountConditionDestring

DiscountConditionDE is the condition in which the discount applies in german

Example:ab 2 Stück

discountConditionFrstring

DiscountConditionFR is the condition in which the discount applies in french

Example:dès 2 pièces

discountConditionItstring

DiscountConditionIT is the condition in which the discount applies in italian

Example:da 2 pezzi

discountImagestring

DiscountImage is the main image referring to the Discount in JPG format

Example:https://image.migros.ch/d/{stack}/o-af-1-t.clr-fff/42d7a4ffcd9a9a33b538c4941e78e40f469ca1cb.jpg

discountLinkDestring

DiscountLinkDE is the link to the german discount on Migros.ch

Example:https://www.migros.ch/de/offers/instore/2380302?context=instore

discountLinkFrstring

DiscountLink is the link to the french discount on Migros.ch

Example:https://www.migros.ch/fr/offers/instore/2380302?context=instore

discountLinkItstring

DiscountLink is the link to the italian discount on Migros.ch

Example:https://www.migros.ch/it/offers/instore/2380302?context=instore

gtinstring

Gtin holds the Main-GTIN of the discounted product

Example:4008082355724

hintDestring

HintDE is an example of a reduction in text form in german

hintFrstring

HintFR is an example of a reduction in text form in french

hintItstring

HintIT is an example of a reduction in text form in italian

idstringrequired

ID is the discountID

Example:2380302

isVitaminFrankenstring

IsVitaminFranken is true if the discount is a vitamin franken discount (AdvertisementTypeID=4)

Example:2

originalPricenumber

OriginalPrice is the non-discounted price

Example:2.5

packagestring

Package holds the package amount of the discounted product

Example:100g

pricenumber

Price is the discounted price

Example:2.25

reductionAmountnumber

ReductionAmount is the amount of money that is reduced

Example:0.5

reductionTypeIdstring

ReductionTypeID tells us whether it’s a 01=relativ, 02=absolut, … reduction

Example:01

typeIdstring

TypeID is the discount type identifier

Example:001

get/migros/marketing/promotions/v1/public/productsup/discounts
 
application/json