Detalhes da Conexão do Amazon Marketplace¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte à versão do Amazon Marketplace

O conector utiliza a API do Amazon Marketplace para habilitar o acesso bidirecional ao Amazon Marketplace.

Estabelecendo uma Conexão¶

Conectando-se ao Amazon Marketplace¶

API do Amazon MWS X API do Parceiro de Vendas¶

A API Amazon MWS ( Marketplace Web Services) é a API mais antiga para o Amazon Marketplace, enquanto a API Selling Partner (SP) fornece várias melhorias em relação à API MWS, incluindo padrões de design de API REST baseados em JSON e OAuth 2.0. SP- API inclui todas as funcionalidades disponíveis na API do Amazon MWS.

Você pode especificar a qual API se conectar definindo Schema. Esteja ciente de que cada API tem diferentes opções de conexão disponíveis, conforme descrito abaixo.

Conectando-se à API do Parceiro de Vendas¶

Ao usar a API Amazon Selling Partner para se conectar ao Amazon Marketplace, as seguintes propriedades são necessárias:

• Schema: Defina para SellingPartner.
• InitiateOAuth: Defina como GETANDREFRESH.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.

Além disso, você pode usar o SellingPartner imóvel a escolher Seller ou Vendor autenticação.

Conectando-se à API do MWS¶

Ao usar a API do Amazon MWS para conectar-se ao Amazon Marketplace, SellerId, Marketplace, Marketplace são propriedades de conexão obrigatórias. Definir Schema para Marketplace.

Configurar o Acesso ao Amazon Marketplace¶

Para se conectar ao Amazon Marketplace, primeiro autorize o desenvolvedor. Para isso siga os passos abaixo:

• Usando o ID do desenvolvedor do MWS: 195280669143.
• Vou ao Manage your apps no Seller Central e faça login na sua conta de vendedor da Amazon como titular principal da conta.
• Clique no Authorize new developer e segue o workflow de autorização usando o ID do desenvolvedor fornecido pelo conector.

Ou você pode ir para Amazon Marketplace Driver e clique em Authorize Now no painel direito.

Obtendo o MWS Auth Token¶

Para obter o MWS Auth Token, siga os passos abaixo:

• Vou ao Manage your apps no Seller Central e faça login na sua conta de vendedor da Amazon como titular principal da conta.
• Encontre o aplicativo.
• Na coluna MWS Auth Token, clique em View.

Obtendo o ID do Vendedor¶

Para obter o ID do vendedor siga os passos abaixo:

• Entre na sua conta de vendedor.
• Selecione Settings, então Account Info no canto superior direito da tela.
• Sob Business Information selecione "Seu token de comerciante".

Autenticar uma Conta do Amazon Marketplace¶

Defina as seguintes propriedades de conexão para conectar:

• SellerId: Defina o ID do vendedor das configurações do serviço da web do Amazon marketplace.
• Marketplace: Defina a localização do mercado da Amazon (Estados Unidos, Canadá, Japão, etc.).
• Schema: Definir esquema para Marketplace.

Autenticar Usando Autenticação OAuth¶

O Amazon Marketplace usa o padrão de autenticação OAuth.

Para autenticar usando OAuth, você precisará usar as Credenciais incorporadas ou crie um novo aplicativo OAuth personalizado (consulte Criando um aplicativo OAuth personalizado).

Política de Retenção de Dados do Amazon Marketplace¶

Por segurança, o Amazon Marketplace restringe o acesso a PII (Informações de identificação pessoal). Você só pode reter PII por 30 dias após a entrega do pedido e apenas para o propósito de, e enquanto for necessário para

• cumprir ordens
• calcular e remeter impostos
• emitir notas fiscais
• atender aos requisitos legais, incluindo requisitos fiscais ou regulamentares.

Se você for obrigado por lei a reter cópias arquivadas de PII para fins fiscais ou outros fins regulatórios, você deve armazenar as PII como um backup criptografado "frio" ou off-line (por exemplo, não disponível para uso imediato ou interativo).

Isso significa, por exemplo, que o driver do Amazon Marketplace não exibe mais as informações do endereço de entrega do cliente após 30 dias. Consulte a documentação da Amazon para obter mais informações:

Política de proteção de dados do Amazon Marketplace

Usando Autenticação OAuth¶

Use o padrão de autenticação OAuth para se conectar ao Amazon Marketplace. Você pode autenticar com uma conta de usuário ou uma conta de serviço. O conector facilita isso conforme descrito abaixo.

Usando uma Conta de Usuário para Autenticar no Amazon Marketplace¶

O fluxo da conta do usuário exige que o usuário autenticado interaja com o Amazon Marketplace por meio do navegador.

Credenciais Incorporadas¶

Consulte Credenciais incorporadas para se conectar com as credenciais incorporadas do conector e pule a criação de um aplicativo OAuth personalizado.

Credenciais Personalizadas¶

Em vez de se conectar com as credenciais incorporadas do conector, você pode registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret. Você também pode usar o OAuthAppStatus imóvel a escolher draft ou published status. Você deve especificar essa propriedade ao usar credenciais personalizadas.

Quando Criar um Aplicativo OAuth Personalizado¶

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Amazon Marketplace e você pode se conectar com suas credenciais incorporadas. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no endpoint OAuth do Amazon Marketplace para conceder permissões ao conector.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Incorporadas¶

Autenticar Usando as Credenciais OAuth Incorporadas¶

Autenticação de Desktop com o Aplicativo OAuth Incorporado¶

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário. Depois de definir o seguinte, você está pronto para se conectar:

• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar a repetição da troca OAuth e definir manualmente o OAuthAccessToken.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth.

1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Credenciais Personalizadas¶

Você pode usar um aplicativo OAuth personalizado para autenticar com uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Autenticar com uma Conta de Usuário¶

Autenticação de Desktop com um Aplicativo OAuth Personalizado¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha e atualize o token de acesso OAuth

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.
• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• AppId: ID do aplicativo para o aplicativo do parceiro de vendas que você criou.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.
• AWSAccessKey: Esta é a chave de acesso vinculada ao usuário da AWS que está associado ao OAuthClientId.
• AWSSecretKey: Esta é a chave secreta vinculada ao usuário da AWS que está associado ao OAuthClientId.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
2. Atualiza o token de acesso quando ele expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

As seções a seguir mostram como autenticar um servidor headless ou outra máquina na qual o conector não pode abrir um navegador. Você pode autenticar com uma conta de usuário ou com uma conta de serviço.

Autenticar com uma Conta de Usuário¶

Para autenticar com uma conta de usuário, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais OAuth Incorporadas¶

Obtenha um código verificador

Siga as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade da conexão:

1. Clique no link a seguir para abrir o endpoint Amazon Marketplace OAuth em seu navegador.
2. Efetue login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador como valor para 'spapi_oauth_code'.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth.

• OAuthVerifier: Defina isso para o código do verificador.
• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.
• AppId: ID do aplicativo para o aplicativo do parceiro de vendas que você criou.
• AWSAccessKey: Esta é a chave de acesso vinculada ao usuário da AWS que está associado ao OAuthClientId.
• AWSSecretKey: Esta é a chave secreta vinculada ao usuário da AWS que está associado ao OAuthClientId.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.

Teste a conexão para autenticar no navegador. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.
• AppId: ID do aplicativo para o aplicativo do parceiro de vendas que você criou.
• AWSAccessKey: Esta é a chave de acesso vinculada ao usuário da AWS que está associado ao OAuthClientId.
• AWSSecretKey: Esta é a chave secreta vinculada ao usuário da AWS que está associado ao OAuthClientId.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

A criação de um aplicativo OAuth customizado é opcional no fluxo OAuth headless; você pode ignorar a criação de um aplicativo conectando-se com as credenciais OAuth incorporadas do conector. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no Amazon Marketplace para conceder permissões ao conector.

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Defina como DESLIGADO.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador como valor para 'spapi_oauth_code'.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.
• AppId: ID do aplicativo para o aplicativo do parceiro de vendas que você criou.
• AWSAccessKey: Esta é a chave de acesso vinculada ao usuário da AWS que está associado ao OAuthClientId.
• AWSSecretKey: Esta é a chave secreta vinculada ao usuário da AWS que está associado ao OAuthClientId.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• Marketplace: Defina isso para a região do Marketplace em que você está registrado para vender.
• Schema: Defina como 'SellingPartner' para se conectar ao SP- API.
• AppId: ID do aplicativo para o aplicativo do parceiro de vendas que você criou.
• AWSAccessKey: Esta é a chave de acesso vinculada ao usuário da AWS que está associado ao OAuthClientId.
• AWSSecretKey: Esta é a chave secreta vinculada ao usuário da AWS que está associado ao OAuthClientId.

Criando um Aplicativo OAuth Personalizado¶

Você pode usar um aplicativo OAuth personalizado para autenticar uma conta de serviço ou uma conta de usuário. Consulte Usando autenticação OAuth Para maiores informações.

Crie um Aplicativo OAuth para Autenticação de Conta de Usuário¶

Siga o procedimento abaixo para registrar um aplicativo e obter o OAuthClientId e OAuthClientSecret.

Crie um Aplicativo OAuth Personalizado¶

1. Faça login no Console do parceiro de vendas e abra Develop Apps from Apps & Services.

2. Clique em Add new app client.

3. Forneça o nome do aplicativo e selecione SP-API como o tipo de API.

4. Forneça o IAM ARN para a conta da AWS e selecione os vendedores.

5. Forneça valores de URI de login OAuth e URI de redirecionamento OAuth. Depois de criar o aplicativo, o OAuthClientId e OAuthClientSecret são exibidos em LWA credentials.

Para uma leitura mais aprofundada sobre como criar um aplicativo OAuth personalizado e configurar a papel IAM, consulte o Guia do parceiro de vendas da Amazon.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector do Amazon Marketplace.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Amazon Marketplace permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Orders WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Jitterbit Connector for Amazon Marketplace modela objetos do Amazon Marketplace como tabelas relacionais e exibições. Um objeto do Amazon Marketplace tem relacionamentos com outros objetos; nas tabelas, esses relacionamentos são expressos por meio de chaves estrangeiras. As seções a seguir mostram os objetos de API disponíveis e fornecem mais informações sobre a execução de SQL para APIs do Amazon Marketplace.

Os esquemas para a maioria dos objetos de banco de dados são definidos em arquivos de configuração simples baseados em texto.

O conector transfere o máximo possível do processamento da instrução SELECT para as APIs do Amazon Marketplace e processa o restante da consultar na memória. Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Usando a API do Marketplace

Consulte Modelo de dados do Marketplace para as entidades disponíveis na API do Marketplace.

Usando a API SellingPartner

Consulte Modelo de dados do parceiro de vendas para as entidades disponíveis no Selling Partner API.

Modelo de Dados do Marketplace¶

O Jitterbit Connector for Amazon Marketplace modela a API do Amazon Marketplace como exibições relacionais e procedimentos armazenados.

Para usar o Modelo de Dados do Marketplace, basta definir Schema para o Marketplace.

Visualizações¶

Visualizações são tabelas que não podem ser modificadas, como Pedidos, Produtos. Normalmente, os dados do modelo que são somente leitura e não podem ser atualizados são mostrados como exibições.

Procedimentos Armazenados¶

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para a fonte de dados. Eles podem ser usados para pesquisar, atualizar e modificar informações na fonte de dados.

Usando Relatórios¶

Os relatórios criados podem ser expostos como exibições definindo IncludeReports propriedade da conexão como true. Os relatórios podem ser criados com o procedimento armazenado RequestReport.

Após um relatório ter sido criado e concluído o processamento com um status _DONE_, ele será exposto como uma visualização com o nome "Relatório{ReportType}{ReportID}".

Somente relatórios delimitados por tabulações podem ser usados como exibições. Você pode encontrar uma lista completa de relatórios aqui: Tipos de relatórios.

Para evitar throttling de API, é sugerido usar o CreateSchema procedimento armazenado* para criar esquemas de tabelas de relatórios.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Amazon Marketplace¶

FeedSubmissionList¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM FeedSubmissionList WHERE FeedSubmissionId = '50377017868'

SELECT * FROM FeedSubmissionList WHERE FeedType = '_POST_PRODUCT_DATA_

SELECT * FROM FeedSubmissionList WHERE SubmittedDate = '2018-12-03T09:42:06'

SELECT * FROM FeedSubmissionList WHERE FeedProcessingStatus = '_DONE_'

Colunas¶

FeedSubmissionResult¶

A operação GetFeedSubmissionResult retorna o relatório de processamento de feed para um feed específico.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM FeedSubmissionResult WHERE FeedSubmissionId = '50377017868'

Colunas¶

Itens de Envio de Entrada¶

Retorna uma lista de itens em uma remessa de entrada especificada.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Remessas de Entrada¶

Retorna uma lista de remessas de entrada com base nos critérios especificados por você.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Fornecimento de Estoque¶

Retorna informações sobre a disponibilidade de estoque que um vendedor possui na rede de atendimento da Amazon e nas remessas de entrada atuais. Você pode verificar o status de disponibilidade atual para o seu inventário Fulfillment by Amazon, bem como descobrir quando o status de disponibilidade muda.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM InventorySupply WHERE SellerSKU = 'Stest'

SELECT * FROM InventorySupply WHERE  QueryStartDateTime = '2016-03-16'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Itens de Ordem¶

Retorna itens do pedido com base no ID do pedido da Amazon que você especificar.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. A tabela OrderItems oferece suporte à filtragem do lado do servidor com os operadores = e IN para o campo AmazonOrderId. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

SELECT * FROM OrderItems WHERE AmazonOrderId IN ('503-9993250-1405404', '503-9993250-1405404')

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pedidos¶

Retorna pedidos criados ou atualizados durante um intervalo de tempo especificado por você.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Colunas¶

Produtos¶

A Tabela de produtos ajuda você a obter informações para corresponder seus produtos às listas de produtos existentes nos sites do Amazon Marketplace.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM Products WHERE SearchTerms = '249-7638334-8161403'

SELECT * FROM Products WHERE idType = 'SellerSKU' AND idlist = '{SellerSku code}'

SELECT * FROM Products WHERE idType = 'ASIN' AND idlist = '{ASIN code}'

SELECT * FROM Products WHERE idType = 'GCID' AND idlist = '{GCID code}'

SELECT * FROM Products WHERE idType = 'UPC' AND idlist = '{UPC code}'

SELECT * FROM Products WHERE idType = 'EAN' AND idlist = '{EAN code}'

SELECT * FROM Products WHERE idType = 'ISBN' AND idlist = '{ISBN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist = '{JAN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist IN ('{JAN code}', '{ISBN code}', '{GCID code}')

Colunas¶

ReportList¶

Informações de uso para a operação ReportList.rsd.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM ReportList WHERE ReportType IN '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportList WHERE AvailableDate > '2016-12-12' AND AvailableDate< '2018-11-12 12:00:00'

SELECT * FROM ReportList WHERE AvailableDate >= '2016-12-12' AND Acknowledged = 'true'

Colunas¶

ReportRequestList¶

Informações de uso para a operação ReportRequestList.rsd.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM ReportRequestList WHERE ReportType = '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportRequestList WHERE ReportType IN ('_GET_MERCHANT_LISTINGS_INACTIVE_DATA_', '_GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_')

SELECT * FROM ReportRequestList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportRequestList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12'

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12' and RequestedDate > '2018-12-12 13:00'

SELECT * FROM ReportRequestList WHERE RequestedDate <= '2016-12-12' AND ReportProcessingStatus = '_DONE_'

SELECT * FROM ReportRequestList WHERE ReportProcessingStatus IN ('_DONE_', '_SUBMITTED_', '_CANCELLED_')

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Amazon Marketplace¶

CancelFeed¶

O CancelFeed cancela um ou mais envios de feed e retorna uma contagem dos envios de feed cancelados e as informações de envio de feed. Observe que, se você não especificar um FeedSubmmissionId, todos os envios de feed serão cancelados.

Entrada¶

Colunas do Conjunto de Resultados¶

CancelReportRequests¶

A operação CancelReportRequests cancela uma ou mais solicitações de relatório e retorna o número de solicitações de relatório canceladas e informações de solicitação de relatório.

Entrada¶

Colunas do Conjunto de Resultados¶

Criar Esquema¶

Cria um arquivo de esquema para a tabela ou exibição especificada.

Entrada¶

Colunas do Conjunto de Resultados¶

ObterRelatório¶

Cria e/ou retorna dados para um relatório específico.

Executar¶

Podemos usar GetReport procedimento armazenado* de duas maneiras:
Para criar e baixar um relatório, nesse caso, você deve definir pelo menos os atributos ReportType, StartDate e DownloadPath. O procedimento armazenado* aguardará até que o relatório seja processado no lado do servidor.

EXEC GetReport
@ReportType = '_GET_FLAT_FILE_ORDERS_DATA_',
@StartDate = '08-27-2020',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Para baixar um relatório existente, nesse caso, você deve definir pelo menos os atributos ReportID e DownloadPath para ex:

EXEC GetReport
@ReportID = '50815018501',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Note: Este procedimento faz uso de indexed parameters. Esses parâmetros de entrada são indicados com um # no final de seus nomes.

Os parâmetros indexados facilitam o fornecimento de várias instâncias de um único parâmetro como entradas para o procedimento.

Suponha que haja um parâmetro de entrada chamado Param#. Insira várias instâncias de um parâmetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Entrada

Colunas do conjunto de resultados

Solicitar Relatório¶

A operação RequestReport cria uma solicitação de relatório.

Note: Este procedimento faz uso de indexed parameters. Esses parâmetros de entrada são indicados com um # no final de seus nomes.

Os parâmetros indexados facilitam o fornecimento de várias instâncias de um único parâmetro como entradas para o procedimento.

Suponha que haja um parâmetro de entrada chamado Param#. Insira várias instâncias de um parâmetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Entrada¶

Colunas do Conjunto de Resultados¶

EnviarImageFeed¶

O feed de imagens permite fazer upload de várias imagens para um produto. A Amazon pode exibir várias imagens para cada produto.

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO ImageFeedAggregate#TEMP (SKU,ImageType,ImageLocation,OperationType) VALUES ('15700','Main','https://www.cdata.com/ui/img/home/adapters.png','Update')

Em seguida, execute o procedimento especificando o valor de ImageFeedAggregate com o nome da tabela #TEMP usada ImageFeedAggregate#TEMP.

EXEC SubmitImageFeed ProductImageFeedAggregate = 'ImageFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

Enviar Feed de Inventário¶

O feed de estoque permite que você atualize as quantidades de estoque (níveis de estoque) para seus itens.

Executar¶

O Driver utiliza as tabelas #TEMP como campos para agregar as informações inseridas.

Você deve incluir em sua consultar:

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('15700',11 ,'2')

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('99987867',10 ,'2')

Em seguida, você executa o procedimento especificando o valor de InventoryFeedAggregate com o nome da tabela #TEMP usada InventoryFeed#TEMP.

EXEC SubmitInventoryFeed InventoryFeedAggregate='InventoryFeed#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarPedidoReconhecimentoFeed¶

O feed de Reconhecimento de Pedido permite que você confirme seu sucesso ou falha ao baixar um pedido.

Executar¶

O Driver utiliza as tabelas #TEMP como campos para agregar as informações inseridas.

Você deve incluir em sua consultar:

INSERT INTO OrderAcknowledgementFeedAggregate#TEMP (AmazonOrderId,StatusCode,AmazonOrderItemCode,CancelReason) VALUES ('249-6070298-2783041','Failure','25959136016214','NoInventory')

Em seguida, execute o procedimento especificando o valor de OrderAcknowledgementFeedAggregate com o nome da tabela #TEMP usada OrderAcknowledgementFeedAggregate#TEMP.

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate = 'OrderAcknowledgementFeedAggregate#TEMP'

As informações agregadas podem ser inseridas especificando-as neste formato XML

<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate='<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>'

Entrada

Colunas do conjunto de resultados

EnviarOrderAdjustmentFeed¶

O feed de ajuste de pedido permite que você emita um reembolso (ajuste) para um pedido. Você deve fornecer um motivo para o ajuste, como Devolução do cliente e o valor do ajuste, discriminado por componente de preço (principal, frete, imposto e assim por diante).

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO ItemPriceAdjustmentsAggregate#TEMP (ItemPriceAdjustmentsComponentType,ItemPriceAdjustmentsComponentAmount,ItemPriceAdjustmentsComponentAmountCurrency) VALUES ('Shipping','150','JPY')

INSERT INTO AdjustedItemAggregate#TEMP (AdjustedItemAmazonOrderItemCode,AdjustedItemAdjustmentReason,ItemPriceAdjustmentsAggregate) VALUES ('25959136016214','CustomerReturn','ItemPriceAdjustmentsAggregate#TEMP')

INSERT INTO OrderAdjustmentFeedAggregate#TEMP (AmazonOrderID,OperationType,AdjustedItemAggregate) VALUES ('249-6070298-2783041','Update','AdjustedItemAggregate#TEMP')

Em seguida, execute o procedimento especificando o valor de OrderAdjustmentFeedAggregate com o nome da tabela #TEMP usada OrderAdjustmentFeedAggregate#TEMP.

EXEC SubmitOrderAdjustmentFeed OrderAdjustmentFeedAggregate = 'OrderAdjustmentFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarPedidoFulfillmentFeed¶

O feed de atendimento de pedidos permite que seu sistema atualize o sistema da Amazon com informações de atendimento de pedidos.

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO ItemAggregate#TEMP (ItemAmazonOrderItemCode,ItemQuantity) VALUES ('25959136016214','1');

INSERT INTO OrderFulfillmentFeedAggregate#TEMP (AmazonOrderID,FulfillmentDate,FulfillmentDataCarrierName,FulfillmentDataShippingMethod,FulfillmentDataShipperTrackingNumber,ItemAggregate) VALUES ('249-6070298-2783041','2017-02-01T00:00:00Z',' Delivery Company','Normal Delivery','1223525345234','ItemAggregate#TEMP')

Em seguida, execute o procedimento especificando o valor de OrderFulfillmentFeedAggregate com o nome da tabela #TEMP usada OrderFulfillmentFeedAggregate#TEMP.

EXEC SubmitOrderFulfillmentFeed OrderFulfillmentFeedAggregate = 'OrderFulfillmentFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarOverrideFeed¶

O feed de substituição permite que você defina uma exceção para as configurações de frete no nível da conta para um produto individual (SKU).

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,IsShippingRestricted) VALUES ('Std JP Kanto8','true')

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,Type,ShipAmount,ShipAmountCurrency) VALUES ('Std JP Kantoa8','Exclusive','400.0','JPY')

INSERT INTO OverrideFeedAggregate#TEMP (SKU,OperationType,ShippingOverrideAggregate) VALUES ('15700','Update','ShippingOverrideAggregate#TEMP')

Em seguida, execute o procedimento especificando o valor de OverrideFeedAggregate com o nome da tabela #TEMP usada OverrideFeedAggregate#TEMP.

EXEC SubmitOverrideFeed OverrideFeedAggregate = 'OverrideFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarPriceFeed¶

O feed Preço permite definir o preço atual e o preço de venda (quando aplicável) de um item.

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('15700','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('99987867','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

Em seguida, você executa o procedimento especificando o valor de PriceFeedAggregate com o nome da tabela #TEMP usada PriceFeedAggregate#TEMP.

EXEC SubmitPriceFeed PriceFeedAggregate = 'PriceFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarProdutoFeed¶

O feed de produtos contém informações descritivas sobre os produtos em seu catálogo. Essas informações permitem que a Amazon crie um registro e atribua um identificador exclusivo conhecido como ASIN (Amazon Standard Item Number) a cada produto.

Executar¶

O Driver utiliza as tabelas #TEMP como campos para agregar as informações inseridas.

SubmitProductFeed Tem dois agregados principais que precisam ser inseridos.

• ProductDescriptionDataAggregate
• ProductDataAggregate

Você deve incluir em sua consultar:

As informações ProductDescriptionDataAggregate precisam ser inseridas usando a tabela temporária ProductDescriptionDataAggregate#TEMP.

INSERT INTO ProductDescriptionDataAggregate#TEMP (Title,Brand,Description,BulletPoint,Manufacturer) VALUES ('test Title','test Brand','test Description','test BulletPoint','test Manufacturer')

As informações do ProductDataAggregate variam de acordo com a categoria usada. A lista de todos os XSD fornecidos pela amazon pode ser encontrada aqui https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Product.xsd

Este exemplo usará a categoria Esportes https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Sports.xsd

Para adicionar um ProductData válido, Sports.xsd deve ser seguido completamente e o agregado xml deve ser criado corretamente. Este exemplo tem os seguintes dados do produto

• ProductType = SportingGoods
• Parentesco = Pai
• VariationTheme = Size (com base no ProductType selecionado, alguns dos VariationTheme serão inválidos. Neste exemplo, a variação de Design é inválida.)
• Tamanho = S
• MaterialComposition = Metal

Seguindo a ordem do arquivo Sports.xsd XSD, o agregado é:

<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>

Este Agregado é o valor de ProductDataAggregate.

INSERT INTO ProductFeedAggregate#TEMP(SKU,ProductDescriptionDataAggregate,ProductDataAggregate) VALUES ('test SKU','ProductDescriptionDataAggregate#TEMP','<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>')

Em seguida, execute o procedimento especificando o valor de ProductFeedAggregate com o nome da tabela #TEMP usada ProductFeedAggregate#TEMP.

EXEC SubmitProductFeed ProductFeedAggregate = 'ProductFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarRelacionamentoFeed¶

O feed Relacionamento permite configurar relacionamentos opcionais entre itens em seu catálogo.

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationshipFeedAggregate#TEMP(ParentSKU,RelationAggregate) VALUES ('15700','RelationAggregate#TEMP')

Em seguida, execute o procedimento especificando o valor de RelationshipFeedAggregate com o nome da tabela #TEMP usada RelationshipFeedAggregate#TEMP.

EXEC SubmitRelationshipFeed RelationshipFeedAggregate = 'RelationshipFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

EnviarSourcingOnDemandFeed¶

Informações de uso para a operação SubmitSourcingOnDemandFeed.rsb.

Executar¶

O Driver usa tabelas #TEMP como campos para agregar informações inseridas

Você deve incluir em sua consultar:

INSERT INTO OrderSourcingOnDemandFeedAggregate#TEMP (AmazonOrderID,SKU,EstimatedShipDate) VALUES ('250-4747727-9303810','15700','2018-12-08T00:00:00Z');

Em seguida, execute o procedimento especificando o valor de OrderSourcingOnDemandFeedAggregate com o nome da tabela #TEMP usada OrderSourcingOnDemandFeedAggregate#TEMP.

EXEC SubmitSourcingOnDemandFeed OrderSourcingOnDemandFeedAggregate = 'OrderSourcingOnDemandFeedAggregate#TEMP'

Entrada

Colunas do conjunto de resultados

Modelo de Dados do Parceiro de Vendas¶

O Conector Jitterbit para Amazon Marketplace modela a API do Parceiro de Vendas como exibições relacionais e procedimentos armazenados.

Para usar o modelo de dados do parceiro de vendas da Amazon, basta definir Schema para SellingPartner.

Visualizações¶

Visualizações são tabelas que não podem ser modificadas, como Pedidos, Produtos. Normalmente, os dados que são somente leitura e não podem ser atualizados são mostrados como exibições.

Procedimentos Armazenados¶

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para a fonte de dados. Eles podem ser usados para pesquisar, atualizar e modificar informações na fonte de dados.

Usando Relatórios¶

Os relatórios podem ser expostos como exibições definindo IncludeReports propriedade da conexão como true. Uma exibição será exposta para cada tipo de relatório especificado em ReportTypes propriedade de conexão. Para incluir vários relatórios, você também pode especificar uma categoria de tipo de relatório, que pode ser recuperada da exibição ReportTypes.

Essas exibições podem ser consultadas usando os parâmetros de data e hora necessários 'DataStartTime' e 'DataEndTime'. O driver procurará automaticamente um relatório existente que corresponda ao intervalo especificado e, se não for encontrado, um novo relatório será criado. Os relatórios podem ser criados manualmente com o procedimento armazenado RequestReport. Você também pode usar a pseudocoluna agregada JSON ReportOptions para especificar campos adicionais que podem ser necessários dependendo do tipo de relatório. Para obter mais detalhes sobre as opções de relatório, consulte Documentação da API de parceiro de vendas da Amazon

Depois que um relatório for criado e enviado para o conjunto de resultados, na próxima vez que você consultar esse tipo de relatório com os mesmos filtros, o relatório criado anteriormente será baixado em vez de criar um novo relatório.

Tabelas¶

O conector modela os dados no Amazon Marketplace em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Amazon Marketplace é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas do Amazon Marketplace¶

Listas de Itens¶

Retorna detalhes sobre um item de listagem para um parceiro de vendas.

Os seguintes filtros são necessários:

• SKU
• SellerId: Você pode especificar SellerId como uma condição de pseudocoluna nos filtros WHERE ou na string de conexão.

Algumas consultas de exemplo:

SELECT * FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

INSERT INTO ListingsItems(ProductType, Requirements, Attributes, SKU, SellerId)
VALUES ('product_type', 'LISTING', '{\"test_attribute\": \"value\"}', '12345', 'XXXXXXXXXXXXXX')

DELETE FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ListagensItensAtributos¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Os seguintes filtros são necessários:

• SKU
• SellerId: Você pode especificar SellerId como uma condição de pseudocoluna nos filtros WHERE ou na string de conexão.

Alguns exemplos de consultas:

SELECT * FROM ListingsItemsAttributes WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

UPDATE ListingsItemsAttributes SET AttributeValue = 'test_value', ProductType = 'LUGGAGE'
WHERE SKU = '12345' AND AttributeName = 'item_name_value'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Amazon Marketplace¶

CatalogItems¶

A tabela Itens do Catálogo ajuda a recuperar detalhes de itens no catálogo.

Os seguintes filtros são necessários:

• MarketplaceId
• Um dos seguintes: Query, SellerSKU, UPC, EAN, ISBN, JAN

Por exemplo:

SELECT * FROM CatalogItems WHERE MarketplaceID = 'XXXXXXXXXXXXX' AND ISBN = 'XXXXXXXXXXXXX'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Feeds¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

Observação: o atributo 'FeedType' é necessário para consultar a visualização. Você pode ver os valores disponíveis para 'FeedType' aqui.

• FeedId suporta a comparação '='.
• FeedType suporta as comparações '=' e 'IN'.
• MarketplaceIds suporta as comparações '=' e 'IN'.
• ProcessingStatus suporta as comparações '=' e 'IN'.
• CreatedTime suporta as comparações '=', '<', '>', '<=' e '>='.

A seguir estão exemplos de consultas que são processadas no lado do servidor:

SELECT * FROM Feeds WHERE FeedId = '50950018754'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA'

SELECT * FROM Feeds WHERE FeedType IN ( 'POST_PRODUCT_PRICING_DATA', 'POST_INVENTORY_AVAILABILITY_DATA' )

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND ProcessingStatus = 'DONE'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND CreatedTime > '2021-06-20' AND CreatedTime < '2021-08-01 12:00:00'

Note: Ao filtrar com CreatedTime, não serão aceitos valores com mais de 90 dias.

Colunas¶

Itens de Envio de Entrada¶

Retorna uma lista de itens em uma remessa de entrada especificada.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

• MarketplaceId suporta a comparação '='.
• LastUpdatedDate suporta as comparações '=', '<', '>', '<=', '>='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM InboundShipmentItems  WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipmentItems  WHERE LastUpdatedDate > '2020-01-01'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Remessas de Entrada¶

Retorna uma lista de remessas de entrada com base nos critérios especificados por você.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

• ShipmentId suporta as comparações '=' e 'IN'.
• ShipmentStatus suporta as comparações '=' e 'IN'.
• MarketplaceId suporta a comparação '='.
• LastUpdatedDate suporta as comparações '=', '<', '>', '<=', '>='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Fornecimento de Estoque¶

Retorna informações sobre a disponibilidade de estoque que um vendedor possui na rede de atendimento da Amazon e nas remessas de entrada atuais. Você pode verificar o status de disponibilidade atual para o seu inventário Fulfillment by Amazon, bem como descobrir quando o status de disponibilidade muda.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

Note: Os atributos 'GranularityType' e 'GranularityId' são necessários para consultar a visualização.

• SellerSKU suporta as comparações '=', 'IN'.
• GranularityType suporta a comparação '='.
• GranularityId suporta a comparação '='.
• MarketplaceId suporta a comparação '='.
• StartDateTime suporta as comparações '=', '<', '>', '<=', '>='.

A seguir estão exemplos de consultas que são processadas no lado do servidor:

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND SellerSKU = '123'

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND StartDateTime > '2020-01-01'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ListagensItensProblemas¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Os seguintes filtros são necessários:

• SKU
• SellerId: Você pode especificar SellerId como uma condição de pseudocoluna nos filtros WHERE ou na string de conexão.

Alguns exemplos de consultas:

SELECT * FROM ListingsItemsIssues WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ListagensItensOfertas¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Os seguintes filtros são necessários:

• SKU
• SellerId: Você pode especificar SellerId como uma condição de pseudocoluna nos filtros WHERE ou na string de conexão.

Alguns exemplos de consultas:

SELECT * FROM ListingsItemsOffers WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ListagensItensResumos¶

A operação GetFeedSubmissionList retorna uma lista de envios de feed.

Os seguintes filtros são necessários:

• SKU
• SellerId: Você pode especificar SellerId como uma condição de pseudocoluna nos filtros WHERE ou na string de conexão.

Alguns exemplos de consultas:

SELECT * FROM ListingsItemsSummaries WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

OrderAckInternal¶

Informações de uso para a operação OrderAckInternal.rsd.

Colunas¶

OrderItemAckInternal¶

Informações de uso para a operação OrderItemAckInternal.rsd.

Colunas¶

Itens de Ordem¶

Retorna itens do pedido com base no ID do pedido da Amazon que você especificar.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector. A tabela OrderItems oferece suporte à filtragem do lado do servidor com os operadores = e IN para o campo AmazonOrderId.

• AmazonOrderId suporta a comparação '='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pedidos¶

Retorna pedidos criados ou atualizados durante um período de tempo especificado por você.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

• AmazonOrderId suporta a comparação '='.
• SellerOrderId suporta a comparação '='.
• PurchaseDate suporta a comparação '=', '<', '>', '<=', '>='.
• LastUpdateDate suporta a comparação '=', '<', '>', '<=', '>='.
• OrderStatus suporta a comparação '=', 'IN'.
• FulfillmentChannel suporta a comparação '=', 'IN'.
• PaymentMethod suporta a comparação '=', 'IN'.
• MarketplaceId suporta a comparação '='.
• BuyerEmail suporta a comparação '='.
• IsISPU suporta a comparação '='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE SellerOrderId = '249-7638334' AND purchasedate > '2010-01-01'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM Orders WHERE BuyerEmail = 'random@gmail.com'

SELECT * FROM Orders WHERE IsISPU = false

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Colunas¶

ReportList¶

Retorna detalhes do relatório para os relatórios que correspondem aos filtros especificados.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

Note: O atributo 'ReportType' é necessário para consultar a exibição. Você pode visualizar os valores disponíveis para 'ReportType' na Documentação da API do Amazon Selling-Partner ou pode consultar a exibição 'ReportTypes'.

• ReportId suporta a comparação '='.
• ReportType suporta as comparações '=', 'IN'.
• MarketplaceIds suporta as comparações '=', 'IN'.
• ProcessingStatus suporta as comparações '=', 'IN'.
• CreatedTime suporta as comparações '=', '<', '>', '<=', '>='.

A seguir estão exemplos de consultas que são processadas no lado do servidor:

SELECT * FROM ReportList WHERE ReportId = '51013018828'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND CreatedTime > '2021-06-12' AND CreatedTime< '2021-08-01 12:00:00'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND ProcessingStatus = 'DONE'

Observação: Ao filtrar com CreatedTime, valores com mais de 90 dias não serão aceitos.

Colunas¶

Tipos de Relatórios¶

Retorna detalhes do relatório para os relatórios que correspondem aos filtros especificados.

Selecione¶

Esta exibição lista todos os tipos de relatório disponíveis da API de parceiro de vendas e seus respectivos formatos (JSON, XML, CSV, TSV, PDF, XLSX).

SELECT * FROM ReportTypes

Colunas¶

Pedidos do Fornecedor¶

A API do parceiro de vendas para pedidos de compras de varejo fornece acesso programático aos dados dos pedidos do fornecedor.

Selecione¶

O conector usará a API do Amazon Marketplace para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

• PurchaseOrderNumber suporta a comparação '='.
• PurchaseOrderState suporta a comparação '='.
• PurchaseOrderDate suporta '<', '>' comparações e cláusula ORDER BY.
• PurchaseOrderChangedDate suporta '<', '>' comparações.
• SellerPartyId suporta a comparação '='.

A seguir estão exemplos de consultas que são processadas no lado do servidor:

SELECT * FROM VendorOrders

SELECT * FROM VendorOrders WHERE PurchaseOrderNumber = '123456789'

SELECT * FROM VendorOrders WHERE PurchaseOrderState = 'New'

SELECT * FROM VendorOrders ORDER BY PurchaseOrderDate DESC

SELECT * FROM VendorOrders WHERE PurchaseOrderDate > '2022-06-01T12:00:00' AND PurchaseOrderDate < '2022-06-10T12:00:00'

SELECT * FROM VendorOrders WHERE PurchaseOrderChangedDate > '2022-06-01T12:00:00' AND PurchaseOrderChangedDate < '2022-06-10T12:00:00'

SELECT * FROM VendorOrders WHERE SellerPartyId = '123456789'

Colunas¶