Credenciamento (Americanas Partner's API)
Nesta seção é apresentado o recurso que possibilita a solicitação de contas no marketplace via API
A API de Credenciamento possibilita que ao contratar a plataforma/ERP o seller seja capaz de fornecer seus dados para a solicitação de uma conta no marketplace Americanas e, consequentemente, na API.
Solicitar credenciais
Ao optar por desenvolver o recurso de Credenciamento, será necessário entrar em contato com a equipe da API através do e-mail [email protected] e solicitar os dados que serão utilizados para autenticação de seu sistema junto ao serviço.
Em posse dos dados que serão fornecidos pelo time de API, o próximo passo será solicitar o token de autenticação através de um POST no seguinte endpoint:
https://api.skyhub.com.br/b2w_partner/authorizer/oauth2/token
Request headers:
Accept
application/json
Content-Type
application/json
X-Accountmanager-Key
token_account único de cada Plataforma/ERP
Request body:
{
"client_id": "your_client_id", // Código de Acesso Único
"client_secret": "your_client_secret", // Chave de Acesso
"grant_type": "password", // Tipos de Autenticação
"provision_key": "abc1234efg567higkl890mnopqrstu", // ID
"authenticated_userid": "some_user_name", // Código de Acesso Único
"scope": "account" // Escopo solicitado para autenticação
}
Example request:
curl --location --request POST 'https://api.skyhub.com.br/b2w_partner/authorizer/oauth2/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--data-raw '{
"client_id": "Plataforma_1",
"client_secret": "9a8b00000c777d6e5f444g33h22i11jf",
"grant_type": "password",
"provision_key": "ab1CDE2fGH3I4jKLmn5OpQQQrsTu6vWX",
"authenticated_userid": "Plataforma_1",
"scope": "account"
}'
Response esperado:
200 - Success [OK]
{
"refresh_token": "rv2N8kc...........6Y87mrJ",
"token_type": "bearer",
"access_token": "44cc6cz...........DU8u9vBt",
"expires_in": 900
}
POST - Solicitação da conta junto ao marketplace
A requisição acima terá como resultado o access token que será utilizado para a solicitação da conta.
Para seguir com esta solicitação, basta realizar um POST no seguinte endpoint:
https://api.skyhub.com.br/b2w/signup
Request headers:
Accept
application/json
Content-Type
application/json
Authorization
Bearer access_token
X-Accountmanager-Key
token_account único de cada Plataforma/ERP
Request body:
{
"test_account": false, // Os possíveis valores são true e false, porém como a conta será em produção, necessário solictar como false
"sellerId": "123456789", // CNPJ da loja
"platform": "Teste", // Nome da plataforma/ERP que está solicitando a conta
"state_register": "123456789", // Inscrição Estadual
"coupon": "B2W123", // Cupom promocional, caso exista. Se não houver cupom, remova o campo da requisição
"contact": {
"type": "PRINCIPAL", // Dados do contato da loja
"phone": "123456789", // Telefone do responsável pela loja
"name": "Teste", // Nome do responsável pela loja
"email": "[email protected]", // E-mail do responsável pela loja
"document": "", // CPF/RG do responsável pela loja
"cellphone": "" // Celular do responsável pela loja
}
}
Example request:
curl --location --request POST 'https://api.skyhub.com.br/b2w/signup' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 44cc6cz...........DU8u9vBt' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--data-raw '{
"test_account": false
"sellerId": "01234567890123",
"platform": "Teste",
"state_register": "123456789",
"coupon": "B2W123",
"contact": {
"type": "PRINCIPAL",
"phone": "123456789",
"name": "Teste",
"email": "[email protected]",
"document": "218788492",
"cellphone": "99887766"
}
}'
Response esperado:
204 - Success [No content]
Após realizar a solicitação e receber o retorno de sucesso na requisição, será necessário aguardar por processos internos realizados pelo marketplace, que validará as informações recebidas e realizará a criação das contas na Americanas e na API.
Não é possível visualizar o andamento da solicitação da conta via API, fazendo-se necessário acompanhar o status da mesma (solicitação) diretamente pelo marketplace.
Last updated