Delivery modes and methods

Many products/offers can be fulfilled by sending tickets or vouchers as QR codes and PDF, but some require physical goods to reach to customer like Food & Drink and Clothing but as well Skipasses.

Products which require shipping : Products which require shipping do not necessarily need to be shipped, if the Seller (Origin.Source) offers a pickup place or store, they can get picked up as well.

If a shipping is required the requirements for the customer and the address is changing. This is known only during the checkout and therefore the definition for it is added to the order object during the pre-fulfillment (see CustomerFields below)

Delivery modes and methods¶

Deliver mode	Icon	Delivery method	Objects in profile
none (default)	none	none
digital		- e-ticket	a Ticket object is created
activation		examples: - terminal - smart skipass - ...	none
pickup		examples: - ticket office - different pickup points	none
shipping		examples: - swisspass examples: - smart skipass examples: - terminal	A ParcelDelivery object is created in the Order

Fulfillment options¶

Fulfillment options allow manage which format of tickets will be provided in the result of fulfilment. Tickets can be generated in several formats using the predefined pdf or html templates based on product configurations.

Example of the order item request

{
    "orderedItem": {
        "fulfillmentOptions": {
            "tokenType": [ "pdf", "html" ]
        }
    }
}

When fulfillment options are not provided in the order item request¶

A QR code is always generated, even when no ticket tokens are defined in the fulfillment options.

Exception

Some providers generate PDF tickets by default; in that case, a PDF ticket will be saved in the ticket object details.

When fulfillment options are provided and contain specific ticket token¶

Supported ticket tokens: - pdf - img - html

If request contains fulfillment options with specific ticket token, then ticket will be generated in the requested formats and saved in ticket objects.

When fulfillment options are provided but don't contain specific ticket token¶

If token which present in the request is not supported by the product provider, then this fulfillment option will be ignored and ticket will be generated in QR code format by default.