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
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
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
Passando os dados obtidos
4. Headers
Na aba "Headers" devemos incluir a chave "x-amz-access-token", que criamos em 3. Refresh Token.
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"
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
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
3. Adicione o "Headers"
Na aba "Headers" adicione a chave Content-Type
, com o valor text/xml; charset=UTF-8
como no exemplo:
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
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
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
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
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
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
Passando os dados obtidos
4. Headers
Na aba "Headers" devemos incluir a chave "x-amz-access-token", que criamos em 3. Refresh Token.
5. Send
Faça a criação do Feed clicando no botão "Send"
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"
}
Updated over 2 years ago