跳至内容

订单入库货物拆包

先决条件

  1. 身份验证 - 请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何调用 OAuth API 来验证和确认您的凭据的说明,请参阅API 身份验证

  2. 获取您的入库订单号 - 向 /colocations/v2/orders/{orderId} 发送 GET 请求%20Order%要获取已安排入库货物的订单号,请使用 20details) 端点。要安排新的入库货物,请向 /colocations/v2/orders/shipments 端点发送 POST 请求。%20inbound%20或%20outbound%20shipment)端点。要安排入库发货,用户必须拥有“发货”权限。如果您已有入库发货订单号,则可以跳过此步骤。

  3. 要获取 Smart Hands 的详细信息,您必须拥有“Smart Hands”订购权限。

  4. 获取 Smart Hands 订单类型 - 向 /v1/orders/smarthands/types 端点发送 GET 请求,即可获取所有 Smart Hands 订单类型。如果您已经知道 Smart Hands 订单类型,则可以跳过此步骤。

  5. 获取位置信息 - 向 /v1/orders/smarthands/locations 端点发送 GET 请求,以检索您有权访问的可用 IBX 位置。如果您已经知道位置信息,则可以跳过此步骤。

订单入库货物拆包及包装处置

如需申请入库货物拆包和包装处理服务,请向 /smarthands/shipmentUnpack 端点发送 POST 请求。请在请求正文中详细说明您的包裹信息和操作说明。您可以使用可选的 attachments 对象为技术人员提供更多详细信息。

注意

在创建带有附件的订单之前,请调用 Attachments File 端点。

cURL 请求示例:

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"
    }
  ]
}'

有关主体参数和描述的完整列表,请参阅API 参考

示例回答:

{
  "OrderNumber": "1-457809872838"
}

响应表明订单已成功,并返回订单号。

此页面有帮助吗?