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 enSellingPartner
.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
, entoncesAccount 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 enMarketplace
.
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 manualmenteOAuthAccessToken
.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.
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Obtiene un nuevo token de acceso cuando caduca el antiguo.
- 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 manualmenteOAuthAccessToken
.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 conOAuthClientId
.AWSSecretKey
: esta es la clave secreta vinculada al usuario de AWS asociado con elOAuthClientId
.
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:
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Actualiza el token de acceso cuando caduca.
- 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.
- 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. - 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:
- Haga clic en el siguiente enlace para abrir el extremo de OAuth de Amazon Marketplace en su 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'.
- 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 conOAuthClientId
.AWSSecretKey
: esta es la clave secreta vinculada al usuario de AWS asociado con elOAuthClientId
.
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 conOAuthClientId
.AWSSecretKey
: esta es la clave secreta vinculada al usuario de AWS asociado con elOAuthClientId
.
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.
- 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.
- 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'.
- 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 conOAuthClientId
.AWSSecretKey
: esta es la clave secreta vinculada al usuario de AWS asociado con elOAuthClientId
.
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 conOAuthClientId
.AWSSecretKey
: esta es la clave secreta vinculada al usuario de AWS asociado con elOAuthClientId
.
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¶
-
Inicie sesión en la Consola de socio vendedor y abra
Develop Apps from Apps & Services
. -
Haga clic en
Add new app client
. -
Proporcione el nombre de la aplicación y seleccione
SP-API
como el tipo de API. -
Proporcione el ARN de IAM para la cuenta de AWS y seleccione vendedores.
-
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
yOAuthClientSecret
se muestran debajo deLWA 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¶
Nombre | Descripción |
---|---|
FeedSubmissionList | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
FeedSubmissionResult | La operación GetFeedSubmissionResult devuelve el informe de procesamiento de feeds para un feed específico. |
InboundShipmentItems | Devuelve una lista de artículos en un envío entrante especificado. |
InboundShipments | Devuelve una lista de envíos entrantes según los criterios que especifique. |
InventorySupply | 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. |
OrderItems | Devuelve los artículos del pedido en función del ID de pedido de Amazon que especifique. |
Orders | Devuelve los pedidos creados o actualizados durante un período de tiempo que especifique. |
Products | 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. |
ReportList | Información de uso para la operación ReportList.rsd. |
ReportRequestList | Información de uso para la operación ReportRequestList.rsd. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
FeedSubmissionId [KEY] | String | El ID de FeedSubmission. | |
FeedType | String | El tipo de fuente. | |
SubmittedDate | Datetime | La fecha en que se envía el feed. | |
FeedProcessingStatus | String | El estado de la alimentación. Los valores permitidos son _AWAITING_ASYNCHRONOUS_REPLY_, _CANCELLED_, _DONE_, _IN_PROGRESS_, _IN_SAFETY_NET_, _SUBMITTED_, _UNCONFIRMED_. | |
StartedProcessingDate | Datetime | La fecha en que el feed comenzó a procesarse. | |
CompletedProcessingDate | Datetime | La fecha en que el feed dejó de procesarse. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
DocumentTransactionID [KEY] | String | El ID de transacción del documento. | |
FeedSubmissionId | String | El ID de envío de alimentación. | |
StatusCode | String | El código de estado del feed. | |
MessagesProcessed | Integer | El número de mensajes procesados. | |
MessagesSuccessful | Integer | El número de mensajes procesados con éxito. | |
MessagesWithError | Integer | El número de mensajes procesados con errores. | |
MessagesWithWarning | Integer | El número de mensajes procesados con advertencias. | |
MessageID [KEY] | String | El ID del mensaje. | |
ResultCode | String | El código de resultado. | |
ResultMessageCode | String | El código de mensaje de resultado. | |
ResultDescription | String | La descripción del resultado. | |
AdditionalInfo_SKU | String | El SKU. | |
AdditionalInfo_FulfillmentCenterID | String | La identificación del centro de cumplimiento. | |
AdditionalInfo_AmazonOrderID | String | El ID de pedido de Amazon. | |
AdditionalInfo_AmazonOrderItemCode | String | El código del artículo del pedido de Amazon. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ShipmentId [KEY] | String | Envíos entrantes.EnvíoId | El ID del envío. |
SellerSKU [KEY] | String | El SKU del vendedor del artículo. | |
QuantityShipped | Int | La cantidad del artículo que está enviando. | |
QuantityInCase | Int | La cantidad de artículos en cada caso, para artículos empaquetados en cajas. | |
QuantityReceived | Int | La cantidad de artículos que se ha recibido en un centro logístico de Amazon. | |
FulfillmentNetworkSKU | String | SKU de la red logística de Amazon del artículo. | |
PrepDetailsListPrepInstruction | String | Instrucciones de preparación para enviar un artículo a la red logística de Amazon. | |
PrepDetailsListPrepOwner | String | Indica quién preparará el artículo. | |
ReleaseDate | Date | La fecha en que un artículo de pedido anticipado estará disponible para la venta. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdatedDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ShipmentId [KEY] | String | El ID del envío. | |
ShipmentStatus | String | El estado de su envío entrante. Los valores posibles son TRABAJANDO, ENVIADO, EN TRÁNSITO, ENTREGADO, REGISTRADO, RECIBIENDO, CERRADO, CANCELADO, ELIMINADO y ERROR. | |
ShipmentName | String | El nombre único del envío entrante. | |
ShipFromPostalCode | String | El Código Postal de la dirección del remitente. | |
ShipFromName | String | El nombre de la dirección de devolución. | |
ShipFromCountryCode | String | El código de país de la dirección de devolución. | |
ShipFromStateOrProvinceCode | String | El código de estado o provincia de la dirección del remitente. | |
ShipFromAddressLine1 | String | La línea de dirección de la dirección de retorno. | |
ShipFromCity | String | La ciudad de la dirección del remitente. | |
LabelPrepType | String | El tipo de preparación de la etiqueta. | |
AreCasesRequired | Boolean | Booleano que indica si un envío entrante contiene o no cajas empaquetadas. | |
DestinationFulfillmentCenterId | String | El identificador del centro logístico de Amazon creado por Amazon. | |
ConfirmedNeedByDate | Date | Fecha en la que el envío debe llegar a un centro logístico de Amazon para artículos pedidos por adelantado. | |
EstimatedBoxContentsFeeTotalUnits | Int | El número de unidades a enviar para una estimación de la tarifa de procesamiento manual que cobra Amazon por las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsFeePerUnitCurrencyCode | String | El código de moneda para una estimación de la tarifa de procesamiento manual que cobra Amazon por las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsFeePerUnitValue | Decimal | La tarifa de procesamiento manual por unidad para una estimación de la tarifa de procesamiento manual cobrada por Amazon por cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsTotalFeeCurrencyCode | String | El código de moneda de la tarifa total para una estimación de la tarifa de procesamiento manual cobrada por Amazon para las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsTotalFeeValue | Decimal | El valor de la tarifa total para una estimación de la tarifa de procesamiento manual cobrada por Amazon para las cajas sin información sobre el contenido de la caja. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdatedDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
UID [KEY] | String | Campo de clave principal generada automáticamente. | |
FNSKU | String | El SKU de la red de cumplimiento (FNSKU) del artículo. El FNSKU es un identificador único para cada artículo de inventario almacenado en un centro logístico de Amazon. | |
SellerSKU | String | El SKU del vendedor del artículo. Obligatorio si no se especifica QueryStartDateTime. | |
ASIN | String | El número de identificación estándar de Amazon (ASIN) del artículo. | |
Condition | String | El estado del artículo. | |
TotalSupplyQuantity | Integer | La cantidad total de artículos que un vendedor tiene en la cadena de suministro de la red logística de Amazon. Esto incluye el inventario que está disponible para envío, el inventario en envíos entrantes y el inventario que se transfiere entre los centros logísticos de Amazon. | |
InStockSupplyQuantity | Integer | La cantidad de artículos que un vendedor tiene en los centros logísticos de Amazon que están disponibles para envío. | |
EarliestAvailability_TimepointType | String | Indica si el inventario está disponible inmediatamente para la recolección, si se desconoce la disponibilidad del inventario o si se espera que el inventario esté disponible para la recolección en una fecha específica. | |
EarliestAvailability_DateTime | Datetime | La fecha y hora en la que se espera que el inventario esté disponible para su selección. |
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.
Nombre | Tipo | Descripción |
---|---|---|
QueryStartDateTime | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
OrderItemId [KEY] | String | El ID del artículo del pedido. | |
AmazonOrderId | String | Pedidos.AmazonOrderId | El ID de Amazon del pedido. |
ASIN | String | El código ASIN. | |
SellerSKU | String | El VendedorSKU. | |
BuyerCustomizedInfoCustomizedURL | String | La URL personalizada del comprador. | |
Title | String | Título. | |
QuantityOrdered | Integer | La cantidad de artículos pedidos. | |
QuantityShipped | Integer | La cantidad de artículos enviados. | |
GrantedPointsNumber | Integer | El Número de Puntos Concedidos. | |
GrantedPointsMonetaryValueAmount | Decimal | La cantidad de puntos otorgados. | |
GrantedPointsMonetaryValueCurrencyCode | String | El código de moneda de los puntos concedidos. | |
NumberOfItems | Integer | El Número De Artículos. | |
ItemPriceAmount | Decimal | El importe del precio del artículo. | |
ItemPriceCurrencyCode | String | El código de moneda del precio del artículo. | |
ShippingPriceAmount | Decimal | El monto del precio de envío. | |
ShippingPriceCurrencyCode | String | El código de moneda del precio de envío. | |
GiftWrapPriceAmount | String | El importe del precio del envoltorio de regalo. | |
GiftWrapPriceCurrencyCode | String | El código de moneda del precio del papel de regalo. | |
TaxCollectionName | String | El nombre de la recaudación de impuestos. | |
TaxCollectionValue | String | El valor de la recaudación de impuestos. | |
ItemTaxAmount | Decimal | El importe del impuesto del artículo. | |
ItemTaxCurrencyCode | String | El código de moneda fiscal del artículo. | |
ShippingTaxAmount | String | El monto del impuesto de envío. | |
ShippingTaxCurrencyCode | String | El código de moneda de impuestos de envío. | |
GiftWrapTaxAmount | Decimal | El monto del impuesto sobre el envoltorio de regalo. | |
GiftWrapTaxCurrencyCode | String | El código de moneda del impuesto sobre el envoltorio de regalo. | |
ShippingDiscountAmount | String | El monto del descuento de envío. | |
ShippingDiscountCurrencyCode | String | El código de moneda de descuento de envío. | |
PromotionDiscountAmount | Decimal | El importe del descuento de la promoción. | |
PromotionDiscountCurrencyCode | String | El código de moneda de descuento de la promoción. | |
PromotionIds | String | Los ID de las promociones. | |
CODFeeAmount | Decimal | El monto de la tarifa COD. | |
CODFeeCurrencyCode | String | El código de moneda de tarifa COD. | |
CODFeeDiscountAmount | String | El monto del descuento de la tarifa COD. | |
CODFeeDiscountCurrencyCode | String | El código de moneda de descuento de tarifa COD. | |
IsGift | Boolean | Booleano que especifica si el artículo es un regalo. | |
GiftMessageText | String | El texto del mensaje de regalo. | |
GiftWrapLevel | String | El nivel de envoltorio de regalo. | |
InvoiceDataInvoiceRequirement | String | El requisito de InvoiceData. | |
InvoiceDataBuyerSelectedInvoiceCategory | String | Las categorías seleccionadas de InvoiceData. | |
InvoiceDataInvoiceTitle | String | El título de los datos de la factura. | |
InvoiceDataInvoiceInformation | String | La Información de los Datos de la Factura. | |
ConditionNote | String | La nota de condición. | |
ConditionId | String | La identificación de la condición. | |
ConditionSubtypeId | String | El ID de subtipo de condición. | |
ScheduledDeliveryStartDate | Datetime | La fecha de inicio de la entrega programada. | |
ScheduledDeliveryEndDate | Datetime | La fecha de finalización de la entrega programada. | |
PriceDesignation | String | La designación del precio. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdateDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
AmazonOrderId [KEY] | String | El ID de Amazon del pedido. | |
SellerOrderId | String | El ID del vendedor del pedido. | |
PurchaseDate | Datetime | La fecha de la compra. | |
LastUpdateDate | Datetime | La última fecha de actualización. | |
OrderStatus | String | Estado del pedido. | |
FulfillmentChannel | String | El Canal de Cumplimiento. | |
SalesChannel | String | El Canal de Ventas. | |
OrderChannel | String | El Canal de la Orden. | |
ShipServiceLevel | String | El nivel del Servicio del Buque. | |
ShippingAddressName | String | El nombre de la dirección de envío. | |
ShippingAddressAddressLine1 | String | La dirección de envío AddressLine. | |
ShippingAddressAddressLine2 | String | La dirección de envío AddressLine. | |
ShippingAddressAddressLine3 | String | La dirección de envío AddressLine. | |
ShippingAddressCity | String | La ciudad de la dirección de envío. | |
ShippingAddressCountry | String | El país de la dirección de envío. | |
ShippingAddressDistrict | String | El distrito de dirección de envío. | |
ShippingAddressStateOrRegion | String | El estado o región de la dirección de envío. | |
ShippingAddressPostalCode | String | El código postal de la dirección de envío. | |
ShippingAddressCountryCode | String | El código de país de la dirección de envío. | |
ShippingAddressPhone | String | El teléfono de la dirección de envío. | |
ShippingAddress_AddressType | String | El tipo de dirección de envío. | |
OrderTotalCurrencyCode | String | El código de moneda de la orden. | |
OrderTotalAmount | Decimal | El monto del pedido. | |
NumberOfItemsShipped | Integer | El número de artículos enviados. | |
NumberOfItemsUnshipped | Integer | El número de artículos no enviados. | |
PaymentExecutionDetail | String | El Detalle de Ejecución de Pago. | |
PaymentMethod | String | El método de pago. | |
PaymentMethodDetail | String | Los detalles del método de pago. | |
IsReplacementOrder | Boolean | Booleano que especifica si se trata de un pedido de reemplazo. | |
ReplacedOrderId | String | El ID de pedido reemplazado. | |
MarketplaceId | String | El MarketplaceId. | |
BuyerEmail | String | El Correo del comprador. | |
BuyerName | String | El nombre del comprador. | |
BuyerCounty | String | El País Comprador. | |
BuyerTaxInfo | String | La información fiscal del comprador. | |
ShipmentServiceLevelCategory | String | La categoría de nivel de servicio de envío. | |
ShippedByAmazonTFM | Boolean | El enviado por Amazon TFM. | |
TFMShipmentStatus | String | El estado del envío TFM. | |
CbaDisplayableShippingLabel | String | La etiqueta de envío visualizable de Cba. | |
OrderType | String | El tipo de orden. | |
EarliestShipDate | Datetime | La fecha de envío más temprana. | |
LatestShipDate | Datetime | La última fecha de envío. | |
EarliestDeliveryDate | Datetime | La fecha de entrega más temprana. | |
LatestDeliveryDate | Datetime | La última fecha de entrega. | |
IsBusinessOrder | Boolean | Booleano especificando si es una Orden Comercial. | |
IsIBA | Boolean | Cuando es verdadero, el artículo dentro de este pedido fue comprado y revendido por Amazon Business EU SARL (ABEU). | |
PurchaseOrderNumber | String | El número de orden de compra. | |
IsPrime | Boolean | Booleano especificando si es una Orden Prime. | |
IsPremiumOrder | Boolean | Booleano especificando si es un Pedido Premium. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
MarketplaceASIN [KEY] | String | El Marketplace ASIN. | |
MarketplaceASINMarketplaceId | String | MarketplaceId de Marketplace ASIN. | |
SKUIdentifierMarketplaceId | String | El SKUIdentifier de MarketplaceId. | |
SKUIdentifierSelerId | String | MarketplaceId de SellerId. | |
SKUIdentifierSellerSKU | String | MarketplaceId de SellerSKU. | |
AttributeSets | String | Los atributos del producto. | |
Relationships | String | Las relaciones del producto. | |
SalesRankings | String | Los rankings de ventas de productos. | |
SearchTerms | String | ||
IdType | String | El tipo de identificación del producto. Los valores permitidos son ASIN, GCID, SellerSKU, UPC, EAN, ISBN, JAN. | |
IdList | String | Una lista de ID de productos. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ReportId [KEY] | String | Informe de identificación. | |
ReportType | String | El tipo del Informe. | |
ReportRequestId | String | El ID de solicitud de informe. | |
Acknowledged | Boolean | Un valor booleano que indica si se ha reconocido el informe de pedido. | |
AvailableDate | Datetime | Fecha en que estuvo disponible el informe. De forma predeterminada, se devolverán los informes disponibles de los últimos 90 días. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ReportRequestId [KEY] | String | El ID de solicitud de informe. | |
ReportType | String | El tipo del Informe. | |
StartDate | Datetime | La fecha de inicio de la solicitud. | |
EndDate | Datetime | La fecha de finalización de la solicitud. | |
Scheduled | Boolean | Un valor booleano que indica si se programó la solicitud de informe. | |
SubmittedDate | Datetime | La fecha y hora en que se envió el informe. | |
ReportProcessingStatus | String | Estado de tramitación del informe. Los valores posibles son: _SUBMITTED_, _IN_PROGRESS_, _CANCELLED_, _DONE_, _DONE_NO_DATA_ | |
GeneratedReportId | String | El ID del informe generado desde Amazon MWS. | |
StartedProcessingDate | Datetime | La fecha y hora en que el informe indicó que se procesará. | |
CompletedDate | Datetime | La fecha y hora en que se completó el informe. |
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.
Nombre | Tipo | Descripción |
---|---|---|
RequestedDate | Datetime |
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¶
Nombre | Descripción |
---|---|
CancelFeed | 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 cancelan. |
CancelReportRequests | 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. |
CreateSchema | Crea un archivo de esquema para la tabla o vista especificada. |
GetReport | Crea y/o devuelve datos para un informe específico. |
RequestReport | La operación RequestReport crea una solicitud de informe. |
SubmitImageFeed | El feed de imágenes le permite cargar varias imágenes para un producto. Amazon puede mostrar varias imágenes para cada producto. |
SubmitInventoryFeed | El feed de inventario le permite actualizar las cantidades de inventario (niveles de existencias) de sus artículos. |
SubmitOrderAcknowledgementFeed | El feed de Reconocimiento de pedidos le permite reconocer su éxito o fracaso al descargar un pedido. |
SubmitOrderAdjustmentFeed | 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.). |
SubmitOrderFulfillmentFeed | El feed de Cumplimiento de pedidos permite que su sistema actualice el sistema de Amazon con información de cumplimiento de pedidos. |
SubmitOverrideFeed | 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). |
SubmitPriceFeed | El feed de precios le permite establecer el precio actual y el precio de venta (cuando corresponda) de un artículo. |
SubmitProductFeed | 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. |
SubmitRelationshipFeed | El feed Relación le permite configurar relaciones opcionales entre artículos en su catálogo. |
SubmitSourcingOnDemandFeed | Información de uso para la operación SubmitSourcingOnDemandFeed.rsb. |
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¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
FeedSubmissionId | String | Cierto | Requerido. Un identificador único para el envío del feed. |
FeedType | String | Falso | El tipo de feed enviado. |
SubmittedFromDate | Datetime | Falso | Comienzo del intervalo de fechas especificado cuando se envió el feed. |
SubmittedToDate | Datetime | Falso | Fin del intervalo de fechas especificado cuando se envió el feed. |
CancelFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Requerido. Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed |
StartedProcessingDate | Datetime | La fecha en que comenzó el procesamiento del feed. |
CompletedProcessingDate | Datetime | La fecha en que se completó el procesamiento del feed. |
SwitchFulfillmentTo | String | Se usa solo cuando se cambia el cumplimiento de un artículo de MFN (cumplimiento del comerciante) a AFN (cumplimiento de Amazon) o viceversa. |
OperationType | String | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
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¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportRequestIdList | String | Falso | Una lista estructurada de valores ReportRequestId. Si se especifica un valor ReportRequestId, se ignoran otras condiciones de consultar. Si no se especifica, se cancelarán todas las solicitudes de informes. |
ReportTypeList | String | Falso | Una lista estructurada de valores ReportType. |
ReportProcessingStatusList | String | Falso | Una lista estructurada de estados de procesamiento de informes que se utiliza para filtrar las solicitudes de informes. Los valores para ReportProcessingStatusList son: _SUBMITTED_, _IN_PROGRESS_, _CANCELLED_, _DONE_, _DONE_NO_DATA_ |
RequestedFromDate | Datetime | Falso | La fecha de inicio del rango de fechas utilizado para seleccionar los datos para informar. Predeterminado: hace 90 días. |
RequestedToDate | Datetime | Falso | Fin del rango de fechas usado para seleccionar los datos a reportar. Predeterminado: fecha actual. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
Count | Integer | Un número entero no negativo que representa el número total de solicitudes de informe canceladas. |
CrearEsquema¶
Crea un archivo de esquema para la tabla o vista especificada.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
TableName | String | Cierto | El nombre de la tabla o vista. |
FileName | String | Cierto | La ruta completa del archivo y el nombre del esquema a generar. Comience eligiendo un directorio principal (este directorio principal debe configurarse en la propiedad Ubicación). Complete la ruta del archivo agregando un directorio correspondiente al esquema utilizado (Marketplace), seguido de un archivo .rsd con un nombre correspondiente al nombre de la tabla deseada. Por ejemplo: 'C:\Users\User\Desktop\AmazonMarketplace\ Marketplace\Filters.rsd' |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
Result | String | Devuelve éxito o fracaso. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportId | String | Falso | ID único del informe a descargar. |
DownloadPath | String | Cierto | La ruta del archivo para escribir los datos del informe. |
CheckSum | Boolean | Falso | Booleano utilizado para comprobar la suma del informe. El valor predeterminado es falso. |
ReportType | String | Falso | Indica el tipo de informe a solicitar. |
StartDate | Datetime | Falso | La fecha de inicio del rango de fechas utilizado para seleccionar los datos para informar. Por defecto es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
EndDate | Datetime | Falso | Fecha de finalización del rango de fechas utilizado para seleccionar los datos para informar. Por defecto es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
ReportOptions | String | Falso | Información adicional para pasar al informe. Si el informe acepta ReportOptions, la información se muestra en la descripción del informe en la sección del enumerador ReportType. |
MarketplaceIdList# | String | Falso | Uno o más ID de mercado para el mercado que registró la cuenta de listado. Predeterminado: el mercado donde registró por primera vez su cuenta de vendedor. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
Success | Boolean | Booleano que indica el resultado de la operación. |
MD5SUM | String | La suma MD5 del contenido del informe. |
GeneratedReportId | String | Un identificador único para el informe. |
ReportRequestId | String | Un identificador único para la solicitud de informe. |
ReportProcessingStatus | String | El estado de procesamiento de la solicitud. |
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¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportType | String | Cierto | Requerido. Indica el tipo de informe a solicitar. |
StartDate | Datetime | Falso | La fecha de inicio del rango de fechas utilizado para seleccionar los datos para informar. De forma predeterminada, es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
EndDate | Datetime | Falso | Fecha de finalización del rango de fechas utilizado para seleccionar los datos para informar. Por defecto es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
ReportOptions | String | Falso | Información adicional para pasar al informe. Si el informe acepta ReportOptions, la información se muestra en la descripción del informe en la sección del enumerador ReportType. |
MarketplaceIdList# | String | Falso | Uno o más ID de mercado para el mercado que registró la cuenta de listado. Predeterminado: el mercado donde registró por primera vez su cuenta de vendedor. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
ReportRequestId | String | Un identificador único para la solicitud de informe. |
ReportProcessingStatus | String | El estado de procesamiento de la solicitud. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
ImageType | String | Falso | Requerido. Los valores disponibles son Main, Swatch, BKLB, PT1, PT2, PT3, PT4, PT5, PT6, PT7, PT8, Search, PM01, MainOfferImage, OfferImage1, OfferImage2, OfferImage3, OfferImage4, OfferImage5, PFEE, PFUK, PFDE, PFFR, PFIT, PFES, EEGL, PT98, PT99 y ELFL. |
ImageLocation | String | Falso | La ubicación exacta de la imagen utilizando una URL completa (como http://mystore.com/images/1234.jpg). |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
ProductImageFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Falso | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
FulfillmentCenterID | String | Falso | Identificador definido por el vendedor para un centro logístico. |
Available | Boolean | Falso | Indica si el artículo está disponible o no (verdadero = disponible; falso = no disponible). |
Quantity | Integer | Falso | Indica si un artículo está disponible o no (cualquier número positivo = disponible; 0 = no disponible). |
RestockDate | Date | Falso | Fecha en que se repondrá el artículo, si no está disponible actualmente. |
FulfillmentLatency | String | Falso | El número de días entre la fecha del pedido y la fecha de envío (un número entero entre 1 y 30). |
SwitchFulfillmentTo | String | Falso | Se usa solo cuando se cambia el cumplimiento de un artículo de MFN (cumplimiento del comerciante) a AFN (cumplimiento de Amazon) o viceversa. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
InventoryFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | El identificador único de Amazon para un pedido, que identifica el pedido completo, independientemente de la cantidad de artículos individuales en el pedido. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. Amazon asignará MerchantOrderID a AmazonOrderID y, a continuación, podrá utilizar su propio ID de pedido (MerchantOrderID) para los subsiguientes feeds relacionados con el pedido. |
StatusCode | String | Falso | Le permite reconocer su éxito o fracaso al descargar un pedido. StatusCode puede ser Correcto o Incorrecto. |
AmazonOrderItemCode | String | Falso | Identificador único de Amazon para un artículo en un pedido. |
MerchantOrderItemID | String | Falso | ID opcional proporcionada por el vendedor para un artículo en un pedido. Si MerchantOrderItemID se especifica con AmazonOrderItemCode, Amazon asignará los dos ID y luego podrá usar su propio ID de artículo de pedido para los feeds posteriores relacionados con ese artículo de pedido. |
CancelReason | String | Falso | Se usa solo cuando se envía un código de estado de falla. |
ItemAggregate | String | Falso | Un agregado que representa un artículo de pedido. Puede estar en forma de XML o una tabla #TEMP. Utilice este campo cuando sea necesario reconocer varios artículos en el pedido. |
OrderAcknowledgementFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | Identificador único de Amazon para un pedido, que identifica el pedido completo independientemente de la cantidad de artículos individuales en el pedido. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. El primer paso es establecer MerchantOrderID en el feed de confirmación. Amazon asignará MerchantOrderID a AmazonOrderID, y luego podrá usar su propio ID de pedido (MerchantOrderID) para los feeds posteriores relacionados con ese pedido. Consulte el XSD base para ver la definición. |
AdjustedItemQuantityCancelled | Integer | Falso | Cantidad de artículos que se cancelan. Utilizado solo para cancelaciones parciales. |
AdjustedItemAmazonOrderItemCode | String | Falso | ID único de Amazon para un artículo en un pedido. |
AdjustedItemMerchantOrderItemID | String | Falso | ID opcional proporcionada por el vendedor para un artículo en un pedido. Se puede utilizar en el procesamiento de pedidos si el emparejamiento se estableció en el feed de confirmación. |
AdjustedItemMerchantAdjustmentItemID | String | Falso | ID único opcional proporcionado por el vendedor para el ajuste (no utilizado por Amazon). |
AdjustedItemAdjustmentReason | String | Falso | Motivo del ajuste. |
ItemPriceAdjustmentsComponentType | String | Falso | El tipo de ajuste de precio del artículo. Los valores incluyen: principal, envío, impuesto, impuesto de envío, tarifa de reabastecimiento, impuesto de tarifa de reabastecimiento, envoltura de regalo, impuesto de envoltura de regalo, recargo, envío de devolución, fondo de comercio, cargo de exportación, COD, impuesto de COD, otro, reemplazo gratuito, devolución de envío |
ItemPriceAdjustmentsComponentAmount | Decimal | Falso | La cantidad del ajuste. |
ItemPriceAdjustmentsComponentAmountCurrency | String | Falso | La moneda para la cantidad. |
ItemPriceAdjustmentsAggregate | String | Falso | Un agregado que representa la cantidad que el comprador debe reembolsar por el artículo. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario aplicar ajustes de precio de varios artículos. |
PromotionAdjustmentsPromotionClaimCode | String | Falso | El ClaimCode para el Ajuste de Promoción. |
PromotionAdjustmentsMerchantPromotionID | String | Falso | El ID de promoción para el ajuste de promoción. |
PromotionAdjustmentsComponentType | String | Falso | El Tipo de ajuste de precio para la promoción. |
PromotionAdjustmentsComponentAmount | Decimal | Falso | El monto del ajuste de precio para la promoción. |
PromotionAdjustmentsComponentAmountCurrency | String | Falso | La moneda para la cantidad. |
PromotionAdjustmentsComponentAggregate | String | Falso | Un agregado que representa el Importe que el comprador debe reembolsar por la promoción, desglosado por tipo. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario aplicar varios ajustes de precio de promoción. |
PromotionAdjustmentsAggregate | String | Falso | Un agregado que representa la promoción. Los elementos secundarios incluyen PromotionClaimCode, MerchantPromotionID, ComponentAgregate (Type, Amount y Amount@Currency). Utilice este campo si es necesario aplicar varias promociones. |
AdjustedItemAggregate | String | Falso | Un agregado que representa la información de ajuste de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario ajustar varios artículos en 1 pedido. |
OrderAdjustmentFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | Identificador único de Amazon para un pedido, que identifica el pedido completo independientemente de la cantidad de artículos individuales en el pedido. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. El primer paso es establecer MerchantOrderID en el feed de confirmación. Amazon asignará MerchantOrderID a AmazonOrderID, y luego podrá usar su propio ID de pedido (MerchantOrderID) para los feeds posteriores relacionados con ese pedido. Consulte el XSD base para ver la definición. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
MerchantFulfillmentID | Integer | Falso | Identificador único proporcionado por el vendedor para el envío (no utilizado por Amazon). |
FulfillmentDate | Datetime | Falso | La fecha en que se envió o recogió el artículo, según el método de cumplimiento especificado en el pedido. |
FulfillmentDataCarrierCode | String | Falso | El código del transportista de envío. |
FulfillmentDataCarrierName | String | Falso | El nombre del transportista. |
FulfillmentDataShippingMethod | String | Falso | El método de envío utilizado para entregar el artículo. |
FulfillmentDataShipperTrackingNumber | String | Falso | El número de seguimiento del envío. |
CODCollectionMethod | String | Falso | Modo de cobro contra reembolso de un pedido. |
ItemAmazonOrderItemCode | String | Falso | ID único de Amazon para un artículo en un pedido. |
ItemMerchantOrderItemID | String | Falso | El ID de envío opcional proporcionado por el vendedor para un artículo en un pedido. |
ItemMerchantFulfillmentItemID | String | Falso | Identificador único proporcionado por el vendedor para un artículo en el envío (no utilizado por Amazon). |
ItemQuantity | Integer | Falso | La cantidad de un artículo enviado. |
ItemAggregate | String | Falso | Un agregado que representa la información de cumplimiento de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando sea necesario incluir varios artículos en el feed. |
FulfillmentDataAggregate | String | Falso | Un agregado que representa la información de cumplimiento de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando sea necesario incluir varios artículos en el feed. |
OrderFulfillmentFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Falso | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
ShipOption | String | Falso | Servicio de local y envío. |
IsShippingRestricted | Boolean | Falso | Indica si el SKU puede o no enviarse a la configuración regional especificada mediante el servicio de envío especificado (ShipOption). |
Type | String | Falso | El tipo de cargo de envío anulado (aditivo o exclusivo) que se aplica al SKU. |
ShipAmount | Decimal | Falso | El importe del cargo de envío Adicional o Exclusivo. |
ShipAmountCurrency | Decimal | Falso | La moneda utilizada para ShipAmount. |
ShippingOverrideAggregate | String | Falso | Un agregado que representa la anulación de envío. Puede estar en forma de XML o una tabla #TEMP. Utilice este campo si se necesitan varias anulaciones de envío. |
OverrideFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Falso | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
StandardPrice | Double | Falso | Requerido. Precio del artículo (precio de no venta). |
StandardPriceCurrency | String | Falso | Requerido. La moneda para el precio estándar. |
MAP | String | Falso | Precio mínimo anunciado. Usar solo si lo dicta el fabricante. Tanto el precio estándar como el de venta (si corresponde) deben ser superiores al valor del MAP. |
MAPCurrency | String | Falso | Precio mínimo anunciado. Usar solo si lo dicta el fabricante. Tanto el precio estándar como el de venta (si corresponde) deben ser superiores al valor del MAP. |
SalePrice | Double | Falso | El precio de la venta. |
SalePriceCurrency | String | Falso | La moneda de la venta. |
SaleStartDate | Datetime | Falso | La fecha de inicio de la venta. |
SaleEndDate | Datetime | Falso | La fecha de finalización de la venta. |
PriceFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualización, Eliminación o Actualización parcial) que se realizará en los datos. |
StandardProductID | String | Falso | Un identificador único estándar para un producto, que consta de un tipo (ISBN, UPC o EAN) y un valor que se ajusta al formato apropiado para el tipo especificado. Este es un campo obligatorio si se proporciona Tipo para StandardProductID en el XSD base. |
ProductTaxCode | String | Falso | Código estándar de Amazon para identificar las propiedades fiscales de un producto. |
LaunchDate | Datetime | Falso | Controla cuándo aparece el producto en las búsquedas y navegación en la web de Amazon. |
DiscontinueDate | Datetime | Falso | Controla cuando el producto desaparece de las búsquedas y navegación en la web de Amazon. |
ReleaseDate | Datetime | Falso | La fecha en que un producto sale a la venta. |
Condition | String | Falso | El estado del artículo. |
Rebate | String | Falso | La rebaja del producto. |
ItemPackageQuantity | Integer | Falso | Número del mismo producto contenido dentro de un paquete. Por ejemplo, si vende una caja de 10 paquetes de calcetines, ItemPackageQuantity sería 10. |
NumberOfItems | Integer | Falso | Número de artículos discretos incluidos en el producto que ofrece a la venta, de modo que cada artículo no esté empaquetado para la venta individual. Por ejemplo, si vende una caja de 10 paquetes de calcetines y cada paquete contiene 3 pares de calcetines, NumberOfItems sería 30. |
Title | String | Cierto | Requerido. Breve descripción del producto. |
Brand | String | Falso | Marca del producto. |
Designer | String | Falso | Diseñador del producto. |
Description | String | Falso | Descripción larga del producto. |
BulletPoint | String | Falso | Breves descripciones de las características del producto. |
PackageDimensionsLength | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsWidth | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsHeight | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsWeight | String | Falso | Dimensiones calculadas del paquete. |
ItemDimensionsLength | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsWidth | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsHeight | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsWeight | String | Falso | Dimensiones calculadas del artículo. |
PackageWeight | String | Falso | Peso del paquete |
ShippingWeight | String | Falso | Peso del producto cuando se empaqueta para enviar. |
MerchantCatalogNumber | String | Falso | Número de catálogo del vendedor para el producto, si es diferente al SKU. |
MSRP | Double | Falso | Precio de venta sugerido por el fabricante. |
MaxOrderQuantity | Integer | Falso | Cantidad máxima del producto que un cliente puede pedir. |
SerialNumberRequired | Boolean | Falso | Indica si el producto debe tener un número de serie. |
Prop65 | Boolean | Falso | Se usa si el producto está sujeto a las reglamentaciones de la Proposición 65 en California. Solo nosotros. |
LegalDisclaimer | String | Falso | Cualquier descargo de responsabilidad legal necesario para el producto. |
Manufacturer | String | Falso | Fabricante del producto. |
MfrPartNumber | String | Falso | Número de pieza proporcionado por el fabricante original. |
SearchTerms | String | Falso | Términos que envía que dan resultados de búsqueda de productos. |
PlatinumKeywords | String | Falso | Valores utilizados para asignar productos a nodos en una estructura de exploración personalizada. |
RecommendedBrowseNode | String | Falso | Valor utilizado para clasificar un artículo. |
Memorabilia | Boolean | Falso | Se utiliza si el producto es un artículo de recuerdo. |
Autographed | Boolean | Falso | Se utiliza si el producto es un artículo autografiado. |
UsedFor | String | Falso | Para qué se utiliza el producto (afecta la ubicación del producto en la estructura de navegación de Amazon). |
ItemType | String | Falso | Valor predefinido que especifica dónde debe aparecer el producto dentro de la estructura de navegación de Amazon. |
OtherItemAttributes | String | Falso | Se utiliza para clasificar aún más el producto dentro de la estructura de navegación de Amazon. |
TargetAudience | String | Falso | Se utiliza para clasificar aún más el producto dentro de la estructura de navegación de Amazon. |
SubjectContent | String | Falso | Se utiliza para relacionar el producto con una idea o concepto específico para la comercialización. |
IsGiftWrapAvailable | Boolean | Falso | Indica si el envoltorio de regalo está disponible para el producto. |
IsGiftMessageAvailable | Boolean | Falso | Indica si los mensajes de regalo están disponibles para el producto. |
IsDiscontinuedByManufacturer | Boolean | Falso | Indica que el fabricante ha dejado de fabricar el artículo. |
MaxAggregateShipQuantity | Integer | Falso | El número máximo del mismo artículo que se puede enviar en el mismo paquete. |
ProductDescriptionDataAggregate | String | Falso | Sección que contiene información específica de la categoría, como variaciones. Puede estar en forma de XML o una tabla #TEMP. |
ProductDataAggregate | String | Falso | Sección que contiene información específica de la categoría, como variaciones. Puede estar en forma de XML o una tabla #TEMP. |
ProductFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ParentSKU | String | Falso | Requerido. El SKU maestro para un producto con variaciones. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
Type | String | Falso | Tipo de relación; actualmente admitidos son Variación o Accesorio. |
SKU | String | Falso | Se utiliza para identificar un producto individual, una variación (secundaria) del SKU principal. |
RelationAggregate | String | Falso | Un agregado que representa la relación. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando aplique múltiples relaciones |
RelationshipFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de tabla XML o #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | ID de pedido de Amazon. |
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
EstimatedShipDate | Datetime | Cierto | Requerido. Día estimado de envío. |
OrderSourcingOnDemandFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedSubmissionId | String | Un identificador único para el envío del feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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¶
Nombre | Descripción |
---|---|
ListingsItems | Devuelve detalles sobre un artículo de listado para un socio de ventas. |
ListingsItemsAttributes | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
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¶
Nombre | Tipo | Solo lectura | Referencias | Descripción |
---|---|---|---|---|
SKU [KEY] | String | Verdadero | Un socio de ventas proporcionó un identificador para una lista de Amazon. | |
FulfillmentAvailability | String | Falso | Disponibilidad de cumplimiento para el artículo de listados. | |
ProcurementCostCurrency | String | Verdadero | El precio (código de moneda ISO4217) que desea que Amazon le pague por este producto. | |
ProcurementCostAmount | String | Verdadero | El precio (valor numérico) que quieres que Amazon te pague por este producto. |
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.
Nombre | Tipo | Descripción |
---|---|---|
Attributes | String | Este campo es obligatorio para las instrucciones INSERT. Objeto JSON que contiene datos de atributos de elementos de listados estructurados con clave por nombre de atributo. |
SellerId | String | Un identificador de socio de ventas, como una cuenta de comerciante o un código de proveedor. |
Requirements | String | Este campo se puede especificar para sentencias INSERT. Los valores permitidos son LISTING, LISTING_PRODUCT_ONLY, LISTING_OFFER_ONLY. |
ProductType | String | Este campo es obligatorio para las instrucciones INSERT. |
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¶
Nombre | Tipo | Solo lectura | Referencias | Descripción |
---|---|---|---|---|
SKU [KEY] | String | Verdadero | Un socio de ventas proporcionó un identificador para una lista de Amazon. | |
AttributeName [KEY] | String | Falso | El nombre del atributo para el artículo de listados. | |
AttributeValue | String | Falso | El valor del atributo para el artículo de listados. |
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.
Nombre | Tipo | Descripción |
---|---|---|
ProductType | String | El tipo de producto de Amazon del artículo de listados. Necesario para actualizar un atributo. |
SellerId | String | Un identificador de socio de ventas, como una cuenta de comerciante o un código de proveedor. |
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¶
Nombre | Descripción |
---|---|
CatalogItems | La tabla Artículos del catálogo lo ayuda a recuperar los detalles de los artículos del catálogo. |
Feeds | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
InboundShipmentItems | Devuelve una lista de artículos en un envío entrante especificado. |
InboundShipments | Devuelve una lista de envíos entrantes según los criterios que especifique. |
InventorySupply | 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. |
ListingsItemsIssues | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
ListingsItemsOffers | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
ListingsItemsSummaries | La operación GetFeedSubmissionList devuelve una lista de envíos de feeds. |
OrderAckInternal | Información de uso para la operación OrderAckInternal.rsd. |
OrderItemAckInternal | Información de uso para la operación OrderItemAckInternal.rsd. |
OrderItems | Devuelve los artículos del pedido en función del ID de pedido de Amazon que especifique. |
Orders | Devuelve los pedidos creados o actualizados durante un período de tiempo que especifique. |
ReportList | Devuelve los detalles del informe para los informes que coinciden con los filtros que especifique. |
ReportTypes | Devuelve los detalles del informe para los informes que coinciden con los filtros que especifique. |
VendorOrders | La API de socios de ventas para pedidos de compras minoristas brinda acceso programático a los datos de pedidos de proveedores. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
MarketplaceASIN [KEY] | String | El Marketplace ASIN. | |
MarketplaceASINMarketplaceId | String | MarketplaceId de Marketplace ASIN. | |
SKUIdentifierMarketplaceId | String | El SKUIdentifier de MarketplaceId. | |
SKUIdentifierSelerId | String | MarketplaceId de SellerId. | |
SKUIdentifierSellerSKU | String | MarketplaceId de SellerSKU. | |
AttributeSets | String | Los atributos del producto. | |
Relationships | String | Las relaciones del producto. | |
SalesRankings | String | Los rankings de ventas de productos. |
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.
Nombre | Tipo | Descripción |
---|---|---|
Query | String | |
SellerSKU | String | |
UPC | String | |
EAN | String | |
ISBN | String | |
JAN | String | |
MarketplaceId | String |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
FeedId [KEY] | String | El ID de la fuente. Este identificador es único solo en combinación con una identificación de vendedor. | |
FeedType | String | El tipo de fuente. FeedType no es necesario cuando UseSandbox=True. | |
MarketplaceIds | String | Una lista de identificadores de mercado para el informe. | |
CreatedTime | Datetime | La fecha y la hora en que se creó el feed. Durante el filtrado, el valor de CreatedTime solo se acepta hasta los 90 días de antigüedad. | |
ProcessingStatus | String | El estado de procesamiento del informe. | |
ProcessingStartTime | Datetime | La fecha en que comenzó el procesamiento del feed. | |
ProcessingEndTime | Datetime | La fecha en que se completó el procesamiento del feed. | |
ResultFeedDocumentId | String | El identificador del documento de fuente. Este identificador es único solo en combinación con una identificación de vendedor. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ShipmentId [KEY] | String | El ID del envío. | |
SellerSKU [KEY] | String | El SKU del vendedor del artículo. | |
QuantityShipped | Int | La cantidad del artículo que está enviando. | |
QuantityInCase | Int | La cantidad de artículos en cada caso, para artículos empaquetados en cajas. | |
QuantityReceived | Int | La cantidad de artículos que se ha recibido en un centro logístico de Amazon. | |
FulfillmentNetworkSKU | String | SKU de la red logística de Amazon del artículo. | |
PrepDetailsListPrepInstruction | String | Instrucciones de preparación para enviar un artículo a la red logística de Amazon. | |
PrepDetailsListPrepOwner | String | Indica quién preparará el artículo. | |
MarketplaceId | String | Identificador de Marketplace para el informe. | |
ReleaseDate | Date | La fecha en que un artículo de pedido anticipado estará disponible para la venta. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdatedDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ShipmentId [KEY] | String | El ID del envío. | |
ShipmentStatus | String | El estado de su envío entrante. Los valores posibles son TRABAJANDO, ENVIADO, EN TRÁNSITO, ENTREGADO, REGISTRADO, RECIBIENDO, CERRADO, CANCELADO, ELIMINADO y ERROR. | |
ShipmentName | String | El nombre único del envío entrante. | |
ShipFromPostalCode | String | El Código Postal de la dirección del remitente. | |
ShipFromName | String | El nombre de la dirección de devolución. | |
ShipFromCountryCode | String | El código de país de la dirección de devolución. | |
ShipFromDistrictOrCounty | String | El código de estado o provincia de la dirección del remitente. | |
ShipFromStateOrProvinceCode | String | El código de estado o provincia de la dirección del remitente. | |
ShipFromAddressLine1 | String | La información de la dirección de la calle de la dirección del remitente. | |
ShipFromAddressLine2 | String | Información adicional de la dirección de la calle de la dirección del remitente. | |
ShipFromCity | String | La ciudad de la dirección del remitente. | |
LabelPrepType | String | El tipo de preparación de la etiqueta. | |
AreCasesRequired | Boolean | Booleano que indica si un envío entrante contiene o no cajas empaquetadas. | |
DestinationFulfillmentCenterId | String | El identificador del centro logístico de Amazon creado por Amazon. | |
ConfirmedNeedByDate | Date | Fecha en la que el envío debe llegar a un centro logístico de Amazon para artículos pedidos por adelantado. | |
MarketplaceId | String | Identificador de Marketplace para el informe. | |
BoxContentsSource | String | Donde el vendedor proporcionó información sobre el contenido de la caja para un envío. | |
EstimatedBoxContentsFeeTotalUnits | Int | El número de unidades a enviar para una estimación de la tarifa de procesamiento manual que cobra Amazon por las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsFeePerUnitCurrencyCode | String | El código de moneda para una estimación de la tarifa de procesamiento manual que cobra Amazon por las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsFeePerUnitValue | Decimal | La tarifa de procesamiento manual por unidad para una estimación de la tarifa de procesamiento manual cobrada por Amazon por cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsTotalFeeCurrencyCode | String | El código de moneda de la tarifa total para una estimación de la tarifa de procesamiento manual cobrada por Amazon para las cajas sin información sobre el contenido de la caja. | |
EstimatedBoxContentsTotalFeeValue | Decimal | El valor de la tarifa total para una estimación de la tarifa de procesamiento manual cobrada por Amazon para las cajas sin información sobre el contenido de la caja. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdatedDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
UID [KEY] | String | Campo de clave principal generada automáticamente. | |
FNSKU | String | El SKU de la red de cumplimiento (FNSKU) del artículo. El FNSKU es un identificador único para cada artículo de inventario almacenado en un centro logístico de Amazon. | |
SellerSKU | String | El SKU del vendedor del artículo. Obligatorio si no se especifica QueryStartDateTime. | |
ASIN | String | El número de identificación estándar de Amazon (ASIN) del artículo. | |
Condition | String | El estado del artículo. | |
GranularityType | String | ||
GranularityId | String | ||
TotalQuantity | Integer | El número total de unidades en un envío entrante o en los centros logísticos de Amazon. | |
ProductName | String | El título del producto en el idioma localizado del artículo dentro del mercado específico. | |
LastUpdatedTime | String | La fecha y hora en que se actualizó por última vez cualquier cantidad. | |
FulfillableQuantity | Integer | La cantidad de artículos que se pueden recoger, embalar y enviar. | |
InboundWorkingQuantity | Integer | La cantidad de artículos que se pueden recoger, embalar y enviar. | |
InboundShippedQuantity | Integer | La cantidad de artículos que se pueden recoger, embalar y enviar. | |
InboundReceivingQuantity | Integer | La cantidad de artículos que se pueden recoger, embalar y enviar. | |
TotalReservedQuantity | Integer | El número total de unidades en la red logística de Amazon que se están recolectando, empaquetando y enviando actualmente. | |
PendingCustomerOrderQuantity | Integer | El número de unidades reservadas para pedidos de clientes. | |
PendingTransshipmentQuantity | Integer | El número de unidades que se transfieren de un centro logístico a otro. | |
FcProcessingQuantity | Integer | El número de unidades que se han dejado de lado en el centro logístico para procesamiento adicional. | |
TotalUnfulfillableQuantity | Integer | El número total de unidades en la red logística de Amazon en condiciones no vendibles. | |
CustomerDamagedQuantity | Integer | El número de unidades en disposición dañada del cliente. | |
WarehouseDamagedQuantity | Integer | El número de unidades en disposición dañada del almacén. | |
DistributorDamagedQuantity | Integer | El número de unidades en disposición dañada del distribuidor. | |
CarrierDamagedQuantity | Integer | El número de unidades en disposición dañada del transportista. | |
DefectiveQuantity | Integer | El número de unidades en disposición defectuosa. | |
ExpiredQuantity | Integer | El número de unidades en disposición vencida. |
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.
Nombre | Tipo | Descripción |
---|---|---|
StartDateTime | Datetime | |
MarketplaceId | String |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
SKU | String | Un socio de ventas proporcionó un identificador para una lista de Amazon. | |
Code | String | Un código de problema que identifica el tipo de problema. | |
Message | String | Un mensaje que describe el problema. | |
Severity | String | La gravedad del problema. Los valores permitidos son INFO, ADVERTENCIA, ERROR. |
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.
Nombre | Tipo | Descripción |
---|---|---|
SellerId | String |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
SKU | String | Un socio de ventas proporcionó un identificador para una lista de Amazon | |
MarketplaceId | String | Un identificador de mercado. Identifica el mercado de Amazon para el artículo listado. | |
OfferType | String | Tipo de oferta para el artículo de listados. Los valores permitidos son B2B, B2C. | |
PriceAmount | String | Importe del precio de compra del artículo del listado. | |
PriceCurrency | String | Moneda del precio de compra del artículo de listados. | |
Points | String | La cantidad de Amazon Points ofrecidos con la compra de un artículo y su valor monetario. Tenga en cuenta que el elemento Puntos solo se devuelve en Japón (JP). |
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.
Nombre | Tipo | Descripción |
---|---|---|
SellerId | String |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
SKU | String | Un socio de ventas proporcionó un identificador para una lista de Amazon. | |
Asin | String | Número de identificación estándar de Amazon (ASIN) del artículo publicado. | |
ConditionType | String | Identifica la condición del artículo listado. Los valores permitidos son nuevo_nuevo, nuevo_caja_abierta, nuevo_oem, reacondicionado_reacondicionado, usado_como_nuevo, usado_muy_bueno, usado_bueno, usado_aceptable, coleccionable_como_nuevo, coleccionable_muy_bueno, coleccionable_bueno, coleccionable_aceptable, club_club. | |
CreatedDate | Datetime | Fecha en que se creó el artículo de listados, en formato ISO 8601. | |
ItemName | String | Nombre, o título, asociado con un artículo del catálogo de Amazon. | |
LastUpdatedDate | Datetime | Fecha en la que se actualizó por última vez el elemento de la lista, en formato ISO 8601. | |
MainImageLink | String | Enlace, o URL, para la imagen principal. | |
MainImageHeight | Integer | Altura de la imagen principal en píxeles. | |
MainImageWidth | Integer | Ancho de la imagen principal en píxeles. | |
MarketplaceId | String | Un identificador de mercado. Identifica el mercado de Amazon para el artículo listado. | |
ProductType | String | El tipo de producto de Amazon del artículo de listados. | |
Status | String | Estados que se aplican al artículo de listados. |
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.
Nombre | Tipo | Descripción |
---|---|---|
SellerId | String |
OrderAckInterno¶
Información de uso para la operación OrderAckInternal.rsd.
Columnas¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ItemSequenceNumber | String | ||
AmazonProductIdentifier | String | ||
VendorProductIdentifier | String | ||
OrderedAmount | Integer | ||
OrderedUnit | String | Los valores permitidos son Casos, Cada uno. | |
OrderedUnitSize | Integer | ||
NetCostCurrencyCode | String | ||
NetCostAmount | String | ||
ListPriceCurrencyCode | String | ||
ListPriceAmount | String | ||
DiscountMultiplier | String | ||
ItemAcknowledgements | String |
OrderItemAckInterno¶
Información de uso para la operación OrderItemAckInternal.rsd.
Columnas¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
AcknowledgementCode | String | Los valores permitidos son Aceptado, Pedido pendiente, Rechazado. | |
AcknowledgedAmount | Integer | ||
AcknowledgedUnit | String | Los valores permitidos son Casos, Cada uno. | |
AcknowledgedUnitSize | Integer | ||
ScheduledShipDate | Datetime | ||
ScheduledDeliveryDate | Datetime | ||
RejectionReason | String | Los valores permitidos son No disponible temporalmente, Identificador de producto no válido, Producto obsoleto. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
OrderItemId [KEY] | String | Un identificador de artículo de pedido definido por Amazon. | |
AmazonOrderId | String | Pedidos.AmazonOrderId | El ID de Amazon del pedido. |
ASIN | String | El número de identificación estándar de Amazon (ASIN) del artículo. | |
SellerSKU | String | La unidad de mantenimiento de existencias (SKU) del vendedor del artículo. | |
BuyerCustomizedInfoCustomizedURL | String | La URL personalizada del comprador. | |
Title | String | El nombre del artículo. | |
QuantityOrdered | Integer | La cantidad de artículos pedidos. | |
QuantityShipped | Integer | La cantidad de artículos enviados. | |
GrantedPointsNumber | Integer | El Número de Puntos Concedidos. | |
GrantedPointsMonetaryValueAmount | Decimal | La cantidad de puntos otorgados. | |
GrantedPointsMonetaryValueCurrencyCode | String | El código de moneda de los puntos concedidos. | |
NumberOfItems | Integer | El número total de artículos que se incluyen en el ASIN. | |
ItemPriceAmount | Decimal | El importe del precio del artículo. | |
ItemPriceCurrencyCode | String | El código de moneda del precio del artículo. | |
ShippingPriceAmount | Decimal | El monto del precio de envío. | |
ShippingPriceCurrencyCode | String | El código de moneda del precio de envío. | |
GiftWrapPriceAmount | String | El importe del precio del envoltorio de regalo. | |
GiftWrapPriceCurrencyCode | String | El código de moneda del precio del papel de regalo. | |
ItemTaxAmount | Decimal | El importe del impuesto del artículo. | |
ItemTaxCurrencyCode | String | El código de moneda fiscal del artículo. | |
ShippingTaxAmount | String | El monto del impuesto de envío. | |
ShippingTaxCurrencyCode | String | El código de moneda de impuestos de envío. | |
GiftWrapTaxAmount | Decimal | El monto del impuesto sobre el envoltorio de regalo. | |
GiftWrapTaxCurrencyCode | String | El código de moneda del impuesto sobre el envoltorio de regalo. | |
ShippingDiscountAmount | String | El monto del descuento de envío. | |
ShippingDiscountCurrencyCode | String | El código de moneda de descuento de envío. | |
ShippingDiscountTaxAmount | String | El monto del impuesto de descuento de envío. | |
ShippingDiscountTaxCurrencyCode | String | El código de moneda del impuesto de descuento de envío. | |
PromotionDiscountAmount | Decimal | El importe del descuento de la promoción. | |
PromotionDiscountCurrencyCode | String | El código de moneda de descuento de la promoción. | |
PromotionDiscountTaxAmount | Decimal | El Importe del Impuesto de Descuento de la Promoción. | |
PromotionDiscountTaxCurrencyCode | String | El código de moneda del impuesto de descuento de promoción. | |
PromotionIds | String | Los ID de las promociones. | |
CODFeeAmount | Decimal | El monto de la tarifa COD. | |
CODFeeCurrencyCode | String | El código de moneda de tarifa COD. | |
CODFeeDiscountAmount | String | El monto del descuento de la tarifa COD. | |
CODFeeDiscountCurrencyCode | String | El código de moneda de descuento de tarifa COD. | |
IsGift | Boolean | Booleano que especifica si el artículo es un regalo. | |
GiftMessageText | String | El texto del mensaje de regalo. | |
GiftWrapLevel | String | El nivel de envoltorio de regalo. | |
ConditionNote | String | La nota de condición. | |
ConditionId | String | La identificación de la condición. | |
ConditionSubtypeId | String | El ID de subtipo de condición. | |
ScheduledDeliveryStartDate | Datetime | La fecha de inicio de la entrega programada. | |
ScheduledDeliveryEndDate | Datetime | La fecha de finalización de la entrega programada. | |
PriceDesignation | String | La designación del precio. | |
TaxCollectionModel | String | El modelo de recaudación de impuestos aplicado al artículo. | |
TaxCollectionResponsibleParty | String | El responsable de retener los impuestos y remitirlos a la autoridad fiscal. | |
SerialNumberRequired | Boolean | Cuando es verdadero, el tipo de producto para este artículo tiene un número de serie. Devuelto solo para pedidos de Amazon Easy Ship. | |
IsTransparency | Boolean | Cuando es verdadero, se requieren códigos de transparencia. | |
IossNumber | String | El número IOSS para el mercado. | |
StoreChainStoreId | String | El identificador de tienda de la cadena de tiendas. Vinculado a una tienda específica en una cadena de tiendas. | |
DeemedResellerCategory | String | Se aplica a los socios vendedores que no tienen su sede en la UE y se utiliza para ayudarlos a cumplir con las leyes fiscales de revendedor considerado con IVA en la UE y el Reino Unido. | |
IsBuyerRequestedCancel | Boolean | Cuando es verdadero, el comprador ha solicitado la cancelación. | |
BuyerCancelReason | String | El motivo por el que el comprador solicitó la cancelación. | |
BuyerCustomizedInfoURL | String | La ubicación de un archivo zip que contiene datos personalizados de Amazon. | |
GiftWrapPriceAmount | String | El importe del precio del envoltorio de regalo. | |
GiftWrapPriceCurrencyCode | Decimal | El código de moneda del precio del papel de regalo. | |
GiftWrapTaxAmount | String | El monto del impuesto sobre el envoltorio de regalo. | |
GiftWrapTaxCurrencyCode | Decimal | El código de moneda del impuesto sobre el envoltorio de regalo. | |
GiftMessageText | String | Un mensaje de regalo proporcionado por el comprador. | |
GiftWrapLevel | String | El nivel de papel de regalo especificado por el comprador. |
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.
Nombre | Tipo | Descripción |
---|---|---|
LastUpdateDate | Datetime |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
AmazonOrderId [KEY] | String | El ID de Amazon del pedido. | |
SellerOrderId | String | El ID del vendedor del pedido. | |
PurchaseDate | Datetime | La fecha de la compra. | |
LastUpdateDate | Datetime | La última fecha de actualización. | |
OrderStatus | String | Estado del pedido. | |
FulfillmentChannel | String | El Canal de Cumplimiento. | |
SalesChannel | String | El Canal de Ventas. | |
OrderChannel | String | El Canal de la Orden. | |
ShipServiceLevel | String | El nivel del Servicio del Buque. | |
ShippingAddressName | String | El nombre de la dirección de envío. | |
ShippingAddressAddressLine1 | String | La dirección de envío AddressLine. | |
ShippingAddressAddressLine2 | String | La dirección de envío AddressLine. | |
ShippingAddressAddressLine3 | String | La dirección de envío AddressLine. | |
ShippingAddressCity | String | La ciudad de la dirección de envío. | |
ShippingAddressCountry | String | El país de la dirección de envío. | |
ShippingAddressDistrict | String | El distrito de dirección de envío. | |
ShippingAddressStateOrRegion | String | El estado o región de la dirección de envío. | |
ShippingAddressPostalCode | String | El código postal de la dirección de envío. | |
ShippingAddressCountryCode | String | El código de país de la dirección de envío. | |
ShippingAddressPhone | String | El teléfono de la dirección de envío. | |
ShippingAddressMunicipality | String | El Municipio Marítimo. | |
ShippingAddress_AddressType | String | El tipo de dirección de envío. | |
DefaultShipAddressName | String | El nombre de la dirección de envío. | |
DefaultShipAddressLine1 | String | Envío predeterminado desde la dirección de la ubicación AddressLine. | |
DefaultShipAddressLine2 | String | Envío predeterminado desde la dirección de la ubicación AddressLine. | |
DefaultShipAddressLine3 | String | Envío predeterminado desde la dirección de la ubicación AddressLine. | |
DefaultShipCity | String | Ciudad de dirección de ubicación predeterminada de envío. | |
DefaultShipCountry | String | País de dirección de ubicación de envío predeterminado. | |
DefaultShipDistrict | String | Distrito de dirección de ubicación de envío predeterminado. | |
DefaultShipStateOrRegion | String | Envío predeterminado desde la ubicación Dirección Estado o región. | |
DefaultShipPostalCode | String | Dirección de envío predeterminada desde el código postal de la ubicación. | |
DefaultShipCountryCode | String | Código de país de dirección de ubicación de envío predeterminado. | |
DefaultShipPhone | String | Dirección de envío predeterminada desde la ubicación Teléfono. | |
DefaultShipMunicipality | String | El municipio de envío predeterminado. | |
DefaultShip_AddressType | String | Tipo de dirección de envío predeterminado desde la ubicación. | |
OrderTotalCurrencyCode | String | El código de moneda de la orden. | |
OrderTotalAmount | Decimal | El monto del pedido. | |
NumberOfItemsShipped | Integer | El número de artículos enviados. | |
NumberOfItemsUnshipped | Integer | El número de artículos no enviados. | |
PaymentExecutionDetail | String | El Detalle de Ejecución de Pago. | |
PaymentMethod | String | El método de pago. | |
PaymentMethodDetails | String | Los detalles del método de pago. | |
IsReplacementOrder | Boolean | Booleano que especifica si se trata de un pedido de reemplazo. | |
ReplacedOrderId | String | El ID de pedido reemplazado. | |
MarketplaceId | String | El MarketplaceId. | |
BuyerEmail | String | El Correo del comprador. | |
BuyerName | String | El nombre del comprador. | |
BuyerCounty | String | El País Comprador. | |
BuyerTaxInfo | String | La información fiscal del comprador. | |
BuyerInvoicePreference | String | Puede ser individual o empresarial. | |
ShipmentServiceLevelCategory | String | La categoría de nivel de servicio de envío. | |
ShippedByAmazonTFM | Boolean | El enviado por Amazon TFM. | |
TFMShipmentStatus | String | El estado del envío TFM. | |
CbaDisplayableShippingLabel | String | La etiqueta de envío visualizable de Cba. | |
OrderType | String | El tipo de orden. | |
HasAutomatedShippingSettings | Boolean | Si es cierto, este pedido tiene configuraciones de envío automatizadas generadas por Amazon. Esta orden podría identificarse como una orden de la SSA. | |
AutomatedCarrier | String | Transportista generado automáticamente para pedidos de la SSA | |
AutomatedShipMethod | String | Método de envío generado automáticamente para pedidos de la SSA. | |
EarliestShipDate | Datetime | La fecha de envío más temprana. | |
EasyShipShipmentStatus | String | El estado del pedido de Amazon Easy Ship. Esta propiedad se incluye solo para pedidos de Amazon Easy Ship. | |
HasRegulatedItems | Boolean | Si el pedido contiene artículos regulados que pueden requerir pasos de aprobación adicionales antes de cumplirse. | |
PromiseResponseDueDate | Datetime | Indica la fecha en la que el vendedor debe responder al comprador con una fecha estimada de envío. Devuelto solo para pedidos de Sourcing on Demand. | |
LatestShipDate | Datetime | La última fecha de envío. | |
EarliestDeliveryDate | Datetime | La fecha de entrega más temprana. | |
LatestDeliveryDate | Datetime | La última fecha de entrega. | |
IsBusinessOrder | Boolean | Booleano especificando si es una Orden Comercial. | |
IsEstimatedShipDateSet | Boolean | Cuando es verdadero, se establece la fecha de envío estimada para el pedido. Devuelto solo para pedidos de Sourcing on Demand. | |
IsSoldByAB | Boolean | Cuando es verdadero, el artículo dentro de este pedido fue comprado y revendido por Amazon Business EU SARL (ABEU). | |
IsIBA | Boolean | Cuando es verdadero, el artículo dentro de este pedido fue comprado y revendido por Amazon Business EU SARL (ABEU). | |
IsISPU | Boolean | Cuando es verdadero, este pedido está marcado para ser recogido en una tienda en lugar de entregado. | |
IsGlobalExpressEnabled | Boolean | Cuando es verdadero, el pedido es un pedido GlobalExpress. | |
PurchaseOrderNumber | String | El número de orden de compra. | |
IsPrime | Boolean | Booleano especificando si es una Orden Prime. | |
IsPremiumOrder | Boolean | Booleano especificando si es un Pedido Premium. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ReportId [KEY] | String | Identificación del informe. | |
ReportType | String | El tipo del Informe. ReportType no es necesario cuando UseSandbox=True. | |
ReportDocumentId | String | El identificador del documento de informe. | |
CreatedTime | Datetime | La fecha y hora en que se creó el informe. Durante el filtrado, el valor de CreatedTime solo se acepta hasta los 90 días de antigüedad. | |
DataStartTime | Datetime | El inicio de un rango de fechas y horas utilizado para seleccionar los datos para informar. | |
DataEndTime | Datetime | El final de un rango de fechas y horas utilizado para seleccionar los datos para informar. | |
MarketplaceIds | String | Una lista de identificadores de mercado para el informe. | |
ProcessingStartTime | Datetime | La fecha y hora en que comenzó el procesamiento del informe. | |
ProcessingEndTime | Datetime | La fecha y hora en que se completó el procesamiento del informe. | |
ProcessingStatus | String | El estado de procesamiento del informe. |
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
ReportTypeId [KEY] | String | ID secuencial del tipo de informe. | |
ReportTypeValue | String | Valor de enumeración del tipo de informe. | |
ReportFormat | String | El formato de descarga del tipo de informe Los valores permitidos son JSON, XML, CSV, TSV, PDF, XLSX. | |
Category | String | Categoría de formato de informe. | |
Description | String | Descripción del formato del informe. | |
URL | String | enlace de documentación de la API de socios vendedores de Amazon del tipo de informe. |
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 '<', '>' comparacionesSellerPartyId
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¶
Nombre | Tipo | Referencias | Descripción |
---|---|---|---|
PurchaseOrderNumber | String | El número de orden de compra para este pedido. | |
PurchaseOrderState | String | El estado actual de la orden de compra. Los valores permitidos son Nuevo, Confirmado, Cerrado. | |
DealCode | String | Si lo solicita el destinatario, este campo contendrá un número de promoción/oferta. | |
DeliveryWindow | String | Esto indica la ventana de entrega. El formato es fecha de inicio y finalización separadas por doble guión (--) | |
ShipWindow | String | Esto indica la ventana del barco. El formato es fecha de inicio y finalización separadas por doble guión (--). | |
Items | String | Una lista de artículos en esta orden de compra. | |
PaymentMethod | String | Método de pago utilizado. Los valores permitidos son Prepago, Tarjeta de Crédito, Consignación, Factura. | |
PurchaseOrderDate | Datetime | La fecha en que se realizó la orden de compra. | |
PurchaseOrderChangedDate | Datetime | La fecha en la que Amazon cambió por última vez el pedido de compra después de realizar el pedido. | |
PurchaseOrderStateChangedDate | Datetime | La fecha en que se cambió el estado actual de la orden de compra. | |
PurchaseOrderType | String | Tipo de orden de compra. Los valores permitidos son RushOrder, NewProductIntroduction, ConsignedOrder, RegularOrder. | |
BillPartyId | String | Identificación asignada para la parte. Por ejemplo, código de almacén o código de proveedor. | |
BillAddressAddressLine1 | String | Primera línea de la dirección. | |
BillAddressAddressLine2 | String | Información adicional de la dirección, si es necesario. | |
BillAddressAddressLine3 | String | Información adicional de la dirección, si es necesario. | |
BillAddressCity | String | La ciudad donde se encuentra la persona, empresa o institución. | |
BillAddressCountryCode | String | El código de país de dos dígitos en formato ISO 3166-1 alpha-2. | |
BillAddressCounty | String | El condado donde se encuentra la persona, empresa o institución. | |
BillAddressDistrict | String | El distrito donde se encuentra la persona, empresa o institución. | |
BillAddressName | String | El nombre de la dirección de la persona, empresa o institución. | |
BillAddressPhone | String | El número de teléfono de la persona, empresa o institución ubicada en esa dirección. | |
BillAddressPostalCode | String | El código postal de esa dirección. Contiene una serie de letras o dígitos o ambos. | |
BillAddressStateOrRegion | String | El estado o región donde se encuentra la persona, empresa o institución. | |
BillTaxRegistrationNumber | String | Número de registro fiscal de la entidad. Por ejemplo, ID de IVA. | |
BillTaxRegistrationType | String | Tipo de registro fiscal de la entidad. Los valores permitidos son IVA, GST. | |
ShipPartyId | String | Identificación asignada para la parte. Por ejemplo, código de almacén o código de proveedor. | |
ShipAddressAddressLine1 | String | Primera línea de la dirección. | |
ShipAddressAddressLine2 | String | Información adicional de la dirección, si es necesario. | |
ShipAddressAddressLine3 | String | Información adicional de la dirección, si es necesario. | |
ShipAddressCity | String | La ciudad donde se encuentra la persona, empresa o institución. | |
ShipAddressCountryCode | String | El código de país de dos dígitos en formato ISO 3166-1 alpha-2. | |
ShipAddressCounty | String | El condado donde se encuentra la persona, empresa o institución. | |
ShipAddressDistrict | String | El distrito donde se encuentra la persona, empresa o institución. | |
ShipAddressName | String | El nombre de la dirección de la persona, empresa o institución. | |
ShipAddressPhone | String | El número de teléfono de la persona, empresa o institución ubicada en esa dirección. | |
ShipAddressPostalCode | String | El código postal de esa dirección. Contiene una serie de letras o dígitos o ambos. | |
ShipAddressStateOrRegion | String | El estado o región donde se encuentra la persona, empresa o institución. | |
ShipTaxRegistrationNumber | String | Número de registro fiscal de la entidad. Por ejemplo, ID de IVA. | |
ShipTaxRegistrationType | String | Tipo de registro fiscal de la entidad. | |
BuyerPartyId | String | Identificación asignada para la parte. Por ejemplo, código de almacén o código de proveedor. | |
BuyerAddressAddressLine1 | String | Primera línea de la dirección. | |
BuyerAddressAddressLine2 | String | Información adicional de la dirección, si es necesario. | |
BuyerAddressAddressLine3 | String | Información adicional de la dirección, si es necesario. | |
BuyerAddressCity | String | La ciudad donde se encuentra la persona, empresa o institución. | |
BuyerAddressCountryCode | String | El código de país de dos dígitos en formato ISO 3166-1 alpha-2. | |
BuyerAddressCounty | String | El condado donde se encuentra la persona, empresa o institución. | |
BuyerAddressDistrict | String | El distrito donde se encuentra la persona, empresa o institución. | |
BuyerAddressName | String | El nombre de la dirección de la persona, empresa o institución. | |
BuyerAddressPhone | String | El número de teléfono de la persona, empresa o institución ubicada en esa dirección. | |
BuyerAddressPostalCode | String | El código postal de esa dirección. Contiene una serie de letras o dígitos o ambos. | |
BuyerAddressStateOrRegion | String | El estado o región donde se encuentra la persona, empresa o institución. | |
BuyerTaxRegistrationNumber | String | Número de registro fiscal de la entidad. Por ejemplo, ID de IVA. | |
BuyerTaxRegistrationType | String | Tipo de registro fiscal de la entidad. | |
SellerPartyId | String | Identificación asignada para la parte. Por ejemplo, código de almacén o código de proveedor. | |
SellerAddressAddressLine1 | String | Primera línea de la dirección. | |
SellerAddressAddressLine2 | String | Información adicional de la dirección, si es necesario. | |
SellerAddressAddressLine3 | String | Información adicional de la dirección, si es necesario. | |
SellerAddressCity | String | La ciudad donde se encuentra la persona, empresa o institución. | |
SellerAddressCountryCode | String | El código de país de dos dígitos en formato ISO 3166-1 alpha-2. | |
SellerAddressCounty | String | El condado donde se encuentra la persona, empresa o institución. | |
SellerAddressDistrict | String | El distrito donde se encuentra la persona, empresa o institución. | |
SellerAddressName | String | El nombre de la dirección de la persona, empresa o institución. | |
SellerAddressPhone | String | El número de teléfono de la persona, empresa o institución ubicada en esa dirección. | |
SellerAddressPostalCode | String | El código postal de esa dirección. Contiene una serie de letras o dígitos o ambos. | |
SellerAddressStateOrRegion | String | El estado o región donde se encuentra la persona, empresa o institución. | |
SellerTaxRegistrationNumber | String | Número de registro fiscal de la entidad. Por ejemplo, ID de IVA. | |
SellerTaxRegistrationType | String | Tipo de registro fiscal de la entidad. | |
ImportContainers | String | Tipos y números de contenedor(es) para órdenes de compra de importación. Puede ser una lista separada por comas si el envío tiene varios contenedores. | |
InternationalCommercialTerms | String | Los Incoterms (Términos Comerciales Internacionales) se utilizan para dividir los costos de transacción y las responsabilidades entre el comprador y el vendedor y reflejan las prácticas de transporte más modernas. | |
MethodOfPayment | String | Si el destinatario lo solicita, contiene la forma de pago del envío. Esto es solo para pedidos de importación. Los valores permitidos son PaidBySeller, PrepaidBySeller, FOBPortOfCall, DefinedByBuyerAndSeller, CollectOnDelivery, PaidByBuyer. | |
PortOfDelivery | String | El puerto donde el proveedor debe entregar las mercancías en una orden de compra de importación. | |
ShippingInstructions | String | Instrucciones especiales con respecto al envío. |
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¶
Nombre | Descripción |
---|---|
CancelFeed | CancelFeed cancela el envío de feeds para el FeedId dado |
CancelReport | La operación CancelReport cancela la solicitud de informe para el ReportId dado. |
CreateSchema | Crea un archivo de esquema para la tabla o vista especificada. |
GetOAuthAccessToken | Obtiene un token de autenticación de Amazon. |
GetOAuthAuthorizationURL | Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solicitará el OAuthAccessToken desde esta URL. |
GetReport | Crea y/o devuelve datos para un informe específico. |
RefreshOAuthAccessToken | Intercambia un token de acceso por un nuevo token de acceso. |
RequestReport | La operación RequestReport crea una solicitud de informe. |
SubmitImageFeed | El feed de imágenes le permite cargar varias imágenes para un producto. Amazon puede mostrar varias imágenes para cada producto. |
SubmitInventoryFeed | El feed de inventario le permite actualizar las cantidades de inventario (niveles de existencias) de sus artículos. |
SubmitOrderAcknowledgementFeed | El feed de Reconocimiento de pedidos le permite reconocer su éxito o fracaso al descargar un pedido. |
SubmitOrderAdjustmentFeed | 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.). |
SubmitOrderFulfillmentFeed | El feed de Cumplimiento de pedidos permite que su sistema actualice el sistema de Amazon con información de cumplimiento de pedidos. |
SubmitOverrideFeed | 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). |
SubmitPriceFeed | El feed de precios le permite establecer el precio actual y el precio de venta (cuando corresponda) de un artículo. |
SubmitProductFeed | 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. |
SubmitRelationshipFeed | El feed Relación le permite configurar relaciones opcionales entre artículos en su catálogo. |
SubmitSourcingOnDemandFeed | Información de uso para la operación SubmitSourcingOnDemandFeed.rsb. |
SubmitVendorOrderAcknowledgement | Envía acuses de recibo de una orden de compra. |
Cancelar Feed¶
CancelFeed cancela el envío de feeds para el FeedId dado
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
FeedId | String | Cierto | Requerido. El identificador del feed. Este identificador es único solo en combinación con una identificación de vendedor. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
Success | Boolean | Si la operación CancelFeed fue exitosa o no |
Cancelar Informe¶
La operación CancelReport cancela la solicitud de informe para el ReportId dado.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportId | String | Cierto | Requerido. El identificador del informe. Este identificador es único solo en combinación con una identificación de vendedor. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
Success | Boolean | Si la operación CancelReport fue exitosa o no. |
CrearEsquema¶
Crea un archivo de esquema para la tabla o vista especificada.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
TableName | String | Cierto | El nombre de la tabla o vista. |
FileName | String | Cierto | La ruta completa del archivo y el nombre del esquema a generar. Comience eligiendo un directorio principal (este directorio principal debe configurarse en la propiedad Ubicación). Complete la ruta del archivo agregando un directorio correspondiente al esquema utilizado (SellingPartner), seguido de un archivo .rsd con un nombre correspondiente al nombre de la tabla deseada. Por ejemplo: 'C:\Users\User\Desktop\AmazonMarketplace\SellingPartner\Filters.rsd' |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
Result | String | Devuelve éxito o fracaso. |
Obtener Token de Acceso de OAuth¶
Obtiene un token de autenticación de Amazon.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AuthMode | String | Falso | El tipo de modo de autenticación a utilizar. Seleccione Aplicación para obtener tokens de autenticación a través de una aplicación de escritorio. Seleccione Web para obtener tokens de autenticación a través de una aplicación web. Los valores permitidos son APP, WEB. El valor predeterminado es APLICACIÓN. |
CallbackUrl | String | Falso | La URL a la que se redirigirá al usuario después de autorizar su aplicación. Solo es necesario cuando el parámetro Authmode es Web. |
Verifier | String | Falso | El verificador devuelto de Amazon después de que el usuario haya autorizado su aplicación para tener acceso a sus datos. Este valor se devolverá como un parámetro para la URL de devolución de llamada. |
State | String | Falso | Cualquier valor que desee que se envíe con la devolución de llamada. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
OAuthAccessToken | String | El token de acceso utilizado para la comunicación con la API. |
OAuthRefreshToken | String | El token de acceso de actualización utilizado para actualizar su conexión. |
ExpiresIn | String | El tiempo de vida restante en el token de acceso. |
Obtener URL de Autorización de OAuth¶
Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solicitará el OAuthAccessToken desde esta URL.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
CallbackURL | String | Falso | Este campo determina dónde se envía la respuesta. El valor de este parámetro debe coincidir exactamente con uno de los valores registrados en la consola de APIs, incluidos los esquemas HTTP o HTTPS, mayúsculas y minúsculas y barra diagonal final ('/'). |
State | String | Falso | Cualquier valor que desee que se envíe con la devolución de llamada. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
URL | String | La URL de autorización, ingresada en un navegador web para obtener el token de verificación y autorizar su aplicación. |
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
@ReportDocumentId = '1234',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportDocumentId | String | Cierto | ID único del informe a descargar. |
DownloadPath | String | Cierto | La ruta del archivo para escribir los datos del informe. Si no se especifica una ruta, el archivo se mantiene en la memoria en la salida de FileData. |
IsRestrictedReport | Boolean | Falso | Booleano que indica si el ID de informe especificado es un informe restringido (informe que contiene PII). El valor predeterminado es falso. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
Success | Boolean | Booleano que indica el resultado de la operación. |
Url | String | Un identificador único para el informe. |
FileData | String | La salida de datos del archivo, si la entrada LocalPath está vacía. |
RefreshOAuthAccessToken¶
Intercambia un token de acceso por un nuevo token de acceso.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
OAuthRefreshToken | String | Cierto | El token de actualización devuelto del intercambio de código de autorización original. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
OAuthAccessToken | String | El token de autenticación devuelto por Amazon. |
OAuthRefreshToken | String | El token de autenticación devuelto por Amazon. |
ExpiresIn | String | El tiempo de vida restante en el token de acceso. |
Solicitud de Informe¶
La operación RequestReport crea una solicitud de informe.
Aporte¶
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ReportType | String | Cierto | Requerido. Indica el tipo de informe a solicitar. |
DataStartTime | Datetime | Falso | La fecha de inicio del rango de fechas utilizado para seleccionar los datos para informar. De forma predeterminada, es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
DataEndTime | Datetime | Falso | Fecha de finalización del rango de fechas utilizado para seleccionar los datos para informar. Por defecto es la fecha actual. Si se especifica, debe ser anterior a la fecha actual. |
ReportOptions | String | Falso | Información adicional para pasar al informe. Si el informe acepta ReportOptions, la información se muestra en la descripción del informe en la sección del enumerador ReportType. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del Conjunto de Resultados¶
Nombre | Tipo | Descripción |
---|---|---|
ReportId | String | Un identificador único para el informe. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
ImageType | String | Cierto | Requerido. Los valores disponibles son Main, Swatch, BKLB, PT1, PT2, PT3, PT4, PT5, PT6, PT7, PT8, Search, PM01, MainOfferImage, OfferImage1, OfferImage2, OfferImage3, OfferImage4, OfferImage5, PFEE, PFUK, PFDE, PFFR, PFIT, PFES, EEGL, PT98, PT99 y ELFL. |
ImageLocation | String | Falso | La ubicación exacta de la imagen utilizando una URL completa (como http://mystore.com/images/1234.jpg). |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
ProductImageFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
FulfillmentCenterID | String | Falso | Identificador definido por el vendedor para un centro logístico. |
Available | Boolean | Falso | Indica si el artículo está disponible o no (verdadero = disponible; falso = no disponible). |
Quantity | Integer | Falso | Indica si un artículo está disponible o no (cualquier número positivo = disponible; 0 = no disponible). |
RestockDate | Date | Falso | Fecha en que se repondrá el artículo, si no está disponible actualmente. |
FulfillmentLatency | String | Falso | El número de días entre la fecha del pedido y la fecha de envío (un número entero entre 1 y 30). |
SwitchFulfillmentTo | String | Falso | Se usa solo cuando se cambia el cumplimiento de un artículo de MFN (cumplimiento del comerciante) a AFN (cumplimiento de Amazon) o viceversa. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
InventoryFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
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
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | El identificador único de Amazon para un pedido, que identifica el pedido completo, independientemente de la cantidad de artículos individuales en el pedido. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. Amazon asignará MerchantOrderID a AmazonOrderID y, a continuación, podrá utilizar su propio ID de pedido (MerchantOrderID) para los subsiguientes feeds relacionados con el pedido. |
StatusCode | String | Falso | Le permite reconocer su éxito o fracaso al descargar un pedido. StatusCode puede ser Correcto o Incorrecto. |
AmazonOrderItemCode | String | Falso | Identificador único de Amazon para un artículo en un pedido. |
MerchantOrderItemID | String | Falso | ID opcional proporcionada por el vendedor para un artículo en un pedido. Si MerchantOrderItemID se especifica con AmazonOrderItemCode, Amazon asignará los dos ID y luego podrá usar su propio ID de artículo de pedido para los feeds posteriores relacionados con ese artículo de pedido. |
CancelReason | String | Falso | Se usa solo cuando se envía un código de estado de falla. |
ItemAggregate | String | Falso | Un agregado que representa un artículo de pedido. Puede estar en forma de XML o una tabla #TEMP. Utilice este campo cuando sea necesario reconocer varios artículos en el pedido. |
OrderAcknowledgementFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | Identificador único de Amazon para un pedido, que identifica el pedido completo independientemente de la cantidad de artículos individuales en el pedido. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. El primer paso es establecer MerchantOrderID en el feed de confirmación. Amazon asignará MerchantOrderID a AmazonOrderID, y luego podrá usar su propio ID de pedido (MerchantOrderID) para los feeds posteriores relacionados con ese pedido. Consulte el XSD base para ver la definición. |
AdjustedItemQuantityCancelled | Integer | Falso | Cantidad de artículos que se cancelan. Utilizado solo para cancelaciones parciales. |
AdjustedItemAmazonOrderItemCode | String | Falso | ID único de Amazon para un artículo en un pedido. |
AdjustedItemMerchantOrderItemID | String | Falso | ID opcional proporcionada por el vendedor para un artículo en un pedido. Se puede utilizar en el procesamiento de pedidos si el emparejamiento se estableció en el feed de confirmación. |
AdjustedItemMerchantAdjustmentItemID | String | Falso | ID único opcional proporcionado por el vendedor para el ajuste (no utilizado por Amazon). |
AdjustedItemAdjustmentReason | String | Falso | Motivo del ajuste. |
ItemPriceAdjustmentsComponentType | String | Falso | El tipo de ajuste de precio del artículo. Los valores incluyen: principal, envío, impuesto, impuesto de envío, tarifa de reabastecimiento, impuesto de tarifa de reabastecimiento, envoltura de regalo, impuesto de envoltura de regalo, recargo, envío de devolución, fondo de comercio, cargo de exportación, COD, impuesto de COD, otro, reemplazo gratuito, devolución de envío |
ItemPriceAdjustmentsComponentAmount | Decimal | Falso | La cantidad del ajuste. |
ItemPriceAdjustmentsComponentAmountCurrency | String | Falso | La moneda para la cantidad. |
ItemPriceAdjustmentsAggregate | String | Falso | Un agregado que representa la cantidad que el comprador debe reembolsar por el artículo. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario aplicar ajustes de precio de varios artículos. |
PromotionAdjustmentsPromotionClaimCode | String | Falso | El ClaimCode para el Ajuste de Promoción. |
PromotionAdjustmentsMerchantPromotionID | String | Falso | El ID de promoción para el ajuste de promoción. |
PromotionAdjustmentsComponentType | String | Falso | El Tipo de ajuste de precio para la promoción. |
PromotionAdjustmentsComponentAmount | Decimal | Falso | El monto del ajuste de precio para la promoción. |
PromotionAdjustmentsComponentAmountCurrency | String | Falso | La moneda para la cantidad. |
PromotionAdjustmentsComponentAggregate | String | Falso | Un agregado que representa el Importe que el comprador debe reembolsar por la promoción, desglosado por tipo. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario aplicar varios ajustes de precio de promoción. |
PromotionAdjustmentsAggregate | String | Falso | Un agregado que representa la promoción. Los elementos secundarios incluyen PromotionClaimCode, MerchantPromotionID, ComponentAgregate (Type, Amount y Amount@Currency). Utilice este campo si es necesario aplicar varias promociones. |
AdjustedItemAggregate | String | Falso | Un agregado que representa la información de ajuste de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo si es necesario ajustar varios artículos en 1 pedido. |
OrderAdjustmentFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | Identificador único de Amazon para un pedido, que identifica el pedido completo independientemente de la cantidad de artículos individuales en el pedido. |
MerchantOrderID | String | Falso | ID de pedido opcional proporcionado por el vendedor. El primer paso es establecer MerchantOrderID en el feed de confirmación. Amazon asignará MerchantOrderID a AmazonOrderID, y luego podrá usar su propio ID de pedido (MerchantOrderID) para los feeds posteriores relacionados con ese pedido. Consulte el XSD base para ver la definición. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
MerchantFulfillmentID | Integer | Falso | Identificador único proporcionado por el vendedor para el envío (no utilizado por Amazon). |
FulfillmentDate | Datetime | Falso | La fecha en que se envió o recogió el artículo, según el método de cumplimiento especificado en el pedido. |
FulfillmentDataCarrierCode | String | Falso | El código del transportista de envío. |
FulfillmentDataCarrierName | String | Falso | El nombre del transportista. |
FulfillmentDataShippingMethod | String | Falso | El método de envío utilizado para entregar el artículo. |
FulfillmentDataShipperTrackingNumber | String | Falso | El número de seguimiento del envío. |
CODCollectionMethod | String | Falso | Modo de cobro contra reembolso de un pedido. |
ItemAmazonOrderItemCode | String | Falso | ID único de Amazon para un artículo en un pedido. |
ItemMerchantOrderItemID | String | Falso | El ID de envío opcional proporcionado por el vendedor para un artículo en un pedido. |
ItemMerchantFulfillmentItemID | String | Falso | Identificador único proporcionado por el vendedor para un artículo en el envío (no utilizado por Amazon). |
ItemQuantity | Integer | Falso | La cantidad de un artículo enviado. |
ItemAggregate | String | Falso | Un agregado que representa la información de cumplimiento de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando sea necesario incluir varios artículos en el feed. |
FulfillmentDataAggregate | String | Falso | Un agregado que representa la información de cumplimiento de pedidos para un artículo específico. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando sea necesario incluir varios artículos en el feed. |
OrderFulfillmentFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
ShipOption | String | Falso | Servicio de local y envío. |
IsShippingRestricted | Boolean | Falso | Indica si el SKU puede o no enviarse a la configuración regional especificada mediante el servicio de envío especificado (ShipOption). |
Type | String | Falso | El tipo de cargo de envío anulado (aditivo o exclusivo) que se aplica al SKU. |
ShipAmount | Decimal | Falso | El importe del cargo de envío Adicional o Exclusivo. |
ShipAmountCurrency | Decimal | Falso | La moneda utilizada para ShipAmount. |
ShippingOverrideAggregate | String | Falso | Un agregado que representa la anulación de envío. Puede estar en forma de XML o una tabla #TEMP. Utilice este campo si se necesitan varias anulaciones de envío. |
OverrideFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Falso | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
StandardPrice | Double | Falso | Requerido. Precio del artículo (precio de no venta). |
StandardPriceCurrency | String | Falso | Requerido. La moneda para el precio estándar. |
MAP | String | Falso | Precio mínimo anunciado. Usar solo si lo dicta el fabricante. Tanto el precio estándar como el de venta (si corresponde) deben ser superiores al valor del MAP. |
MAPCurrency | String | Falso | Precio mínimo anunciado. Usar solo si lo dicta el fabricante. Tanto el precio estándar como el de venta (si corresponde) deben ser superiores al valor del MAP. |
SalePrice | Double | Falso | El precio de la venta. |
SalePriceCurrency | String | Falso | La moneda de la venta. |
SaleStartDate | Datetime | Falso | La fecha de inicio de la venta. |
SaleEndDate | Datetime | Falso | La fecha de finalización de la venta. |
PriceFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
MarketplaceIds | String | Falso | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
SKU | String | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
OperationType | String | Cierto | Requerido. Se utiliza para especificar el tipo de operación (Actualización, Eliminación o Actualización parcial) que se realizará en los datos. |
StandardProductID | String | Falso | Un identificador único estándar para un producto, que consta de un tipo (ISBN, UPC o EAN) y un valor que se ajusta al formato apropiado para el tipo especificado. Este es un campo obligatorio si se proporciona Tipo para StandardProductID en el XSD base. |
ProductTaxCode | String | Falso | Código estándar de Amazon para identificar las propiedades fiscales de un producto. |
LaunchDate | Datetime | Falso | Controla cuándo aparece el producto en las búsquedas y navegación en la web de Amazon. |
DiscontinueDate | Datetime | Falso | Controla cuando el producto desaparece de las búsquedas y navegación en la web de Amazon. |
ReleaseDate | Datetime | Falso | La fecha en que un producto sale a la venta. |
Condition | String | Falso | El estado del artículo. |
Rebate | String | Falso | La rebaja del producto. |
ItemPackageQuantity | Integer | Falso | Número del mismo producto contenido dentro de un paquete. Por ejemplo, si vende una caja de 10 paquetes de calcetines, ItemPackageQuantity sería 10. |
NumberOfItems | Integer | Falso | Número de artículos discretos incluidos en el producto que ofrece a la venta, de modo que cada artículo no esté empaquetado para la venta individual. Por ejemplo, si vende una caja de 10 paquetes de calcetines y cada paquete contiene 3 pares de calcetines, NumberOfItems sería 30. |
Title | String | Cierto | Requerido. Breve descripción del producto. |
Brand | String | Falso | Marca del producto. |
Designer | String | Falso | Diseñador del producto. |
Description | String | Falso | Descripción larga del producto. |
BulletPoint | String | Falso | Breves descripciones de las características del producto. |
PackageDimensionsLength | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsWidth | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsHeight | String | Falso | Dimensiones calculadas del paquete. |
PackageDimensionsWeight | String | Falso | Dimensiones calculadas del paquete. |
ItemDimensionsLength | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsWidth | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsHeight | String | Falso | Dimensiones calculadas del artículo. |
ItemDimensionsWeight | String | Falso | Dimensiones calculadas del artículo. |
PackageWeight | String | Falso | Peso del paquete. |
ShippingWeight | String | Falso | Peso del producto cuando se empaqueta para enviar. |
MerchantCatalogNumber | String | Falso | Número de catálogo del vendedor para el producto, si es diferente al SKU. |
MSRP | Double | Falso | Precio de venta sugerido por el fabricante. |
MaxOrderQuantity | Integer | Falso | Cantidad máxima del producto que un cliente puede pedir. |
SerialNumberRequired | Boolean | Falso | Indica si el producto debe tener un número de serie. |
Prop65 | Boolean | Falso | Se usa si el producto está sujeto a las reglamentaciones de la Proposición 65 en California. Solo nosotros. |
LegalDisclaimer | String | Falso | Cualquier descargo de responsabilidad legal necesario para el producto. |
Manufacturer | String | Falso | Fabricante del producto. |
MfrPartNumber | String | Falso | Número de pieza proporcionado por el fabricante original. |
SearchTerms | String | Falso | Términos que envía que dan resultados de búsqueda de productos. |
PlatinumKeywords | String | Falso | Valores utilizados para asignar productos a nodos en una estructura de exploración personalizada. |
RecommendedBrowseNode | String | Falso | Valor utilizado para clasificar un artículo. |
Memorabilia | Boolean | Falso | Se utiliza si el producto es un artículo de recuerdo. |
Autographed | Boolean | Falso | Se utiliza si el producto es un artículo autografiado. |
UsedFor | String | Falso | Para qué se utiliza el producto (afecta la ubicación del producto en la estructura de navegación de Amazon). |
ItemType | String | Falso | Valor predefinido que especifica dónde debe aparecer el producto dentro de la estructura de navegación de Amazon. |
OtherItemAttributes | String | Falso | Se utiliza para clasificar aún más el producto dentro de la estructura de navegación de Amazon. |
TargetAudience | String | Falso | Se utiliza para clasificar aún más el producto dentro de la estructura de navegación de Amazon. |
SubjectContent | String | Falso | Se utiliza para relacionar el producto con una idea o concepto específico para la comercialización. |
IsGiftWrapAvailable | Boolean | Falso | Indica si el envoltorio de regalo está disponible para el producto. |
IsGiftMessageAvailable | Boolean | Falso | Indica si los mensajes de regalo están disponibles para el producto. |
IsDiscontinuedByManufacturer | Boolean | Falso | Indica que el fabricante ha dejado de fabricar el artículo. |
MaxAggregateShipQuantity | Integer | Falso | El número máximo del mismo artículo que se puede enviar en el mismo paquete. |
ProductDescriptionDataAggregate | String | Falso | Sección que contiene información específica de la categoría, como variaciones. Puede estar en forma de XML o una tabla #TEMP. |
ProductDataAggregate | String | Falso | Sección que contiene información específica de la categoría, como variaciones. Puede estar en forma de XML o una tabla #TEMP. |
ProductFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML, JSON o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
ParentSKU | String | Falso | Requerido. El SKU maestro para un producto con variaciones. |
OperationType | String | Falso | Requerido. Se utiliza para especificar el tipo de operación (Actualizar o Eliminar) que se realizará en los datos. |
Type | String | Falso | Tipo de relación; actualmente admitidos son Variación o Accesorio. |
SKU | String | Falso | Se utiliza para identificar un producto individual, una variación (secundaria) del SKU principal. |
RelationAggregate | String | Falso | Un agregado que representa la relación. Puede estar en forma de XML, JSON o una tabla #TEMP. Utilice este campo cuando aplique múltiples relaciones |
RelationshipFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de tabla XML o #TEMP. |
MarketplaceIds | String | Falso | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
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', marketplaceids = 'A1VC38T7YXB528'
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
AmazonOrderID | String | Falso | ID de pedido de Amazon. |
SKU | Datetime | Cierto | Requerido. Se utiliza para identificar un producto individual. Cada producto debe tener un SKU y cada SKU debe ser único. |
EstimatedShipDate | String | Cierto | Requerido. Día estimado de envío. |
OrderSourcingOnDemandFeedAggregate | String | Falso | Un agregado que representa el feed. Puede estar en forma de XML o una tabla #TEMP. |
MarketplaceIds | String | Cierto | Requerido. Una lista de uno o más ID de mercado para el mercado que registró la cuenta de listado. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
FeedId | String | Un identificador único para el feed. |
FeedType | String | El tipo de feed enviado. |
SubmittedDate | Datetime | La fecha y la hora en que se envió el feed. |
FeedProcessingStatus | String | El estado de procesamiento del envío del feed. |
EnviarProveedorOrderAcknowledgement¶
Envía acuses de recibo de una orden de compra.
Ejecutar¶
El controlador utiliza tablas #TEMP como campos para la información agregada ingresada
Debes incluir en tu consultar información de ambos OrderAcknowledgement
y OrderItemAcknowledgement
.
Primero creamos una tabla temporal OrderItemAcknowledgements para el OrderAcknowledgement número 1:
INSERT INTO itemAck1#temp(AcknowledgementCode, AcknowledgedAmount, AcknowledgedUnit, AcknowledgedUnitSize, ScheduledShipDate, ScheduledDeliveryDate, RejectionReason)
VALUES ('Accepted', 100, 'Cases', 10, '2022-02-02T12:00:00Z', '2022-02-10T15:00:00Z', 'TemporarilyUnavailable')
INSERT INTO itemAck1#temp(AcknowledgementCode, AcknowledgedAmount, AcknowledgedUnit, AcknowledgedUnitSize, ScheduledShipDate, ScheduledDeliveryDate, RejectionReason)
VALUES ('Accepted', 100, 'Cases', 20, '2022-03-02T12:00:00Z', '2022-03-10T15:00:00Z', 'InvalidProductIdentifier')
INSERT INTO itemAck1#temp(AcknowledgementCode, AcknowledgedAmount, AcknowledgedUnit, AcknowledgedUnitSize, ScheduledShipDate, ScheduledDeliveryDate, RejectionReason)
VALUES ('Rejected', 100, 'Cases', 30, '2022-04-02T12:00:00Z', '2022-04-10T15:00:00Z', 'ObsoleteProduct')
INSERT INTO itemAck1#temp(AcknowledgementCode, AcknowledgedAmount, AcknowledgedUnit, AcknowledgedUnitSize, ScheduledShipDate, ScheduledDeliveryDate, RejectionReason)
VALUES ('Rejected', 101, 'Cases', 30, '2022-04-02T12:00:00Z', '2022-04-10T15:00:00Z', 'ObsoleteProduct')
Luego creamos otra tabla temporal OrderItemAcknowledgements para el OrderAcknowledgement número 2:
INSERT INTO itemAck2#temp(AcknowledgementCode, AcknowledgedAmount, AcknowledgedUnit, AcknowledgedUnitSize, ScheduledShipDate, ScheduledDeliveryDate, RejectionReason)
VALUES ('Accepted', 99, 'Cases', 9, '2022-09-09T12:00:00Z', '2022-08-8T15:00:00Z', 'ObsoleteProduct')
Después de eso, tenemos que crear otra tabla temporal que haga referencia a las tablas temporales creadas previamente itemAck1#temp y itemAck2#temp
INSERT INTO orderAck#temp(ItemSequenceNumber, AmazonProductIdentifier, VendorProductIdentifier, OrderedAmount, OrderedUnit, OrderedUnitSize, NetCostCurrencyCode, NetCostAmount, ListPriceCurrencyCode, ListPriceAmount, DiscountMultiplier, ItemAcknowledgements)
VALUES ('seq1', 'id1', 'vendId1', 100, 'Cases', 2, 'ALL', 999, 'ALL', 999, 'discount_multiplier_123', 'itemAck1#temp')
INSERT INTO orderAck#temp(ItemSequenceNumber, AmazonProductIdentifier, VendorProductIdentifier, OrderedAmount, OrderedUnit, OrderedUnitSize, NetCostCurrencyCode, NetCostAmount, ListPriceCurrencyCode, ListPriceAmount, DiscountMultiplier, ItemAcknowledgements)
VALUES ('seq2', 'id2', 'vendId2', 200, 'Cases', 4, 'ALL', 992, 'ALL', 992, 'discount_multiplier_456', 'itemAck2#temp')
Después de haber creado las tablas temporales necesarias, podemos ejecutar el procedimiento almacenado, como se muestra en el siguiente ejemplo:
EXECUTE SubmitVendorOrderAcknowledgement
PurchaseOrderNumber = 'PurchaseOrderNumber1',
SellerPartyId = '123',
SellerTaxRegistrationType = 'VAT',
SellerTaxRegistrationNumber = '123456',
AcknowledgementDate = '2022-01-01T10:00:00.000',
Items = 'orderAck#temp';
OrderAcknowledgement
información de esquema de tabla temporal:
Nombre de columna | Tipo | Obligatorio | Descripción |
---|---|---|---|
Número de secuencia de artículo | cadena | falso | Número de secuencia de artículo de línea para el artículo. |
Identificador de producto de Amazon | cadena | falso | Número de identificación estándar de Amazon (ASIN) de un artículo. |
Identificador de producto de proveedor | cadena | falso | El proveedor seleccionó la identificación del producto del artículo. Debe ser el mismo que se envió en la orden de compra. |
Monto pedido | entero | cierto | Cantidad ordenada. Este valor no debe ser cero. |
Unidad ordenada | cadena | cierto | Unidad de medida de la cantidad pedida. |
Tamaño de la unidad ordenada | entero | cierto | El tamaño de la caja, en caso de que ordenemos usando cajas. |
NetCostCurrencyCode | cadena | falso | Código de moneda de tres dígitos en formato ISO 4217. |
Importe del coste neto | cadena | falso | Un número decimal sin pérdida de precisión. |
ListPriceCurrencyCode | cadena | falso | Código de moneda de tres dígitos en formato ISO 4217. |
ListaPrecioCantidad | cadena | falso | Un número decimal sin pérdida de precisión. |
DescuentoMultiplicador | cadena | falso | El multiplicador de descuento que se debe aplicar al precio si un vendedor vende libros con un precio de lista. |
ArtículoAgradecimientos | cadena | cierto | Se utiliza para indicar la cantidad reconocida. Debe especificarse mediante una tabla #temp. |
OrderItemAcknowledgement
información de esquema de tabla temporal:
Nombre de columna | Tipo | Obligatorio | Descripción |
---|---|---|---|
Código de reconocimiento | cadena | cierto | Esto indica el código de reconocimiento. |
Importe reconocido | entero | cierto | Cantidad ordenada. Este valor no debe ser cero. |
Unidad reconocida | cadena | cierto | Unidad de medida de la cantidad pedida. |
Tamaño de unidad reconocido | entero | falso | El tamaño de la caja, en caso de que ordenemos usando cajas. |
Fecha de envío programada | fecha y hora | falso | Fecha de envío estimada por artículo de línea. Debe estar en formato de fecha/hora ISO-8601. |
Fecha de entrega programada | fecha y hora | falso | Fecha de entrega estimada por línea de pedido. Debe estar en formato de fecha/hora ISO-8601. |
Razón de rechazo | cadena | falso | Indica el motivo del rechazo. |
Aporte
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
PurchaseOrderNumber | String | Cierto | El número de orden de compra |
SellerPartyId | String | Cierto | Identificación asignada para la parte. Por ejemplo, código de almacén o código de proveedor. |
SellerTaxRegistrationNumber | String | Falso | Número de registro fiscal de la entidad. Por ejemplo, ID de IVA. |
SellerTaxRegistrationType | String | Falso | Tipo de registro fiscal de la entidad. Los valores permitidos son IVA, GST. |
SellerAddressAddressLine1 | String | Falso | Primera línea de la dirección. |
SellerAddressAddressLine2 | String | Falso | Información adicional de la dirección, si es necesario. |
SellerAddressAddressLine3 | String | Falso | Información adicional de la dirección, si es necesario. |
SellerAddressCity | String | Falso | La ciudad donde se encuentra la persona, empresa o institución. |
SellerAddressCountryCode | String | Falso | El código de país de dos dígitos en formato ISO 3166-1 alpha-2. |
SellerAddressCounty | String | Falso | El condado donde se encuentra la persona, empresa o institución. |
SellerAddressDistrict | String | Falso | El distrito donde se encuentra la persona, empresa o institución. |
SellerAddressName | String | Falso | El nombre de la dirección de la persona, empresa o institución. |
SellerAddressPhone | String | Falso | El número de teléfono de la persona, empresa o institución ubicada en esa dirección. |
SellerAddressPostalCode | String | Falso | El código postal de esa dirección. Contiene una serie de letras o dígitos o ambos. |
SellerAddressStateOrRegion | String | Falso | El estado o región donde se encuentra la persona, empresa o institución. |
Items | String | Cierto | Una representación agregada de elementos. Puede tener la forma de una tabla #TEMP. |
AcknowledgementDate | Datetime | Falso | La fecha y hora en que se reconoce la orden de compra, en formato de fecha/hora ISO-8601. |
Columnas del conjunto de resultados
Nombre | Tipo | Descripción |
---|---|---|
Success | String | |
TransactionId | String |
Tablas del Sistema¶
Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.
Tablas de Esquema¶
Las siguientes tablas devuelven metadatos de la base de datos para Amazon Marketplace:
- sys_catalogs: enumera las bases de datos disponibles.
- sys_schemas: enumera los esquemas disponibles.
- sys_tablas: enumera las tablas y vistas disponibles.
- sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
- procedimientos_sys: describe los procedimientos almacenados disponibles.
- parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
- sys_keycolumns: describe las claves principal y externa.
- índices_sys: Describe los índices disponibles.
Tablas de Fuentes de Datos¶
Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:
- sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
- sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.
Tablas de Información de Consultas¶
La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:
- identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.
Sys_catalogs¶
Enumera las bases de datos disponibles.
La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:
SELECT * FROM sys_catalogs
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos. |
Sys_schemas¶
Enumera los esquemas disponibles.
La siguiente consultar recupera todos los esquemas disponibles:
SELECT * FROM sys_schemas
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos. |
SchemaName | String | El nombre del esquema. |
Sys_tables¶
Enumera las tablas disponibles.
La siguiente consultar recupera las tablas y vistas disponibles:
SELECT * FROM sys_tables
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | La base de datos que contiene la tabla o vista. |
SchemaName | String | El esquema que contiene la tabla o vista. |
TableName | String | El nombre de la tabla o vista. |
TableType | String | El tipo de tabla (tabla o vista). |
Description | String | Una descripción de la tabla o vista. |
IsUpdateable | Boolean | Si la tabla se puede actualizar. |
Sys_tablecolumns¶
Describe las columnas de las tablas y vistas disponibles.
La siguiente consultar devuelve las columnas y los tipos de datos de la tabla Pedidos:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Orders'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la tabla o vista. |
SchemaName | String | El esquema que contiene la tabla o vista. |
TableName | String | El nombre de la tabla o vista que contiene la columna. |
ColumnName | String | El nombre de la columna. |
DataTypeName | String | El nombre del tipo de datos. |
DataType | Int32 | Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente. |
Length | Int32 | El tamaño de almacenamiento de la columna. |
DisplaySize | Int32 | El ancho máximo normal de la columna designada en caracteres. |
NumericPrecision | Int32 | El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora. |
NumericScale | Int32 | La escala de columna o número de dígitos a la derecha del punto decimal. |
IsNullable | Boolean | Si la columna puede contener nulo. |
Description | String | Una breve descripción de la columna. |
Ordinal | Int32 | El número de secuencia de la columna. |
IsAutoIncrement | String | Si el valor de la columna se asigna en incrementos fijos. |
IsGeneratedColumn | String | Si se genera la columna. |
IsHidden | Boolean | Si la columna está oculta. |
IsArray | Boolean | Si la columna es una matriz. |
Sys_procedimientos¶
Enumera los procedimientos almacenados disponibles.
La siguiente consultar recupera los procedimientos almacenados disponibles:
SELECT * FROM sys_procedures
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | La base de datos que contiene el procedimiento almacenado. |
SchemaName | String | El esquema que contiene el procedimiento almacenado. |
ProcedureName | String | El nombre del procedimiento almacenado. |
Description | String | Una descripción del procedimiento almacenado. |
ProcedureType | String | El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN. |
Sys_procedureparameters¶
Describe procedimiento almacenado* parámetros.
La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SampleProcedure:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' AND Direction=1 OR Direction=2
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene el procedimiento almacenado. |
SchemaName | String | El nombre del esquema que contiene el procedimiento almacenado. |
ProcedureName | String | El nombre del procedimiento almacenado* que contiene el parámetro. |
ColumnName | String | El nombre del procedimiento almacenado* parámetro. |
Direction | Int32 | Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida. |
DataTypeName | String | El nombre del tipo de datos. |
DataType | Int32 | Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente. |
Length | Int32 | El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos. |
NumericPrecision | Int32 | La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora. |
NumericScale | Int32 | El número de dígitos a la derecha del punto decimal en datos numéricos. |
IsNullable | Boolean | Si el parámetro puede contener nulo. |
IsRequired | Boolean | Si el parámetro es necesario para la ejecución del procedimiento. |
IsArray | Boolean | Si el parámetro es una matriz. |
Description | String | La descripción del parámetro. |
Ordinal | Int32 | El índice del parámetro. |
Sys_keycolumns¶
Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla Pedidos:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Orders'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la clave. |
SchemaName | String | El nombre del esquema que contiene la clave. |
TableName | String | El nombre de la tabla que contiene la clave. |
ColumnName | String | El nombre de la columna clave. |
IsKey | Boolean | Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName. |
IsForeignKey | Boolean | Si la columna es una clave externa a la que se hace referencia en el campo TableName. |
PrimaryKeyName | String | El nombre de la clave principal. |
ForeignKeyName | String | El nombre de la clave foránea. |
ReferencedCatalogName | String | La base de datos que contiene la clave principal. |
ReferencedSchemaName | String | El esquema que contiene la clave principal. |
ReferencedTableName | String | La tabla que contiene la clave principal. |
ReferencedColumnName | String | El nombre de la columna de la clave principal. |
Sys_foreignkeys¶
Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene la clave. |
SchemaName | String | El nombre del esquema que contiene la clave. |
TableName | String | El nombre de la tabla que contiene la clave. |
ColumnName | String | El nombre de la columna clave. |
PrimaryKeyName | String | El nombre de la clave principal. |
ForeignKeyName | String | El nombre de la clave foránea. |
ReferencedCatalogName | String | La base de datos que contiene la clave principal. |
ReferencedSchemaName | String | El esquema que contiene la clave principal. |
ReferencedTableName | String | La tabla que contiene la clave principal. |
ReferencedColumnName | String | El nombre de la columna de la clave principal. |
ForeignKeyType | String | Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas). |
Sys_indexes¶
Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.
La siguiente consultar recupera todos los índices que no son claves principales:
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
CatalogName | String | El nombre de la base de datos que contiene el índice. |
SchemaName | String | El nombre del esquema que contiene el índice. |
TableName | String | El nombre de la tabla que contiene el índice. |
IndexName | String | El nombre del índice. |
ColumnName | String | El nombre de la columna asociada con el índice. |
IsUnique | Boolean | True si el índice es único. Falso en caso contrario. |
IsPrimary | Boolean | True si el índice es una clave principal. Falso en caso contrario. |
Type | Int16 | Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3). |
SortOrder | String | El orden de clasificación: A para ascender o D para descender. |
OrdinalPosition | Int16 | El número de secuencia de la columna en el índice. |
Sys_connection_props¶
Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.
Al consultar esta tabla, se debe usar la cadena de conexión de configuración:
jdbc:cdata:amazonmarketplace:config:
Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.
La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:
SELECT * FROM sys_connection_props WHERE Value <> ''
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Name | String | El nombre de la propiedad de conexión. |
ShortDescription | String | Una breve descripción. |
Type | String | El tipo de datos de la propiedad de conexión. |
Default | String | El valor predeterminado si no se establece uno explícitamente. |
Values | String | Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor. |
Value | String | El valor que establezca o un valor predeterminado preconfigurado. |
Required | Boolean | Si la propiedad es necesaria para conectarse. |
Category | String | La categoría de la propiedad de conexión. |
IsSessionProperty | String | Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual. |
Sensitivity | String | El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación. |
PropertyName | String | Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión. |
Ordinal | Int32 | El índice del parámetro. |
CatOrdinal | Int32 | El índice de la categoría de parámetro. |
Hierarchy | String | Muestra las propiedades dependientes asociadas que deben configurarse junto con esta. |
Visible | Boolean | Informa si la propiedad está visible en la interfaz de usuario de la conexión. |
ETC | String | Diversa información miscelánea sobre la propiedad. |
Sys_sqlinfo¶
Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.
Procesamiento Colaborativo de Consultas¶
Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.
Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶
A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.
Nombre | Descripción | Valores posibles |
---|---|---|
AGGREGATE_FUNCTIONS | Funciones de agregación admitidas. | AVG , COUNT , MAX , MIN , SUM , DISTINCT |
COUNT | Si se admite la función COUNT. | YES , NO |
IDENTIFIER_QUOTE_OPEN_CHAR | El carácter de apertura utilizado para escapar de un identificador. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | El carácter de cierre utilizado para escapar de un identificador. | ] |
SUPPORTED_OPERATORS | Una lista de operadores de SQL admitidos. | = , > , < , >= , <= , <> , != , LIKE , NOT LIKE , IN , NOT IN , IS NULL , IS NOT NULL , AND , OR |
GROUP_BY | Si se admite GROUP BY y, de ser así, el grado de compatibilidad. | NO , NO_RELATION , EQUALS_SELECT , SQL_GB_COLLATE |
STRING_FUNCTIONS | Funciones de cadena admitidas. | LENGTH , CHAR , LOCATE , REPLACE , SUBSTRING , RTRIM , LTRIM , RIGHT , LEFT , UCASE , SPACE , SOUNDEX , LCASE , CONCAT , ASCII , REPEAT , OCTET , BIT , POSITION , INSERT , TRIM , UPPER , REGEXP , LOWER , DIFFERENCE , CHARACTER , SUBSTR , STR , REVERSE , PLAN , UUIDTOSTR , TRANSLATE , TRAILING , TO , STUFF , STRTOUUID , STRING , SPLIT , SORTKEY , SIMILAR , REPLICATE , PATINDEX , LPAD , LEN , LEADING , KEY , INSTR , INSERTSTR , HTML , GRAPHICAL , CONVERT , COLLATION , CHARINDEX , BYTE |
NUMERIC_FUNCTIONS | Funciones numéricas compatibles. | ABS , ACOS , ASIN , ATAN , ATAN2 , CEILING , COS , COT , EXP , FLOOR , LOG , MOD , SIGN , SIN , SQRT , TAN , PI , RAND , DEGREES , LOG10 , POWER , RADIANS , ROUND , TRUNCATE |
TIMEDATE_FUNCTIONS | Funciones de fecha/hora admitidas. | NOW , CURDATE , DAYOFMONTH , DAYOFWEEK , DAYOFYEAR , MONTH , QUARTER , WEEK , YEAR , CURTIME , HOUR , MINUTE , SECOND , TIMESTAMPADD , TIMESTAMPDIFF , DAYNAME , MONTHNAME , CURRENT_DATE , CURRENT_TIME , CURRENT_TIMESTAMP , EXTRACT |
REPLICATION_SKIP_TABLES | Indica tablas omitidas durante la replicación. | |
REPLICATION_TIMECHECK_COLUMNS | Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación. | |
IDENTIFIER_PATTERN | Valor de cadena que indica qué cadena es válida para un identificador. | |
SUPPORT_TRANSACTION | Indica si el proveedor admite transacciones como compromiso y reversión. | YES , NO |
DIALECT | Indica el dialecto SQL a usar. | |
KEY_PROPERTIES | Indica las propiedades que identifican la base de datos uniforme. | |
SUPPORTS_MULTIPLE_SCHEMAS | Indica si pueden existir varios esquemas para el proveedor. | YES , NO |
SUPPORTS_MULTIPLE_CATALOGS | Indica si pueden existir varios catálogos para el proveedor. | YES , NO |
DATASYNCVERSION | La versión de sincronización de datos necesaria para acceder a este controlador. | Standard , Starter , Professional , Enterprise |
DATASYNCCATEGORY | La categoría Sincronización de datos de este controlador. | Source , Destination , Cloud Destination |
SUPPORTSENHANCEDSQL | Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. | TRUE , FALSE |
SUPPORTS_BATCH_OPERATIONS | Si se admiten las operaciones lote. | YES , NO |
SQL_CAP | Todas las funciones de SQL admitidas para este controlador. | SELECT , INSERT , DELETE , UPDATE , TRANSACTIONS , ORDERBY , OAUTH , ASSIGNEDID , LIMIT , LIKE , BULKINSERT , COUNT , BULKDELETE , BULKUPDATE , GROUPBY , HAVING , AGGS , OFFSET , REPLICATE , COUNTDISTINCT , JOINS , DROP , CREATE , DISTINCT , INNERJOINS , SUBQUERIES , ALTER , MULTIPLESCHEMAS , GROUPBYNORELATION , OUTERJOINS , UNIONALL , UNION , UPSERT , GETDELETED , CROSSJOINS , GROUPBYCOLLATE , MULTIPLECATS , FULLOUTERJOIN , MERGE , JSONEXTRACT , BULKUPSERT , SUM , SUBQUERIESFULL , MIN , MAX , JOINSFULL , XMLEXTRACT , AVG , MULTISTATEMENTS , FOREIGNKEYS , CASE , LEFTJOINS , COMMAJOINS , WITH , LITERALS , RENAME , NESTEDTABLES , EXECUTE , BATCH , BASIC , INDEX |
PREFERRED_CACHE_OPTIONS | Un valor de cadena especifica las cacheOptions preferidas. | |
ENABLE_EF_ADVANCED_QUERY | Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. | YES , NO |
PSEUDO_COLUMNS | Una matriz de cadenas que indica las pseudocolumnas disponibles. | |
MERGE_ALWAYS | Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. | TRUE , FALSE |
REPLICATION_MIN_DATE_QUERY | Una consultar de selección para devolver la fecha y hora de inicio de la réplica. | |
REPLICATION_MIN_FUNCTION | Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor. | |
REPLICATION_START_DATE | Permite que un proveedor especifique una fecha de inicio de réplica. | |
REPLICATION_MAX_DATE_QUERY | Una consultar de selección para devolver la fecha y hora de finalización de la réplica. | |
REPLICATION_MAX_FUNCTION | Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial. | |
CHECKCACHE_USE_PARENTID | Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. | TRUE , FALSE |
CREATE_SCHEMA_PROCEDURES | Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema. |
La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:
SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'
Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
NAME | String | Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor. |
VALUE | String | Detalles sobre el SQL o la sintaxis de SQL admitidos. |
Sys_identidad¶
Devuelve información sobre los intentos de modificación.
La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:
SELECT * FROM sys_identity
Columnas¶
Nombre | Tipo | Descripción |
---|---|---|
Id | String | El ID generado por la base de datos devuelto de una operación de modificación de datos. |
Batch | String | Un identificador para el lote. 1 para una sola operación. |
Operation | String | El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO. |
Message | String | ÉXITO o un mensaje de error si falla la actualización en el lote. |
Propiedades de Configuraciones Avanzadas¶
Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.
Propiedad | Descripción |
---|---|
Schema | El tipo de esquema a utilizar. |
AWSRegion | La región de alojamiento de sus Amazon Web Services. |
AWSAccessKeyId | El ID de AWS AccessKey que recibió cuando se registró en Amazon MWS. |
Marketplace | La región de Marketplace en la que está registrado para vender. |
MWSAuthToken | El token de autorización que recibió cuando se registró en Amazon MWS. |
SellerId | El ID de vendedor que recibió cuando se registró en Amazon MWS. |
AWSRoleARN | El nombre de recurso de Amazon del rol que se usará al autenticarse. |
AppId | ID de aplicación para la aplicación de socio de ventas que creó. |
AWSSessionToken | Token de sesión de AWS para la aplicación de socio vendedor que creó. |
AWSAccessKey | Su clave de acceso de AWS. |
AWSSecretKey | Su clave secreta de AWS. |
SellingPartner | Especifica el tipo de socio de ventas. |
IncludeRestrictedData | Determina si se deben usar tokens de datos restringidos (RDT) para recuperar información de identificación personal (PII). |
UseSandbox | Un valor booleano que determina si la conexión se debe realizar con la cuenta de sandbox del socio de ventas. |
Propiedad | Descripción |
---|---|
InitiateOAuth | Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte. |
OAuthClientId | El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. |
OAuthClientSecret | El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. |
OAuthAccessToken | El token de acceso para conectarse mediante OAuth. |
CallbackURL | La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación. |
OAuthAppStatus | Especifica si la aplicación OAuth de SellingPartner especificada está en estado Borrador o Estado publicado. |
OAuthVerifier | El código verificador devuelto desde la URL de autorización de OAuth. |
OAuthRefreshToken | El token de actualización de OAuth para el token de acceso de OAuth correspondiente. |
OAuthExpiresIn | La vida útil en segundos del AccessToken de OAuth. |
OAuthTokenTimestamp | La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual. |
Propiedad | Descripción |
---|---|
SSLServerCert | El certificado que se aceptará del servidor al conectarse mediante TLS/SSL. |
Propiedad | Descripción |
---|---|
Location | Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados. |
BrowsableSchemas | Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC. |
Views | Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC. |
Propiedad | Descripción |
---|---|
IncludeReports | Establezca esta propiedad de conexión en true para exponer los informes ya creados como vistas. |
MaxRows | Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño. |
Other | Estas propiedades ocultas se usan solo en casos de uso específicos. |
ProcedurePooling | Si obtener o no resultados de feed después de la ejecución de un procedimiento almacenado. |
PseudoColumns | Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla. |
ReportTypes | Establezca esta propiedad de conexión en uno o más tipos de informes para filtrar informes. |
RowScanDepth | El número máximo de filas para escanear para buscar el tipo de datos de las columnas en un informe. |
Timeout | El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación. |
TypeDetectionScheme | Especifica cómo determinar los tipos de datos de las columnas al seleccionar en Informes. |
Autenticación¶
Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.
Propiedad | Descripción |
---|---|
Schema | El tipo de esquema a utilizar. |
AWSRegion | La región de alojamiento de sus Amazon Web Services. |
AWSAccessKeyId | El ID de AWS AccessKey que recibió cuando se registró en Amazon MWS. |
Marketplace | La región de Marketplace en la que está registrado para vender. |
MWSAuthToken | El token de autorización que recibió cuando se registró en Amazon MWS. |
SellerId | El ID de vendedor que recibió cuando se registró en Amazon MWS. |
AWSRoleARN | El nombre de recurso de Amazon del rol que se usará al autenticarse. |
AppId | ID de aplicación para la aplicación de socio de ventas que creó. |
AWSSessionToken | Token de sesión de AWS para la aplicación de socio vendedor que creó. |
AWSAccessKey | Su clave de acceso de AWS. |
AWSSecretKey | Su clave secreta de AWS. |
SellingPartner | Especifica el tipo de socio de ventas. |
IncludeRestrictedData | Determina si se deben usar tokens de datos restringidos (RDT) para recuperar información de identificación personal (PII). |
UseSandbox | Un valor booleano que determina si la conexión se debe realizar con la cuenta de sandbox del socio de ventas. |
Esquema¶
El tipo de esquema a utilizar.
Valores Posibles¶
Marketplace
, SellingPartner
Tipo de Datos¶
string
Valor por Defecto¶
"Marketplace"
Observaciones¶
Los esquemas disponibles son Marketplace y SellingPartner.
Región de AWS¶
La región de alojamiento de sus Amazon Web Services.
Valores Posibles¶
OHIO
, NORTHERNVIRGINIA
, NORTHERNCALIFORNIA
, OREGON
, CAPETOWN
, HONGKONG
, MUMBAI
, OSAKA
, SEOUL
, SINGAPORE
, SYDNEY
, TOKYO
, CENTRAL
, BEIJING
, NINGXIA
, FRANKFURT
, IRELAND
, LONDON
, MILAN
, PARIS
, STOCKHOLM
, BAHRAIN
, SAOPAULO
, GOVCLOUDEAST
, GOVCLOUDWEST
Tipo de Datos¶
string
Valor por Defecto¶
"NORTHERNVIRGINIA"
Observaciones¶
La región de alojamiento de sus Amazon Web Services. Los valores disponibles son OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEÚL, SINGAPUR, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRLANDA, LONDRES, MILÁN, PARÍS, ESTOCOLMO, BAHREIN, SAOPAULO, GOVCLOUDEAST y GOVCLOUDWEST.
ID de Clave de Acceso de AWS¶
El ID de AWS AccessKey que recibió cuando se registró en Amazon MWS.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Utilice esta propiedad de conexión para anular el AWSAccessKeyId incrustado.
Marketplace¶
La región de Marketplace en la que está registrado para vender.
Valores Posibles¶
United States
, Canada
, Mexico
, Spain
, United Kingdom
, France
, Germany
, Italy
, Brazil
, India
, China
, Japan
, Australia
, Netherlands
Tipo de Datos¶
string
Valor por Defecto¶
"United States"
Observaciones¶
Las regiones disponibles son Estados Unidos, Canadá, México, España, Reino Unido, Francia, Alemania, Italia, Brasil, India, China, Japón, Países Bajos y Australia.
MWSAutToken¶
El token de autorización que recibió cuando se registró en Amazon MWS.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
El token de autorización que recibió cuando se registró en Amazon MWS.
VendedorId¶
El ID de vendedor que recibió cuando se registró en Amazon MWS.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Si no se especifica el ID del vendedor, se requiere el identificador del comerciante para la autenticación.
AWSRoleARN¶
El nombre de recurso de Amazon del rol que se usará al autenticarse.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Cuando se autentica fuera de AWS, es común usar un rol para la autenticación en lugar de las credenciales de su cuenta de AWS directa. Entrando al AWSRoleARN
hará que Jitterbit Connector for Amazon Marketplace realice una autenticación basada en rol en lugar de utilizar AWSAccessKey y AWSSecretKey directamente. La AWSAccessKey y AWSSecretKey aún debe especificarse para realizar esta autenticación. No puede utilizar las credenciales de un usuario raíz de AWS al configurar RoleARN. La AWSAccessKey y AWSSecretKey deben ser los de un usuario de IAM.
ID de Aplicación¶
ID de aplicación para la aplicación de socio de ventas que creó.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
ID de aplicación para la aplicación de socio de ventas que creó.
Token de Sesión de AWS¶
Token de sesión de AWS para la aplicación de socio vendedor que creó.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
El token de sesión de AWS se puede obtener de la solicitud de AssumeRole a AWS. Id. de clave de acceso de AWS y AWSSecretKey también se debe proporcionar al configurar AWSSessionToken.
Clave de Acceso de AWS¶
Su clave de acceso de AWS.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Esta es la clave de acceso vinculada al usuario de AWS asociado con el OAuthClientId.
AWSSecretKey¶
Su clave secreta de AWS.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Esta es la clave secreta vinculada al usuario de AWS asociado con el OAuthClientId.
Socio Vendedor¶
Especifica el tipo de socio de ventas.
Valores Posibles¶
Seller
, Vendor
Tipo de Datos¶
string
Valor por Defecto¶
"Seller"
Observaciones¶
Especifica el tipo de socio vendedor, que puede ser vendedor o proveedor.
Incluir Datos Restringidos¶
Determina si se deben usar tokens de datos restringidos (RDT) para recuperar información de identificación personal (PII).
Tipo de Datos¶
bool
Valor por Defecto¶
false
Observaciones¶
Determina si se deben usar tokens de datos restringidos (RDT) para recuperar información de identificación personal (PII)
UsarSandbox¶
Un valor booleano que determina si la conexión se debe realizar con la cuenta de sandbox del socio de ventas.
Tipo de Datos¶
bool
Valor por Defecto¶
false
Observaciones¶
Un valor booleano que determina si la conexión se debe realizar con la cuenta de sandbox del socio de ventas.
Nota: Para usar la cuenta Sandbox, configure Esquema a 'Socio vendedor'.
OAuth¶
Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.
Propiedad | Descripción |
---|---|
InitiateOAuth | Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte. |
OAuthClientId | El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. |
OAuthClientSecret | El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. |
OAuthAccessToken | El token de acceso para conectarse mediante OAuth. |
CallbackURL | La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación. |
OAuthAppStatus | Especifica si la aplicación OAuth de SellingPartner especificada está en estado Borrador o Estado publicado. |
OAuthVerifier | El código verificador devuelto desde la URL de autorización de OAuth. |
OAuthRefreshToken | El token de actualización de OAuth para el token de acceso de OAuth correspondiente. |
OAuthExpiresIn | La vida útil en segundos del AccessToken de OAuth. |
OAuthTokenTimestamp | La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual. |
Iniciar OAuth¶
Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
Valores Posibles¶
OFF
, GETANDREFRESH
, REFRESH
Tipo de Datos¶
string
Valor por Defecto¶
"OFF"
Observaciones¶
Las siguientes opciones están disponibles:
OFF
: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.GETANDREFRESH
: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.REFRESH
: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.
OAuthClientId¶
El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId
valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.
OAuthClientSecretOAuthClientSecret¶
El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret
propiedad.
Token de Acceso de OAuth¶
El token de acceso para conectarse mediante OAuth.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
El OAuthAccessToken
la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken
se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.
El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.
URL de Devolución de Llamada¶
La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Durante el proceso de autenticación, el servidor de autorización de OAuth redirige al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.
OAuthAppStatus¶
Especifica si la aplicación OAuth de SellingPartner especificada está en estado Borrador o Estado publicado.
Valores Posibles¶
Published
, Draft
Tipo de Datos¶
string
Valor por Defecto¶
"Published"
Observaciones¶
Especifica si la aplicación OAuth de SellingPartner especificada está en estado Borrador o Estado publicado.
Si establece esta propiedad en 'Borrador', el parámetro version=beta se agrega al URI de autorización de OAuth y el flujo de trabajo autoriza una aplicación en estado Borrador. De lo contrario, el flujo de trabajo autoriza una aplicación publicada en Amazon Seller Central Partner Network.
OAuthVerifier¶
El código verificador devuelto desde la URL de autorización de OAuth.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.
Nota: Para el esquema de socio vendedor, el código verificador devuelto desde la URL de autorización de OAuth debe decodificarse en base64 antes de usarlo.
Autenticación en Máquinas Sin Cabeza¶
Ver para obtener el OAuthVerifier
valor.
Establezca OAuthSettingsLocation junto con OAuthVerifier
. Cuando se conecta, el conector intercambia el OAuthVerifier
para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth para GETANDREFRESH automatizar el intercambio.
Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier
desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.
Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.
OAuthRefreshToken¶
El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
El OAuthRefreshToken
la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.
OAuthExpiresIn¶
La vida útil en segundos del AccessToken de OAuth.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.
OAuthTokenTimestamp¶
La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.
SSL¶
Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.
Propiedad | Descripción |
---|---|
SSLServerCert | El certificado que se aceptará del servidor al conectarse mediante TLS/SSL. |
SSLServerCert¶
El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.
Esta propiedad puede tomar las siguientes formas:
Descripción | Ejemplo |
---|---|
Un certificado PEM completo (ejemplo abreviado por brevedad) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Una ruta a un archivo local que contiene el certificado | C:\cert.cer |
La clave pública (ejemplo abreviado por brevedad) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
La huella digital MD5 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) | ecadbdda5a1529c58a1e9e09828d70e4 |
La huella digital SHA1 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.
La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).
Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.
Esquema¶
Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.
Propiedad | Descripción |
---|---|
Location | Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados. |
BrowsableSchemas | Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC. |
Views | Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC. |
Ubicación¶
Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
Tipo de Datos¶
string
Valor por Defecto¶
"%APPDATA%\\\AmazonMarketplace Data Provider\\Schema"
Observaciones¶
La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location
La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.
Si no se especifica, la ubicación predeterminada es "%APPDATA%\\AmazonMarketplace Data Provider\Schema" con %APPDATA%
estando configurado en el directorio de configuración del usuario:
Plataforma | %APPDATA% |
---|---|
Windows | El valor de la variable de ambiente APPDATA |
Mac | ~/Biblioteca/Soporte de aplicaciones |
Linux | ~/.config |
Esquemas Navegables¶
Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.
Mesas¶
Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.
Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.
Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.
Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.
Puntos de Vista¶
Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.
Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.
Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.
Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.
Misceláneas¶
Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.
Propiedad | Descripción |
---|---|
IncludeReports | Establezca esta propiedad de conexión en true para exponer los informes ya creados como vistas. |
MaxRows | Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño. |
Other | Estas propiedades ocultas se usan solo en casos de uso específicos. |
ProcedurePooling | Si obtener o no resultados de feed después de la ejecución de un procedimiento almacenado. |
PseudoColumns | Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla. |
ReportTypes | Establezca esta propiedad de conexión en uno o más tipos de informes para filtrar informes. |
RowScanDepth | El número máximo de filas para escanear para buscar el tipo de datos de las columnas en un informe. |
Timeout | El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación. |
TypeDetectionScheme | Especifica cómo determinar los tipos de datos de las columnas al seleccionar en Informes. |
Incluir Informes¶
Establezca esta propiedad de conexión en true para exponer los informes ya creados como vistas.
Tipo de Datos¶
bool
Valor por Defecto¶
false
Observaciones¶
Establezca esta propiedad de conexión en true para exponer los informes ya creados como vistas. Al usar 'Socio de ventas' Esquema, se expondrá una vista para cada tipo de informe especificado en ReportTypes propiedad de conexión. Estas vistas se pueden consultar mediante los parámetros necesarios '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. 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
Filas Máximas¶
Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Tipo de Datos¶
int
Valor por Defecto¶
-1
Observaciones¶
Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Otro¶
Estas propiedades ocultas se usan solo en casos de uso específicos.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.
Especifique varias propiedades en una lista separada por punto y coma.
Integración y Formateo¶
Propiedad | Descripción |
---|---|
DefaultColumnSize | Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000. |
ConvertDateTimeToGMT | Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina. |
RecordToFile=filename | Registra la transferencia de datos del socket subyacente al archivo especificado. |
Procedimiento de Agrupación¶
Si obtener o no resultados de feed después de la ejecución de un procedimiento almacenado.
Tipo de Datos¶
bool
Valor por Defecto¶
true
Observaciones¶
Establézcalo en False si no desea esperar para obtener los resultados de un procedimiento almacenado.
Pseudocolumnas¶
Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".
Tipos de Informes¶
Establezca esta propiedad de conexión en uno o más tipos de informes para filtrar informes.
Tipo de Datos¶
string
Valor por Defecto¶
""
Observaciones¶
Establezca esta propiedad de conexión en uno o más tipos o categorías de informes separados por comas para filtrar informes. Esta propiedad decide qué tipos de informes exponer como vistas cuando IncludeReports = Verdadero y Esquema = Socio vendedor. Para incluir varios informes, también puede especificar una categoría de tipo de informe, que se puede recuperar desde la vista ReportTypes.
FilaExploraciónProfundidad¶
El número máximo de filas para escanear para buscar el tipo de datos de las columnas en un informe.
Tipo de Datos¶
int
Valor por Defecto¶
100
Observaciones¶
Las columnas de una tabla deben determinarse escaneando las filas de la tabla. Este valor determina el número máximo de filas que se escanearán.
Establecer un valor alto puede disminuir el rendimiento. Establecer un valor bajo puede evitar que el tipo de datos se determine correctamente, especialmente cuando hay datos nulos.
Se Acabó el Tiempo¶
El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.
Tipo de Datos¶
int
Valor por Defecto¶
60
Observaciones¶
Si Timeout
= 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.
Si Timeout
caduca y la operación aún no se ha completado, el conector genera una excepción.
TipoDetecciónEsquema¶
Especifica cómo determinar los tipos de datos de las columnas al seleccionar en Informes.
Valores Posibles¶
None
, RowScan
Tipo de Datos¶
string
Valor por Defecto¶
"RowScan"
Observaciones¶
Cuando IncludeReports se establece en True, esta propiedad especifica cómo determinar los tipos de datos.
Propiedad | Descripción |
---|---|
None | Configuración TypeDetectionScheme a Ninguno devolverá todas las columnas como el tipo de cadena. |
RowScan | Configuración TypeDetectionScheme to RowScan escaneará filas para determinar heurísticamente el tipo de datos. |