getStoreAvailability

de.dm.mcp/dm-drogerie-markt · Verify this server

Check whether one or more dm-drogeriemarkt products are available in one or more specific stores right now. USE WHEN: you need to know if one or more products can currently be bought in one or more particular physical stores. INPUT: one to five storeIds and one to ten DANs (dm product numbers). OUTPUT: for each requested DAN, whether it was found and a status per requested storeId - VERFUEGBAR (available, includes current stockLevel), NICHT_VERFUEGBAR (not available in this store right now), NUR_ONLINE (this product is not carried in ANY dm store, not just this one), PRODUKT_UNBEKANNT (DAN not found), or STORE_UNBEKANNT (storeId does not exist in our system). IMPORTANT: NUR_ONLINE means the product itself is never sold in physical dm stores - it will be the same result for every store. Do not check other or nearby stores for that product; tell the customer it is online-only right away. IMPORTANT: storeIds MUST come from the findNearbyStores tool - call it first to resolve the storeId(s) for a location. Never invent, guess, or otherwise make up a storeId yourself; a made-up storeId will come back as STORE_UNBEKANNT instead of a real availability answer. IMPORTANT: if a customer asks about availability for several products, pass ALL of their DANs (up to 10) into this single call. Never assume, infer, or extrapolate the availability of a product you have not included in a call and gotten a result for - not even from a similar or already-checked product, and not even for "usually available" items. When reporting back, state the result for every single product individually (e.g. one line per product) - never collapse multiple products into one summary statement such as "all of them are available". TIP: if a product's result is NUR_ONLINE, or it is NICHT_VERFUEGBAR and you already know from an earlier product lookup that it is available online, suggest buying it online instead and include a link to the product page if you have one. NOT FOR: click & collect / express pickup or same-day delivery eligibility (not covered by this tool), or repeatedly polling a store's stock over time. ERRORS: validation error if any DAN is invalid, dans is empty, more than 10 dans are given, storeIds is empty, or more than 5 storeIds are given.