Merchandise Services

A MerchandiseService is a booked instance of a merchandise product.

GET: Get a Merchandise Service

POST: Create an Merchandise Service

PATCH: Update an Merchandise Service

Fields

Name

Type

Description

id read-only

String

href read-only

Field

name read-only

String

The name of this service.

status

String

The current status of the service:

  • Option: The service is being held on option until the option_expiry_date. No deposit or payment is required to hold an option. An Option service can be Expired or Confirmed.

  • On Request: The service has been requested by the client, but the request has not been sent to the local office. All departures with availability status REQUEST_SPACE can not be put on Option, but must be requested. Full payment is required. An On Request service can be Expired with no cancellation fees applied.

  • Request Confirmation: The service has been requested by the client, and the request has been sent by G Adventures to the local office. A Request Confirmation service can be Cancelled with cancellation fees applied.

  • Confirmed: The service is confirmed. Deposit is always required to confirm, and full payment will be required for a departure where FULL_PAYMENT_REQUIRED_TO_BOOK is present in the flags field. A Confirmed service can be Cancelled with cancellation fees applied.

  • Waitlisted: The service is in a waitlist queue. A cancellation on the product will cause the service to automatically be moved to Option. Only product with availability status WAIT_LIST can be Waitlisted. A Waitlisted service can be Cancelled with no cancellation fees applied.

  • Expired: The service is expired. An Option or On Request service is Expired at midnight EST when it reaches its option_expiry_date. A Waitlisted service can be Expired at any time, but will automatically be Expired when a departure reaches availability status REQUEST_SPACE. No cancellation fees will be applied.

  • Request Cancellation: The service has been requested to be Cancelled. Cancellation fees will be applied when it is Cancelld by G Adventures staff (if applicable).

  • Cancelled: The service is cancelled. A Request Confirmation or Confirmed service can be cancelled with cancellation fees applied.

Active service status transitions:

  • Option –> Confirmed/Expired

  • On Request –> Request Confirmation/Expired

  • Request Confirmation –> Request Cancellation

  • Confirmed –> Request Cancellation

  • Waitlisted –> Expired

status_transitions read-only

List

A list of status values to which this service can transition.

type read-only

String

The type of this resource.

sub_type read-only

String

A brief description of this service type.

start_date read-only

Date

The start date of this service.

finish_date read-only

Date

The finish date of this service.

customers

Field

The customers on this service.

  • id read-only

String

  • href read-only

Field

  • name

Nested Object

    • legal_first_name required

String

Legal first name as it appears on a passport.

    • legal_middle_name

String

Legal middle name as it appears on a passport.

    • legal_last_name required

String

Legal last name as it appears on a passport.

    • common_name

String

The name this person likes to be called if different from their legal name.

    • title required

String

The title. Valid values are: Mr, Mrs, Ms, and Miss

date_created read-only

Datetime

The date/time this service was created, in the standard Dates & Times.

date_confirmed read-only

Datetime

The date/time this service had its service status set to Confirmed, in the standard Dates & Times.

date_cancelled read-only

Datetime

The date/time this service had its service status set to Cancelled, in the standard Dates & Times.

option_expiry_date read-only

Datetime

The date/time when an Option service status will automatically be set to Expired, in the standard Dates & Times.

purchase_price read-only

Decimal

The currency-specific purchase price this service was Confirmed at, in the standard Currencies & Prices. The price reflected includes any promotions applied. The price is not locked until the service has its service status set to Confirmed (i.e. the price could change when the service status is on Option).

commission read-only

Decimal

The currency-specific commission amount that the booking agent will receive for this service, in the standard Currencies & Prices.

applied_promotion

Nested Object

The promotion applied to this service

  • id read-only

String

  • href read-only

Field

  • name

String

The name of the promotion used.

  • promotion_code

String

A unique code for this promotion.

  • discount_amount

Decimal

The currency-specific amount that has been discounted from the purchase_price. Add the discount_amount and purchase_price to see the original non-discounted price.

  • commission_rate

Integer

The commission rate for this promotion.

  • terms_and_conditions

String

The promotion applied to this service.

flags read-only

List

A list of codes that, when present, require special considerations for a booked service.

The list of departure service flags related to the current status of a request to hike the Inca Trail, or the option booked for services on these special departures:

Service Status Flags

  • SUSPENDED: This departure service has been suspended due to mitigating circumstances out of G Adventures’ control and will not be departing.

Inca Trail Flags

  • ON_INCA_TRAIL: Inca Trail permits have been obtained for all travellers on this service.

  • REQUESTING_INCA_TRAIL: A request to hike the Inca Trail has been submitted. The permits have not yet been obtained for travellers on this service.

  • ON_LARES_TREK: All travellers on this service will be hiking the Lares Trek as the Inca Trail is not available.

  • CUZCO_STAY: All travellers on this service will stay in Cuzco, as either they have chosen this option or the Inca Trail permits are not available for this departure.

  • INCA_TRAIL_UNKNOWN: A request to the local office has been made to confirm availability and additional local intricacies. This is an intermediary state which can occur before REQUESTING_INCA_TRAIL and any of the other states.

booking read-only

Reference Object

A reference to the associated booking.

documents read-only

Field

  • id read-only

String

  • href read-only

Field

  • date_created required

Datetime

The time when the resource was created, in the standard Dates & Times.

  • type read-only

String

The document type, currently: INVOICE, ATOL_CERTIFICATE, VOUCHER.

  • audience read-only

String

The intended audience of this document. Either AGENT or CUSTOMER.

  • booking read-only

Reference Object

The related booking resource.

  • mime_type read-only

String

The Internet media type.

declined_reason read-only

Reference Object

The related declined reason resource.

product read-only

Reference Object

A reference to the merchandise itself.

associated_services

List

requirements read-only

Nested Object

A list of requirements associated with the merchandise service. This is similar to the same set referenced on a booking, but scoped to the single service.

size

String

The size of the merchandise being sold.

Get a Merchandise Service

GET /merchandise_services/(string: service_id)/

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
"applied_promotion": null,
"associated_services": [
    {
        "href": "https://rest.gadventures.com/departure_services/2734310",
        "id": "2734310"
    }
],
"booking": {
    "href": "https://rest.gadventures.com/bookings/1293604",
    "id": "1293604"
},
"commission": "0.00",
"customers": [
    {
        "href": "https://rest.gadventures.com/customers/9089767",
        "id": "9089767",
        "name": {
            "common_name": null,
            "legal_first_name": "Johnny",
            "legal_last_name": "Five",
            "legal_middle_name": null,
            "title": "Mr"
        }
    }
],
"date_cancelled": null,
"date_confirmed": "2018-07-26T16:36:44Z",
"date_created": "2018-07-24T09:06:34Z",
"declined_reason": null,
"documents": [],
"finish_date": "2019-07-07",
"flags": [],
"href": "https://rest.gadventures.com/activity_services/2734311",
"id": "2734311",
"name": "Expedition Parka",
"option_expiry_date": null,
"product": {
    "href": "https://rest.gadventures.com/merchandise/134597",
    "id": "134597"
},
"purchase_price": "0.00",
"size": "[{'id': 3672452, 'size': ''}]",
"start_date": "2019-07-07",
"status": "Confirmed",
"status_transitions": [
    "Request Cancellation"
],
"sub_type": "Product",
"type": "activity_services"
}

Create an Merchandise Service

POST /merchandise_services/

Example request:

POST /merchandise_services/ HTTP/1.1
Host: rest.gadventures.com
Accept: application/json
Content-Type:application/json

{
    "customers": [
      {
        "id":"9089767",
        "size":"L",
      },
    ],
    "booking": {
      "id": "1293604",
    },
    "product": {
      "id": "134597",
    },
}

Example response:

A successful response returns the same data as a GET on this resource.

Update an Merchandise Service

One can only update the customer’s jacket size and the status of the order.

PATCH /merchandise_services/(string: service_id)/

Example request:

PATCH /merchandise_services/1161864/ HTTP/1.1
Host: rest.gadventures.com
Accept: application/json
Content-Type: application/json

{
    "customers": [
    {
        "id": 9672452,
        "size": "XL"
    }
    ],
    "status": "Cancelled"
}

A successful response returns the same data as a GET on this resource.