Guía de casos de uso de la API de orígenes de suministro v2020-07-01

Cómo gestionar las configuraciones y capacidades de los orígenes de suministro del vendedor mediante la API de orígenes de suministro.

Versión de la API: 2020-07-01

¿Qué es la API de orígenes de suministro?

La API de orígenes de suministro se utiliza para configurar y actualizar la información sobre los orígenes de suministro de los vendedores, como tiendas y almacenes. Puedes utilizar la API de orígenes de suministro para crear aplicaciones que utilicen funciones de gestión logística en el nivel de ubicación y que proporcionen información sobre los orígenes de suministro y el inventario en el nivel de ubicación.

Características principales

Esta guía de casos de uso proporciona tutoriales sobre los siguientes procedimientos:

Requisitos

Antes de utilizar la API de orígenes de suministro, tu cuenta de vendedor debe tener permiso para utilizar el Inventario de varias ubicaciones (MLI). Si su cuenta no tiene permisos de MLI, puede solicitar el acceso a través del formulario de registro de inventario de varias ubicaciones. Recibirás una confirmación de que tu cuenta está lista en un plazo de 15 días hábiles.

Una vez que tu cuenta tenga los permisos para utilizar el inventario de varias ubicaciones (MLI), la ubicación predeterminada y cualquier otra ubicación que hayas creado en las plantillas permitidas por la funcionalidad de automatización de la configuración de envío (SSA) se añadirán automáticamente como orígenes de suministro. Si necesitas añadir o actualizar orígenes de suministro, puedes utilizar la API de orígenes de suministro o ir a la pestaña Ubicaciones de la configuración de envíos de Seller Central.

  1. Crea orígenes de suministro nuevos o actualiza los existentes mediante la API de orígenes de suministro o la interfaz de usuario de Seller Central.
  2. Proporciona un inventario específico de la ubicación a través de la API.
  3. Crea o identifica las plantillas existentes permitidas por la funcionalidad de automatización de la configuración de envío (SSA) que incluyen todas las ubicaciones de tu inventario que utilizan esta configuración de envío.
  4. Asigna la plantilla de envíos creada o identificada en el paso 3 a los SKU que has añadido al inventario por ubicación.
  5. Establece el canal de inventario de DEFAULT para 0.
  6. Añade el rol de Información del colaborador comercial a tu perfil de desarrollador.

🚧

El inventario de varias ubicaciones (MLI) no está disponible actualmente para los siguientes vendedores:

  • Vendedores que forman parte del programa Comprar por Internet y recoger en tienda (BOPIS).
  • Vendedores que utilizan el inventario de Logística de Amazon.
  • Vendedores que gestionan su inventario a través de Seller Central.

Tutorial: Configurar un nuevo origen de suministro

Puedes añadir un nuevo origen de suministro mediante la API de orígenes de suministro o a través de Seller Central.

Requisitos

Para completar este tutorial, necesitarás:

Paso 1. Configurar un nuevo origen de suministro mediante la API de orígenes de suministro

POST la API de orígenes de suministro e introduce los siguientes parámetros:

Parámetros de solicitud

Parámetro Descripción Obligatorio
supplySourceCode El vendedor ha proporcionado un identificador único del origen de suministro.

Tipo: cadena

alias El origen de suministro específico. Este campo se mostrará al comprador en los casos de uso pertinentes. El formato debe estar en Store Name – City Name

Tipo: cadena

address La dirección específica del origen de suministro.

Type: Address

Dirección

En la tabla siguiente se muestran los elementos secundarios del elemento address:

Elemento Descripción
name El nombre relacionado con la dirección. Este nombre se le debe mostrar al comprador. El formato debe estar en Store Name – City Name

Tipo: cadena

addressLine1 Un campo de dirección.

Tipo: cadena

addressLine2 Un campo de dirección adicional.

Tipo: cadena

addressLine3 Un campo de dirección adicional.

Tipo: cadena

city La dirección específica del origen de suministro.

Tipo: cadena

county La dirección específica del origen de suministro.

Tipo: cadena

district La dirección específica del origen de suministro.

Tipo: cadena

stateOrRegion El estado o la región específicos de la dirección.

Tipo: cadena

postalCode El código postal de la dirección.

Tipo: cadena

countryCode El código de país de la dirección.

Tipo: cadena

phone El número de teléfono de la dirección del origen de suministro. Este campo se mostrará al comprador en los casos de uso pertinentes dirigidos al comprador.

Tipo: cadena

Respuesta

Una respuesta correcta incluye los siguientes objetos:

Nombre Descripción
supplySourceId El identificador alfanumérico suministrado por Amazon de un origen de suministro. El SupplySourceId es único en todo el mundo.

Tipo: cadena

Ejemplo de respuesta

{ "address": { "name": "ABC Store - Milpitas", "addressLine1": "63 Ranch Dr", "countryCode": "US", "stateOrRegion": "CA", "addressLine2": "", "addressLine3": "", "city": "Milpitas", "county": "Santa Clara", "district": "", "postalCode": "95035", "phone": "1234567890" }, "supplySourceCode": "TestRaghav123", "alias": "ABC Store - Milpitas" }

Paso 2. Configurar un nuevo origen de suministro a través de la configuración de envíos de Seller Central

También puedes añadir un nuevo origen de suministro a través de Seller Central.

  1. Inicia sesión en tu cuenta de Seller Central.
  2. Navega hasta el icono de configuración en la esquina superior derecha y, a continuación, seleccionaShipping Settings.
  3. Seleccione el Locations pestaña.
  4. Elige Add Location para crear una nueva fuente de suministro.
  5. Para realizar cambios en una fuente de suministro existente, seleccione Edit en el lado derecho, junto a la fuente de suministro.
  6. Seleccione Save.

Tutorial: Configurar el estado de un origen de suministro existente

Paso 1. Establecer el estado de tu tienda

PUT el status e indica los siguientes parámetros:

Parámetros de solicitud

Parámetro Descripción Obligatorio
status Especifica el estado del origen de suministro. Los valores válidos son Active y Inactive.

Tipo: cadena

🚧

El estado de la tienda es Inactive por defecto.

Los socios vendedores deben establecer el estado como Active cuando esté listo para salir en vivo.

Ejemplo de respuesta

{ "supplySourceId": "353e4e48-6301-4d50-990e-43a86e8787a3", "supplySourceCode": "ss_ss005", "alias": "SS Store - Milpitas" "status": "Inactive" "address": { "name": "SS Store - Milpitas", "addressLine1": "63 Ranch Dr", "addressLine2": "", "addressLine3": "", "city": "Milpitas", "county": "Santa Clara", "district": "", "stateOrRegion": "CA" "postalCode": "95035", "countryCode": "US", }, "createdAt": "1.678741763E9", "updatedAt": "1.678741763E9" }

Tutorial: Recuperar los detalles de un origen de suministro configurado

Paso 1. Recupera el ID del origen de suministro

GET el supplySourceId. No se requieren parámetros de consulta.

Respuesta

Una respuesta correcta incluye los siguientes objetos:

Nombre Descripción
supplySourceId El identificador alfanumérico suministrado por Amazon de un origen de suministro. El SupplySourceId es único en todo el mundo.

Tipo: cadena

supplySourceCode El identificador único del origen de suministro proporcionado por el vendedor.

Tipo: cadena

alias El nombre del origen de suministro. Este campo se mostrará al comprador en los casos de uso pertinentes.

Tipo: cadena

status El estado de la tienda. Los valores posibles son Active, Inactive y Archived.

Tipo: cadena

address La dirección del origen de suministro.

Type: Address

configuration La configuración del origen de suministro.

Type: SupplySourceConfiguration

capabilities Las capacidades del origen de suministro.

Type: Capabilities

createdAt La fecha y la hora en que se creó el origen de suministro.

Tipo: cadena

updatedAt La fecha y la hora en que se actualizó el origen de suministro.

Tipo: cadena

Tutorial: Actualizar un origen de suministro existente

Paso 1. Configurar el ID del origen de suministro

PUT el supplySourceId e indica los siguientes parámetros:

Parámetros de solicitud

Parámetro Descripción Obligatorio
alias El nombre específico del origen de suministro. Este campo se mostrará al comprador en los casos de uso pertinentes dirigidos a compradores.

Tipo: cadena

configuration La configuración específica del origen de suministro.

Type: SupplySourceConfiguration

capabilities Las capacidades específicas del origen de suministro.

Type: Capabilities

Configuración

En la tabla siguiente se muestran los elementos secundarios del elemento Configuration:

Elemento Descripción
operationalConfiguration La configuración operativa del origen de suministro.

Tipo: OperationalConfiguration

timezone La zona horaria en la que funciona el origen de suministro. Consulta los ID de zona horaria estándar que figuran en RFC 6557.

Tipo: cadena

handlingTime En los casos de uso de entrega, el tiempo que tarda el vendedor en enviar el artículo. En los casos de uso de recogida, el tiempo que necesita el vendedor para tener el artículo listo para su recogida.

Type: Duration

Tiempo de gestión

🚧

HandlingTime es solo para nosotros en el programa BOPIS.

El elemento HandlingTime no se puede utilizar con el inventario de varias ubicaciones (MLI) .

En la tabla siguiente se muestran los elementos secundarios del elemento HandlingTime:

Elemento Descripción
value El tiempo de gestión del origen de suministro.

Type: NonNegativeInteger

timeUnit Las unidades de tiempo utilizadas para medir el tiempo de gestión. Los valores aceptables son Minutes, Hours y Days.

Tipo: cadena

Configuración operativa

En la tabla siguiente se muestran los elementos secundarios del elemento OperationalConfiguration:

Elemento Descripción
contactDetails Los detalles de contacto del origen de suministro.

Type: ContactDetails

operatingHoursByDay El horario de funcionamiento del origen de suministro.

Type: OperatingHoursByDay

throughputConfig La configuración de rendimiento del origen de suministro.

Type: ThroughputConfig

Datos de contacto

En la tabla siguiente se muestran los elementos secundarios del elemento ContactDetails:

Elemento Descripción
primary Los datos del contacto principal en el origen de suministro.

Type: Primary

Principal

En la tabla siguiente se muestran los elementos secundarios del elemento Primary:

Elemento Descripción
email La dirección de correo electrónico de contacto del origen de suministro. Este campo se mostrará al comprador en los casos de uso pertinentes.

Tipo: cadena

phone El número de teléfono de la persona de contacto del origen de suministro.

Tipo: cadena

Horas de operación por día

En la tabla siguiente se muestran los elementos secundarios del elemento OperatingHoursByDay:

Elemento Descripción
monday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

tuesday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

wednesday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

thursday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

friday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

saturday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

sunday La lista de objetos que incluye [{"startTime": "string","endTime": "string"}].

Tipo: objeto

🚧

Formato de hora

The startTime and endTime are ISO 8601 formatted timestamps without dates. The format is HH:mm. For example, 12:30.

Configuración de rendimiento

En la tabla siguiente se muestran los elementos secundarios del elemento ThroughputConfig:

Elemento Descripción
throughputCap El throughputCap del origen de suministro.

Type: ThroughputCap

Límite de rendimiento

En la tabla siguiente se muestran los elementos secundarios del elemento ThroughputCap:

Elemento Descripción
value El valor de throughputCap.

Type: NonNegativeInteger

timeUnit La unidad de tiempo del throughputCap. Los valores aceptables son Minutes, Hours y Days.

Tipo: cadena

Capacidades

En la tabla siguiente se muestran los elementos secundarios del elemento Capabilities:

Elemento Descripción
outbound Las capacidades de salida del origen de suministro.

Tipo: OutboundCapability

Saliente

En la tabla siguiente se muestran los elementos secundarios del elemento Outbound:

Elemento Descripción
isSupported Cuando es TRUE, el origen de suministro admite la capacidad de salida.

Tipo: booleano

operationalConfiguration La estructura de la configuración operativa es la misma que la que aparece en la entidad principal de la configuración. Los valores de la configuración operativa en este nivel sustituyen a los valores mencionados en el nivel de configuración.

Tipo: OperationalConfiguration

returnLocation La dirección de devolución vinculada a la salida del origen de suministro.

Tipo: ReturnLocation

deliveryChannel La configuración operativa del canal de entrega. Solo habrá una respuesta si el origen de suministro admite la entrega.

Type: DeliveryChannel

pickupChannel La configuración operativa del canal de recogida. Solo habrá una respuesta si el origen de suministro admite la recogida.

Tipo: PickupChannel

Ubicación de devolución

En la tabla siguiente se muestran los elementos secundarios del elemento ReturnLocation:

Elemento Descripción
addressWithContact La información de contacto para la capacidad de devolución.

Tipo: AddressWithContact

supplySourceId El identificador alfanumérico suministrado por Amazon de un origen de suministro. El SupplySourceId es único en todo el mundo.

Tipo: cadena

Dirección con contacto

En la tabla siguiente se muestran los elementos secundarios del elemento AddressWithContact:

Elemento Descripción
address La dirección de la ubicación de devolución.

Type: Address

contactDetails Los datos de contacto de la ubicación de devolución.

Type: ContactDetails

Canal de entrega

En la tabla siguiente se muestran los elementos secundarios del elemento DeliveryChannel:

Elemento Descripción
isSupported Si es VERDADERO, el vendedor puede realizar entregas desde el origen de suministro.

Tipo: booleano

operationalConfiguration La estructura de la configuración operativa es la misma que la que aparece en la entidad principal de la configuración. Los valores de la configuración operativa en este nivel sustituyen a los valores mencionados en el nivel de configuración.

Tipo: OperationalConfiguration

Canal de recogida

En la tabla siguiente se muestran los elementos secundarios del elemento PickupChannel:

Elemento Descripción
isSupported Si es TRUE, el vendedor puede admitir la recogida en la tienda desde el origen de suministro.

Tipo: booleano

inventoryHoldPeriod El tiempo que un artículo permanecerá en el origen de suministro una vez que esté listo para ser recogido.

Type: Duration

operationalConfiguration La estructura de la configuración operativa es la misma que la que aparece en la entidad principal de la configuración. Los valores de la configuración operativa en este nivel sustituyen a los valores mencionados en el nivel de configuración.

Tipo: OperationalConfiguration

Periodo de retención de inventario

En la tabla siguiente se muestran los elementos secundarios del elemento InventoryHoldPeriod:

Elemento Descripción
value El tiempo que un artículo permanecerá en el origen de suministro una vez que esté listo para su recogida.

Type: NonNegativeInteger

timeUnit Las unidades de tiempo utilizadas para medir el tiempo de retención del inventario. Los valores aceptables son Minutes, Hours y Days.

Tipo: cadena

Tutorial: Practicar la incorporación de un vendedor de principio a fin con un SKU

Paso 1. Crear el origen de suministro

Ejemplo de solicitud

POST: {{baseUrl}}/supplySources/2020-07-01/supplySources
{ "address": { "name": "SS Store - Milpitas", "addressLine1": "63 Ranch Dr", "countryCode": "US", "stateOrRegion": "CA", "addressLine2": "", "addressLine3": "", "city": "Milpitas", "county": "Santa Clara", "district": "", "postalCode": "95035", "phone": "1234567890" }, "supplySourceCode": "ss_ss005", "alias": "SS Store - Milpitas" }

Ejemplo de respuesta

{ "supplySourceId": "353e4e48-6301-4d50-990e-43a86e8787a3", "supplySourceCode": "ss_ss005" }

Paso 2. Obtener el origen de suministro

Ejemplo de solicitud

GET: {{baseUrl}}/supplySources/2020-07-01/supplySources/353e4e48-6301-4d50-990e-43a86e8787a3

Ejemplo de respuesta

{ "supplySourceId": "353e4e48-6301-4d50-990e-43a86e8787a3", "supplySourceCode": "ss_ss005", "alias": "SS Store - Milpitas" "status": "Inactive" "address": { "name": "SS Store - Milpitas", "addressLine1": "63 Ranch Dr", "addressLine2": "", "addressLine3": "", "city": "Milpitas", "county": "Santa Clara", "district": "", "stateOrRegion": "CA" "postalCode": "95035", "countryCode": "US", }, "createdAt": "1.678741763E9", "updatedAt": "1.678741763E9" }

Paso 3. Actualizar el estado de la configuración

Ejemplo de solicitud

PUT: {{baseUrl}}/supplySources/2020-07-01/supplySources/353e4e48-6301-4d50-990e-43a86e8787a3

Ejemplo de respuesta

{ "alias": "SS Store - Milpitas", "configuration": { "operationalConfiguration": { "contactDetails": { "countryCode": { "primary": { "email": "test324@gmail.com", "phone": "4813924781" } }, "throughputConfig": { "throughputCap": { "value": 1, "timeUnit": "Days" }, "throughputUnit": "ORDERS" }, "handlingTime": { "value": 1, "timeUnit": "Hours" }, "operatingHoursByDay": { "monday": { "startTime": "00:59", "endTime": "06:01" }, "tuesday": { "startTime": "00:59", "endTime": "06:01" }, "wednesday": { "startTime": "00:59", "endTime": "06:01" }, "thursday": { "startTime": "00:59", "endTime": "06:01" }, "friday": { "startTime": "00:59", "endTime": "06:01" }, "saturday": { "startTime": "00:00", "endTime": "00:00" }, "sunday": { "startTime": "00:00", "endTime": "00:00" } } }, "timezone": "Africa/Accra" }, "capabilities": { "outbound": { "isSupported": true, "operationalConfiguration": { "contactDetails": { "email": "test324@gmail.com", "phone": "4813924781" } }, "throughputConfig": { "throughputCap": { "value": 1, "timeUnit": "Days" }, "throughputUnit": "ORDERS" }, "handlingTime": { "value": 1, "timeUnit": "Hours" }, "operatingHoursByDay": { "monday": { "startTime": "00:59", "endTime": "06:01" }, "tuesday": { "startTime": "00:59", "endTime": "06:01" }, "wednesday": { "startTime": "00:59", "endTime": "06:01" }, "thursday": { "startTime": "00:59", "endTime": "06:01" }, "friday": { "startTime": "00:59", "endTime": "06:01" }, "saturday": { "startTime": "00:00", "endTime": "00:00" }, "sunday": { "startTime": "00:00", "endTime": "00:00" } } } }, "createdAt": "1.678741763E9", "updatedAt": "1.678741763E9" } }

Paso 4. Actualizar el estado del origen de suministro

Ejemplo de solicitud

PUT: {{baseUrl}}/supplySources/2020-07-01/supplySources/353e4e48-6301-4d50-990e-43a86e8787a3/status

Respuesta

1

Paso 5. Obtener el origen de suministro

Ejemplo de solicitud

GET: {{baseUrl}}/supplySources/2020-07-01/supplySources/353e4e48-6301-4d50-990e-43a86e8787a3

Ejemplo de respuesta

{ "supplySourceId": "353e4e48-6301-4d50-990e-43a86e8787a3", "supplySourceCode": "ss_ss005", "alias": "SS Store - Milpitas", "status": "Active", "address": { "name": "SS Store - Milpitas", "addressLine1": "63 Ranch Dr", "addressLine2": "", "addressLine3": "", "city": "Milpitas", "county": "Santa Clara", "district": "", "stateOrRegion": "CA", "postalCode": "95035", "countryCode": "US" }, "configuration": { "operationalConfiguration": { "contactDetails": { "countryCode": { "primary": { "email": "test324@gmail.com", "phone": "4813924781" } }, "throughputConfig": { "throughputCap": { "value": 1, "timeUnit": "Days" }, "throughputUnit": "ORDERS" }, "handlingTime": { "value": 1, "timeUnit": "Hours" }, "operatingHoursByDay": { "monday": { "startTime": "00:59", "endTime": "06:01" }, "tuesday": { "startTime": "00:59", "endTime": "06:01" }, "wednesday": { "startTime": "00:59", "endTime": "06:01" }, "thursday": { "startTime": "00:59", "endTime": "06:01" }, "friday": { "startTime": "00:59", "endTime": "06:01" }, "saturday": { "startTime": "00:00", "endTime": "00:00" }, "sunday": { "startTime": "00:00", "endTime": "00:00" } } }, "timezone": "Africa/Accra" }, "capabilities": { "outbound": { "isSupported": true, "operationalConfiguration": { "contactDetails": { "email": "test324@gmail.com", "phone": "4813924781" } }, "throughputConfig": { "throughputCap": { "value": 1, "timeUnit": "Days" }, "throughputUnit": "ORDERS" }, "handlingTime": { "value": 1, "timeUnit": "Hours" }, "operatingHoursByDay": { "monday": { "startTime": "00:59", "endTime": "06:01" }, "tuesday": { "startTime": "00:59", "endTime": "06:01" }, "wednesday": { "startTime": "00:59", "endTime": "06:01" }, "thursday": { "startTime": "00:59", "endTime": "06:01" }, "friday": { "startTime": "00:59", "endTime": "06:01" }, "saturday": { "startTime": "00:00", "endTime": "00:00" }, "sunday": { "startTime": "00:00", "endTime": "00:00" } } } }, "createdAt": "1.678741763E9", "updatedAt": "1.678741763E9" } }

Tutorial: Recuperar el fichero de gestión logística de pedidos

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:include schemaLocation="amzn-base.xsd"/> <xsd:element name="OrderFulfillment"> <xsd:complexType> <xsd:sequence> <xsd:choice> <xsd:element ref="AmazonOrderID"/> <xsd:element ref="MerchantOrderID"/> </xsd:choice> <xsd:element name="MerchantFulfillmentID" type="IDNumber" minOccurs="0"/> <xsd:element name="FulfillmentDate" type="xsd:dateTime"/> <xsd:element name="FulfillmentData" minOccurs="0"> <xsd:complexType> <xsd:sequence> <xsd:element ref="CarrierCode" minOccurs="0"/> <xsd:element name="CarrierName" type="String" minOccurs="0"/> <xsd:element name="ShippingMethod" type="String" minOccurs="0"/> <xsd:element name="ShipperTrackingNumber" type="String" minOccurs="0"/> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="CODCollectionMethod" minOccurs="0"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="DirectPayment"/> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Item" minOccurs="0" maxOccurs="unbounded"> <xsd:complexType> <xsd:sequence> <xsd:choice> <xsd:element ref="AmazonOrderItemCode"/> <xsd:element ref="MerchantOrderItemID"/> </xsd:choice> <xsd:element name="MerchantFulfillmentItemID" type="IDNumber" minOccurs="0"/> <xsd:element name="Quantity" type="xsd:positiveInteger" minOccurs="0"/> <xsd:element name="TransparencyCode" type="xsd:string" minOccurs="0" maxOccurs="10"/> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="ShipFromAddress" type="AddressType" minOccurs="0" /> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>

¿Te ha ayudado esta página?