O que é?
A integração de produtos TIPO KIT consiste em identificar os itens compostos dentro do kit para ofertarmos as possibilidades de entregas dentro do grupo de itens que compõem o kit. Trataremos também o processo de integração do pedido com o LinxOmni, atentando-nos até mesmo ao preço dos itens para que seja equivalente ao total pago.
Regras gerais:
- O processo de criação do produto KIT no commerce não sofreu alteração;
- A funcionalidade é restrita ao processo de integração com o LinxOmni, desde o processo de cotação até a integração de pedidos.
Funcionamento no processo de cotação:
Regras gerais:
- Dimensões dentro do Kit não serão levadas em consideração (em breve, essa propriedade no cadastro do kit não mais aparecerá);
- Quantidade inserida dentro do kit multiplicará pela quantidade de kits selecionados:
Exemplo:- 1 unidade do SKU1
- 2 unidades do SKU2
- 3 unidades do SKU3
- Ao serem colocadas duas unidades desse kit no carrinho, na prática se está adquirindo:
Exemplo:- 2 unidades do SKU1
- 4 unidades do SKU2
- 6 unidades do SKU3
Como se comportará na cotação esse cenário:
{
"groups": {
"group1": {
"items": {
"896348-G": {
"sku": "896348-G",
"quantity": 2
},
"894687-M": {
"sku": "894687-M",
"quantity": 4
},
"930323-P": {
"sku": "930323-P",
"quantity": 6
}
},
"kits": [
{
"kitId": "99391",
"quantity": 2,
"items": {
"896348-G": {
"quantity": 1
},
"894687-M": {
"quantity": 2
},
"930323-P": {
"quantity": 3
}
}
}
]
}
}
}
Atenção!
Todos as variações selecionadas para cotação/compra deverão conter saldo positivo no mesmo estoque, caso contrário, não retornará a cotação, pois não há split de entrega dos itens do KIT. Ou seja, obrigatoriamente, todas as variações escolhidas para compra deverão sair da mesma localidade. A Entrega é sempre única para todos os itens do Kit.
Atenção!
Kits estão contemplados na cotação do LinxOmni somente para Shipment e Pickup. Lockers não são contemplados.
Identificação do kit na cotação:
O formato da informação de KitId que será utilizado para enviar para o LinxOmni é o seguinte:
- a concatenação do ID do Produto Kit com as variações selecionadas, separados com um hífen ( - ).
Por exemplo:
ProductID | Tipo | Nome |
1010 | Kit | Meu Kit |
1020 | Produto | Camiseta |
1021 | SKU | Camiseta P |
1022 | SKU | Camiseta M |
1030 | Produto | Bermuda |
1031 | SKU | Bermuda P |
1032 | SKU | Bermuda M |
Se as variações selecionadas pelo consumidor forem
- Camiseta P + Bermuda M >> o ID que será enviado para o OMS será: 1010-1021-1032 ou 1010-1032-1021;
- Camiseta P + Bermuda P >> o ID que será enviado para o OMS será: 1010-1021-1031 ou 1010-1031-1021.
Atenção!
A ordem dos IDs dos SKUs podem variar, mas devem sempre ser os IDs das variações correspondentes. O primeiro ID será sempre o ID do Kit.
Demais regras do processo de cotação:
- O sku a ser informado na cotação obrigatoriamente deve ser o sku ou integrationid da variação (catalogitemtype = 5), respeitando o fluxo atual;
- Somente deve ser enviado o objeto kits caso haja um kit a ser cotado, pois não é permitido o array vazio na cotação;
- O item do kit também deverá ser informado dentro do objeto groups.groupId.items para que seja informado os dados de dimensão e quantidade;
- Ser possível informar quantidade do item (groups.groupId.items.) maior que a quantidade do mesmo item dentro do array kit (kits.[].items.skuId.quantity), significando que parte dessa quantidade a ser cotada é avulsa;
- O valor inserido em kits.[].items.skuId.quantity não pode ser maior que o valor contido groups.groupId.items.skuId1.quantity do mesmo sku;
- Não é possível mais de um stocktype para os items que compõem o mesmo kit.
- O valor da propriedade kits.[].quantity representa a quantidade de kits que será adquirido (não pode ser zero).
Funcionamento no processo de integração do pedido com o LinxOmni:
Regras gerais:
A informação de que os skus adquiridos compõem um KIT serão identificados no pedido enviado ao LinxOmni através da propriedade items.tags do modelo de dados do integrador. Importante salientar que a informação contida nessa propriedade será a mesma informação utilizada pelo kit no processo de cotação para que possa ser utilizado futuramente a fim de comparação e identificação.
A identificação do kit, no commerce, é montada por productid do kit - productid da variação selecionada.
Sendo assim, o envio ficará no seguinte formato:
"items": [ { "sku": "1234", "quantity": 1, "basePrice": 249.99, "price": 187.49, "name": "Tênis", "discount": 62.5, "tags": "1010-11-12" }, { "sku": "5678", "quantity": 1, "basePrice": 249.99, "price": 187.49, "name": "Tênis", "discount": 62.5, "tags": "1010-11-12" }, { "sku": "9010", "quantity": 1, "basePrice": 249.99, "price": 187.49, "name": "Tênis", "discount": 62.5, "tags": "" } ], |
|---|
No exemplo acima nota-se que o pedido contém três itens, porém somente dois deles fazer parte de um kit. Sendo assim, o último item (9010) está com a propriedade tags não preenchida pois não referencia um item dentro do kit. É um item que será enviado de forma avulsa.
Rateio dos Preços!
Por via de regra, um kit possui um valor específico onde o kit acaba sendo menor que a somatória dos valores dos skus que ele compõe. Sendo assim, ao integrar o pedido no LinxOmni, os valores dos itens receberão de forma "rateada" de maneira proporcional o valor do kit entre todos os itens que compõem o kit.