Detalles de Conexión de Amazon Marketplace¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión de Amazon Marketplace

El conector aprovecha la API de Amazon Marketplace para habilitar el acceso bidireccional a Amazon Marketplace.

Establecer una Conexión¶

Conexión a Amazon Marketplace¶

API de Amazon MWS Frente a API de Socio de Ventas¶

La API de Amazon MWS ( Marketplace Web Services) es la API más antigua para Amazon Marketplace, mientras que la API de socio de ventas (SP) proporciona una serie de mejoras sobre la API de MWS, incluidos los estándares de diseño de API REST basados en JSON y OAuth 2.0. SP- API incluye todas las funciones disponibles en Amazon MWS API.

Puede especificar a qué API conectarse configurando Schema. Tenga en cuenta que cada API tiene diferentes opciones de conexión disponibles, como se describe a continuación.

Conexión a la API de Socio Vendedor¶

Al utilizar la API de socio vendedor de Amazon para conectarse a Amazon Marketplace, se requieren las siguientes propiedades:

• Schema: Establézcalo en SellingPartner.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• Marketplace: establezca esto en la región de Marketplace en la que está registrado para vender.

Además, puedes usar el SellingPartner propiedad a elegir Seller o Vendor autenticación.

Conexión a la API de MWS¶

Al utilizar la API de Amazon MWS para conectarse a Amazon Marketplace, SellerId, Marketplace, Marketplace son propiedades de conexión requeridas. Colocar Schema a Marketplace.

Configurar el Acceso a Amazon Marketplace¶

Para conectarse a Amazon Marketplace, primero autorice al desarrollador. Para hacerlo, siga los pasos a continuación:

• Usando la identificación del desarrollador de MWS: 195280669143.
• Ve a la Manage your apps página en Seller Central e inicie sesión en su cuenta de vendedor de Amazon como titular principal de la cuenta.
• Haga clic en el Authorize new developer y sigue el flujo de trabajo de autorización utilizando el ID de desarrollador proporcionado por el conector.

O puede ir a Controlador de Amazon Marketplace y haga clic en Authorize Now en el panel derecho.

Obtención del Token de Autenticación de MWS¶

Para obtener el token de autenticación MWS, siga los pasos a continuación:

• Ve a la Manage your apps página en Seller Central e inicie sesión en su cuenta de vendedor de Amazon como titular principal de la cuenta.
• Encuentra la aplicación.
• Debajo de la columna del token de autenticación de MWS, haga clic en View.

Obtención del ID del Vendedor¶

Para obtener el ID de vendedor, siga los pasos a continuación:

• Inicie sesión en su cuenta de vendedor.
• Seleccionar Settings, entonces Account Info en la parte superior derecha de la pantalla.
• Bajo Business Information seleccione "Su token de comerciante".

Autenticar una Cuenta de Amazon Marketplace¶

Establezca las siguientes propiedades de conexión para conectarse:

• SellerId: establezca la ID de vendedor de la configuración del servicio web del mercado de Amazon.
• Marketplace: Establecer la ubicación del mercado de Amazon (Estados Unidos, Canadá, Japón, etc.).
• Schema: establecer el esquema en Marketplace.

Autenticar Usando la Autenticación OAuth¶

Amazon Marketplace utiliza el estándar de autenticación OAuth.

Para autenticarse mediante OAuth, deberá utilizar las Credenciales integradas o cree una nueva aplicación OAuth personalizada (consulte Creación de una aplicación OAuth personalizada).

Política de Retención de Datos de Amazon Marketplace¶

Por seguridad, Amazon Marketplace restringe el acceso a PII (Información de identificación personal). Solo puede conservar la PII durante 30 días después de la entrega del pedido y solo con el propósito de, y durante el tiempo que sea necesario para

• cumplir pedidos
• calcular y remitir impuestos
• producir facturas de impuestos
• cumplir con los requisitos legales, incluidos los requisitos fiscales o reglamentarios.

Si la ley le exige que conserve copias de archivo de la PII con fines impositivos u otros fines normativos, debe almacenar la PII como una copia de seguridad cifrada "en frío" o fuera de línea (p. ej., no disponible para uso inmediato o interactivo).

Esto significa, por ejemplo, que el controlador de Amazon Marketplace ya no muestra la información de la dirección de envío del cliente después de 30 días. Consulte la documentación de Amazon para obtener más información:

Política de protección de datos de Amazon Marketplace

Uso de la Autenticación OAuth¶

Utilice el estándar de autenticación OAuth para conectarse a Amazon Marketplace. Puede autenticarse con una cuenta de usuario o una cuenta de servicio. El conector facilita esto como se describe a continuación.

Uso de una Cuenta de Usuario para Autenticarse en Amazon Marketplace¶

El flujo de la cuenta de usuario requiere que el usuario que se autentica interactúe con Amazon Marketplace a través del navegador.

Credenciales Integradas¶

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas¶

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret. También puedes usar el OAuthAppStatus propiedad a elegir draft o published estado. Debe especificar esta propiedad cuando utilice credenciales personalizadas.

Cuándo Crear una Aplicación OAuth Personalizada¶

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Amazon Marketplace y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Amazon Marketplace para otorgar permisos al conector.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas¶

Autenticarse con las Credenciales de OAuth Integradas¶

Autenticación de Escritorio con la Aplicación OAuth Integrada¶

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas¶

Puede usar una aplicación OAuth personalizada para autenticarse con una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Autenticarse con una Cuenta de Usuario¶

Autenticación de Escritorio con una Aplicación OAuth Personalizada¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga y actualice el token de acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• AppId: ID de aplicación para la aplicación de socio de ventas que creó.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.
• AWSAccessKey: esta es la clave de acceso vinculada al usuario de AWS que está asociado con OAuthClientId.
• AWSSecretKey: esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Actualiza el token de acceso cuando caduca.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

Las siguientes secciones muestran cómo autenticar un servidor sin periféricos u otra máquina en la que el conector no puede abrir un navegador. Puede autenticarse con una cuenta de usuario o con una cuenta de servicio.

Autenticarse con una Cuenta de Usuario¶

Para autenticarse con una cuenta de usuario, debe hacerlo desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales de OAuth Integradas¶

Obtenga un código verificador

Siga los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión:

1. Haga clic en el siguiente enlace para abrir el extremo de OAuth de Amazon Marketplace en su navegador.
2. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador como valor para 'spapi_oauth_code'.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth.

• OAuthVerifier: Establézcalo en el código del verificador.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.
• AppId: ID de aplicación para la aplicación de socio de ventas que creó.
• AWSAccessKey: esta es la clave de acceso vinculada al usuario de AWS que está asociado con OAuthClientId.
• AWSSecretKey: esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.

Pruebe la conexión para autenticarse en el navegador. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.
• AppId: ID de aplicación para la aplicación de socio de ventas que creó.
• AWSAccessKey: esta es la clave de acceso vinculada al usuario de AWS que está asociado con OAuthClientId.
• AWSSecretKey: esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Cree una aplicación OAuth personalizada

La creación de una aplicación de OAuth personalizada es opcional en el flujo de OAuth sin interfaz; puede omitir la creación de una aplicación conectándose con las credenciales de OAuth integradas del conector. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Amazon Marketplace para otorgar permisos al conector.

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador como valor para 'spapi_oauth_code'.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.
• AppId: ID de aplicación para la aplicación de socio de ventas que creó.
• AWSAccessKey: esta es la clave de acceso vinculada al usuario de AWS que está asociado con OAuthClientId.
• AWSSecretKey: esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• Marketplace: establezca esto en la región de The Marketplace en la que está registrado para vender.
• Schema: establezca esto en 'Socio de ventas' para conectarse a SP- API.
• AppId: ID de aplicación para la aplicación de socio de ventas que creó.
• AWSAccessKey: esta es la clave de acceso vinculada al usuario de AWS que está asociado con OAuthClientId.
• AWSSecretKey: esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.

Creación de una Aplicación OAuth Personalizada¶

Puede usar una aplicación OAuth personalizada para autenticar una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Usuario¶

Siga el procedimiento a continuación para registrar una aplicación y obtener el OAuthClientId y OAuthClientSecret.

Crear una Aplicación OAuth Personalizada¶

1. Inicie sesión en la Consola de socio vendedor y abra Develop Apps from Apps & Services.

2. Haga clic en Add new app client.

3. Proporcione el nombre de la aplicación y seleccione SP-API como el tipo de API.

4. Proporcione el ARN de IAM para la cuenta de AWS y seleccione vendedores.

5. Proporcione los valores de URI de inicio de sesión de OAuth y URI de redirección de OAuth. Después de crear la aplicación, OAuthClientId y OAuthClientSecret se muestran debajo de LWA credentials.

Para obtener una lectura más detallada sobre cómo crear una aplicación OAuth personalizada y configurar el rol de IAM, consulte la Guía de socios vendedores de Amazon.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de características avanzadas del conector de Amazon Marketplace.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Amazon Marketplace le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Orders WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

Jitterbit Connector for Amazon Marketplace modela los objetos de Amazon Marketplace como tablas y vistas relacionales. Un objeto de Amazon Marketplace tiene relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas. Las siguientes secciones muestran los objetos de API disponibles y brindan más información sobre cómo ejecutar SQL en las APIs de Amazon Marketplace.

Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto.

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a las APIs de Amazon Marketplace y luego procesa el resto de la consultar en la memoria. Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Usando la API del Marketplace

Consulte Modelo de datos de Marketplace para las entidades disponibles en Marketplace API.

Usando la API de socio vendedor

Consulte Modelo de datos del socio vendedor para las entidades disponibles en la API de socio vendedor.

Modelo de Datos del Marketplace¶

Jitterbit Connector for Amazon Marketplace modela la API de Amazon Marketplace como vistas relacionales y procedimientos almacenados.

Para usar el modelo de datos de Marketplace, simplemente configure Schema a Marketplace.

Puntos de Vista¶

Puntos de vista son tablas que no se pueden modificar, como Pedidos, Productos. Normalmente, los datos del modelo que son de solo lectura y no se pueden actualizar se muestran como vistas.

Procedimientos Almacenados¶

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para buscar, actualizar y modificar información en la fuente de datos.

Uso de Informes¶

Los informes creados se pueden exponer como vistas configurando IncludeReports propiedad de conexión a verdadero. Los informes se pueden crear con el procedimiento almacenado RequestReport.

Una vez que se ha creado un informe y se ha terminado de procesar con un estado _DONE_, se mostrará como una vista con el nombre "Informe{ReportType}{ReportID}".

Solo los informes delimitados por tabuladores se pueden usar como vistas. Puede encontrar una lista completa de informes aquí: Tipos de informes.

Para evitar la limitación de API, se sugiere utilizar CreateSchema procedimiento almacenado* para crear esquemas de tablas de informes.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Amazon Marketplace¶

FeedSubmissionList¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM FeedSubmissionList WHERE FeedSubmissionId = '50377017868'

SELECT * FROM FeedSubmissionList WHERE FeedType = '_POST_PRODUCT_DATA_

SELECT * FROM FeedSubmissionList WHERE SubmittedDate = '2018-12-03T09:42:06'

SELECT * FROM FeedSubmissionList WHERE FeedProcessingStatus = '_DONE_'

Columnas¶

FeedSubmissionResult¶

La operación GetFeedSubmissionResult devuelve el informe de procesamiento de feeds para un feed específico.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM FeedSubmissionResult WHERE FeedSubmissionId = '50377017868'

Columnas¶

Artículos de Envío Entrantes¶

Devuelve una lista de artículos en un envío entrante especificado.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Envíos Entrantes¶

Devuelve una lista de envíos entrantes según los criterios que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Suministro de Inventario¶

Devuelve información sobre la disponibilidad del inventario que tiene un vendedor en la red logística de Amazon y en los envíos entrantes actuales. Puede comprobar el estado de disponibilidad actual de su inventario de Logística de Amazon, así como descubrir cuándo cambia el estado de disponibilidad.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM InventorySupply WHERE SellerSKU = 'Stest'

SELECT * FROM InventorySupply WHERE  QueryStartDateTime = '2016-03-16'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Encargar Artículos¶

Devuelve los artículos del pedido en función del ID de pedido de Amazon que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. La tabla OrderItems admite el filtrado del lado del servidor con operadores = e IN para el campo AmazonOrderId. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

SELECT * FROM OrderItems WHERE AmazonOrderId IN ('503-9993250-1405404', '503-9993250-1405404')

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Pedidos¶

Devuelve los pedidos creados o actualizados durante un período de tiempo que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Columnas¶

Productos¶

La Tabla de productos lo ayuda a obtener información para hacer coincidir sus productos con las listas de productos existentes en los sitios web de Amazon Marketplace.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Products WHERE SearchTerms = '249-7638334-8161403'

SELECT * FROM Products WHERE idType = 'SellerSKU' AND idlist = '{SellerSku code}'

SELECT * FROM Products WHERE idType = 'ASIN' AND idlist = '{ASIN code}'

SELECT * FROM Products WHERE idType = 'GCID' AND idlist = '{GCID code}'

SELECT * FROM Products WHERE idType = 'UPC' AND idlist = '{UPC code}'

SELECT * FROM Products WHERE idType = 'EAN' AND idlist = '{EAN code}'

SELECT * FROM Products WHERE idType = 'ISBN' AND idlist = '{ISBN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist = '{JAN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist IN ('{JAN code}', '{ISBN code}', '{GCID code}')

Columnas¶

Lista de Informes¶

Información de uso para la operación ReportList.rsd.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM ReportList WHERE ReportType IN '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportList WHERE AvailableDate > '2016-12-12' AND AvailableDate< '2018-11-12 12:00:00'

SELECT * FROM ReportList WHERE AvailableDate >= '2016-12-12' AND Acknowledged = 'true'

Columnas¶

ReportRequestList¶

Información de uso para la operación ReportRequestList.rsd.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM ReportRequestList WHERE ReportType = '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportRequestList WHERE ReportType IN ('_GET_MERCHANT_LISTINGS_INACTIVE_DATA_', '_GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_')

SELECT * FROM ReportRequestList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportRequestList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12'

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12' and RequestedDate > '2018-12-12 13:00'

SELECT * FROM ReportRequestList WHERE RequestedDate <= '2016-12-12' AND ReportProcessingStatus = '_DONE_'

SELECT * FROM ReportRequestList WHERE ReportProcessingStatus IN ('_DONE_', '_SUBMITTED_', '_CANCELLED_')

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos Almacenados¶

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Jitterbit Connector para Procedimientos Almacenados de Amazon Marketplace¶

Cancelar Feed¶

CancelFeed cancela uno o más envíos de feeds y devuelve un recuento de los envíos de feeds cancelados y la información de envío de feeds. Tenga en cuenta que si no especifica un FeedSubmmissionId, todos los envíos de feeds se cancelarán.

Aporte¶

Columnas del Conjunto de Resultados¶

CancelarSolicitudes de Informe¶

La operación CancelReportRequests cancela una o más solicitudes de informe y devuelve el número de solicitudes de informe canceladas y la información de solicitud de informe.

Aporte¶

Columnas del Conjunto de Resultados¶

CrearEsquema¶

Crea un archivo de esquema para la tabla o vista especificada.

Aporte¶

Columnas del Conjunto de Resultados¶

Obtener Informe¶

Crea y/o devuelve datos para un informe específico.

Ejecutar¶

Podemos usar GetReport procedimiento almacenado* de dos maneras:
Para crear y descargar un informe, en cuyo caso debe establecer al menos los atributos ReportType, StartDate y DownloadPath. El procedimiento almacenado* esperará hasta que el informe se procese en el lado del servidor.

EXEC GetReport
@ReportType = '_GET_FLAT_FILE_ORDERS_DATA_',
@StartDate = '08-27-2020',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Para descargar un informe existente, en cuyo caso debe establecer al menos los atributos ReportID y DownloadPath, por ejemplo:

EXEC GetReport
@ReportID = '50815018501',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Note: Este procedimiento hace uso de indexed parameters. Estos parámetros de entrada se indican con un # carácter al final de sus nombres.

Los parámetros indexados facilitan el suministro de múltiples instancias de un solo parámetro como entradas para el procedimiento.

Supongamos que hay un parámetro de entrada llamado Param#. Ingrese múltiples instancias de un parámetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Aporte

Columnas del conjunto de resultados

Solicitud de Informe¶

La operación RequestReport crea una solicitud de informe.

Note: Este procedimiento hace uso de indexed parameters. Estos parámetros de entrada se indican con un # carácter al final de sus nombres.

Los parámetros indexados facilitan el suministro de múltiples instancias de un solo parámetro como entradas para el procedimiento.

Supongamos que hay un parámetro de entrada llamado Param#. Ingrese múltiples instancias de un parámetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Aporte¶

Columnas del Conjunto de Resultados¶

EnviarImagenFeed¶

El feed de imágenes le permite cargar varias imágenes para un producto. Amazon puede mostrar varias imágenes para cada producto.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO ImageFeedAggregate#TEMP (SKU,ImageType,ImageLocation,OperationType) VALUES ('15700','Main','https://www.cdata.com/ui/img/home/adapters.png','Update')

Luego ejecuta el procedimiento especificando el valor de ImageFeedAggregate con el nombre de la tabla #TEMP used ImageFeedAggregate#TEMP.

EXEC SubmitImageFeed ProductImageFeedAggregate = 'ImageFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarInventarioFeed¶

El feed de inventario le permite actualizar las cantidades de inventario (niveles de existencias) de sus artículos.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada.

Debes incluir en tu consultar:

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('15700',11 ,'2')

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('99987867',10 ,'2')

Luego ejecuta el procedimiento especificando el valor de InventoryFeedAggregate con el nombre de la tabla #TEMP used InventoryFeed#TEMP.

EXEC SubmitInventoryFeed InventoryFeedAggregate='InventoryFeed#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarPedidoAgradecimientoFeed¶

El feed de Reconocimiento de pedidos le permite reconocer su éxito o fracaso al descargar un pedido.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada.

Debes incluir en tu consultar:

INSERT INTO OrderAcknowledgementFeedAggregate#TEMP (AmazonOrderId,StatusCode,AmazonOrderItemCode,CancelReason) VALUES ('249-6070298-2783041','Failure','25959136016214','NoInventory')

Luego ejecuta el procedimiento especificando el valor de OrderAcknowledgementFeedAggregate con el nombre de la tabla #TEMP used OrderAcknowledgementFeedAggregate#TEMP.

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate = 'OrderAcknowledgementFeedAggregate#TEMP'

La información agregada se puede ingresar especificándola en este formato XML

<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate='<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>'

Aporte

Columnas del conjunto de resultados

EnviarOrderAdjustmentFeed¶

El feed de ajuste de pedidos le permite emitir un reembolso (ajuste) para un pedido. Debe proporcionar un motivo para el ajuste, como Devolución del cliente, y el monto del ajuste, desglosado por componente del precio (principal, envío, impuestos, etc.).

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO ItemPriceAdjustmentsAggregate#TEMP (ItemPriceAdjustmentsComponentType,ItemPriceAdjustmentsComponentAmount,ItemPriceAdjustmentsComponentAmountCurrency) VALUES ('Shipping','150','JPY')

INSERT INTO AdjustedItemAggregate#TEMP (AdjustedItemAmazonOrderItemCode,AdjustedItemAdjustmentReason,ItemPriceAdjustmentsAggregate) VALUES ('25959136016214','CustomerReturn','ItemPriceAdjustmentsAggregate#TEMP')

INSERT INTO OrderAdjustmentFeedAggregate#TEMP (AmazonOrderID,OperationType,AdjustedItemAggregate) VALUES ('249-6070298-2783041','Update','AdjustedItemAggregate#TEMP')

Luego ejecuta el procedimiento especificando el valor de OrderAdjustmentFeedAggregate con el nombre de la tabla #TEMP used OrderAdjustmentFeedAggregate#TEMP.

EXEC SubmitOrderAdjustmentFeed OrderAdjustmentFeedAggregate = 'OrderAdjustmentFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarPedidoCumplimientoFeed¶

El feed de Cumplimiento de pedidos permite que su sistema actualice el sistema de Amazon con información de cumplimiento de pedidos.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO ItemAggregate#TEMP (ItemAmazonOrderItemCode,ItemQuantity) VALUES ('25959136016214','1');

INSERT INTO OrderFulfillmentFeedAggregate#TEMP (AmazonOrderID,FulfillmentDate,FulfillmentDataCarrierName,FulfillmentDataShippingMethod,FulfillmentDataShipperTrackingNumber,ItemAggregate) VALUES ('249-6070298-2783041','2017-02-01T00:00:00Z',' Delivery Company','Normal Delivery','1223525345234','ItemAggregate#TEMP')

Luego ejecuta el procedimiento especificando el valor de OrderFulfillmentFeedAggregate con el nombre de la tabla #TEMP used OrderFulfillmentFeedAggregate#TEMP.

EXEC SubmitOrderFulfillmentFeed OrderFulfillmentFeedAggregate = 'OrderFulfillmentFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarAnularFeed¶

El feed Anular le permite establecer una excepción a la configuración de envío a nivel de cuenta para un producto individual (SKU).

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,IsShippingRestricted) VALUES ('Std JP Kanto8','true')

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,Type,ShipAmount,ShipAmountCurrency) VALUES ('Std JP Kantoa8','Exclusive','400.0','JPY')

INSERT INTO OverrideFeedAggregate#TEMP (SKU,OperationType,ShippingOverrideAggregate) VALUES ('15700','Update','ShippingOverrideAggregate#TEMP')

Luego ejecuta el procedimiento especificando el valor de OverrideFeedAggregate con el nombre de la tabla #TEMP used OverrideFeedAggregate#TEMP.

EXEC SubmitOverrideFeed OverrideFeedAggregate = 'OverrideFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarPrecioFeed¶

El feed de precios le permite establecer el precio actual y el precio de venta (cuando corresponda) de un artículo.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('15700','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('99987867','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

Luego ejecuta el procedimiento especificando el valor de PriceFeedAggregate con el nombre de la tabla #TEMP used PriceFeedAggregate#TEMP.

EXEC SubmitPriceFeed PriceFeedAggregate = 'PriceFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarProductFeed¶

El feed de productos contiene información descriptiva sobre los productos de su catálogo. Esta información le permite a Amazon crear un registro y asignar un identificador único conocido como ASIN (Número de artículo estándar de Amazon) a cada producto.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada.

SubmitProductFeed tiene dos agregados principales que deben ingresarse.

• ProductDescriptionDataAgregate
• Agregado de datos de producto

Debes incluir en tu consultar:

La información de ProductDescriptionDataAgregate debe ingresarse mediante la tabla temporal ProductDescriptionDataAggregate#TEMP.

INSERT INTO ProductDescriptionDataAggregate#TEMP (Title,Brand,Description,BulletPoint,Manufacturer) VALUES ('test Title','test Brand','test Description','test BulletPoint','test Manufacturer')

La información agregada de ProductData varía según la categoría utilizada. La lista de todos los XSD proporcionados por Amazon se puede encontrar aquí https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Product.xsd

Este ejemplo usará la categoría Deportes. https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Sports.xsd

Para agregar un ProductData válido, Sports.xsd debe seguirse minuciosamente y el agregado xml debe crearse correctamente. Este ejemplo tiene los siguientes datos de producto

• ProductType = SportingGoods
• Parentesco = Padre
• Tema de variación = Tamaño (según el tipo de producto seleccionado, algunos de los temas de variación no serán válidos. En este ejemplo, la variación de diseño no es válida).
• Talla = S
• MaterialComposición = Metal

Siguiendo el orden del archivo Sports.xsd XSD, el agregado es:

<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>

Este Agregado es el valor de ProductDataAggregate.

INSERT INTO ProductFeedAggregate#TEMP(SKU,ProductDescriptionDataAggregate,ProductDataAggregate) VALUES ('test SKU','ProductDescriptionDataAggregate#TEMP','<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>')

Luego ejecuta el procedimiento especificando el valor de ProductFeedAggregate con el nombre de la tabla #TEMP used ProductFeedAggregate#TEMP.

EXEC SubmitProductFeed ProductFeedAggregate = 'ProductFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarRelaciónFeed¶

El feed Relación le permite configurar relaciones opcionales entre artículos en su catálogo.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationshipFeedAggregate#TEMP(ParentSKU,RelationAggregate) VALUES ('15700','RelationAggregate#TEMP')

Luego ejecuta el procedimiento especificando el valor de RelationshipFeedAggregate con el nombre de la tabla #TEMP used RelationshipFeedAggregate#TEMP.

EXEC SubmitRelationshipFeed RelationshipFeedAggregate = 'RelationshipFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

EnviarAbastecimientoOnDemandFeed¶

Información de uso para la operación SubmitSourcingOnDemandFeed.rsb.

Ejecutar¶

El controlador utiliza tablas #TEMP como campos para la información agregada ingresada

Debes incluir en tu consultar:

INSERT INTO OrderSourcingOnDemandFeedAggregate#TEMP (AmazonOrderID,SKU,EstimatedShipDate) VALUES ('250-4747727-9303810','15700','2018-12-08T00:00:00Z');

Luego ejecuta el procedimiento especificando el valor de OrderSourcingOnDemandFeedAggregate con el nombre de la tabla #TEMP used OrderSourcingOnDemandFeedAggregate#TEMP.

EXEC SubmitSourcingOnDemandFeed OrderSourcingOnDemandFeedAggregate = 'OrderSourcingOnDemandFeedAggregate#TEMP'

Aporte

Columnas del conjunto de resultados

Modelo de Datos de Socio Vendedor¶

Jitterbit Connector for Amazon Marketplace modela la API de socios comerciales como vistas relacionales y procedimientos almacenados.

Para usar el modelo de datos de socios vendedores de Amazon, simplemente configure Schema al socio vendedor.

Puntos de Vista¶

Puntos de vista son tablas que no se pueden modificar, como Pedidos, Productos. Normalmente, los datos que son de solo lectura y no se pueden actualizar se muestran como vistas.

Procedimientos Almacenados¶

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para buscar, actualizar y modificar información en la fuente de datos.

Uso de Informes¶

Los informes se pueden exponer como vistas configurando IncludeReports propiedad de conexión a verdadero. Se expondrá una vista para cada tipo de informe especificado en ReportTypes propiedad de conexión. Para incluir varios informes, también puede especificar una categoría de tipo de informe, que se puede recuperar desde la vista ReportTypes.

Estas vistas se pueden consultar mediante los parámetros de fecha y hora requeridos 'DataStartTime' y 'DataEndTime'. El controlador buscará automáticamente un informe existente que coincida con el intervalo especificado y, si no lo encuentra, se creará un nuevo informe. Los informes se pueden crear manualmente con el procedimiento almacenado RequestReport. También puede usar la pseudocolumna agregada JSON de ReportOptions para especificar campos adicionales que pueden ser necesarios según el tipo de informe. Para obtener más detalles sobre las opciones de informe, consulte la Documentación de la API de Amazon Selling-Partner

Después de crear un informe y enviarlo al conjunto de resultados, la próxima vez que consultar este tipo de informe con los mismos filtros, se descargará el informe creado anteriormente en lugar de crear un nuevo informe.

Mesas¶

El conector modela los datos en Amazon Marketplace en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar las tablas de Amazon Marketplace es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas de Amazon Marketplace¶

ListingsItems¶

Devuelve detalles sobre un artículo de listado para un socio de ventas.

Se requieren los siguientes filtros:

• SKU
• SellerId: Puede especificar SellerId como una condición de pseudocolumna en los filtros WHERE o en la cadena de conexión.

Algunos ejemplos de consultas:

SELECT * FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

INSERT INTO ListingsItems(ProductType, Requirements, Attributes, SKU, SellerId)
VALUES ('product_type', 'LISTING', '{\"test_attribute\": \"value\"}', '12345', 'XXXXXXXXXXXXXX')

DELETE FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ListingsItemsAttributes¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Se requieren los siguientes filtros:

• SKU
• SellerId: Puede especificar SellerId como una condición de pseudocolumna en los filtros WHERE o en la cadena de conexión.

Algunos ejemplos de consultas:

SELECT * FROM ListingsItemsAttributes WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

UPDATE ListingsItemsAttributes SET AttributeValue = 'test_value', ProductType = 'LUGGAGE'
WHERE SKU = '12345' AND AttributeName = 'item_name_value'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Amazon Marketplace¶

CatálogoArtículos¶

La tabla Artículos del catálogo lo ayuda a recuperar los detalles de los artículos del catálogo.

Se requieren los siguientes filtros:

• MarketplaceId
• Uno de los siguientes: Query, SellerSKU, UPC, EAN, ISBN, JAN

Por ejemplo:

SELECT * FROM CatalogItems WHERE MarketplaceID = 'XXXXXXXXXXXXX' AND ISBN = 'XXXXXXXXXXXXX'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Feeds¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

Nota: Se requiere el atributo 'FeedType' para consultar la vista. Puede ver los valores disponibles para 'FeedType' aquí.

• FeedId admite la comparación '='.
• FeedType admite las comparaciones '=' e 'IN'.
• MarketplaceIds admite las comparaciones '=' e 'IN'.
• ProcessingStatus admite las comparaciones '=' e 'IN'.
• CreatedTime admite las comparaciones '=', '<', '>', '<=' y '>='.

Las siguientes son consultas de ejemplo que se procesan del lado del servidor:

SELECT * FROM Feeds WHERE FeedId = '50950018754'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA'

SELECT * FROM Feeds WHERE FeedType IN ( 'POST_PRODUCT_PRICING_DATA', 'POST_INVENTORY_AVAILABILITY_DATA' )

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND ProcessingStatus = 'DONE'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND CreatedTime > '2021-06-20' AND CreatedTime < '2021-08-01 12:00:00'

Note: Al filtrar con CreatedTime, no se aceptarán valores mayores de 90 días.

Columnas¶

Artículos de Envío Entrantes¶

Devuelve una lista de artículos en un envío entrante especificado.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• MarketplaceId admite la comparación '='.
• LastUpdatedDate admite las comparaciones '=', '<', '>', '<=', '>='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM InboundShipmentItems  WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipmentItems  WHERE LastUpdatedDate > '2020-01-01'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Envíos Entrantes¶

Devuelve una lista de envíos entrantes según los criterios que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• ShipmentId admite las comparaciones '=' e 'IN'.
• ShipmentStatus admite las comparaciones '=' e 'IN'.
• MarketplaceId admite la comparación '='.
• LastUpdatedDate admite las comparaciones '=', '<', '>', '<=', '>='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Suministro de Inventario¶

Devuelve información sobre la disponibilidad del inventario que tiene un vendedor en la red logística de Amazon y en los envíos entrantes actuales. Puede comprobar el estado de disponibilidad actual de su inventario de Logística de Amazon, así como descubrir cuándo cambia el estado de disponibilidad.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

Note: Se requieren los atributos 'GranularityType' y 'GranularityId' para consultar la vista.

• SellerSKU admite las comparaciones '=', 'IN'.
• GranularityType admite la comparación '='.
• GranularityId admite la comparación '='.
• MarketplaceId admite la comparación '='.
• StartDateTime admite las comparaciones '=', '<', '>', '<=', '>='.

Las siguientes son consultas de ejemplo que se procesan del lado del servidor:

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND SellerSKU = '123'

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND StartDateTime > '2020-01-01'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ListadosArtículosProblemas¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Se requieren los siguientes filtros:

• SKU
• SellerId: Puede especificar SellerId como una condición de pseudocolumna en los filtros WHERE o en la cadena de conexión.

Algunos ejemplos de consultas:

SELECT * FROM ListingsItemsIssues WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ListadosArtículosOfertas¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Se requieren los siguientes filtros:

• SKU
• SellerId: Puede especificar SellerId como una condición de pseudocolumna en los filtros WHERE o en la cadena de conexión.

Algunos ejemplos de consultas:

SELECT * FROM ListingsItemsOffers WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ListadosArtículosResúmenes¶

La operación GetFeedSubmissionList devuelve una lista de envíos de feeds.

Se requieren los siguientes filtros:

• SKU
• SellerId: Puede especificar SellerId como una condición de pseudocolumna en los filtros WHERE o en la cadena de conexión.

Algunos ejemplos de consultas:

SELECT * FROM ListingsItemsSummaries WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

OrderAckInterno¶

Información de uso para la operación OrderAckInternal.rsd.

Columnas¶

OrderItemAckInterno¶

Información de uso para la operación OrderItemAckInternal.rsd.

Columnas¶

Encargar Artículos¶

Devuelve los artículos del pedido en función del ID de pedido de Amazon que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector. La tabla OrderItems admite el filtrado del lado del servidor con operadores = e IN para el campo AmazonOrderId.

• AmazonOrderId admite la comparación '='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Pedidos¶

Devuelve los pedidos creados o actualizados durante un período de tiempo que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• AmazonOrderId admite la comparación '='.
• SellerOrderId admite la comparación '='.
• PurchaseDate admite la comparación '=', '<', '>', '<=', '>='.
• LastUpdateDate admite la comparación '=', '<', '>', '<=', '>='.
• OrderStatus admite la comparación '=', 'IN'.
• FulfillmentChannel admite la comparación '=', 'IN'.
• PaymentMethod admite la comparación '=', 'IN'.
• MarketplaceId admite la comparación '='.
• BuyerEmail admite la comparación '='.
• IsISPU admite la comparación '='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE SellerOrderId = '249-7638334' AND purchasedate > '2010-01-01'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM Orders WHERE BuyerEmail = 'random@gmail.com'

SELECT * FROM Orders WHERE IsISPU = false

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Columnas¶

Lista de Informes¶

Devuelve los detalles del informe para los informes que coinciden con los filtros que especifique.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

Note: Se requiere el atributo 'ReportType' para consultar la vista. Puede ver los valores disponibles para 'ReportType' en Documentación de la API de Amazon Selling-Partner, o puede consultar la vista 'ReportTypes'.

• ReportId admite la comparación '='.
• ReportType admite las comparaciones '=', 'IN'.
• MarketplaceIds admite las comparaciones '=', 'IN'.
• ProcessingStatus admite las comparaciones '=', 'IN'.
• CreatedTime admite las comparaciones '=', '<', '>', '<=', '>='.

Las siguientes son consultas de ejemplo que se procesan del lado del servidor:

SELECT * FROM ReportList WHERE ReportId = '51013018828'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND CreatedTime > '2021-06-12' AND CreatedTime< '2021-08-01 12:00:00'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND ProcessingStatus = 'DONE'

Nota: Al filtrar con CreatedTime, no se aceptarán valores anteriores a 90 días.

Columnas¶

Tipos de Informes¶

Devuelve los detalles del informe para los informes que coinciden con los filtros que especifique.

Seleccionar¶

Esta vista enumera todos los tipos de informes disponibles de la API de socios comerciales y su formato respectivo (JSON, XML, CSV, TSV, PDF, XLSX).

SELECT * FROM ReportTypes

Columnas¶

ProveedorÓrdenes¶

La API de socios de ventas para pedidos de compras minoristas brinda acceso programático a los datos de pedidos de proveedores.

Seleccionar¶

El conector utilizará la API de Amazon Marketplace para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• PurchaseOrderNumber admite la comparación '='.
• PurchaseOrderState admite la comparación '='.
• PurchaseOrderDate admite '<', '>' comparaciones y cláusula ORDER BY.
• PurchaseOrderChangedDate admite '<', '>' comparaciones
• SellerPartyId admite la comparación '='.

Las siguientes son consultas de ejemplo que se procesan del lado del servidor:

SELECT * FROM VendorOrders

SELECT * FROM VendorOrders WHERE PurchaseOrderNumber = '123456789'

SELECT * FROM VendorOrders WHERE PurchaseOrderState = 'New'

SELECT * FROM VendorOrders ORDER BY PurchaseOrderDate DESC

SELECT * FROM VendorOrders WHERE PurchaseOrderDate > '2022-06-01T12:00:00' AND PurchaseOrderDate < '2022-06-10T12:00:00'

SELECT * FROM VendorOrders WHERE PurchaseOrderChangedDate > '2022-06-01T12:00:00' AND PurchaseOrderChangedDate < '2022-06-10T12:00:00'

SELECT * FROM VendorOrders WHERE SellerPartyId = '123456789'

Columnas¶