List of Voucher-Orders

GET https://api.e-guma.ch/v1/vouchers/orders.json?apikey={api-key}

Parameters

api-key
required
updated_at_afterShow orders modified at or after date (format: 2019-06-04T23:15:14).
updated_at_beforeShow orders modified before date (format: 2019-07-04T23:15:14).

Return

idThe ID of the order.
created_at The autogenerated date and time (ISO 8601 format) when the order was created. E.g. 2019-06-03T19:16:43
updated_at The date and time (ISO 8601 format) when the order was last modified.

This value changes when one of the following events happens:
- An order line (voucher) gets cancelled

- An order gets cancelled

- A value of the customer object gets updated

When an order is created then updated_at has the same value as created_at.
order_number The order number
status completed or cancelled
currency The three-letter code (ISO 4217 format) for the currency. Each shop only supports one currency.
language Language as a two-letter code (ISO 639-1).
location web or local
discount_in_cents The total discounts applied to the price of the order.
grand_total_in_cents The sum of all line item prices, shipping fee and added discounts.
customer Customer, see customer object below for details.
order_lines List of order lines, see order line object below for details.
payments List of payments, see payment object below for details.

Customer object

idThe ID of the customer.
titleMr, Mrs or Company
first_nameFirst name
last_nameLast name
companyCompany name
streetStreet
zipZip code
cityCity
countryCountry as two-letter code (ISO 3166-1 alpha-2)
emailEmail address
accepts_marketingWhether the customer consented (Double Opt-in) to receive email newsletters.
double_opt_in_confirmed_atIf the customer consented to receive the email newsletter then the date and time (ISO 8601 format) of the Double Opt-in will be returned. Otherwise this value will be null.
phonePhone number

Order line object

product_idThe ID of the voucher product.
nameThe name of the voucher (e.g. Candle Light Dinner).
unit_price_in_centsUnit Price
quantityQuantity
total_price_in_centsquantity x unit_price_in_cents

Payment object

payment_idThe ID of the payment method.
nameThe name of the payment method. E.g. Credit Card
amount_in_centsAmount
is_complimentaryIndicates if a payment is complimentary.

Example

GET https://api.e-guma.ch/v1/vouchers/orders.json?updated_at_after=2019-07-29T00:00:00&apikey=5bb668e394f2811f3ca4a9db
[
  {
    "id": "c004033d-ded1-4b74-958f-76ef47e747d6",
    "created_at": "2019-07-29T14:41:05",
    "updated_at": "2019-07-29T14:41:05",
    "order_number": "GI10023",
    "status": "completed",
    "currency": "CHF",
    "language": "de",
    "location": "web",
    "discount_in_cents": 0,
    "grand_total_in_cents": 30000,
    "customer": {
      "id": "4c3150ad-7117-4516-aa7c-2ca6d5c7a597",
      "title": "Mr",
      "first_name": "Christoph",
      "last_name": "Thomet",
      "company": "Idea Creation GmbH",
      "street": "Walchestrasse 15",
      "zip": "8006",
      "city": "Zürich",
      "country": "CH",
      "email": "[email protected]",
      "accepts_marketing": true,
      "double_opt_in_confirmed_at": "2019-07-29T12:13:53",
      "phone": "044 500 54 00"
    },
    "order_lines": [
      {
        "product_id": "13a7b4a7-2256-4f23-b690-2d562d98e171",
        "name": "Wertgutschein",
        "unit_price_in_cents": 10000,
        "quantity": 3,
        "total_price_in_cents": 30000
      }
    ],
    "payments": [
      {
        "payment_id": "1",
        "name": "Postkarte / Kreditkarte",
        "amount_in_cents": 30000,
        "is_complimentary": false
      }
    ]
  },
  {
    "id": "7a7f2b66-feab-43fd-b579-d284af14173e",
    "created_at": "2019-07-29T14:44:41",
    "updated_at": "2019-07-29T14:45:44",
    "order_number": "GI10024",
    "status": "completed",
    "currency": "CHF",
    "language": "de",
    "location": "local",
    "discount_in_cents": 0,
    "grand_total_in_cents": 50000,
    "customer": {
      "id": "2f1744d6-1c43-4620-bd74-4c6983b3cf88",
      "title": "Mr",
      "first_name": "Hans",
      "last_name": "Muster",
      "company": "",
      "street": "Bahnhofstrasse 99",
      "zip": "8006",
      "city": "Zürich",
      "country": "CH",
      "email": "",
      "accepts_marketing": false,
      "double_opt_in_confirmed_at": null,
      "phone": ""
    },
    "order_lines": [
      {
        "product_id": "57186abe-7cd6-489f-8434-1c8acf3d3f10",
        "name": "Individueller Gutschein",
        "unit_price_in_cents": 50000,
        "quantity": 1,
        "total_price_in_cents": 50000
      }
    ],
    "payments": [
      {
        "payment_id": "2",
        "name": "Rechnung",
        "amount_in_cents": 50000,
        "is_complimentary": false
      }
    ]
  }
]