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