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 srv.mktp.api@americanas.io 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:
{
"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"
}'
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:
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": "contato@teste.com.br", // E-mail do responsável pela loja
"document": "", // CPF/RG do responsável pela loja
"cellphone": "" // Celular do responsável pela loja
}
}
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.
