Perguntas e Respostas: Americanas
Essa funcionalidade foi descontinuada de nossa API, caso tenha sido impactado entre em contato conosco através do email [email protected]
Perguntas e Respostas é o endpoint criado para que os sellers Americanas interajam com os clientes a respeito de quaisquer dúvidas sobre o produto que está visualizando.
Nesta função, os sellers que pertencem ao BuyBox poderão responder, rejeitar, listar perguntas.

Limitações:

  • Não é possível excluir uma pergunta para a Americanas;
  • O retorno do "product_sku" e "platform_sku" é referente ao ID Americanas, ou seja, será necessário acessar o portal parceiro para identificar o SKU do produto;
  • Retorna somente uma plataforma por requisição.

Cursor (Paginação):

A paginação é feita utilizando o cursor que está presente em todas as requests de listar. Cada cursor sempre aponta para a próxima página em apenas um único sentido.
Ao utilizar o cursor, os parâmetros de filtros são ignorados pois o cursor sempre refere-se aos filtros da primeira consulta.
Por exemplo:

Response:

1
{"status": "UNANSWERED", "product_sku": "33629401", "platform_sku": "33629401", "platform": "B2W",…},
2
{"status": "UNANSWERED", "product_sku": "15606067", "platform_sku": "15606067", "platform": "B2W",…}
3
],
4
"qty": 50,
5
"cursor": "eyJzdGF0dXMiOiJVTkFOU1dFUkVEIiwib2Zmc2V0Ijo1MSwibGltaXQiOjUwfQ=="
6
}
Copied!

Endpoints:

Os endpoints de perguntas/respostas têm a responsabilidade de expor dados por plataforma, segue a lista de plataformas suportadas:
  • Meli
  • Americanas
Segue abaixo como efetuar cada função e seus respectivos endpoints.

Questions:

Tem como função retornar as perguntas relacionadas ao seller, ou seja, ao BuyBox.
Por exemplo:
Existem 3 sellers que estão no BuyBox, neste caso a pergunta que o cliente fizer poderá ser respondida por quaisquer dos 3 sellers, desde de que não esteja respondida.
Para listar deve ser utilizado o endpoint:
1
GET /questions
Copied!
Filtros:
  • status: Estado atual da pergunta;
  • platform: De qual marketplace está buscando as informações.

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Query Parameters
Name
Type
Required
Description
Example
status
String
Optional
Filtra as mensagens pelos seus status
Valores possíveis:
  • ANSWERED
  • UNANSWERED
  • UNANSWERED_BY_YOU
UNANSWERED
platform
String
Required
Filtro para retornar somente as mensagens de uma plataform específica.
Valores possíveis
  • B2W
B2W
cursor
String
Optional
Utilizado para fazer a paginação das perguntas.
Caso este parâmetro esteja presente, os parâmetros de status e platform serão ignorados.
eyJwbGF0Zm9ybSI6Ik1lbGkiLCJvZmZzZXQiO
Responses:
200 - Success
1
{
2
"questions": [{
3
"status": "UNANSWERED",
4
"product_sku": "29267596",
5
"platform_sku": "29267596",
6
"platform": "B2W",
7
"customer": {
8
"name": "Rodrigo"
9
},
10
"created_at": "2019-10-10T16:58:07.297Z",
11
"code": "B2W-5d9f631fec233600327e3205",
12
"body": "Ola boa tarde...\nFiz o pagamento dos autofalantes ontem ainda e ate agora nao foi despachado! Vocês não tem eles a pronta entrega?",
13
"answers": [],
14
"answer": {}
15
},
16
{
17
"status": "UNANSWERED",
18
"product_sku": "23237068",
19
"platform_sku": "23237068",
20
"platform": "B2W",
21
"customer": {
22
"name": "Ronaldo"
23
},
24
"created_at": "2019-10-10T12:06:52.758Z",
25
"code": "B2W-5d9f1edca8bad6003227cbe5",
26
"body": "Nao poderia retirar em alguma loja de vcs ??? Preciso muito rapido",
27
"answers": [],
28
"answer": {}
29
30
}
31
],
32
"qty": 50,
33
"cursor": "eyJvZmZzZXQiOjUxLCJsaW1pdCI6NTB9"
34
}
Copied!
400 - BAD REQUEST
Não foi possível processar a requisição
401 - AUTHENTICATION FAILED
Não foi possível realizar a autenticação. Verifique se as credenciais de acesso estão corretas.
500 - INTERNAL SERVER ERROR
Caso ocorra algum erro interno no servidor

Show Question:

Tem como função visualizar as perguntas através do code, que é disponibilizado ao efetuar o GET /questions. Por exemplo:
1
"code": "B2W-5d9e80ed9df1b1002c39716a"
Copied!
Neste caso é necessário utilizar o seguinte endpoint:
1
GET /questions/{code}
Copied!
Example Request:
1
curl -X GET \
2
https://api.skyhub.com.br/questions/{code} \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Responses:
200 - SUCCESS
400 - BAD REQUEST
401 - AUTHENTICATION FAILED
404 - NOT FOUND
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented

Questions Answer:

Tem como função responder perguntas através do code. Neste caso é necessário utilizar a seguinte endpoint:
1
POST /questions​/{code}​
Copied!

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions/{code} \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT

Listar Answers

Tem como função retornar as respostas de uma pergunta através do code.
Neste caso é necessário utilizar o seguinte endpoint:
1
GET /questions/{code}/answers
Copied!

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions/{code}/answers \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT

Summaries

Tem como função retornar as perguntas com sumário baseado no produto. Os status do sumário serão:
  • REJECTED
  • UNANSWERED
  • APPROVED
Rejected e Approved: Quantidade de respostas que o seller deu e que foram aprovadas ou rejeitadas pela moderação;
Unanswered: Quantidade de perguntas que o seller não respondeu.
Neste caso é necessário utilizar o seguinte endpoint:
1
GET /questions/products/summaries
Copied!

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions/products/summaries \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Query Parameters
Name
Type
Required
Description
Example
platform
String
Required
Filtro para retornar somente as mensagens de uma plataform específica.
Valores possíveis
  • B2W
B2W

Response:

200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
1
{
2
"summary": {
3
"UNANSWERED": 1,
4
"REJECTED": 2
5
},
6
"name": "Mp3 Player Roadstar 2 Din Bluetooth Usb Micro Sd Auxiliar P2 Rádio Fm Rs-3707br",
7
"image": "https://images-americanas.b2w.io/produtos/01/00/img3/108424/7/108424700_1SZ.jpg",
8
"id": "108424697"
9
},
10
{
11
"summary": {
12
"UNANSWERED": 1
13
},
14
"name": "Para-choque Impulsão Quebra Mato S10 2012 2013 2014 2015 2016 2017 2018 Grafite",
15
"image": "https://images-americanas.b2w.io/produtos/01/00/oferta/60681/9/60681918_1SZ.jpg",
16
"id": "60681921"
17
Copied!

Questions especifico - produto

Responsável por retornar as perguntas específicas do produto informado.
Será possível verificar o ID do produto através do endpoint: GET /questions/products/summaries.
Para obter o retorno das perguntas será necessário utilizar o seguinte endpoint:
1
GET /questions/product/:id
Copied!

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions/product/{id} \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Query Parameters
Name
Type
Required
Description
Example
platform
String
Required
Filtro para retornar somente as mensagens de uma plataform específica.
Valores possíveis
  • B2W
B2W
200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
1
{
2
"questions": [
3
{
4
"status": "APPROVED",
5
"product_sku": "71028130",
6
"platform_sku": "71028130",
7
"platform": "B2W",
8
"customer": {
9
"name": "Fabio"
10
},
11
"created_at": "2019-09-18T10:15:19.861Z",
12
"code": "B2W-5d8203b7b983f70032a4faf4",
13
"body": "Tem na cor preta?",
14
"answers": [],
15
"answer": {}
16
}
17
],
18
"qty": 1,
19
"cursor": null
20
}
Copied!

Questions não respondidas:

Tem como função retornar a quantidade de perguntas não respondidas de acordo com o BuyBox.
Para obter o retorno é necessário utilizar a enpoint:
1
GET /questions/count_unanswered_by_all
Copied!

Example Request:

1
curl -X GET \
2
https://api.skyhub.com.br/questions/count_unanswered_by_all \
3
-H 'accept: application/json' \
4
-H 'cache-control: no-cache' \
5
-H 'content-type: application/json' \
6
-H 'x-accountmanager-key: SUAXACCOUNT' \
7
-H 'x-api-key: YOUR API KEY HERE' \
8
-H 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
application/json
Content-type
String
Required
application/json
application/json
x-user-email
String
Required
E-mail da loja
x-api-key
String
Required
Token da loja
SuaApiKey
x-accountmanager-key
String
Required
Código identificador da sua Integração
SUAXACCOUNT
Query Parameters
Name
Type
Required
Description
Example
platform
String
Required
Filtro para retornar somente as mensagens de uma plataform específica.
Valores possíveis
  • B2W
B2W
200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
1
{
2
"unansweredQuestions": 484
3
}
Copied!