Get in-store product availability
getStoreAvailabilityRead-onlyIdempotent
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dans | Yes | DANs (dm product numbers) (1-10) | |
| storeIds | Yes | Store IDs of the physical dm stores (1-5) |