Compartir a través de


eBay (Publicador independiente) (versión preliminar)

eBay es una empresa multinacional estadounidense de comercio electrónico que facilita las ventas de consumidor a consumidor y de negocio a consumidor a través de su sitio web.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Artesian Software Technologies LLP
URL https://artesian.io
Correo Electrónico amit.sharma@artesian.io
Metadatos del conector
Publicador Artesian Software Technologies LLP
Sitio web https://www.ebay.com/
Directiva de privacidad https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260
Categorías Comercio; Ventas y CRM

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Id. de cliente: tu clientId de eBay cuerda / cadena Escriba el identificador de cliente. Cierto
Secreto del cliente securestring Escriba el secreto de cliente. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualizar oferta

Esta llamada actualiza una oferta existente que puede estar publicada o en un estado no publicado.

Crear o reemplazar elemento de inventario

Esta llamada crea un nuevo registro de elemento de inventario o reemplaza un registro de elemento de inventario existente.

Crear oferta

Esta llamada crea una oferta para un artículo de inventario específico en un marketplace de eBay específico.

Crear ubicación de inventario

Use esta llamada para crear una nueva ubicación de inventario. Para crear y publicar una oferta, un vendedor debe tener al menos una ubicación de inventario, ya que cada oferta debe estar asociada a una ubicación.

Elemento de inventario GET

Esta llamada recupera el registro de elementos de inventario de una SKU determinada.

Eliminar oferta

Esta llamada eliminará permanentemente la oferta.

GET Offer

Esta llamada recupera una oferta publicada o no publicada específica.

Obtención de la ubicación del inventario

Esta llamada recupera todos los detalles definidos de la ubicación del inventario especificada por el parámetro de ruta de acceso merchantLocationKey.

Obtener aspectos del elemento para la categoría

Esta llamada devuelve una lista de aspectos adecuados o necesarios para describir con precisión los elementos de la categoría hoja especificada. Cada aspecto identifica un atributo de elemento (por ejemplo, color) para el que el vendedor será obligatorio o se recomienda proporcionar un valor (o valores de variación) al ofrecer un artículo en esa categoría en eBay.

Obtener directiva de cumplimiento

Este método recupera los detalles completos de una directiva de cumplimiento. Proporcione el identificador de la directiva que desea recuperar mediante el parámetro de ruta de acceso fulfillmentPolicyId.

Obtener directiva de devolución

Este método recupera los detalles completos de la directiva de retorno especificada por el parámetro de ruta de acceso returnPolicyId.

Obtener directiva de pago

Este método recupera los detalles completos de una directiva de pago. Proporcione el identificador de la directiva que desea recuperar mediante el parámetro de ruta de acceso paymentPolicyId.

Obtener directivas de condición de elemento

Este método devuelve metadatos de condición de artículo en una, varias o todas las categorías de eBay en un marketplace de eBay.

Obtener directivas de cumplimiento

Este método recupera todas las directivas de cumplimiento configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Obtener directivas de devolución

Este método recupera todas las directivas de retorno configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Obtener directivas de pago

Este método recupera todas las directivas de pago configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Obtener elementos de inventario

Esta llamada recupera todos los registros de elementos de inventario definidos para la cuenta del vendedor.

Obtener sugerencias de categoría

Esta llamada devuelve una matriz de nodos hoja de árbol de categoría en el árbol de categorías especificado que eBay considera que se corresponde más estrechamente con la consulta.

Obtener treeId de categoría predeterminado

Un marketplace de eBay determinado puede usar varios árboles de categoría, pero uno de esos árboles se considera el valor predeterminado para ese marketplace. Esta llamada recupera una referencia al árbol de categorías predeterminado asociado al identificador de marketplace de eBay especificado.

Obtener ubicaciones de inventario

Esta llamada recupera todos los detalles definidos de cada ubicación de inventario asociada a la cuenta del vendedor.

Ofertas GET

Esta llamada recupera todas las ofertas existentes para el valor de SKU especificado. El vendedor tiene la opción de limitar las ofertas que se recuperan a un marketplace de eBay específico o a un formato de descripción.

Publicar oferta

Esta llamada se usa para convertir una oferta no publicada en una oferta publicada o publicar la descripción en directo de eBay. El identificador único de la oferta (offerId) se pasa al final del URI de llamada.

Retirar oferta

Esta llamada se usa para finalizar una lista de variación única asociada a la oferta especificada.

Actualizar oferta

Esta llamada actualiza una oferta existente que puede estar publicada o en un estado no publicado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de oferta
offerId True string

Identificador único de la oferta que desea actualizar.

Cantidad disponible
availableQuantity integer

Cantidad disponible de inventario para la compra.

Id. de categoría
categoryId string

eBay Id. de categoría único en el que se mostrará el producto.

Id. de caridad
charityId string

eBay-assigned unique ID of charitable organization that'll receive a percentage of sales proceeds.

Porcentaje de donación
donationPercentage string

Porcentaje de precio de compra que la organización benéfica recibirá para cada venta que genere el listado.

Identificador de producto del productor
producerProductId string

Identificador único del productor relacionado con el elemento.

Id. del paquete del producto
productPackageId string

Identificador único del productor del embalaje del producto agregado por el vendedor.

Id. de paquete de envío
shipmentPackageId string

Identificador único del productor de cualquier embalaje utilizado por el vendedor para enviar artículos.

Id. de documentación del producto
productDocumentationId string

Identificador único del productor de cualquier papel añadido al paquete del artículo por parte del vendedor.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Ocultar detalles del comprador
hideBuyerDetails boolean

Este campo se incluye si el vendedor desea crear una descripción privada.

Incluir detalles del producto del catálogo
includeCatalogProductDetails boolean

Indica si los detalles del catálogo de productos de eBay se aplican o no a una descripción.

Descripción de la descripción
listingDescription string

Descripción de la descripción de eBay.

Duración de la descripción
listingDuration string

Número de días que la lista estará activa.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Mejor oferta habilitada
bestOfferEnabled boolean

Indica si la característica Mejor oferta está habilitada o no para la descripción.

eBay Plus si es apto
eBayPlusIfEligible boolean

Este campo se incluye en una oferta si un vendedor de Top-Rated participa en el programa eBay Plus.

Identificador de directiva de cumplimiento
fulfillmentPolicyId string

Identificador único indica la directiva de negocio de cumplimiento que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificador de directiva de pago
paymentPolicyId string

El identificador único indica la política comercial de pago que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificadores de directiva de cumplimiento de productos
productCompliancePolicyIds array of string

Este campo contiene una matriz de hasta cinco identificadores que especifican las directivas de cumplimiento creadas por el vendedor para la lista.

Id. de directiva de devolución
returnPolicyId string

Devolver el identificador único de la política de negocios que se usará una vez que se publique una oferta y se convierta en una descripción de eBay.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Priority
priority integer

El valor entero que se introduce en este campo, junto con el valor shippingServiceType, establece qué opción de servicio de envío nacional o internacional en la directiva de suministro se modificará con los costos de envío actualizados.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Tipo de servicio
shippingServiceType string

Este valor indica si el servicio de envío especificado en el campo de prioridad es una opción de servicio de envío nacional o internacional.

Id. de directiva de devolución
takeBackPolicyId string

Id. de vendedor que creó la directiva de devolución.

Fecha de inicio de la lista
listingStartDate string

Este campo se puede usar si el vendedor quiere especificar una hora en el futuro que la descripción se activará en eBay.

Tamaño de lote
lotSize integer

Este campo solo es aplicable si la lista es mucho listado. El valor entero pasado a este campo es el número total de elementos del lote.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la ubicación de inventario de un comerciante

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Se vende originalmente por precio de venta al por menor
originallySoldForRetailPriceOn string

Este campo es necesario si la característica Precios de tachado se usará en la oferta. Este campo indica que el producto se vendió por el precio en el campo retailPrice original en un sitio de eBay, o que se vendió por ese precio por un minorista de terceros.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Visibilidad de precios
pricingVisibility string

Este campo es necesario si la característica Precio anunciado mínimo se usará en la oferta.

Límite de cantidad por comprador
quantityLimitPerBuyer integer

Este campo solo es aplicable y se establece si el vendedor desea establecer una restricción en la cantidad de compra por vendedor.

Id. de categoría secundaria
secondaryCategoryId string

Identificador de categoría secundaria único y aplicable si el vendedor decide enumerar el elemento en dos categorías.

Nombres de categoría de la tienda
storeCategoryNames array of string

Almacenar nombres de categoría

Aplicar impuestos
applyTax boolean

Este contenedor solo es aplicable y se usa si se aplicará una tabla de impuestos de ventas, una tasa de impuestos Value-Added o un código de categoría de excepción fiscal a la oferta.

Categoría fiscal de terceros
thirdPartyTaxCategory string

Código de categoría de excepción fiscal. Si se usa este campo, el impuesto sobre las ventas también se aplicará a un servicio/tarifa, y no solo al precio del artículo.

Porcentaje de IVA
vatPercentage number

Este valor es el tipo de IVA del artículo, si existe. Cuando se especifica un porcentaje de IVA, la información del IVA del artículo aparece en la página Ver elemento de la lista.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de oferta
offerId string

Identificador único de la oferta

Advertencias
warnings array of object

Este contenedor devolverá cuando se realice una llamada y se produzcan errores o advertencias.

Categoría
warnings.category string

Este valor de cadena indica la categoría de error.

Dominio
warnings.domain string

Nombre de dominio en el que se produjo el error o la advertencia.

Identificador de error
warnings.errorId integer

Código único que identifica el error o la advertencia concretos que se produjeron.

inputRefIds
warnings.inputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de solicitud específicos más estrechamente asociados al error o advertencia, si los hay.

Mensaje largo
warnings.longMessage string

Descripción detallada de la condición que provocó el error o la advertencia e información sobre qué hacer para corregir el problema.

Message
warnings.message string

Descripción de la condición que provocó el error o la advertencia.

outputRefIds
warnings.outputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de respuesta específicos más estrechamente asociados al error o advertencia, si los hay.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la advertencia.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain string

Nombre del subdominio en el que se produjo el error o la advertencia.

Crear o reemplazar elemento de inventario

Esta llamada crea un nuevo registro de elemento de inventario o reemplaza un registro de elemento de inventario existente.

Parámetros

Nombre Clave Requerido Tipo Description
SKU
sku True string

Valor definido por el vendedor para el elemento de inventario.

Content-Language
Content-Language True string

El encabezado establece el lenguaje natural que se usará en los valores de campo de la carga de solicitud.

Tipo
availabilityType string

Estado de disponibilidad del artículo de inventario en el almacén físico del comerciante.

Unidad
unit string

Unidad de tiempo usada para especificar el tiempo de suministro.

Importancia
value integer

Valor de tiempo de cumplimiento.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la tienda del comerciante donde In-Store artículo de inventario de recogida se encuentra actualmente o se enviará a.

Cantidad
quantity integer

Cantidad de artículos de inventario disponibles para In-Store Recogida.

Unidad
unit string

Unidad de tiempo usada para especificar el tiempo de suministro.

Importancia
value integer

Valor de tiempo de cumplimiento.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la tienda del comerciante donde In-Store artículo de inventario de recogida se encuentra actualmente, o se enviará a.

Cantidad
quantity integer

Cantidad del elemento de inventario que está disponible en esta ubicación de inventario.

Cantidad
quantity integer

Cantidad total de "envío a casa" de artículos de inventario que estarán disponibles para su compra a través de una o varias ofertas publicadas.

Condición
condition string

Condición del elemento.

Descripción de la condición
conditionDescription string

Descripción de la condición de un elemento de inventario.

Altura
height number

Alto real del paquete de envío.

Length
length number

Longitud real del paquete de envío.

Unidad
unit string

Unidad de medida utilizada para especificar las dimensiones de un paquete de envío.

Ancho
width number

Ancho real del paquete de envío.

Tipo de paquete
packageType string

Valor del paquete de envío usado para enviar el artículo de inventario.

Unidad
unit string

Unidad de medida utilizada para especificar el peso de un paquete de envío.

Importancia
value number

Peso real del paquete de envío.

Aspectos
aspects object

Se trata de una colección de pares de nombre-valor específicos de los artículos que proporcionan más información sobre el producto y podría facilitar la búsqueda de compradores.

Marca
brand string

Marca del producto.

Description
description string

Descripción del producto.

Elementos de EAN
ean array of string

EAN

ePID
epid string

Identificador de producto de eBay para el producto.

Direcciones URL de imagen
imageUrls array of string

Direcciones URL de imagen

Elementos ISBN
isbn array of string

ISBN

MPN
mpn string

Fabricante Número de pieza de un producto.

Subtítulo
subtitle string

Característica de descripción opcional que permite al vendedor proporcionar más información sobre el producto, posiblemente incluyendo palabras clave que pueden ayudar con los resultados de la búsqueda.

Title
title string

El título de un elemento de inventario se puede agregar o modificar.

Elementos DE LA CPU
upc array of string

Upc

Identificadores de vídeo
videoIds array of string

videoIds

Devoluciones

Nombre Ruta de acceso Tipo Description
Advertencias
warnings array of object

Este contenedor se devolverá en una carga de respuesta de llamada si se desencadenan una o varias advertencias o errores.

Categoría
warnings.category string

Este valor de cadena indica la categoría de error.

Dominio
warnings.domain string

Nombre del dominio en el que se produjo el error o la advertencia.

Identificador de error
warnings.errorId integer

Código único que identifica el error o la advertencia concretos que se produjeron.

inputRefIds
warnings.inputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de solicitud específicos más estrechamente asociados al error o advertencia, si los hay.

Mensaje largo
warnings.longMessage string

Descripción detallada de la condición que provocó el error o la advertencia e información sobre qué hacer para corregir el problema.

Message
warnings.message string

Descripción de la condición que provocó el error o la advertencia.

outputRefIds
warnings.outputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de respuesta específicos más estrechamente asociados al error o advertencia, si los hay.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la advertencia.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain object

Descripción de la condición que provocó el error o la advertencia.

Crear oferta

Esta llamada crea una oferta para un artículo de inventario específico en un marketplace de eBay específico.

Parámetros

Nombre Clave Requerido Tipo Description
Cantidad disponible
availableQuantity integer

Cantidad disponible de inventario para la compra.

Id. de categoría
categoryId string

eBay Id. de categoría único en el que se mostrará el producto.

Id. de caridad
charityId string

eBay-assigned unique ID of charitable organization that'll receive a percentage of sales proceeds.

Porcentaje de donación
donationPercentage string

Porcentaje de precio de compra que la organización benéfica recibirá para cada venta que genere el listado.

Identificador de producto del productor
producerProductId string

Identificador único del productor relacionado con el elemento.

Id. del paquete del producto
productPackageId string

Identificador único del productor del embalaje del producto agregado por el vendedor.

Id. de paquete de envío
shipmentPackageId string

Identificador único del productor de cualquier embalaje utilizado por el vendedor para enviar artículos.

Id. de documentación del producto
productDocumentationId string

Identificador único del productor de cualquier papel añadido al paquete del artículo por parte del vendedor.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Formato
format string

Formato de anuncio de la oferta.

Ocultar detalles del comprador
hideBuyerDetails boolean

Este campo se incluye si el vendedor desea crear una descripción privada.

Incluir detalles del producto del catálogo
includeCatalogProductDetails boolean

Indica si los detalles del catálogo de productos de eBay se aplican o no a una descripción.

Descripción de la descripción
listingDescription string

Descripción de la descripción de eBay.

Duración de la descripción
listingDuration string

Número de días que la lista estará activa.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Mejor oferta habilitada
bestOfferEnabled boolean

Indica si la característica Mejor oferta está habilitada o no para la descripción.

eBay Plus si es apto
eBayPlusIfEligible boolean

Este campo se incluye en una oferta si un vendedor de Top-Rated participa en el programa eBay Plus.

Identificador de directiva de cumplimiento
fulfillmentPolicyId string

Identificador único indica la directiva de negocio de cumplimiento que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificador de directiva de pago
paymentPolicyId string

El identificador único indica la política comercial de pago que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificadores de directiva de cumplimiento de productos
productCompliancePolicyIds array of string

Este campo contiene una matriz de hasta cinco identificadores que especifican las directivas de cumplimiento creadas por el vendedor para la lista.

Id. de directiva de devolución
returnPolicyId string

Devolver el identificador único de la política de negocios que se usará una vez que se publique una oferta y se convierta en una descripción de eBay.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Priority
priority integer

El valor entero que se introduce en este campo, junto con el valor shippingServiceType, establece qué opción de servicio de envío nacional o internacional en la directiva de suministro se modificará con los costos de envío actualizados.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Tipo de servicio
shippingServiceType string

Este valor indica si el servicio de envío especificado en el campo de prioridad es una opción de servicio de envío nacional o internacional.

Id. de directiva de devolución
takeBackPolicyId string

Id. de vendedor que creó la directiva de devolución.

Fecha de inicio de la lista
listingStartDate string

Este campo se puede usar si el vendedor quiere especificar una hora en el futuro que la descripción se activará en eBay.

Tamaño de lote
lotSize integer

Este campo solo es aplicable si la lista es mucho listado. El valor entero pasado a este campo es el número total de elementos del lote.

Identificador de Marketplace
marketplaceId string

Id. único del sitio de eBay para el que la oferta estará disponible.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la ubicación de inventario de un comerciante

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Se vende originalmente por precio de venta al por menor
originallySoldForRetailPriceOn string

Este campo es necesario si la característica Precios de tachado se usará en la oferta. Este campo indica que el producto se vendió por el precio en el campo retailPrice original en un sitio de eBay, o que se vendió por ese precio por un minorista de terceros.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Visibilidad de precios
pricingVisibility string

Este campo es necesario si la característica Precio anunciado mínimo se usará en la oferta.

Límite de cantidad por comprador
quantityLimitPerBuyer integer

Este campo solo es aplicable y se establece si el vendedor desea establecer una restricción en la cantidad de compra por vendedor.

Id. de categoría secundaria
secondaryCategoryId string

Identificador de categoría secundaria único y aplicable si el vendedor decide enumerar el elemento en dos categorías.

SKU
sku string

Valor de SKU definido por el vendedor del producto que se mostrará en el sitio de eBay.

Nombres de categoría de la tienda
storeCategoryNames array of string

Nombre de categoría del almacén

Aplicar impuestos
applyTax boolean

Este contenedor solo es aplicable y se usa si se aplicará una tabla de impuestos de ventas, una tasa de impuestos Value-Added o un código de categoría de excepción fiscal a la oferta.

Categoría fiscal de terceros
thirdPartyTaxCategory string

Código de categoría de excepción fiscal. Si se usa este campo, el impuesto sobre las ventas también se aplicará a un servicio/tarifa, y no solo al precio del artículo.

Porcentaje de IVA
vatPercentage number

Este valor es el tipo de IVA del artículo, si existe. Cuando se especifica un porcentaje de IVA, la información del IVA del artículo aparece en la página Ver elemento de la lista.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de oferta
offerId string

Identificador único de la oferta

Advertencias
warnings array of object

Este contenedor devolverá cuando se realice una llamada y se produzcan errores o advertencias.

Categoría
warnings.category string

Este valor de cadena indica la categoría de error.

Dominio
warnings.domain string

Nombre de dominio en el que se produjo el error o la advertencia.

Identificador de error
warnings.errorId integer

Código único que identifica el error o la advertencia concretos que se produjeron.

inputRefIds
warnings.inputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de solicitud específicos más estrechamente asociados al error o advertencia, si los hay.

Mensaje largo
warnings.longMessage string

Descripción detallada de la condición que provocó el error o la advertencia e información sobre qué hacer para corregir el problema.

Message
warnings.message string

Descripción de la condición que provocó el error o la advertencia.

outputRefIds
warnings.outputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de respuesta específicos más estrechamente asociados al error o advertencia, si los hay.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la advertencia.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain string

Nombre del subdominio en el que se produjo el error o la advertencia.

Crear ubicación de inventario

Use esta llamada para crear una nueva ubicación de inventario. Para crear y publicar una oferta, un vendedor debe tener al menos una ubicación de inventario, ya que cada oferta debe estar asociada a una ubicación.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de ubicación del comerciante
merchantLocationKey True string

Clave única definida por el comerciante para una ubicación de inventario.

Línea de dirección 1
addressLine1 string

Primera línea de una dirección postal.

Línea de dirección 2
addressLine2 string

Segunda línea de una dirección postal.

City
city string

Ciudad en la que reside la ubicación del inventario.

País
country string

Código de país en el que reside la dirección.

Provincia
county string

Condado en el que reside la dirección.

Código postal
postalCode string

Código postal o postal de la dirección.

Estado o provincia
stateOrProvince string

Estado o provincia en el que reside la ubicación del inventario.

Latitude
latitude string

Componente de latitud de la coordenada geográfica.

Longitude
longitude string

Componente de longitud de la coordenada geográfica.

Información adicional de ubicación
locationAdditionalInformation string

Información adicional sobre una ubicación de inventario.

Instrucciones de ubicación
locationInstructions string

Instrucciones de recogida especiales para una ubicación de inventario de tiendas.

locationTypes
locationTypes array of string

Tipos de ubicación

Dirección URL web de ubicación
locationWebUrl string

Dirección del sitio web asociada a la ubicación del inventario.

Estado de la ubicación del comerciante
merchantLocationStatus string

El estado de la ubicación del inventario podría estar habilitado o deshabilitado.

Nombre
name string

Nombre de la ubicación del inventario.

Día de la semana
dayOfWeekEnum string

Día en que la ubicación de la tienda tiene horas de funcionamiento normales.

cerrar
close string

Hora de cierre de la tienda.

abrir
open string

Hora de apertura de la tienda.

Teléfono
phone string

Número de teléfono de una ubicación de inventario de la tienda.

Fecha
date string

Valor de fecha específico que la ubicación del almacén tiene horas de funcionamiento especiales.

cerrar
close string

Hora de cierre de la tienda.

abrir
open string

Hora de apertura de la tienda.

Devoluciones

response
string

Elemento de inventario GET

Esta llamada recupera el registro de elementos de inventario de una SKU determinada.

Parámetros

Nombre Clave Requerido Tipo Description
SKU
sku True string

Valor definido por el vendedor del producto cuyo registro de artículos de inventario desea recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
PickupAtLocationAvailability
availability.pickupAtLocationAvailability array of object

Este contenedor consta de una matriz de tiendas físicas del comerciante donde el artículo de inventario está disponible para la recogida en la tienda.

Tipo de disponibilidad
availability.pickupAtLocationAvailability.availabilityType string

Este campo indica el estado de disponibilidad del elemento de inventario en el almacén físico del comerciante.

Unidad
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

El valor indica la unidad de tiempo utilizada para especificar el tiempo de suministro.

Importancia
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

El valor entero de este campo, junto con la unidad de tiempo del campo unidad, indicará el tiempo de cumplimiento.

Clave de ubicación del comerciante
availability.pickupAtLocationAvailability.merchantLocationKey string

Identificador único de la tienda del comerciante en el que se encuentra actualmente el In-Store artículo de inventario de recogida, o se enviará a.

Cantidad
availability.pickupAtLocationAvailability.quantity integer

Este valor entero indica la cantidad del elemento de inventario que está disponible para In-Store Recogida.

Subasta
availability.shipToLocationAvailability.allocationByFormat.auction integer

Este valor entero indica la cantidad del elemento de inventario reservado para las ofertas de formato de subasta publicadas de la SKU.

Precio fijo
availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Este valor entero indica la cantidad del elemento de inventario que está disponible para las ofertas de precio fijo de la SKU.

AvailabilityDistributions
availability.shipToLocationAvailability.availabilityDistributions array of object

Este contenedor se usa para establecer la cantidad disponible del elemento de inventario en una o varias ubicaciones de almacenamiento.

Unidad
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

El valor indica la unidad de tiempo utilizada para especificar el tiempo de suministro.

Importancia
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

El valor entero de este campo, junto con la unidad de tiempo del campo unidad, indicará el tiempo de cumplimiento.

Clave de ubicación del comerciante
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

Identificador único de una ubicación de inventario donde la cantidad está disponible para el elemento de inventario.

Cantidad
availability.shipToLocationAvailability.availabilityDistributions.quantity integer

Cantidad del elemento de inventario que está disponible en esta ubicación de inventario.

Cantidad
availability.shipToLocationAvailability.quantity integer

Este contenedor se usa para establecer la cantidad total de "envío a casa" del artículo de inventario que estará disponible para su compra a través de una o varias ofertas publicadas.

Condición
condition string

Este valor indica la condición del elemento.

Descripción de la condición
conditionDescription string

El vendedor usa este campo de cadena para describir con más claridad la condición de los elementos usados, o los elementos que no son "Brand New", "New with tags" (Nuevo con etiquetas) o "New in box" (Nuevo en el cuadro).

identificadores de grupo
groupIds array of string
inventoryItemGroupKeys
inventoryItemGroupKeys array of string

Esta matriz se devuelve si el elemento de inventario está asociado a cualquier grupo de elementos de inventario.

Configuración regional
locale string

Este campo devuelve el lenguaje natural que se proporcionó en los valores de campo de la carga de la solicitud.

Altura
packageWeightAndSize.dimensions.height number

Alto real del paquete de envío.

Length
packageWeightAndSize.dimensions.length number

Longitud real del paquete de envío.

Unidad
packageWeightAndSize.dimensions.unit string

Unidad de medida utilizada para especificar las dimensiones de un paquete de envío.

Ancho
packageWeightAndSize.dimensions.width number

Ancho real del paquete de envío.

Tipo de paquete
packageWeightAndSize.packageType string

Este valor indica el tipo de paquete de envío usado para enviar el artículo de inventario.

Unidad
packageWeightAndSize.weight.unit string

Unidad de medida utilizada para especificar el peso de un paquete de envío.

Importancia
packageWeightAndSize.weight.value number

Peso real del paquete de envío.

Aspectos
product.aspects object

Se trata de una colección de pares de nombre-valor específicos de los artículos que proporcionan más información sobre el producto y podría facilitar la búsqueda de compradores.

Marca
product.brand string

La marca del producto.

Description
product.description string

Descripción del producto.

Ean
product.ean array of string

Número de artículo europeo/Número de artículo internacional (EAN) para el producto.

ePID
product.epid string

Identificador de producto de eBay (ePID) para el producto.

imageUrls
product.imageUrls array of string

Matriz de uno o varios vínculos a imágenes para el producto.

ISBN
product.isbn array of string

Valor de número de libro estándar internacional para el producto.

MPN
product.mpn string

Número de pieza del fabricante (MPN) de un producto.

Subtítulo
product.subtitle string

Un subtítulo es una característica de descripción opcional que permite al vendedor proporcionar más información sobre el producto, posiblemente incluyendo palabras clave que pueden ayudar con los resultados de búsqueda.

Title
product.title string

El título de un elemento de inventario se puede agregar o modificar con una llamada createOrReplaceInventoryItem.

Upc
product.upc array of string

Valor de número de libro estándar internacional para el producto.

videoIds
product.videoIds array of string

Matriz de uno o varios valores de VideoId para el producto.

SKU
sku string

Unidad de Stock-Keeping definida por el vendedor (SKU) del elemento de inventario. El vendedor debe tener un valor de SKU único para cada producto que venda.

Eliminar oferta

Esta llamada eliminará permanentemente la oferta.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de oferta
offerId True string

Identificador único de la oferta que se va a eliminar.

Devoluciones

response
string

GET Offer

Esta llamada recupera una oferta publicada o no publicada específica.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de oferta
offerId True string

Identificador único de la oferta que se va a recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Cantidad disponible
availableQuantity integer

Cantidad del artículo de inventario que estará disponible para su compra por parte de los compradores.

Id. de categoría
categoryId string

Identificador único de la categoría principal de eBay en la que aparece el artículo de inventario.

Id. de caridad
charity.charityId string

Identificador único asignado por eBay de la organización caritativa que recibirá un porcentaje de las ganancias de ventas.

Porcentaje de donación
charity.donationPercentage string

Porcentaje de precio de compra que la organización benéfica recibirá por cada venta que genere la descripción.

Identificador de producto del productor
extendedProducerResponsibility.producerProductId string

Identificador único del productor relacionado con el elemento.

Id. del paquete del producto
extendedProducerResponsibility.productPackageId string

Identificador único del productor de cualquier embalaje relacionado con el producto agregado por el vendedor.

Id. de paquete de envío
extendedProducerResponsibility.shipmentPackageId string

Identificador único del productor de cualquier embalaje utilizado por el vendedor para enviar el artículo.

Id. de documentación del producto
extendedProducerResponsibility.productDocumentationId string

Identificador único del productor de cualquier papel añadido al paquete del artículo por parte del vendedor.

Moneda
extendedProducerResponsibility.ecoParticipationFee.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
extendedProducerResponsibility.ecoParticipationFee.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Formato
format string

Formato de anuncio de la oferta

Ocultar detalles del comprador
hideBuyerDetails boolean

Este campo se devuelve como true si la característica de descripción privada se ha habilitado para la oferta.

Incluir detalles del producto del catálogo
includeCatalogProductDetails boolean

Este campo indica si los detalles del catálogo de productos de eBay se aplican o no a una descripción.

Id. de lista
listing.listingId string

Identificador único de la descripción de eBay asociada a la oferta publicada.

Estado de la lista
listing.listingStatus string

Mostrar el estado asociado a la oferta publicada.

Cantidad vendida
listing.soldQuantity integer

Cantidad de producto que se ha vendido para la oferta publicada.

Descripción de la descripción
listingDescription string

Descripción de la descripción de eBay

Duración de la descripción
listingDuration string

Este campo indica el número de días que la lista estará activa.

Moneda
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Mejor oferta habilitada
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Este contenedor se usa si el vendedor desea admitir la característica Mejor oferta en su descripción.

eBay Plus si es apto
listingPolicies.eBayPlusIfEligible boolean

Este campo se incluye en una oferta si un vendedor de Top-Rated participa en el programa eBay Plus.

Identificador de directiva de cumplimiento
listingPolicies.fulfillmentPolicyId string

Identificador único indica la directiva de negocio de cumplimiento que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificador de directiva de pago
listingPolicies.paymentPolicyId string

El identificador único indica la política comercial de pago que se usará una vez publicada una oferta y convertida en una descripción de eBay.

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

Este campo contiene una matriz de hasta cinco identificadores que especifican las directivas de cumplimiento creadas por el vendedor para la lista.

Id. de directiva de devolución
listingPolicies.returnPolicyId string

El identificador único indica la política de devolución de negocios que se usará una vez publicada una oferta y convertida en una descripción de eBay.

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

Este contenedor se usa si el vendedor desea invalidar los costos de envío de una o varias opciones de servicio de envío nacionales o internacionales definidas en la directiva de lista de cumplimiento.

Moneda
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
listingPolicies.shippingCostOverrides.additionalShippingCost.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Priority
listingPolicies.shippingCostOverrides.priority integer

El valor entero que se introduce en este campo, junto con el valor shippingServiceType, establece qué opción de servicio de envío nacional o internacional en la directiva de suministro se modificará con los costos de envío actualizados.

Moneda
listingPolicies.shippingCostOverrides.shippingCost.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
listingPolicies.shippingCostOverrides.shippingCost.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Tipo de servicio de envío
listingPolicies.shippingCostOverrides.shippingServiceType string

Este valor indica si el servicio de envío es una opción de servicio de envío nacional o internacional.

Id. de directiva de devolución
listingPolicies.takeBackPolicyId string

Id. de vendedor creado para la directiva de devolución.

Fecha de inicio de la lista
listingStartDate string

Esta marca de tiempo es la fecha y hora en que el vendedor estableció para la lista programada.

Tamaño de lote
lotSize integer

Este campo solo es aplicable si la lista es mucho listado. Una lista de lotes es una lista que tiene varias cantidades del mismo producto.

Identificador de Marketplace
marketplaceId string

Identificador único del sitio de eBay en el que la oferta está disponible o estará disponible.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la ubicación del inventario.

Id. de oferta
offerId string

Identificador único de la oferta.

Moneda
pricingSummary.auctionReservePrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
pricingSummary.auctionReservePrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
pricingSummary.auctionStartPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
pricingSummary.auctionStartPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
pricingSummary.minimumAdvertisedPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
pricingSummary.minimumAdvertisedPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Se vende originalmente por precio de venta al por menor
pricingSummary.originallySoldForRetailPriceOn string

Este campo es necesario si la característica Precios de tachado se usará en la oferta. Este campo indica que el producto se vendió por el precio en el campo retailPrice original en un sitio de eBay, o que se vendió por ese precio por un minorista de terceros.

Moneda
pricingSummary.originalRetailPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
pricingSummary.originalRetailPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
pricingSummary.price.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
pricingSummary.price.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Visibilidad de precios
pricingSummary.pricingVisibility string

Este campo es necesario si la característica Precio anunciado mínimo se usará en la oferta.

Límite de cantidad por comprador
quantityLimitPerBuyer integer

Este campo solo es aplicable si el vendedor desea establecer una restricción en la cantidad de compra de un artículo de inventario por vendedor.

Id. de categoría secundaria
secondaryCategoryId string

Identificador único de una categoría secundaria y aplicable si el vendedor decide enumerar el elemento en dos categorías.

SKU
sku string

Valor de SKU definido por el vendedor del producto en la oferta.

Estado
status string

El valor especifica el estado de la oferta.

Nombres de categoría de la tienda
storeCategoryNames array of string

Nombre de categoría del almacén

Aplicar impuestos
tax.applyTax boolean

Este campo se incluirá si el vendedor desea hacer referencia a su impuesto sobre ventas de nivel de cuenta

Categoría fiscal de terceros
tax.thirdPartyTaxCategory string

Código de categoría de excepción fiscal. Si se usa este campo, el impuesto sobre las ventas también se aplicará a un servicio/tarifa, y no solo al precio del artículo.

Porcentaje de IVA
tax.vatPercentage number

Este valor es el tipo de IVA del artículo, si existe. Cuando se especifica un porcentaje de IVA, la información del IVA del artículo aparece en la página Ver elemento de la lista.

Obtención de la ubicación del inventario

Esta llamada recupera todos los detalles definidos de la ubicación del inventario especificada por el parámetro de ruta de acceso merchantLocationKey.

Parámetros

Nombre Clave Requerido Tipo Description
Clave de ubicación del comerciante
merchantLocationKey True string

Clave (ID) única definida por el comerciante para una ubicación de inventario.

Devoluciones

Nombre Ruta de acceso Tipo Description
Línea de dirección 1
location.address.addressLine1 string

Primera línea de una dirección postal.

Línea de dirección 2
location.address.addressLine2 string

Segunda línea de una dirección postal.

Ciudad
location.address.city string

Ciudad en la que reside la ubicación del inventario.

País
location.address.country string

Código de país en el que reside la dirección

Provincia
location.address.county string

Condado en el que reside la dirección.

Código postal
location.address.postalCode string

Código postal o postal de la dirección.

Estado o provincia
location.address.stateOrProvince string

Estado o provincia en el que reside la ubicación del inventario.

Latitude
location.geoCoordinates.latitude string

Componente de latitud de la coordenada geográfica.

Longitude
location.geoCoordinates.longitude string

Componente de longitud de la coordenada geográfica.

Id. de ubicación
location.locationId string

Identificador único asignado a eBay para la ubicación.

Información adicional de ubicación
locationAdditionalInformation string

Este campo de texto proporciona información adicional sobre una ubicación de inventario.

Instrucciones de ubicación
locationInstructions string

El comerciante utiliza el campo para proporcionar instrucciones de recogida especiales para la ubicación de la tienda.

locationTypes
locationTypes array of string

Este contenedor define la función de la ubicación del inventario.

Dirección URL web de ubicación
locationWebUrl string

El campo muestra la dirección del sitio web asociada a la ubicación del inventario.

Clave de ubicación del comerciante
merchantLocationKey string

Identificador único de la ubicación del inventario.

Estado de la ubicación del comerciante
merchantLocationStatus string

El campo indica si la ubicación del inventario está habilitada o deshabilitada.

Nombre
name string

Nombre de la ubicación del inventario.

operatingHours
operatingHours array of object

Este contenedor muestra las horas de funcionamiento normales de una ubicación de almacén durante los días de la semana.

Enumeración de semana
operatingHours.dayOfWeekEnum string

Se requiere un valor para cada día de la semana que la ubicación de la tienda tiene horas de funcionamiento normales.

Intervalos
operatingHours.intervals array of object

Este contenedor se usa para definir las horas de apertura y cierre del día laborable de un almacén.

cerrar
operatingHours.intervals.close string

cerrar

abrir
operatingHours.intervals.open string

abrir

Teléfono
phone string

Número de teléfono de una ubicación de inventario.

SpecialHours
specialHours array of object

Este contenedor muestra las horas de funcionamiento especiales de una ubicación de almacén en una fecha o fechas específicas.

Fecha
specialHours.date string

Se requiere un valor de fecha para cada fecha específica en la que la ubicación del almacén tenga horas de funcionamiento especiales.

Intervalos
specialHours.intervals array of object

Este contenedor se usa para definir las horas de apertura y cierre de un almacén en una fecha específica.

cerrar
specialHours.intervals.close string

cerrar

abrir
specialHours.intervals.open string

abrir

Obtener aspectos del elemento para la categoría

Esta llamada devuelve una lista de aspectos adecuados o necesarios para describir con precisión los elementos de la categoría hoja especificada. Cada aspecto identifica un atributo de elemento (por ejemplo, color) para el que el vendedor será obligatorio o se recomienda proporcionar un valor (o valores de variación) al ofrecer un artículo en esa categoría en eBay.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de árbol de categoría
category_tree_id True string

Árbol de categorías eBay Id. único desde el que se solicitan los aspectos de la categoría especificada.

Id. de categoría
category_id True string

Identificador único de categoría hoja para los que se solicitan aspectos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Aspectos
aspects array of object

Lista de aspectos de elementos adecuados para describir elementos en una categoría hoja determinada

Aspecto aplicable a
aspects.aspectConstraint.aspectApplicableTo array of string

Este valor indica si el aspecto identificado por el campo aspects.localizedAspectName es un aspecto del producto o un aspecto de elemento o instancia, que es un aspecto cuyo valor variará en función de una instancia determinada del producto.

Tipo de datos de aspecto
aspects.aspectConstraint.aspectDataType string

Tipo de datos de aspecto.

Aspecto habilitado para variaciones
aspects.aspectConstraint.aspectEnabledForVariations boolean

Un valor true indica que este aspecto se puede usar para ayudar a identificar las variaciones de elementos.

Formato de aspecto
aspects.aspectConstraint.aspectFormat string

Se devuelve solo si el valor de aspectDataType identifica un tipo de datos que requiere formato específico.

Longitud máxima de aspecto
aspects.aspectConstraint.aspectMaxLength integer

Longitud máxima del valor del aspecto del elemento.

Modo de aspecto
aspects.aspectConstraint.aspectMode string

La manera en que el vendedor debe especificar los valores de este aspecto.

Aspecto requerido
aspects.aspectConstraint.aspectRequired boolean

Un valor true indica que este aspecto es necesario al ofrecer elementos en la categoría especificada.

Uso de aspecto
aspects.aspectConstraint.aspectUsage string

El valor indica si se recomienda o opcional el aspecto correspondiente.

Se esperaba requerido por fecha
aspects.aspectConstraint.expectedRequiredByDate string

Fecha esperada después de la cual se requerirá el aspecto.

Elemento a la cardinalidad de aspecto
aspects.aspectConstraint.itemToAspectCardinality string

Indica si este aspecto puede aceptar valores únicos o múltiples para los elementos de la categoría especificada.

aspectValues
aspects.aspectValues array of object

Lista de valores válidos junto con las restricciones de este aspecto.

localizedValue
aspects.aspectValues.localizedValue string

Valor localizado de este aspecto.

valueConstraints
aspects.aspectValues.valueConstraints array of object

Contiene una lista de las dependencias que identifican cuándo el valor del campo localizedValue está disponible para el aspecto actual.

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

Nombre del aspecto del control en el que depende el valor de aspecto actual.

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

Contiene una lista de los valores del aspecto del control en el que depende el valor de este aspecto.

Nombre de aspecto localizado
aspects.localizedAspectName string

Nombre localizado de este aspecto.

Recuento de búsquedas
aspects.relevanceIndicator.searchCount integer

Número de búsquedas recientes para el aspecto.

Obtener directiva de cumplimiento

Este método recupera los detalles completos de una directiva de cumplimiento. Proporcione el identificador de la directiva que desea recuperar mediante el parámetro de ruta de acceso fulfillmentPolicyId.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de directiva de cumplimiento
fulfillmentPolicyId True string

Identificador de directiva de cumplimiento que desea recuperar

Devoluciones

Nombre Ruta de acceso Tipo Description
categoryTypes
categoryTypes array of object

Este contenedor indica si la directiva de cumplimiento se aplica a los listados de vehículos motores o a los listados de vehículos no motores.

Nombre
categoryTypes.name string

Nombre de tipo de categoría al que se aplica la directiva.

Description
description string

Descripción definida por el vendedor de la directiva de cumplimiento. Esta descripción solo es para uso del vendedor y no se expone en ninguna página de eBay.

Envío de mercancías
freightShipping boolean

Si se devuelve como true, el vendedor ofrece envío de mercancías.

PolicyId de cumplimiento
fulfillmentPolicyId string

Identificador único asignado a eBay para la directiva de cumplimiento.

Envío global
globalShipping boolean

Si se devuelve como true, el vendedor usará el programa de envío global de eBay para enviar artículos a ubicaciones internacionales.

Unidad
handlingTime.unit string

Se define un intervalo de tiempo cuando se aplica el valor especificado en el campo de valor al valor especificado para la unidad.

Importancia
handlingTime.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Recogida local
localPickup boolean

Si se devuelve como true, la recogida local está disponible para esta directiva.

Identificador de Marketplace
marketplaceId string

Id. de marketplace de eBay al que se aplica esta directiva de cumplimiento.

Nombre
name string

Nombre único definido por el vendedor para esta directiva de cumplimiento.

Entrega de recogida
pickupDropOff boolean

Si se devuelve como true, el vendedor ofrece la opción "Hacer clic y recopilar".

shippingOptions
shippingOptions array of object

Esta matriz se utiliza para proporcionar información detallada sobre las opciones de envío nacionales e internacionales disponibles para la política.

Tipo coste
shippingOptions.costType string

Este campo define si el modelo de costo de envío es FLAT_RATE o CALCULATED

Tipo de opción
shippingOptions.optionType string

Este campo se usa para indicar si las opciones de servicio de envío correspondientes son nacionales o internacionales.

Moneda
shippingOptions.packageHandlingCost.currency string

Moneda base aplicada al campo de valor para establecer una cantidad monetaria.

Importancia
shippingOptions.packageHandlingCost.value string

Importe monetario en la moneda especificada.

Id. de tabla de frecuencia
shippingOptions.rateTableId string

Este campo se utiliza si el vendedor quiere asociar una tabla de tarifas de envío nacional o internacional a la política comercial de cumplimiento.

shippingServices
shippingOptions.shippingServices array of object

Esta matriz consta de las opciones de servicios de envío nacionales o internacionales que se definen para la política.

divisa
shippingOptions.shippingServices.additionalShippingCost.currency string

divisa

value
shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

Este campo debe incluirse para una lista de vehículos de motor si será responsabilidad del comprador recoger el vehículo de motor comprado después de que se realice el pago completo.

buyerResponsibleForShipping
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

Este campo debe incluirse para una lista de vehículos motores si será responsabilidad del comprador organizar el envío de un vehículo de motor comprado después de que se realice el pago completo.

divisa
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

divisa

value
shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
shippingOptions.shippingServices.freeShipping boolean

Este campo se incluye si el vendedor ofrece una opción de envío gratuita al comprador.

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

Este campo establece o indica el transportista de envío.

divisa
shippingOptions.shippingServices.shippingCost.currency string

divisa

value
shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

Este campo establece o indica la opción de servicio de envío nacional o internacional.

regionExcluded
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
shippingOptions.shippingServices.sortOrder integer

El valor entero establecido en este campo controla el orden del servicio de envío.

regionExcluded
shipToLocations.regionExcluded array of object

Matriz de valores regionName que especifican las áreas en las que un vendedor no se envía.

Nombre de la región
shipToLocations.regionExcluded.regionName string

Cadena que indica el nombre de una región, tal como se define en eBay.

Tipo de región
shipToLocations.regionExcluded.regionType string

Reservado para uso futuro.

regionIncluded
shipToLocations.regionIncluded array of object

Matriz de campos regionName que especifican las áreas en las que se distribuye un vendedor.

Nombre de la región
shipToLocations.regionIncluded.regionName string

Cadena que indica el nombre de una región, tal como se define en eBay.

Tipo de región
shipToLocations.regionIncluded.regionType string

Reservado para uso futuro.

Obtener directiva de devolución

Este método recupera los detalles completos de la directiva de retorno especificada por el parámetro de ruta de acceso returnPolicyId.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de directiva de devolución
return_policy_id True string

Devuelve el identificador de directiva que desea recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
categoryTypes
categoryTypes array of object

Este contenedor indica a qué grupo de categorías se aplica la directiva de devolución.

Nombre
categoryTypes.name string

Tipo de categoría al que se aplica la directiva

Description
description string

Descripción definida por el vendedor de la directiva de devolución de negocio.

Return (método)
internationalOverride.returnMethod string

Este campo establece o indica si el vendedor ofrece artículos de reemplazo al comprador en el caso de un retorno internacional.

Unidad
internationalOverride.returnPeriod.unit string

Unidad de medición de tiempo, como DAY.

Importancia
internationalOverride.returnPeriod.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Devuelve aceptado
internationalOverride.returnsAccepted boolean

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Devolución del pago de costos de envío
internationalOverride.returnShippingCostPayer string

Este campo indica quién es responsable de pagar los gastos de envío de los artículos devueltos.

Identificador de Marketplace
marketplaceId string

Id. del marketplace de eBay al que se aplica esta directiva de devolución de negocios.

Nombre
name string

Nombre definido por el vendedor para esta directiva empresarial de pago.

Refund (método)
refundMethod string

Si un vendedor indica que aceptarán devoluciones de comprador, este valor se establecerá en MONEY_BACK.

Instrucciones de devolución
returnInstructions string

Este campo basado en texto proporciona más detalles sobre las instrucciones de devolución especificadas por el vendedor. Este campo solo se devuelve si se establece para la directiva empresarial de devolución.

Return (método)
returnMethod string

Este campo solo se devuelve si el vendedor está dispuesto a ofrecer un artículo de reemplazo como alternativa a "Devolución de dinero"

Unidad
returnPeriod.unit string

Unidad de medición de tiempo, como DAY.

Importancia
returnPeriod.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Id. de directiva de devolución
returnPolicyId string

Id. único asignado a eBay para una directiva de devolución de negocios. Este identificador se genera cuando se crea la directiva.

Devuelve aceptado
returnsAccepted boolean

Si este campo se devuelve como true, el vendedor acepta devoluciones.

Devolución del pago de costos de envío
returnShippingCostPayer string

Este campo indica quién es responsable de pagar los gastos de envío de los artículos devueltos.

Obtener directiva de pago

Este método recupera los detalles completos de una directiva de pago. Proporcione el identificador de la directiva que desea recuperar mediante el parámetro de ruta de acceso paymentPolicyId.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de directiva de pago
payment_policy_id True string

Identificador de directiva de pago que desea recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
categoryTypes
categoryTypes array of object

Este contenedor indica si la directiva de cumplimiento se aplica a los listados de vehículos motores o no motores.

Nombre
categoryTypes.name string

Tipo de categoría al que se aplica la directiva.

Moneda
deposit.amount.currency string

Moneda base aplicada al campo de valor para establecer una cantidad monetaria.

Importancia
deposit.amount.value string

Importe monetario en la moneda especificada.

Unidad
deposit.dueIn.unit string

Unidad de medición de tiempo, como DAY.

Importancia
deposit.dueIn.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Description
description string

Descripción definida por el vendedor de la directiva de pago.

Unidad
fullPaymentDueIn.unit string

Unidad de medición de tiempo, como DAY.

Importancia
fullPaymentDueIn.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Pago inmediato
immediatePay boolean

Si este campo se devuelve como true, se requiere el pago inmediato del comprador.

Identificador de Marketplace
marketplaceId string

Id. del marketplace de eBay al que se aplica la directiva de negocio de pago.

Nombre
name string

Id. del marketplace de eBay al que se aplica la directiva de negocio de pago.

Instrucciones de pago
paymentInstructions string

Aunque este campo se puede devolver para algunas directivas empresariales de pago anteriores, las instrucciones de pago ya no son compatibles con las directivas de negocio de pago.

paymentMethods
paymentMethods array of object

Este contenedor se devuelve para mostrar los métodos de pago que se aceptan para la directiva empresarial de pago.

Tipo de método de pago
paymentMethods.paymentMethodType string

Tipo de método de pago para soporte técnico sin conexión

Identificador de directiva de pago
paymentPolicyId string

Un identificador único asignado a eBay para una directiva de negocio de pago.

Obtener directivas de condición de elemento

Este método devuelve metadatos de condición de artículo en una, varias o todas las categorías de eBay en un marketplace de eBay.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de Marketplace
marketplace_id True string

Id. de marketplace de eBay para el que se recupera la información de la directiva.

Filter
filter string

Limita la respuesta devolviendo información de directiva solo para las secciones seleccionadas del árbol de categorías.

Devoluciones

Nombre Ruta de acceso Tipo Description
itemConditionPolicies
itemConditionPolicies array of object

Lista de identificadores de categoría y directivas para indicar la condición de un elemento en cada una de las categorías enumeradas.

Id. de categoría
itemConditionPolicies.categoryId string

Identificador de categoría al que se aplica la directiva item-condition.

Id. de árbol de categoría
itemConditionPolicies.categoryTreeId string

Valor que indica el nodo raíz del árbol de categorías usado para el conjunto de respuestas.

Condición de elemento requerida
itemConditionPolicies.itemConditionRequired boolean

Esta marca indica si debe mostrar o no la condición de elemento en una lista para la categoría especificada.

itemConditions
itemConditionPolicies.itemConditions array of object

Los valores de condición de elemento permitidos en la categoría.

conditionDescription
itemConditionPolicies.itemConditions.conditionDescription string

Etiqueta legible para la condición.

conditionId
itemConditionPolicies.itemConditions.conditionId string

Valor de identificador de la condición de elemento seleccionado.

usage
itemConditionPolicies.itemConditions.usage string

usage

Advertencias
warnings array of object

Lista de advertencias que se generaron como resultado de la solicitud.

Categoría
warnings.category string

Tipo de categoría para este error o advertencia.

Dominio
warnings.domain string

Nombre de dominio que contiene el servicio o la aplicación.

Identificador de error
warnings.errorId integer

Entero positivo que identifica de forma única la condición de error específica que se produjo.

inputRefIds
warnings.inputRefIds array of string

Identifica elementos de solicitud específicos asociados al error, si existe. La respuesta de inputRefId es específica del formato.

Mensaje largo
warnings.longMessage string

Una versión expandida del mensaje que debe tener aproximadamente entre 100 y 200 caracteres, pero no es necesaria para ser tal.

Message
warnings.message string

Un mensaje independiente del dispositivo para desarrolladores de aplicaciones y usuarios finales.

outputRefIds
warnings.outputRefIds array of string

Identifica elementos de respuesta específicos asociados al error, si los hay.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la advertencia.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain string

Nombre del subsistema o subdivisión del dominio.

Obtener directivas de cumplimiento

Este método recupera todas las directivas de cumplimiento configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de Marketplace
marketplace_id True string

Id. de Marketplace de eBay de las directivas que quieres recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
fulfillmentPolicies
fulfillmentPolicies array of object

Lista de las directivas de cumplimiento del vendedor definidas para el marketplace especificado.

Tipos de categoría
fulfillmentPolicies.categoryTypes array of object

Este contenedor indica si la directiva de cumplimiento se aplica a los listados de vehículos motores o no motores.

nombre
fulfillmentPolicies.categoryTypes.name string

Tipo de categoría al que se aplica la directiva

Description
fulfillmentPolicies.description string

Descripción definida por el vendedor de la directiva de cumplimiento.

Envío de mercancías
fulfillmentPolicies.freightShipping boolean

Si se devuelve como true, el vendedor ofrece envío de flete para artículos grandes de más de 150 lbs.

Identificador de directiva de cumplimiento
fulfillmentPolicies.fulfillmentPolicyId string

Identificador único asignado a eBay para la directiva de cumplimiento.

Envío global
fulfillmentPolicies.globalShipping boolean

Si se devuelve como true, el vendedor usará el programa de envío global de eBay para enviar artículos a ubicaciones internacionales.

Unidad
fulfillmentPolicies.handlingTime.unit string

Unidad de medición de tiempo, como DAY.

Importancia
fulfillmentPolicies.handlingTime.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Recogida local
fulfillmentPolicies.localPickup boolean

Si se devuelve como true, la recogida local está disponible para esta directiva.

Identificador de Marketplace
fulfillmentPolicies.marketplaceId string

Id. del marketplace de eBay al que se aplica esta política de cumplimiento.

Nombre
fulfillmentPolicies.name string

Nombre definido por el vendedor para esta directiva de cumplimiento. Los nombres deben ser únicos para las directivas asignadas al mismo marketplace.

Entrega de recogida
fulfillmentPolicies.pickupDropOff boolean

Si se devuelve como true, el vendedor ofrece la opción "Hacer clic y recopilar".

shippingOptions
fulfillmentPolicies.shippingOptions array of object

La matriz proporciona información detallada sobre las opciones de envío nacionales e internacionales disponibles para la política.

Tipo coste
fulfillmentPolicies.shippingOptions.costType string

Este campo define si el modelo de costo de envío es FLAT_RATE o CALCULATED

Moneda
fulfillmentPolicies.shippingOptions.insuranceFee.currency string

Moneda base aplicada al campo de valor para establecer una cantidad monetaria.

Importancia
fulfillmentPolicies.shippingOptions.insuranceFee.value string

Importe monetario en la moneda especificada.

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

divisa
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

divisa

value
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

value

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

shippingServices
fulfillmentPolicies.shippingOptions.shippingServices array of object

shippingServices

divisa
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

divisa

value
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

value

buyerResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

buyerResponsibleForPickup

buyerResponsibleForShipping
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

buyerResponsibleForShipping

divisa
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

divisa

value
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

value

freeShipping
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

freeShipping

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

divisa
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

divisa

value
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

value

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

regionExcluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regionExcluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType

regionIncluded
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regionIncluded

regionName
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

divisa
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

divisa

value
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

value

Región excluida
fulfillmentPolicies.shipToLocations.regionExcluded array of object

Matriz de valores regionName que especifican las áreas en las que un vendedor no se envía.

regionName
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType

Región incluida
fulfillmentPolicies.shipToLocations.regionIncluded array of object

Matriz de campos regionName que especifican las áreas en las que se distribuye un vendedor.

regionName
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

regionName

regionType
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType

Href
href string

Este campo es para uso futuro.

Limit
limit integer

Este campo es para uso futuro.

Next
next string

Este campo es para uso futuro.

Desplazar
offset integer

Este campo es para uso futuro.

Prev
prev string

Este campo es para uso futuro.

Total
total integer

Número total de directivas de cumplimiento recuperadas en el conjunto de resultados.

Obtener directivas de devolución

Este método recupera todas las directivas de retorno configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de Marketplace
marketplace_id True string

Id. de marketplace de eBay de la directiva que quieres recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Href
href string

Este campo es para uso futuro.

Limit
limit integer

Este campo es para uso futuro.

Next
next string

Este campo es para uso futuro.

Desplazar
offset integer

Este campo es para uso futuro.

Prev
prev string

Este campo es para uso futuro.

returnPolicies
returnPolicies array of object

Lista de las directivas de negocio de devolución del vendedor definidas para el marketplace especificado.

categoryTypes
returnPolicies.categoryTypes array of object

Este contenedor indica a qué grupo de categorías se aplica la directiva de devolución.

nombre
returnPolicies.categoryTypes.name string

nombre

Description
returnPolicies.description string

Descripción definida por el vendedor de la directiva de devolución de negocio.

Return (método)
returnPolicies.internationalOverride.returnMethod string

Este campo establece o indica si el vendedor ofrece artículos de reemplazo al comprador en el caso de un retorno internacional.

Unidad
returnPolicies.internationalOverride.returnPeriod.unit string

Estos valores de enumeración representan la unidad de medida de tiempo, como DAY.

Importancia
returnPolicies.internationalOverride.returnPeriod.value integer

Unidad de medición de tiempo, como DAY.

Devuelve aceptado
returnPolicies.internationalOverride.returnsAccepted boolean

Si se establece en true, el vendedor acepta devoluciones internacionales.

Devolución del pago de costos de envío
returnPolicies.internationalOverride.returnShippingCostPayer string

Este campo indica quién es responsable de pagar los gastos de envío de los artículos devueltos.

Identificador de Marketplace
returnPolicies.marketplaceId string

Id. de marketplace de eBay al que se aplica esta directiva de negocios de retorno.

Nombre
returnPolicies.name string

Nombre definido por el vendedor para esta directiva empresarial de pago.

Refund (método)
returnPolicies.refundMethod string

Si un vendedor indica que aceptarán devoluciones de comprador, este valor se establecerá en MONEY_BACK.

Instrucciones de devolución
returnPolicies.returnInstructions string

Este campo basado en texto proporciona más detalles sobre las instrucciones de devolución especificadas por el vendedor.

Return (método)
returnPolicies.returnMethod string

Este campo solo se devuelve si el vendedor está dispuesto a ofrecer un artículo de reemplazo como alternativa a "Devolución de dinero".

Unidad
returnPolicies.returnPeriod.unit string

Unidad de medición de tiempo, como DAY.

Importancia
returnPolicies.returnPeriod.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Id. de directiva de devolución
returnPolicies.returnPolicyId string

Un identificador único asignado a eBay para una directiva de devolución de negocios.

Devolución aceptada
returnPolicies.returnsAccepted boolean

Si este campo se devuelve como true, el vendedor acepta devoluciones.

Devolución del pago de costos de envío
returnPolicies.returnShippingCostPayer string

Este campo indica quién es responsable de pagar los gastos de envío de los artículos devueltos.

Total
total integer

Número total de directivas empresariales de devolución recuperadas en el conjunto de resultados.

Obtener directivas de pago

Este método recupera todas las directivas de pago configuradas para marketplace que especifique mediante el parámetro de consulta marketplace_id.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de Marketplace
marketplace_id string

Id. de Marketplace de eBay de las directivas que quieres recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Href
href string

Este campo es para uso futuro.

Limit
limit integer

Este campo es para uso futuro.

Next
next string

Este campo es para uso futuro.

Desplazar
offset integer

Este campo es para uso futuro.

paymentPolicies
paymentPolicies array of object

Lista de las directivas de negocio de pago del vendedor definidas para el marketplace especificado.

categoryTypes
paymentPolicies.categoryTypes array of object

Este contenedor indica si la directiva de cumplimiento se aplica a los listados de vehículos motores o no motores.

predeterminado
paymentPolicies.categoryTypes.default boolean

predeterminado

nombre
paymentPolicies.categoryTypes.name string

nombre

Moneda
paymentPolicies.deposit.amount.currency string

Moneda base aplicada al campo de valor para establecer una cantidad monetaria.

Importancia
paymentPolicies.deposit.amount.value string

Importe monetario en la moneda especificada.

Unidad
paymentPolicies.deposit.dueIn.unit string

Estos valores representan la unidad de medida de tiempo, como DAY.

Importancia
paymentPolicies.deposit.dueIn.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Description
paymentPolicies.description string

Descripción definida por el vendedor de la directiva de pago.

Unidad
paymentPolicies.fullPaymentDueIn.unit string

Unidad de medición de tiempo, como DAY.

Importancia
paymentPolicies.fullPaymentDueIn.value integer

Valor de unidad de medición de tiempo especificado en el campo de unidad.

Pago inmediato
paymentPolicies.immediatePay boolean

Si este campo se devuelve como true, se requiere el pago inmediato del comprador.

Identificador de Marketplace
paymentPolicies.marketplaceId string

Id. de marketplace de eBay al que se aplica la directiva de pago de negocios.

Nombre
paymentPolicies.name string

Nombre definido por el vendedor para esta directiva de cumplimiento.

Instrucciones de pago
paymentPolicies.paymentInstructions string

Aunque este campo se puede devolver para algunas directivas empresariales de pago anteriores, las instrucciones de pago ya no son compatibles con las directivas de negocio de pago. Si se devuelve este campo, se puede omitir y estas instrucciones de pago no aparecerán en ninguna lista que use la directiva empresarial correspondiente.

paymentMethods
paymentPolicies.paymentMethods array of object

Este contenedor se devuelve para mostrar los métodos de pago que se aceptan para la directiva empresarial de pago.

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

Tipo de método de pago

Identificador de directiva de pago
paymentPolicies.paymentPolicyId string

Id. único asignado a eBay para una política comercial de pago.

Prev
prev string

Este campo es para uso futuro.

Total
total integer

Número total de directivas empresariales de pago recuperadas en el conjunto de resultados.

Obtener elementos de inventario

Esta llamada recupera todos los registros de elementos de inventario definidos para la cuenta del vendedor.

Parámetros

Nombre Clave Requerido Tipo Description
Limit
limit string

Número máximo de registros que se van a devolver por página de datos.

Desplazar
offset string

Número de página que se va a recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Href
href string

Esta es la dirección URL de la página actual de los elementos de inventario.

inventoryItems
inventoryItems array of object

Este contenedor es una matriz de uno o varios elementos de inventario.

pickupAtLocationAvailability
inventoryItems.availability.pickupAtLocationAvailability array of object

Este contenedor consta de una matriz de tiendas físicas del comerciante donde el artículo de inventario está disponible para la recogida en la tienda.

availabilityType
inventoryItems.availability.pickupAtLocationAvailability.availabilityType string

Estado de disponibilidad del elemento de inventario

unidad
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit string

Unidad de tiempo usada para especificar el tiempo de suministro

value
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

El valor entero de este campo, junto con la unidad de tiempo del campo unidad, indicará el tiempo de cumplimiento.

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

El almacén del comerciante Identificador único donde se encuentra el elemento de inventario de In-Store recogida actualmente, o se enviará a.

quantity
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

quantity

Subasta
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

Este valor entero indica la cantidad del elemento de inventario reservado para las ofertas de formato de subasta publicadas de la SKU.

Precio fijo
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice integer

Este valor indica la cantidad del artículo de inventario que está disponible para las ofertas de precio fijo de la SKU.

availabilityDistributions
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

Este contenedor se usa para establecer la cantidad disponible del elemento de inventario en una o varias ubicaciones de almacenamiento.

unidad
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

unidad

value
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

value

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

quantity
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

quantity

Cantidad
inventoryItems.availability.shipToLocationAvailability.quantity integer

Este contenedor se usa para establecer la cantidad total de "envío a casa" del artículo de inventario que estará disponible para su compra a través de una o varias ofertas publicadas.

Condición
inventoryItems.condition string

Este valor indica la condición del elemento.

Descripción de la condición
inventoryItems.conditionDescription string

El vendedor usa este campo de cadena para describir con más claridad la condición de los elementos.

identificadores de grupo
inventoryItems.groupIds array of string

Esta matriz se devuelve si el elemento de inventario está asociado a cualquier grupo de elementos de inventario.

inventoryItemGroupKeys
inventoryItems.inventoryItemGroupKeys array of string

Esta matriz se devuelve si el elemento de inventario está asociado a cualquier grupo de elementos de inventario.

Configuración regional
inventoryItems.locale string

Este campo devuelve el lenguaje natural que se proporcionó en los valores de campo de la carga de la solicitud.

Altura
inventoryItems.packageWeightAndSize.dimensions.height number

Alto real del paquete de envío.

Length
inventoryItems.packageWeightAndSize.dimensions.length number

Longitud real del paquete de envío.

Unidad
inventoryItems.packageWeightAndSize.dimensions.unit string

Unidad de medida utilizada para especificar las dimensiones de un paquete de envío.

Ancho
inventoryItems.packageWeightAndSize.dimensions.width number

Ancho real del paquete de envío.

Ancho
inventoryItems.packageWeightAndSize.packageType string

Tipo de paquete de envío usado para enviar el artículo de inventario.

Unidad
inventoryItems.packageWeightAndSize.weight.unit string

Unidad de medida utilizada para especificar el peso de un paquete de envío.

Importancia
inventoryItems.packageWeightAndSize.weight.value number

Peso real del paquete de envío.

Aspectos
inventoryItems.product.aspects object

Se trata de una colección de pares de nombre-valor específicos de los artículos que proporcionan más información sobre el producto y podría facilitar la búsqueda de compradores.

Marca
inventoryItems.product.brand string

La marca del producto. Este campo suele estar emparejado con el campo mpn para identificar un producto específico por Número de pieza de fabricación.

Description
inventoryItems.product.description string

Descripción del producto.

Ean
inventoryItems.product.ean array of string

Número de artículo europeo/Número de artículo internacional para el producto.

ePID
inventoryItems.product.epid string

Identificador de producto de eBay (ePID) para el producto.

imageUrls
inventoryItems.product.imageUrls array of string

Matriz de uno o varios vínculos a imágenes para el producto.

ISBN
inventoryItems.product.isbn array of string

Valor de número de libro estándar internacional para el producto.

MPN
inventoryItems.product.mpn string

Fabricante Número de pieza de un producto.

Subtítulo
inventoryItems.product.subtitle string

Un subtítulo es una característica de descripción opcional que permite al vendedor proporcionar más información sobre el producto, posiblemente incluyendo palabras clave que pueden ayudar con los resultados de búsqueda.

Title
inventoryItems.product.title string

El título de un elemento de inventario se puede agregar o modificar

Upc
inventoryItems.product.upc array of string

Valor del código de producto universal para el producto.

videoIds
inventoryItems.product.videoIds array of string

Matriz de uno o varios valores de VideoId para el producto.

SKU
inventoryItems.sku string

Unidad de Stock-Keeping definida por el vendedor del artículo de inventario.

Limit
limit integer

Número de elementos de inventario que se mostrarán en cada página de resultados.

Next
next string

Dirección URL a la página siguiente de los elementos de inventario.

Prev
prev string

Dirección URL a la página anterior de los elementos de inventario.

Tamaño
size integer

Número total de páginas de resultados disponibles.

Total
total integer

Número de artículos de inventario que existen para la cuenta del vendedor.

Obtener sugerencias de categoría

Esta llamada devuelve una matriz de nodos hoja de árbol de categoría en el árbol de categorías especificado que eBay considera que se corresponde más estrechamente con la consulta.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de árbol de categoría
category_tree_id True string

Identificador único del árbol de categorías de eBay para el que se solicitan los nodos sugeridos.

Término de búsqueda
q True string

Término de búsqueda que describe el artículo que se ofrece para la venta.

Devoluciones

Nombre Ruta de acceso Tipo Description
categorySuggestions
categorySuggestions array of object

Contiene detalles sobre una o varias categorías sugeridas que corresponden a las palabras clave proporcionadas.

Id. de categoría
categorySuggestions.category.categoryId string

Identificador único de la categoría eBay dentro de su árbol de categorías.

Nombre de categoría
categorySuggestions.category.categoryName string

Nombre de la categoría identificada por categoryId.

Antecesores de nodo de árbol de categorías
categorySuggestions.categoryTreeNodeAncestors array of object

Matriz de lista ordenada de referencias de categoría que describe la ubicación de la categoría sugerida en el árbol de categorías especificado.

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

Identificador único de la categoría antecesor de eBay.

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

Nombre de la categoría antecesor identificada por categoryId.

categorySubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

La parte href de la llamada getCategorySubtree que recupera el subárbol debajo del nodo de categoría antecesor.

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

Nivel absoluto del nodo de categoría antecesor en la jerarquía de su árbol de categorías.

Nivel de nodo de árbol de categorías
categorySuggestions.categoryTreeNodeLevel integer

Nivel absoluto del nodo de categoría antecesor en la jerarquía de su árbol de categorías.

Relevancia
categorySuggestions.relevancy string

Este campo está reservado para uso interno o futuro.

Id. de árbol de categoría
categoryTreeId string

Identificador único del árbol de categorías de eBay desde el que se devuelven sugerencias.

Versión del árbol de categorías
categoryTreeVersion string

Versión del árbol de categorías identificado por categoryTreeId.

Obtener treeId de categoría predeterminado

Un marketplace de eBay determinado puede usar varios árboles de categoría, pero uno de esos árboles se considera el valor predeterminado para ese marketplace. Esta llamada recupera una referencia al árbol de categorías predeterminado asociado al identificador de marketplace de eBay especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de Marketplace
marketplace_id True string

Id. de Marketplace de eBay para el que se solicita el identificador de árbol de categoría.

Accept-Language
Accept-Language True string

Encabezado usado para indicar el lenguaje natural que el vendedor prefiere para la respuesta.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de árbol de categoría
categoryTreeId string

Id. de árbol de categoría único de eBay para el marketplace especificado.

Versión del árbol de categorías
categoryTreeVersion string

Versión del árbol de categorías identificado por categoryTreeId.

Obtener ubicaciones de inventario

Esta llamada recupera todos los detalles definidos de cada ubicación de inventario asociada a la cuenta del vendedor.

Parámetros

Nombre Clave Requerido Tipo Description
Desplazar
offset string

Especifica el número de ubicaciones que se omitirán en el conjunto de resultados antes de devolver la primera ubicación.

Limit
limit string

Número máximo de registros que se van a devolver por página de datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Href
href string

URI de la página actual de resultados del conjunto de resultados.

Limit
limit integer

Número de elementos devueltos en una sola página del conjunto de resultados.

Next
next string

URI de la siguiente página de resultados.

Desplazar
offset string

Número de resultados omitidos en el conjunto de resultados antes de enumerar el primer resultado devuelto.

Prev
prev string

URI de la página anterior de resultados.

Total
total integer

Número total de elementos recuperados en el conjunto de resultados.

ubicaciones
locations array of object

Matriz de una o varias de las ubicaciones de inventario del comerciante.

Línea de dirección 1
locations.location.address.addressLine1 string

Primera línea de una dirección postal.

Línea de dirección 2
locations.location.address.addressLine2 string

Segunda línea de una dirección postal.

City
locations.location.address.city string

Ciudad en la que reside la ubicación del inventario.

País
locations.location.address.country string

Código de país en el que reside la dirección.

Provincia
locations.location.address.county string

Condado en el que reside la dirección.

Código postal
locations.location.address.postalCode string

Código postal o postal de la dirección.

Estado o provincia
locations.location.address.stateOrProvince string

Estado o provincia en el que reside la ubicación del inventario.

Latitude
locations.location.geoCoordinates.latitude string

Componente de latitud de la coordenada geográfica.

Longitude
locations.location.geoCoordinates.longitude string

Componente de longitud de la coordenada geográfica.

Id. de ubicación
locations.location.locationId string

Identificador único asignado a eBay para la ubicación.

Información adicional de ubicación
locations.locationAdditionalInformation string

Este campo proporciona información adicional sobre una ubicación de inventario.

Instrucciones de ubicación
locations.locationInstructions string

Este campo lo usa el comerciante para proporcionar instrucciones de recogida especiales para la ubicación de la tienda.

locationTypes
locations.locationTypes array of string

Este contenedor define la función de la ubicación del inventario.

Dirección URL web de ubicación
locations.locationWebUrl string

Este campo muestra la dirección del sitio web asociada a la ubicación del inventario.

Clave de ubicación del comerciante
locations.merchantLocationKey string

Identificador único de la ubicación del inventario.

Estado de la ubicación del comerciante
locations.merchantLocationStatus string

Este campo indica si la ubicación del inventario está habilitada o deshabilitada.

Nombre
locations.name string

Nombre de la ubicación del inventario.

operatingHours
locations.operatingHours array of object

Este contenedor muestra las horas de funcionamiento normales de una ubicación de almacén durante los días de la semana.

dayOfWeekEnum
locations.operatingHours.dayOfWeekEnum string

dayOfWeekEnum

Intervalos
locations.operatingHours.intervals array of object

Este contenedor se usa para definir las horas de apertura y cierre del día laborable de un almacén.

cerrar
locations.operatingHours.intervals.close string

cerrar

abrir
locations.operatingHours.intervals.open string

abrir

Teléfono
locations.phone string

Número de teléfono de una ubicación de inventario.

specialHours
locations.specialHours array of object

Este contenedor muestra las horas de funcionamiento especiales de una ubicación de almacén en una fecha o fechas específicas.

date
locations.specialHours.date string

date

Intervalos
locations.specialHours.intervals array of object

Este contenedor se usa para definir las horas de apertura y cierre de un almacén en una fecha específica.

cerrar
locations.specialHours.intervals.close string

cerrar

abrir
locations.specialHours.intervals.open string

abrir

Ofertas GET

Esta llamada recupera todas las ofertas existentes para el valor de SKU especificado. El vendedor tiene la opción de limitar las ofertas que se recuperan a un marketplace de eBay específico o a un formato de descripción.

Parámetros

Nombre Clave Requerido Tipo Description
SKU
sku True string

Valor de SKU definido por el vendedor

Identificador de Marketplace
marketplace_id string

Identificador único del marketplace de eBay.

Formato
format string

Formato de descripción de la oferta.

Limit
limit string

Número máximo de registros que se van a devolver por página de datos.

Desplazar
offset string

Número de página que se va a recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Href
href string

Dirección URL a la página actual de ofertas.

Limit
limit integer

Número de ofertas que se mostrarán en cada página de resultados.

Next
next string

Dirección URL a la página siguiente de ofertas.

offers
offers array of object

Este contenedor es una matriz de una o varias ofertas del vendedor para el valor de SKU.

Cantidad disponible
offers.availableQuantity integer

Cantidad de artículos de inventario que estará disponible para su compra.

Id. de categoría
offers.categoryId string

eBay category unique ID that the inventory item is listed under.

Id. de caridad
offers.charity.charityId string

Identificador único asignado por eBay de la organización caritativa que recibirá un porcentaje de las ganancias de ventas.

Porcentaje de donación
offers.charity.donationPercentage string

Porcentaje de precio de compra que la organización benéfica recibirá para cada venta.

Identificador de producto del productor
offers.extendedProducerResponsibility.producerProductId string

Identificador único del productor relacionado con el elemento.

Id. del paquete del producto
offers.extendedProducerResponsibility.productPackageId string

Identificador único del producto empaquetado agregado por el vendedor.

Id. de paquete de envío
offers.extendedProducerResponsibility.shipmentPackageId string

Identificador único del productor de cualquier embalaje utilizado por el vendedor para enviar el artículo.

Id. de documentación del producto
offers.extendedProducerResponsibility.productDocumentationId string

Identificador único del productor de cualquier papel añadido al paquete del artículo por parte del vendedor.

Moneda
offers.extendedProducerResponsibility.ecoParticipationFee.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.extendedProducerResponsibility.ecoParticipationFee.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Formato
offers.format string

Este valor establece el formato de lista de la oferta.

Ocultar detalles del comprador
offers.hideBuyerDetails boolean

Este campo se devuelve como true si la característica de descripción privada se ha habilitado para la oferta.

Incluir detalles del producto del catálogo
offers.includeCatalogProductDetails boolean

Este campo indica si los detalles del catálogo de productos de eBay se aplican o no a una descripción.

Id. de lista
offers.listing.listingId string

Identificador único de la descripción de eBay asociada a la oferta publicada.

Estado de la lista
offers.listing.listingStatus string

Mostrar el estado asociado a la oferta publicada.

Cantidad vendida
offers.listing.soldQuantity integer

Cantidad de producto que se ha vendido para la oferta publicada.

Descripción de la descripción
offers.listingDescription string

Descripción de la descripción de eBay.

Duración de la descripción
offers.listingDuration string

Indica el número de días que la lista estará activa.

Moneda
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Mejor oferta habilitada
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Este campo indica si la característica Mejor oferta está habilitada o no para la lista.

eBay Plus si es apto
offers.listingPolicies.eBayPlusIfEligible boolean

Este campo se incluye en una oferta y se establece en true si un vendedor de Top-Rated participa en el programa eBay Plus

Identificador de directiva de cumplimiento
offers.listingPolicies.fulfillmentPolicyId string

Identificador único indica la directiva de negocio de cumplimiento que se usará una vez publicada una oferta y convertida en una descripción de eBay.

Identificador de directiva de pago
offers.listingPolicies.paymentPolicyId string

El identificador único indica la política comercial de pago que se usará una vez publicada una oferta y convertida en una descripción de eBay.

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

Este campo contiene una matriz de hasta cinco identificadores que especifican las directivas de cumplimiento creadas por el vendedor para la lista.

Id. de directiva de devolución
offers.listingPolicies.returnPolicyId string

El identificador único indica la política de devolución de negocios que se usará una vez publicada una oferta y convertida en una descripción de eBay.

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

Este contenedor se utiliza si el vendedor desea invalidar los costos de envío o el suplemento de una o varias opciones de servicio de envío nacionales o internacionales definidas en la directiva de lista de cumplimiento.

divisa
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

divisa

value
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

value

prioridad
offers.listingPolicies.shippingCostOverrides.priority integer

prioridad

divisa
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

divisa

value
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

value

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

Id. de directiva de devolución
offers.listingPolicies.takeBackPolicyId string

Id. de vendedor que creó la directiva de devolución.

Fecha de inicio de la lista
offers.listingStartDate string

Fecha y hora en que el vendedor estableció para la lista programada.

Tamaño de lote
offers.lotSize integer

Este campo solo es aplicable y se devuelve si la lista es mucho listado.

Identificador de Marketplace
offers.marketplaceId string

Identificador único del sitio de eBay en el que la oferta está disponible o estará disponible.

Clave de ubicación del comerciante
offers.merchantLocationKey string

Identificador único de la ubicación del inventario.

Id. de oferta
offers.offerId string

Identificador único de la oferta.

Moneda
offers.pricingSummary.auctionReservePrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.pricingSummary.auctionReservePrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
offers.pricingSummary.auctionStartPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.pricingSummary.auctionStartPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
offers.pricingSummary.minimumAdvertisedPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.pricingSummary.minimumAdvertisedPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Se vende originalmente por precio de venta al por menor
offers.pricingSummary.originallySoldForRetailPriceOn string

Este campo es necesario si la característica Precios de tachado se usará en la oferta. Este campo indica que el producto se vendió por el precio en el campo retailPrice original en un sitio de eBay, o que se vendió por ese precio por un minorista de terceros.

Moneda
offers.pricingSummary.originalRetailPrice.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.pricingSummary.originalRetailPrice.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Moneda
offers.pricingSummary.price.currency string

Valor de cadena de tres dígitos que representa el tipo de moneda.

Importancia
offers.pricingSummary.price.value string

Representación de cadena de un valor de dólar expresado en el campo de moneda.

Visibilidad de precios
offers.pricingSummary.pricingVisibility string

Este campo es necesario si la característica Precio anunciado mínimo se usará en la oferta.

Límite de cantidad por comprador
offers.quantityLimitPerBuyer integer

Este campo solo es aplicable y se establece si el vendedor desea establecer una restricción en la cantidad de compra de un artículo de inventario por vendedor.

Id. de categoría secundaria
offers.secondaryCategoryId string

Identificador único de una categoría secundaria.

SKU
offers.sku string

Valor de SKU definido por el vendedor del producto en la oferta.

Estado
offers.status string

El valor especifica el estado de la oferta.

storeCategoryNames
offers.storeCategoryNames array of string

Este contenedor se devuelve si el vendedor eligió colocar el artículo de inventario en una o dos categorías de tienda eBay que el vendedor ha configurado para su tienda eBay

Aplicar impuestos
offers.tax.applyTax boolean

Este campo se incluirá si el vendedor desea hacer referencia a su tabla fiscal de ventas de nivel de cuenta para calcular los impuestos de ventas de un pedido.

Categoría fiscal de terceros
offers.tax.thirdPartyTaxCategory string

Código de categoría de excepción fiscal.

Porcentaje de IVA
offers.tax.vatPercentage number

Valor de tasa del impuesto añadido (IVA) para el artículo, si existe.

Prev
prev string

Dirección URL a la página anterior de ofertas.

Tamaño
size integer

Número de ofertas que se muestran en la página actual de resultados.

Total
total integer

Número total de ofertas que existen para el valor de SKU especificado.

Publicar oferta

Esta llamada se usa para convertir una oferta no publicada en una oferta publicada o publicar la descripción en directo de eBay. El identificador único de la oferta (offerId) se pasa al final del URI de llamada.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de oferta
offerId True string

Identificador único de la oferta que se va a publicar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de lista
listingId string

Identificador único de la descripción de eBay recién creada.

Advertencias
warnings array of object

Este contenedor se devolverá si había una o varias advertencias asociadas al intento de retirar la oferta.

Categoría
warnings.category string

Este valor de cadena indica la categoría de error.

Dominio
warnings.domain string

Nombre del dominio en el que se produjo el error o la advertencia.

Identificador de error
warnings.errorId integer

Código único que identifica el error o la advertencia concretos que se produjeron.

inputRefIds
warnings.inputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de solicitud específicos más estrechamente asociados al error o advertencia, si los hay.

Mensaje largo
warnings.longMessage string

Descripción detallada de la condición que provocó el error o la advertencia e información sobre qué hacer para corregir el problema.

Message
warnings.message string

Descripción de la condición que provocó el error o la advertencia.

outputRefIds
warnings.outputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de respuesta específicos más estrechamente asociados al error o advertencia, si los hay.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la advertencia.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain string

Nombre del subdominio en el que se produjo el error o la advertencia.

Retirar oferta

Esta llamada se usa para finalizar una lista de variación única asociada a la oferta especificada.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de oferta
offerId True string

Identificador único de la oferta que se va a retirar.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de lista
listingId string

Identificador único de la descripción de eBay asociada a la oferta que se retiró.

Advertencias
warnings array of object

Este contenedor se devolverá si había una o varias advertencias asociadas al intento de retirar la oferta.

Categoría
warnings.category string

Este valor de cadena indica la categoría de error.

Dominio
warnings.domain string

Este valor de cadena indica la categoría de error.

Identificador de error
warnings.errorId integer

Código único que identifica el error o la advertencia concretos que se produjeron.

inputRefIds
warnings.inputRefIds array of string

Matriz de uno o más identificadores de referencia que identifican los elementos de solicitud específicos más estrechamente asociados al error o advertencia, si los hay.

Mensaje largo
warnings.longMessage string

Descripción detallada de la condición que provocó el error o la advertencia e información sobre qué hacer para corregir el problema.

Message
warnings.message string

Descripción de la condición que provocó el error o la advertencia.

outputRefIds
warnings.outputRefIds array of string

Este contenedor se devolverá si había una o varias advertencias asociadas al intento de retirar la oferta.

parameters
warnings.parameters array of object

Varios mensajes de advertencia y error devuelven una o varias variables que contienen información contextual sobre el error o la guerra.

nombre
warnings.parameters.name string

nombre

value
warnings.parameters.value string

value

Subdominio
warnings.subdomain string

Nombre del subdominio en el que se produjo el error o la advertencia.

Definiciones

cuerda / cadena

Este es el tipo de datos básico "string".