Perguntas e Respostas B2W

Essa funcionalidade foi descontinuada de nossa API, caso tenha sido impactado entre em contato conosco através do email [email protected]
Perguntas e Respostas é a Endpoint criada para que os sellers B2W interajam com os clientes a respeito de quaisquer duvidas sobre o produto que esta 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 B2W;
O retorno do "product_sku" e "platform_sku" é referente ao ID B2W, ou seja, será necessário acessar o portal B2W para identificar o sku do produto.
Retorna somente uma plataforma por requisição;
Cursor (Paginação):
A paginação é feita utilizando o cursor que esta 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 tem a responsabilidade de expor dados por plataforma, segue a lista de plataformas suportadas:
Meli
B2W
Segue a baixo como efetuar cada função e suas respectivas 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 poderá ser respondido por quaisquer dos 3 sellers, desde de que não esteja respondido.
Para listar deve ser utilizado a endpoint:
1
GET /questions
Copied!
Filtros:
status: Estado atual da pergunta
platform: De qual marketplace esta 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
[email protected]
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 a 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
[email protected]
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
[email protected]
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 a 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
[email protected]
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 a 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
[email protected]
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 especificas do produto informado.
Será possível verificar o ID do produto através da endpoint:  GET /questions/products/summaries. 
Para obter o retorno das perguntas será necessário utilizar a 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
[email protected]
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
[email protected]
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!
Mercado Livre - Previous
Questions
Listar SAC
Last modified 10mo ago
Copy link
Contents
Questions especifico - produto
Questions não respondidas: