Shipments / Update
Name | Shipments Update |
|---|---|
Description | Update a shipment for an existing order |
Type | PUT |
URL | /v9/shipments/:id |
API|User |
Long Description
Update a shipment for an existing order. The JSON body of the request will vary depending on the what is being done and if it is the seller or the buyer doing it.
NOTE: Despite this being a PUT the original shipment will be deleted and a new shipment with a new ID will be returned as the response body.
SELLER: Change a Shipment to Transfer (TMMobile or TMMobileLink or FlashSeats) or Eticket
Sellers may change any order to either TMMobile or FlashSeats.
Name | Description | Type | Required |
|---|---|---|---|
| Defines how the ticket will be transferred. Must be one of:
Previously | string | Required (for this operation) |
PUT /v9/shipments/1234567 | Response |
|---|---|
{"mobile_transfer_type":"TMMobile"}OR {"mobile_transfer_type":"FlashSeats"}OR {"mobile_transfer_type":"TMMobileLink"} | {
"id": 5192586,
"url": "/shipment/5192586",
"type": "TMMobile",
"email_address": {
"id": 4227710,
"url": null,
"address": "michaelstarr@example.com",
"label": null,
"updated_at": "2021-05-16T22:15:11Z"
},
}(Response has been trimmed for brevity.) |
SELLER: Provide Local Pickup Information
After an order with a shipment.type of LocalPickup has been accepted the Seller must provide information on where to pick up the tickets.
Name | Description | Type | Required |
|---|---|---|---|
| Contact name of the seller | string | Required when |
| Attributes of a new phone number to create and use as a contact number for the seller. A new Phone Number will be created (see example below). | Hash | Required when |
| Attributes of a new address to create and use for the pickup location. A new Address will be created (see example below). | Hash | Required when |
| The pickup time | string | Required when |
| Additional notes on location and any other pickup details | string | Optional |
PUT /v9/shipments/1234567 | Response |
|---|---|
{
"ship_from_name":"Michael Starr",
"ship_from_phone_number_attributes":{
"label":"Cell",
"country_code":"+1",
"number":"2015555555",
"extension":null
},
"ship_from_address_attributes":{
"name":"Michael Starr",
"street_address":"333 Washington St",
"extended_address":"Suite 302",
"locality":"Jersey City",
"region":"NJ",
"postal_code":"07307",
"country_code":"US"
},
"pickup_time_range":"2 Hours before game",
"pickup_instructions":"Call and I will come downstairs"
} | {
"id": 5184368,
"url": "/shipments/5184368",
"type": "LocalPickup",
"ship_from_name": "Michael Starr",
"ship_from_address": {
"id": 63965284,
"label": null,
"name": "Michael Starr",
"street_address": "333 Washington St",
"extended_address": "Suite 302",
"locality": "Jersey City",
"region": "NJ",
"postal_code": "07307",
"country_code": "US"
},
"ship_from_phone_number": {
"id": 25954226,
"url": "/clients//phone_numbers/25954226",
"label": "Cell",
"country_code": "+1",
"number": "2015555555",
"extension": "",
"updated_at": "2021-09-06T15:17:54Z"
}
"pickup_time_range": "2 Hours before game",
"pickup_instructions": "Call and I will come downstairs",
}(Response has been trimmed for brevity.) If both parties have already updated the shipment with their Local Pickup details, the shipment will move to a Delivered state and can no longer be updated. To make changes you will need to contact support. |
BUYER: Provide Local Pickup Information
After an order with a shipment.type of LocalPickup has been accepted the Buyer must provide information to the seller to help arrange the pick up of the tickets.
Name | Description | Type | Required |
|---|---|---|---|
| Contact name of the Attendee/Customer | string | Required when |
| Attributes of a new phone number to create and use as a contact number for the Attendee/Customer. A new Phone Number will be created (see example below). | Hash | Required when |
| Any additional requests or comments | string | Optional |
PUT /v9/shipments/1234567 | Response |
|---|---|
{
"ship_to_name":"Ralph Saenz",
"phone_number_attributes":{
"label":"iPhone",
"country_code":"+1",
"number":"2025555555",
"extension":null
},
"notes":"I will be in a Saints jersey"
} | {
"id": 5184368,
"url": "/shipments/5184368",
"type": "LocalPickup",
"ship_to_name": "Ralph Saenz",
"phone_number": {
"label": "iPhone",
"country_code": "+1",
"number": "2025555555",
"extension": null
},
"notes": "I will be in a Saints jersey"
}(Response has been trimmed for brevity.) If both parties have already updated the shipment with their Local Pickup details, the shipment will move to a Delivered state and can no longer be updated. To make changes you will need to contact support. |