Skip to content

Create order

The only way to create an order is to use place order endpoint.

These are possible statuses for the new created order:

  • Status = New does not make any update and some data validation.
  • Status = Checkout validates the order and do order update (set order item numbers, getting product information from infocenter and apply offers if it's needed)
  • Status = Placed validates the order, gets offers if it is needed, and if possible move it to the placed status and the order is ready to get paid

The response contains the updated order object (product information, prices) and the validation errors if there are any.

Place empty order

Sometimes it is needed to create empty order and then add order items to it.

{ }
POST {{ marketUrl }}/orders
{
    "order": {
        "orderNumber": "{{ orderId }}",
        "orderDate": "2021-10-11T07:20:54.180294-06:00",
        "customer": {
            "profileId": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
            "additionalName": "Remark",
            "address": {
                "addressCountry": "CH",
                "addressLocality": "Werdenberg",
                "addressRegion": "SG",
                "postalCode": "9472",
                "streetAddress": "Dorf 1"
            },
            "email": "harry.phoenix@test.in",
            "familyName": "Phoenix",
            "gender": "Male",
            "givenName": "Harry",
            "nationality": "CH",
            "birthDate": "2000-12-07",
            "displayName": "Harry Phoenix",
            "isGuest": "True",
            "passport": "ccxxx",
            "maritalStatus": "Single",
            "mobilePhone": "079 365 45 88",
            "salutation": "Mr",
            "preferredLanguage": "de",
            "hasProfileImage": false,
            "dataGovernance": {
                "origin": [
                    {
                        "datasource": "some_datasource",
                        "created": "2021-09-27T06:15:00.6913204-06:00",
                        "lastModified": "2021-10-10T02:43:41.8015455-06:00",
                        "provider": {
                            "acronym": "some_acronym"
                        },
                        "source": {
                            "acronym": "some_acronym"
                        },
                        "author": {
                            "identifier": "a23a4be8-8f4f-4a53-ae29-917349c11df4"
                        }
                    }
                ]
            },
            "createdDateTime": "2021-09-27T06:15:00.6924683-06:00",
            "lastModified": "2021-10-10T02:43:41.8021602-06:00",
            "lastModifiedBy": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
            "createdBySubscription": "some_subscription",
            "lastModifiedBySubscription": "some_subscription"
        },
        "orderStatus": "New",
        "priceCurrency": "CHF",
        "orderedItem": [],
        "term": [],
        "partnerAcronym": "ds",
        "profileId": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
        "@id": "{{ marketUrl }}/orders/{{ orderId }}",
        "dataGovernance": {
            "origin": [
                {
                    "datasource": "some_datasource",
                    "created": "2021-09-27T06:15:00.6913204-06:00",
                    "lastModified": "2021-10-10T02:43:41.8015455-06:00",
                    "provider": {
                        "acronym": "some_acronym"
                    },
                    "source": {
                        "acronym": "some_acronym"
                    },
                    "author": {
                        "identifier": "a23a4be8-8f4f-4a53-ae29-917349c11df4"
                    }
                }
            ]
        },
        "createdDateTime": "2021-10-11T07:20:54.5296789-06:00",
        "lastModified": "2021-10-11T07:20:54.5296712-06:00",
        "lastModifiedBy": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
        "createdBySubscription": "some_subscription",
        "lastModifiedBySubscription": "some_subscription"
    },
    "validationMessages": []
}

Place order with product configurations

To create an order with an orderItem using product configuration it is necessary to declare product configuration for each orderItem.

{  
    "orderStatus": "Placed",
    "priceCurrency": "CHF",
    "orderedItem": [
        {
        "orderQuantity": 1,
        "orderedItem": {
            "product": {
                "identifier": "nova_zurichcard24"
                },
                "traveler": [
                {
                    "givenName": "Alex",
                    "familyName": "Alex",
                    "birthDate": "2014-09-14"
                }
                ],
                "validFrom": "2021-10-19"
            }
        }
    ]
}
POST {{ marketUrl }}/orders
{
    "order": {
        "orderNumber": "{{ orderId }}",
        "orderDate": "2021-10-11T13:49:21.7692814+00:00",
        "customer": {
            "profileId": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
            "additionalName": "Remark",
            "address": {
                "addressCountry": "CH",
                "addressLocality": "Werdenberg",
                "addressRegion": "SG",
                "postalCode": "9472",
                "streetAddress": "Dorf 1"
            },
            "email": "harry.phoenix@test.in",
            "familyName": "Phoenix",
            "gender": "Male",
            "givenName": "Harry",
            "nationality": "CH",
            "birthDate": "2000-12-07",
            "displayName": "Harry Phoenix",
            "isGuest": "True",
            "passport": "ccxxx",
            "maritalStatus": "Single",
            "mobilePhone": "079 365 45 88",
            "salutation": "Mr",
            "preferredLanguage": "de",
            "hasProfileImage": false,
            "dataGovernance": {
                "origin": [
                    {
                        "datasource": "some_datasource",
                        "created": "2021-09-27T06:15:00.6913204-06:00",
                        "lastModified": "2021-10-10T02:43:41.8015455-06:00",
                        "provider": {
                            "acronym": "some_acronym"
                        },
                        "source": {
                            "acronym": "some_acronym"
                        },
                        "author": {
                            "identifier": "a23a4be8-8f4f-4a53-ae29-917349c11df4"
                        }
                    }
                ]
            },
            "createdDateTime": "2021-09-27T06:15:00.6924683-06:00",
            "lastModified": "2021-10-10T02:43:41.8021602-06:00",
            "lastModifiedBy": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
            "createdBySubscription": "some_subscription",
            "lastModifiedBySubscription": "some_subscription"
        },
        "orderStatus": "Placed",
        "priceCurrency": "CHF",
        "totalAmount": 19.0,
        "totalAmountCHF": 19.0,
        "totalTaxCHF": 1.463,
        "language": "en",
        "orderedItem": [
            {
                "orderItemNumber": "{{ orderId }}-1",
                "orderItemStatus": "Placed",
                "orderQuantity": 1,
                "orderedItem": {
                    "product": {
                        "identifier": "nova_zurichcard24",
                        "productIdentifier": "nova_zurichcard",
                        "sku": "895",
                        "name": "ZVV Zürich Card, ZVV Zürich Card 24 hours",
                        "dataGovernance": {
                            "provider": {
                                "acronym": "sbb"
                            },
                            "term": {
                                "code": "ZHT-AGB|ZHT-DPP"
                            },
                            "source": {}
                        },
                        "priceList": [
                            {
                                "priceCHF": 19.0,
                                "maxAllowedAge": 15,
                                "minAllowedAge": 5
                            },
                            {
                                "priceCHF": 27.0,
                                "maxAllowedAge": 2500,
                                "minAllowedAge": 15
                            }
                        ],
                        "taxRate": 0.077
                    },
                    "validFrom": "2021-10-19T00:00:00+00:00",
                    "traveler": [
                        {
                            "priceCHF": 19.0,
                            "identifier": "f6b7264c-70ca-522f-5bfc-d8382e2443f8",
                            "givenName": "Alex",
                            "familyName": "Alex",
                            "birthDate": "2014-09-14T00:00:00"
                        }
                    ]
                },
                "orderDelivery": "e-ticket",
                "amount": 19.0,
                "amountCHF": 19.0,
                "taxRate": 1.463,
                "taxCHF": 1.463,
                "ticket": [],
                "offerBundleId": "d4702201-bac1-4f54-989d-a32ddfb70250"
            }
        ],
        "term": [
            {
                "termCode": "ZHT-AGB|ZHT-DPP",
                "accepted": false,
                "acceptedDate": "2021-10-11T13:49:26.4425621+00:00",
                "termVersions": [
                    {
                        "@id": "{{ infoUrl }}/termversions/ZHT-AGB-2.0",
                        "code": "ZHT-AGB-2.0",
                        "name": "Allgemeine Geschäftsbedingungen von Zürich Tourismus",
                        "partnerName": "Zurich Tourism",
                        "termDocument": "https://www.zuerich.com/gtc",
                        "validFrom": "2018-08-29T00:00:00+00:00",
                        "termCode": "ZHT-AGB"
                    },
                    {
                        "@id": "{{ infoUrl }}/termversions/ZHT-DPP-2019-10-28",
                        "code": "ZHT-DPP-2019-10-28",
                        "name": "Datenschutzerklärung von Zürich Tourismus",
                        "partnerName": "Zurich Tourism",
                        "termDocument": "https://www.zuerich.com/datenschutz",
                        "validFrom": "2019-10-28T00:00:00+00:00",
                        "termCode": "ZHT-DPP"
                    }
                ]
            }
        ],
        "partnerAcronym": "ds",
        "profileId": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
        "@id": "{{ marketUrl }}/api/orders/{{ orderId }}",
        "dataGovernance": {
            "origin": [
                {
                    "datasource": "some_datasource",
                    "created": "2021-09-27T06:15:00.6913204-06:00",
                    "lastModified": "2021-10-10T02:43:41.8015455-06:00",
                    "provider": {
                        "acronym": "some_acronym"
                    },
                    "source": {
                        "acronym": "some_acronym"
                    },
                    "author": {
                        "identifier": "a23a4be8-8f4f-4a53-ae29-917349c11df4"
                    }
                }
            ]
        },
        "createdDateTime": "2021-10-11T13:49:21.6640121+00:00",
        "lastModified": "2021-10-11T13:49:31.2156037+00:00",
        "lastModifiedBy": "a23a4be8-8f4f-4a53-ae29-917349c11df4",
        "createdBySubscription": "some_subscription",
        "lastModifiedBySubscription": "some_subscription"
    },
    "validationMessages": []
}