Paketi gruplara böl

POST /OrderPackage/shipment-packages/{shipmentPackageId}/multi-split — OMS API · Paket Bölme

Tek istekte paketi birden fazla pakete böler; her splitGroups elemanı ayrı bir paket olur. Paketteki satırların hepsini gruplara yazmayın: gruplara yazılmayan satırlar için sistem otomatik olarak ayrı bir paket oluşturur. Örneğin [1,2] ve [3] grupları verildiğinde, kalan satırlarla birlikte üç paket oluşur.

Bölme asenkron tamamlanır: yeni paketleri görmek için GetOrderPackages ile paketleri yeniden çekin.

Parametreler

  • shipmentPackageId (path, integer<int64>, zorunlu): Bölünecek paketin OMS kimliği (GetOrderPackages yanıtındaki id; sourcePackageId değil).

İstek gövdesi

  • splitGroups (object[], zorunlu): Her grup ayrı bir paket olur. Gruplara yazılmayan satırlar için sistem ayrıca bir paket oluşturur.
    • splitGroups.orderLineIds (integer<int64>[], zorunlu): Bu gruptaki satırların OMS kimlikleri.

Yanıtlar

  • 200: Başarılı. Gövdedeki isSuccess alanını mutlaka kontrol edin.
  • 400: Gövde doğrulanamadı (zorunlu alan eksik, tip uyumsuz ya da JSON bozuk). Yanıt ASP.NET Core ValidationProblemDetails biçimindedir; errors alanı hangi alanın hatalı olduğunu gösterir.
  • 401: Authorization başlığı yok, token geçersiz ya da süresi dolmuş. Gövde boş döner; /Auth/login ile yeni token alın.
  • 500: Beklenmeyen sunucu hatası. Bu yanıt PascalCase alan adlarıyla döner (diğer yanıtlardan farklı olarak) ve null alanlar da yazılır.

200 yanıt alanları

  • errors (object[]): Ayrıntılı hata listesi. Yalnızca doluysa döner.
    • errors.code (string): Hata kodu.
    • errors.message (string): Hata mesajı.
  • isSuccess (boolean, zorunlu): İşlem başarılı ise true. HTTP 200 dönse bile false olabilir; her yanıtta kontrol edin.
  • statusCode (integer<int32>, zorunlu): Durum kodu. Başarılı yanıtlarda genellikle 0 gelir; HTTP durum kodu yerine kullanılmamalıdır.
  • errorSource (string): Hata kaynağı. Yalnızca doluysa döner.
  • correlationId (string): İstek izleme kimliği. Yalnızca doluysa döner.
  • errorMesssage (string): Hata mesajı (alan adı kaynakta üç s ile yazılmıştır). Yalnızca hata varsa döner.