Gönderi kaydet

POST /openapi/Consignment/SaveConsignment — TMS API · Sipariş ve Gönderi Kaydı

Daha önce kaydedilmiş siparişlere yeni gönderi (konsinye) ekler. İstek kuyruğa alınır ve bir ticketNumber döner; sonucu GetTicketNumberStatus ile sorgulayın.

Kendi araç filonuzla dağıtım yapıyorsanız carInfo, driverInfo ve routeInfo ile araç, sürücü ve rota bilgisini de gönderebilirsiniz.

İstek gövdesi

  • orders (object[], zorunlu): Gönderi eklenecek siparişler.
    • orders.orderNumber (string, zorunlu): Kayıtlı sipariş numarası.
    • orders.consignments (object[], zorunlu): Eklenecek gönderiler.
      • orders.consignments.attr1 (string): Serbest alan 1.
      • orders.consignments.attr2 (string): Serbest alan 2.
      • orders.consignments.attr3 (string): Serbest alan 3.
      • orders.consignments.attr4 (string): Serbest alan 4.
      • orders.consignments.attr5 (string): Serbest alan 5.
      • orders.consignments.attr6 (string): Serbest alan 6.
      • orders.consignments.attr7 (string): Serbest alan 7.
      • orders.consignments.attr8 (string): Serbest alan 8.
      • orders.consignments.attr9 (string): Serbest alan 9.
      • orders.consignments.attr10 (string): Serbest alan 10.
      • orders.consignments.weight (number): Ağırlık (kg).
      • orders.consignments.products (object[]): Gönderideki ürünler.
      • orders.consignments.vendorId (integer): Satıcı kimliği (pazaryeri satıcı gönderisi).
      • orders.consignments.totalPrice (number): Gönderi tutarı.
      • orders.consignments.carrierCode (string): Taşıyıcı kodu. Boşsa taşıyıcı hesap kurallarına göre seçilir.
      • orders.consignments.currentPrice (number): Kapıda ödemede tahsil edilecek tutar.
      • orders.consignments.isChangeable (boolean): Taşıyıcı sonradan değiştirilebilir mi.
      • orders.consignments.locationCode (string): Çıkış lokasyonu kodu. Boşsa hesabın varsayılan lokasyonu kullanılır.
      • orders.consignments.senderAddress (oneOf): Gönderici adresi (pazaryeri müşteriden müşteriye gönderilerde).
      • orders.consignments.totalQuantity (integer): Gönderideki ürün adedi.
      • orders.consignments.toLocationCode (string): Varış lokasyonu kodu (mağazaya/depoya transferde).
      • orders.consignments.isSendCargoData (boolean): Gönderi verisi taşıyıcıya iletilsin mi.
      • orders.consignments.isVendorPackage (boolean): Satıcı (vendor) gönderisi mi.
      • orders.consignments.paymentTypeCode (string): Ödeme tipi kodu (bkz. GetPaymentTypes).
      • orders.consignments.pickUpPointCode (string): Teslimat noktası (pick-up point) kodu.
      • orders.consignments.shippingAddress (object)
      • orders.consignments.deliverySlotCode (string): Teslimat zaman dilimi kodu.
      • orders.consignments.deliveryTypeCode (string): Teslimat tipi kodu.
      • orders.consignments.volumetricWeight (number): Desi.
      • orders.consignments.consignmentNumber (string): Gönderi (konsinye/paket) numarası.
      • orders.consignments.isStatusTrackManuel (boolean): Durum takibi elle (Durum Bildirimi uçlarıyla) yapılacak mı.
      • orders.consignments.vendorAgreementTypeId (integer): Satıcı anlaşma tipi kimliği.
      • orders.consignments.pickUpPointCompanyCode (string): Teslimat noktası firma kodu.
      • orders.consignments.salesChannelTrackingNumber (string): Satış kanalının (pazaryerinin) verdiği takip numarası.
      • orders.consignments.saleChannelConfigurationKey (string): Satış kanalı yapılandırma anahtarı.
      • orders.consignments.estimatedPackagingCompletionDate (string<date-time>): Kargoya teslim tarihi.
      • orders.consignments.expectedPackagingCompletionDueDate (string<date-time>): Pazaryerinin beklediği/anlaşılan kargoya teslim tarihi.
  • carInfo (object): Kendi filonuzla dağıtımda araç bilgisi.
    • carInfo.carPlate (string): Plaka.
    • carInfo.carTypeName (string): Araç tipi.
  • routeInfo (object): Kendi filonuzla dağıtımda rota bilgisi.
    • routeInfo.count (integer): Rotadaki durak sayısı.
    • routeInfo.locations (string[]): Rota lokasyon kodları.
    • routeInfo.routeName (string): Rota adı.
  • clientCode (string, zorunlu): Organizasyon kodu.
  • driverInfo (object): Kendi filonuzla dağıtımda sürücü bilgisi.
    • driverInfo.email (string): E-posta.
    • driverInfo.lastName (string): Soyad.
    • driverInfo.password (string): Sürücü kullanıcısının parolası.
    • driverInfo.firstName (string): Ad.
    • driverInfo.driverUserName (string): Sürücü kullanıcı adı.
  • accountCode (string, zorunlu): Hesap kodu.
  • salesChannelCode (string): Satış kanalı/pazaryeri kodu.

Yanıtlar

  • 200: Kayıt kuyruğa alındı (ya da senkron işlendi)
  • 400: Hesap doğrulanamadı ya da senkron kayıt hata verdi
  • 401: Token yok, geçersiz ya da süresi dolmuş (gövdesiz yanıt).
  • 429: İstek sınırı aşıldı.

200 yanıt alanları