Saltar al contenido principal

Programar envíos

Todos los envíos deben programarse con antelación mediante la creación de un pedido de envío de entrada o de salida. Si no lo hace, el envío puede ser rechazado. Solo un usuario de Equinix Customer Portal con permiso para realizar pedidos de envíos puede programar estos envíos. Los tipos de envíos que actualmente admiten 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 al API de OAuth 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 del 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 punto final 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 de entrada, envíe una POST solicitud al /colocations/v2/orders/shipments punto final. Utilice el "type": "INBOUND" parámetro para especificar que se trata de un envío de entrada y proporcione el resto de los detalles del envío en el cuerpo de la solicitud. Una solicitud de envío de entrada requiere que se incluyan como mínimo el tipo de envío, la fecha de envío, la jaula asociada, el transportista y el número de cajas. La otra información necesaria que debe transmitir al organismo de la solicitud de envío de entrada 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 procede de su organización, de un transportista incluido en la lista o de un transportista no incluido en la lista. Si su transportista no es DHL, FedEx, UPS, su transportista no aparece 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 de entrada se entrega en su jaula vinculada a una sola cuenta por alguien de su organización. La información mínima requerida para este escenario se transmite 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 de entrada desde una jaula asociada a varias cuentas que será entregado por un transportista no incluido en la lista. También se incluyen solicitudes de Smart Hands adicionales, información, datos de contacto y archivos adjuntos.

nota

Antes de crear un pedido con archivo adjunto, llama 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"
            }
        ]
    }
  ]
}'

El pedido se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay ningún cuerpo de respuesta.

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

Si desea añadir 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 obtener más información.

Programar un envío de salida​

Para programar un envío de salida, envíe una POST solicitud al /colocations/v2/orders/shipments punto final. Utilice el "type": "OUTBOUND" parámetro para especificar que se trata de un envío de salida y proporcione el resto de los detalles del envío en el cuerpo de la solicitud. Una solicitud de envío de salida requiere que se incluyan como mínimo el tipo de envío, la fecha de envío, la jaula asociada y el transportista. La otra información necesaria que debe transmitir al cuerpo de la 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 procede de su organización, de un transportista incluido en la lista o de un transportista no incluido en la lista. Si su transportista no es DHL, FedEx, UPS, su transportista no aparece 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 de salida se entrega en su jaula vinculada a una sola cuenta por alguien de su organización. La información mínima requerida para este escenario se transmite 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 de salida desde una jaula asociado con varios recuentos que serán entregados por un transportista no incluido en la lista y requiere que Equinix imprima la etiqueta de envío. Los detalles pertinentes de la etiqueta de envío se proporcionan como archivo adjunto. También se incluyen solicitudes de Smart Hands adicionales, información, datos de contacto y archivos adjuntos.

nota

Antes de crear un pedido con archivo adjunto, llama 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"
            }
        ]
    }
  ]
}'

El pedido se crea correctamente cuando se devuelve un código HTTP de 201 y se devuelve el encabezado de respuesta. No hay ningún cuerpo de respuesta.

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

Si desea añadir 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 obtener más información.

¿Le ha resultado útil esta página?