eBay (Editora Independente) (Pré-visualização)
O eBay é uma empresa multinacional americana de comércio eletrônico que facilita as vendas de consumidor para consumidor e de empresa para consumidor através de seu site.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Artesian Software Technologies LLP |
| URL | https://artesian.io |
| amit.sharma@artesian.io |
| Metadados do conector | |
|---|---|
| Editora | Artesian Software Technologies LLP |
| Sítio Web | https://www.ebay.com/ |
| Política de Privacidade | https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260 |
| Categorias | Comércio; Vendas e CRM |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente - O seu clientId do eBay | cadeia (de caracteres) | Introduza o ID do cliente. | Verdade |
| Segredo do Cliente | securestring | Introduza o segredo do cliente. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar oferta |
Esta chamada atualiza uma oferta existente que pode estar em estado publicado ou não publicado. |
| Criar local de inventário |
Use esta chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter pelo menos um local de inventário, pois cada oferta deve estar associada a um local. |
| Criar oferta |
Esta chamada cria uma oferta para um item de inventário específico em um mercado específico do eBay. |
| Criar ou substituir item de inventário |
Esta chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente. |
| Excluir oferta |
Esta chamada eliminará permanentemente a oferta |
| GET Item de inventário |
Esta chamada recupera o registro de item de inventário para uma determinada SKU. |
| Obtenha políticas de atendimento |
Esse método recupera todas as políticas de atendimento configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id. |
| Obter aspetos do item para a categoria |
Esta chamada retorna uma lista de aspetos que são apropriados ou necessários para descrever com precisão os itens na categoria de folha especificada. Cada aspeto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será solicitado ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay. |
|
Obter categoria padrão Tree |
Um determinado mercado do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse mercado. Esta chamada recupera uma referência à árvore de categorias padrão associada ao ID de mercado do eBay especificado. |
| Obter itens de inventário |
Esta chamada recupera todos os registros de itens de estoque definidos para a conta do vendedor. |
| Obter locais de inventário |
Esta chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor. |
| Obter localização de inventário |
Esta chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey. |
| Obter Política de Atendimento |
Esse método recupera os detalhes completos de uma política de atendimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId. |
| Obter Política de Devoluções |
Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId. |
| Obter Política de Pagamento |
Este método recupera os detalhes completos de uma política de pagamento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho paymentPolicyId. |
| Obter políticas de condição de item |
Esse método retorna metadados de condição de item em uma, várias ou todas as categorias do eBay em um mercado do eBay. |
| Obter Políticas de Devolução |
Esse método recupera todas as políticas de retorno configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id. |
| Obter Políticas de Pagamento |
Esse método recupera todas as políticas de pagamento configuradas para o marketplace especificado usando o parâmetro de consulta marketplace_id. |
| Obter sugestões de categoria |
Esta chamada retorna uma matriz de nós de folha de árvore de categorias na árvore de categorias especificada que são considerados pelo eBay como correspondendo mais estreitamente à consulta. |
| Oferta GET |
Esta chamada recupera uma oferta específica publicada ou não publicada. |
| Ofertas GET |
Esta chamada recupera todas as ofertas existentes para o valor de SKU especificado. O vendedor tem a opção de limitar as ofertas que são recuperadas a um mercado específico do eBay ou a um formato de anúncio. |
| Publicar oferta |
Esta chamada é usada para converter uma oferta não publicada em uma oferta publicada ou listagem ao vivo do eBay. O identificador exclusivo da oferta (offerId) é passado no final do URI de chamada. |
| Retirar Oferta |
Esta chamada é usada para encerrar uma listagem de variação única associada à oferta especificada. |
Atualizar oferta
Esta chamada atualiza uma oferta existente que pode estar em estado publicado ou não publicado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da oferta
|
offerId | True | string |
Identificador exclusivo da oferta que você deseja atualizar. |
|
Quantidade disponível
|
availableQuantity | integer |
Quantidade disponível de estoque para compra. |
|
|
ID da categoria
|
categoryId | string |
ID de categoria único do eBay em que o produto será listado. |
|
|
Id de caridade
|
charityId | string |
ID exclusivo atribuído pelo eBay de organização de caridade que receberá uma porcentagem das receitas de vendas. |
|
|
Percentagem de Doação
|
donationPercentage | string |
Porcentagem do preço de compra que a organização de caridade receberá por cada venda que a listagem gerar. |
|
|
ID do Produto do Produtor
|
producerProductId | string |
Identificador único do produtor relacionado com o item. |
|
|
ID do pacote do produto
|
productPackageId | string |
ID único do produtor da embalagem do produto adicionada pelo vendedor. |
|
|
ID do pacote de envio
|
shipmentPackageId | string |
ID único do produtor de qualquer embalagem usada pelo vendedor para enviar o item. |
|
|
ID da documentação do produto
|
productDocumentationId | string |
Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Este campo é incluído se o vendedor pretender criar um anúncio privado. |
|
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem. |
|
|
Descrição do anúncio
|
listingDescription | string |
Descrição da listagem do eBay. |
|
|
Duração do anúncio
|
listingDuration | string |
Número de dias em que o anúncio estará ativo. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Melhor Oferta Ativada
|
bestOfferEnabled | boolean |
Indica se o recurso Melhor Oferta está ou não habilitado para a listagem. |
|
|
eBay Plus se elegível
|
eBayPlusIfEligible | boolean |
Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus. |
|
|
ID da Política de Cumprimento
|
fulfillmentPolicyId | string |
O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
ID da Política de Pagamento
|
paymentPolicyId | string |
O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
|
Ids da política de conformidade do produto
|
productCompliancePolicyIds | array of string |
Este campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
|
ID da política de devolução
|
returnPolicyId | string |
Devolver o ID exclusivo da política comercial que será usado assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Priority
|
priority | integer |
O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com custos de envio atualizados. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Tipo de Serviço:
|
shippingServiceType | string |
Este valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de transporte nacional ou internacional. |
|
|
Retomar ID da política
|
takeBackPolicyId | string |
ID do vendedor que criou a política de retomada. |
|
|
Data de início do anúncio
|
listingStartDate | string |
Este campo pode ser utilizado se o vendedor pretender especificar uma hora no futuro em que o anúncio ficará ativo no eBay. |
|
|
Tamanho do Lote
|
lotSize | integer |
Este campo só é aplicável se a listagem for uma listagem de lotes. O valor inteiro passado para este campo é o número total de itens no lote. |
|
|
Chave de localização do comerciante
|
merchantLocationKey | string |
Identificador exclusivo da localização do inventário de um comerciante |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Originalmente vendido pelo preço de varejo em
|
originallySoldForRetailPriceOn | string |
Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Visibilidade de preços
|
pricingVisibility | string |
Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à quantidade de compra por vendedor. |
|
|
ID da categoria secundária
|
secondaryCategoryId | string |
ID de categoria secundária única e aplicável se o vendedor decidir listar o item em duas categorias. |
|
|
Nomes de categorias de lojas
|
storeCategoryNames | array of string |
Nomes de categorias de lojas |
|
|
Aplicar Imposto
|
applyTax | boolean |
Esse contêiner só é aplicável e usado se uma tabela de imposto, uma taxa de imposto de Value-Added ou um código de categoria de exceção de imposto forem aplicados à oferta. |
|
|
Categoria de Imposto de Terceiros
|
thirdPartyTaxCategory | string |
O código da categoria de exceção de imposto. Se este campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa, e não apenas ao preço do item. |
|
|
Percentagem de IVA
|
vatPercentage | number |
Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da oferta
|
offerId | string |
Identificador único da oferta |
|
Advertências
|
warnings | array of object |
Esse contêiner retornará quando uma chamada for feita e ocorrerem erros e/ou avisos. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Nome de domínio no qual ocorreu o erro ou aviso. |
|
ID do erro
|
warnings.errorId | integer |
Código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | string |
Nome do subdomínio no qual ocorreu o erro ou aviso. |
Criar local de inventário
Use esta chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter pelo menos um local de inventário, pois cada oferta deve estar associada a um local.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de localização do comerciante
|
merchantLocationKey | True | string |
Chave exclusiva definida pelo comerciante para um local de inventário. |
|
Linha de Endereço 1
|
addressLine1 | string |
Primeira linha de um endereço. |
|
|
Endereço Linha 2
|
addressLine2 | string |
Segunda linha de um endereço. |
|
|
City
|
city | string |
Cidade em que reside o local de inventário. |
|
|
Country
|
country | string |
Código do país de residência. |
|
|
Concelho
|
county | string |
Condado em que o endereço reside. |
|
|
Código Postal
|
postalCode | string |
Código postal/postal da morada. |
|
|
Estado Ou Província
|
stateOrProvince | string |
Estado/província em que reside o local de inventário. |
|
|
Latitude
|
latitude | string |
Componente Latitude da coordenada geográfica. |
|
|
Longitude
|
longitude | string |
Componente de longitude da coordenada geográfica. |
|
|
Informação Adicional de Localização
|
locationAdditionalInformation | string |
Informações adicionais sobre um local de inventário. |
|
|
Instruções de localização
|
locationInstructions | string |
Instruções especiais de recolha para um local de inventário da loja. |
|
|
locationTypes
|
locationTypes | array of string |
Tipos de localização |
|
|
Localização Web Url
|
locationWebUrl | string |
Endereço do site associado ao local do inventário. |
|
|
Status da localização do comerciante
|
merchantLocationStatus | string |
O status do local do inventário pode ser ativado ou desativado. |
|
|
Nome
|
name | string |
Nome do local do inventário. |
|
|
Dia da Semana
|
dayOfWeekEnum | string |
Dia em que o local da loja tem horário normal de funcionamento. |
|
|
fechar
|
close | string |
Hora de fecho da loja. |
|
|
aberto
|
open | string |
Horário de abertura da loja. |
|
|
Telemóvel
|
phone | string |
Número de telefone para um local de inventário da loja. |
|
|
Date
|
date | string |
Valor de data específico que o local da loja tem horário especial de funcionamento. |
|
|
fechar
|
close | string |
Hora de fecho da loja. |
|
|
aberto
|
open | string |
Horário de abertura da loja. |
Devoluções
- response
- string
Criar oferta
Esta chamada cria uma oferta para um item de inventário específico em um mercado específico do eBay.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Quantidade disponível
|
availableQuantity | integer |
Quantidade disponível de estoque para compra. |
|
|
ID da categoria
|
categoryId | string |
ID de categoria único do eBay em que o produto será listado. |
|
|
Id de caridade
|
charityId | string |
ID exclusivo atribuído pelo eBay de organização de caridade que receberá uma porcentagem das receitas de vendas. |
|
|
Percentagem de Doação
|
donationPercentage | string |
Porcentagem do preço de compra que a organização de caridade receberá por cada venda que a listagem gerar. |
|
|
ID do Produto do Produtor
|
producerProductId | string |
Identificador único do produtor relacionado com o item. |
|
|
ID do pacote do produto
|
productPackageId | string |
ID único do produtor da embalagem do produto adicionada pelo vendedor. |
|
|
ID do pacote de envio
|
shipmentPackageId | string |
ID único do produtor de qualquer embalagem usada pelo vendedor para enviar o item. |
|
|
ID da documentação do produto
|
productDocumentationId | string |
Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Formato
|
format | string |
Formato de listagem da oferta. |
|
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Este campo é incluído se o vendedor pretender criar um anúncio privado. |
|
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem. |
|
|
Descrição do anúncio
|
listingDescription | string |
Descrição da listagem do eBay. |
|
|
Duração do anúncio
|
listingDuration | string |
Número de dias em que o anúncio estará ativo. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Melhor Oferta Ativada
|
bestOfferEnabled | boolean |
Indica se o recurso Melhor Oferta está ou não habilitado para a listagem. |
|
|
eBay Plus se elegível
|
eBayPlusIfEligible | boolean |
Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus. |
|
|
ID da Política de Cumprimento
|
fulfillmentPolicyId | string |
O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
ID da Política de Pagamento
|
paymentPolicyId | string |
O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
|
Ids da política de conformidade do produto
|
productCompliancePolicyIds | array of string |
Este campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
|
ID da política de devolução
|
returnPolicyId | string |
Devolver o ID exclusivo da política comercial que será usado assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Priority
|
priority | integer |
O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com custos de envio atualizados. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Tipo de Serviço:
|
shippingServiceType | string |
Este valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de transporte nacional ou internacional. |
|
|
Retomar ID da política
|
takeBackPolicyId | string |
ID do vendedor que criou a política de retomada. |
|
|
Data de início do anúncio
|
listingStartDate | string |
Este campo pode ser utilizado se o vendedor pretender especificar uma hora no futuro em que o anúncio ficará ativo no eBay. |
|
|
Tamanho do Lote
|
lotSize | integer |
Este campo só é aplicável se a listagem for uma listagem de lotes. O valor inteiro passado para este campo é o número total de itens no lote. |
|
|
ID do mercado
|
marketplaceId | string |
ID exclusivo do site do eBay para o qual a oferta será disponibilizada. |
|
|
Chave de localização do comerciante
|
merchantLocationKey | string |
Identificador exclusivo da localização do inventário de um comerciante |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Originalmente vendido pelo preço de varejo em
|
originallySoldForRetailPriceOn | string |
Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Valor
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Visibilidade de preços
|
pricingVisibility | string |
Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à quantidade de compra por vendedor. |
|
|
ID da categoria secundária
|
secondaryCategoryId | string |
ID de categoria secundária única e aplicável se o vendedor decidir listar o item em duas categorias. |
|
|
SKU
|
sku | string |
Valor de SKU definido pelo vendedor do produto que será listado no site do eBay. |
|
|
Nomes de categorias de lojas
|
storeCategoryNames | array of string |
Nome da categoria da loja |
|
|
Aplicar Imposto
|
applyTax | boolean |
Esse contêiner só é aplicável e usado se uma tabela de imposto, uma taxa de imposto de Value-Added ou um código de categoria de exceção de imposto forem aplicados à oferta. |
|
|
Categoria de Imposto de Terceiros
|
thirdPartyTaxCategory | string |
O código da categoria de exceção de imposto. Se este campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa, e não apenas ao preço do item. |
|
|
Percentagem de IVA
|
vatPercentage | number |
Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da oferta
|
offerId | string |
Identificador único da oferta |
|
Advertências
|
warnings | array of object |
Esse contêiner retornará quando uma chamada for feita e ocorrerem erros e/ou avisos. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Nome de domínio no qual ocorreu o erro ou aviso. |
|
ID do erro
|
warnings.errorId | integer |
Código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | string |
Nome do subdomínio no qual ocorreu o erro ou aviso. |
Criar ou substituir item de inventário
Esta chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor definido pelo vendedor para o item de inventário. |
|
Linguagem de conteúdo
|
Content-Language | True | string |
O cabeçalho define a linguagem natural que será usada nos valores de campo da carga útil da solicitação. |
|
Tipo
|
availabilityType | string |
Status de disponibilidade do item de estoque na loja física do comerciante. |
|
|
Unidade
|
unit | string |
Unidade de tempo usada para especificar o tempo de preenchimento. |
|
|
Valor
|
value | integer |
Valor do tempo de cumprimento. |
|
|
Chave de localização do comerciante
|
merchantLocationKey | string |
ID exclusivo da loja do comerciante onde In-Store item de inventário de retirada está atualmente localizado ou para o qual será enviado. |
|
|
Quantidade
|
quantity | integer |
Quantidade de item de estoque disponível para In-Store Pickup. |
|
|
Unidade
|
unit | string |
Unidade de tempo usada para especificar o tempo de preenchimento. |
|
|
Valor
|
value | integer |
Valor do tempo de cumprimento. |
|
|
Chave de localização do comerciante
|
merchantLocationKey | string |
ID exclusivo da loja do comerciante onde In-Store item de inventário de retirada está atualmente localizado ou para o qual será enviado. |
|
|
Quantidade
|
quantity | integer |
Quantidade do item de inventário que está disponível neste local de inventário. |
|
|
Quantidade
|
quantity | integer |
Quantidade total de itens de inventário 'ship-to-home' que estarão disponíveis para compra através de uma ou mais ofertas publicadas. |
|
|
Condition
|
condition | string |
Condição do item. |
|
|
Descrição da condição
|
conditionDescription | string |
Descrição da condição de um item de inventário. |
|
|
Altura
|
height | number |
Altura real do pacote de envio. |
|
|
Length
|
length | number |
Comprimento real do pacote de envio. |
|
|
Unidade
|
unit | string |
A unidade de medida usada para especificar as dimensões de um pacote de envio. |
|
|
Largura
|
width | number |
A largura real do pacote de envio. |
|
|
Tipo de embalagem
|
packageType | string |
Valor do pacote de envio usado para enviar o item de inventário. |
|
|
Unidade
|
unit | string |
A unidade de medida usada para especificar o peso de um pacote de envio. |
|
|
Valor
|
value | number |
O peso real do pacote de envio. |
|
|
Aspetos
|
aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização pelos compradores. |
|
|
Marca
|
brand | string |
Marca do produto. |
|
|
Description
|
description | string |
Descrição do produto. |
|
|
Itens EAN
|
ean | array of string |
EAN |
|
|
ePID
|
epid | string |
Identificador de produto do eBay para o produto. |
|
|
Urls de imagem
|
imageUrls | array of string |
Urls de imagem |
|
|
Itens ISBN
|
isbn | array of string |
ISBN [en] |
|
|
MPN
|
mpn | string |
Número de peça do fabricante de um produto. |
|
|
Subtítulo
|
subtitle | string |
Recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar com os resultados da pesquisa. |
|
|
Title
|
title | string |
O título de um item de inventário pode ser adicionado ou modificado. |
|
|
Itens UPC
|
upc | array of string |
UPC |
|
|
Ids de vídeo
|
videoIds | array of string |
videoIds |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Advertências
|
warnings | array of object |
Esse contêiner será retornado em uma carga útil de resposta de chamada se um ou mais avisos ou erros forem acionados. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro. |
|
Domínio
|
warnings.domain | string |
O nome do domínio no qual ocorreu o erro ou aviso. |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | object |
Uma descrição da condição que causou o erro ou aviso. |
Excluir oferta
Esta chamada eliminará permanentemente a oferta
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da oferta
|
offerId | True | string |
Identificador único da oferta a eliminar. |
Devoluções
- response
- string
GET Item de inventário
Esta chamada recupera o registro de item de inventário para uma determinada SKU.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor definido pelo vendedor do produto cujo registro de item de estoque você deseja recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
PickupAtLocationDisponibilidade
|
availability.pickupAtLocationAvailability | array of object |
Esse contêiner consiste em uma variedade de lojas físicas do comerciante onde o item de estoque está disponível para retirada na loja. |
|
Tipo de disponibilidade
|
availability.pickupAtLocationAvailability.availabilityType | string |
Este campo indica o estado de disponibilidade do item de inventário na loja física do comerciante. |
|
Unidade
|
availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
O valor indica a unidade de tempo usada para especificar o tempo de cumprimento |
|
Valor
|
availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento. |
|
Chave de localização do comerciante
|
availability.pickupAtLocationAvailability.merchantLocationKey | string |
Identificador exclusivo da loja do comerciante onde o item de inventário de retirada de In-Store está atualmente localizado ou para o qual será enviado. |
|
Quantidade
|
availability.pickupAtLocationAvailability.quantity | integer |
Esse valor inteiro indica a quantidade do item de estoque que está disponível para In-Store Coleta |
|
Leilão
|
availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Este valor inteiro indica a quantidade do item de inventário que está reservado para as ofertas de formato de leilão publicadas da SKU. |
|
Preço Fixo
|
availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Esse valor inteiro indica a quantidade do item de estoque que está disponível para as ofertas de preço fixo da SKU. |
|
DisponibilidadeDistribuições
|
availability.shipToLocationAvailability.availabilityDistributions | array of object |
Esse contêiner é usado para definir a quantidade disponível do item de estoque em um ou mais locais de depósito. |
|
Unidade
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
O valor indica a unidade de tempo usada para especificar o tempo de cumprimento |
|
Valor
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento. |
|
Chave de localização do comerciante
|
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
Identificador exclusivo de um local de inventário onde a quantidade está disponível para o item de inventário. |
|
Quantidade
|
availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
Quantidade do item de inventário que está disponível neste local de inventário. |
|
Quantidade
|
availability.shipToLocationAvailability.quantity | integer |
Este contentor é utilizado para definir a quantidade total "ship-to-home" do item de inventário que estará disponível para compra através de uma ou mais ofertas publicadas. |
|
Condition
|
condition | string |
Esse valor indica a condição do item |
|
Descrição da condição
|
conditionDescription | string |
Este campo string é usado pelo vendedor para descrever mais claramente a condição de itens usados, ou itens que não são 'Brand New', 'New with tags' ou 'New in box'. |
|
IDs de grupo
|
groupIds | array of string | |
|
inventoryItemGroupKeys
|
inventoryItemGroupKeys | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
Localidade
|
locale | string |
Este campo retorna a linguagem natural que foi fornecida nos valores de campo da carga útil da solicitação |
|
Altura
|
packageWeightAndSize.dimensions.height | number |
A altura real do pacote de envio. |
|
Length
|
packageWeightAndSize.dimensions.length | number |
O comprimento real do pacote de envio. |
|
Unidade
|
packageWeightAndSize.dimensions.unit | string |
Unidade de medida usada para especificar as dimensões de um pacote de transporte. |
|
Largura
|
packageWeightAndSize.dimensions.width | number |
A largura real do pacote de envio. |
|
Tipo de embalagem
|
packageWeightAndSize.packageType | string |
Esse valor indica o tipo de pacote de remessa usado para enviar o item de estoque. |
|
Unidade
|
packageWeightAndSize.weight.unit | string |
A unidade de medida usada para especificar o peso de um pacote de envio. |
|
Valor
|
packageWeightAndSize.weight.value | number |
O peso real do pacote de envio. |
|
Aspetos
|
product.aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização pelos compradores. |
|
Marca
|
product.brand | string |
A marca do produto. |
|
Description
|
product.description | string |
A descrição do produto. |
|
Ean
|
product.ean | array of string |
Número de artigo europeu/Número internacional de artigo (EAN) para o produto. |
|
ePID
|
product.epid | string |
O eBay Product Identifier (ePID) do produto. |
|
imageUrls
|
product.imageUrls | array of string |
Uma matriz de um ou mais links para imagens do produto. |
|
ISBN
|
product.isbn | array of string |
Valor do número contabilístico normalizado internacional para o produto. |
|
MPN
|
product.mpn | string |
O número de peça do fabricante (MPN) de um produto. |
|
Subtítulo
|
product.subtitle | string |
Uma legenda é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar com os resultados da pesquisa. |
|
Title
|
product.title | string |
O título de um item de inventário pode ser adicionado ou modificado com uma chamada createOrReplaceInventoryItem. |
|
UPC
|
product.upc | array of string |
Valor do número contabilístico normalizado internacional para o produto. |
|
videoIds
|
product.videoIds | array of string |
Uma matriz de um ou mais valores VideoId para o produto. |
|
SKU
|
sku | string |
A Unidade de Stock-Keeping (SKU) definida pelo vendedor do item de inventário. O vendedor deve ter um valor de SKU único para cada produto que vende. |
Obtenha políticas de atendimento
Esse método recupera todas as políticas de atendimento configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do mercado
|
marketplace_id | True | string |
ID do mercado do eBay das políticas que você deseja recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
fulfillmentPolíticas de cumprimento
|
fulfillmentPolicies | array of object |
Lista de políticas de atendimento do vendedor definidas para o mercado especificado. |
|
Tipos de Categoria
|
fulfillmentPolicies.categoryTypes | array of object |
Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor ou não motorizados. |
|
nome
|
fulfillmentPolicies.categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica |
|
Description
|
fulfillmentPolicies.description | string |
Uma descrição definida pelo vendedor da política de cumprimento. |
|
Frete
|
fulfillmentPolicies.freightShipping | boolean |
Se devolvido como verdadeiro, o vendedor oferece frete para itens grandes acima de 150 libras. |
|
ID da Política de Cumprimento
|
fulfillmentPolicies.fulfillmentPolicyId | string |
ID exclusivo atribuído pelo eBay para a política de atendimento. |
|
Envios Globais
|
fulfillmentPolicies.globalShipping | boolean |
Se devolvido como verdadeiro, o Programa de Envio Global do eBay será usado pelo vendedor para enviar itens para locais internacionais. |
|
Unidade
|
fulfillmentPolicies.handlingTime.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
fulfillmentPolicies.handlingTime.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Recolha Local
|
fulfillmentPolicies.localPickup | boolean |
Se retornado como verdadeiro, o recebimento local estará disponível para esta política. |
|
ID do mercado
|
fulfillmentPolicies.marketplaceId | string |
ID do mercado do eBay ao qual esta política de atendimento se aplica. |
|
Nome
|
fulfillmentPolicies.name | string |
Um nome definido pelo vendedor para esta política de cumprimento. Os nomes devem ser exclusivos para políticas atribuídas ao mesmo mercado. |
|
Recolha Drop Off
|
fulfillmentPolicies.pickupDropOff | boolean |
Se devolvido como verdadeiro, o vendedor oferece a opção "Clique e Colete". |
|
envioOpções
|
fulfillmentPolicies.shippingOptions | array of object |
A matriz fornece informações detalhadas sobre as opções de envio nacional e internacional disponíveis para a apólice. |
|
Tipo de Custo
|
fulfillmentPolicies.shippingOptions.costType | string |
Este campo define se o modelo de custo de envio é FLAT_RATE ou CALCULADO |
|
Moeda
|
fulfillmentPolicies.shippingOptions.insuranceFee.currency | string |
Moeda base aplicada ao campo de valor para estabelecer um montante monetário. |
|
Valor
|
fulfillmentPolicies.shippingOptions.insuranceFee.value | string |
O montante monetário na moeda especificada. |
|
optionType
|
fulfillmentPolicies.shippingOptions.optionType | string |
optionType |
|
moeda
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency | string |
moeda |
|
valor
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.value | string |
valor |
|
rateTableId
|
fulfillmentPolicies.shippingOptions.rateTableId | string |
rateTableId |
|
serviços de envio
|
fulfillmentPolicies.shippingOptions.shippingServices | array of object |
serviços de envio |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency | string |
moeda |
|
valor
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value | string |
valor |
|
compradorResponsibleForPickup
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
compradorResponsibleForPickup |
|
compradorResponsávelporEnvio
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
compradorResponsávelporEnvio |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
moeda |
|
valor
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
valor |
|
frete grátis
|
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping | boolean |
frete grátis |
|
shippingCarrierCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode | string |
shippingCarrierCode |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency | string |
moeda |
|
valor
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value | string |
valor |
|
shippingServiceCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode | string |
shippingServiceCode |
|
regiãoExcluído
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
regiãoExcluído |
|
nome_da_região
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType [en]
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType [en] |
|
regiãoIncluído
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regiãoIncluído |
|
nome_da_região
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType [en]
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType [en] |
|
sortOrder
|
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder | integer |
sortOrder |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency | string |
moeda |
|
valor
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value | string |
valor |
|
Região excluída
|
fulfillmentPolicies.shipToLocations.regionExcluded | array of object |
Uma matriz de valores regionName que especifica as áreas para as quais um vendedor não envia. |
|
nome_da_região
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType [en]
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionType | string |
regionType [en] |
|
Região Incluída
|
fulfillmentPolicies.shipToLocations.regionIncluded | array of object |
Uma matriz de campos regionName que especificam as áreas para onde um vendedor envia. |
|
nome_da_região
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType [en]
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionType | string |
regionType [en] |
|
Href
|
href | string |
Este campo é para uso futuro. |
|
Limite
|
limit | integer |
Este campo é para uso futuro. |
|
Next
|
next | string |
Este campo é para uso futuro. |
|
Compensação
|
offset | integer |
Este campo é para uso futuro. |
|
Anterior
|
prev | string |
Este campo é para uso futuro. |
|
Total
|
total | integer |
Número total de políticas de atendimento recuperadas no conjunto de resultados. |
Obter aspetos do item para a categoria
Esta chamada retorna uma lista de aspetos que são apropriados ou necessários para descrever com precisão os itens na categoria de folha especificada. Cada aspeto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será solicitado ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da árvore de categorias
|
category_tree_id | True | string |
Árvore de categorias do eBay ID único a partir do qual os aspetos da categoria especificada estão sendo solicitados. |
|
ID da categoria
|
category_id | True | string |
Identificador único da categoria folha para os quais os aspetos estão sendo solicitados. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Aspetos
|
aspects | array of object |
Lista de aspetos do item que são apropriados para descrever itens em uma determinada categoria de folha |
|
Aspeto aplicável a
|
aspects.aspectConstraint.aspectApplicableTo | array of string |
Esse valor indica se o aspeto identificado pelo campo aspects.localizedAspectName é um aspeto do produto ou um aspeto do item/instância, que é um aspeto cujo valor variará com base em uma instância específica do produto. |
|
Tipo de dados de aspeto
|
aspects.aspectConstraint.aspectDataType | string |
Tipo de dados de aspeto. |
|
Aspeto ativado para variações
|
aspects.aspectConstraint.aspectEnabledForVariations | boolean |
Um valor true indica que esse aspeto pode ser usado para ajudar a identificar variações de itens. |
|
Formato de aspeto
|
aspects.aspectConstraint.aspectFormat | string |
Retornado somente se o valor de aspectDataType identificar um tipo de dados que requer formatação específica. |
|
Comprimento máximo do aspeto
|
aspects.aspectConstraint.aspectMaxLength | integer |
Comprimento máximo do valor do aspeto do item. |
|
Modo de aspeto
|
aspects.aspectConstraint.aspectMode | string |
Maneira pela qual os valores deste aspeto devem ser especificados pelo vendedor. |
|
Aspeto Necessário
|
aspects.aspectConstraint.aspectRequired | boolean |
Um valor true indica que esse aspeto é necessário ao oferecer itens na categoria especificada. |
|
Uso do aspeto
|
aspects.aspectConstraint.aspectUsage | string |
O valor indica se o aspeto correspondente é recomendado ou opcional. |
|
Esperada por data exigida
|
aspects.aspectConstraint.expectedRequiredByDate | string |
Data prevista após a qual o aspeto será exigido. |
|
Cardinalidade do Item ao Aspeto
|
aspects.aspectConstraint.itemToAspectCardinality | string |
Indica se esse aspeto pode aceitar valores únicos ou múltiplos para itens na categoria especificada. |
|
aspectValores
|
aspects.aspectValues | array of object |
Uma lista de valores válidos, juntamente com quaisquer restrições para este aspeto. |
|
localizadoValor
|
aspects.aspectValues.localizedValue | string |
O valor localizado deste aspeto. |
|
valueConstraints
|
aspects.aspectValues.valueConstraints | array of object |
Contém uma lista das dependências que identificam quando o valor do campo localizedValue está disponível para o aspeto atual. |
|
applicableForLocalizedAspectName
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName | string |
O nome do aspeto de controle do qual depende o valor do aspeto atual. |
|
applicableForLocalizedAspectValues
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues | array of string |
Contém uma lista dos valores do aspeto de controle do qual o valor desse aspeto depende. |
|
Nome do aspeto localizado
|
aspects.localizedAspectName | string |
Nome localizado deste aspeto. |
|
Contagem de pesquisas
|
aspects.relevanceIndicator.searchCount | integer |
Número de pesquisas recentes para o aspeto. |
Obter categoria padrão TreeId
Um determinado mercado do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse mercado. Esta chamada recupera uma referência à árvore de categorias padrão associada ao ID de mercado do eBay especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Marketplace ID
|
marketplace_id | True | string |
ID do mercado do eBay para o qual o ID da árvore de categorias está sendo solicitado. |
|
Accept-Language
|
Accept-Language | True | string |
Um cabeçalho usado para indicar a linguagem natural que o vendedor prefere para a resposta. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da árvore de categoria
|
categoryTreeId | string |
ID da árvore de categorias exclusiva do eBay para o mercado especificado. |
|
Versão da árvore de categorias
|
categoryTreeVersion | string |
A versão da árvore de categorias identificada por categoryTreeId. |
Obter itens de inventário
Esta chamada recupera todos os registros de itens de estoque definidos para a conta do vendedor.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Limite
|
limit | string |
Número máximo de registos a devolver por página de dados. |
|
|
Compensação
|
offset | string |
O número da página a ser recuperada. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Este é o URL para a página atual de itens de inventário. |
|
inventoryItems
|
inventoryItems | array of object |
Esse contêiner é uma matriz de um ou mais itens de inventário. |
|
pickupAtLocationDisponibilidade
|
inventoryItems.availability.pickupAtLocationAvailability | array of object |
Esse contêiner consiste em uma variedade de lojas físicas do comerciante onde o item de estoque está disponível para retirada na loja. |
|
availabilityType
|
inventoryItems.availability.pickupAtLocationAvailability.availabilityType | string |
Status de disponibilidade do item de inventário |
|
unidade
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
Unidade de tempo usada para especificar o tempo de cumprimento |
|
valor
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento. |
|
merchantLocationKey
|
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey | string |
Loja do comerciante Identificador exclusivo onde o item de inventário In-Store Pickup está atualmente localizado ou para o qual será enviado. |
|
quantidade
|
inventoryItems.availability.pickupAtLocationAvailability.quantity | integer |
quantidade |
|
Leilão
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Este valor inteiro indica a quantidade do item de inventário que está reservado para as ofertas de formato de leilão publicadas da SKU. |
|
Preço Fixo
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Esse valor indica a quantidade do item de estoque que está disponível para as ofertas de preço fixo da SKU. |
|
disponibilidadeDistribuições
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions | array of object |
Esse contêiner é usado para definir a quantidade disponível do item de estoque em um ou mais locais de depósito. |
|
unidade
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
unidade |
|
valor
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
valor |
|
merchantLocationKey
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
merchantLocationKey |
|
quantidade
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
quantidade |
|
Quantidade
|
inventoryItems.availability.shipToLocationAvailability.quantity | integer |
Este contentor é utilizado para definir a quantidade total "ship-to-home" do item de inventário que estará disponível para compra através de uma ou mais ofertas publicadas |
|
Condition
|
inventoryItems.condition | string |
Esse valor indica a condição do item. |
|
Descrição da condição
|
inventoryItems.conditionDescription | string |
Este campo string é usado pelo vendedor para descrever mais claramente a condição dos itens |
|
IDs de grupo
|
inventoryItems.groupIds | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
inventoryItemGroupKeys
|
inventoryItems.inventoryItemGroupKeys | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
Localidade
|
inventoryItems.locale | string |
Este campo retorna a linguagem natural que foi fornecida nos valores de campo da carga útil da solicitação. |
|
Altura
|
inventoryItems.packageWeightAndSize.dimensions.height | number |
Altura real do pacote de envio. |
|
Length
|
inventoryItems.packageWeightAndSize.dimensions.length | number |
Duração real do pacote de envio. |
|
Unidade
|
inventoryItems.packageWeightAndSize.dimensions.unit | string |
Unidade de medida usada para especificar as dimensões de um pacote de transporte. |
|
Largura
|
inventoryItems.packageWeightAndSize.dimensions.width | number |
Largura real do pacote de envio. |
|
Largura
|
inventoryItems.packageWeightAndSize.packageType | string |
Tipo de pacote de envio usado para enviar o item de inventário. |
|
Unidade
|
inventoryItems.packageWeightAndSize.weight.unit | string |
Unidade de medida utilizada para especificar o peso de uma encomenda de envio. |
|
Valor
|
inventoryItems.packageWeightAndSize.weight.value | number |
O peso real do pacote de envio. |
|
Aspetos
|
inventoryItems.product.aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização pelos compradores. |
|
Marca
|
inventoryItems.product.brand | string |
A marca do produto. Este campo é frequentemente emparelhado com o campo mpn para identificar um produto específico por Número de Peça de Fabricação. |
|
Description
|
inventoryItems.product.description | string |
A descrição do produto. |
|
Ean
|
inventoryItems.product.ean | array of string |
Número do artigo europeu/Número do artigo internacional do produto. |
|
ePID
|
inventoryItems.product.epid | string |
O eBay Product Identifier (ePID) do produto. |
|
imageUrls
|
inventoryItems.product.imageUrls | array of string |
Uma matriz de um ou mais links para imagens do produto. |
|
ISBN
|
inventoryItems.product.isbn | array of string |
Valor do número contabilístico normalizado internacional para o produto. |
|
MPN
|
inventoryItems.product.mpn | string |
Número de peça do fabricante de um produto. |
|
Subtítulo
|
inventoryItems.product.subtitle | string |
Uma legenda é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar com os resultados da pesquisa. |
|
Title
|
inventoryItems.product.title | string |
O título de um item de inventário pode ser adicionado ou modificado |
|
UPC
|
inventoryItems.product.upc | array of string |
Valor do Código Universal do Produto para o produto. |
|
videoIds
|
inventoryItems.product.videoIds | array of string |
Uma matriz de um ou mais valores VideoId para o produto. |
|
SKU
|
inventoryItems.sku | string |
Unidade de Stock-Keeping definida pelo vendedor do item de inventário. |
|
Limite
|
limit | integer |
O número de itens de inventário que serão exibidos em cada página de resultados. |
|
Next
|
next | string |
URL para a próxima página de itens de inventário. |
|
Anterior
|
prev | string |
URL para a página anterior de itens de inventário. |
|
Tamanho
|
size | integer |
Número total de páginas de resultados disponíveis. |
|
Total
|
total | integer |
Número total de itens de inventário que existem para a conta do vendedor. |
Obter locais de inventário
Esta chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Compensação
|
offset | string |
Especifica o número de locais a serem ignorados no conjunto de resultados antes de retornar o primeiro local. |
|
|
Limite
|
limit | string |
Número máximo de registos a devolver por página de dados. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
URI da página atual de resultados do conjunto de resultados. |
|
Limite
|
limit | integer |
Número de itens retornados em uma única página do conjunto de resultados. |
|
Next
|
next | string |
URI para a seguinte página de resultados. |
|
Compensação
|
offset | string |
Número de resultados ignorados no conjunto de resultados antes de listar o primeiro resultado retornado. |
|
Anterior
|
prev | string |
URI para a página de resultados anterior. |
|
Total
|
total | integer |
Número total de itens recuperados no conjunto de resultados. |
|
localizações
|
locations | array of object |
Uma matriz de um ou mais locais de inventário do comerciante. |
|
Linha de Endereço 1
|
locations.location.address.addressLine1 | string |
Primeira linha de um endereço. |
|
Endereço Linha 2
|
locations.location.address.addressLine2 | string |
Segunda linha de um endereço. |
|
City
|
locations.location.address.city | string |
Cidade em que reside o local de inventário. |
|
Country
|
locations.location.address.country | string |
Código do país em que o endereço reside. |
|
Concelho
|
locations.location.address.county | string |
Condado em que o endereço reside. |
|
Código Postal
|
locations.location.address.postalCode | string |
Código postal/postal da morada. |
|
Estado Ou Província
|
locations.location.address.stateOrProvince | string |
Estado/província em que reside o local de inventário. |
|
Latitude
|
locations.location.geoCoordinates.latitude | string |
Componente Latitude da coordenada geográfica. |
|
Longitude
|
locations.location.geoCoordinates.longitude | string |
Componente de longitude da coordenada geográfica. |
|
ID da localização
|
locations.location.locationId | string |
ID exclusivo atribuído pelo eBay para o local. |
|
Informação Adicional de Localização
|
locations.locationAdditionalInformation | string |
Este campo fornece informações adicionais sobre um local de inventário. |
|
Instruções de localização
|
locations.locationInstructions | string |
Este campo é utilizado pelo comerciante para fornecer instruções especiais de levantamento para a localização da loja. |
|
locationTypes
|
locations.locationTypes | array of string |
Esse contêiner define a função do local do inventário. |
|
Localização Web Url
|
locations.locationWebUrl | string |
Este campo mostra o endereço do site associado ao local do inventário. |
|
Chave de localização do comerciante
|
locations.merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
Status da localização do comerciante
|
locations.merchantLocationStatus | string |
Este campo indica se a localização do inventário está ativada ou desativada. |
|
Nome
|
locations.name | string |
Nome do local do inventário. |
|
operandoHoras
|
locations.operatingHours | array of object |
Este contentor mostra o horário normal de funcionamento de uma loja durante os dias da semana. |
|
diadesemanaenum
|
locations.operatingHours.dayOfWeekEnum | string |
diadesemanaenum |
|
intervalos
|
locations.operatingHours.intervals | array of object |
Este contentor é utilizado para definir os horários de abertura/fecho do dia de trabalho de uma loja. |
|
fechar
|
locations.operatingHours.intervals.close | string |
fechar |
|
aberto
|
locations.operatingHours.intervals.open | string |
aberto |
|
Telemóvel
|
locations.phone | string |
O número de telefone de um local de inventário. |
|
specialHours [en]
|
locations.specialHours | array of object |
Este contêiner mostra o horário de funcionamento especial para um local de loja em uma data ou datas específicas. |
|
date
|
locations.specialHours.date | string |
date |
|
intervalos
|
locations.specialHours.intervals | array of object |
Este contentor é utilizado para definir os horários de abertura e fecho de uma loja numa data específica. |
|
fechar
|
locations.specialHours.intervals.close | string |
fechar |
|
aberto
|
locations.specialHours.intervals.open | string |
aberto |
Obter localização de inventário
Esta chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de localização do comerciante
|
merchantLocationKey | True | string |
Uma chave (ID) exclusiva definida pelo comerciante para um local de inventário. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Linha de Endereço 1
|
location.address.addressLine1 | string |
Primeira linha de um endereço. |
|
Endereço Linha 2
|
location.address.addressLine2 | string |
Segunda linha de um endereço. |
|
CIty
|
location.address.city | string |
Cidade em que reside o local de inventário. |
|
Country
|
location.address.country | string |
Código do país em que reside o endereço |
|
Concelho
|
location.address.county | string |
Condado em que o endereço reside. |
|
Código Postal
|
location.address.postalCode | string |
Código postal/postal da morada. |
|
Estado Ou Província
|
location.address.stateOrProvince | string |
Estado/província em que reside o local de inventário. |
|
Latitude
|
location.geoCoordinates.latitude | string |
Componente Latitude da coordenada geográfica. |
|
Longitude
|
location.geoCoordinates.longitude | string |
Componente de longitude da coordenada geográfica. |
|
ID da localização
|
location.locationId | string |
ID exclusivo atribuído pelo eBay para o local. |
|
Informação Adicional de Localização
|
locationAdditionalInformation | string |
Este campo de texto fornece informações adicionais sobre um local de inventário. |
|
Instruções de localização
|
locationInstructions | string |
O campo é usado pelo comerciante para fornecer instruções especiais de retirada para o local da loja. |
|
locationTypes
|
locationTypes | array of string |
Esse contêiner define a função do local do inventário. |
|
Localização Web Url
|
locationWebUrl | string |
O campo mostra o endereço do site associado ao local do inventário. |
|
Chave de localização do comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
Status da localização do comerciante
|
merchantLocationStatus | string |
O campo indica se o local do inventário está habilitado ou desativado |
|
Nome
|
name | string |
Nome do local do inventário. |
|
operandoHoras
|
operatingHours | array of object |
Este contentor mostra o horário normal de funcionamento de uma loja durante os dias da semana. |
|
Semana Enum
|
operatingHours.dayOfWeekEnum | string |
É necessário um valor para cada dia da semana em que o local da loja tenha horário normal de funcionamento. |
|
intervalos
|
operatingHours.intervals | array of object |
Este contentor é utilizado para definir os horários de abertura/fecho do dia de trabalho de uma loja. |
|
fechar
|
operatingHours.intervals.close | string |
fechar |
|
aberto
|
operatingHours.intervals.open | string |
aberto |
|
Telemóvel
|
phone | string |
Número de telefone para um local de inventário. |
|
Horário Especial
|
specialHours | array of object |
Este contêiner mostra o horário de funcionamento especial para um local de loja em uma data ou datas específicas. |
|
Date
|
specialHours.date | string |
Um valor de data é necessário para cada data específica em que o local da loja tem horários especiais de funcionamento. |
|
intervalos
|
specialHours.intervals | array of object |
Este contentor é utilizado para definir os horários de abertura/fecho de uma loja numa data específica. |
|
fechar
|
specialHours.intervals.close | string |
fechar |
|
aberto
|
specialHours.intervals.open | string |
aberto |
Obter Política de Atendimento
Esse método recupera os detalhes completos de uma política de atendimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Política de Cumprimento
|
fulfillmentPolicyId | True | string |
ID da política de atendimento que você deseja recuperar |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
categoriaTipos
|
categoryTypes | array of object |
Este contentor indica se a política de cumprimento se aplica a listagens de veículos a motor ou a listagens de veículos não motorizados. |
|
Nome
|
categoryTypes.name | string |
Nome do tipo de categoria ao qual a política se aplica. |
|
Description
|
description | string |
Uma descrição definida pelo vendedor da política de cumprimento. Esta descrição é apenas para uso do vendedor e não é exposta em nenhuma página do eBay. |
|
Frete
|
freightShipping | boolean |
Se devolvido como verdadeiro, o vendedor oferece frete de frete. |
|
Id da Política de Cumprimento
|
fulfillmentPolicyId | string |
ID exclusivo atribuído pelo eBay para a política de atendimento. |
|
Envios Globais
|
globalShipping | boolean |
Se devolvido como verdadeiro, o Programa de Envio Global do eBay será usado pelo vendedor para enviar itens para locais internacionais. |
|
Unidade
|
handlingTime.unit | string |
Um período de tempo é definido quando você aplica o valor especificado no campo de valor ao valor especificado para a unidade. |
|
Valor
|
handlingTime.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Recolha Local
|
localPickup | boolean |
Se retornado como verdadeiro, o recebimento local estará disponível para esta política. |
|
ID do mercado
|
marketplaceId | string |
ID do mercado do eBay ao qual esta política de atendimento se aplica. |
|
Nome
|
name | string |
Nome exclusivo definido pelo vendedor para esta política de cumprimento. |
|
Recolha Drop Off
|
pickupDropOff | boolean |
Se devolvido como verdadeiro, o vendedor oferece a opção "Clique e Colete". |
|
envioOpções
|
shippingOptions | array of object |
Esta matriz é usada para fornecer informações detalhadas sobre as opções de envio nacionais e internacionais disponíveis para a apólice. |
|
Tipo de Custo
|
shippingOptions.costType | string |
Este campo define se o modelo de custo de envio é FLAT_RATE ou CALCULADO |
|
Tipo de opção
|
shippingOptions.optionType | string |
Este campo é utilizado para indicar se as opções de serviço de transporte correspondentes são nacionais ou internacionais. |
|
Moeda
|
shippingOptions.packageHandlingCost.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um montante monetário. |
|
Valor
|
shippingOptions.packageHandlingCost.value | string |
O montante monetário na moeda especificada. |
|
ID da tabela de taxas
|
shippingOptions.rateTableId | string |
Este campo é usado se o vendedor quiser associar uma tabela de taxas de envio nacional ou internacional à política comercial de cumprimento. |
|
serviços de envio
|
shippingOptions.shippingServices | array of object |
Essa matriz consiste nas opções de serviços de envio nacionais ou internacionais definidas para a política. |
|
moeda
|
shippingOptions.shippingServices.additionalShippingCost.currency | string |
moeda |
|
valor
|
shippingOptions.shippingServices.additionalShippingCost.value | string |
valor |
|
compradorResponsibleForPickup
|
shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
Este campo deve ser incluído para uma listagem de veículos a motor se for da responsabilidade do comprador levantar o veículo automóvel comprado após o pagamento integral ser feito. |
|
compradorResponsávelporEnvio
|
shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
Este campo deve ser incluído para uma listagem de veículos a motor se for da responsabilidade do comprador providenciar o envio de um veículo a motor comprado após o pagamento integral ser feito |
|
moeda
|
shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
moeda |
|
valor
|
shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
valor |
|
frete grátis
|
shippingOptions.shippingServices.freeShipping | boolean |
Este campo está incluído se o vendedor oferecer uma opção de envio gratuito ao comprador. |
|
shippingCarrierCode
|
shippingOptions.shippingServices.shippingCarrierCode | string |
Este campo define/indica a transportadora. |
|
moeda
|
shippingOptions.shippingServices.shippingCost.currency | string |
moeda |
|
valor
|
shippingOptions.shippingServices.shippingCost.value | string |
valor |
|
shippingServiceCode
|
shippingOptions.shippingServices.shippingServiceCode | string |
Este campo define/indica a opção de serviço de transporte nacional ou internacional. |
|
regiãoExcluído
|
shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
regiãoExcluído |
|
nome_da_região
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType [en]
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType [en] |
|
regiãoIncluído
|
shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regiãoIncluído |
|
nome_da_região
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType [en]
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType [en] |
|
sortOrder
|
shippingOptions.shippingServices.sortOrder | integer |
O valor inteiro definido neste campo controla a ordem do serviço de envio. |
|
regiãoExcluído
|
shipToLocations.regionExcluded | array of object |
Uma matriz de valores regionName que especifica as áreas para as quais um vendedor não envia. |
|
Nome da Região
|
shipToLocations.regionExcluded.regionName | string |
Uma cadeia de caracteres que indica o nome de uma região, conforme definido pelo eBay. |
|
Tipo de região
|
shipToLocations.regionExcluded.regionType | string |
Reservado para uso futuro. |
|
regiãoIncluído
|
shipToLocations.regionIncluded | array of object |
Uma matriz de campos regionName que especificam as áreas para onde um vendedor envia. |
|
Nome da Região
|
shipToLocations.regionIncluded.regionName | string |
Uma cadeia de caracteres que indica o nome de uma região, conforme definido pelo eBay. |
|
Tipo de região
|
shipToLocations.regionIncluded.regionType | string |
Reservado para uso futuro. |
Obter Política de Devoluções
Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da política de devolução
|
return_policy_id | True | string |
ID da política de retorno que você deseja recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
categoriaTipos
|
categoryTypes | array of object |
Esse contêiner indica a qual grupo de categorias a política de retorno se aplica. |
|
Nome
|
categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica |
|
Description
|
description | string |
Uma descrição definida pelo vendedor da política comercial de devolução. |
|
Método de retorno
|
internationalOverride.returnMethod | string |
Este campo define/indica se o vendedor oferece artigos de substituição ao comprador em caso de devolução internacional. |
|
Unidade
|
internationalOverride.returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
internationalOverride.returnPeriod.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Devoluções Aceites
|
internationalOverride.returnsAccepted | boolean |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Pagador do Custo de Envio de Devolução
|
internationalOverride.returnShippingCostPayer | string |
Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos. |
|
ID do mercado
|
marketplaceId | string |
ID do mercado eBay ao qual se aplica esta política comercial de devolução. |
|
Nome
|
name | string |
Um nome definido pelo vendedor para esta política comercial de pagamento. |
|
Método de reembolso
|
refundMethod | string |
Se um vendedor indicar que aceitará devoluções do comprador, este valor será definido como MONEY_BACK. |
|
Instruções de devolução
|
returnInstructions | string |
Este campo baseado em texto fornece mais detalhes sobre as instruções de devolução especificadas pelo vendedor. Este campo só é devolvido se definido para a política comercial de devolução. |
|
Método de retorno
|
returnMethod | string |
Este campo só é devolvido se o vendedor estiver disposto a oferecer um artigo de substituição como alternativa ao 'Dinheiro de Volta' |
|
Unidade
|
returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
returnPeriod.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
ID da política de devolução
|
returnPolicyId | string |
ID exclusivo atribuído pelo eBay para uma política comercial de devolução. Esse ID é gerado quando a política é criada. |
|
Devoluções Aceites
|
returnsAccepted | boolean |
Se este campo for devolvido como verdadeiro, o vendedor aceita devoluções. |
|
Pagador do Custo de Envio de Devolução
|
returnShippingCostPayer | string |
Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos. |
Obter Política de Pagamento
Este método recupera os detalhes completos de uma política de pagamento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho paymentPolicyId.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Política de Pagamento
|
payment_policy_id | True | string |
ID da política de pagamento que você deseja recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
categoriaTipos
|
categoryTypes | array of object |
Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor ou não motorizados. |
|
Nome
|
categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica. |
|
Moeda
|
deposit.amount.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um montante monetário. |
|
Valor
|
deposit.amount.value | string |
O montante monetário na moeda especificada. |
|
Unidade
|
deposit.dueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
deposit.dueIn.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Description
|
description | string |
Uma descrição da política de pagamento definida pelo vendedor. |
|
Unidade
|
fullPaymentDueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
fullPaymentDueIn.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Pagamento Imediato
|
immediatePay | boolean |
Se este campo for devolvido como verdadeiro, é necessário o pagamento imediato por parte do comprador |
|
ID do mercado
|
marketplaceId | string |
ID do mercado eBay ao qual se aplica a política comercial de pagamentos. |
|
Nome
|
name | string |
ID do mercado eBay ao qual se aplica a política comercial de pagamentos. |
|
Instruções de Pagamento
|
paymentInstructions | string |
Embora esse campo possa ser retornado para algumas políticas comerciais de pagamento mais antigas, as instruções de pagamento não são mais suportadas pelas políticas comerciais de pagamento |
|
paymentMethods
|
paymentMethods | array of object |
Esse contêiner é retornado para mostrar os métodos de pagamento aceitos para a política comercial de pagamento. |
|
Tipo de Método de Pagamento
|
paymentMethods.paymentMethodType | string |
Tipo de método de pagamento para suporte offline |
|
ID da Política de Pagamento
|
paymentPolicyId | string |
Um ID exclusivo atribuído ao eBay para uma política comercial de pagamento. |
Obter políticas de condição de item
Esse método retorna metadados de condição de item em uma, várias ou todas as categorias do eBay em um mercado do eBay.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do mercado
|
marketplace_id | True | string |
ID do mercado do eBay para o qual as informações de política são recuperadas. |
|
Filter
|
filter | string |
Limita a resposta retornando informações de política apenas para as seções selecionadas da árvore de categorias. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
itemConditionPolicies
|
itemConditionPolicies | array of object |
Uma lista de IDs de categoria e as políticas de como indicar a condição de um item em cada uma das categorias listadas. |
|
ID da categoria
|
itemConditionPolicies.categoryId | string |
ID da categoria à qual a política de condição do item se aplica. |
|
ID da árvore de categorias
|
itemConditionPolicies.categoryTreeId | string |
Um valor que indica o nó raiz da árvore de categorias usada para o conjunto de respostas. |
|
Condição do item necessária
|
itemConditionPolicies.itemConditionRequired | boolean |
Esse sinalizador indica se você deve ou não listar a condição do item em uma listagem para a categoria especificada. |
|
itemCondições
|
itemConditionPolicies.itemConditions | array of object |
Os valores de condição de item permitidos na categoria. |
|
condiçãoDescrição
|
itemConditionPolicies.itemConditions.conditionDescription | string |
O rótulo legível por humanos para a condição. |
|
condiçãoId
|
itemConditionPolicies.itemConditions.conditionId | string |
Valor de ID da condição do item selecionado. |
|
utilização
|
itemConditionPolicies.itemConditions.usage | string |
utilização |
|
Advertências
|
warnings | array of object |
Lista de avisos que foram gerados como resultado da solicitação. |
|
Categoria
|
warnings.category | string |
Tipo de categoria para este erro ou aviso. |
|
Domínio
|
warnings.domain | string |
Nome de domínio que contém o serviço ou aplicativo. |
|
ID do erro
|
warnings.errorId | integer |
Um inteiro positivo que identifica exclusivamente a condição de erro específica que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Identifica elementos de solicitação específicos associados ao erro, se houver. A resposta de inputRefId é específica do formato. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma versão expandida da mensagem que deve ter cerca de 100-200 caracteres, mas não é necessária para ser tal. |
|
Message
|
warnings.message | string |
Uma mensagem agnóstica de dispositivo amigável para o usuário final e desenvolvedor de aplicativos. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Identifica elementos de resposta específicos associados ao erro, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | string |
Nome do subsistema ou subdivisão do domínio. |
Obter Políticas de Devolução
Esse método recupera todas as políticas de retorno configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Marketplace ID
|
marketplace_id | True | string |
ID do mercado do eBay da política que pretende recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Este campo é para uso futuro. |
|
Limite
|
limit | integer |
Este campo é para uso futuro. |
|
Next
|
next | string |
Este campo é para uso futuro. |
|
Compensação
|
offset | integer |
Este campo é para uso futuro. |
|
Anterior
|
prev | string |
Este campo é para uso futuro. |
|
devoluçãoPolíticas
|
returnPolicies | array of object |
Lista das políticas comerciais de devolução do vendedor definidas para o mercado especificado. |
|
categoriaTipos
|
returnPolicies.categoryTypes | array of object |
Esse contêiner indica a qual grupo de categorias a política de retorno se aplica. |
|
nome
|
returnPolicies.categoryTypes.name | string |
nome |
|
Description
|
returnPolicies.description | string |
Uma descrição definida pelo vendedor da política comercial de devolução. |
|
Método de retorno
|
returnPolicies.internationalOverride.returnMethod | string |
Este campo define/indica se o vendedor oferece artigos de substituição ao comprador em caso de devolução internacional. |
|
Unidade
|
returnPolicies.internationalOverride.returnPeriod.unit | string |
Esses valores de enum representam a unidade de medida de tempo, como DAY. |
|
Valor
|
returnPolicies.internationalOverride.returnPeriod.value | integer |
Unidade de medição de tempo, como DAY. |
|
Devoluções Aceites
|
returnPolicies.internationalOverride.returnsAccepted | boolean |
Se definido como true, o vendedor aceita devoluções internacionais. |
|
Pagador do Custo de Envio de Devolução
|
returnPolicies.internationalOverride.returnShippingCostPayer | string |
Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos. |
|
ID do mercado
|
returnPolicies.marketplaceId | string |
ID do mercado do eBay ao qual esta política de negócios de devolução se aplica. |
|
Nome
|
returnPolicies.name | string |
Um nome definido pelo vendedor para esta política comercial de pagamento. |
|
Método de reembolso
|
returnPolicies.refundMethod | string |
Se um vendedor indicar que aceitará devoluções do comprador, este valor será definido como MONEY_BACK. |
|
Instruções de devolução
|
returnPolicies.returnInstructions | string |
Este campo baseado em texto fornece mais detalhes sobre as instruções de devolução especificadas pelo vendedor. |
|
Método de retorno
|
returnPolicies.returnMethod | string |
Este campo só é devolvido se o vendedor estiver disposto a oferecer um artigo de substituição como alternativa ao 'Dinheiro de Volta'. |
|
Unidade
|
returnPolicies.returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
returnPolicies.returnPeriod.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
ID da política de devolução
|
returnPolicies.returnPolicyId | string |
Um ID exclusivo atribuído pelo eBay para uma política comercial de devolução. |
|
Devolução Aceite
|
returnPolicies.returnsAccepted | boolean |
Se este campo for devolvido como verdadeiro, o vendedor aceita devoluções. |
|
Pagador do Custo de Envio de Devolução
|
returnPolicies.returnShippingCostPayer | string |
Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos. |
|
Total
|
total | integer |
Número total de políticas de negócios de retorno recuperadas no conjunto de resultados. |
Obter Políticas de Pagamento
Esse método recupera todas as políticas de pagamento configuradas para o marketplace especificado usando o parâmetro de consulta marketplace_id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do mercado
|
marketplace_id | string |
ID do mercado do eBay das políticas que você deseja recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Este campo é para uso futuro. |
|
Limite
|
limit | integer |
Este campo é para uso futuro. |
|
Next
|
next | string |
Este campo é para uso futuro. |
|
Compensação
|
offset | integer |
Este campo é para uso futuro. |
|
paymentPolíticas
|
paymentPolicies | array of object |
Lista de políticas comerciais de pagamento do vendedor definidas para o mercado especificado. |
|
categoriaTipos
|
paymentPolicies.categoryTypes | array of object |
Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor ou não motorizados. |
|
predefinição
|
paymentPolicies.categoryTypes.default | boolean |
predefinição |
|
nome
|
paymentPolicies.categoryTypes.name | string |
nome |
|
Moeda
|
paymentPolicies.deposit.amount.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um montante monetário. |
|
Valor
|
paymentPolicies.deposit.amount.value | string |
O montante monetário na moeda especificada. |
|
Unidade
|
paymentPolicies.deposit.dueIn.unit | string |
Esses valores representam a unidade de medida de tempo, como DAY. |
|
Valor
|
paymentPolicies.deposit.dueIn.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Description
|
paymentPolicies.description | string |
Uma descrição da política de pagamento definida pelo vendedor. |
|
Unidade
|
paymentPolicies.fullPaymentDueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Valor
|
paymentPolicies.fullPaymentDueIn.value | integer |
Valor unitário de medição do tempo especificado no campo da unidade. |
|
Pagamento Imediato
|
paymentPolicies.immediatePay | boolean |
Se este campo for devolvido como verdadeiro, é necessário o pagamento imediato por parte do comprador |
|
ID do mercado
|
paymentPolicies.marketplaceId | string |
ID do mercado eBay ao qual se aplica a política comercial de pagamento. |
|
Nome
|
paymentPolicies.name | string |
Um nome definido pelo vendedor para esta política de cumprimento. |
|
Instruções de Pagamento
|
paymentPolicies.paymentInstructions | string |
Embora esse campo possa ser retornado para algumas políticas comerciais de pagamento mais antigas, as instruções de pagamento não são mais suportadas pelas políticas comerciais de pagamento. Se este campo for devolvido, pode ser ignorado e estas instruções de pagamento não aparecerão em quaisquer anúncios que utilizem a política comercial correspondente. |
|
paymentMethods
|
paymentPolicies.paymentMethods | array of object |
Esse contêiner é retornado para mostrar os métodos de pagamento aceitos para a política comercial de pagamento. |
|
paymentMethodType
|
paymentPolicies.paymentMethods.paymentMethodType | string |
Tipo de Método de Pagamento |
|
ID da Política de Pagamento
|
paymentPolicies.paymentPolicyId | string |
ID exclusivo atribuído ao eBay para uma política comercial de pagamento. |
|
Anterior
|
prev | string |
Este campo é para uso futuro. |
|
Total
|
total | integer |
Número total de políticas comerciais de pagamento recuperadas no conjunto de resultados. |
Obter sugestões de categoria
Esta chamada retorna uma matriz de nós de folha de árvore de categorias na árvore de categorias especificada que são considerados pelo eBay como correspondendo mais estreitamente à consulta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da árvore de categorias
|
category_tree_id | True | string |
Identificador único da árvore de categorias do eBay para o qual os nós sugeridos estão sendo solicitados. |
|
Termo de Pesquisa
|
q | True | string |
Um termo de pesquisa que descreve o item que está sendo colocado à venda. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
categorySugestões
|
categorySuggestions | array of object |
Contém detalhes sobre uma ou mais categorias sugeridas que correspondem às palavras-chave fornecidas. |
|
ID da categoria
|
categorySuggestions.category.categoryId | string |
Identificador único da categoria do eBay na sua árvore de categorias. |
|
Nome da categoria
|
categorySuggestions.category.categoryName | string |
Nome da categoria identificada por categoryId. |
|
Categoria: Árvore Nó Ancestrais
|
categorySuggestions.categoryTreeNodeAncestors | array of object |
Uma matriz de lista ordenada de referências de categoria que descreve o local da categoria sugerida na árvore de categorias especificada. |
|
categoryId
|
categorySuggestions.categoryTreeNodeAncestors.categoryId | string |
Identificador único da categoria de antepassados do eBay. |
|
categoryName
|
categorySuggestions.categoryTreeNodeAncestors.categoryName | string |
Nome da categoria ancestral identificada por categoryId. |
|
categoriaSubtreeNodeHref
|
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref | string |
A parte href da chamada getCategorySubtree que recupera a subárvore abaixo do nó da categoria ancestral. |
|
categoryTreeNodeLevel
|
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel | integer |
Nível absoluto do nó da categoria ancestral na hierarquia de sua árvore de categorias. |
|
Nível do nó da árvore de categorias
|
categorySuggestions.categoryTreeNodeLevel | integer |
Nível absoluto do nó da categoria ancestral na hierarquia de sua árvore de categorias. |
|
Relevância
|
categorySuggestions.relevancy | string |
Este campo está reservado para uso interno ou futuro. |
|
ID da árvore de categorias
|
categoryTreeId | string |
Identificador exclusivo da árvore de categorias do eBay a partir da qual as sugestões são retornadas. |
|
Versão da árvore de categorias
|
categoryTreeVersion | string |
A versão da árvore de categorias identificada por categoryTreeId. |
Oferta GET
Esta chamada recupera uma oferta específica publicada ou não publicada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da oferta
|
offerId | True | string |
Identificador exclusivo da oferta a ser recuperada. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Quantidade disponível
|
availableQuantity | integer |
Quantidade do item de estoque que estará disponível para compra pelos compradores. |
|
ID da categoria
|
categoryId | string |
Identificador exclusivo da categoria principal do eBay na qual o item de inventário está listado. |
|
Id de caridade
|
charity.charityId | string |
Identificador único atribuído pelo eBay da organização de caridade que receberá uma porcentagem das receitas de vendas. |
|
Percentagem de Doação
|
charity.donationPercentage | string |
Percentagem do preço de compra que a organização de caridade receberá por cada venda que o anúncio gerar. |
|
ID do Produto do Produtor
|
extendedProducerResponsibility.producerProductId | string |
Identificador único do produtor relacionado com o item. |
|
ID do pacote do produto
|
extendedProducerResponsibility.productPackageId | string |
ID único do produtor de qualquer embalagem relacionada com o produto adicionado pelo vendedor. |
|
ID do pacote de envio
|
extendedProducerResponsibility.shipmentPackageId | string |
Identificador único do produtor de qualquer embalagem utilizada pelo vendedor para enviar o artigo. |
|
ID da documentação do produto
|
extendedProducerResponsibility.productDocumentationId | string |
Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor. |
|
Moeda
|
extendedProducerResponsibility.ecoParticipationFee.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
extendedProducerResponsibility.ecoParticipationFee.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Formato
|
format | string |
Formato do anúncio da oferta |
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Este campo é retornado como true se o recurso de listagem privada tiver sido ativado para a oferta. |
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Este campo indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem. |
|
ID do anúncio
|
listing.listingId | string |
Identificador único da listagem do eBay associada à oferta publicada. |
|
Estado do anúncio
|
listing.listingStatus | string |
Status do anúncio associado à oferta publicada. |
|
Quantidade vendida
|
listing.soldQuantity | integer |
Quantidade de produto que foi vendida para a oferta publicada. |
|
Descrição do anúncio
|
listingDescription | string |
Descrição da listagem do eBay |
|
Duração do anúncio
|
listingDuration | string |
Este campo indica o número de dias em que o anúncio estará ativo. |
|
Moeda
|
listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Melhor Oferta Ativada
|
listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Este contentor é utilizado se o vendedor pretender suportar a funcionalidade Melhor Oferta no seu anúncio. |
|
eBay Plus se elegível
|
listingPolicies.eBayPlusIfEligible | boolean |
Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus. |
|
ID da Política de Cumprimento
|
listingPolicies.fulfillmentPolicyId | string |
O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
ID da Política de Pagamento
|
listingPolicies.paymentPolicyId | string |
O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
productCompliancePolicyIds
|
listingPolicies.productCompliancePolicyIds | array of string |
Este campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
ID da política de devolução
|
listingPolicies.returnPolicyId | string |
O identificador único indica a política comercial de devolução que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
shippingCostOverrides
|
listingPolicies.shippingCostOverrides | array of object |
Este contentor é utilizado se o vendedor pretender substituir os custos de envio por uma ou mais opções de serviço de envio nacional ou internacional definidas na política de listagem de cumprimentos. |
|
Moeda
|
listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Priority
|
listingPolicies.shippingCostOverrides.priority | integer |
O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com custos de envio atualizados. |
|
Moeda
|
listingPolicies.shippingCostOverrides.shippingCost.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
listingPolicies.shippingCostOverrides.shippingCost.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Tipo de Serviço de Envio
|
listingPolicies.shippingCostOverrides.shippingServiceType | string |
Este valor indica se o serviço de envio é uma opção de serviço de transporte nacional ou internacional. |
|
Retomar ID da política
|
listingPolicies.takeBackPolicyId | string |
O ID do vendedor criou uma política de retomada. |
|
Data de início do anúncio
|
listingStartDate | string |
Este carimbo de data/hora é a data/hora que o vendedor definiu para o anúncio agendado. |
|
Tamanho do Lote
|
lotSize | integer |
Este campo só é aplicável se a listagem for uma listagem de lotes. Uma listagem de lotes é uma listagem que tem várias quantidades do mesmo produto. |
|
ID do mercado
|
marketplaceId | string |
Identificador único do site do eBay no qual a oferta está disponível ou será disponibilizada. |
|
Chave de localização do comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
ID da oferta
|
offerId | string |
Identificador único da oferta. |
|
Moeda
|
pricingSummary.auctionReservePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
pricingSummary.auctionReservePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.auctionStartPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
pricingSummary.auctionStartPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.minimumAdvertisedPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
pricingSummary.minimumAdvertisedPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Originalmente vendido pelo preço de varejo em
|
pricingSummary.originallySoldForRetailPriceOn | string |
Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro. |
|
Moeda
|
pricingSummary.originalRetailPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
pricingSummary.originalRetailPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.price.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
pricingSummary.price.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Visibilidade de preços
|
pricingSummary.pricingVisibility | string |
Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Este campo só é aplicável se o vendedor desejar definir uma restrição à quantidade de compra de um item de inventário por vendedor. |
|
ID da categoria secundária
|
secondaryCategoryId | string |
Identificador único para uma categoria secundária e aplicável se o vendedor decidir listar o item em duas categorias. |
|
SKU
|
sku | string |
Valor de SKU definido pelo vendedor do produto na oferta. |
|
Situação
|
status | string |
O valor especifica o status da oferta. |
|
Nomes de categorias de lojas
|
storeCategoryNames | array of string |
Nome da categoria da loja |
|
Aplicar Imposto
|
tax.applyTax | boolean |
Este campo será incluído se o vendedor pretender fazer referência ao seu Imposto sobre Vendas ao nível da conta |
|
Categoria de Imposto de Terceiros
|
tax.thirdPartyTaxCategory | string |
O código da categoria de exceção de imposto. Se este campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa, e não apenas ao preço do item. |
|
Percentagem de IVA
|
tax.vatPercentage | number |
Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio. |
Ofertas GET
Esta chamada recupera todas as ofertas existentes para o valor de SKU especificado. O vendedor tem a opção de limitar as ofertas que são recuperadas a um mercado específico do eBay ou a um formato de anúncio.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor de SKU definido pelo vendedor |
|
ID do mercado
|
marketplace_id | string |
Identificador único do mercado eBay. |
|
|
Formato
|
format | string |
Formato do anúncio da oferta. |
|
|
Limite
|
limit | string |
Número máximo de registos a devolver por página de dados. |
|
|
Compensação
|
offset | string |
Número da página a recuperar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
URL para a página atual de ofertas. |
|
Limite
|
limit | integer |
Número de ofertas que serão exibidas em cada página de resultados. |
|
Next
|
next | string |
URL para a próxima página de ofertas. |
|
offers
|
offers | array of object |
Este contêiner é uma matriz de ofertas de um ou mais vendedores para o valor de SKU. |
|
Quantidade disponível
|
offers.availableQuantity | integer |
Quantidade de item de estoque que estará disponível para compra. |
|
ID da categoria
|
offers.categoryId | string |
ID exclusivo da categoria do eBay em que o item de inventário está listado. |
|
Id de caridade
|
offers.charity.charityId | string |
Identificador único atribuído pelo eBay da organização de caridade que receberá uma percentagem das receitas das vendas. |
|
Percentagem de Doação
|
offers.charity.donationPercentage | string |
Percentagem do preço de compra que a organização de caridade receberá por cada venda. |
|
ID do Produto do Produtor
|
offers.extendedProducerResponsibility.producerProductId | string |
Identificador único do produtor relacionado com o item. |
|
ID do pacote do produto
|
offers.extendedProducerResponsibility.productPackageId | string |
ID exclusivo do produto embalado adicionado pelo vendedor. |
|
ID do pacote de envio
|
offers.extendedProducerResponsibility.shipmentPackageId | string |
Identificador único do produtor de qualquer embalagem utilizada pelo vendedor para enviar o artigo. |
|
ID da documentação do produto
|
offers.extendedProducerResponsibility.productDocumentationId | string |
Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor. |
|
Moeda
|
offers.extendedProducerResponsibility.ecoParticipationFee.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.extendedProducerResponsibility.ecoParticipationFee.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Formato
|
offers.format | string |
Este valor define o formato de listagem para a oferta |
|
Ocultar detalhes do comprador
|
offers.hideBuyerDetails | boolean |
Este campo é retornado como true se o recurso de listagem privada tiver sido ativado para a oferta. |
|
Incluir detalhes do produto do catálogo
|
offers.includeCatalogProductDetails | boolean |
Este campo indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem. |
|
ID do anúncio
|
offers.listing.listingId | string |
Identificador único da listagem do eBay associada à oferta publicada. |
|
Estado do anúncio
|
offers.listing.listingStatus | string |
Status do anúncio associado à oferta publicada. |
|
Quantidade vendida
|
offers.listing.soldQuantity | integer |
Quantidade de produto que foi vendida para a oferta publicada. |
|
Descrição do anúncio
|
offers.listingDescription | string |
Descrição do anúncio do eBay. |
|
Duração do anúncio
|
offers.listingDuration | string |
Indica o número de dias em que a listagem estará ativa. |
|
Moeda
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Melhor Oferta Ativada
|
offers.listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Este campo indica se a funcionalidade Melhor Oferta está ou não ativada para o anúncio. |
|
eBay Plus se elegível
|
offers.listingPolicies.eBayPlusIfEligible | boolean |
Este campo é incluído numa oferta e definido como true se um vendedor Top-Rated optar pelo programa eBay Plus |
|
ID da Política de Cumprimento
|
offers.listingPolicies.fulfillmentPolicyId | string |
O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay. |
|
ID da Política de Pagamento
|
offers.listingPolicies.paymentPolicyId | string |
O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
productCompliancePolicyIds
|
offers.listingPolicies.productCompliancePolicyIds | array of string |
Este campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
ID da política de devolução
|
offers.listingPolicies.returnPolicyId | string |
O identificador único indica a política comercial de devolução que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay. |
|
shippingCostOverrides
|
offers.listingPolicies.shippingCostOverrides | array of object |
Este contêiner é usado se o vendedor desejar substituir os custos de envio ou sobretaxa para uma ou mais opções de serviço de transporte doméstico ou internacional definidas na política de listagem de cumprimento. |
|
moeda
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
moeda |
|
valor
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
valor |
|
priority
|
offers.listingPolicies.shippingCostOverrides.priority | integer |
priority |
|
moeda
|
offers.listingPolicies.shippingCostOverrides.shippingCost.currency | string |
moeda |
|
valor
|
offers.listingPolicies.shippingCostOverrides.shippingCost.value | string |
valor |
|
shippingServiceType
|
offers.listingPolicies.shippingCostOverrides.shippingServiceType | string |
shippingServiceType |
|
Retomar ID da política
|
offers.listingPolicies.takeBackPolicyId | string |
ID do vendedor que criou a política de retomada. |
|
Data de início do anúncio
|
offers.listingStartDate | string |
Data/hora que o vendedor definiu para o anúncio agendado. |
|
Tamanho do Lote
|
offers.lotSize | integer |
Este campo só é aplicável e devolvido se a listagem for uma listagem de lotes. |
|
ID do mercado
|
offers.marketplaceId | string |
Identificador único do site do eBay no qual a oferta está disponível ou será disponibilizada. |
|
Chave de localização do comerciante
|
offers.merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
ID da oferta
|
offers.offerId | string |
Identificador único da oferta. |
|
Moeda
|
offers.pricingSummary.auctionReservePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.pricingSummary.auctionReservePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.auctionStartPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.pricingSummary.auctionStartPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.minimumAdvertisedPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.pricingSummary.minimumAdvertisedPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Originalmente vendido pelo preço de varejo em
|
offers.pricingSummary.originallySoldForRetailPriceOn | string |
Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro. |
|
Moeda
|
offers.pricingSummary.originalRetailPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.pricingSummary.originalRetailPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.price.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Valor
|
offers.pricingSummary.price.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Visibilidade de preços
|
offers.pricingSummary.pricingVisibility | string |
Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
Limite de quantidade por comprador
|
offers.quantityLimitPerBuyer | integer |
Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à quantidade de compra de um item de inventário por vendedor. |
|
ID da categoria secundária
|
offers.secondaryCategoryId | string |
Identificador exclusivo para uma categoria secundária. |
|
SKU
|
offers.sku | string |
Valor de SKU definido pelo vendedor do produto na oferta. |
|
Situação
|
offers.status | string |
O valor especifica o status da oferta. |
|
storeCategoryNomes
|
offers.storeCategoryNames | array of string |
Este recipiente é devolvido se o vendedor optar por colocar o item de inventário em uma ou duas categorias de lojas do eBay que o vendedor tenha configurado para sua loja do eBay |
|
Aplicar Imposto
|
offers.tax.applyTax | boolean |
Este campo será incluído se o vendedor pretender consultar a Tabela de Impostos sobre Vendas ao nível da conta para calcular o imposto sobre vendas de uma encomenda. |
|
Categoria de Imposto de Terceiros
|
offers.tax.thirdPartyTaxCategory | string |
Código da categoria de exceção fiscal. |
|
Percentagem de IVA
|
offers.tax.vatPercentage | number |
Valor da taxa de Imposto sobre Valor Agregado (IVA) para o item, se houver. |
|
Anterior
|
prev | string |
URL para a página anterior de ofertas. |
|
Tamanho
|
size | integer |
Número de ofertas exibidas na página atual de resultados. |
|
Total
|
total | integer |
Número total de ofertas existentes para o valor de SKU especificado. |
Publicar oferta
Esta chamada é usada para converter uma oferta não publicada em uma oferta publicada ou listagem ao vivo do eBay. O identificador exclusivo da oferta (offerId) é passado no final do URI de chamada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da oferta
|
offerId | True | string |
Identificador único da oferta a publicar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do anúncio
|
listingId | string |
Identificador único da listagem recém-criada do eBay. |
|
Advertências
|
warnings | array of object |
Este contentor será devolvido se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro. |
|
Domínio
|
warnings.domain | string |
O nome do domínio no qual ocorreu o erro ou aviso. |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | string |
O nome do subdomínio no qual ocorreu o erro ou aviso. |
Retirar Oferta
Esta chamada é usada para encerrar uma listagem de variação única associada à oferta especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da oferta
|
offerId | True | string |
Identificador único da oferta a retirar. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do anúncio
|
listingId | string |
Identificador único da listagem do eBay associada à oferta que foi retirada. |
|
Advertências
|
warnings | array of object |
Este contentor será devolvido se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Este contentor será devolvido se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
valor
|
warnings.parameters.value | string |
valor |
|
Subdomain
|
warnings.subdomain | string |
O nome do subdomínio no qual ocorreu o erro ou aviso. |
Definições
cadeia (de caracteres)
Este é o tipo de dados básico 'string'.