Saltar al contenido

Detalles de Conexión de Ebay

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 eBay

El conector permite una vista relacional de las entidades de las APIs de Trading, FileTransfer, BulkData, Feedback y Merchandising.

Establecer una Conexión

Conexión a las APIs de Ebay

De forma predeterminada, el conector se conecta a ambientes de producción. Colocar UseSandbox a true para usar una cuenta sandbox de eBay.

Autenticación en Ebay

eBay utiliza el estándar de autenticación OAuth 2.0 y Auth'n'Auth, la autenticación tradicional utilizada por las APIs de eBay. Para autenticarse usando OAuth o Auth'n'Auth, según cómo esté configurada su aplicación, deberá crear una aplicación para obtener el OAuthClientId, OAuthClientSecret, DevID, y CallbackURL propiedades de conexión. Consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con eBay usando el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Personalizadas

Deberá registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Creación de una Aplicación OAuth Personalizada

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

Credenciales Personalizadas

Autenticación de Escritorio con Su Aplicación OAuth

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 un Token de Acceso OAuth

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

  • 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.
  • CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
  • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..

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

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

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear fuentes de datos de eBay en servidores autónomos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

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

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

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

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 de la aplicación en la configuración de su aplicación.
  • OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.

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

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

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

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

Conectarse a datos

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 proveedor para habilitar la actualización automática del token de acceso.
  • InitiateOAuth: Establézcalo en ACTUALIZAR.

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: 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.
  • CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de 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.
  • 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.

Creación de una Aplicación OAuth Personalizada

Hay dos métodos de autenticación disponibles para conectarse a eBay: usar un token generado para acceder solo a datos personales o usar tokens que permitan a otros usuarios acceder a sus propios datos. Ambos métodos requieren que te unas al Programa de desarrolladores de eBay.

Regístrese y Obtenga Sus Claves

Después de unirse al Programa de desarrolladores de eBay, puede obtener los siguientes valores en la página Claves de la aplicación (Mi cuenta -> Claves de acceso a la aplicación).

  1. OAuthClientId (ID de la aplicación)
  2. DevID
  3. OAuthClientSecret (ID de certificado)
Uso de un Token Personal

Si está trabajando con su propia cuenta, siga los pasos a continuación para generar un token:

  1. Vaya a su panel de cuenta de desarrollador y abra la página Claves de aplicación.

  2. En la fila ID de aplicación (ID de cliente) para el conjunto de claves que desea usar, haga clic en Tokens de usuario.

    Use claves de producción si está buscando artículos reales o listando artículos reales en el sitio de eBay en vivo. Utilice las claves de la zona de pruebas si está creando listados de prueba en la zona de pruebas.

  3. Haga clic en Obtener un token de usuario aquí e inicie sesión con las credenciales para su sandbox o su cuenta de eBay de producción. Asegúrese de establecer también 'Su URL aceptada de autenticación' en su URL de devolución de llamada preferida. Dado que eBay requiere un URI de redireccionamiento seguro (https), para las aplicaciones de escritorio puede configurarlo en: https://localhost:33333 o para https://oauth.cdata.com/oauth/ para aplicaciones web.

Nota: Para habilitar la autenticación OAuth 2.0, debe marcar la casilla de verificación 'OAuth habilitado' en la pestaña abierta 'Su configuración de inicio de sesión de eBay '. Si no está habilitado, solo se admitirá el método de autenticación Auth'N'Auth.

A continuación, puede establecer las siguientes propiedades de conexión y conectarse:

  • DevID: Establézcalo en el ID de desarrollador de su conjunto de claves.
  • OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) de su conjunto de claves.
  • OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) de su conjunto de claves.
  • SiteID: Establézcalo en el ID del sitio de eBay. De forma predeterminada, es 0 (el sitio de EE. UU.).
  • OAuthAccessToken: establezca esto en el token personal que generó desde el panel de control de su cuenta de desarrollador.
  • UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
  • AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.
  • CallbackURL: Establézcalo en http://localhost:33333 u otro puerto de su elección. (Si no ha configurado el https://oauth.cdata.com/oauth/ URL de redirección, asegúrese de estar utilizando el mismo puerto que la URL de redirección configurada en su aplicación de eBay )
Obtención de Tokens para Aplicaciones con Múltiples Usuarios

eBay implementa el estándar de autenticación OAuth, que puedes usar para permitir que otros usuarios accedan a sus propios datos.

OAuth requiere que el usuario que se autentica interactúe con eBay usando el navegador. El conector facilita esto de varias maneras, como se describe en las siguientes secciones.

Configurar una Aplicación OAuth

Siga los pasos a continuación para configurar el flujo de consentimiento del usuario:

  1. Vaya a su panel de cuenta de desarrollador y abra la página Claves de aplicación.
  2. En la fila ID de aplicación (ID de cliente) de su aplicación, haga clic en Fichas de usuario.
  3. Haga clic en Obtener un token de usuario aquí e inicie sesión con las credenciales para su sandbox o su cuenta de eBay de producción. Asegúrese de establecer también 'Su URL aceptada de autenticación' en su URL de devolución de llamada preferida. Dado que eBay requiere un URI de redireccionamiento seguro (https), para las aplicaciones de escritorio puede configurarlo en: https://localhost:33333 o para https://oauth.cdata.com/oauth/ para aplicaciones web.

Nota: Para habilitar la autenticación OAuth 2.0, debe marcar la casilla de verificación 'OAuth habilitado' en la pestaña abierta 'Su configuración de inicio de sesión de eBay '. Si no está habilitado, solo se admitirá el método de autenticación Auth'N'Auth.

Autenticarse en Ebay Desde una Aplicación de Escritorio

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

  • DevID: Establézcalo en el ID de desarrollador de su conjunto de claves.
  • OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) de su conjunto de claves.
  • OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) de su conjunto de claves.
  • RuName: establezca esto en el nombre de URL de redireccionamiento en el token de eBay a través de su sección de aplicación de la página de tokens de usuario.
  • SiteID: Establézcalo en el ID del sitio de eBay. De forma predeterminada, es 0 (el sitio de EE. UU.).
  • CallbackURL: Establézcalo en http://localhost:33333 u otro puerto de su elección. (Si no ha configurado el https://oauth.cdata.com/oauth/ URL de redirección, asegúrese de estar utilizando el mismo puerto que la URL de redirección configurada en su aplicación de eBay )
  • InitiateOAuth: Establézcalo en GETANDREFRESH.
  • UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
  • AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.

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

  1. Extrae el token y autentica las solicitudes.
  2. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
Autenticarse en Ebay Desde una Aplicación Web

Para obtener el token de acceso, establezca las siguientes propiedades de conexión:

  • DevID: establezca esto en la ID del desarrollador en su conjunto de claves.
  • OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) en su conjunto de claves.
  • OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) en su conjunto de claves.
  • SiteID: Establézcalo en el ID del sitio de eBay. Por defecto es 0, (EE. UU.)
  • RuName: establezca esto en el nombre de URL de redireccionamiento en el token de eBay a través de su sección de aplicación de la página de tokens de usuario.
  • UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
  • AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.

Cuando se conecta a través de una aplicación web, o si el conector no está autorizado para abrir una ventana del navegador, debe intercambiar una ID de sesión (si está usando Auth y Auth como método de autenticación) o un código verificador (si está usando OAuth 2.0) para el OAuthAccessToken:

  1. Configure el UseSandbox propiedad de conexión a verdadero si está utilizando una cuenta de espacio aislado.
  2. Configure el AuthScheme propiedad de conexión a "OAuth" si desea usar la autenticación OAuth, o establecer en "AuthNAuth" para usar Auth'n'Auth para la autenticación.
  3. Llame a GetOAuthAuthorizationURL. El procedimiento almacenado* devuelve la URL al extremo de OAuth.
  4. Inicie sesión y autorice la aplicación. Se le redirigirá a la URL de devolución de llamada.
  5. Llame a GetOAuthAccessToken. Establezca el parámetro AuthMode en "WEB". Si usa OAuth para autenticarse, establezca el valor del Verificador en el valor del código devuelto en el paso anterior. De lo contrario, si usa Auth y Auth, establezca el parámetro SessionId en el parámetro SessionId devuelto en la cadena de consultar de la URL de devolución de llamada del paso anterior.

Para realizar solicitudes a eBay, establezca OAuthAccessToken devuelto además de las propiedades de conexión anteriores. Colocar InitiateOAuth a REFRESH para actualizar automáticamente el token de acceso cuando caduca.

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 funciones avanzadas del conector de eBay.

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 Jitterbit Connector para eBay te 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 Utilizando 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 ItemListing 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 eBay modela entidades en la API de eBay como tablas, vistas y procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

Jitterbit Connector para eBay modela listados de artículos en tablas para que puedan consultarse, actualizarse y eliminarse fácilmente. Puede enumerar artículos en su tienda eBay llamando al procedimiento almacenado AddItem.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura 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.

Mesas

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

Generalmente, consultar las tablas de eBay 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 Ebay

Nombre Descripción
ItemListing Actualice, elimine y consultar Listados de artículos para vendedores.
ItemVariations Las variaciones de artículos son varios artículos similares (pero no idénticos) en un solo listado de precio fijo. Por ejemplo, una lista de camisetas podría contener varios artículos de la misma marca que varían según el color y el tamaño; cada variación especificaría una combinación de uno de estos colores y tamaños. Cada variación puede tener una cantidad y precio diferente. Puede comprar varios artículos de una variación al mismo tiempo. (Es decir, un elemento de línea de pedido puede contener varios elementos de una sola variación).
Tasks Recupera todas las tareas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

ArtículoListado

Actualice, elimine y consultar Listados de artículos para vendedores.

Información Específica de la Tabla
Seleccionar

La siguiente consultar recupera artículos del vendedor. De forma predeterminada, esta consultar devuelve elementos que se agregaron en los últimos 100 días.

SELECT * FROM ItemListing

ItemListing es la única tabla que admite ORDER BY. Solo se pueden usar dos columnas para ordenar: StartTime y EndTime. La siguiente consultar recupera los elementos que finalizan entre el tiempo especificado, ordenados por el elemento que finaliza antes.

SELECT * FROM ItemListing WHERE EndTimeFrom='2016-01-25' AND EndTimeTo='2016-02-05' ORDER BY EndTime
Insertar

AddItem procedimiento almacenado* proporciona la funcionalidad para agregar un nuevo elemento.

Actualizar

Las entradas que se requieren para una actualización dependen del tipo de elemento y su categoría. Se debe proporcionar al menos el ItemId y una propiedad del elemento en una actualización.

UPDATE ItemListing SET Title='My Awesome Item' WHERE ItemId='123456789'

Después de que se haya vendido un artículo en un listado de cantidades múltiples, los vendedores no pueden cambiar los valores en los campos Título, Categoría principal, Categoría secundaria, Duración del listado y Tipo de listado. Sin embargo, todos los demás campos siguen siendo editables.

Borrar

Se deben especificar ItemId y EndingReason para eliminar un elemento.

DELETE FROM ItemListing WHERE ItemId='123456789' AND  EndingReason='LostOrBroken'
Columnas
Nombre Tipo Solo lectura Descripción
ItemId [KEY] String Falso El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
Title String Falso Nombre del artículo tal como aparece en el listado o en los resultados de búsqueda.
AutoPay Boolean Falso Si es verdadero, el vendedor solicita el pago inmediato del artículo.
BuyerProtection String Falso Marca para indicar la elegibilidad de un artículo para el programa de Protección del Comprador de PayPal.
BuyItNowPrice Decimal Falso Este campo solo se aplica a las listas de subastas. Al especificar un precio ¡Cómpralo ya!, el vendedor permite a los compradores potenciales la oportunidad de comprar el artículo en la subasta a este precio de inmediato.
ConditionDescription String Falso El vendedor utiliza este campo de cadena para describir con mayor claridad el estado de los artículos que no son nuevos.
Country String Falso Define el código de país ISO 3166 de 2 letras.
Currency String Falso Divisa asociada a la información de precio del artículo. Código de moneda ISO 4217 de 3 letras.
Description String Falso La descripción del artículo por parte del vendedor. En las solicitudes de listado, puede usar etiquetas CDATA para enviar su descripción si desea usar caracteres reservados HTML o XML en la descripción.
HideFromSearch Boolean Falso Si el anuncio está oculto a todas las búsquedas que se realizan en eBay.
HitCount Integer Falso El número de páginas vistas para el elemento.
Adult Boolean Falso Si es verdadero, el elemento aparece en una categoría para adultos.
BestOfferAutoAcceptPrice Decimal Falso El precio al que se aceptan automáticamente las mejores ofertas. De uso similar al Precio Mínimo de la Mejor Oferta.
CheckoutEnabled Boolean Falso Esta bandera indica si la preferencia de Checkout Enabled del vendedor está activada o no (a nivel de cuenta o a nivel de listado).
StartTime Datetime Falso La hora de inicio para cuando se enumeró el elemento.
EndTime Datetime Falso Marca de tiempo (en GMT) cuando el listado está programado para finalizar (calculado en función de los valores de StartTime y ListingDuration), o la hora de finalización real si el artículo ha finalizado.
MinimumBestOfferPrice Decimal Falso Especifica el precio de mejor oferta mínimo aceptable. Si un comprador presenta una Mejor oferta que está por debajo de este valor, el vendedor rechaza automáticamente la oferta.
ViewItemURL String Falso La URL de la página web donde un usuario puede ver el listado. En el sitio de EE. UU., esto se llama la página Ver elemento.
ViewItemURLForNaturalSearch String Falso Esta URL lo lleva a la misma página Ver elemento que ViewItemURL, pero esta URL está optimizada para admitir la búsqueda natural. Es decir, esta URL está diseñada para que los artículos en eBay sean más fáciles de encontrar a través de los motores de búsqueda de Internet más populares.
ListingDuration String Falso Describe la cantidad de días que el vendedor desea que el listado esté activo (disponible para ofertar/comprar).
ListingType String Falso El formato del listado que el vendedor quiere usar, como subasta china o precio fijo.
Location String Falso Indica la ubicación geográfica del elemento (junto con el País). Cuando revisa un listado, puede agregar o cambiar este valor solo si el listado no tiene ofertas (o no se han vendido artículos) y no finaliza dentro de las 12 horas.
CategoryId String Falso Id. de categoría para la primera (o única) categoría en la que aparece el artículo (o aparecerá, si el artículo es nuevo).
CategoryName String Falso Este valor de cadena es el nombre para mostrar de la categoría principal de eBay, tal como aparecería en el sitio web de eBay.
PrivateListing Boolean Falso Si es verdadero, designa la lista como privada.
Quantity Integer Falso El significado de este valor depende del contexto.
QuantityAvailableHint String Falso Indica el tipo de mensaje que se devolverá describiendo la cantidad disponible para el artículo.
QuantityThreshold Integer Falso El umbral de cantidad por encima del cual el vendedor prefiere no mostrar la cantidad real disponible.
ReservePrice Decimal Falso El precio más bajo al que el vendedor está dispuesto a vender el artículo.
Refund String Falso Cadena de visualización que las aplicaciones de los compradores pueden usar para presentar RefundOption en un formato más fácil de usar para los compradores.
RefundOption String Falso Indica cómo el vendedor compensará al comprador por un artículo devuelto.
ReturnsAccepted String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar ReturnsAcceptedOption en un formato más fácil de usar para los compradores.
ReturnsAcceptedOption String Falso Indica si el vendedor permite que el comprador devuelva el artículo. Uno de los siguientes valores: ReturnsAccepted o ReturnsNotAccepted. Si especifica ReturnsNotAccepted, la página Ver artículo indicará que no se aceptan devoluciones en su lugar.
ReturnsWithin String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar ReturnsWithinOption en un formato más fácil de usar para los compradores.
ReturnsWithinOption String Falso El comprador puede devolver el artículo dentro de este plazo de tiempo desde el día que recibe el artículo.
ShippingCostPaidBy String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar ShippingCostPaidByOption en un formato más fácil de usar para los compradores.
ShippingCostPaidByOption String Falso La parte que paga el costo de envío de un artículo devuelto.
WarrantyDuration String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar la opción de duración de la garantía en un formato más fácil de usar para los compradores.
WarrantyDurationOption String Falso El período de garantía.
WarrantyOffered String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar la opción de garantía ofrecida en un formato más fácil de usar para los compradores.
WarrantyOfferedOption String Falso Indica si se ofrece una garantía para el artículo.
WarrantyType String Falso Cadena de visualización que las aplicaciones del comprador pueden usar para presentar la opción de tipo de garantía en un formato más fácil de usar para los compradores.
WarrantyTypeOption String Falso Indica la fuente o tipo de garantía, si la hubiere.
ItemRevised Boolean Falso Este campo se devuelve como verdadero si se ha revisado el listado original.
SellerName String Falso El nombre del vendedor. Este campo se utiliza como parte de la dirección.
CurrentPrice Decimal Falso El precio actual del artículo en la divisa original del anuncio.
ListingStatus String Falso Especifica un estado de listado activo o finalizado en el flujo de trabajo de procesamiento.
PromotionalEndTime Datetime Falso Hora de finalización de un descuento para un artículo cuyo precio ha reducido un vendedor con la función Visualización de precios promocionales.
PromotionalOriginalPrice Decimal Falso Precio original de un artículo cuyo precio ha reducido un vendedor con la función Visualización de precios promocionales.
PromotionalStartTime Datetime Falso Hora de inicio de un descuento para un artículo cuyo precio ha reducido un vendedor con la función Visualización de precios promocionales.
QuantitySold Integer Falso El número total de artículos comprados hasta el momento durante la vida útil del anuncio. Reste esto de Cantidad para determinar la cantidad disponible.
ReserveMet Boolean Falso Indica si se ha alcanzado el precio de reserva para el listado. Devuelve verdadero si se alcanzó el precio de reserva o no se especificó ningún precio de reserva.
SecondChanceEligible Boolean Falso Parte de la función Oferta de segunda oportunidad, que indica si el vendedor puede extender una oferta de segunda oportunidad para el artículo.
Site String Falso El nombre del sitio en el que aparece el artículo.
SKU String Falso Un SKU (unidad de mantenimiento de existencias) es un identificador definido por un vendedor.
StartPrice Decimal Falso El precio original del artículo en el momento de cotización o reinscripción. Si este valor cambia cuando se revisa el artículo, el nuevo valor se convierte en el precio original.
TimeLeft String Falso Tiempo restante antes de que finalice el listado. La duración se representa en el formato de duración ISO 8601 (PnYnMnDTnHnMnS).
TotalQuestionCount Integer Falso El número de preguntas formuladas sobre este elemento. Se aplica únicamente a las aplicaciones de eBay Motors Pro.
WatchCount Integer Falso El número de relojes colocados en este artículo desde las cuentas de Mi eBay de los compradores.
StoreCategoryId Long Falso Identificador único de una categoría personalizada principal en la que incluir el artículo.
StoreCategoryId2 Long Falso Identificador único de la categoría personalizada secundaria en la que se incluye el artículo.
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
AdminEndedItemsOnly String Especifica si se devolverán solo los elementos que se finalizaron administrativamente en función de una infracción de política.
EndTimeFrom Datetime Especifica la fecha más temprana (la más antigua) para usar en un filtro de intervalo de fechas basado en la hora de finalización del elemento. Especifique un intervalo de tiempo de finalización o un filtro de intervalo de tiempo de inicio. Cada uno de los intervalos de tiempo debe ser un valor inferior a 120 días.
EndTimeTo Datetime Especifica la fecha más reciente (más reciente) para usar en un filtro de intervalo de fechas basado en la hora de finalización del elemento. Especifique un intervalo de tiempo de finalización o un filtro de intervalo de tiempo de inicio. Cada uno de los intervalos de tiempo debe ser un valor inferior a 120 días.
GranularityLevel String Especifica el subconjunto de elementos y campos de usuario para devolver.
StartTimeFrom Datetime Especifica la fecha más temprana (la más antigua) para usar en un filtro de intervalo de fechas basado en la hora de inicio del elemento.
StartTimeTo Datetime Especifica la fecha más reciente (más reciente) para usar en un filtro de rango de fechas basado en la hora de inicio del elemento. Debe especificarse si se especifica StartTimeFrom.
UserId String Especifica el vendedor cuyos artículos se devolverán. UserId es una entrada opcional. Si no se especifica, recupera listados para el usuario identificado por el token de autenticación pasado en la solicitud.
DetailLevel String Los niveles de detalle son instrucciones que definen subconjuntos estándar de datos para devolver para tablas particulares. Los valores permitidos son ReturnAll.
EndingReason String Indica el motivo por el que el vendedor finalizó el anuncio antes de tiempo.

Variaciones del Artículo

Las variaciones de artículos son varios artículos similares (pero no idénticos) en un solo listado de precio fijo. Por ejemplo, una lista de camisetas podría contener varios artículos de la misma marca que varían según el color y el tamaño; cada variación especificaría una combinación de uno de estos colores y tamaños. Cada variación puede tener una cantidad y precio diferente. Puede comprar varios artículos de una variación al mismo tiempo. (Es decir, una línea de pedido puede contener varios artículos de una sola variación).

Información Específica de la Tabla
Seleccionar

Se debe especificar un ID de artículo para obtener variaciones del artículo que representa este ID.

SELECT * FROM ItemVariations WHERE ItemId = '110187147205'
Insertar

Los campos que se requieren para la inserción son ItemId, VariationSpecificsAgregate, StartPrice y Cantidad. VariationSpecificsAggregate debe contener detalles de variación estructurados en formato XML. Por ejemplo, el siguiente VariationSpecificsAggregate agrega un elemento azul grande:

<NameValueList>
  <Name>Color</Name>
  <Value>Blue</Value>
</NameValueList>
<NameValueList>
  <Name>Size</Name>
  <Value>L</Value>
</NameValueList>

La siguiente consultar agrega una variación de un elemento azul grande con un precio inicial de 15 y una cantidad de 100.

INSERT INTO ItemVariations (ItemId,VariationSpecificsAggregate,Quantity,StartPrice) values ('110188946596','<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>','100','15')
Actualizar

ItemId y VariationSpecificsAgregate son necesarios para actualizar una variación. Opcionalmente, se pueden proporcionar otros detalles para las variaciones, como StartPrice y Cantidad. VariationSpecificsAgregate debe estar en formato XML y debe contener todos los detalles que identifican una variación.

UPDATE ItemVariations SET Quantity='5' WHERE ItemId='110188946596' AND VariationSpecificsAggregate='<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'
Borrar

ItemId y VariationSpecificsAgregate son necesarios para eliminar una variación.

DELETE FROM ItemVariations WHERE ItemId='110188946596' AND VariationSpecificsAggregate='<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'
Columnas
Nombre Tipo Solo lectura Descripción
ItemId [KEY] String Falso El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
VariationSpecificsAggregate [KEY] String Falso Una lista de pares de nombre/valor que identifican de forma única la variación dentro de la lista. Todas las variaciones deben especificar el mismo conjunto de nombres. Por ejemplo, si los artículos varían en color y tamaño, entonces cada variación debe especificar Color y Tamaño como nombres, y dos variaciones no pueden especificar la misma combinación de valores de color y tamaño.
StartPrice Decimal Falso El precio del artículo en el momento de cotizar o volver a cotizar. Si este valor cambia cuando se revisa el artículo, el nuevo valor se convierte en este precio.
Currency String Falso Divisa asociada a la información de precio del artículo. Código de moneda ISO 4217 de 3 letras.
Quantity Integer Falso Este valor indica la cantidad de artículos en la variación específica que están disponibles para la compra.
QuantitySold Integer Falso El número total de artículos comprados hasta ahora. Reste esto de Cantidad para determinar la cantidad disponible.
SKU String Falso Un SKU (unidad de mantenimiento de existencias) es un identificador definido por un vendedor. Solo está destinado para el uso del vendedor (no para los compradores).
EAN String Falso Este campo se usa si el vendedor desea identificar cada variación de producto dentro de una lista de múltiples variaciones por un valor EAN (Número de artículo europeo).
ISBN String Falso Este campo se usa si el vendedor desea identificar cada variación de producto dentro de una lista de variaciones múltiples por un valor ISBN (Número de libro estándar internacional).
UPC String Falso Este campo se usa si el vendedor desea identificar cada variación de producto dentro de una lista de variaciones múltiples por un valor UPC (Código de producto universal).
ListingStatus String Falso Especifica un anuncio con un estado activo o finalizado en el flujo de trabajo de procesamiento de eBay.

Tareas

Recupera todas las tareas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

FeedType es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM [Tareas] WHERE FeedType = 'LMS_ADD_ITEM'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Insertar

Se requieren FeedType, MarketplaceID y SchemaVersion en la consultar de inserción. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')
Columnas
Nombre Tipo Solo lectura Descripción
TaskId [KEY] String Verdadero El ID de la tarea que se envió en la solicitud.
Status String Verdadero El valor de enumeración que indica el estado de la tarea que se envió en la solicitud.
FeedType String Falso El tipo de fuente asociado con la tarea.
CreationDate Datetime Verdadero La fecha en que se creó la tarea.
UploadSummaryAggr String Verdadero Este contenedor proporciona información resumida sobre un feed de carga (no se aplica a los tipos de feed de descarga).
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
MarketplaceID String MarketplaceID de su cuenta de Ebay.
SchemaVersion String El número de versión del esquema asociado con la tarea.

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 Ebay

Nombre Descripción
Bidders Consulta a los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.
Categories Consulta las categorías de eBay.
CategoryFeatures Consulta la configuración admitida por las categorías de eBay.
CategorySpecifics Lista de compatibilidad de artículos de consulta para vendedores.
Countries Muestra el código de país y el nombre asociado de los países admitidos por el sistema de eBay, independientemente del sitio especificado en la solicitud.
Currencies Consulta las monedas admitidas en eBay.
DSRSummary Consulta la información de calificación de los informes resumidos de DSR.
FulfillmentPolicies Recupera todas las políticas de cumplimiento configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.
HighestBidder Consulta al mejor postor de los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.
ItemCompatibilityList Consulte las categorías de compatibilidad y los posibles valores de compatibilidad para un elemento específico.
ItemShipping Consulte los detalles pertinentes a uno o más artículos para los que el vendedor ha ofrecido el envío calculado, como la dimensión del paquete, el peso y los costos de embalaje/manejo.
ItemSpecifics Consulta los detalles del artículo para un artículo específico.
ItemTransactions Consulta la información de la línea de pedido (transacción) de un listado específico. Para las listas de subastas, las líneas de pedido no se crean hasta que la subasta finaliza con un postor ganador, o si la función ¡Cómpralo ya! está habilitada para la lista y el comprador la utiliza para comprar el artículo. Para los listados de precio fijo, las líneas de pedido se crean después de que un comprador se haya comprometido a comprar los artículos.
MostWatchedItems Consulte los elementos con el mayor número de visitas para todo el sitio o para una categoría específica. Los elementos principales están determinados por los totales de Watch Count del día anterior. La clasificación de los elementos más vistos se calcula con la última información de Watch Count.
OrderPayments Consulta todos los pagos de los pedidos, en los que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los datos de pago de los pedidos realizados en los últimos 90 días. Los detalles de pago de pedidos con más de 90 días se pueden recuperar especificando OrderId.
Orders Consulta todos los pedidos en los que el usuario autenticado sea el comprador o el vendedor. Por defecto, solo se devuelven los pedidos realizados en los últimos 90 días. Los pedidos de más de 90 días se pueden recuperar especificando OrderId.
OrderShipping Consultar detalles de envío de los pedidos en los que el usuario autenticado es comprador o vendedor. De forma predeterminada, solo se devuelven los detalles de envío de los pedidos realizados en los últimos 90 días. Los detalles de envío de pedidos con más de 90 días se pueden recuperar especificando OrderId.
PaymentPolicies Recupera todas las políticas de pago configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.
ReturnPolicies Recupera todas las políticas de devolución configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.
ShippingCarriers Consulta de transportistas compatibles con el sitio especificado.
ShippingCategories Una categoría de servicio de envío compatible con el sitio.
ShippingLocations Enumera las regiones y ubicaciones admitidas por los servicios de envío de eBay. Devuelve todas las ubicaciones de envío admitidas por eBay, independientemente del sitio especificado en la solicitud.
ShippingServices Consulte los servicios de envío admitidos por el sitio de eBay especificado.
Sites Enumera todos los sitios de eBay disponibles y sus números SiteID asociados.
TopSellingProducts Consulte sus productos más vendidos de eBay.
TransactionPayments Consulta todos los pagos de las transacciones en las que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los pagos de las transacciones realizadas en los últimos 90 días. Los pagos de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.
Transactions Consulta todas las transacciones en las que el usuario autenticado es el comprador o el vendedor. Por defecto, solo se devuelven las transacciones de los pedidos realizados en los últimos 90 días. Las transacciones de pedidos de más de 90 días se pueden recuperar especificando OrderId.
TransactionShipping Consulta los detalles de envío de las transacciones en las que el usuario autenticado es el comprador o el vendedor. De forma predeterminada, solo se devuelven los detalles de envío de la transacción realizada en los últimos 90 días. Los detalles de envío de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.

Postores

Consulta a los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.

Información Específica de la Tabla
Seleccionar

Las únicas columnas admitidas para el filtrado son ItemId y ListMode. Se debe especificar un ItemId para recuperar datos de esta vista.

Select * FROM Bidders WHERE ItemId = '1234567'
Select * FROM Bidders WHERE ItemId = '1234567' And ListMode = 'EndedListing'
Columnas
Nombre Tipo Descripción
Action String Indica el tipo de oferta que se realiza en el listado especificado.
MaxBid Decimal Importe de la oferta realizada. Para las listas de subastas, el monto ofertado por el artículo (sujeto a oferta superior por parte de otros compradores). Para listados de precio fijo, el precio de venta fijo al que se compra el artículo. Para listados de subastas con una opción ¡Cómpralo ya! activa, esta cantidad será el precio de compra ¡Cómpralo ahora! o la cantidad de una oferta, según el tipo de oferta.
Currency String El código de moneda de tres dígitos para la oferta máxima.
ConvertedPrice Decimal El precio en la moneda especificada.
ConvertedPriceCurrency String El ID de moneda de tres dígitos del precio convertido.
HighestBid Decimal Cantidad que el mejor postor ha ofertado por el artículo. Aplicable solo a los listados de subastas donde hay ofertas progresivas y los postores ganadores se determinan en función de la oferta más alta.
HighestBidCurrency String El código de moneda de tres dígitos para la oferta más alta.
Quantity Integer Especifica el número de artículos que el usuario que presenta la oferta tiene la intención de comprar, pujar o hacer una mejor oferta.
SecondChanceEnabled Boolean Indica si el usuario está dispuesto a recibir ofertas de segunda oportunidad.
SiteCurrency String ID único que identifica la moneda en la que se expresan los montos de la oferta localizada.
TimeBid Datetime Fecha y hora en que se realizó la oferta o puja.
UserId String ID de usuario único de eBay para el usuario.
UserCountry String El código de dos dígitos que representa el país del usuario.
UserFeedbackScore Integer La puntuación de comentarios agregada para un usuario. Un puntaje de retroalimentación para un usuario es la retroalimentación positiva neta menos la retroalimentación negativa neta que le queda al usuario.
ItemId String El ID del artículo. Se devuelven los postores que pujaron por este artículo.
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
ListMode String Especifica qué información del postor devolver. EndedListing devuelve todos los postores no ganadores solo para listados finalizados. Solo puede ser utilizado por un vendedor. SecondChanceEligibleEndedListing devuelve todos los postores no ganadores de una lista finalizada que aún no han recibido una Oferta de segunda oportunidad y notaron interés en recibir una Oferta de segunda oportunidad. Solo puede ser utilizado por un vendedor. ViewAll devuelve todos los postores de una lista finalizada o aún activa. Puede ser utilizado por cualquier usuario. Los valores permitidos son EndedListing, SecondChanceEligibleEndedListing, ViewAll.

Categorías

Consulta las categorías de eBay.

Información Específica de la Tabla
Seleccionar

Las únicas columnas admitidas para el filtrado son CategorySiteId, LevelLimit y CategoryParentId.

SELECT * FROM Categories.

Puede devolver más información sobre una categoría específica y sus subcategorías con la siguiente consultar:

SELECT * FROM Categories WHERE LevelLimit = '2' AND CategoryParent = '267'
Columnas
Nombre Tipo Descripción
CategoryId [KEY] String Este valor de cadena es el identificador único de una categoría de eBay.
AutoPayEnabled Boolean Especifica que la categoría correspondiente admite el pago inmediato de listados.
B2BVATEnabled Boolean Especifica que la categoría correspondiente admite listados de IVA de empresa a empresa (B2B). Esta función solo se aplica a los sitios de eBay Alemania (DE), Austria (AT) y Suiza (CH).
BestOfferEnabled Boolean Especifica que la categoría correspondiente admite Mejores ofertas.
CategoryLevel Integer Este valor entero indica el nivel en el que encaja la categoría en la jerarquía de categorías del sitio de eBay. Por ejemplo, si este campo tiene un valor de 2, entonces la categoría está dos niveles por debajo de la categoría raíz.
CategoryName String Este valor de cadena es el nombre para mostrar de la categoría principal de eBay, tal como aparecería en el sitio web de eBay.
CategoryParentId String Este valor de cadena es el Id. de categoría de la categoría principal de la categoría principal indicada en el campo Id. de categoría.
Expired Boolean Especifica que la categoría correspondiente ya no es una categoría de eBay válida en el sitio y es posible que los artículos no se incluyan en esta categoría.
LeafCategory Boolean Especifica que la categoría correspondiente es una categoría hoja de eBay, una categoría en la que se pueden enumerar artículos.
LSD Boolean Tamaño de lote deshabilitado. Especifica que la categoría correspondiente no admite listados de lotes. Una lista de lotes es una lista que presenta varios artículos relacionados que debe comprar un comprador en una transacción.
ORPA Boolean Anular precio de reserva permitido: especifica que la categoría correspondiente es una excepción a la política de precio de reserva estándar en las listas de subastas del sitio de eBay.
ORRA Boolean Anular la reducción de la reserva permitida: especifica que la categoría correspondiente es una excepción a la política estándar de reducción del precio de reserva (en la lista de subasta activa).
Virtual Boolean Especifica que la categoría correspondiente es una categoría virtual de eBay, una categoría en la que es posible que no se incluyan artículos.
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
CategorySiteId String El ID del sitio de eBay de EE. UU. para la categoría.
LevelLimit String Especifica la profundidad máxima de la jerarquía de categorías para recuperar, donde las categorías de nivel superior (metacategorías) están en el nivel 1. Si no se especifica, las categorías se recuperan en todos los niveles aplicables.
ViewAllNodes String Este valor controla si se devuelven todas las categorías de eBay o solo las categorías de hoja que satisfacen las restricciones de la cláusula WHERE. Solo puede enumerar elementos en categorías de hoja. El valor por defecto es verdadero.
DetailLevel String Los niveles de detalle son instrucciones que definen subconjuntos de datos para devolver para tablas particulares. Valores posibles: ItemReturnAttributes, ItemReturnCategories, ItemReturnDescription, ReturnAll, ReturnHeaders, ReturnMessages y ReturnSummary.

CategoríaCaracterísticas

Consulta la configuración admitida por las categorías de eBay.

Información Específica de la Tabla
Seleccionar

Las únicas columnas admitidas para el filtrado son CategoryId, LevelLimit, AllFeaturesForCategory y FeatureId. Si no se especifica CategoryId, se devolverán todas las características de las categorías de nivel superior.

SELECT * FROM CategoryFeatures                          
SELECT * FROM CategoryFeatures WHERE LevelLimit='2' And CategoryId='277'
Columnas
Nombre Tipo Descripción
CategoryId String El identificador único de la categoría a la que pertenece la configuración.
BestOfferAutoAcceptEnabled Boolean Indica si la categoría es compatible con la función de aceptación automática de mejor oferta para listados de precio fijo.
BestOfferAutoDeclineEnabled Boolean Indica si la categoría es compatible con la función Rechazo automático de la mejor oferta.
BestOfferCounterEnabled Boolean Indica si la categoría admite vendedores que ofrecen una contraoferta contra la Mejor Oferta de un comprador, o si un comprador ofrece una contraoferta contra la contraoferta del vendedor. Este campo solo se aplica a los anuncios de precio fijo.
BestOfferEnabled Boolean Indica si la categoría admite la función Mejor oferta para listados de precio fijo.
BrandMPNIdentifierEnabled Boolean Indica si la categoría admite la capacidad de identificar un producto mediante la combinación de marca/número de pieza del fabricante.
ConditionEnabled String Indica si la categoría admite (o requiere) que se especifiquen condiciones.
ConditionValuesAggregate String Los ID de condición válidos para esta categoría.
EANEnabled String Indica si se pueden usar o no números de artículo europeos (EAN) para ayudar a crear un listado.
FreeGalleryPlusEnabled Boolean Indica si la categoría admite actualizaciones automáticas y gratuitas para Gallery Plus, que mejora las imágenes en los resultados de búsqueda.
FreePicturePackEnabled Boolean Indica si la categoría admite actualizaciones automáticas gratuitas para Picture Pack, un paquete de descuento que incluye imágenes de gran tamaño.
GlobalShippingEnabled Boolean Especifica si la categoría correspondiente admite o no el Programa de envío global (GSP).
Group1MaxFlatShippingCost Double Devuelve el máximo aplicable. tope por costo de envío para el grupo de servicio de envío 1.
Group2MaxFlatShippingCost Double Devuelve el máximo aplicable. tope por costo de envío para el grupo de servicio de envío 2.
Group3MaxFlatShippingCost Double Devuelve el máximo aplicable. tope por costo de envío para el grupo de servicio de envío 3.
HandlingTimeEnabled Boolean Si es falso, los listados en esta categoría requieren un tiempo de manejo cuando se especifica el envío calculado o fijo. No se requiere un tiempo de manejo para la recolección local o para el envío de carga. consulte DispatchTimeMax en AddItem.
HomePageFeaturedEnabled Boolean Indica si es posible o no mejorar un listado colocándolo en rotación para mostrarlo en un área especial de la página de inicio de eBay. El soporte para esta función varía según el sitio. Se pueden aplicar restricciones de artículos o comentarios.
INEscrowWorkflowTimeline String Indica la versión del flujo de trabajo de custodia que se aplica a la categoría en el sitio de la India: Flujo de Trabajo predeterminado, Flujo de Trabajo A o Flujo de Trabajo B.
ISBNEnabled String Indica si se pueden usar o no los números estándar internacionales de libros (ISBN) para ayudar a crear una lista.
ItemCompatibilityEnabled String Indica si la categoría admite la compatibilidad de piezas por aplicación (ByApplication), por especificación (BySpecification) o no (Disabled).
ItemSpecificsEnabled String Indica si la categoría admite especificaciones de artículo personalizadas.
ListingDurations String Los tipos de listas y las duraciones de las listas en días que se admiten para la categoría.
MaxFlatShippingCost Double El costo máximo que el vendedor puede cobrar por el primer servicio de envío de tarifa plana nacional. El costo total de envío es el costo de envío de tarifa plana base más el costo del seguro, si se requiere seguro. Mutuamente excluyente con GroupNMaxFlatShippingCost.
MaxGranularFitmentCount Integer Indica el número máximo de accesorios.
MaxItemCompatibility Integer Especifica el número máximo de compatibilidades de piezas.
MinimumReservePrice Double Indica si está habilitado un Precio Mínimo de Reserva para esta categoría. En los sitios de Alemania, Austria, Bélgica, Francia y Bélgica, Holanda, se admite el precio de reserva mínimo para las categorías de arte y antigüedades, relojes y joyas y motocicletas.
MinItemCompatibility Integer Este campo especifica el número mínimo de compatibilidades de piezas para enumerar artículos.
NonSubscription String El valor de este campo indica si la categoría es compatible con las listas de Motors Local Market si el vendedor no tiene una suscripción de vehículos.
PaisaPayFullEscrowEnabled Boolean Indica si la categoría admite el método de pago PaisaPayEscrow. Esta función solo se aplica al sitio de la India.
PaymentMethods String Indica los métodos de pago aceptables que se pueden usar al agregar, revisar o volver a poner en venta un artículo en la categoría correspondiente.
PaymentProfileCategoryGroup String Indica el grupo de categorías de políticas comerciales que se puede usar para los perfiles de pago. Solo se devuelve cuando este valor (o la configuración de esta categoría) anula el valor heredado de la categoría principal.
PayPalBuyerProtectionEnabled Boolean Si entonces se permite la protección del comprador para esta categoría.
PayPalRequired Boolean Indica si la categoría requiere PayPal como método de pago.
PickupDropOffEnabled Boolean Un valor verdadero en este campo indica que los elementos enumerados en la categoría se pueden habilitar con la función Hacer clic y recopilar. Con la función Click and Collect, un comprador puede comprar ciertos artículos en eBay y recogerlos en una tienda local. eBay notifica a los compradores una vez que sus artículos están disponibles.
PremiumSubscription String El valor de este campo indica si la categoría es compatible con las listas de Motors Local Market si el vendedor tiene una suscripción de vehículos Premium.
ProductCreationEnabled String Indica si una categoría admite (o requiere) la creación de productos en listados. Use esto para determinar si es obligatorio especificar el ID del producto al agregar, revisar o volver a incluir en la lista.
ProPackEnabled Boolean Indica si la categoría es compatible con la actualización de la lista Pro Pack Bundle.
ReturnPolicyEnabled Boolean Solo se devuelve cuando este valor (o la configuración de esta categoría) anula el valor heredado del padre de la categoría.
ReturnPolicyProfileCategoryGroup String Indica el grupo de categorías de políticas comerciales que se puede usar para los perfiles de política de devolución. Solo se devuelve cuando este valor (o la configuración de esta categoría) anula el valor heredado del padre de la categoría.
RevisePriceAllowed Boolean Indica si la categoría permite al vendedor revisar el precio de un listado de precio fijo.
ReviseQuantityAllowed Boolean Indica si la categoría permite al vendedor revisar la cantidad de un listado activo de varias cantidades.
SafePaymentRequired Boolean Indica si los anuncios de esta categoría deben tener un método de pago seguro.
SellerContactDetailsEnabled Boolean Indica si esta categoría admite información de contacto a nivel de vendedor para listados de anuncios clasificados.
SellerProvidedTitleSupported Boolean Este campo booleano indica si una categoría admite Títulos proporcionados por el vendedor en los listados.
ShippingProfileCategoryGroup String Indica el grupo de categorías de políticas comerciales que se puede usar para los perfiles de envío. Solo se devuelve cuando este valor (o la configuración de esta categoría) anula el valor heredado del padre de la categoría.
ShippingTermsRequired Boolean Indica si la categoría requiere que los vendedores especifiquen los detalles de envío en el momento del listado.
SpecialitySubscription String El valor de este campo indica si la categoría es compatible con las listas de Motors Local Market si el vendedor tiene una suscripción de vehículos especiales.
ListingDurationsAggregate String Proporciona duraciones de listados adicionales que están disponibles para los propietarios de tiendas eBay. Las duraciones de cotización ampliadas proporcionadas aquí en este elemento deben fusionarse con las duraciones de cotización de referencia proporcionadas en la columna ListingDurations. Se aplica a Listados de precio fijo.
TransactionConfirmationRequestEnabled Boolean Define si las solicitudes de confirmación de transacciones están habilitadas en una categoría determinada.
UPCEnabled String Indica si se pueden usar o no los códigos universales de productos (UPC) para ayudar a crear una lista.
UserConsentRequired Boolean Indica si un postor debe aceptar la oferta confirmando que leyó y acepta los términos de la política de privacidad de eBay.
ValueCategory Boolean Algunos sitios de eBay pueden seleccionar algunas categorías y designarlas como categorías de valor. Por lo general, se seleccionan de categorías en las que los compradores pueden encontrar grandes ofertas. Esta designación puede cambiar con el tiempo.
ValuePackEnabled Boolean Indica si la categoría es compatible con la actualización de la lista de paquetes de Value Pack.
VariationsEnabled Boolean Si es verdadero, puede crear listados de variaciones múltiples cuando lista un artículo de precio fijo en esta categoría.
VINSupported Boolean Indica si la categoría admite el uso del campo VIN (Número de identificación del vehículo) para identificar un vehículo de motor y crear una lista. Los VIN son compatibles con los sitios de EE. UU., Canadá, Canadá-francés y Australia.
VRMSupported Boolean Indica si la categoría admite el uso del campo VRM (Marca de registro del vehículo) para identificar un vehículo de motor y crear una lista. Los VRM solo se admiten en el sitio del Reino Unido.
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
AllFeaturesForCategory String Use este interruptor para ver todas las configuraciones de funciones para una categoría específica. Se devuelven todas las configuraciones de funciones, independientemente de la configuración predeterminada del sitio. Este elemento funciona junto con CategoryId; consulte las notas de ese elemento para obtener más detalles. Si también establece FeatureId, eBay devuelve el estado de las funciones especificadas solo para la categoría especificada. Valor predeterminado: falso.
FeatureId String Utilice este campo si desea saber si las características específicas están habilitadas en el sitio o en el nivel de categoría raíz. Se pueden usar varios elementos FeatureId en la solicitud.
LevelLimit String Un nivel de profundidad en la jerarquía de categorías. Recupera todos los nodos de categoría con un CategoryLevel menor o igual que el valor de LevelLimit. La categoría raíz es 0. Los valores permitidos son 1.
ViewAllNodes String Si se establece, eBay devuelve los valores predeterminados del sitio junto con todas las categorías que anulan la configuración de funciones que heredan. Es decir, esta columna contiene solo las características que la categoría anuló de su categoría principal.
DetailLevel String Los niveles de detalle son instrucciones que definen subconjuntos de datos para devolver para tablas particulares. Valores posibles: ItemReturnAttributes, ItemReturnCategories, ItemReturnDescription, ReturnAll, ReturnHeaders, ReturnMessages y ReturnSummary.

CategoríaEspecificaciones

Lista de compatibilidad de artículos de consulta para vendedores.

Columnas
Nombre Tipo Descripción
CategoryId [KEY] String El ID que identifica de forma única la categoría. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
Name String Nombre del artículo tal como aparece en el listado o en los resultados de búsqueda.
PotentialValues String Valores potenciales de la categoría específica.
ValueType String El tipo de los valores.
MaxValues String Valores máximos que se pueden especificar para la categoría específica.
SelectionMode String Modo de selección.
AspectUsage String Uso de aspectos.
UsageConstraint String Restricciones de la categoría específica.
VariationSpecifics String Detalles de la variación.

Países

Muestra el código de país y el nombre asociado de los países admitidos por el sistema de eBay, independientemente del sitio especificado en la solicitud.

Columnas
Nombre Tipo Descripción
Country String Código de dos letras que representa un país. Estos códigos de dos letras generalmente se usan en llamadas Agregar/Revisar/Volver a listar cuando se hace referencia a un país.
Description String Nombre completo del país para fines de visualización. Puede ser similar (pero no necesariamente idéntico) a CountryName en las direcciones (por ejemplo, User.RegistrationAddress.CountryName en GetUser).
DetailVersion String Devuelve el número de versión más reciente para este campo. La versión se puede utilizar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles. Esta marca de tiempo se puede usar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son CountryDetails.

Monedas

Consulta las monedas admitidas en eBay.

Información Específica de la Tabla
Seleccionar

Devuelve todas las monedas admitidas. No se admiten columnas para el filtrado.

SELECT * FROM Currencies 
Columnas
Nombre Tipo Descripción
Currency String El código de moneda de tres dígitos como se define en ISO 4217.
Description String Nombre completo de la moneda para fines de visualización.
DetailVersion String Devuelve el número de versión más reciente para este campo.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los campos de características para los detalles.
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
DetailName String Si se establece en un valor de CurrencyDetails, se devuelven detalles de moneda adicionales. Los valores permitidos son CurrencyDetails.

Resumen de DSRS

Consulta la información de calificación de los informes resumidos de DSR.

Información Específica de la Tabla
Seleccionar

La columna JobId debe especificarse para recuperar datos de esta vista.

SELECT * FROM DSRSummary WHERE JobId = '123456' 
Columnas
Nombre Tipo Descripción
JobId String JobId que puede usar para descargar el informe.
1StarRatings Integer El número total de calificaciones de 1 estrella recibidas por un vendedor para un área de DSR en particular.
2StarsRatings Integer El número total de calificaciones de 2 estrellas recibidas por un vendedor para un área de DSR en particular.
3StarsRatings Integer El número total de calificaciones de 3 estrellas recibidas por un vendedor para un área de DSR en particular.
4StarsRatings Integer El número total de calificaciones de 4 estrellas recibidas por un vendedor para un área de DSR en particular.
5StarsRatings Integer El número total de calificaciones de 5 estrellas recibidas por un vendedor para un área de DSR en particular.

Políticas de Cumplimiento

Recupera todas las políticas de cumplimiento configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM FulfillmentPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas
Nombre Tipo Descripción
FulfillmentPolicyId [KEY] String Una identificación única asignada por eBay para la política de cumplimiento. Este ID se genera cuando se crea la política.
Name String Un nombre definido por el usuario para esta política de cumplimiento. Los nombres deben ser únicos para las pólizas asignadas al mismo mercado.
Description String Una descripción opcional definida por el vendedor de la política de cumplimiento para uso interno (este valor no se muestra a los usuarios finales).
CategoryTypesAggr String El valor de CategoryTypeEnum al que se aplica esta política. Se utiliza para distinguir las cuentas que venden vehículos de motor de las que no. (Actualmente, cada directiva se puede establecer en un solo valor de tipocategoría a la vez).
MarketplaceId String El ID del mercado de eBay al que se aplica esta política de cumplimiento.
FreightShipping Boolean Si se establece en verdadero, el vendedor ofrece envío de carga. El envío de carga se puede utilizar para artículos grandes de más de 150 libras.
GlobalShipping Boolean Indica si el vendedor se suscribió al Programa de envío global de eBay y si utiliza ese servicio para sus envíos internacionales.
HandlingTimeValue Integer El número máximo de días hábiles a los que se compromete el vendedor para preparar y enviar un pedido después de recibir un pago compensado por el pedido.
HandlingTimeUnit String Una unidad de medida de tiempo que especifica un período singular de tiempo utilizado para HandlingTimeValue.
LocalPickup Boolean Identifica si esta política ofrece el envío y el vendedor ofrece solo la recolección local del artículo (normalmente desde una ubicación no comercial).
PickupDropOff Boolean Si se establece en verdadero, el vendedor ofrece el
ShipToLocationsAggr String Este objeto contiene los campos regionIncluded y regionExcluded, que definen las regiones geográficas que un vendedor cubre y no cubre la política de envío asociada.
ShippingOptionsAggr String Una lista que define las configuraciones de envío del vendedor para envíos de pedidos DOMÉSTICOS e INTERNACIONALES.

Mejor Postor

Consulta al mejor postor de los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.

Información Específica de la Tabla
Seleccionar

Las únicas columnas admitidas para el filtrado son ItemId y ListMode. Se debe especificar un ItemId para recuperar datos de esta vista.

Select * FROM HighestBidder WHERE ItemId = '1234567'
Select * FROM HighestBidder WHERE ItemId = '1234567' And ListMode = 'EndedListing'
Columnas
Nombre Tipo Descripción
ItemId String El ID del artículo. Se devuelven los postores que pujaron por este artículo.
HighBidder String ID de usuario de eBay para el usuario con la oferta más alta (o la marca de tiempo más antigua, en caso de empate); un candidato de oferta de segunda oportunidad.
HighestBid Decimal Monto de la oferta ofrecida por el mejor postor.
Currency String Código de moneda de la oferta.
ListingStatus String Especifica el estado de un anuncio activo o finalizado en el flujo de trabajo de procesamiento del sistema de eBay. Si un anuncio finaliza con una venta (o ventas), eBay debe actualizar los detalles de la venta (p. ej., el precio total y el comprador/mejor postor) y la tarifa de valor final. Este procesamiento puede tardar varios minutos. Si recupera un artículo vendido y no se devuelven detalles sobre el comprador o el mejor postor o no hay una tarifa de valor final disponible, use esta información de estado del anuncio para determinar si eBay ha terminado de procesar el anuncio.
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
ListMode String Especifica qué información del postor devolver. EndedListing devuelve todos los postores no ganadores solo para listados finalizados. Solo puede ser utilizado por un vendedor. SecondChanceEligibleEndedListing devuelve todos los postores no ganadores de una lista finalizada que aún no han recibido una Oferta de segunda oportunidad y notaron interés en recibir una Oferta de segunda oportunidad. Solo puede ser utilizado por un vendedor. ViewAll devuelve todos los postores de una lista finalizada o aún activa. Puede ser utilizado por cualquier usuario. Los valores permitidos son EndedListing, SecondChanceEligibleEndedListing, ViewAll.

Lista de Compatibilidad de Elementos

Consulte las categorías de compatibilidad y los posibles valores de compatibilidad para un elemento específico.

Columnas
Nombre Tipo Descripción
ItemId [KEY] String El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
CompatibilityAttributes String Una lista de todas las posibles categorías de compatibilidad para el artículo especificado.
PossibleCompatibilites String Una lista de todos los valores de compatibilidad posibles para el elemento especificado.
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
IncludeItemCompatibilityList String Esto se usa para incluir elementos de ItemCompatibilityList y no debe configurarse manualmente.

ArtículoEnvío

Consulte los detalles pertinentes a uno o más artículos para los que el vendedor ha ofrecido el envío calculado, como la dimensión del paquete, el peso y los costos de embalaje/manejo.

Información Específica de la Tabla
Seleccionar

Los filtros DestinationCountryCode y ItemId deben especificarse para recuperar datos de esta vista. Además, se puede usar el filtro Cantidad vendida, pero es opcional.

SELECT * FROM ItemShipping WHERE ItemId='110177686055' AND DestinationCountryCode='US'
Columnas
Nombre Tipo Descripción
ItemId String El Id. de artículo que identifica de forma exclusiva la lista de artículos para la que se recuperarán los datos. Entrada requerida.
DestinationCountryCode String Código del país de destino. Si DestinationCountryCode es EE. UU., se requiere un código postal y representa el código postal de EE. UU. Predeterminado: EE. UU.
ExpeditedService Boolean Indica si el servicio es un servicio de envío acelerado.
FreeShipping Boolean Especifica que el vendedor quiere ofrecer envío gratuito. Esto se aplica solo al primer servicio de envío nacional especificado y se ignora si se establece para cualquier otro servicio de envío.
ImportCharge Decimal El costo total de aduanas e impuestos para el tramo internacional de un pedido enviado mediante el Programa de envío global. El proveedor de envío internacional calcula y proporciona esta cantidad para cada artículo cuando un comprador ve las propiedades del artículo.
Currency String Identificación de moneda
ShippingService String Una opción de servicio de envío que ofrece el vendedor para enviar un artículo a un comprador. Para obtener una lista de valores de ShippingService válidos, llame a GeteBayDetails con DetailName establecido en ShippingServiceDetails. El indicador ShippingServiceDetails.ValidForSellingFlow también debe estar presente. De lo contrario, esa opción de servicio de envío en particular ya no es válida y no se puede ofrecer a los compradores a través de un listado.
ShippingInsuranceCost Decimal El costo del seguro asociado con el envío de un solo artículo con este servicio de envío.
ShippingServiceAdditionalCost Decimal Una opción de servicio de envío que ofrece el vendedor para enviar un artículo a un comprador. Para obtener una lista de valores de ShippingService válidos, llame a GeteBayDetails con DetailName establecido en ShippingServiceDetails. El indicador ShippingServiceDetails.ValidForSellingFlow también debe estar presente. De lo contrario, esa opción de servicio de envío en particular ya no es válida y no se puede ofrecer a los compradores a través de un listado.
ShippingServiceCost Decimal El costo base de enviar el artículo utilizando el servicio de envío especificado en el campo ShippingService. En el caso de un listado de precio fijo de cantidad múltiple, el campo Costo adicional del servicio de envío muestra el costo de envío de cada artículo adicional si el comprador compra varias cantidades del mismo artículo de línea.
ShippingServicePriority Integer Controla el pedido (en relación con otros servicios de envío) en el que aparecerá el Servicio de envío correspondiente en la página Ver artículo y Pagar.
ShippingTimeMax Integer El número máximo garantizado de días que el transportista tardará en enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista).
ShippingTimeMin Integer El número mínimo garantizado de días en los que el transportista puede enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista).
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
QuantitySold String Número de artículos vendidos a un solo comprador y que se enviarán juntos.
DestinationPostalCode String Código postal del país de destino (o código postal para EE. UU.). Se ignora si no se proporciona un código de país. Etiqueta opcional para algunos países. Es más probable que se requiera para países grandes.

Características del Artículo

Consulta los detalles del artículo para un artículo específico.

Columnas
Nombre Tipo Descripción
ItemId [KEY] String El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
Attribute String Una lista de todos los atributos del elemento especificado.
Specifics String Una lista de todos los atributos específicos para el elemento especificado.
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
IncludeItemSpecifics String Esto se usa para incluir elementos ItemSpecifics y no debe configurarse manualmente.

Transacciones de Artículos

Consulta la información de la línea de pedido (transacción) de un listado específico. Para las listas de subastas, las líneas de pedido no se crean hasta que la subasta finaliza con un postor ganador, o si la función ¡Cómpralo ya! está habilitada para la lista y el comprador la utiliza para comprar el artículo. Para los listados de precio fijo, las líneas de pedido se crean después de que un comprador se haya comprometido a comprar los artículos.

Información Específica de la Tabla
Seleccionar

La columna ItemId debe especificarse para recuperar la información de la transacción.

Obtenga todas las transacciones relacionadas con un artículo específico:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901'

Filtre el número de transacciones devueltas especificando el número de días en el pasado:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901' AND NumberOfDays='25'

Obtenga información para una transacción específica que se realizó para un artículo específico:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901' AND TransactionId='0'
Columnas
Nombre Tipo Descripción
OrderLineItemId [KEY] String Un identificador único para una línea de pedido de eBay. Este campo se crea tan pronto como existe un compromiso de compra del vendedor, y su valor se basa en la concatenación de ItemId y TransactionId con un guión entre estos dos Id.
TransactionId String El identificador único de una transacción que se realizó para un artículo específico. Si se proporciona un TransactionId, se ignora cualquier filtro de tiempo especificado.
ItemId String Identificador único para una lista de artículos de eBay.
HandlingCost Decimal El costo de manejo que el vendedor ha cobrado por el artículo de línea de pedido. Este campo solo se devuelve después de completar el pago. El valor de este campo se devuelve como cero dólares (0,0) si el vendedor no especificó un costo de manejo para el listado.
ShippingCost Decimal El costo de envío pagado por el comprador por la línea de pedido. Este campo solo se devuelve después de completar el pago.
AdjustmentAmount Decimal Importe de ajuste introducido por el comprador. Una cantidad positiva indica que la cantidad es un cargo adicional que el comprador paga al vendedor. Un valor negativo indica que esta cantidad es un crédito otorgado al comprador por el vendedor.
AmountPaid Decimal El importe total que el comprador pagó por la línea de pedido.
Currency String Un código de moneda estándar ISO 4217 de 3 dígitos para la moneda utilizada en países de todo el mundo.
BestOfferSale Boolean Indica si la partida de pedido se creó o no como resultado de que el vendedor aceptara una mejor oferta de un comprador.
BuyerId String ID de usuario único de eBay para el usuario.
BuyerCheckoutMessage String Este campo se devuelve si un comprador dejó un comentario para el vendedor durante el flujo de pago.
CreatedDate Datetime Indica la hora de creación de la línea de pedido.
DepositType String Este valor indica si el vendedor requiere o no un depósito por el vehículo. Este campo solo se aplica a los listados de eBay Motors de EE. UU. De lo contrario, este campo se devuelve como un valor vacío.
EBayPlusTransaction Boolean Si es verdadero, esta transacción es para un artículo que se compró bajo el programa eBay Plus.
ExtendedOrderId String Un identificador único para un pedido de eBay.
FinalValueFee Decimal Una tarifa de valor final se calcula y carga a la cuenta de un vendedor inmediatamente después de la creación de una línea de pedido.
Gift Boolean Este campo booleano se devuelve como verdadero si el vendedor le da una tarjeta de regalo digital a otra persona como regalo. Este campo solo se aplica a las líneas de pedido de tarjetas de regalo digitales.
GiftSummaryMessage String Este texto de forma libre contiene el mensaje que el comprador de la tarjeta de regalo digital dejó para el destinatario de la tarjeta de regalo.
IntangibleItem Boolean Esta bandera indica si la línea de pedido es o no un bien intangible, como una pista de MP3 o un tono de llamada de un teléfono móvil. Los artículos intangibles no son elegibles para el programa de Protección al vendedor de PayPal, por lo que el vendedor no podrá abrir un caso de artículo no pagado contra el comprador.
InvoiceSentTime Datetime Este campo indica la fecha y la hora en que se envió una factura de pedido del vendedor al comprador. Este campo solo se devuelve si se envió una factura (que contiene el artículo de línea del pedido) al comprador.
IsMultiLegShipping Boolean Si IsMultilegShipping es verdadero, se utilizará el Programa de envío global (GSP) para enviar el artículo de línea del pedido a un comprador internacional.
LogisticsPlanType String Este campo se devolverá solo si el comprador compró una tarjeta de regalo digital, que se entrega por correo, o si el comprador compró un artículo habilitado con la función Hacer clic y recoger.
PaidTime Datetime Indica el momento en que el pedido se marcó como pagado. Este campo no se devuelve hasta que el comprador haya realizado el pago. Este campo no se devolverá para pedidos en los que el comprador haya recibido reembolsos parciales o totales.
PayPalEmailAddress String La dirección de correo de PayPal del vendedor. Este campo solo se devuelve si el vendedor es el usuario autenticado.
QuantityPurchased Integer Este valor indica la cantidad de artículos idénticos comprados al mismo tiempo por el mismo comprador de una lista.
ProductName String El nombre de un producto del Gestor de ventas.
ShippedTime Datetime Indica la hora en que los artículos asociados con el pedido se marcaron como enviados. Este valor solo será visible para el usuario a ambos lados del pedido. Un pedido puede marcarse como enviado en Mi eBay, Selling Manager Pro o mediante programación por parte del vendedor a través del procedimiento almacenado CompleteSale.
ShippingConvenienceCharge Decimal La cantidad que se le cobra al vendedor por la comodidad de una entrega de eBay Now.
ExpeditedService Boolean Indica si el servicio es un servicio de envío acelerado.
ShippingServiceImportCharge Decimal El costo total de aduanas e impuestos para el tramo internacional de un pedido enviado mediante el Programa de envío global. El proveedor de envío internacional calcula y proporciona esta cantidad para cada artículo cuando un comprador ve las propiedades del artículo.
ShippingInsuranceCost Decimal El costo del seguro asociado con el envío de un solo artículo con este servicio de envío.
ShippingPackageInfo String Si el pedido se entrega a través de eBay Now, contiene información sobre el estado del pedido, el identificador único de la tienda desde donde se origina el pedido y los tiempos de entrega esperados y reales.
ShippingService String Una opción de servicio de envío que ofrece el vendedor para enviar un artículo a un comprador.
ShippingServiceAdditionalCost Decimal El costo de envío de cada artículo adicional si el mismo comprador compra uno o más artículos de la misma línea.
ShippingServiceCost Decimal El costo base utilizando el servicio de envío especificado en el campo ShippingService para enviar el artículo. En el caso de una publicación de cantidad múltiple y precio fijo, el campo Costo adicional del servicio de envío muestra el costo de envío de cada artículo adicional si el comprador compra uno o más artículos de la misma línea.
ShippingServicePriority Integer Este valor entero controla el pedido (en relación con otros servicios de envío) en el que aparecerá el Servicio de envío correspondiente en la página Ver artículo y Pagar.
ShippingTimeMax Integer El número máximo garantizado de días que el transportista tardará en enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista).
ShippingTimeMin Integer El número mínimo garantizado de días en los que el transportista puede enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista).
BuyerSelectedShipping Boolean Indica si el comprador ha seleccionado los detalles de envío durante el pago.
CheckoutStatus String Indica el estado actual del flujo de pago del pedido.
CompleteStatus String Indica si el pago está completo, incompleto o pendiente para un pedido.
DigitalStatus String El estado actual de una tarjeta de regalo digital comprada.
EBayPaymentStatus String Indica el éxito o fracaso del pago en línea de un pedido por parte del comprador.
InquiryStatus String Este campo proporciona el estado de una consulta de artículo no recibido (INR) por parte del comprador. Este campo solo se devuelve si el comprador ha creado una consulta de INR.
IntegratedMerchantCreditCardEnabled Boolean Indica si el artículo se puede pagar a través de una cuenta de pasarela de pago.
LastTimeModified Datetime Indica la fecha y la hora en que se actualizó por última vez el estado de un pedido (en GMT).
PaymentHoldStatus String Este campo indica el tipo y/o el estado de una retención de pago en el artículo.
PaymentInstrument String El método de pago utilizado por un comprador alemán al que se le ofreció la opción Pagar al recibir la factura. Este campo solo se devolverá si a un comprador alemán se le ofreció la opción Pagar al recibir la factura. De lo contrario, el método de pago seleccionado por el comprador se devuelve en el campo PaymentMethodUsed.
PaymentMethodUsed String El método de pago que el comprador seleccionó para pagar el pedido. Si el pago aún no se ha completado, PaymentMethodUsed se establece en lo que el comprador haya seleccionado como su preferencia en la página Revisar su compra.
ReturnStatus String Este campo da el estado de una solicitud de devolución del comprador. Este campo solo se devuelve si el comprador ha iniciado una solicitud de devolución o ha escalado una solicitud de devolución existente a un caso de devolución.
TransactionPrice Decimal El precio de la línea de pedido (transacció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
ModTimeFrom String Los campos ModTimeFrom y ModTimeTo especifican un intervalo de fechas para recuperar elementos de línea de pedido asociados con el ItemId especificado. El campo ModTimeFrom es el intervalo de fechas de inicio.
ModTimeTo String Los campos ModTimeFrom y ModTimeTo especifican un intervalo de fechas para recuperar elementos de línea de pedido asociados con el ItemId especificado. El campo ModTimeTo es el intervalo de fechas de finalización.
NumberOfDays String Este filtro de tiempo especifica el número de días (períodos de 24 horas) en el pasado para buscar elementos de línea de pedido.

Elementos Más Vistos

Consulte los elementos con el mayor número de visitas para todo el sitio o para una categoría específica. Los elementos principales están determinados por los totales de Watch Count del día anterior. La clasificación de los elementos más vistos se calcula con la última información de Watch Count.

Información Específica de la Tabla
Seleccionar

Las únicas columnas que se pueden usar para filtrar son CategoryId, AffiliateCustomId, AffiliateNetworkId y AffiliateTrackingId. Estos filtros son opcionales.

SELECT * FROM MostWatchedItems
SELECT * FROM MostWatchedItems WHERE CategoryId = '277' 
Columnas
Nombre Tipo Descripción
ItemId [KEY] String El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista.
Title String Nombre del artículo tal como aparece en el listado o en los resultados de búsqueda.
Subtitle String Subtítulo del artículo. Solo se devolvió si el vendedor incluyó un subtítulo para el listado.
WatchCount Integer El número de relojes colocados en este artículo desde las cuentas de Mi eBay de los compradores.
BidCount Integer El número de ofertas que se han realizado en el artículo.
BuyItNowPrice Decimal El precio ¡Cómpralo ya! del artículo (si corresponde), en la moneda del sitio en el que se incluyó el artículo.
Currency String Los códigos de moneda ISO 4217 de 3 dígitos para la moneda utilizada por el sitio.
OriginalRetailPrice Decimal El precio minorista real establecido por el fabricante (OEM).
PricingTreatment String Con los valores OriginalRetailPrice, MinimalAdvertisedPrice y StartPrice, eBay identifica si el anuncio pertenece a MAP o STP (también conocido como OriginalRetailPrice).
SoldOffEbay Boolean Utilizado por los sitios de eBay Reino Unido y eBay Alemania (DE), este indicador indica que el precio de descuento (especificado como StartPrice) es el precio por el cual el vendedor ofreció el mismo artículo (o uno similar) a la venta en un sitio web o tienda fuera de línea que no sea que eBay en los 30 días anteriores. El precio de descuento es siempre en referencia al precio del artículo fijado por el vendedor.
SoldOnEbay Boolean Usado por los sitios de eBay Reino Unido y eBay Alemania (DE), este indicador indica que el precio de descuento (especificado como StartPrice) es el precio por el cual el vendedor ofreció el mismo artículo (o uno similar) a la venta en eBay en los 30 días anteriores. El precio de descuento es siempre en referencia al precio del artículo fijado por el vendedor.
GlobalId String El sitio en el que se enumera el artículo. Devuelve un Id. global, que es un identificador único para combinaciones de sitio, idioma y territorio.
ImageURL String URL de una imagen utilizada como miniatura de la galería, si corresponde. La imagen utiliza uno de los siguientes formatos gráficos: JPEG, BMP, TIF o GIF. Solo se devolvió si el vendedor eligió mostrar una imagen de la galería.
OriginalPrice Decimal Precio original de un artículo cuyo precio ha reducido un vendedor con la función Visualización de precios promocionales. Solo se devuelve si el precio ha sido revisado.
PrimaryCategoryId String ID numérico de la primera (o única) categoría en la que aparece el artículo. (Los listados pueden aparecer en más de una categoría.)
PrimaryCategoryName String Nombre para mostrar de la primera (o única) categoría en la que aparece el artículo. Esta es una ruta de exploración de categoría completamente calificada (por ejemplo, Computadoras y redes: computadoras portátiles, computadoras portátiles).
ShippingCost Decimal El costo de envío asociado con el primer servicio de envío. Solo se devuelve cuando ShippingType es plano.
ShippingType String El modelo de gastos de envío ofrecido por el vendedor.
TimeLeft String Tiempo restante antes de que finalice la lista de artículos. La duración se representa en el formato de duración ISO 8601 (PnDTnHnMnS). Para listados finalizados, el tiempo restante es P0DT0H0M0S (cero días, cero horas, cero minutos y cero segundos).
ViewItemURL String La URL de la página web donde un usuario puede ver el listado. En el sitio de EE. UU., esto se llama la página Ver elemento. Si habilitó el seguimiento de afiliados en la llamada, ViewItemURL contiene una cadena que incluye información de seguimiento de afiliados (consulte la Red de socios de eBay).
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
CategoryId String Especifica la categoría de la que recuperar listados de artículos.
AffiliateCustomId String No es necesario especificarlo. Puede definir un AffiliateCustomId para monitorear mejor sus esfuerzos de marketing. Si utiliza la red de socios de eBay y proporciona un AffiliateCustomId, la URL de seguimiento devuelta por la red de socios de eBay contendrá el AffiliateUserId.
AffiliateNetworkId String Especifica su socio de seguimiento para las comisiones de afiliados.
AffiliateTrackingId String El valor que especifique se obtiene de su socio de seguimiento.

PedidoPagos

Consulta todos los pagos de los pedidos, en los que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los datos de pago de los pedidos realizados en los últimos 90 días. Los detalles de pago de pedidos con más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista OrderPayments:

SELECT * FROM OrderPayments WHERE ModTimeFrom = '2/22/2018'

SELECT * FROM OrderPayments WHERE NumberOfDays = '30'
Columnas
Nombre Tipo Descripción
PaymentId [KEY] String Un ID de transacción único para el pago.
OrderId String Un identificador único para un pedido de eBay.
FeeOrCreditAmount Decimal El monto de la tarifa es un valor positivo y el monto del crédito es un valor negativo.
Payee String La persona u organización que va a recibir la asignación del pago.
Payer String Este campo indica el usuario de eBay o el socio de eBay que envió el pago.
PaymentAmount Decimal El monto del pago que se asigna al beneficiario.
PaymentStatus String El estado actual de un pago de comprador que se asigna a un beneficiario específico.
PaymentTime Datetime La fecha y hora en que el beneficiario recibe el pago.
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
CreateTimeFrom Datetime Especifica el inicio del intervalo de fechas para el que se recuperarán los detalles de pago de los pedidos creados dentro de este intervalo de fechas.
CreateTimeTo Datetime Especifica el final del intervalo de fechas para el que se recuperarán los detalles de pago de los pedidos creados dentro de este intervalo de fechas.
ModTimeFrom Datetime Especifica el inicio del intervalo de fechas para el que recuperar los detalles de pago de los pedidos modificados dentro de este intervalo de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del intervalo de fechas para el que se recuperarán los detalles de pago de los pedidos modificados dentro de este intervalo de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todos los detalles de pago de eBay de los pedidos que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra los detalles de pago devueltos de los pedidos según el rol del usuario. El rol del usuario es comprador o vendedor.
OrderStatus String Filtra los detalles de pago devueltos de los pedidos según el estado del pedido. Valores aplicables: Activo, Todo, Completado, Inactivo.

Pedidos

Consulta todos los pedidos en los que el usuario autenticado sea el comprador o el vendedor. Por defecto, solo se devuelven los pedidos realizados en los últimos 90 días. Los pedidos de más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista Pedidos:

SELECT * FROM Orders WHERE OrderId = '110276240386-28854859001'

SELECT * FROM Orders WHERE OrderId IN ('110276240386-28854859001','110277719772-28859911001')

SELECT * FROM Orders WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'

SELECT * FROM Orders WHERE OrderStatus = 'Active'

SELECT * FROM Orders WHERE NumberOfDays = '26'
Columnas
Nombre Tipo Descripción
OrderId [KEY] String Un identificador único para un pedido de eBay.
ExtendedOrderId String El identificador único de la orden en formato heredado, como se usa tradicionalmente en la API comercial.
BuyerUserId String ID de usuario de eBay del comprador del pedido.
SellerUserId String Este es el ID de usuario de eBay del vendedor del pedido.
OrderStatus String Este valor de enumeración indica el estado actual del pedido. Valores aplicables: Activo, Todo, Cancelado, Completado, Inactivo.
AdjustmentAmount Decimal Este valor indica el monto en dólares por el cual el comprador ha ajustado el total del pedido.
AmountPaid Decimal Este valor indica el importe total del pedido.
AmountSaved Decimal Este valor indica el descuento de envío experimentado por el comprador como resultado de crear un pedido de factura combinada.
CreatedTime Datetime Marca de tiempo que indica la fecha y hora en que se creó el pedido.
ShippedTime Datetime Sello de tiempo que indica la fecha y hora de envío del pedido. Este campo no se devuelve hasta que el pedido se haya marcado como enviado.
PaymentMethod String El método de pago que el comprador seleccionó para pagar el pedido.
PaymentStatus String Este valor indica el estado de pago de un pedido.
CheckoutStatus String Contenedor que consta de detalles relacionados con el estado de pago actual del pedido.
SellerEmail String La dirección de correo del vendedor involucrado en el pedido. La dirección de correo del vendedor solo se devuelve si es el mismo vendedor que realiza la llamada.
SubTotal Decimal El monto subtotal del pedido es el costo total de todos los elementos de línea del pedido. Este valor no incluye ningún costo de envío/manejo, seguro de envío o impuesto a las ventas.
Total Decimal El monto total es igual al valor del subtotal más los costos de envío/manejo, seguro de envío e impuestos sobre las ventas.
CancelCompleteDate Datetime Marca de tiempo que indica cuándo se ha completado el proceso de cancelación de un pedido de eBay.
CancelInitiationDate Datetime Esta marca de tiempo indica cuándo se inició la cancelación del pedido de eBay.
CancelInitiator String Este valor indica qué parte inició la cancelación del pedido de eBay.
CancelReason String Este valor indica el motivo por el cual se inició la cancelación del pedido.
CancelStatus String El estado actual de la solicitud de cancelación del pedido, si existe.
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
CreateTimeFrom Datetime Especifica el inicio del intervalo de fechas para el que se recuperarán los pedidos creados dentro de este intervalo de fechas.
CreateTimeTo Datetime Especifica el final del intervalo de fechas para el que se recuperarán los pedidos creados dentro de este intervalo de fechas.
ModTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todos los pedidos de eBay que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra los pedidos devueltos según el rol del usuario. El rol del usuario es comprador o vendedor.

PedidoEnvío

Consultar detalles de envío de los pedidos en los que el usuario autenticado es comprador o vendedor. De forma predeterminada, solo se devuelven los detalles de envío de los pedidos realizados en los últimos 90 días. Los detalles de envío de pedidos con más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista OrderShipping:

SELECT * FROM OrderShipping WHERE NumberOfDays = '30'

SELECT * FROM OrderShipping WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'
Columnas
Nombre Tipo Descripción
OrderId [KEY] String El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
AddressId String ID único para la dirección de un usuario en la base de datos de eBay.
CityName String El nombre de la ciudad del usuario.
Country String El código de dos dígitos que representa el país del usuario.
CountryName String El nombre del país del usuario.
AddressName String Nombre de usuario para la dirección.
Phone String Número de teléfono principal del usuario.
PostalCode String Código postal del usuario.
StateOrProvince String El estado o provincia de la dirección del usuario. Que sea un estado o una provincia dependerá de la región y/o país.
Street1 String La primera línea de la dirección postal del usuario.
Street2 String La segunda línea de la dirección de la calle del usuario (como un número de apartamento o número de suite).
ShippingCharge Decimal El valor en dólares de este campo indica la cantidad que se le está cobrando al vendedor (a nivel de pedido) por la conveniencia de una entrega a pedido de eBay.
ExpeditedService Boolean Indica si el servicio es un servicio de envío acelerado.
ShippingImportCharge Decimal El costo total de aduanas e impuestos para el tramo internacional de un pedido enviado mediante el Programa de envío global.
ShippingInsuranceCost Decimal El costo del seguro asociado con el envío de un solo artículo con este servicio de envío.
ShippingServiceAdditionalCost Decimal El costo de envío de cada artículo adicional si el mismo comprador compra varias cantidades del mismo artículo de línea.
ShippingServiceCost Decimal El costo base de enviar el artículo utilizando el servicio de envío especificado en el campo ShippingService.
ActualDeliveryTime Datetime Esta marca de tiempo indica cuándo se entregó realmente el pedido al comprador.
EstimatedDeliveryTimeMax Datetime Las marcas de tiempo estimadas de tiempo de entrega y estimado de tiempo máximo de entrega indican la ventana durante la cual el comprador puede esperar la entrega.
EstimatedDeliveryTimeMin Datetime Las marcas de tiempo estimadas de tiempo de entrega y estimado de tiempo máximo de entrega indican la ventana durante la cual el comprador puede esperar la entrega.
HandleByTime Datetime Esta marca de tiempo indica la última fecha/hora en que el vendedor debe enviar el paquete para asegurarse de que el paquete llegue al comprador dentro del plazo de entrega estimado.
ScheduledDeliveryTimeMax Datetime Las marcas de tiempo ScheduledDeliveryTimeMin y ScheduledDeliveryTimeMax indican la ventana de entrega en la que el comprador puede esperar recibir el pedido.
ScheduledDeliveryTimeMin Datetime Las marcas de tiempo ScheduledDeliveryTimeMin y ScheduledDeliveryTimeMax indican la ventana de entrega en la que el comprador puede esperar recibir el pedido.
ShippingTrackingEvent String Este valor de enumeración indica si el pedido se ha recogido o no en la tienda indicada por el valor StoreID.
StoreId String El identificador único de la tienda desde donde se entregará el pedido.
SalesTaxAmount Decimal El importe del impuesto sobre las ventas, calculado para un pedido en función de SalesTaxPercent y la información de precios.
SalesTaxPercent Float Porcentaje del precio de un artículo que se cobrará como impuesto sobre las ventas para el pedido.
SalesTaxState String Estado o jurisdicción para el cual se recauda el impuesto sobre las ventas. Solo se devuelve si el vendedor especificó un valor.
ShipmentTrackingNumbers String Los números de seguimiento asignados por los transportistas.
ShippingCarriers String El nombre de los transportistas utilizados para enviar los artículos.
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
CreateTimeFrom Datetime Especifica el inicio del intervalo de fechas para el que se recuperarán los detalles de envío de los pedidos creados dentro de este intervalo de fechas.
CreateTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de envío de los pedidos creados dentro de este rango de fechas.
ModTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar los detalles de envío de los pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de envío de los pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todos los detalles de envío de eBay de los pedidos que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra los detalles de envío devueltos de los pedidos según el rol del usuario. El rol del usuario es comprador o vendedor.
OrderStatus String Filtra los detalles de envío devueltos de los pedidos según el estado del pedido. Valores aplicables: Activo, Todo, Completado, Inactivo.

Políticas de Pago

Recupera todas las políticas de pago configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM PaymentPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas
Nombre Tipo Descripción
PaymentPolicyId [KEY] String Una identificación única asignada por eBay para una política de pago. Este ID se genera cuando se crea la política.
Description String La Descripción de la política de pago.
Name String La Descripción de la política de pago.
CategoryTypesName String El valor del nombre del tipo de categoría al que se aplica esta política. Se utiliza para distinguir las cuentas que venden vehículos de motor de las que no.
DepositAggr String Montos y fechas de vencimiento de los depósitos en listados de vehículos motorizados en eBay Motors. Es aplicable solo si el campo categoryTypes.name se establece en MOTORS_VEHICLES.
MarketplaceId String El ID del mercado de eBay al que se aplica la política de pago.
ImmediatePay Boolean Si se establece en verdadero, el pago vence al recibirlo (eBay genera un recibo cuando el comprador acepta comprar un artículo).
PaymentMethodAggr String Si el vendedor no está habilitado para pagos administrados, este contenedor devuelve una lista de los métodos de pago aceptados por el vendedor.
RecipientAccountReferenceId String Contiene la dirección de correo de PayPal del destinatario (comprador) si referenceType se establece en PAYPAL_EMAIL.
RecipientAccountReferenceType String Una referencia a la cuenta de un destinatario. Actualmente, solo PAYPAL_EMAIL es válido.

Políticas de Devolución

Recupera todas las políticas de devolución configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM ReturnPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas
Nombre Tipo Descripción
ReturnPolicyId [KEY] String Una identificación única asignada por eBay para esta política.
Description String La descripción definida por el vendedor de la política de devolución para uso interno (este valor no se muestra a los usuarios finales).
Name String El tipo de categoría al que se aplica la póliza (vehículos automotores o no automotores).
CategoryTypesName String El tipo de categoría al que se aplica la póliza (vehículos automotores o no automotores).
MarketplaceId String El ID del mercado de eBay al que se aplica esta política de devolución.
ExtendedHolidayReturnsOffered String Si se establece en verdadero, el vendedor ofrece una política de devoluciones de vacaciones extendidas para sus anuncios.
InternationalOverrideAggr String Si se completa, especifica las políticas del vendedor para devoluciones internacionales (artículos que requieren franqueo a través de un servicio de envío internacional).
RefundMethod String Indica el método que utiliza el vendedor para compensar al comprador por los artículos devueltos. El método de devolución especificado se aplica solo a las devoluciones de remordimiento.
RestockingFeePercentage String Para los vendedores que aceptan devoluciones, este campo se completa si cobran a los compradores una tarifa de reposición cuando se devuelven los artículos.
ReturnInstructions String Contiene la explicación detallada del vendedor sobre su política de devoluciones y se muestra en la sección Política de devoluciones de la página Ver artículo.
ReturnMethod String Válido solo en el mercado de EE. UU., este campo opcional indica servicios adicionales (aparte de la devolución de dinero) que los vendedores pueden ofrecer a los compradores por devoluciones de remordimiento.
ReturnPeriodValue String Especifica la cantidad de tiempo que el comprador tiene para devolver un artículo.
ReturnPeriodUnit String Especifica la unidad de medida de la cantidad de tiempo que el comprador tiene para devolver un artículo.
ReturnsAccepted Boolean Si se establece en verdadero, el vendedor acepta devoluciones.
ReturnShippingCostPayer String Este campo indica quién es responsable de pagar los gastos de envío de los artículos devueltos. El campo se puede configurar como COMPRADOR o VENDEDOR.

EnvíoTransportistas

Consulta de transportistas compatibles con el sitio especificado.

Columnas
Nombre Tipo Descripción
ShippingCarrierId Integer Identificador numérico.
Description String Cadena de visualización que las aplicaciones pueden usar para presentar una lista de transportistas en un formato más fácil de usar (como en una lista desplegable).
DetailVersion String Devuelve el número de versión más reciente para este campo.
ShippingCarrier String El código del transportista.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son ShippingCarrierDetails.

EnvíoCategorías

Una categoría de servicio de envío compatible con el sitio.

Columnas
Nombre Tipo Descripción
ShippingCategory [KEY] String Indica la categoría de envío. Las categorías de envío incluyen las siguientes: ECONÓMICO, ESTÁNDAR, RÁPIDO, UN DÍA, RECOGIDA, OTRO y NINGUNO. Los servicios de envío internacional generalmente se agrupan en la categoría NINGUNO. Para obtener más información sobre estas categorías de envío y qué servicios pertenecen a qué categoría, consulte la página Conceptos básicos de envío en el sitio del Centro de envío de eBay.
Description String Cadena de visualización que las aplicaciones pueden usar para presentar una lista de categorías de envío en un formato más fácil de usar (como en una lista desplegable). Este campo está localizado por sitio.
DetailVersion String Devuelve el número de versión más reciente para este campo. La versión se puede utilizar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles. Esta marca de tiempo se puede usar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son ShippingCategoryDetails.

Ubicaciones de Envío

Enumera las regiones y ubicaciones admitidas por los servicios de envío de eBay. Devuelve todas las ubicaciones de envío admitidas por eBay, independientemente del sitio especificado en la solicitud.

Columnas
Nombre Tipo Descripción
ShippingLocation [KEY] String Nombre corto o abreviatura de una región (p. ej., Asia) o ubicación (p. ej., Japón).
Description String Cadena de visualización que las aplicaciones pueden usar para presentar una lista de ubicaciones de envío en un formato más fácil de usar (como en una lista desplegable). Este campo está localizado en el idioma del sitio.
DetailVersion String Devuelve el número de versión más reciente para este campo. La versión se puede utilizar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles. Esta marca de tiempo se puede usar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son ShippingLocationDetails.

Servicios de Transporte Marítimo

Consulte los servicios de envío admitidos por el sitio de eBay especificado.

Información Específica de la Tabla
Seleccionar

La siguiente consultar recupera todos los servicios de envío disponibles. No hay filtros admitidos para esta vista.

SELECT * FROM ShippingServices
Columnas
Nombre Tipo Descripción
ShippingServiceId [KEY] Integer Identificador numérico. Un valor superior a 50000 representa un servicio de envío internacional.
CODService Boolean Este indicador se devuelve como verdadero si el valor de ShippingService correspondiente es un servicio COD (Cash-On-Delivery).
CostGroupFlat Boolean Si se devuelve, este es el grupo de servicios de envío al que pertenece el servicio de envío.
Description String Una descripción fácil de usar de las opciones de servicio de envío.
DetailVersion String Devuelve el número de versión más reciente para este campo.
DimensionsRequired Boolean Si la opción del servicio de envío requiere que el vendedor proporcione las dimensiones del paquete.
ExpeditedService Boolean Indica si el servicio de envío es un servicio de envío acelerado. Solo devuelto para sitios para los que la función Get It Fast está habilitada y solo si es verdadero.
InternationalService Boolean Indica si el servicio de envío es un servicio de envío internacional.
MappedToShippingServiceId Integer El ID de otro servicio de envío que se usará cuando un servicio de envío quede obsoleto.
ShippingCategory String Indica la categoría de envío. Las categorías de envío incluyen las siguientes: ECONÓMICO, ESTÁNDAR, RÁPIDO, UN DÍA, RECOGIDA, OTRO y NINGUNO. Los servicios de envío internacional generalmente se agrupan en la categoría NINGUNO.
ShippingService String El nombre de la opción de servicio de envío. Si la columna ValidForSellingFlow no es verdadera, esta opción de servicio de envío en particular ya no es válida y no se puede ofrecer a los compradores a través de una publicación.
ShippingTimeMax Integer El número máximo garantizado de días que el transportista tardará en enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista). Siempre devuelto cuando ExpeditedService es verdadero o si está definido para un servicio en particular.
ShippingTimeMin Integer El número mínimo garantizado de días que el transportista tardará en enviar un artículo (sin incluir el tiempo que tarda el vendedor en entregar el artículo al transportista). Siempre devuelto cuando ExpeditedService es verdadero o si está definido para un servicio en particular.
SurchargeApplicable Boolean Verdadero si se aplica un recargo para cualquier región a la que se envíe este servicio.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles.
ValidForSellingFlow Boolean Si este campo se devuelve como verdadero, se puede utilizar la opción de servicio de envío. Si este campo se devuelve como falso, la opción de servicio de envío no se admite actualmente.
WeightRequired Boolean Si es verdadero, un vendedor que seleccione este tipo de paquete para el listado y luego ofrezca este servicio de envío debe especificar Peso Mayor y Peso Menor en la definición del artículo. Si no se devuelve, WeightRequired es falso.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son ShippingServiceDetails.

Sitios

Enumera todos los sitios de eBay disponibles y sus números SiteID asociados.

Columnas
Nombre Tipo Descripción
SiteID Integer Identificador numérico de un sitio de eBay. Si utiliza la API de SOAP, utilice ID de sitio numéricos en la URL de solicitud. Si usa la API XML, use ID de sitio numéricos en el encabezado X-EBAY- API -SITEID.
SiteName String Nombre corto que identifica un sitio de eBay. Por lo general, un sitio de eBay está asociado con un país o una región en particular (por ejemplo, EE. UU. o Bélgica_Francés). Los sitios especializados (p. ej., las tiendas de eBay) utilizan el mismo ID de sitio que su sitio de eBay principal asociado. El sitio de eBay Motors de EE. UU. es una excepción a esta convención.
DetailVersion String Devuelve el número de versión más reciente para este campo. La versión se puede utilizar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
UpdateTime Datetime Proporciona la hora en GMT en la que se actualizaron por última vez los indicadores de función para los detalles. Esta marca de tiempo se puede usar para determinar si se deben actualizar los datos del cliente almacenados en caché y cuándo hacerlo.
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
DetailName String Una designación del tipo de información que desea obtener para el sitio de eBay especificado. Los valores permitidos son SiteDetails.

Los Productos Más Vendidos

Consulte sus productos más vendidos de eBay.

Información Específica de la Tabla
Seleccionar

Las únicas columnas que se pueden usar para filtrar son AffiliateCustomId, AffiliateNetworkId y AffiliateTrackingId. Estos filtros son opcionales.

SELECT * FROM TopSellingProducts
SELECT * FROM TopSellingProducts WHERE AffiliateCustomId='12345'
Columnas
Nombre Tipo Descripción
Title String El título del producto, tal como se especifica en el catálogo.
ProductId String Los ID de eBay o externos asociados con el producto. Use este valor como entrada para buscar el mismo producto en el futuro, o use el valor ISBN, EAN o UPC (si se devuelve). Los valores de ProductId se pueden usar para recuperar productos, listados de artículos o guías y reseñas. Longitud máxima: 4000.
ProductURL String URL completa para información opcional sobre el producto, como la descripción o los créditos cinematográficos de una película. Esta información está alojada en el sitio web de eBay y no se puede editar. Partes del contenido están protegidas por derechos de autor. Este enlace permite a los usuarios ver detalles descriptivos adicionales sobre el producto.
ImageURL String URL completa para una imagen de archivo (si la hay) asociada con el producto del catálogo de eBay. La URL es para la imagen que eBay suele mostrar en los resultados de búsqueda de productos (normalmente de 70 px de alto). Puede ser útil calcular las dimensiones de la foto mediante programación antes de mostrarla. Solo se devuelve si hay una URL disponible para el producto.
CatalogName String Nombre del catálogo en el que se encuentra el producto. Solo se devuelve si el producto está en un catálogo.
ReviewCount Long El número total de reseñas disponibles para este producto en el sitio web de eBay.
HighestPrice Decimal El precio más alto para artículos enumerados como este producto.
LowestPrice Decimal El precio más bajo para los artículos enumerados como este producto.
Currency String El código de moneda de tres dígitos como se define en ISO 4217.
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
AffiliateCustomId String No es necesario especificarlo. Puede usar esta pseudocolumna si desea aprovecharla para monitorear mejor sus esfuerzos de marketing. Si utiliza la red de socios de eBay y proporciona un AffiliateCustomId, la URL de seguimiento devuelta por la red de socios de eBay contendrá el AffiliateUserId.
AffiliateNetworkId String Especifica su socio de seguimiento para las comisiones de afiliados.
AffiliateTrackingId String El valor que especifique se obtiene de su socio de seguimiento.

TransacciónPagos

Consulta todos los pagos de las transacciones en las que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los pagos de las transacciones realizadas en los últimos 90 días. Los pagos de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista TransactionPayments:

SELECT * FROM TransactionPayments WHERE OrderRole = 'Seller'

SELECT * FROM TransactionPayments WHERE OrderId = '110277719772-28859911001'
Columnas
Nombre Tipo Descripción
TransactionReferenceId [KEY] String Un ID de transacción único para el pago.
TransactionId String El identificador único de la transacción por la que se ha realizado el pago.
OrderId String El identificador único del pedido por el que se ha realizado el pago.
FeeOrCreditAmount Decimal El monto de la tarifa es un valor positivo y el monto del crédito es un valor negativo.
Payee String La persona u organización que va a recibir la asignación del pago.
Payer String Este campo indica el usuario de eBay o el socio de eBay que envió el pago.
PaymentAmount Decimal El monto del pago que se asigna al beneficiario.
PaymentStatus String El estado actual de un pago de comprador que se asigna a un beneficiario específico.
PaymentTime Datetime La fecha y hora en que el beneficiario recibe el pago.
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
CreateTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar los detalles de pago de las transacciones en pedidos creados dentro de este rango de fechas. Por defecto, el intervalo de fechas es de 90 días.
CreateTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de pago de las transacciones en pedidos creados dentro de este rango de fechas. Por defecto, el intervalo de fechas es de 90 días.
ModTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar los detalles de pago de las transacciones en pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de pago de las transacciones en pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todos los detalles de pago de eBay de las transacciones en pedidos que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra los detalles de pago devueltos de las transacciones según el rol del usuario. El rol del usuario es comprador o vendedor.
OrderStatus String Filtra los detalles de pago devueltos de las transacciones según el estado del pedido. Valores aplicables: Activo, Todo, Completado, Inactivo.

Actas

Consulta todas las transacciones en las que el usuario autenticado es el comprador o el vendedor. Por defecto, solo se devuelven las transacciones de los pedidos realizados en los últimos 90 días. Las transacciones de pedidos de más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista Transacciones.

Select * FROM Transactions WHERE OrderRole = 'Seller'

Select * FROM Transactions WHERE OrderId = '110276240386-28854859001'

Select * FROM Transactions WHERE CreateTimeFrom = '2/10/2018' And CreateTimeTo = '3/16/2018'
Columnas
Nombre Tipo Descripción
TransactionId [KEY] String Identificador único para una línea de pedido de eBay. Una línea de pedido se crea una vez que existe el compromiso de un comprador de comprar un artículo.
OrderId String El ID que identifica de forma única la lista de artículos. eBay genera el ID después de que se incluye un artículo en la lista. No puede elegir ni revisar este valor.
ItemId String El identificador único de la lista de eBay. eBay genera este identificador y lo devuelve en la respuesta de una llamada Agregar si un artículo se incluye correctamente.
ItemSite String El nombre del sitio en el que aparece el artículo.
ItemTitle String Este campo se utiliza para especificar el título del listado.
ActualHandlingCost Decimal El costo de manejo que el vendedor ha cobrado por el artículo de línea de pedido.
ActualShippingCost Decimal El costo de envío pagado por el comprador por la línea de pedido. Este campo solo se devuelve después de completar el pago.
BuyerEmail String Dirección de Correo del usuario.
BuyerFirstName String El nombre del comprador que compró el pedido.
BuyerLastName String El apellido del comprador que compró el pedido.
CreatedDate Datetime Indica la hora de creación de la línea de pedido.
Price Decimal El precio de la línea de pedido.
SiteId String El sitio en el que se creó la línea de pedido (transacción).
PaidTime Datetime Indica el momento en que el pedido se marcó como pagado.
DigitalRecipientEmail String Este campo muestra la dirección de correo del remitente/comprador de la tarjeta de regalo digital.
DigitalRecipientName String Este campo muestra el nombre real (no el ID de usuario de eBay) del remitente/comprador de la tarjeta de regalo digital.
DigitalSenderEmail String Este campo muestra la dirección de correo del remitente/comprador de la tarjeta de regalo digital.
DigitalSenderName String Este campo muestra el nombre real (no el ID de usuario de eBay) del remitente/comprador de la tarjeta de regalo digital
DigitalDeliveryMethod String Este valor indica el método en el que se entregará la tarjeta de regalo digital al comprador.
EBayPlusTransaction Boolean Si es verdadero, esta transacción es para un artículo que se compró bajo el programa eBay Plus.
ExternalTransactionId String Identificador único para un pago de PayPal de un pedido de eBay.
ExternalTransactionStatus String El estado de procesamiento actual de un pago de PayPal para un pedido de eBay.
ExternalTransactionTime Datetime Marca de tiempo para la transacción de pago.
ExternalFeeOrCreditAmount Decimal El monto de la tarifa es un valor positivo y el monto del crédito es un valor negativo.
ExternalPaymentOrRefundAmount Decimal Si es positivo, la cantidad que el comprador paga al vendedor a través de PayPal en la compra de artículos. Si es negativo, el importe reembolsado al comprador. Predeterminado = 0.
FinalValueFee Decimal Una tarifa de valor final se calcula y carga a la cuenta de un vendedor inmediatamente después de la creación de una línea de pedido.
GuaranteedDelivery Boolean Este campo se devuelve como verdadero si el artículo de la línea del pedido cumple los requisitos para la entrega garantizada de eBay, o como falso si no cumple los requisitos.
GuaranteedShipping Boolean Este campo se devuelve como verdadero si el vendedor optó por utilizar la función de envío garantizado de eBay en el momento del anuncio.
InvoiceSentTime Datetime Este campo indica la fecha/hora en que se envió una factura de pedido del vendedor al comprador.
DigitalStatus String Este valor de enumeración indica el estado actual de una tarjeta de regalo digital comprada.
InquiryStatus String Este campo proporciona el estado de la consulta de artículo no recibido (INR) de un comprador.
ReturnStatus String Este campo proporciona el estado de la solicitud de devolución de un comprador.
TotalTaxAmount Decimal Este valor indica el monto total del impuesto para el artículo de línea del pedido, incluido el impuesto sobre las ventas del artículo, el impuesto sobre las ventas sobre el envío y la manipulación, y cualquier tarifa de reciclaje de desechos electrónicos.
UnpaidItemStatus String Este campo indica el estado del caso de artículo no pagado. Este campo siempre se devuelve con el contenedor UnpaidItem.
UnpaidItemType String Este campo indica si el cliente abrió manualmente el caso del artículo no pagado o si lo abrió automáticamente la función Asistente de artículos no pagados de eBay.
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
CreateTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar transacciones de pedidos creados dentro de este rango de fechas.
CreateTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar transacciones de pedidos creados dentro de este rango de fechas.
ModTimeFrom Datetime Especifica el inicio del intervalo de fechas para el que recuperar transacciones de pedidos modificados dentro de este intervalo de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar transacciones de órdenes modificadas dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todas las transacciones de eBay que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra las transacciones devueltas según el rol del usuario. El rol del usuario es comprador o vendedor.
OrderStatus String Filtra las transacciones devueltas según el estado del pedido. Valores aplicables: Activo, Todo, Completado, Inactivo.

TransacciónEnvío

Consulta los detalles de envío de las transacciones en las que el usuario autenticado es el comprador o el vendedor. De forma predeterminada, solo se devuelven los detalles de envío de la transacción realizada en los últimos 90 días. Los detalles de envío de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.

Ver Información Específica
Seleccionar

Ejemplos de consulta de la vista TransactionShipping:

SELECT * FROM TransactionShipping WHERE ModTimeFrom = '2/22/2018' And ModTimeTo = '3/4/2018'

SELECT * FROM TransactionShipping WHERE OrderId = '110277719772-28859911001'

SELECT * FROM TransactionShipping WHERE OrderId IN ('110277719772-28859911001', '110276240386-28854859001')
Columnas
Nombre Tipo Descripción
TransactionId [KEY] String Identificador único para la transacción.
OrderId String Identificador único para el pedido.
InternationalPackagingHandlingCosts Decimal Tarifas que un vendedor puede cobrar por el envío del artículo (además de lo que pueda cobrar el servicio de envío).
OriginatingPostalCode String Código postal de la ubicación desde donde se enviará el paquete.
PackagingHandlingCosts Decimal Tarifas que un vendedor puede cobrar por el envío del artículo (además de lo que pueda cobrar el servicio de envío).
ShippingIrregular Boolean Este campo booleano indica que el transportista considera que el paquete de envío tiene una forma o un tamaño irregulares y, por lo tanto, requiere un manejo especial.
ExpeditedService Boolean Indica si el servicio es un servicio de envío acelerado.
ShippingImportCharge Decimal El costo total de aduanas e impuestos para el tramo internacional de un pedido enviado mediante el Programa de envío global.
ShippingInsuranceCost Decimal El costo del seguro asociado con el envío de un solo artículo con este servicio de envío.
ShippingServiceAdditionalCost Decimal El costo de envío de cada artículo adicional si el mismo comprador compra varias cantidades del mismo artículo de línea.
ShippingServiceCost Decimal El costo base de enviar el artículo utilizando el servicio de envío especificado en el campo ShippingService.
ActualDeliveryTime Datetime Esta marca de tiempo indica cuándo se entregó realmente el pedido al comprador.
EstimatedDeliveryTimeMax Datetime Las marcas de tiempo estimadas de tiempo de entrega y estimado de tiempo máximo de entrega indican la ventana durante la cual el comprador puede esperar la entrega.
EstimatedDeliveryTimeMin Datetime Las marcas de tiempo estimadas de tiempo de entrega y estimado de tiempo máximo de entrega indican la ventana durante la cual el comprador puede esperar la entrega.
HandleByTime Datetime Esta marca de tiempo indica la última fecha/hora en que el vendedor debe enviar el paquete para asegurarse de que el paquete llegue al comprador dentro del plazo de entrega estimado.
ScheduledDeliveryTimeMax Datetime Las marcas de tiempo ScheduledDeliveryTimeMin y ScheduledDeliveryTimeMax indican la ventana de entrega en la que el comprador puede esperar recibir el pedido.
ScheduledDeliveryTimeMin Datetime Las marcas de tiempo ScheduledDeliveryTimeMin y ScheduledDeliveryTimeMax indican la ventana de entrega en la que el comprador puede esperar recibir el pedido.
ShippingTrackingEvent String Este valor de enumeración indica si el pedido se ha recogido o no en la tienda indicada por el valor StoreID.
StoreId String El identificador único de la tienda desde donde se entregará el pedido.
ShipmentTrackingNumbers String Los números de seguimiento asignados por los transportistas.
ShippingCarriers String El nombre de los transportistas utilizados para enviar los artículos.
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
CreateTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar los detalles de envío de las transacciones en pedidos creados dentro de este rango de fechas. Por defecto, el intervalo de fechas es de 90 días.
CreateTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de envío de las transacciones en pedidos creados dentro de este rango de fechas. Por defecto, el intervalo de fechas es de 90 días.
ModTimeFrom Datetime Especifica el inicio del rango de fechas para el cual recuperar los detalles de envío de las transacciones en pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
ModTimeTo Datetime Especifica el final del rango de fechas para el cual recuperar los detalles de envío de las transacciones en pedidos modificados dentro de este rango de fechas. El rango de tiempo máximo que se puede especificar es de 30 días.
NumberOfDays Integer Todos los detalles de envío de eBay de las transacciones en pedidos que se crearon o modificaron dentro de este período se devuelven en la salida. Mín.: 1. Máx.: 30.
OrderRole String Filtra los detalles de envío devueltos de las transacciones según el rol del usuario. El rol del usuario es comprador o vendedor.
OrderStatus String Filtra los detalles de envío devueltos de las transacciones según el estado del pedido. Valores aplicables: Activo, Todo, Completado, Inactivo.

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.

Conector Jitterbit para Procedimientos Almacenados de Ebay

Nombre Descripción
AddItem Cree y publique una nueva lista de artículos en un sitio de eBay.
CompleteSale Realice varias tareas después de la creación de un pedido de una sola línea o de varias líneas. Por ejemplo, complete una venta y deje comentarios.
CreateDSRSummery Recupere un informe de resumen de DSR que incluya la precisión de la descripción, la comunicación, el envío, etc. Esta información puede ayudar a los vendedores a determinar cómo las prácticas comerciales específicas pueden estar contribuyendo a puntajes de DSR más altos o más bajos.
CreateReport Comienza a procesar los datos para descargar un archivo de informe.
GetOAuthAccessToken Obtiene el token de acceso OAuth de eBay.
GetOAuthAuthorizationURL Obtiene la URL de autorización de eBay. Acceda a la URL devuelta en la salida en un navegador de Internet. Esto solicita el token de acceso que se puede utilizar como parte de la cadena de conexión a eBay.
GetReport Descarga un informe que se creó previamente con el procedimiento almacenado CreateReport. Para descargar el informe su estado debe ser Completado.
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth utilizado para la autenticación con EBay.
SetUserNotes Agregue, reemplace y elimine notas de Mi eBay para los artículos que se están rastreando en las áreas de Ventas y Compras de Mi eBay.
UploadFile Sube un archivo a la cuenta de EBay.

Añadir Artículo

Cree y publique una nueva lista de artículos en un sitio de eBay.

Procedimiento Almacenado* Información Específica

Tras la creación exitosa de un Listado de artículos, se devuelve un ID de artículo en la respuesta junto con las tarifas estimadas para listar el artículo. Después de agregar un elemento, puede usar la tabla ItemListing para actualizar, eliminar y consultar.

Las entradas requeridas para agregar cualquier artículo son las siguientes: Título, Descripción, Id. de categoría, Precio de inicio, Id. de condición, País, Moneda, Tiempo máximo de envío, Duración del listado, Tipo de listado, Método de pago, Dirección de correo electrónico de PayPal, Cantidad, Ubicación y Opción de devoluciones aceptadas.

También debe especificar varias entradas requeridas para seleccionar un tipo de envío: Plana o Calculada. Ambos tipos de envío requieren que se especifique un ShippingService.

Agregar un elemento

Puede seguir el procedimiento a continuación para obtener los valores requeridos y agregar un elemento a través de SQL:

  1. Utilice la vista Categorías para seleccionar una categoría de nivel superior; por ejemplo, Libros. Puedes usar la siguiente consultar:

    SELECT * FROM Categories
    
  2. Utilice la vista Categorías para seleccionar una categoría de hoja; por ejemplo, ficción y literatura. Se requiere un ID de categoría de hoja para agregar un artículo. Puede utilizar una consultar como la siguiente:

    SELECT * FROM Categories WHERE CategoryParentId='267'
    
  3. Utilice la vista Servicios de envío para seleccionar un Servicio de envío. El valor de la columna ValidForSellingFlow debe ser verdadero; de lo contrario, esa opción de servicio de envío en particular ya no es válida y no se puede ofrecer a los compradores a través de un listado.

Selección de envío fijo

Se requieren las siguientes entradas para el tipo de envío Flat: ShippingType, ShippingService, ShippingServicePriority y ShippingServiceCost.

Selección de envío calculado

El tipo de envío Calculado requiere información adicional relacionada con las estadísticas del paquete. Se requieren las siguientes entradas para este tipo de envío: ShippingType, WeightMajor, WeightMinor, OriginatingPostalCode, ShippingService y ShippingServicePriority.

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"
Entrada
Nombre Tipo Obligatorio Descripción
Title String Falso Nombre del artículo tal como aparece en el listado o en los resultados de búsqueda.
Description String Falso La descripción del artículo por parte del vendedor. En las solicitudes de listado, puede usar etiquetas CDATA para enviar su descripción si desea usar caracteres reservados HTML o XML en la descripción.
CategoryId String Falso Id. de categoría para la primera (o única) categoría en la que aparece el artículo (o aparecerá, si el artículo es nuevo).
StartPrice String Falso El precio original del artículo en el momento de cotización o reinscripción. Si este valor cambia cuando se revisa el artículo, el nuevo valor se convierte en el precio original.
ConditionId String Falso Un identificador de la condición del artículo. Por ejemplo, 1000 para Nuevo o 3000 para Usado.
Country String Falso Define el código de país ISO 3166 de 2 letras.
Currency String Falso Divisa asociada a la información de precio del artículo. Código de moneda ISO 4217 de 3 letras.
DispatchTimeMax String Falso Especifica el número máximo de días hábiles que el vendedor se compromete a preparar para enviar un artículo después de recibir un pago compensado. Este tiempo no incluye el tiempo de envío (el tiempo de tránsito del transportista).
ListingDuration String Falso Describe la cantidad de días que el vendedor desea que el listado esté activo (disponible para ofertar/comprar).
ListingType String Falso El formato del listado que el vendedor quiere usar, como subasta china o precio fijo.
PaymentMethod String Falso Identifica el método de pago (como PayPal) que el vendedor aceptará cuando el comprador pague el artículo. Use la vista CategoryFeatures para encontrar los métodos de pago disponibles para una categoría.
PayPalEmailAddress String Falso La dirección de correo de PayPal del vendedor.
Quantity String Falso El valor de cantidad para los listados de subasta siempre debe ser 1. Para un listado de precio fijo, el valor de cantidad indica la cantidad de artículos idénticos que el vendedor tiene disponibles para la venta en el listado.
Location String Falso Indica la ubicación geográfica del elemento (junto con el País). Cuando revisa un listado, puede agregar o cambiar este valor solo si el listado no tiene ofertas (o no se han vendido artículos) y no finaliza dentro de las 12 horas.
ReturnsAcceptedOption String Falso Indica si el vendedor permite que el comprador devuelva el artículo. Uno de los siguientes valores: ReturnsAccepted o ReturnsNotAccepted. Si especifica ReturnsNotAccepted, la página Ver artículo indicará que no se aceptan devoluciones en su lugar.
Sku String Falso Un valor SKU (Unidad de mantenimiento de existencias) es un identificador definido por el vendedor para un producto.
ShippingType String Falso El modelo de gastos de envío ofrecido por el vendedor.
FreeShipping String Falso Especifica que el vendedor quiere ofrecer envío gratuito. Esto se aplica solo al primer servicio de envío nacional especificado y se ignora si se establece para cualquier otro servicio de envío.
ShippingService String Falso Una opción de servicio de envío que ofrece el vendedor para enviar un artículo a un comprador. Para obtener una lista de valores de ShippingService válidos, consultar la vista ShippingServices; el servicio de envío devuelto debe tener un valor de verdadero en la columna ValidForSellingFlow.
ShippingServiceCost String Falso El costo base de enviar el artículo mediante el servicio de envío especificado en el campo ShippingService, si se especificó uno. Esta columna incluye el costo de empaque y manejo para envíos fijos y calculados. Si se trata de un envío calculado para una publicación que aún no finalizó, tenga en cuenta que el costo no se puede determinar hasta que finalice la publicación y el comprador haya especificado un código postal. Este valor refleja los ahorros de una opción de servicio de envío promocional. También aplicable a Half.com.
ShippingServicePriority String Falso Este valor entero controla el pedido (en relación con otros servicios de envío) en el que aparecerá el Servicio de envío correspondiente en la página Ver artículo y Pagar. Los vendedores pueden especificar hasta cuatro servicios de envío nacionales.
ShippingServiceAdditionalCost String Falso El costo de envío de cada artículo adicional si el mismo comprador compra varias cantidades del mismo artículo de línea. Si es menor que ShippingServiceCost, esta columna otorga al comprador un descuento de envío. Este campo es obligatorio cuando se crea un listado de precio fijo de cantidad múltiple. Este campo no se aplica a listados de una sola cantidad.
CalculatedShippingMeasurementSystem String Falso Sistema de medida (p. ej., inglés).
CalculatedShippingMeasurementUnit String Falso Especifica el tipo de unidad del peso y las dimensiones de un paquete de envío.
CalculatedShippingPackageLength String Falso Longitud del paquete, en un número entero de pulgadas (inglés) o centímetros (métrico), necesario para enviar el artículo.
CalculatedShippingPackageDepth String Falso Profundidad del paquete, en un número entero de pulgadas (inglés) o centímetros (métrico), necesario para enviar el artículo.
CalculatedShippingPackageWidth String Falso Ancho del paquete, en un número entero de pulgadas (inglés) o centímetros (métrico), necesario para enviar el artículo.
ShippingPackage String Falso La naturaleza del paquete utilizado para enviar los artículos. Obligatorio solo para envío calculado.
WeightMajor String Falso La unidad principal utilizada para especificar el peso de un paquete de envío. Por ejemplo, libras.
WeightMinor String Falso La unidad menor utilizada para especificar el peso de un paquete de envío. Por ejemplo, oz.
OriginatingPostalCode String Falso Código postal de la ubicación desde donde se enviará el paquete. Obligatorio para el envío calculado. Utilice Item.PostalCode para especificar la ubicación del elemento utilizado para las búsquedas por ubicación.
CategoryMappingAllowed String Falso Controla cómo eBay maneja los casos en los que la categoría ya no existe en la estructura de categorías actual: si es verdadero, eBay usará la nueva ID para la lista; si es falso, se devuelve un error.
BestOfferEnabled String Falso Este campo indica si la función Mejor oferta está habilitada o no para este artículo.
LinkedPayPalAccount String Falso El vendedor incluye y establece este campo en verdadero como un mecanismo para bloquear a los postores que no tienen una cuenta de PayPal vinculada a su cuenta de eBay.
MaximumBuyerPolicyViolations String Falso Este valor entero establece el número máximo de infracciones de la política del comprador que un posible comprador puede tener durante un período de tiempo específico (MaximumBuyerPolicyViolationsPeriod) antes de que se le bloquee la compra/oferta del artículo.
MaximumBuyerPolicyViolationsPeriod String Falso Este valor define el período de tiempo durante el cual se contarán las infracciones de la política del comprador de un posible comprador.
MaximumItemCount String Falso La cantidad máxima de artículos que un comprador puede comprar al vendedor durante un período de 10 días antes de que se bloquee la compra/oferta del artículo.
MaximumUnpaidItemStrikesInfo String Falso El número máximo de avisos por artículos no pagados que un posible comprador puede tener durante un período de tiempo específico (MaximumUnpaidItemStrikesInfoPeriod) antes de que se le bloquee la compra/oferta del artículo.
MaximumUnpaidItemStrikesInfoPeriod String Falso Se contará el período de tiempo durante el cual el artículo sin pagar golpea a un posible comprador. Si el número de avisos por artículos no pagados durante este período definido excede el valor establecido en el campo MaximumUnpaidStrikesInfo, ese posible comprador no podrá comprar/pujar por el artículo.
MinimumFeedbackScore String Falso El vendedor incluye este campo como un mecanismo para bloquear a los postores que tienen un puntaje de retroalimentación inferior al valor especificado.
ShipToRegistrationCountry String Falso El vendedor incluye y establece este campo en verdadero como un mecanismo para bloquear a los postores que residen (según su dirección de envío principal de eBay) en países que están en la lista de exclusión de envío.
VerifiedUser String Falso Para impedir que los usuarios no verificados compren/pujen por sus artículos, el vendedor debe incluir este campo y establecer su valor en verdadero.
ZeroFeedbackScore String Falso Esta función de requisitos del comprador solo está disponible para los vendedores en el sitio de China y solo se aplica a los artículos ¡Cómpralo ya! de precio fijo o de subasta.
CategoryBasedAttributesPrefill String Falso Si es verdadero, eBay completará automáticamente algunos de los valores de los valores específicos del artículo en función de la categoría (o categorías) del anuncio. Por ejemplo, marca, tamaño o color.
StoreCategoryId String Falso Identificador único de una categoría personalizada principal en la que incluir el artículo.
StoreCategoryName String Falso Nombre de categoría de una categoría personalizada principal en la que se listará el artículo.
StoreCategoryId2 String Falso Identificador único de la categoría personalizada secundaria en la que se incluye el artículo.
StoreCategoryName2 String Falso Nombre de la categoría personalizada secundaria en la que incluir el artículo.
LiveAuction String Falso Este campo debe incluirse y establecerse en verdadero si el anuncio formará parte de una subasta en vivo. Este campo booleano se devuelve como verdadero en la tabla ItemList si el listado es parte de una subasta en vivo. Consulte la página de inicio de las subastas en vivo de eBay para obtener más información sobre las subastas en vivo en eBay.com.
LotSize String Falso Un lote es un conjunto de dos o más artículos similares incluidos en un solo listado que deben comprarse juntos en una sola línea de pedido. El valor LotSize es el número de artículos en el lote. Este campo es obligatorio si se incluyen dos o más artículos en un listado.
DaysToFullPayment String Falso Este valor entero indica la cantidad de días que tiene un comprador (después de que se comprometa a comprar) para realizar el pago total al vendedor y cerrar el saldo restante de un vehículo motorizado. Los valores válidos son 3, 7 (predeterminado), 10 y 14.
PostalCode String Falso Código postal del lugar donde se encuentra el artículo. Este valor se utiliza para búsquedas de proximidad.
Brand String Falso La marca del producto. eBay busca los nombres que están disponibles públicamente en sus catálogos de productos. Esto significa que puede especificar la marca conocida que un usuario promedio reconocería. Tanto Brand como MPN deben especificarse si se usa la columna BrandMPN.
BrandMPN String Falso El número de pieza del fabricante del producto. Utilice el valor especificado por el fabricante.
EAN String Falso Aplicable solo para la lista de casos de uso (no para la búsqueda del lado de la compra). EAN es un identificador único de 8 o 13 dígitos que muchas industrias (como las editoriales de libros) utilizan para identificar productos.
IncludeeBayProductDetails String Falso Este campo booleano controla si un producto del catálogo de eBay se usa o no para ayudar a crear o revisar una lista de artículos.
IncludeStockPhotoURL String Falso Si es verdadero, indica que la lista de elementos incluye la foto de stock.
ISBN String Falso Aplicable solo para la lista de casos de uso (no para la búsqueda del lado de la compra). ISBN es un identificador único para libros (un estándar internacional). Especifique un ISBN de 10 o 13 caracteres.
ProductId String Falso El identificador único para una versión específica de un producto.
ProductReferenceId String Falso El ID de referencia global abreviado para un producto de catálogo.
UPC String Falso Aplicable solo para la lista de casos de uso (no para la búsqueda del lado de la compra). UPC es un identificador único de 12 caracteres que muchas industrias usan para identificar productos.
UseStockPhotoURLAsGallery String Falso Si es verdadero, indica que la foto de stock de un elemento (si está disponible) se usa como miniatura de la galería. IncluirStockPhotoURL también debe ser verdadero y Item.
MinimumRemnantSet String Falso Le permite a usted (el vendedor) evitar quedarse con 1 artículo en su listado. Un caso de uso típico son las entradas para eventos en asientos adyacentes reservados o artículos que normalmente solo se venden si se puede comprar más de 1 a la vez.
ScheduleTime String Falso Permite al usuario especificar la hora a la que el anuncio se activa en eBay.
PaymentProfileId String Falso El identificador único de un perfil de pago de Business Policies. Se puede especificar un PaymentProfileId o PaymentProfileName.
PaymentProfileName String Falso El nombre de un perfil de pago de Business Policies. Se puede especificar un PaymentProfileId o PaymentProfileName.
ReturnProfileId String Falso El identificador único de un perfil de política de devolución de Business Policies. Se puede especificar un ReturnProfileId o ReturnProfileName.
ReturnProfileName String Falso El nombre de un perfil de política de devolución de Business Policies. Se puede especificar un ReturnProfileId o ReturnProfileName.
ShippingProfileId String Falso El identificador único de un perfil de política de envío de Business Policies. Se puede especificar un ShippingProfileId o ShippingProfileName.
ShippingProfileName String Falso El nombre de un perfil de política de envío de Business Policies. Se puede especificar un ShippingProfileId o ShippingProfileName.
MeasurementUnit String Falso Especifica el tipo de unidad del peso y las dimensiones de un paquete de envío.
PackageDepth String Falso Profundidad del paquete, en un número entero de pulgadas, necesaria para enviar el artículo.
MeasurementSystem String Falso Sistema de medición (por ejemplo, inglés).
Unit String Falso Unidad de medida (p. ej., lbs, oz, kg, g, in, cm).
PackageLength String Falso Longitud del paquete, en un número entero de pulgadas, necesaria para enviar el artículo.
PackageWidth String Falso Ancho del paquete, en un número entero de pulgadas, necesario para enviar el artículo.
ShippingIrregular String Falso Si un paquete es irregular y, por lo tanto, no puede pasar por la máquina de estampado en la oficina de servicios de envío y, por lo tanto, requiere un manejo especial o frágil.
SubTitle String Falso Subtítulo para usar además del título.
TaxCategory String Falso Código de categoría de excepción fiscal.
ThirdPartyCheckout String Falso Determina si el pago debe ser manejado o no por una aplicación de pago de terceros autorizada.
TransactionId String Falso Un identificador único para un elemento de línea de pedido (transacción). Una línea de pedido se crea cuando un comprador se compromete a comprar un artículo. Dado que puede cambiar los listados activos de precio fijo de cantidad múltiple incluso después de que se haya comprado uno de los artículos, el TransactionId se asocia con una instantánea de los datos del artículo en el momento de la compra. Longitud máxima: 19.
UseRecommendedProduct String Falso Si es verdadero, y los detalles del artículo en la solicitud coinciden con un producto en el catálogo de eBay, el producto coincidente se usa para enumerar el artículo.
UseTaxTable String Falso Indica si se utilizará la tabla de impuestos del vendedor al aplicar y calcular el impuesto sobre las ventas para un artículo de línea de pedido.
UUID String Falso Etiqueta de restricción universalmente única. Utilice el UUID para asegurarse de enumerar un artículo en particular una sola vez, especialmente si está enumerando muchos artículos a la vez.
BusinessSeller String Falso Si es cierto, esto indica que el vendedor es un usuario comercial y tiene la intención de utilizar las funciones de listado que se ofrecen solo a los usuarios comerciales.
RestrictedToBusiness String Falso Si es cierto, esto indica que el vendedor elige ofrecer el artículo exclusivamente a usuarios comerciales. Si es falso o no se especifica, esto indica que el vendedor elige ofrecer el artículo a todos los usuarios.
VATPercent String Falso Tipo de IVA del artículo, si lo hubiere.
VIN String Falso Este campo muestra el número de identificación del vehículo, que es un número de serie único para un vehículo motorizado.
VRM String Falso Marca de registro del vehículo, que es un identificador único para un vehículo motorizado en el Reino Unido.
GalleryDuration String Falso Número de días que el tipo de Galería destacada se aplica a una lista. Los valores aplicables incluyen Days_7 y LifeTime.
GalleryURL String Falso Este campo solo se utiliza internamente. La imagen de la galería siempre es la primera URL de imagen que se pasa y este campo se establece en ese valor.
PhotoDisplay String Falso Especifica el tipo de visualización de imagen utilizada en un listado. Algunas opciones solo están disponibles si las imágenes se alojan a través de los Servicios de imágenes de eBay (EPS).
PictureUrl# String Falso Fuente de la imagen. Utilice esta entrada para agregar varias imágenes. PictureUrl#1, PictureUrl#2, PictureUrl#3 etc.
ItemSpecificName# String Falso Nombre de los detalles del artículo. Combine esto con ItemSpecificValue.
ItemSpecificValue# String Falso Valor de las especificaciones del artículo. Combine esto con ItemSpecificName.
Columnas del conjunto de resultados
Nombre Tipo Descripción
ItemId String El identificador único del elemento creado.
StartTime String Fecha y hora de inicio del nuevo listado.
EndTime String Fecha y hora en que está programado que finalice el nuevo anuncio en función de la hora de inicio y el valor de duración del anuncio que se configuró en el campo Duración del anuncio en el momento del anuncio.
FeesAggregate String Una serie de tarifas asociadas con la creación de la lista.
DiscountReason String eBay ofrece al vendedor uno o más tipos de tarifa de listado/descuento de actualización. Valores aplicables: CustomCode, Promotion, SpecialOffer.

Venta completa

Realice varias tareas después de la creación de un pedido de una sola línea o de varias líneas. Por ejemplo, complete una venta y deje comentarios.

Entrada
Nombre Tipo Obligatorio Descripción
FeedbackCommentText String Falso Comentario textual que explica, aclara o justifica la calificación de Feedback especificada en FeedbackCommentType. Este campo es obligatorio si se dejan comentarios.
FeedbackCommentType String Falso Este valor indica la calificación de comentarios para el usuario especificado en el campo FeedbackTargetUser. Este campo es obligatorio si se dejan comentarios. Por ejemplo, positivo o negativo.
FeedbackTargetUser String Falso Nombre de usuario del usuario de destino.
ItemId String Falso ID del artículo vendido.
ListingType String Falso Este campo es obligatorio si se utiliza CompleteSale para un pedido de Half.com. El valor debe establecerse en Half, que es el único valor ListingType aplicable para esta entrada.
OrderId String Falso Un identificador único que identifica un solo artículo de línea o un pedido de varios artículos de línea.
OrderLineItemId String Falso Un identificador único para un artículo de línea de pedido de eBay basado en la concatenación de ItemId y TransactionId con un guión entre estos dos Id. Para un pedido de un artículo de una sola línea, el valor de OrderLineItemId se puede pasar al campo OrderId.
Paid String Falso Si el comprador ha pagado el pedido. Verdadero o falso.
ShipmentNotes String Falso Este campo de cadena permite que un vendedor proporcione notas al comprador sobre el envío de un artículo de Half.com. Por ejemplo: Enviado con USPS Media.
ShipmentTrackingNumber String Falso El número de seguimiento asignado por el transportista al envío del artículo. Este campo y el campo ShippingCarrierUsed son mutuamente dependientes. Cuando envía ShipmentTrackingNumber, también debe proporcionar un valor para ShippingCarrierUsed. Cuando envía ShippingCarrierUsed, también debe proporcionar un valor para ShipmentTrackingNumber.
ShippingCarrierUsed String Falso El nombre del transportista utilizado para enviar el artículo. Este campo y el campo ShipmentTrackingNumber son mutuamente dependientes. Cuando envía ShippingCarrierUsed, también debe proporcionar un valor para ShipmentTrackingNumber. Cuando envía ShipmentTrackingNumber, también debe proporcionar un valor para ShippingCarrierUsed.
ShippedTime String Falso La fecha y hora en que el vendedor entregó los paquetes al transportista. Si este campo no está incluido en la llamada, la marca de tiempo de la ejecución de la llamada se usa como la hora de envío.
Shipped String Falso El vendedor incluye y establece este campo en verdadero si el pedido ha sido enviado. Si la llamada tiene éxito, los elementos de línea del pedido se marcan como Enviado en Mi eBay. Por ejemplo, verdadero o falso.
TransactionId String Falso Identificador único para una línea de pedido de eBay (transacción).
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Este valor muestra una indicación booleana de si la operación fue exitosa o no.

CreateDSRSummery

Recupere un informe de resumen de DSR que incluya la precisión de la descripción, la comunicación, el envío, etc. Esta información puede ayudar a los vendedores a determinar cómo las prácticas comerciales específicas pueden estar contribuyendo a puntajes de DSR más altos o más bajos.

Entrada
Nombre Tipo Obligatorio Descripción
CategoryId String Falso El informe resumido se basará en las DSR restantes para los elementos que se enumeraron solo en categorías específicas.
DateFrom String Falso El punto de partida del rango de fechas utilizado para recopilar datos de DSR para artículos comprados. El período de tiempo se aplica a la fecha de finalización de la transacción del artículo o a la fecha en que se incluyó el artículo.
DateTo String Falso El punto final del intervalo de fechas.
DateRangeEventType String Falso Tipo de evento de elemento en el que se basará el intervalo de fechas. Los tipos de eventos de rango de fechas incluyen: TransactionEndDate: el rango de fechas especificado se relaciona con la fecha en que finalizaron las transacciones. ListingDate: el rango de fechas especificado se relaciona con la fecha en que se enumeraron los elementos. Los valores permitidos son TransactionEndDate, ListingDate.
ShippingCostType String Falso Restrinja las DSR a artículos con envío gratuito o artículos para los que hubo un cargo por envío y manejo. Los valores permitidos son Gratis, Pagado.
ShippingDestinationType String Falso Restrinja los DSR a destinos de envío nacionales o internacionales. Los valores permitidos son Doméstico, Límites.
ShippingService String Falso Servicio de envío utilizado para enviar artículos.
ShipToCountry String Falso País al que se enviaron los artículos.
ItemId String Falso ID del anuncio asociado a la transacción para la que el vendedor recopila datos de calificación resumidos.
TransactionId String Falso Identificador único para una transacción.
ReportType String Falso Los informes se generarán en función de este filtro. Los valores permitidos son ByCategory, ByPeriod, ByShippingDetails, ByTransaction.
Columnas del conjunto de resultados
Nombre Tipo Descripción
JobId String JobId que puede usar para descargar el informe más tarde.

Crear informe

Comienza a procesar los datos para descargar un archivo de informe.

Entrada
Nombre Tipo Obligatorio Descripción
DownloadJobType String Falso Este campo se utiliza para especificar el tipo de informe de Datos del comerciante que se va a crear. Los valores permitidos son ActiveInventoryReport, FeeSettlementReport, SoldReport, OrderReport.
UUID String Falso Un identificador único universal (UUID) proporcionado por la aplicación del vendedor.
Columnas del conjunto de resultados
Nombre Tipo Descripción
JobId String ID único que se asigna para un trabajo.

GetOAuthAccessToken

Obtiene el token de acceso OAuth de eBay.

Entrada
Nombre Tipo Obligatorio Descripción
Verifier String Falso El token verificador devuelto por EBay después de usar la URL obtenida con GetOAuthAuthorizationURL. Requerido solo para Web AuthMode.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación.
RuName String Falso El nombre de la URL de redirección en el token de eBay a través de la sección de su aplicación de la página de tokens de usuario.
SessionId String Falso El ID de sesión necesario para autenticarse al usar Auth y Auth.
Scope String Falso El alcance o los permisos que está solicitando. El valor predeterminado es *https://api.ebay.com/oauth/api_scope https://api.ebay.com/oauth/api_scope/sell.marketing.readonly https://api.ebay.com/oauth/api_scope/sell.marketing https://api.ebay.com/oauth/api_scope/sell.inventory.readonly https://api.ebay.com/oauth/api_scope/sell.inventory https://api.ebay.com/oauth/api_scope/sell.account.readonly https://api.ebay.com/oauth/api_scope/sell.account https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly https://api.ebay.com/oauth/api_scope/sell.fulfillment https://api.ebay.com/oauth/api_scope/sell.analytics.readonly*.
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.
State String Falso Un valor opaco utilizado por el cliente para mantener el estado entre la solicitud y la devolución de llamada.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de OAuth.
OAuthRefreshToken String El token de actualización de OAuth.
ExpiresIn String El tiempo de vida restante para el token de acceso en segundos.

GetOAuthAuthorizationURL

Obtiene la URL de autorización de eBay. Acceda a la URL devuelta en la salida en un navegador de Internet. Esto solicita el token de acceso que se puede utilizar como parte de la cadena de conexión a eBay.

Entrada
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que eBay regresará después de que el usuario haya autorizado su aplicación. Si UseOAuth se establece en verdadero, se utilizará RuName en lugar de CallbackUrl.
RuName String Falso El nombre de la URL de redirección en el token de eBay a través de la sección de su aplicación de la página de tokens de usuario.
State String Falso Un valor opaco utilizado por el cliente para mantener el estado entre la solicitud y la devolución de llamada.
Scope String Falso El alcance o los permisos que está solicitando. Requerido solo para la autenticación OAuth. El valor predeterminado es *https://api.ebay.com/oauth/api_scope https://api.ebay.com/oauth/api_scope/sell.marketing.readonly https://api.ebay.com/oauth/api_scope/sell.marketing https://api.ebay.com/oauth/api_scope/sell.inventory.readonly https://api.ebay.com/oauth/api_scope/sell.inventory https://api.ebay.com/oauth/api_scope/sell.account.readonly https://api.ebay.com/oauth/api_scope/sell.account https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly https://api.ebay.com/oauth/api_scope/sell.fulfillment https://api.ebay.com/oauth/api_scope/sell.analytics.readonly*.
Columnas del conjunto de resultados
Nombre Tipo Descripción
URL String La URL que se ingresará en un navegador web para obtener el token del verificador, que deberá volver a enviar con el procedimiento almacenado GetOAuthAccessToken.

Obtener informe

Descarga un informe que se creó previamente con el procedimiento almacenado CreateReport. Para descargar el informe su estado debe ser Completado.

Entrada
Nombre Tipo Obligatorio Descripción
DownloadPath String Falso Ruta local para guardar el informe generado.
FileReferenceId String Falso Un ID único asignado al archivo.
TaskReferenceId String Falso Este campo hace referencia al JobId devuelto después de llamar al procedimiento almacenado CreateReport.
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Este valor muestra una indicación booleana de si la operación fue exitosa o no.
FileData String Si DownloadPath se deja en blanco, el contenido del archivo descargado se expondrá como una cadena codificada en Base64.

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con EBay.

Entrada
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Falso El antiguo token que se actualizará.
Columnas del conjunto de resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto de EBay.
ExpiresIn String El tiempo de vida restante en el token de acceso.

Establecer notas de usuario

Agregue, reemplace y elimine notas de Mi eBay para los artículos que se están rastreando en las áreas de Ventas y Compras de Mi eBay.

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"
Entrada
Nombre Tipo Obligatorio Descripción
Action String Cierto El vendedor debe incluir este campo y configurarlo en 'AddOrUpdate' para agregar una nueva nota de usuario o actualizar una nota de usuario existente, o configurarlo en 'Eliminar' para eliminar una nota de usuario existente.
ItemId String Falso Identificador único del anuncio al que se adjuntará la nota de Mi eBay. Las notas solo se pueden agregar a los artículos que se están rastreando actualmente en Mi eBay.
NoteText String Falso Este campo es necesario si la acción es AddOrUpdate. El texto proporcionado en este campo reemplazará por completo cualquier nota existente de Mi eBay para el artículo especificado.
OrderLineItemId String Falso Un identificador único para una línea de pedido de eBay. Este campo se crea tan pronto como existe un compromiso de compra del vendedor, y su valor se basa en la concatenación de ItemID y TransactionID, con un guión entre estos dos ID. OrderLineItemID se puede usar en la entrada en lugar de un par ItemID/TransactionID para identificar un artículo de línea de pedido.
SKU String Falso Valor SKU de la variación del artículo al que se adjuntará la nota de Mi eBay. Las notas solo se pueden agregar a los artículos que se están rastreando actualmente en Mi eBay. El vendedor define y utiliza un valor de SKU (unidad de mantenimiento de existencias) para identificar una variación dentro de un listado de múltiples variaciones de precio fijo. El valor SKU se asigna a una variación de un artículo a través del elemento Variations.Variation.SKU.
TransactionId String Falso Identificador único de la línea de pedido a la que se adjuntará la nota de Mi eBay. Las notas solo se pueden agregar a las líneas de pedido que se están rastreando actualmente en Mi eBay. Los compradores pueden ver las notas de usuario realizadas en las líneas de pedido en el campo PrivateNotes del contenedor WonList en GetMyeBayBuying, y los vendedores pueden ver las notas de usuario realizadas en las líneas de pedido en el campo PrivateNotes de los contenedores SoldList y DeletedFromSoldList en GetMyeBaySellinging.
VariationSpecificName# String Falso Dependiendo de la llamada y el contexto, este valor es un nombre de artículo/categoría/específico de variación o un nombre de compatibilidad de piezas.
VariationSpecificValue# String Falso Según la llamada y el contexto, este valor es el valor de un artículo/categoría/específico de variación, un valor de compatibilidad de piezas o un identificador de producto.
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Este valor muestra una indicación booleana de si la operación fue exitosa o no.

Subir archivo

Sube un archivo a la cuenta de EBay.

Procedimiento almacenado* Información específica

Este procedimiento asocia el archivo especificado con el ID de tarea especificado y carga el archivo de entrada. Una vez cargado el archivo, comienza el procesamiento del archivo.

Las entradas requeridas para cargar un archivo son las siguientes: TaskID y FilePath.

Subir un archivo

Puede seguir el procedimiento a continuación para enviar un archivo de carga exitoso:

  1. Utilice la tabla Tareas para crear una nueva Tarea. Puedes usar la siguiente consultar:

    INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')
    
  2. Puede obtener el TaskID recién generado a partir de las claves generadas o utilizando la tabla Tareas nuevamente para seleccionar.

        Statement stat = conn.createStatement();
        stat.executeUpdate("INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')", Statement.RETURN_GENERATED_KEYS);
        ResultSet rs = stat.getGeneratedKeys();
        while (rs.next()) {
          for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
            System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
          }
    }
    

    o

    SELECT * FROM [Tareas] WHERE FeedType = 'LMS_ADD_ITEM' AND CreationDate > '2021-11-16 09:19:00'
    
  3. Use este ID de tarea como entrada junto con FilePath del archivo que se va a cargar, en el procedimiento almacenado UploadFile.

        CallableStatement callableStatement = conn.prepareCall("UploadFile");
        callableStatement.setString("TaskID", "task-5-1XXXXX");
        callableStatement.setString("FilePath", "C:\Users\User\Documents\upload.csv");
    
        boolean ret = callableStatement.execute();
        if (!ret) {
          int count = callableStatement.getUpdateCount();
          if (count != -1) {
            System.out.println("Affected rows: " + count);
          }
        } else {
          ResultSet rs = callableStatement.getResultSet();
          while (rs.next()) {
            for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
              System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
            }
          }
    }
    
  4. Entonces su archivo debería estar procesando. Para realizar un seguimiento del estado, puede ejecutar una consultar SELECCIONAR en la tabla Tareas con el TaskID y verificar la columna Estado.

    SELECT Status FROM [Tareas] WHERE TaskID = '{Generated Task ID}'
    
Entrada
Nombre Tipo Obligatorio Descripción
TaskID String Cierto El task_id asociado con el archivo que se cargará. Este ID se generó cuando se creó la tarea especificada.
FilePath String Falso La ruta absoluta del archivo que se cargará.
Content String Falso El contenido del archivo que desea cargar debe ser una secuencia de entrada y el campo FilePath debe mantenerse en blanco.
FileName String Falso El nombre del archivo subido. Debe especificarse solo al cargar el contenido como InputStream. (Con extensión)
Columnas del conjunto de resultados
Nombre Tipo Descripción
Success String Este parámetro establece si la operación fue exitosa o no.
Description String Mensaje de descripción de la operación de carga. Puede ser un mensaje de error o un mensaje exitoso.

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 esquemas

Las siguientes tablas devuelven metadatos de la base de datos para eBay:

Tablas de origen 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.

Consultar tablas de información

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 ItemListing:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='ItemListing' 
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_procedures

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 AddItem:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='AddItem' 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 ItemListing:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='ItemListing'
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:ebay: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 de consultas en colaboración

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.

Autenticación

Propiedad Descripción
AuthScheme El esquema utilizado para la autenticación. Las entradas aceptadas son Auth y AuthNAuth.
DevID Su ID de desarrollador, según lo registrado en el Programa de desarrolladores de eBay.
SiteID El ID del sitio de eBay al que desea enviar la solicitud. Por defecto es 0, (EE.UU.).
UseSandbox Un valor booleano que indica si está utilizando una cuenta de espacio aislado.
RuName El nombre de URL de redireccionamiento utilizado para la validación. Esta propiedad solo es necesaria si está utilizando el proveedor para permitir que otros usuarios accedan a sus propios datos.

OAuth

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.
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.

SSL

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Esquema

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.

Misceláneas

Propiedad Descripción
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.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

Propiedad Descripción
AuthScheme El esquema utilizado para la autenticación. Las entradas aceptadas son Auth y AuthNAuth.
DevID Su ID de desarrollador, según lo registrado en el Programa de desarrolladores de eBay.
SiteID El ID del sitio de eBay al que desea enviar la solicitud. Por defecto es 0, (EE.UU.).
UseSandbox Un valor booleano que indica si está utilizando una cuenta de espacio aislado.
RuName El nombre de URL de redireccionamiento utilizado para la validación. Esta propiedad solo es necesaria si está utilizando el proveedor para permitir que otros usuarios accedan a sus propios datos.

Esquema de autenticación

El esquema utilizado para la autenticación. Las entradas aceptadas son Auth y AuthNAuth.

Valores posibles

Auto, OAuth, AuthNAuth

Tipo de datos

string

Valor predeterminado

"Auto"

Observaciones
  • Automático: permite que el controlador decida automáticamente según las otras propiedades de conexión que haya establecido.
  • OAuth: configure esto para realizar la autenticación OAuth.
  • AuthNAuth: establézcalo para realizar el método de autenticación tradicional Auth'n'Auth que utilizan las APIs de eBay.

ID de dispositivo

Su ID de desarrollador, según lo registrado en el Programa de desarrolladores de eBay.

Tipo de datos

string

Valor predeterminado

""

Observaciones

Su ID de desarrollador, según lo registrado en el Programa de desarrolladores de eBay.

ID del sitio

El ID del sitio de eBay al que desea enviar la solicitud. Por defecto es 0, (EE.UU.).

Tipo de datos

string

Valor predeterminado

"0"

Observaciones

El ID del sitio de eBay al que desea enviar la solicitud. Por defecto es 0, (EE. UU.)

UseSandbox

Un valor booleano que indica si está utilizando una cuenta de espacio aislado.

Tipo de datos

bool

Valor predeterminado

false

Observaciones

Un valor booleano que indica si está utilizando una cuenta de espacio aislado.

RuName

El nombre de URL de redireccionamiento utilizado para la validación. Esta propiedad solo es necesaria si está utilizando el proveedor para permitir que otros usuarios accedan a sus propios datos.

Tipo de datos

string

Valor predeterminado

""

Observaciones

El nombre de URL de redireccionamiento utilizado para la validación. Esta propiedad solo es necesaria si utiliza el conector para permitir que otros usuarios accedan a sus propios datos. Puede obtener esto haciendo clic en Tokens de usuario desde su cuenta de desarrollador, haciendo clic en Obtener un token de eBay a través de su aplicación y luego haciendo clic en Agregar URL de redirección de eBay.

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.
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 predeterminado

"OFF"

Observaciones

Las siguientes opciones están disponibles:

  1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
  2. 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.
  3. 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 predeterminado

""

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.

OAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de datos

string

Valor predeterminado

""

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 predeterminado

""

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 predeterminado

""

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.

Verificador OAuth

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de datos

string

Valor predeterminado

""

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.

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 predeterminado

""

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 predeterminado

""

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 predeterminado

""

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 predeterminado

""

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 predeterminado

"%APPDATA%\\\Ebay 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%\\Ebay 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 predeterminado

""

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.

Tablas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de datos

string

Valor predeterminado

""

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.

Vistas

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de datos

string

Valor predeterminado

""

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.

Varios

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
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.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

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.

Tipo de datos

int

Valor predeterminado

-1

Comentarios

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 predeterminado

""

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 formato
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.

PseudoColumnas

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de datos

string

Valor predeterminado

""

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, "*=*".

Tiempo de espera

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de datos

int

Valor predeterminado

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.