# Regra Fiscal

A estrutura da Regra Fiscal seguirá campos pré-definidos de acordo com a necessidade do *seller*. 

Para a criação, atualização e consulta da Regra Fiscal serão utilizados os headers padronizados na API da Americanas e visualizados a seguir:

#### **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                            |

Ainda, todas as ações descritas neste guia utilizarão a URL base:

```
https://api.skyhub.com.br/taxes/{platform}/data
```

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

## POST - Cadastrando/Atualizando uma Regra Fiscal

A criação/atualização de uma Regra Fiscal via API deverá ser realizada através de um POST, contendo os headers padronizados e descritos acima, para o endpoint:

```
https://api.skyhub.com.br/taxes/b2w/data
```

Uma vez que a Regra Fiscal é aplicada para toda a loja, qualquer POST realizado após a sua criação substitui os dados previamente preenchidos, isto é, após criada a regra, as requisições seguintes contendo o método POST serão consideradas como atualizações e irão sobrescrever as informações anteriormente aplicadas.

#### Request body:

```
{
  "id_crt": 2,
  "tp_calc_sub_cs": "2",
  "tp_calc_icms_destin": "1",
  "difal_states": [
    "SP"
  ],
  "configs": [
    "DESC_COND_BASE_ICMS",
    "DESC_COND_BASE_IPI",
    "DESC_COND_BASE_PIS",
    "DESC_INC_BASE_ICMS",
    "DESC_INC_BASE_IPI",
    "DESC_INC_BASE_PIS",
    "DESC_INC_BASE_SUB",
    "DESPESA_BASE_ICMS",
    "DESPESA_BASE_IPI",
    "DESPESA_BASE_SUB",
    "FRETE_BASE_ICMS",
    "FRETE_BASE_IPI",
    "FRETE_BASE_PIS",
    "FRETE_BASE_SUB",
    "ICMS_BASE_PIS",
    "ICMS_SUB_BASE_PIS",
    "IPI_BASE_ICMS",
    "IPI_BASE_PIS",
    "IPI_BASE_SUB",
    "SEGURO_BASE_ICMS",
    "SEGURO_BASE_IPI",
    "SEGURO_BASE_PIS",
    "SEGURO_BASE_SUB",
    "CALC_DIFAL"
  ]
}
```

#### Atributos da requisição:

{% hint style="info" %}
Caso alguma *config* não seja inclusa na requisição, o atributo automaticamente será acatado pelo marketplace como **não utilizado**/**indisponível** para a loja.
{% endhint %}

<table><thead><tr><th width="252">Atributo</th><th>Descrição</th></tr></thead><tbody><tr><td><em>id_crt</em></td><td>Código CRT do vendedor</td></tr><tr><td><em>calc_sub_cs</em></td><td>Modelo de cálculo da “EC87 / 2015” e Difal - ST - contribuinte</td></tr><tr><td><em>calc_icms_destin</em></td><td>Modelo de cálculo da “EC87 / 2015” e Difal - ST - não contribuinte</td></tr><tr><td><em>difal_states</em></td><td>Lista de estados para aplicação: Tipo de destinatário do cálculo do ICMS</td></tr><tr><td><em>configs</em></td><td>Regras Fiscais (constantes) que quando informadas constarão como SIM no Marketplace</td></tr><tr><td><em>DESC_COND_BASE_ICMS</em></td><td>ICMS - Deduz descontos condicionais</td></tr><tr><td><em>DESC_INC_BASE_ICMS</em></td><td>ICMS - Deduz descontos incondicionais</td></tr><tr><td><em>DESPESA_BASE_ICMS</em></td><td>ICMS - Despesas</td></tr><tr><td><em>FRETE_BASE_ICMS</em></td><td>ICMS - Frete</td></tr><tr><td><em>IPI_BASE_ICMS</em></td><td>ICMS - IPI</td></tr><tr><td><em>SEGURO_BASE_ICMS</em></td><td>ICMS - Seguro</td></tr><tr><td><em>DESC_COND_BASE_SUB</em></td><td>ICMS - ST - Deduz descontos condicionais</td></tr><tr><td><em>DESC_INC_BASE_SUB</em></td><td>ICMS - ST - Deduz descontos incondicionais</td></tr><tr><td><em>DESPESA_BASE_SUB</em></td><td>ICMS - ST - Despesas</td></tr><tr><td><em>FRETE_BASE_SUB</em></td><td>ICMS - ST - Frete</td></tr><tr><td><em>IPI_BASE_SUB</em></td><td>ICMS - ST - IPI</td></tr><tr><td><em>SEGURO_BASE_SUB</em></td><td>ICMS - ST - Seguro</td></tr><tr><td><em>DESC_COND_BASE_IPI</em></td><td>IPI - Deduz descontos condicionais</td></tr><tr><td><em>DESC_INC_BASE_IPI</em></td><td>IPI - Deduz descontos incondicionais</td></tr><tr><td><em>DESPESA_BASE_IPI</em></td><td>IPI - Despesas</td></tr><tr><td><em>FRETE_BASE_IPI</em></td><td>IPI - Frete</td></tr><tr><td><em>SEGURO_BASE_IPI</em></td><td>IPI - Seguro</td></tr><tr><td><em>DESC_COND_BASE_PIS</em></td><td>Pis e Cofins - Deduz descontos condicionais</td></tr><tr><td><em>DESC_INC_BASE_PIS</em></td><td>Pis e Cofins - Deduz descontos incondicionais</td></tr><tr><td><em>DESPESA_BASE_PIS</em></td><td>Pis e Cofins - Despesas</td></tr><tr><td><em>FRETE_BASE_PIS</em></td><td>Pis e Cofins - Frete</td></tr><tr><td><em>ICMS_BASE_PIS</em></td><td>Pis e Cofins - ICMS</td></tr><tr><td><em>ICMS_SUB_BASE_PIS</em></td><td>Pis e Cofins - ICMS - ST</td></tr><tr><td><em>IPI_BASE_PIS</em></td><td>Pis e Cofins - IPI</td></tr><tr><td><em>SEGURO_BASE_PIS</em></td><td>Pis e Cofins - Seguro</td></tr><tr><td><em>CALC_DIFAL</em></td><td>ICMS tipo de cálculo - Destino</td></tr></tbody></table>

#### Example request:

```
curl --location --request POST 'https://api.skyhub.com.br/taxes/b2w/data' \
--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 '{
  "id_crt": 2,
  "tp_calc_sub_cs": "2",
  "tp_calc_icms_destin": "1",
  "difal_states": [
    "BA",
    "SP",
    "RJ"
  ],
  "configs": [
    "DESC_COND_BASE_ICMS",
    "DESC_COND_BASE_IPI",
    "DESC_COND_BASE_PIS",
    "DESC_INC_BASE_ICMS",
    "DESC_INC_BASE_IPI",
    "DESC_INC_BASE_PIS",
    "DESC_INC_BASE_SUB",
    "DESPESA_BASE_ICMS",
    "DESPESA_BASE_IPI",
    "DESPESA_BASE_SUB",
    "FRETE_BASE_ICMS",
    "FRETE_BASE_IPI",
    "FRETE_BASE_PIS",
    "FRETE_BASE_SUB",
    "ICMS_BASE_PIS",
    "ICMS_SUB_BASE_PIS",
    "IPI_BASE_ICMS",
    "IPI_BASE_PIS",
    "IPI_BASE_SUB",
    "SEGURO_BASE_ICMS",
    "SEGURO_BASE_IPI",
    "SEGURO_BASE_PIS",
    "SEGURO_BASE_SUB",
    "CALC_DIFAL"
  ]
}'
```

#### Response esperado:

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

## GET - Consultando a Regra Fiscal

A consulta da Regra Fiscal cadastrada na conta poderá ser realizada através de um GET, utilizando os [headers](#request-headers) padronizados na API, para o endpoint:

```
https://api.skyhub.com.br/taxes/b2w/data
```

#### **Example request:**

```
curl --location --request GET 'https://api.skyhub.com.br/taxes/b2w/data' \
--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: O retorno trará informações sobre a regra cadastrada, conforme exemplo abaixo:
{% endhint %}

```
{
    "cnpj_filial": "cnpj_cd_direct",
    "configs": [
        "CALC_DIFAL",
        "DESC_COND_BASE_ICMS",
        "DESC_COND_BASE_PIS",
        "DESC_INC_BASE_ICMS",
        "DESC_INC_BASE_PIS",
        "DESC_INC_BASE_SUB",
        "DESPESA_BASE_ICMS",
        "DESPESA_BASE_IPI",
        "DESPESA_BASE_SUB",
        "FRETE_BASE_ICMS",
        "FRETE_BASE_IPI",
        "FRETE_BASE_PIS",
        "FRETE_BASE_SUB",
        "ICMS_BASE_PIS",
        "ICMS_SUB_BASE_PIS",
        "IPI_BASE_ICMS",
        "IPI_BASE_PIS",
        "IPI_BASE_SUB",
        "SEGURO_BASE_ICMS",
        "SEGURO_BASE_IPI",
        "SEGURO_BASE_PIS",
        "SEGURO_BASE_SUB"
    ],
    "difal_states": [
        "BA",
        "SP",
        "RJ"
    ],
    "id_crt": 2,
    "id_terceiro": CNPJ_da_Loja,
    "tp_calc_icms_destin": "1",
    "tp_calc_sub_cs": "2"
}
```


---

# Agent Instructions: 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:

```
GET https://desenvolvedores.skyhub.com.br/americanas-fulfillment/faturador/regras-fiscais.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.