Saltar al contenido principal

Programar envíos

Todos los envíos deben programarse por adelantado mediante la creación de una orden de envío entrante o saliente. El no hacerlo puede resultar en el rechazo del envío. Solo un usuario de Equinix Customer Portal con permiso de pedido de envíos puede programar estos envíos. Los tipos de envíos actualmente soportados por las API de Equinix Customer Portal se pueden encontrar aquí.

Requisitos previos​

  1. Para obtener los detalles del envío, el usuario debe tener Shipmentspermisos de pedido.

  2. 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.

  3. Para programar un envío, debe determinar el ID exacto de la jaula y el número de cuenta para el envío. Estos valores se pasarán para los cageIdparámetros AND accountNumberen el cuerpo de la solicitud.

  4. 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.

Programar un envío entrante​

Para programar un envío entrante, envíe una POST solicitud al /colocations/v2/orders/shipmentspunto final. Utilice el "type": "INBOUND" parámetro para especificar que se trata de un Envío entrante y proporcione el resto de los detalles del envío en el cuerpo de la solicitud. Una solicitud de envío entrante requiere mínimamente el tipo de envío, la fecha de envío, la jaula asociada, el transportista y el número de cajas a incluir. La otra información necesaria que necesita pasar en el cuerpo de solicitud de envío entrante depende de lo siguiente:

  • Si su envío entrante procede de una jaula vinculada a varias cuentas.
  • Si el transportista que entrega el envío es de su organización, un transportista listado o un transportista no listado. Si su transportista no es DHL, FedEx, UPS, su transportista no está listado.

Ejemplo de solicitud cURL:

Un envío entrante procedente de una jaula asociada a una única cuenta que será entregado por su organización.

Para este escenario, su envío entrante se entrega a su jaula vinculada a una sola cuenta por alguien de su organización. La información mínima requerida para este escenario se pasa en esta solicitud de muestra.

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "INBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "details": {  
    "carrier": "CUSTOMER_CARRIER",  
    "numberOfBoxes": 2  
    }  
}'

Ejemplo de solicitud cURL:

Un envío entrante desde una jaula asociada a múltiples cuentas que serán entregadas por un transportista no listado. También se incluyen solicitudes adicionales de Smart Hands, información, detalles de contacto y archivos adjuntos.

nota

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

En este escenario, usted ha proporcionado la información mínima requerida para facilitar un envío entrante, y ha incluido parámetros de cuerpo adicionales que apoyan lo siguiente:

  • solicitud adicional de Smart Hands para entregar el envío en su jaula
  • descripción adicional
  • anexos de apoyo
  • su propio identificador de referencia
  • información sobre el pedido
  • información de contacto para notificaciones o personas de contacto técnico

En esta solicitud de ejemplo se pasan todos los parámetros del cuerpo disponibles y aplicables.

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "INBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "accountNumber": 901011,  
    "details": {  
        "carrier": "OTHER",  
        "carrierName": "New Carrier",  
        "numberOfBoxes": 2,  
        "carrierTrackingNumbers": [  
            "t1Z294AK92654678989",  
            "t1Z086DK96424456780"  
        ],  
        "cageDelivery": true  
    },  
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",  
    "attachments": [  
        {  
            "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",  
            "name": "OrderInstructions.docx"  
        }  
    ],   
    "customerReferenceId": "2020/16347",  
        "purchaseOrder": {  
        "type": "NEW",  
        "number": "9654284",  
        "amount": "10000",  
        "startDate": "2020-10-01",  
        "endDate": "2021-09-30",  
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"  
    },  
    "contacts": [  
    {  
        "type": "NOTIFICATION",  
        "registeredUsers": [  
            "john_doe1",  
            "jane_smith1"  
        ]  
    },  
    {  
        "type": "TECHNICAL",  
        "firstName": "John",  
        "lastName": "Doe",  
        "availability": "WORK_HOURS",  
        "timezone": "America/Los_Angeles",  
        "details": [  
            {  
                "type": "EMAIL",  
                "value": "johndoe@acme.com""  
            },  
            {  
                "type": "PHONE",  
                "value": "+1-987654321"  
            },  
            {  
                "type": "MOBILE",  
                "value": "+1-912345678"  
            }  
        ]  
    }  
  ]  
}'

La orden se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay un órgano de respuesta.

Si desea actualizar este orden, consulte /v2/orders/shipments/{orderId} la sección de Referencia de API para obtener más información.

Si desea agregar notas a este pedido, recuperar y responder las negociaciones para este pedido, o cancelar este pedido, consulte Pedidos en la Sección de Referencia de API para más información.

Programar un envío de salida​

Para programar un envío saliente, envíe una POST solicitud al /colocations/v2/orders/shipmentsendpoint. Utilice el "type": "OUTBOUND" parámetro para especificar que se trata de un envío saliente y proporcione el resto de los detalles del envío en el cuerpo de la solicitud. Una solicitud de envío saliente requiere mínimamente que se incluya el tipo de envío, la fecha de envío, la jaula asociada y el transportista. La otra información necesaria que necesita pasar en el cuerpo de solicitud de envío de salida depende de lo siguiente:

  • Si su envío saliente procede de una jaula vinculada a varias cuentas.
  • Si el transportista que entrega el envío es de su organización, un transportista listado o un transportista no listado. Si su operador no es DHL, FedEx, UPS, su operador no está listado.
  • Si necesita que Equinix imprima una etiqueta de envío.

Ejemplo de solicitud cURL:

Un envío saliente de una jaula asociada a una sola cuenta que será entregado por alguien de su organización.

Para este escenario, su envío saliente se entrega a su jaula vinculada a una sola cuenta por alguien de su organización. La información mínima requerida para este escenario se pasa en esta solicitud de muestra.

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "OUTBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "details": {  
    "carrier": "CUSTOMER_CARRIER"  
    ]  
    }  
}'

Ejemplo de solicitud cURL:

Un envío saliente de una jaula asociada con múltiples recuentos que serán entregados por un transportista no listado, y requiere que Equinix imprima la etiqueta de envío. Los detalles pertinentes de la etiqueta de envío se proporcionan como un archivo adjunto. También se incluyen solicitudes adicionales de Smart Hands, información, detalles de contacto y archivos adjuntos.

nota

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

En este escenario, usted ha proporcionado la información mínima requerida para facilitar una solicitud de envío saliente, y ha incluido parámetros de cuerpo adicionales que soportan lo siguiente:

  • valor declarado del envío en una divisa distinta del USD
  • solicitudes adicionales de Smart Hands para recoger su envío de su jaula o para asegurarlo
  • descripción adicional
  • anexos de apoyo
  • su propio identificador de referencia
  • información sobre el pedido
  • información de contacto para notificaciones o personas de contacto técnico

En esta solicitud de ejemplo se pasan todos los parámetros del cuerpo disponibles y aplicables.

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "OUTBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "accountNumber": 901011,  
    "details": {  
    "carrier": "OTHER",  
    "carrierName": "New Carrier",  
    "numberOfBoxes": 2,  
    "declaredValue": 1000,  
    "declaredValueCurrency": "EUR",  
    "carrierTrackingNumbers": [  
        "t1Z294AK92654678989",  
        "t1Z086DK96424456780"  
    ],  
        "shipmentLabelRequired": true,  
        "shipmentAttachmentId": "f49891fc-d9a5-4b4b-bc65-150b1c5e6dff",  
        "requirePickup": true,  
        "insureShipment": true  
    },  
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",  
    "attachments": [  
    {  
        "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",  
        "name": "OrderInstructions.docx"  
    }  
    ],  
    "customerReferenceId": "2020/16347",  
    "purchaseOrder": {  
        "type": "NEW",  
        "number": "9654284",  
        "amount": "10000",  
        "startDate": "2020-10-01",  
        "endDate": "2021-09-30",  
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"  
    },  
    "contacts": [  
    {  
        "type": "NOTIFICATION",  
        "registeredUsers": [  
            "john_doe1",  
            "jane_smith1"  
        ]  
    },  
    {  
        "type": "TECHNICAL",  
        "firstName": "John",  
        "lastName": "Doe",  
        "availability": "WORK_HOURS",  
        "timezone": "America/Los_Angeles",  
        "details": [  
            {  
                "type": "EMAIL",  
                "value": "johndoe@acme.com"  
            },  
            {  
                "type": "PHONE",  
                "value": "+1-987654321"  
            },  
            {  
                "type": "MOBILE",  
                "value": "+1-912345678"  
            }  
        ]  
    }  
  ]  
}'

La orden se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay un órgano de respuesta.

Si desea actualizar este orden, consulte /v2/orders/shipments/{orderId} la sección de Referencia de API para obtener más información.

Si desea agregar notas a este pedido, recuperar y responder las negociaciones para este pedido, o cancelar este pedido, consulte Pedidos en la Sección de Referencia de API para más información.

¿Le ha resultado útil esta página?