Ir al contenido principal

Programar envíos

Todos los envíos deben programarse con antelación mediante la creación de una orden de envío entrante o saliente. De lo contrario, el envío podría ser rechazado. Sólo un usuario del Equinix Customer Portal con permiso para realizar pedidos de envíos puede programar estos envíos. Los tipos de envíos admitidos actualmente por las API del Equinix Customer Portal pueden consultarse aquí.

Requisitos previos​

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

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

  3. Para programar un envío, necesita determinar el ID de jaula y el número de cuenta exactos para el envío. Estos valores se pasarán para los parámetros cageId y accountNumber en el cuerpo de la solicitud.

  4. Obtener información de ubicación - Envíe una solicitud GET al punto final /v1/orders/smarthands/locations para recuperar las ubicaciones IBX disponibles a las que tiene 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 solicitud POST al punto final /colocations/v2/orders/shipments. Utilice el parámetro "type": "INBOUND" para especificar que se trata de un envío entrante, y proporcione el resto de detalles del envío en el cuerpo de la solicitud. Una solicitud de envío entrante requiere como mínimo que se incluya el tipo de envío, la fecha de envío, la jaula asociada, el transportista y el número de cajas. El resto de la información necesaria que debe pasar en el cuerpo de la 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 realiza 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á en la lista.

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 es entregado 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 ejemplo.

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 de una jaula asociada a varias cuentas que será entregado por un transportista no incluido en la lista. También se incluyen solicitudes adicionales de Smart Hands, información, datos de contacto y archivos adjuntos.

nota

Antes de crear un pedido con archivo adjunto, llame al punto final Attachments File.

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

El pedido se ha creado correctamente cuando se devuelve un código HTTP de 201 y se devuelve la cabecera de respuesta. No hay cuerpo de respuesta.

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

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

Programar un envío de salida​

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

  • Si su envío saliente procede de una jaula vinculada a varias cuentas.
  • Si el transportista que realiza 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á en la lista.
  • 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 es entregado 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 ejemplo.

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 a múltiples cuentas que será entregado por un transportista no listado, y que requiere que Equinix imprima la etiqueta de envío. Los detalles relevantes de la etiqueta de envío se proporcionan como archivo adjunto. También se incluyen solicitudes adicionales de Smart Hands, información, datos de contacto y archivos adjuntos.

nota

Antes de crear un pedido con archivo adjunto, llame al punto final Attachments File.

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

El pedido se ha creado correctamente cuando se devuelve un código HTTP de 201 y se devuelve la cabecera de respuesta. No hay cuerpo de respuesta.

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

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

¿Fue útil esta página?