Utilização de Itens do Tipo Kit na Integração de Pedidos via API – Nordware

Visão Geral

A API de integração de pedidos do Enviando passou a suportar itens do tipo Kit por meio de um novo array no payload de criação de pedidos: kits.

Essa melhoria foi criada para atender cenários logísticos onde a separação operacional deve ocorrer por um SKU de Kit, enquanto o faturamento continua sendo realizado pelos SKUs componentes, sem necessidade de ajustes externos ou mudanças no fluxo interno do Enviando.

Quando Utilizar Kits

Essa funcionalidade é indicada para operações que apresentam o seguinte cenário:

O pedido comercial/fiscal é composto por SKUs componentes
A operação logística (WMS) trabalha melhor separando por um SKU agregador (Kit)
O cliente deseja:
- Simplificar a separação
- Manter o faturamento baseado nos componentes
- Evitar adaptações externas na integração

Exemplo típico:

Um “Kit Promocional” vendido como unidade logística, mas faturado por livros, canecas, brindes etc.

O Que Mudou na API

Novo Campo no Payload

Foi adicionado um novo array ao endpoint de criação de pedidos:

"kits": []

Estrutura do Array `kits`

O array kits possui exatamente a mesma estrutura do array items.

Cada objeto representa um SKU do tipo Kit.

Exemplo de item de kit:

{
  "item": {
    "code": "KIT001",
    "gtin": "999999999",
    "description": "Kit Promocional",
    "quantity": 1
  }
}

Regra de Prioridade entre `items` e `kits`

A API passa a seguir a seguinte regra:

✅ Quando `kits` não é informado ou está vazio

O comportamento atual permanece inalterado
O sistema utiliza normalmente os itens enviados em items

✅ Quando `kits` está preenchido

O array items é totalmente ignorado
Apenas os itens informados em kits serão considerados no pedido
Os kits substituem logicamente os itens padrão para todo o processamento

⚠️ Importante:
Mesmo que items esteja preenchido, ele não será utilizado se kits existir e contiver itens.

Impacto no Processamento Interno

Nenhuma alteração foi feita no fluxo interno do Enviando.

Após a substituição lógica:

Os itens de kits são tratados como itens padrão
Não há diferenciação no:
- WMS
- Regras de envio
- Separação
- Demais etapas operacionais

A diferença está apenas na origem do item considerado (kits em vez de items).

Exemplo Completo de Payload com Kit

POST https://sandbox.enviando.nordware.io/webapi/order/SLUG

{
  "number": "1",
  "date": "2025-01-01",
  "store": "1",
  "situation": "Atendido",
  "items": [
    {
      "item": {
        "code": "COMPONENTE1",
        "gtin": "111111111",
        "description": "Componente 1",
        "quantity": 2
      }
    }
  ],
  "kits": [
    {
      "item": {
        "code": "KIT001",
        "gtin": "999999999",
        "description": "Kit Promocional",
        "quantity": 1
      }
    }
  ],
  "client": {
    "name": "João da Silva",
    "cnpj": "",
    "email": "",
    "cellPhone": "",
    "city": "São Paulo",
    "province": "SP",
    "postalCode": "12345678",
    "district": "Centro",
    "number": "123",
    "address": "Rua Brasil",
    "complement": ""
  },
  "transport": {
    "volumes": [
      {
        "volume": {
          "idService": "1"
        }
      }
    ],
    "addressDelivery": {
      "name": "João da Silva",
      "cnpj": "",
      "cellPhone": "",
      "city": "São Paulo",
      "province": "SP",
      "postalCode": "12345678",
      "district": "Centro",
      "number": "123",
      "address": "Rua Brasil",
      "complement": ""
    }
  }
}

Observação Importante

No exemplo acima:

O array items está preenchido
Porém, ele será ignorado
O pedido será processado exclusivamente com base no array kits

Boas Práticas de Uso

✅ Utilize kits somente quando houver necessidade operacional
✅ Garanta que o SKU do Kit esteja corretamente cadastrado no WMS
⚠️ Evite duplicar informações entre items e kits
⚠️ Não utilize kits para cenários onde faturamento e separação devem ocorrer pelo mesmo SKU

Resumo

kits é um novo array para integração de SKUs do tipo Kit
Quando preenchido, ele substitui completamente o array items
O faturamento continua baseado nos componentes
A separação logística pode ser otimizada usando o SKU do Kit
Nenhuma mudança é necessária no fluxo interno do Enviando