Postman

Iremos fazer o envio de feeds pelo Postman para facilitar o entendimento.

1. Criar um Documento Feed (createFeedDocument)

1. Adicione uma nova requisição

No canto superior esquerdo, clique em "New" e adicione uma nova requisição HTTP

333

2. Requisição POST

A requisição deve ser do tipo POST para a seguinte URL:

https://sellingpartnerapi-na.amazon.com/feeds/2021-06-30/documents
130

3. Authorization

Na aba "Authorization" devemos incluir os dados do Session Token, que criamos em 2. Session Token (STS), passe esses dados em "AccessKey", "SecretKey" e "Session Token".

Exemplo de Session Token

266

Passando os dados obtidos

752

4. Headers

Na aba "Headers" devemos incluir a chave "x-amz-access-token", que criamos em 3. Refresh Token.

416

5. Body

No corpo da requisição é necessário o envio do seguinte JSON:

{
  "contentType":"text/xml; charset=UTF-8"
}

6. Send

Faça a criação do Feed clicando no botão "Send"

116

7. Sucesso na criação

Se você obteve êxito na criação você deve receber um feedDocumentId e url, como no exemplo, essa URL será usado para o envio do Feed no próximo passo.

{
    "feedDocumentId": "amzn1.tortuga.3.9f74494d-485c-4cff-aeff-8d713aaf5c0f.T2EGRLFSSAU4I",
    "url": "https://tortuga-prod-na.s3-external-1.amazonaws.com/%2FNinetyDays/amzn1.tortuga.3.ac2a2549-8c8c-4324-9d70-9e870f491727.TLTVEETAA4Z?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210818T184251Z&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Expires=300&X-Amz-Credential=AKIA5U6MOCCAFBOQNLTF%2F20210818%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=62afbdb7b2edd90c299f4483e4a7a1caf257a3116aeb6a2311f0044a07e66397"
}

2. Envio do arquivo Feed

1. Adicione uma nova requisição

333

2. Requisição PUT

A requisição deve ser do tipo PUT, devemos usar a URL que recebemos ao criar o Feed no passo 1:

https://tortuga-prod-na.s3-external-1.amazonaws.com/%2FNinetyDays/amzn1.tortuga.3.ac2a2549-8c8c-4324-9d70-9e870f491727.TLTVEETAA4Z?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210818T184251Z&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Expires=300&X-Amz-Credential=AKIA5U6MOCCAFBOQNLTF%2F20210818%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=62afbdb7b2edd90c299f4483e4a7a1caf257a3116aeb6a2311f0044a07e66397
125

3. Adicione o "Headers"

Na aba "Headers" adicione a chave Content-Type, com o valor text/xml; charset=UTF-8 como no exemplo:

443

4. Adicione o "Body"

Você deve enviar o arquivo diretamente no Body com a chave em branco, selecione seu arquivo no botão "File".

  • Clique em form-data
  • Depois em File
  • Adicione o XML que adicionamos como exemplo
674

Exemplo de XML

<?xml version="1.0" encoding="utf-8"?>
<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>A2ZPJ4TLUOSWY8</MerchantIdentifier>
  </Header>
  <MessageType>Product</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Product>
      <SKU>CSAS003</SKU>
      <Condition>
        <ConditionType>New</ConditionType>
      </Condition>
      <ItemPackageQuantity>1</ItemPackageQuantity>
      <DescriptionData>
        <Title>Camiseta do Orochimaru</Title>
        <Brand>Generic</Brand>
        <Description>Camiseta de algodão do Orochimaru, confortável</Description>
        <BulletPoint>Algodão</BulletPoint>
        <BulletPoint>Polo</BulletPoint>
        <ItemDimensions>
          <Length unitOfMeasure="CM">45.72</Length>
          <Width unitOfMeasure="CM">35.56</Width>
          <Height unitOfMeasure="CM">40.32</Height>
          <Weight unitOfMeasure="KG">0.10</Weight>
        </ItemDimensions>
        <ShippingWeight unitOfMeasure="KG">0.10</ShippingWeight>
        <MSRP currency="BRL">999.00</MSRP>
        <Manufacturer>Generic</Manufacturer>
        <MfrPartNumber>Advanced</MfrPartNumber>
        <SearchTerms>Camiseta, Orochimaru</SearchTerms>
        <RecommendedBrowseNode>17682472011</RecommendedBrowseNode>
        <MerchantShippingGroupName>default</MerchantShippingGroupName>
      </DescriptionData>
      <ProductData>
        <Clothing>
          <!-- <VariationData>
            <Parentage>parent</Parentage>
            <VariationTheme>SizeColor</VariationTheme>
          </VariationData> -->
          <VariationData>
            <Parentage>parent</Parentage>
            <Size>42</Size>
            <Color>beige</Color>
            <VariationTheme>SizeColor</VariationTheme>
          </VariationData>
          <ClassificationData>
            <ClothingType>Shirt</ClothingType>
            <Department>Woman</Department>
            <StyleKeywords>Apparel</StyleKeywords>
            <MaterialComposition>100% poliesther</MaterialComposition>
            <OuterMaterial>syntetic</OuterMaterial>
            <OccasionAndLifestyle>Casual</OccasionAndLifestyle>
            <Season>Spring/Summer 2016</Season>
            <IsAdultProduct>false</IsAdultProduct>
            <CollectionName>Pring/Summer 2016</CollectionName>
          </ClassificationData>
        </Clothing>
      </ProductData>
    </Product>
  </Message>
</AmazonEnvelope>

7. Sucesso

Você deve receber um Status 200, que o upload do arquivo foi feito com sucesso.

3. Criando o Feed

https://sellingpartnerapi-na.amazon.com/feeds/2021-06-30/feeds

1. Criar um Documento Feed (createFeed)

1. Adicione uma nova requisição

No canto superior esquerdo, clique em "New" e adicione uma nova requisição HTTP

333

2. Requisição POST

A requisição deve ser do tipo POST para a seguinte URL:

https://sellingpartnerapi-na.amazon.com/feeds/2021-06-30/feeds
130

4. Adicione o "Body"

O corpo da requisição é do tipo raw com o seguinte JSON:

  • marketplaceIds: O ID da loja.
  • inputFeedDocumentId: Que recebemos no passo 1.
{
  "feedType":"POST_PRODUCT_DATA",
  "marketplaceIds":[
  	"A2Q3Y263D00KWC"
  ],
  "inputFeedDocumentId":"amzn1.tortuga.3.9f74494d-485c-4cff-aeff-8d713aaf5c0f.T2EGRLFSSAU4I"
}

5. Sucesso

Você deve receber um JSON de retorno com o feedId que será usado para verificar o status da solicitação do Feed.

Exemplo sucesso

{
  "feedId": "55934018857"
}

Veja todos os exemplos de Feeds.

4. Verificar status do Feed (Processamento)

1. Adicione uma nova requisição

No canto superior esquerdo, clique em "New" e adicione uma nova requisição HTTP

333

2. Requisição GET

A requisição deve ser do tipo GET com o feedId para a seguinte URL:

https://sellingpartnerapi-na.amazon.com/feeds/2021-06-30/feeds/55934018857
145

3. Authorization

Na aba "Authorization" devemos incluir os dados do Session Token, que criamos em 2. Session Token (STS), passe esses dados em "AccessKey", "SecretKey" e "Session Token".

Exemplo de Session Token

266

Passando os dados obtidos

752

4. Headers

Na aba "Headers" devemos incluir a chave "x-amz-access-token", que criamos em 3. Refresh Token.

416

5. Send

Faça a criação do Feed clicando no botão "Send"

116

6. Sucesso na criação

O retorno dessa chamada é um JSON com as informações e status do seu Feed.
Se obtiver sucesso o processingStatus retornará como DONE.

{
    "processingEndTime": "2021-08-18T18:56:16+00:00",
    "processingStatus": "DONE",
    "marketplaceIds": [
        "A2Q3Y263D00KWC"
    ],
    "feedId": "55934018857",
    "feedType": "POST_PRODUCT_DATA",
    "createdTime": "2021-08-18T18:55:33+00:00",
    "processingStartTime": "2021-08-18T18:55:40+00:00",
    "resultFeedDocumentId": "amzn1.tortuga.3.a1e0871b-ac54-4c55-8f19-74a67d3e7b75.T17OS48JHJ4DRL"
}