Solicitar ubicación del paquete

Requisitos previos

1. Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.

2. Recuperar el número de orden de envío entrante: Envía una GET solicitud al /colocations/v2/orders/{orderId} endpoint para recuperar un número de pedido para un envío entrante que ya ha sido programado. Para programar un nuevo envío entrante, envíe una POST solicitud al /colocations/v2/orders/shipmentspunto final. Para programar un envío entrante, el usuario debe tener Shipments permiso. Puede omitir este paso si ya tiene el número de orden de envío entrante.

3. Para obtener los detalles de Smart Hands, debe tener Smart Handspermiso de pedido.

4. Obtener tipos de Smart Hands - Enviar una GET solicitud al /v1/orders/smarthands/types endpoint para obtener todos los tipos de órdenes de Smart Hands. Puede omitir este paso si ya conoce el tipo de orden Smart Hands.

5. Obtener información de ubicación: Envíe una GET solicitud al /v1/orders/smarthands/locations endpoint para recuperar las ubicaciones de IBX disponibles a las que tenga acceso. Puede omitir este paso si ya conoce la información de ubicación.

Obtenga la ubicación de un paquete

Para solicitar la ubicación de sus paquetes en el IBX, envíe una POST solicitud al /v1/orders/smarthands/locatePackage punto final. Especifique los detalles de sus paquetes y necesidades en el serviceDetails objeto en el cuerpo de la solicitud. Utilice el objeto opcional attachmentspara incluir detalles adicionales para un técnico.

nota

Antes de crear una orden con adjunto, llame al Attachments File punto final.

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/locatePackage"  
-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": {  
    "shipmentOrderNumber": "1-1234567890",  
    "trackingNumber": "All tracking numbers in this shipment order.",  
    "possibleLocation": "Last known location was the loading bay.",  
    "packageDescription": "Multiple DHL boxes.",  
    "scopeOfWork": "Locate and group all boxes together in a fixed location for easy identification and later collection.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
        "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",  
        "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"  
    }  
  ]  
}'

Para obtener una lista completa de los parámetros y descripciones del cuerpo, consulte la Referencia API .

Respuesta de muestra:

{  
  "OrderNumber": "1-457809872838"  
}

La respuesta indica que el pedido se ha realizado correctamente y devuelve el número de pedido.