/api/items20

provide items of a category and related data

Parameters

(int) the category id to list items for🔗 group_id
(int) alternativly, the rubric id to list items for🔗 rubric_id
(int) alternativly, the subcategory id to list items for🔗 subgroup_id
(any value) dont include the items themselves, just their accompanying data (like units or tour limits)
(boolean) if 1, include all hidden items (which are otherwise skipped)
(int) a maximum nuber of records to be returned.
(int) scrolling offset. Use it together with max to implement result scrolling. If nothing was returned, you reached the end of the list.
(1 or 0) shuffle result
(int) if 1, utilize edge cache. use it to get fast responses. Caches are cleared at midnight, if not explicitly requested.
(int) request that images are provided as data urls. The value can be between 20 and 150, it defines the px size of the image square.
(int) if provided, the request will fail if there is no authenticated session. Use it to re-authenticate if needed.
(String) optionally define the response-format for this call. One of: compact (default) | compacts | full | fulls | json | md | html | js | openapi | yaml
(int) optionally force the API to check against the role (instead of silently not returning data). For guests or public access, the default is -1. 0 (regular customer) and above define the role for which the current session is expected to be authorized.

Response Types

Item · TourLimit

Item (v22) docs

A warehouse Item

Fields (66)
#FieldTypeDescriptionLinks
0idintInternal Id🔗 item_id
1namestringitem name
2pricedoubleitem base price
3unitstringitem base unit (plain text) (translatable)
4infotxtstringshort info text, Item teaser line
5categoryidintid of the warehouse category this item belongs to⬆ categoryid🔗 group_id
6vatdoubleitem vat percentage (0..100)
7refunddoublerefund value associated with that item (CHECKME)
8typeintItem type. 0: regular item that comes in piece, -1 regular item with a weighted unit, other ids: see item type documentation
9hiddenboolitems may be (temporarily) hidden, as such not to be part of the offering
10referencePricedoublereference price: price/referenceAmount
11thumbnailCodestringif set, a thumbnail exists. Depending on the request (parameter ?img=b64), either a data URL or a image hashCode is returned. In the latter case, the image can be fetched by BASEURL/t.px?PARAMS (see docu)
12hasLongInfobooltrue if a long info exists. Fetch it separately
13preorderPossiblebooltrue if the item can be pre ordered for a delivery later than the current selected delivery date
14infoReferenceintif > 0, where to get more information. 1: Ecoinform, 2: Datanature
15orderPeriodEnddateif set, date when the ordering period ends.
16orderPeriodStartdateif set, date when the ordering period starts.
17deliveryPeriodStartdateif set, date when the delivery period starts.
18deliveryPeriodEnddateif set, date when the delivery period ends.
19weightedbooltrue if the item is weighted (and thus, the price might change slightly)
20preOrderOnOrderStopboolaka orderStopNew. if true , the item shall be pre-ordered the following possible delivery day
21pointerstringIf the type is not 0, this is a pointer item and it points to the target with that id. What kind of target is defined by the item type (dee reference). if item type is 27 (href link), its the URL this pointer points to. For type 0 , its the unit id reference.
22specialOfferbool(aka flag2), if true, this item shall be highlighted as special offer
23searchTermsstringalternative search terms for this item
24referenceUnitstringreference unit (translatable)
25imageCodestringif set, a (big) image) exists. Depending on the request (parameter ?img=b64), either a data URL or a image hashCode is returned. In the latter case, the image can be fetched by BASEURL/b.px?PARAMS (see docu)
26packnamestringalternative internal name. For vouchers, this field transports the semi-secret voucher code.
27verbandstringThe main (organic) certification association. These are well-known codes
28originIdintreference to the geografic origin (aka Herkunft) of that item.
29isRegionalbooltrue if this item is sourced regionally
30AmountMindoubleif > 0, minimum amount of this item when ordered
31AmountMaxdoubleif > 0, maximum amount of this item when ordered
32AmountDefdoubleif > 0, default amount of this item when picked in a UI without amount selection options or as initial value when placed into the cart
33AmountStepdoubleif > 0, the increment and decrement when plus or minus buttons are used to modify the order amount
34imageCountintnumber of extra images available for this product. Add the index (1..9) to the proxy call like BASEURL/b1.px?...
35lastPricedoubleif > 0, last price of this item, set by the last price detection mechanism
36labelsint[]list of label ids that apply to this item
37hasRelatedbooltrue if this item has referenced items (transported in Object RelatedItem)
38producerIdintif > 0, reference to the producer of that item.
39hasLG5boolhas data for the label group 5 (Nutrition data). Fetch them separately if needed.
40saleLeftdoubleif -1, this item is not limited by a saleout. If 0, item was just sold out. If > 0, it tells the number of still available items (in item unit)
41certificatestringorganic monitoring certifiation code
42availablebooltrue if this item is available for purchase (aka legacy protection)
43unitsstringcleartext unit name (translatable)
44packageCodeintRefund type: 0: unset, 1: One-Way, 2: Reusable (aka Mehrweg-Pfand), 3: no refund
45euOriginstringcan be one of the three EU source labels (DOOR) PGI (1), TSG (2), PDO (0)
46alcoholCodeintAlcohol code: 0: unset, 1: Alcohol, 2: Non-Alcohol
47tradingClassstringaka Handelsklasse, german trade quality class (applicable for regular items type 0 only)
48seasonalbooltrue if this item is seasonal (not always available at fullfillment time)
49packingStationIdintreference to a packing station. A packing station may imply limits when ordering.
50weightdoubleweight of this item in kilograms
51referenceUnitFactordoubleif > 0, how to translate the packaging unit (field unit) into the reference unit (for displaying the reference price)
52maxDiscountdoublemaximum discount that can be applied for this item (<=100)
53unitHintstringhint to be displayed next to the unit string. PCG liver does only use ISO Units so eny extra hint (like '6-pack' is expected here)
54bulkPricedoublebulk price for this item. If > 0, this item has a discounted price if the buldAmount is exceeded
55bulkAmountdoublethis item has a discounted price if the buldAmount is exceeded
56bulkPriceReferencedoublereference price in reference units (bulkprice / refAmount)
57noSubscriptionbooltrue if this item is not available for subscription
58dateBorderdateThis record shows values relevant for the sessions selected delivery date. Some field may change after this date
59brandcodestringbrand shortcode of the item
60infoReferencePointersstringif enabled, shows pointers to external information (ean, ecoinform, datanature
61producerNamestringname of the producer of that item (translatable)
62saleTypeint(aka Abverkauf), there are several saleout types, see the documentation. 0: no sale, 1: regular (forever) sale
63brandNamestringname of the brand of that item (through Item/Datanature (translatable)
64partnerIdintif > 0, it is the Id of a partner that handles fulfillment
65locationHintstringLocation information in a physical store. May be used to creat creative shop ideas. (translatable)

Data (17 records)

idnamepriceunitinfotxtcategoryidvatrefundtypehiddenreferencePricethumbnailCodehasLongInfopreorderPossibleinfoReferenceorderPeriodEndorderPeriodStartdeliveryPeriodStartdeliveryPeriodEndweightedpreOrderOnOrderStoppointerspecialOffersearchTermsreferenceUnitimageCodepacknameverbandoriginIdisRegionalAmountMinAmountMaxAmountDefAmountStepimageCountlastPricelabelshasRelatedproducerIdhasLG5saleLeftcertificateavailableunitspackageCodeeuOriginalcoholCodetradingClassseasonalpackingStationIdweightreferenceUnitFactormaxDiscountunitHintbulkPricebulkAmountbulkPriceReferencenoSubscriptiondateBorderbrandcodeinfoReferencePointersproducerNamesaleTypebrandNamepartnerIdlocationHint
4644 →create2 →item1Delikatess Bratwürstchen5.3Stück180g19 →items21 →items22 →items23 →items20 ⬆7.00.00false29.4449e561c96falsefalse12027-11-221899-12-302022-08-012027-11-22falsefalse3false1kg9e551c94Delikatess Bratwürstchen100% Bioanbau37false0.00.01.00.000.0[]false235false-1.0DE-ÖKO-001trueStück00false20.180.18100.00.00.00.0false2022-08-01ÖKLean:4031829230244, ecoinform:null, datanature:47acfc9b-779a-4c2f-8f76-1b4ad5df675dÖKOLAND0ÖKOLAND0
4500 →create2 →item1Haussalami Mini ca.250g5.2195Stück19 →items21 →items22 →items23 →items20 ⬆7.00.00false36.59c101c98falsefalse22027-11-221899-12-302025-04-162027-11-22truetrue3falsekg9c0a1c92Haussalami Mini ca.250g0false0.00.01.00.000.0[]false631true-1.0DE-ÖKO-005trueStück00false20.110.143100.00.00.00.0false2026-02-28TBMean:null, ecoinform:null, datanature:42b09436-a4d9-4cdc-b451-7e0ea71fe259Tagwerk0Tartufi di Fassia0
4578 →create2 →item1Putenlyoner mini 190g6.55Packung19 →items21 →items22 →items23 →items20 ⬆7.00.00false34.474bfaa10dcfalsefalse12027-11-221899-12-302024-02-102027-11-22falsetrue13false1kgce9510f0Putenlyoner mini 190g100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005truePackung00IIfalse20.20.19100.00.00.00.0false2026-02-28TBMean:270000300200, ecoinform:null, datanature:9882a11a-88da-4e61-89d6-054c06b5dd7fTagwerk0Tartufi di Fassia0
4533 →create2 →item1Delikatessleberwurst 145g4.3StückTAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false29.655a9081d37falsefalse12027-11-221899-12-302022-11-012027-11-22falsetrue3false1kga90a1d3bDelikatessleberwurst 145g100% Bioanbau64false1.00.01.01.000.0[]false524true-1.0DE-ÖKO-005trueStück30IIfalse21.00.145100.00.00.00.0false2026-02-28TBMean:4260431730914, ecoinform:null, datanature:3d6ec019-3727-482b-bcb8-4b69c3469f42Tagwerk0Tartufi di Fassia0
4508 →create2 →item1Gelbwurst mini ca. 190g5.15Stück TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false27.1057ace1c43falsefalse12027-11-221899-12-302024-02-102027-11-22falsetrue3false1kg975c1c7fGelbwurst mini ca. 190g100% Bioanbau64false0.50.01.00.100.0[]false524true-1.0DE-ÖKO-005trueStück00IIfalse21.00.19100.00.00.00.0false2026-02-28TBMean:27000030000, ecoinform:null, datanature:5c6c8d7b-b99f-43e8-a1e6-30a695f53759Tagwerk0Tartufi di Fassia0
4510 →create2 →item1Gelbwurst mit Petersilie mini5.15Stück190g TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false27.105a75e1cb5falsefalse12027-11-221899-12-302022-11-012027-11-22falsetrue3false1kga7631cb6Gelbwurst mit Petersilie mini100% Bioanbau64false0.50.01.00.100.0[]false524false-1.0DE-ÖKO-005trueStück30IIfalse20.190.19100.00.00.00.0false2026-02-28TBMean:27000030000, ecoinform:null, datanature:ecdaf71f-2f1e-4eea-8d32-8f72c91e15dcTagwerk0Tartufi di Fassia0
4535 →create2 →item1Kräuterleberwurst ca. 150g4.5StückTagwerk19 →items21 →items22 →items23 →items20 ⬆7.00.00false39.139bc01cc0falsefalse22027-11-221899-12-302023-03-242027-11-22falsetrue3false1kg9bc51cc5Kräuterleberwurst ca. 150g100% Bioanbau64false1.00.01.01.000.0[]false524true-1.0DE-ÖKO-005trueStück00IIfalse20.1450.115100.00.00.00.0false2026-02-28TBMean:4260431730938, ecoinform:null, datanature:c0ba281a-dbe9-429a-9025-43452c30fda5Tagwerk0Tartufi di Fassia0
4560 →create2 →item1Leberkäs Scheibe ca. 180g4.7StückTAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false26.111a0691ca9falsefalse12027-11-221899-12-302022-11-012027-11-22falsetrue3false1kga0691ca9Leberkäs Scheibe ca. 180g100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005trueStück30IIfalse20.180.18100.00.00.00.0false2026-02-28TBMean:2700003030036, ecoinform:null, datanature:a224b79c-b669-448d-881e-d054220e1d5eTagwerk0Tartufi di Fassia0
4567 →create2 →item1Lyoner 200g5.15StückBrühwurst geräuchert, Tagwerk19 →items21 →items22 →items23 →items20 ⬆7.00.00false25.759cef1cd4falsefalse12027-11-221899-12-302023-07-082027-11-22falsetrue3false1kg9cec1cd0Lyoner 200g100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005trueStück30IIfalse21.00.2100.00.00.00.0false2026-02-28TBMean:4260431730495, ecoinform:null, datanature:550a8f71-9bef-45cf-bfd0-c68d148a9d27Tagwerk0Tartufi di Fassia0
4531 →create2 →item1Mettwurst fein 145g3.75StückTAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false25.8629f2b1cd9falsefalse22027-11-221899-12-302022-11-012027-11-22falsetrue3false1kg9f211cd2Mettwurst fein 145g100% Bioanbau64false1.00.01.01.000.0[]false524false-1.0DE-ÖKO-005trueStück00IIfalse20.150.145100.00.00.00.0false2026-02-28TBMean:4260431730969, ecoinform:null, datanature:bb7e2e6f-bc0c-4111-bdf3-ccdbbb083c5fTagwerk0Tartufi di Fassia0
4522 →create2 →item1Pfefferknacker 2 Stück3.625Packung scharf würzig, TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false36.25d0fc1112falsefalse12027-11-221899-12-302022-11-012027-11-22truetrue13falsekgcefc10fcPfefferknacker 2 Stück100% Bioanbau64false1.00.01.01.000.0[]false524false-1.0DE-ÖKO-005truePackung30Ifalse21.00.1100.00.00.00.0false2026-02-28TBMean:2700003000089, ecoinform:null, datanature:Tagwerk0Tartufi di Fassia0
4524 →create2 →item1Polnische 2 Stück5.8149Stück100g TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false31.95falsefalse02027-11-221899-12-302022-11-012027-11-22truetrue3falsekgPolnische 2 Stück100% Bioanbau64false1.00.01.01.000.0[]false524false-1.0DE-ÖKO-005trueStück00IIfalse21.00.182100.00.00.00.0false2026-02-28TBMean:2746067, ecoinform:null, datanature:Tagwerk0Tartufi di Fassia0
4573 →create2 →item1Putenwiener 4St. SB 180 g6.55PackungTagwerk Biometzgerei19 →items21 →items22 →items23 →items20 ⬆7.00.00false36.3898c001c35falsefalse12027-11-221899-12-302024-02-102027-11-22falsetrue13false1kg8c001c35Putenwiener 4St. SB 180 g100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005truePackung30IIfalse20.180.18100.00.00.00.0false2026-02-28TBMean:4260431730204, ecoinform:null, datanature:b5f01aec-659a-4cad-9d7e-482af7b71754Tagwerk0Tartufi di Fassia0
4566 →create2 →item1Regensburger 2 Stück vac.5.15Packungca. 180g, Brühwurst, TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false30.2948e471c40falsefalse12027-11-221899-12-302026-02-282027-11-22falsetrue13false1kg8e411c3aRegensburger 2 Stück vac.100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005truePackung30IIfalse20.170.17100.00.00.00.0false2026-02-28TBMean:4260431730211, ecoinform:null, datanature:07ee2ab8-2565-428f-9614-2d250c80d43fTagwerk0Tartufi di Fassia0
4485 →create2 →item1Salamihappen44.2kg19 →items21 →items22 →items23 →items20 ⬆7.00.0-1false0.0c01210e8falsefalse12027-11-221899-12-302026-02-282027-11-22truetrue1falsecef210faSalamihappenDemeter37false0.49950.01.00.100.0[852, 889, 896, 918, 914, 611]false910true-1.0DE-ÖKO-005truekg30Ifalse20.50.0100.00.00.00.0false2026-02-28DMLean:2700003100101, ecoinform:null, datanature:DML0Demeter Landbauerzeugnisse0
4551 →create2 →item1Schweinsbratwürstl 4 Stück5.35Packungca. 180g, TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false29.72293621c6cfalsefalse12027-11-221899-12-302022-11-012027-11-22falsetrue13false1kg93671c71Schweinsbratwürstl 4 Stück100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005truePackung30IIfalse20.180.18100.00.00.00.0false2026-02-28TBMean:4260431730297, ecoinform:null, datanature:13ae7750-c471-492c-943d-78f492fc3a54Tagwerk0Tartufi di Fassia0
4565 →create2 →item1Wiener 4 Stück vac.5.15PackungBrühwurst geräuchert, TAGWERK19 →items21 →items22 →items23 →items20 ⬆7.00.00false25.75a4e61d24falsefalse12027-11-221899-12-302022-11-012027-11-22falsetrue13false1kga4e81d27Wiener 4 Stück vac.100% Bioanbau64false0.00.01.00.000.0[]false524false-1.0DE-ÖKO-005truePackung30IIfalse20.180.2100.00.00.00.0false2026-02-28TBMean:4260431730235, ecoinform:null, datanature:6b17749c-6048-464d-935b-1f361454b208Tagwerk0Tartufi di Fassia0

TourLimit (v2) docs

Item order limits applicable for individual tours

Fields (3)
#FieldTypeDescription
0iidintitem id reference. if > 0, its a item, if < 0 defines a item group.
1tidinttour id reference
2orderStopHourintorderstop offset in hours. 0: no meaning, no offset, <0: extra hours to be added to the orders stop hour, 1: this item is not to be offered for this tour at all

Data (17 records)

iidtidorderStopHour
464426-189
450026-189
457826-189
453326-189
450826-189
451026-189
453526-189
456026-189
456726-189
453126-189
452226-189
452426-189
457326-189
456626-189
448526-189
455126-189
456526-189