> 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/americanas-fulfillment/faturador/relacionamento-entre-produto-e-regra/produto-simples.md).

# Produto Simples

O relacionamento/associação entre uma Regra Tributária e um produto simples cadastrado na conta pode ser criado e consultado utilizando a URL base visualizada a seguir:

```
https://api.skyhub.com.br/taxes/{platform}/items/{sku}/rule
```

{% hint style="info" %}
O `{platform}` deve ser preenchido como **b2w**.
{% endhint %}

Tanto para a criação/atualização quanto para a consulta das regras associadas, os headers utilizados são aqueles padronizados na API e visualizados logo abaixo:

#### Request headers:

| Key                  | Value                                       |
| -------------------- | ------------------------------------------- |
| X-User-Email         | email\_de\_usuario                          |
| X-Api-Key            | token\_de\_integracao de sua conta SkyHub   |
| X-Accountmanager-Key | token\_account único de cada Plataforma/ERP |
| Accept               | application/json                            |
| Content-Type         | application/json                            |

## POST - Cadastrando/Atualizando o relacionamento de uma regra ao produto simples

A criação (assim como a atualização) do relacionamento de um produto simples a uma regra existente deve ser realizada através de um POST, utilizando os headers padronizados e descritos acima, para o endpoint base:

```
https://api.skyhub.com.br/taxes/b2w/items/{sku}/rule
```

#### Request body:

```
{
    "configs": [
        "" "" // Constantes que quando passadas respresentam 'sim' e quando omitidas, representam 'não'
    ],
    "rules": [
        {
            "id": "{ID_da_regra}"
        },
        {
            "id": "{ID_da_regra}"
        }
    ]
}
```

{% hint style="info" %}
Caso hajam dúvidas quanto ao ID das regras cadastradas, é possível consultar a seção [Regras Tributárias](/americanas-fulfillment/faturador/regras-tributarias.md). 
{% endhint %}

#### Example request:

```
curl --location --request POST 'https://api.skyhub.com.br/taxes/b2w/items/SKU007/rule' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "configs": [
        "FABRICANTE" // Config que determina a constante "característica de fabricante"
    ],
    "rules": [
        {
            "id": "1411"
        }
    ]
}'
```

#### Response esperado:

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

{% hint style="info" %}
Importante reforçar que após uma regra ser associada a um produto, a mesma não poderá ser removida, apenas sobrescrita. 
{% endhint %}

## GET - Consultando o relacionamento de uma regra ao produto simples

A consulta do relacionamento se dá através de um GET, utilizando os [headers](#request-headers) padronizados na API, para o endpoint base apresentado no início deste guia:

```
https://api.skyhub.com.br/taxes/b2w/items/{sku}/rule
```

#### **Example request:**

```
curl --location --request GET 'https://api.skyhub.com.br/taxes/b2w/items/SKU007/rule' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
```

#### Response esperado:

{% hint style="success" %}
200 \[Success] - OK: Como retorno, será apresentada a listagem das Regras Tributárias associadas ao SKU consultado:
{% endhint %}

```
{
    "configs": [
        "FABRICANTE"
    ],
    "filial": "cnpj_cd_direct",
    "rules": [
        {
            "id": "1272"
        },
        {
            "id": "1411"
        }
    ],
    "sku": "SKU007"
}
```