Orders reguladas

Cómo trabajar con regulado pedidos a través de las Orders API.

¿Qué son los regulated orders (pedidos regulados)?

Amazon clasifica a algunos productos, según lo regulado para cumplir con las regulaciones locales y apoyar a ofrecer una selección más amplia de materiales regulados a los clientes. Debido a los pedidos que contienen materiales regulados deben ser validados por profesionales cualificados antes del envío, los clientes están obligados a proporcionar información adicional o cargar las recetas cuando se complete la compra. Ejemplos de materiales regulados incluyen mascota de farmacia, de los ojos lentes de contacto y gafas de prescripción.

Las operaciones getOrderRegulatedInfo y updateVerificationStatus en las Orders API puede ayudar a integrar mediante programación este proceso de validación en las aplicaciones.

Terminología

Regulated product (Producto regulado). Un producto que se vende en Amazon que requiere el suministro de información adicional a la compra de tiempo para cumplir con las regulaciones locales.
Regulated information (Información reglamentada). Información adicional introducida por el cliente en el momento de la compra de un producto regulado.
Regulated order (Pedido regulado). Un pedido de un cliente que contiene un producto regulado y asociadas Regulated information (Información reglamentada).
Restricted Data Token (RDT) (Token de datos restringidos). Un breve token de acceso que autoriza llamadas restringido de las operaciones. Un RDT sigue siendo válido por una hora.
Verification status (Estado de verificación). El estado de un pedido regulado, indicando si se ha aprobado o rechazado por un profesional cualificado.

Tutorial: Descubre si un pedido contiene información regulada

Este tutorial se muestra cómo determinar si una Order (Pedido) es una Regulated order (Pedido regulado). Una vez identificados, los más regulados de la información y el estado sobre el Order (Pedido) puede ser recuperada de la cookie (ver Tutorial: Cómo recuperar una Order (Pedido) de Regulated information (Información reglamentada)).

Requisitos previos

Para completar este tutorial, usted necesitará:

La autorización del seller para quien usted está haciendo llamadas. Ver la Guía para desarrolladores de la Selling Partner API para más información.
La aprobación de la Directo-a-Consumidor de Entrega (Restringido) papel en su perfil de desarrollador.
El Directo-a-Consumidor de Entrega (Restringido) papel seleccionado en la Aplicación de la página de registro para su aplicación.

Paso 1. Averiguar si un pedido contiene Regulated information (Información reglamentada)

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

Parámetro	Descripción	Se requiere
orderId	Amazon definido por el identificador, en 3-7-7 formato. Tipo: string de	Sí

Ejemplo de solicitud:

GET https://sellingpartnerapi-eu.amazon.com/orders/v0/orders/205-1725759-9209952/

Respuesta

Una respuesta correcta incluye el payload objeto, que contiene la información de un pedido. Incluido es una HasRegulatedItems propiedad booleana. Cuando es true, la Order (Pedido) se ha regulado los elementos que puede requerir la aprobación de pasos antes de ser cumplido.

Ver Order (Pedido) en la referencia de la API para obtener más detalles acerca de los posibles objetos y propiedades en una Order (Pedido).

Respuesta de ejemplo (para un pedido que contiene Regulated information (Información reglamentada)):

{
  "payload": {
    "BuyerInfo": {},
    "AmazonOrderId": "026-1520163-6049104",
    "EarliestShipDate": "2022-03-10T00:00:00Z",
    "SalesChannel": "Amazon.co.uk",
    "AutomatedShippingSettings": {
      "HasAutomatedShippingSettings": false
    },
    "OrderStatus": "Canceled",
    "NumberOfItemsShipped": 0,
    "OrderType": "StandardOrder",
    "IsPremiumOrder": false,
    "IsPrime": false,
    "FulfillmentChannel": "MFN",
    "NumberOfItemsUnshipped": 0,
    "HasRegulatedItems": true,
    "IsReplacementOrder": false,
    "IsSoldByAB": false,
    "LatestShipDate": "2022-03-10T23:59:59Z",
    "ShipServiceLevel": "Std UK Dom_1",
    "IsISPU": false,
    "MarketplaceId": "A1F83G8C2ARO7P",
    "PurchaseDate": "2022-03-09T22:03:02Z",
    "IsAccessPointOrder": false,
    "IsBusinessOrder": false,
    "OrderTotal": {
      "CurrencyCode": "GBP",
      "Amount": "20.00"
    },
    "PaymentMethodDetails": [
      "Standard"
    ],
    "IsGlobalExpressEnabled": false,
    "LastUpdateDate": "2022-03-14T22:05:14Z",
    "ShipmentServiceLevelCategory": "Standard"
  }
}

Respuesta de ejemplo (para un pedido que NO contienen Regulated information (Información reglamentada)):

{
  "payload": {
    "BuyerInfo": {},
    "AmazonOrderId": "026-1520163-6049104",
    "EarliestShipDate": "2022-03-10T00:00:00Z",
    "SalesChannel": "Amazon.co.uk",
    "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-03-10T23:59:59Z",
    "ShipServiceLevel": "Std UK Dom_1",
    "IsISPU": false,
    "MarketplaceId": "A1F83G8C2ARO7P",
    "PurchaseDate": "2022-03-09T22:03:02Z",
    "IsAccessPointOrder": false,
    "IsBusinessOrder": false,
    "OrderTotal": {
      "CurrencyCode": "GBP",
      "Amount": "20.00"
    },
    "PaymentMethodDetails": [
      "Standard"
    ],
    "IsGlobalExpressEnabled": false,
    "LastUpdateDate": "2022-03-14T22:05:14Z",
    "ShipmentServiceLevelCategory": "Standard"
  }
}

Tutorial: Cómo reconocer que Ordera en una lista de contener Regulated information (Información reglamentada)

Este tutorial muestra cómo reconocer que Ordera en una lista de contener Regulated information (Información reglamentada). Una vez identificados, los más regulados de la información y el estado de cada Order (Pedido) puede ser recuperada de la cookie (ver Tutorial: Cómo recuperar una Order (Pedido) de Regulated information (Información reglamentada)).

Requisitos previos

Para completar este tutorial, usted necesitará:

La autorización del seller para quien usted está haciendo llamadas. Ver la Guía para desarrolladores de la Selling Partner API para más información.
La aprobación de la Directo-a-Consumidor de Entrega (Restringido) papel en su perfil de desarrollador.
El Directo-a-Consumidor de Entrega (Restringido) papel seleccionado en la Aplicación de la página de registro para su aplicación.

Paso 1. Reconocer que los pedidos a partir de una lista de contener Regulated information (Información reglamentada)

Llame a la getOrders operación, pasando los parameters que desea utilizar para filtrar el resultado.

Ejemplo de solicitud:

GET https://sellingpartnerapi-eu.amazon.com/orders/v0/orders?MarketplaceIds=A1F83G8C2ARO7P&CreatedAfter=1985-04-12T23:20:50.52Z

Respuesta

Una respuesta correcta incluye un payload objeto, que contiene una Orders array de uno o más pedidos, y opcionalmente propiedades adicionales (ver OrderList para obtener información acerca de las propiedades adicionales). Cada Order (Pedido) en la array incluye una HasRegulatedItems propiedad booleana. Cuando es true, la Order (Pedido) contiene materiales regulados que puede requerir la aprobación de pasos antes de ser cumplido.

Ver Order (Pedido) en la referencia de la API para obtener más detalles acerca de los posibles objetos y propiedades en una Order (Pedido).

Respuesta ejemplo:

En este ejemplo, la primera Order (Pedido) en el Order (Pedido) de la array ha regulado los elementos, y la de segundo Order (Pedido) en el Order (Pedido) de la array no se han regulado los elementos.

{
  "payload": {
    "Orders": [
      {
        "BuyerInfo": {},
        "AmazonOrderId": "026-1520163-6049104",
        "EarliestShipDate": "2022-03-10T00:00:00Z",
        "SalesChannel": "Amazon.co.uk",
        "AutomatedShippingSettings": {
          "HasAutomatedShippingSettings": false
        },
        "OrderStatus": "Canceled",
        "NumberOfItemsShipped": 0,
        "OrderType": "StandardOrder",
        "IsPremiumOrder": false,
        "IsPrime": false,
        "FulfillmentChannel": "MFN",
        "NumberOfItemsUnshipped": 0,
        "HasRegulatedItems": true,
        "IsReplacementOrder": false,
        "IsSoldByAB": false,
        "LatestShipDate": "2022-03-10T23:59:59Z",
        "ShipServiceLevel": "Std UK Dom_1",
        "IsISPU": false,
        "MarketplaceId": "A1F83G8C2ARO7P",
        "PurchaseDate": "2022-03-09T22:03:02Z",
        "IsAccessPointOrder": false,
        "IsBusinessOrder": false,
        "OrderTotal": {
          "CurrencyCode": "GBP",
          "Amount": "20.00"
        },
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2022-03-14T22:05:14Z",
        "ShipmentServiceLevelCategory": "Standard"
      }, 
      {
        "BuyerInfo": {},
        "AmazonOrderId": "203-1028129-8694751",
        "EarliestShipDate": "2022-03-17T00:00:00Z",
        "SalesChannel": "Amazon.co.uk",
        "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-03-17T23:59:59Z",
        "ShipServiceLevel": "Std UK Dom_1",
        "IsISPU": false,
        "MarketplaceId": "A1F83G8C2ARO7P",
        "PurchaseDate": "2022-03-15T16:45:35Z",
        "IsAccessPointOrder": false,
        "IsBusinessOrder": false,
        "OrderTotal": {
          "CurrencyCode": "GBP",
          "Amount": "20.00"
        },
        "PaymentMethodDetails": [
          "Standard"
        ],
        "IsGlobalExpressEnabled": false,
        "LastUpdateDate": "2022-03-29T01:55:37Z",
        "ShipmentServiceLevelCategory": "Standard"
      }
    ],
    "CreatedBefore": "2022-04-22T07:23:40Z"
  }
}

Tutorial: Cómo recuperar una Order (Pedido) de Regulated information (Información reglamentada)

Este tutorial se muestra cómo recuperar Regulated information (Información reglamentada) asociado con un pedido.

Requisitos previos

Para completar este tutorial, usted necesitará:

La autorización del seller para quien usted está haciendo llamadas. Ver Guía para desarrolladores de la Selling Partner API para más información.
La aprobación de la Directo-a-Consumidor de Entrega (Restringido) papel en su perfil de desarrollador.
El Directo-a-Consumidor de Entrega (Restringido) papel seleccionado en la Aplicación de la página de registro para su aplicación.

Paso 1. Recuperar los Datos Restringidos Token necesario para acceder a Regulated information (Información reglamentada)

Usted necesitará un RDT para recuperar un Order (Pedido) de Regulated information (Información reglamentada) en el paso 2 de este tutorial. Este paso se muestra cómo recuperar la RDT necesaria para el Paso 2.

Llame a la createRestrictedDataToken operación, pasando los siguientes parámetros:

Parámetro	Descripción	Se requiere
restrictedResources	Una lista de recursos restringidos. Tipo: arrayRestrictedResource	Sí

Ejemplo de solicitud:

POST https://sellingpartnerapi-eu.amazon.com/tokens/2021-03-01/restrictedDataToken
{
  "restrictedResources": [
    {
      "method": "GET",
      "path": "/orders/v0/orders/{orderId}/regulatedInfo"
    }
  ]
}

Respuesta

Ver CreateRestrictedDataTokenResponse en las Fichas de referencia de la API para obtener más detalles acerca de las propiedades de respuesta.

Respuesta ejemplo:

{
  "expiresIn": 3600,
  "restrictedDataToken": "Atz..."
}

Guardar el restrictedDataToken valor (RDT) para utilizar en el Paso 2. Recuperar Regulated information (Información reglamentada) asociado con un pedido.

Paso 2. Recuperar Regulated information (Información reglamentada) asociado con un pedido

Llame a la getOrderRegulatedInfo operación, pasando por la orderId por el Order (Pedido) en que se ha regulado la información que se desea recuperar. Asegúrese de incluir los RDT desde el paso previo, en la x-amz-access-token cabecera de su llamada getOrderRegulatedInfo.

El parámetro de la ruta

Parámetro	Descripción	Se requiere
orderId	Amazon definido por el identificador, en 3-7-7 formato. Tipo: string de	Sí

Ejemplo de solicitud:

GET https://sellingpartnerapi-eu.amazon.com/orders/v0/orders/205-1725759-9209952/regulatedInfo

Respuesta

Una respuesta correcta incluye información acerca de la Order (Pedido), si la dosis se requiere la etiqueta, la verificación del estado de la Order (Pedido), y la solicitud de información regulada, en función del estado de la Order (Pedido). Para obtener información detallada acerca de los objetos y propiedades que pueden ser incluidos en una respuesta correcta, consulte OrderRegulatedInfo en la referencia de la API.

Respuesta ejemplo (Order (Pedido) pendiente):

{
  "payload": {
    "AmazonOrderId": "205-1725759-9209952",
    "RequiresDosageLabel": true,
    "RegulatedInformation": {
      "Fields": [
        {
          "FieldLabel": "Species",
          "FieldId": "petsSpecies",
          "FieldValue": "Cat",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Pet name",
          "FieldId": "petsName",
          "FieldValue": "Snowy",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Birth date",
          "FieldId": "petsDateOfBirth",
          "FieldValue": "15 August 2021",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Weight",
          "FieldId": "petsWeight",
          "FieldValue": "1 kg",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Gender",
          "FieldId": "petsGender",
          "FieldValue": "Female",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet lactating?",
          "FieldId": "petsLactating",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet pregnant?",
          "FieldId": "petsPregnant",
          "FieldValue": "Yes",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Pregnancy stage",
          "FieldId": "petsPregnancyStage",
          "FieldValue": "Second trimester",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Does your pet have allergies?",
          "FieldId": "petsAllergies",
          "FieldValue": "Yes",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet neutered?",
          "FieldId": "petsNeutered",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet on any other medication?",
          "FieldId": "petsAdditionalMedicationRadio",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "snowy prescription 1",
          "FieldId": "snowy prescription 1",
          "FieldValue": "https://...",
          "FieldType": "FileAttachment"
        }
      ]
    },
    "RegulatedOrderVerificationStatus": {
      "Status": "Pending",
      "RequiresMerchantAction": true,
      "ValidRejectionReasons": [
        {
          "RejectionReasonId": "shield_pom_v_reject_pregnant_only",
          "RejectionReasonDescription": "Not suitable for pregnant pet"
        }, {
          "RejectionReasonId": "shield_pom_v_reject_product",
          "RejectionReasonDescription": "This product is not suitable"
        }, {
          "RejectionReasonId": "shield_pom_v_reject_reject_age",
          "RejectionReasonDescription": "Your pet is too young for this medicine."
        }
      ]
    }
  }
}

Respuesta ejemplo (aprobado por Order (Pedido)):

{
  "payload": {
    "AmazonOrderId": "205-1725759-9209952",
    "RequiresDosageLabel": true,
    "RegulatedInformation": {
      "Fields": [
        {
          "FieldLabel": "Species",
          "FieldId": "petsSpecies",
          "FieldValue": "Cat",
          "FieldType": "Text"
        }
      ]
    },
    "RegulatedOrderVerificationStatus": {
      "Status": "Approved",
      "RequiresMerchantAction": false,
      "ExternalReviewerId": "externalId",
      "ReviewDate": "1970-01-19T03:59:27Z",
      "ValidRejectionReasons": []
    }
  }
}

Respuesta ejemplo (rechazado Order (Pedido)):

{
  "payload": {
    "AmazonOrderId": "205-1725759-9209952",
    "RequiresDosageLabel": true,
    "RegulatedInformation": {
      "Fields": [
        {
          "FieldLabel": "Species",
          "FieldId": "petsSpecies",
          "FieldValue": "Cat",
          "FieldType": "Text"
        }
      ]
    },
    "RegulatedOrderVerificationStatus": {
      "Status": "Rejected",
      "RequiresMerchantAction": false,
      "ExternalReviewerId": "externalId",
      "ReviewDate": "1970-01-19T03:59:27Z",
      "RejectionReason": {
        "RejectionReasonId": "shield_pom_vps_reject_species",
        "RejectionReasonDescription": "This medicine is not suitable for this pet’s species"
      }
      "ValidRejectionReasons": []
    }
  }
}

Respuesta ejemplo (cancelación del pedido)

{
  "payload": {
    "AmazonOrderId": "202-5156092-2672318",
    "RequiresDosageLabel": false,
    "RegulatedInformation": {
      "Fields": [
        {
          "FieldLabel": "Species",
          "FieldId": "petsSpecies",
          "FieldValue": "Dog",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Birth date",
          "FieldId": "petsDateOfBirth",
          "FieldValue": "8 March 2019",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Weight",
          "FieldId": "petsWeight",
          "FieldValue": "44 kg",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Gender",
          "FieldId": "petsGender",
          "FieldValue": "Male",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Does your pet have allergies?",
          "FieldId": "petsAllergies",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet neutered?",
          "FieldId": "petsNeutered",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet on any other medication?",
          "FieldId": "petsAdditionalMedicationRadio",
          "FieldValue": "No",
          "FieldType": "Text"
        }
      ]
    },
    "RegulatedOrderVerificationStatus": {
      "Status": "Cancelled",
      "RequiresMerchantAction": false,
      "ValidRejectionReasons": []
    }
  }
}

Respuesta ejemplo (Order (Pedido) vencida)

{
  "payload": {
    "AmazonOrderId": "205-2554781-3212354",
    "RequiresDosageLabel": true,
    "RegulatedInformation": {
      "Fields": [
        {
          "FieldLabel": "Species",
          "FieldId": "petsSpecies",
          "FieldValue": "Cat",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Birth date",
          "FieldId": "petsDateOfBirth",
          "FieldValue": "25 January 2020",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Weight",
          "FieldId": "petsWeight",
          "FieldValue": "2 kg",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Gender",
          "FieldId": "petsGender",
          "FieldValue": "Male",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Does your pet have allergies?",
          "FieldId": "petsAllergies",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet neutered?",
          "FieldId": "petsNeutered",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "Is your pet on any other medication?",
          "FieldId": "petsAdditionalMedicationRadio",
          "FieldValue": "No",
          "FieldType": "Text"
        }, {
          "FieldLabel": "JPEG 2 prescription 1",
          "FieldId": "JPEG 2 prescription 1",
          "FieldValue": "https://...",
          "FieldType": "FileAttachment"
        }
      ]
    },
    "RegulatedOrderVerificationStatus": {
      "Status": "Expired",
      "RequiresMerchantAction": false,
      "ValidRejectionReasons": []
    }
  }
}

Tutorial: Cómo aprobar o rechazar regulado con el fin de

Este tutorial muestra cómo para aprobar o rechazar un pedido que contiene Regulated information (Información reglamentada).

Requisitos previos

Para completar este tutorial, usted necesitará:

La autorización del seller para quien usted está haciendo llamadas. Ver Guía para desarrolladores de la Selling Partner API para más información.
La aprobación de la Directo-a-Consumidor de Entrega (Restringido) papel en su perfil de desarrollador.
El Directo-a-Consumidor de Entrega (Restringido) papel seleccionado en la Aplicación de la página de registro para su aplicación.

Paso 1. Aprobar o rechazar regulado con el fin de

Llame a la updateVerificationStatus operación, pasando los siguientes parámetros:

El parámetro de la ruta

Parámetro	Descripción	Se requiere
orderId	Amazon definido por el identificador, en 3-7-7 formato. Tipo: string de	Sí

Cuerpo parámetro

Parámetro	Descripción	Se requiere
regulatedOrderVerificationStatus	La actualización de la verificación de las propiedades de estado. Tipo: UpdateVerificationStatusRequestBody	Sí

Ejemplo de solicitud (Aprobado):

PATCH https://sellingpartnerapi-eu.amazon.com/orders/v0/orders/205-1725759-9209952/regulatedInfo
{
  "regulatedOrderVerificationStatus": {
    "status": "Approved",
    "externalReviewerId": "reviewer1234"
  }
}

Ejemplo de solicitud (Rechazada):

PATCH https://sellingpartnerapi-eu.amazon.com/orders/v0/orders/205-1725759-9209952/regulatedInfo
{
  "regulatedOrderVerificationStatus": {
    "status": "Rejected",
    "externalReviewerId": "reviewer1234",
    "rejectionReasonId": "shield_pom_vps_reject_incorrect_weight"
  }
}

Respuesta

Nota: la Respuesta es vacía para esta operación

Updated over 1 year ago