> 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"
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://desenvolvedores.skyhub.com.br/americanas-fulfillment/faturador/relacionamento-entre-produto-e-regra/produto-simples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.