Order Inbound Shipment Unpacking
Prerequisites
-
Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call the OAuth API to validate and authenticate your credentials.
-
Retrieve your inbound shipment order number - send a
GET
request to the [/colocations/v2/orders/{orderId}
](/api-catalog/ordersv2/#tag/Orders/operation/GET Order details) endpoint to retrieve an order number for an inbound shipment that has already been scheduled. To schedule a new inbound shipment, send aPOST
request to the [/colocations/v2/orders/shipments
](/api-catalog/shipmentsv2/#tag/Shipments/operation/Schedule inbound or outbound shipment) endpoint. To schedule an inbound shipment, the user must haveShipments
permission. You may skip this step if you already have the inbound shipment order number. -
To get Smart Hands details, you must have
Smart Hands
ordering permission. -
Get Smart Hands Types - Send a
GET
request to the/v1/orders/smarthands/types
endpoint to get all Smart Hands order types. You may skip this step if you already know the Smart Hands order type. -
Get Location Information - Send a
GET
request to the/v1/orders/smarthands/locations
endpoint to retrieve available IBX locations that you have access to. You may skip this step if you already know the location information.
Order Inbound Shipment Unpacking and Packaging Disposal
To request Inbound Shipment unpacking and packaging disposal, send a POST
request to the /smarthands/shipmentUnpack
endpoint. Specify the details of your package and instructions in the body of the request. Use the optional attachments
object to include additional details for a technician.
Before creating an order with attachment, call the Attachments File
endpoint.
Sample cURL Request:
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/shipmentUnpack"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"inboundShipmentOrderNumber": "1-190403752735",
"discardShipmentMaterial": false,
"copyOfPackingSlipNeeded": false,
"scopeOfWork": "Flatten the boxes and keep them by the side of the cage.",
"needSupportFromASubmarineCableStationEngineer": true
},
"attachments": [
{
"id": "26f40e6e-dd6e-48fa-a797-62c0d3157388",
"name": "AdditionalShipmentWorkDetails.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "janesmith"
}
]
}'
For a complete list of body parameters and descriptions, see the API Reference.
Sample Response:
{
"OrderNumber": "1-457809872838"
}
The response indicates the order was successful and returns the order number.