Kartonizasyon API

Sipariş satırlarını doğru kutulara çevirin.

Ürünleri ve kullanılabilir kolileri WiCartonize’a gönderin. Paket atamaları, kutu seçimi ve 3D koordinatlar içeren optimize edilmiş bir paketleme planı alın — e-ticaret, WMS ve 3PL iş akışlarına hazır.

API + Web arayüzüÇoklu koli siparişleriYüksek hacimli iş akışları

POST /api/v1/pack
// Example request · mm / g
{
  "requestId": "order-20481",
  "dimensionUnit": "mm",
  "weightUnit": "g",
  "items": [
    {
      "name": "SKU-1001",
      "quantity": 2,
      "dimensions": {
        "length": 320,
        "width": 220,
        "height": 80
      },
      "weight": 450
    }
  ],
  "boxes": [
    { "name": "S", "dimensions": { "length": 350, "width": 250, "height": 120 }, "maxWeight": 5000 },
    { "name": "M", "dimensions": { "length": 450, "width": 350, "height": 250 }, "maxWeight": 15000 }
  ]
}
optimize edilmiş paketleme planı döner
E-ticaret için WMS ile çalışır 3PL için tasarlandı API + Web arayüzü Shopify için de mevcut

Algoritmayı kendiniz yazmadan kartonizasyon.

Sipariş yönetimi, depo ve fulfillment iş akışlarınız yerinde kalsın; uygulamanıza paketleme zekası ekleyin.

Otomatik kutu seçimi

Zaten kullandığınız kolileri değerlendirin ve her sipariş için basit hacim hesabı yerine uygun kutuyu seçin.

3D paketleme planları

Paketleme talimatı, görselleştirme ve depo iş akışlarını destekleyen yerleştirme verisi döndürün.

Çoklu koli siparişleri

Tek koli yetmediğinde siparişi birden fazla fiziksel pakete bölün; atama açık kalsın.

Yüksek hacimli işleme

Sistemler arası işler için API’yi, mühendislik olmadan büyük sipariş setleri için Web arayüzünü kullanın.

Esnek ürün girişi

Kayıtlı ürünlere itemId ile referans verin veya satır içi length, width, height, ağırlık ve adet gönderin. İki mod aynı istekte bir arada olabilir.

Platformunuzdan bağımsız

WMS, OMS, ERP, özel e-ticaret yığını veya yalnızca Web arayüzü. Shopify zorunlu değildir.

Üç girdi. Bir paketleme kararı.

WiCartonize, sipariş veriniz ile fiziksel paket kararının gerektiği nokta arasında durur. Motor gerçek 3D yerleştirmedir — hacim karşılaştırması değil.

1
Ürünleri gönderinKayıtlı itemId ve adet, ya da satır içi ölçü, ağırlık ve adet.
2
Kullanılabilir kolileri gönderinSatır içi kutu + maxWeight, kayıtlı boxId veya kutuları atlayıp paketleme profili.
3
Paketleme planını alınSeçilen kutular, paket içeriği, koordinatlar, doluluk, kalanlar ve incelenebilir 3D embed.
Örnek paketleme sonucuSipariş #WC-20481
Seçilen koliMedium
Paket1
Atanan ürün2

İstekten paketleme planına tek API akışı.

Public Gateway’e tenant API anahtarı ile çağrı yapın. Master data isteğe bağlıdır. Geçersiz itemId değerleri ITEM_REFERENCE_NOT_FOUND döner — sessiz düşüş yok.

İSTEK
curl -X POST "https://wicartonizegateway-wicartonize.up.railway.app/api/v1/pack" \
  -H "X-Api-Key: $WICARTONIZE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "requestId": "order-20481", "items": [{ "name": "SKU-1001", "quantity": 2, "dimensions": { "length": 320, "width": 220, "height": 80 }, "weight": 450 }], "boxes": [{ "name": "M", "dimensions": { "length": 450, "width": 350, "height": 250 }, "maxWeight": 15000 }] }'
YANIT
{
  "requestId": "order-20481",
  "decisionId": "8f2c1a0e-…",
  "status": "Packed",
  "summary": {
    "boxCount": 1,
    "packedItemCount": 2,
    "leftoverItemCount": 0,
    "utilization": 0.61
  },
  "packages": [
    {
      "packageIndex": 0,
      "box": { "name": "M" },
      "items": [
        {
          "name": "SKU-1001",
          "position": { "x": 0, "y": 0, "z": 0 }
        }
      ]
    }
  ],
  "leftovers": []
}

Public boyut alanları length, width ve height. Kimlik: X-Api-Key veya Authorization: Bearer. Tam sözleşme: Geliştirici API.

Paket kararı gereken her yerde kartonizasyon.

API’yi yalnızca “kartonizasyon” kelimesine değil, alıcıların zaten aradığı problemlere konumlandırın.

E-ticaret fulfillment

Etiket üretimi veya depo paketlemesinden önce paket sayısını kestirin ve koliyi seçin.

WMS kartonizasyonu

Dalga, tahsis, toplama veya pack iş akışına kutu seçimi ekleyin; motoru kendiniz yazmayın.

3PL operasyonu

Birden fazla müşteri, kanal ve depo sürecinde tutarlı bir paketleme hizmeti uygulayın.

Shopify siparişleri

Shopify Admin içinde kullanın veya aynı motoru kendi iş akışınızdan çağırın. Shopify zorunlu değildir.

Tek siparişten fazlası için.

Operasyon ekipleri ve yazılım platformları için kartonizasyon, büyük sipariş setlerinde tekrar tekrar ve tutarlı uygulandığında daha değerlidir.

Sistemler arası iş akışları için programatik API erişimi.
Entegrasyon olmadan hesaplama isteyen operasyon kullanıcıları için Web arayüzü.
Sipariş partileri, depo planlama ve ön-kartonizasyon iş akışlarına uygun.
Ürün ve koli master data’sını sizde tutun — veya satır içi ölçü gönderin.
Toplu hesaplamaÖrnek operasyon
orders-2026-09-13-a1.000 siparişTamam
orders-2026-09-13-b2.500 siparişTamam
orders-2026-09-13-c500 siparişTamam
orders-2026-09-13-d5.000 siparişTamam

Toplu kartonizasyon için örnek arayüz. Hız iddiaları yalnızca ölçüldükten sonra yayınlanır.

Kartonizasyon API nedir?

Kartonizasyon API, başka bir uygulamanın siparişin nasıl paketlenmesi gerektiğini belirlemesine yardımcı olan bir yazılım arayüzüdür. Basit hacim karşılaştırmasıyla kutu seçmek yerine; ürün ölçüleri, adetler ve kullanılabilir kolileri değerlendirir ve bir veya birden fazla fiziksel paket döndürür.

Bu nedenle kartonizasyon; paketlemeden önce, fulfillment’tan önce veya bir sistemin kaç koli gerektiğini bilmesi gereken her yerde işe yarar. E-ticaret platformları, WMS, 3PL yazılımları ve özel fulfillment uygulamaları, algoritmayı kendi kod tabanlarına gömmeden aynı paketleme hizmetini çağırabilir.

Kartonizasyon API vs. 3D bin packing API

Terimler örtüşür ama arama niyeti farklı olabilir. “3D bin packing API” çoğunlukla geometrik bir paketleme problemi düşünen geliştiriciler tarafından aranır; “kartonizasyon API” ise e-ticaret ve depo iş akışlarında kullanılır. WiCartonize ikisidir: fulfillment için kartonizasyon API olarak sunulan bir 3D paketleme motoru.

WMS veya fulfillment akışında nereye oturur?

Paketleme kararı sipariş planlama, dalga, toplama, pack veya etiket anında gerekebilir. WiCartonize bağımsız bir hizmettir: WMS veya ticaret platformu kayıt sistemi olarak kalır, POST /api/v1/pack bir sonraki adımın ihtiyaç duyduğu paket planını döner. WMS entegrasyon kontrol listesine bakın.

WiCartonize Shopify olmadan kullanılabilir mi?

Evet. WiCartonize API ve Web arayüzü üzerinden bağımsız kullanılabilir. Shopify eklentisi ek bir deneyimdir, zorunluluk değildir. Bu, ürünü Shopify dışındaki geliştiricilere, WMS satıcılarına, 3PL’lere ve e-ticaret ekiplerine açık tutar.

Sık sorulan kartonizasyon API soruları

Kartonizasyon API ne döndürür?

WiCartonize seçilen kolileri, her paketteki ürünleri, milimetre yerleştirme koordinatlarını, doluluğu, kalanları, bölünme nedenlerini ve isteğe bağlı bir 3D inceleme URL’si döndürür.

Bir sipariş birden fazla kutuya bölünebilir mi?

Evet. Sipariş tek koliye sığmadığında veya ağırlık ve geometri birden fazla fiziksel paketi daha iyi kıldığında çoklu kutu çıktısı kullanılır.

Kendi WMS veya OMS’imle kullanabilir miyim?

Evet. API bağımsız bir paketleme hizmetidir. WMS, OMS, ERP veya özel uygulamanız sipariş ve master data kaynağı olarak kalır.

Shopify kullanmak zorunda mıyım?

Hayır. Shopify bir entegrasyon yoludur. WiCartonize API ve Web arayüzü üzerinden de kullanılır.

Ürün ID’si mi ölçü mü göndermeliyim?

İkisi de olur. itemId varsa yalnızca quantity yeterlidir. Yoksa length, width, height, weight ve quantity zorunludur. Geçersiz ID’ler ITEM_REFERENCE_NOT_FOUND ile başarısız olur.

Uygulamanıza bir paketleme motoru verin.

Otomatik iş akışları için API’yi kullanın; entegrasyon projesi olmadan kartonizasyon gerektiğinde Web arayüzünü açın.