Search
K
Layout-API

Rendered warranty

Render a warranty (Garantieschein) as HTML, PDF or JSON.

You can also provide the format as a filename extension like in …v3/{cumulus}/warranty/detail/{warrantyId}.[pdf|html|json] . All information is formated like specified for digital view.

get
https://api-qual.migros.ch/migros/customers/warranties/v1/detail/{cumulus}/{warrantyId}

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

warrantyIdstringrequired

warrantyId of the warrranty as returned from the …/warranty/list or …/warranty/xlist endpoints.

Response

200

Warranty as HTML, PDF or JSON

WarrantyDetailResponse

articleDescriptionstringrequired

Article description.

Example:MediaPadT5 10.1 WiFi s

articleNumberstringrequired

Unique article identifer. Product-ID.

Example:798458800000

articlePricenumberrequired

Full article price without reductions in CHF.

Example:274

articlePriceNettonumberrequired

Article price after reductions in CHF.

Example:229

articleReductionnumberrequired

Article price reduction in CHF.

Example:-45

buyTimestringrequired

Time on which the article which issues a warranty has been acquired. Provided in MMHHSS.

Example:110457

cashierstringrequired

Cashier number which can be back referenced to the real person.

Example:0533572

cooperativestringrequired

Cooperative ID (Genossenschaft). Online purchases are listed as cooperative 202.

Example:MEL Rothenburg

cumulusstringrequired

Cumulus number of the customer.

Example:2099318037622

cumulusPointsTotalnumberrequired

Cumulus total acquired including this transaction.

Example:1000

cumulusPointsTotalDateinteger

Date of the latest transaction. Usually the same as buyDate. Provided in YYYYMMDD.

Example:20190927

storeIdstringrequired

Unique store identifier. Filial-ID

Example:0150475

storeLangstringrequired

Language of the store in which the warranty has been acquired. The warranty will be computed in the given store lang.

Allowed values:DEFRIT

Example:DE

storeNamestringrequired

Name of the store.

Example:MEL Limmatplatz

terminalstringrequired

Terminal number which was used to issue the transaction. Real “Kasse”.

Example:042

transactionDateintegerrequired

Date on which the article warranty has been computed. Pretty much going to be the same as buyDate. Provided in YYYYMMDD.

Example:20190927

transactionNumberstringrequired

Transaction number of the purchase itself. If you bought different articles with warranties in the same transaction, this number will stay the same.

Example:20220124_174650_0045160_046_203

trxNumstringrequired

Misc number which will be shown on the warranty footer.

Example:0025

warrantystringrequired

Displayed number of the warranty, this is not an unique identifier.

Example:0150475 042002501

warrantyDurationintegerrequired

Complete length of the warranty duration in months.

Example:24

warrantyIdstringrequired

Warranty unique identifier.

Example:20220124_174650_0045160_046_203_0

warrantyUntilintegerrequired

Exact date when the warranty will expire. Provided in YYYYMMDD.

Example:20210921

get/migros/customers/warranties/v1/detail/{cumulus}/{warrantyId}
 
200

List warranties

Lists the available warranties for a specific Cumulus number between two dates. The returned data is a shortened version of the detail of each warranty.

get
https://api-qual.migros.ch/migros/customers/warranties/v1/list/{cumulus}

Query Parameters

fromstring(date)

start date
If omited it defaults to “3 years and 2 months ago”.

Example:2019-03-17

tostring(date)

end date of list; if omited or empty the current date is used

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

Response

200 application/json

list of warranties

WarrantyListResponse

articleDescriptionstringrequired

Article description.

Example:MediaPadT5 10.1 WiFi s

articleNumberstringrequired

Unique article identifer. Product-ID

Example:798458800000

articlePricenumberrequired

Full article price in CHF without reductions in CHF.

Example:274.5

storeIdstringrequired

Unique store identifier. Filial-ID

Example:0150475

warrantyDurationintegerrequired

Complete length of the warranty duration in months.

Example:24

warrantyIdnumberrequired

Warranty identifier.

warrantyUntilintegerrequired

Exact date when the warranty will expire. Provided in YYYYMMDD.

Example:20210927

get/migros/customers/warranties/v1/list/{cumulus}
 
200 application/json

Augmented warranties

Lists warranties for a specific Cumulus number between two dates.

The returned data is not just the raw data from the archived warranty but is augmented/extended by looking up the product in the M-API. If the product is not found in the M-API (for whatever reason) the original data is returned.

get
https://api-qual.migros.ch/migros/customers/warranties/v1/xlist/{cumulus}

Query Parameters

fromstring(date)

start date
If omited it defaults to “yesterday one year ago”, i.e. one whole year of data is returned or analyzed.

Example:2021-03-17

tostring(date)

end date of list; if omited or empty the current date is used

langstringrequired

Target language to use for article description.

Allowed values:defrit

storeTypestring

Show only warranties issued in a store of this type. SMVM is M or MM or MMM.

Allowed values:MMMMMMSMVMMELDGMICSXX

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

Response

200 application/json

list of augmented warranties

XWarrantyListResponse

articleDescriptionstringrequired

Article description.

Example:MediaPadT5 10.1 WiFi s

articleImagestring

URL of image

Example:http://image.migros.ch/{stack}foo/bar.jpg

articleLinkstring

URL of article in shop.

Example:https://produkte.migros.ch/bellcolor-kreidestift-3-stk

articleNumberstringrequired

Unique article identifer. Product-ID.

Example:798458800000

articlePricenumberrequired

Full article price in CHF without reductions in CHF.

Example:274.95

buyDateinteger

Buy-date as YYYYMMDD

Example:20220124

manualsarray[object]

List of user manuals

Show Child Parameters
serviceLinkstring

URL to migros.service.

Example:https://migros-service.ch/foo/bar

storeIdstringrequired

Unique store identifier. Filial-ID.

Example:0150475

storeNamestring

Name of store

Example:M Gränichen

storeTypestring

Type of the store

Example:MEL

warrantyDurationintegerrequired

Complete length of the warranty duration in months.

Example:24

warrantyIdstringrequired

Warranty identifier.

Example:20220124_174650_0045160_046_203_0

warrantyUntilstringrequired

Exact date when the warranty will expire. Provided in YYYYMMDD.

Example:20210927

get/migros/customers/warranties/v1/xlist/{cumulus}
 
200 application/json

Audit

Lookup redemtion of UCBs

Check if a Cumulus number redeemed some UCBs returning details about when and where they got redeemed.

get
https://api-qual.migros.ch/migros/customers/receipts/v1/ucblookup/{cumulus}

Query Parameters

ucbstringrequired

ID of the UCB(s) to look up

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

Response

200 application/json

JSON with list of purchases.

ucblookupResponse

ucblookupResponseobject

Map of those UCBs that where redeemed by this cumulus number.

get/migros/customers/receipts/v1/ucblookup/{cumulus}
 
200 application/json