Produto Variável

Nesta seção constam as orientações de como criar, atualizar e consultar a associação de regras com produtos variáveis

O relacionamento/associação entre uma Regra Tributária e uma variação cadastrada pode ser criado e consultado utilizando a URL base visualizada a seguir:

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

O {platform} deve ser preenchido como b2w.

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 variável

A criação (assim como a atualização) do relacionamento de um produto variável 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_pai}/rule

Request body:

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

Example request:

curl --location --request POST 'https://api.skyhub.com.br/taxes/b2w/items/SKU008/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 '{
    "variation": "00801",
    "configs": [
        "FABRICANTE" // Config para "característica de fabricante"
    ],
    "rules": [
        {
            "id": "1411"
        }
    ]
}'

Note que a URL receberá o SKU pai/agrupador e a variação será referida apenas no corpo da requisição (campo variation).

Response esperado:

204 [Success] - No content

Importante reforçar que após uma regra ser associada a um produto, a mesma não poderá ser removida, apenas sobrescrita.

GET - Consultando o relacionamento de uma regra ao produto variável

A consulta do relacionamento se dá através de um GET, utilizando os headers padronizados na API, para o endpoint base apresentado no início deste guia. Quando se trata de um produto variável, a consulta do relacionamento/associação deverá obrigatoriamente conter o filtro variation, conforme visualizado a seguir:

https://api.skyhub.com.br/taxes/b2w/items/{sku_pai}/rule?variation={sku_variacao}

Ao se tratar de um produto variável, caso o filtro variation não seja aplicado, a consulta retornará status 422.

Importante: Não serão retornados os dados de todas as variações de um produto, sendo necessário realizar pesquisas individuais para cada uma delas.

Example request:

curl --location --request GET 'https://api.skyhub.com.br/taxes/b2w/items/SKU008/rule?variation=00801' \
--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:

200 [Success] - OK: Como retorno, será apresentada a listagem das Regras Tributárias associadas à variação consultada:

{
    "configs": [
        "FABRICANTE"
    ],
    "filial": "cnpj_cd_direct",
    "rules": [
        {
            "id": "1411"
        }
    ],
    "sku": "00801"
}