> For the complete documentation index, see [llms.txt](https://desenvolvedores.skyhub.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://desenvolvedores.skyhub.com.br/credenciamento/credenciamento-americanas-partners-api.md).

# Credenciamento (Americanas Partner's 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 <mark style="color:blue;"><srv.mktp.api@americanas.io></mark> 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:**

| Name                 | Type                                        |
| -------------------- | ------------------------------------------- |
| 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:**&#x20;

```
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:**

{% hint style="success" %}
200 - Success \[OK]
{% endhint %}

```
{
    "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.&#x20;

Para seguir com esta solicitação, basta realizar um POST no seguinte endpoint:

```
https://api.skyhub.com.br/b2w/signup
```

#### **Request headers**:

| Name                 | Type                                        |
| -------------------- | ------------------------------------------- |
| 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": "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
  }
}
```

#### **Example request**:&#x20;

```
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": "contato@teste.com.br", 
    "document": "218788492", 
    "cellphone": "99887766" 
  }
}'
```

#### **Response esperado**:

{% hint style="success" %}
204 - Success \[No content]
{% endhint %}

Após realizar a solicitação e receber o retorno de sucesso na requisição, <mark style="color:green;">será necessário aguardar por processos internos realizados pelo marketplace</mark>, que validará as informações recebidas e realizará a criação das contas na Americanas e na API.

{% hint style="warning" %}
**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**.
{% endhint %}