Guias de uso
Documentação GlobalDeveloper HubSuporteStatus da API

Guía de casos de uso de Amazon Business orders (Amazon Business de pedidos)

Cómo trabajar con Amazon Business orders (Amazon Business de pedidos) a través de las Orders API.

Suggest Edits

La API de la Versión: v0

¿Cuáles son Amazon Business order (Amazon Business de pedidos) ?

Amazon es un Negocio global de adquisición de la solución utilizada por las empresas, que van desde los propietarios únicos para las empresas multinacionales, con decenas de miles de empleados en una sola cuenta. Desde su lanzamiento en los Estados Unidos en el 2015, en Amazon Empresa se ha expandido a otros ocho países y alcanzó los 25 mil millones de dólares en todo el mundo anualizada de ventas! Más de la mitad de las ventas de los sellers de terceras partes con una mayoría de los sellers de terceras partes en Amazon. Com también la venta en Amazon para los clientes de Negocios. Amazon Business sirve a más de 5 millones de empresas en todo el mundo.

Amazon Business que los clientes esperan rápido en el tiempo de las entregas sólo como consumidores individuales, pero también esperan la adhesión a su entrega preferencias, es decir, los envíos deben ser entregados dentro de su operativo de días/horas (por ejemplo, Lunes-Viernes 9am-5pm) y a su zona preferida por instrucciones (por ejemplo, Entrar por la puerta 1, a continuación, Un ascensor). Para apoyar Amazon específicas del Negocio casos de uso y mejorar el negocio de la entrega de la experiencia, hemos añadido atributos específicos de la empresa órdenes existentes en la Orders API.

La Orders API se utiliza para recuperar los pedidos creados para la selling partner para quien el se realizan las llamadas. Puede utilizar la operación getOrders para obtener todos los pedidos para la selling partner y getOrderAddress para recuperar la dirección de envío y de entrega asociada preferencias.

Requisitos previos

Para completar con éxito este tutorial, debe tener lo siguiente:

Tutorial : Cómo conseguir todos los Amazon Business order (Amazon Business de pedidos)

Este tutorial muestra cómo obtener todos los Amazon de Negocios órdenes e identificarlos.

Requisitos previos

Para completar con éxito este tutorial, debe tener lo siguiente:

Capturar los pedidos de venta y de pareja identificar Amazon Business order (Amazon Business de pedidos)

solicitud

Llame a la operación getOrders, pasando por los parámetros que desea filtrar el resultado. Esta es una pagina de la API. Por favor, utilice el NextToken atributo en las llamadas posteriores para obtener el siguiente lote de pedidos.

Ejemplo de solicitud

GET https://sellingpartnerapi-eu.amazon. Com/orders/v0/orders?MarketplaceIds=A13V1IB3VIYZZH&CreatedAfter=2022-12-25

Respuesta

Una respuesta correcta incluye un payload objeto, que contiene una Orders array de uno o más pedidos, y opcionalmente propiedades adicionales (consulte OrderList para obtener información acerca de las propiedades adicionales). Amazon empresas, a fin tendrá el isBusinessOrder atributo se establece en true.

Consulte Order en la referencia de la API para obtener más detalles acerca de los posibles objetos y propiedades en una order.

Ejemplo de respuesta

{
  "payload": {
    "Orders": [
      {
        "BuyerInfo": {
          "BuyerEmail": "[email protected]"
        },
        "AmazonOrderId": "933-1551061-4583027",
        "EarliestDeliveryDate": "2023-02-13T23:00:00Z",
        "EarliestShipDate": "2023-02-12T23:00:00Z",
        "SalesChannel": "Amazon.fr",
        "AutomatedShippingSettings": {
          "HasAutomatedShippingSettings": false
        },
        "OrderStatus": "Unshipped",
        "NumberOfItemsShipped": 0,
        "OrderType": "StandardOrder",
        "IsPremiumOrder": false,
        "IsPrime": false,
        "FulfillmentChannel": "MFN",
        "NumberOfItemsUnshipped": 6,
        "HasRegulatedItems": false,
        "IsReplacementOrder": "false",
        "IsSoldByAB": false,
        "LatestShipDate": "2023-02-13T22:59:59Z",
        "ShipServiceLevel": "Std FR Dom_6",
        "DefaultShipFromLocationAddress": {
          "AddressLine1": "123 Any Street",
          "Phone": "2062661000",
          "PostalCode": "75008",
          "City": "Any Town",
          "CountryCode": "FR",
          "Name": "Domestic"
        },
        "IsISPU": false,
        "MarketplaceId": "A13V1IB3VIYZZH",
        "LatestDeliveryDate": "2023-02-15T22:59:59Z",
        "PurchaseDate": "2023-01-31T21:40:07Z",
        "ShippingAddress": {
          "PostalCode": "92110",
          "City": "Clichy",
          "CountryCode": "FR"
        },
        "IsAccessPointOrder": false,
        "IsBusinessOrder": true,
        "OrderTotal": {
          "CurrencyCode": "EUR",
          "Amount": "192.00"
        },
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2023-02-09T18:22:08Z",
        "ShipmentServiceLevelCategory": "Standard"
      },
      {
        "BuyerInfo": {},
        "AmazonOrderId": "933-8991965-4707025",
        "EarliestShipDate": "2022-12-13T23:00:00Z",
        "SalesChannel": "Amazon.fr",
        "AutomatedShippingSettings": {
          "HasAutomatedShippingSettings": false
        },
        "OrderStatus": "Canceled",
        "NumberOfItemsShipped": 0,
        "OrderType": "StandardOrder",
        "IsPremiumOrder": false,
        "IsPrime": false,
        "FulfillmentChannel": "MFN",
        "NumberOfItemsUnshipped": 0,
        "HasRegulatedItems": false,
        "IsReplacementOrder": "false",
        "IsSoldByAB": false,
        "LatestShipDate": "2022-12-14T22:59:59Z",
        "ShipServiceLevel": "Std FR Dom_6",
        "IsISPU": false,
        "MarketplaceId": "A13V1IB3VIYZZH",
        "PurchaseDate": "2022-12-13T21:37:23Z",
        "IsAccessPointOrder": false,
        "IsBusinessOrder": false,
        "OrderTotal": {
          "CurrencyCode": "EUR",
          "Amount": "64.00"
        },
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2022-12-23T23:52:48Z",
        "ShipmentServiceLevelCategory": "Standard"
      }
    ],
    "NextToken": "9A+grgyHbZ6aJqJYLDm0ZAmQazDrhw3CjfZLM4uXhchUojdU4H46tsNI3HOI22PIxqXyQLkGMBs8VhF73Xgy+yXWMVizzhiaOZR31XSS2A6ihtsveF3jYQF2C+OrWLWlInTAy+XKVmRZBY+oaVuycxWu4fsY7GTeCx7ShGY9OykghJ+2Ki9vXqfQmOEx4uZaf2GLmUGyr9UGnxD0RJmrryegoU0IPZxXhi1SP6zE/wLAVWPoD6wzg73j3O8ab4IoMBO/reDY2s8hGWNNu3VwFU0hrIUQcumU7YYXwRo+g8JiIXlRXylzxduZ3sLNMwtcdxoH3Y2nWfyVkzb2pTkxaavNDfG6UytaVlcQwn/OKRi5RanugZwxmUYrj/A7uEu6kY1qVoni2ChKw4h6m/JgREdtrcnli9iATruOKKI89oh4YcsIg8cwXw==",
    "CreatedBefore": "2023-02-09T19:37:29Z"
  }
}

En este ejemplo, el primer order en la Orders array se isBusinesssOrder establece en true, y la de segundo order en la Orders array tiene el atributo se establece en false.

Para obtener acceso a los datos de la PII para las órdenes a granel, consulte las Fichas de la API Tutorial: Obtener la autorización para el acceso seguro de responsabilidad profesional para los pedidos a granel.

Tutorial: Cómo obtener los detalles de Amazon Business order (Amazon Business de pedidos)

Este tutorial muestra cómo obtener detalles de pedido para un order específico.

Requisitos previos

Para completar con éxito este tutorial, debe tener lo siguiente:

Obtener detalles de pedido para un order ID

Llame a la operación getOrder con un order ID para obtener todos los detalles de la order asociado con un pedido.

solicitud

Llame a la operación getOrder, pasando por la consulta siguiente parámetro:

ParámetroDescripciónSe requiere
orderIdAmazon definido por el identificador, en 3-7-7 formato. Tipo: string deSí

Ejemplo de solicitud

GET https://sellingpartnerapi-eu.amazon. Com/orders/v0/orders/931-2344438-7825451

Respuesta

Una respuesta correcta incluye el payload objeto, que contiene la información de un pedido. La carga incluye una IsBusinessOrder propiedad booleana. Cuando es true, el order es una order. De lo contrario, el atributo se establece en false.

Consulte Order en la referencia de la API para obtener más detalles acerca de los posibles objetos y propiedades en una order.

Ejemplo de respuesta

{
  "payload": {
    "BuyerInfo": {
      "BuyerEmail": "[email protected]"
    },
    "AmazonOrderId": "931-2344438-7825451",
    "EarliestDeliveryDate": "2023-02-13T23:00:00Z",
    "EarliestShipDate": "2023-02-12T23:00:00Z",
    "SalesChannel": "Amazon.fr",
    "AutomatedShippingSettings": {
      "HasAutomatedShippingSettings": false
    },
    "OrderStatus": "Unshipped",
    "NumberOfItemsShipped": 0,
    "OrderType": "StandardOrder",
    "IsPremiumOrder": false,
    "IsPrime": false,
    "FulfillmentChannel": "MFN",
    "NumberOfItemsUnshipped": 2,
    "HasRegulatedItems": false,
    "IsReplacementOrder": false,
    "IsSoldByAB": false,
    "LatestShipDate": "2023-02-13T22:59:59Z",
    "ShipServiceLevel": "Std FR Dom_6",
    "DefaultShipFromLocationAddress": {
      "AddressLine1": "123 Any Street",
      "Phone": "2062661000",
      "PostalCode": "75008",
      "City": "Any Town",
      "CountryCode": "FR",
      "Name": "Domestic"
    },
    "IsISPU": false,
    "MarketplaceId": "A13V1IB3VIYZZH",
    "LatestDeliveryDate": "2023-02-15T22:59:59Z",
    "PurchaseDate": "2023-02-09T18:07:04Z",
    "ShippingAddress": {
      "PostalCode": "92110",
      "City": "Any Town",
      "CountryCode": "FR"
    },
    "IsAccessPointOrder": false,
    "PaymentMethod": "Other",
    "IsBusinessOrder": true,
    "OrderTotal": {
      "CurrencyCode": "EUR",
      "Amount": "64.00"
    },
    "PaymentMethodDetails": [
      "Standard"
    ],
    "IsGlobalExpressEnabled": false,
    "LastUpdateDate": "2023-02-09T18:25:16Z",
    "ShipmentServiceLevelCategory": "Standard"
  }
}

Para obtener acceso a los datos de la PII para un order ID, consulte las Fichas de la API Tutorial: Obtener la autorización para acceder a la PII para el order de los elementos en un order

Tutorial: Obtener la entrega de las preferencias de Amazon Business order (Amazon Business de pedidos)

Este tutorial se muestra cómo obtener la entrega de las preferencias de Amazon Business order (Amazon Business de pedidos).

Paso 1. Obtener el order ID por Amazon Business order (Amazon Business de pedidos)

Con el fin de obtener la entrega de las preferencias de un pedido, necesitamos el order ID. El order ID se puede descargar de la GetOrders API, como se describe en el Tutorial: Cómo conseguir todos los Amazon de Negocios órdenes. Cualquier order ID devuelto con isBusinessOrder = true es de Amazon order.

Paso 2. orderar los datos de la dirección de Amazon Business order (Amazon Business de pedidos)

La entrega de las preferencias están asociados con la dirección de envío. Llame a la operación getOrderAddress con un order ID para obtener toda la entrega de las preferencias especificadas por el usuario para la dirección de envío. Si no hay entrega de las preferencias especificadas por el cliente para la dirección, el horario comercial predeterminado para la región son devueltos. Asegúrese de lo siguiente:

  • La IDENTIFICACIÓN de la order pertenece a Amazon Business order (Amazon Business de pedidos)
  • La order fue creada después de 02/08/2023

solicitud

Llame a la operación getOrderAddress, pasando por la consulta siguiente parámetro:

ParámetroDescripciónSe requiere
orderIdAmazon definido por el identificador, en 3-7-7 formato. Tipo: string deSí

Ejemplo de solicitud

GET https://sellingpartnerapi-eu.amazon. Com/orders/v0/orders/931-2344438-7825451/address

Respuesta

Una respuesta correcta incluye una carga de objeto con todos los parámetros del objeto OrderAddress en el documento API. Por favor, tenga en cuenta que el ShippingAddress no es devuelto por la pendiente y los pedidos cancelados hoy en día, y DeliveryPreferences sólo están disponibles para Amazon Business order (Amazon Business de pedidos).

Ejemplo de respuesta

{
  "payload": {
    "DeliveryPreferences": {
      "AddressInstructions": "\"//\\\"Amazon france delivery for @sksri }\\\\\\\\}\"",
      "PreferredDeliveryTime": {
        "BusinessHours": [
          {
            "DayOfWeek": "TUE",
            "OpenIntervals": [
              {
                "EndTime": {
                  "Minute": 0,
                  "Hour": 16
                },
                "StartTime": {
                  "Minute": 0,
                  "Hour": 8
                }
              }
            ]
          },
          {
            "DayOfWeek": "WED",
            "OpenIntervals": [
              {
                "EndTime": {
                  "Minute": 0,
                  "Hour": 16
                },
                "StartTime": {
                  "Minute": 0,
                  "Hour": 9
                }
              }
            ]
          },
          {
            "DayOfWeek": "FRI",
            "OpenIntervals": [
              {
                "EndTime": {
                  "Minute": 0,
                  "Hour": 16
                },
                "StartTime": {
                  "Minute": 0,
                  "Hour": 9
                }
              }
            ]
          },
          {
            "DayOfWeek": "MON",
            "OpenIntervals": [
              {
                "EndTime": {
                  "Minute": 0,
                  "Hour": 14
                },
                "StartTime": {
                  "Minute": 0,
                  "Hour": 6
                }
              }
            ]
          }
        ]
      },
      "OtherAttributes": []
    },
    "AmazonOrderId": "931-2344438-7825451",
    "ShippingAddress": {
      "AddressLine1": "123 Any Street",
      "Phone": "2062661000",
      "PostalCode": "92110",
      "City": "Any Town",
      "CountryCode": "FR",
      "AddressType": "Commercial",
      "Name": "Amazon France"
    }
  }
}

Updated over 1 year ago