Gutschein

Mit dieser Api werden die Gutscheine ausgegeben.

Felder

Feld	Typ	Beschreibung	Beispiel
soid	integer	Gutschein ID	1
name	string	Name	Sommer-Sale 2018
description	string	Beschreibung
offer	integer	Angebot	2500
currency	string	Währung	EUR
unit	integer	Einheit (1 Prozent / 2 Absolut)	1
minOrderValue	integer	Mindestbestellwert	0
password	string	Passwort	sale2016
state	integer	Status 1-aktiv ; 2-deaktiv	1
financesAttendDiscountAbleFlag	integer	Rabattfähigkeit beachten	0
orderPositionIID	integer	Zuordnungen Position IID	501
availabilityCount	integer	Mengenverfügbarkeit, Gutscheine insgesamt	0
availabilityCountCustomer	integer	Mengenverfügbarkeit, Gutschein je Kunde	0
availabilityNote	integer	Mengenverfügbarkeit, Einschränkung beachten	0
additionalIID	integer	Zugabe-Produkt IID	10016
additionalCount	integer	Zugabenmenge	1
additionalType	integer	Typ Zugabe	0
additionalMinType	integer	Berechnungsgrundlage	0
additionalMinCount	integer	Grenzwert	ab
start	date	Zeitliche Einschränkungen Start	0000-01-01T00:00:00
end	date	Zeitliche Einschränkungen Ende	0000-01-01T00:00:00
accessUID	integer	Gilt nur für Benutzer UID	0
restrictionCategoryCID	array	Zuordnung Kategorie CID	["","21","10"]
restrictionBrandBID	array	Zuordnung Marke BID	["","1","2"]
restrictionItemIID	string	Gilt nur für Produktliste IID	1000,1001
restrictionGroupGID	array	Zuordnung Gruppe	[]
restrictionSalesGroup	array	Zuordnung Verkaufsgruppe	[]
restrictionCountryIso	array	Land	[]
shoppingcardAssignMode	string	Berechnungsgrundlage
locale	object	Sprachabhängige Texte
aid	integer	Affiliate Partner ID	0
erpID	integer
erpName	integer
erpNumber	integer
erpLastUpdate	integer		0000-01-01T00:00:00
erpCreation	integer		0000-01-01T00:00:00
archived	integer		0

Einen Gutschein auslesen

Die URL /api/commerce/voucher/[ITID] liefert einen Gutschein zurück

{
    "dataset": {
        "39887013-301b-4f06-a3ca-096b109c9e86": {
            "soid": 1,
            "name": "Sommer-Sale 2018",
            "description": "",
            "offer": 2500,
            "currency": "EUR",
            "unit": 1,
            "minOrderValue": 0,
            "password": "sale2018",
            "state": 1,
            "financesAttendDiscountAbleFlag": "0",
            "orderPositionIID": 501,
            "availabilityCount": 0,
            "availabilityCountCustomer": 0,
            "availabilityNote": 0,
            "additionalIID": 10016,
            "additionalCount": 1,
            "additionalType": 0,
            "additionalMinType": 0,
            "additionalMinCount": 40,
            "start": "0000-01-01T00:00:00",
            "end": "0000-01-01T00:00:00",
            "accessUID": 0,
            "restrictionCategoryCID": [
                "",
                "21",
                "10"
            ],
            "restrictionBrandBID": [],
            "restrictionItemIID": "",
            "restrictionGroupGID": [],
            "restrictionSalesGroup": [],
            "restrictionCompany": [],
            "restrictionCountryIso": [],
            "shoppingcardAssignMode": "",
            "locale": {
                "de": {
                    "name": "Sommer-Sale 2018" 
                },
                "en": {
                    "name": "Sommer-Sale 2018"
                },
                "fr": {
                    "name": "Sommer-Sale 2018"
                }
            },
            "affiliateID": 0,
            "erpID": "",
            "erpName": "",
            "erpNumber": "",
            "erpLastUpdate": "0000-01-01T00:00:00",
            "erpCreation": "0000-01-01T00:00:00",
            "archived": "0"
        }
    },
    "sys": {
        "pagination": {
            "total": 1,
            "currentPage": 1,
            "objectsPerPage": 20,
            "offset": 0,
            "nextOffset": null,
            "prevOffset": null,
            "pages": 1
        },
        "message": "200 OK",
        "code": 200
    }
}

Gutscheine auslesen

Die URL /api/commerce/item/voucher?page=[SEITE]&count=[ANZAHL DER OBJEKTE]&orderby=[SORTIERUNG] liefert alle Gutscheine zurück. Mit dem Pagestepper kann durch die Daten navigiert werden.

Beispiel : /api/commerce/item/voucher?page=0&count=5

{
    "dataset": {
        "66681c38-1094-4490-e416-9d431fa5ef57": {},
        "caec026c-b9a0-4ea7-af27-0b36e8c47cbd": {},
        "9f9a232a-efc4-4079-f091-035fdb8f1b4c": {},
        "1b3da6a2-994f-4060-a47d-38c12a19a416": {},
        "7555bb79-f8d0-461b-d488-008819447df2": {}
    },
    "sys": {
        "pagination": {
            "total": 47,
            "currentPage": 3,
            "objectsPerPage": 5,
            "offset": 10,
            "nextOffset": 15,
            "prevOffset": 5,
            "pages": 10
        },
        "message": "200 OK",
        "code": 200
    }
}

Gutscheine suchen

Über die URL /api/commerce/voucher/search?q=[QUERY] können Gutscheine gesucht werden. Mit dem Pagestepper kann durch die Daten navigiert werden.

Beispiel : /api/commerce/voucher/search?q=itid%3D1

{
    "dataset": {
        "66681c38-1094-4490-e416-9d431fa5ef57": {},
        "caec026c-b9a0-4ea7-af27-0b36e8c47cbd": {},
        "9f9a232a-efc4-4079-f091-035fdb8f1b4c": {},
        "1b3da6a2-994f-4060-a47d-38c12a19a416": {},
        "7555bb79-f8d0-461b-d488-008819447df2": {}
    },
    "sys": {
        "pagination": {
            "total": 47,
            "currentPage": 3,
            "objectsPerPage": 5,
            "offset": 10,
            "nextOffset": 15,
            "prevOffset": 5,
            "pages": 10
        },
        "message": "200 OK",
        "code": 200
    }
}