Sipariş ve gönderi bilgisi

POST /openapi/Consignment/GetConsignmentInfo — TMS API · Takip ve Durum

Siparişlerin gönderilerini; taşıyıcı, takip numarası/bağlantısı, desi, teslimat tipi, fiyat, tahmini teslim tarihleri, koli bilgisi, son durum ve tüm durum geçmişiyle birlikte döner.

  • orders[].consignments boş bırakılırsa siparişin tüm gönderileri döner.
  • Durum kodları (statusCode) TMS durum tablosundan gelir; ör. NOTSTARTED, PRINTEDBARCODELABEL, WAITDELIVERY, INTRANSIT, ENROUTE, DELIVERED, RETURNED.
  • carrierStatusCode / carrierStatus taşıyıcının kendi durum kodu ve açıklamasıdır.

İstek gövdesi

  • orders (object[], zorunlu): Sorgulanacak siparişler.
    • orders.orderNumber (string): Sipariş numarası.
    • orders.consignments (object[]): Yalnız bu gönderileri getir; boşsa siparişin tüm gönderileri döner.
  • clientCode (string, zorunlu): Organizasyon kodu.
  • accountCode (string, zorunlu): Hesap kodu.

Yanıtlar

  • 200: Sipariş bazında gönderi bilgisi
  • 400: Doğrulama hatası
  • 401: Token yok, geçersiz ya da süresi dolmuş (gövdesiz yanıt).

200 yanıt alanları

  • orderNumber (string): Sipariş numarası.
  • consignments (object[]): Siparişin gönderileri.
    • consignments.carrier (string): Taşıyıcı adı.
    • consignments.otpCode (string): Teslimat noktası gönderilerinde teslim alma kodu.
    • consignments.shipments (object[]): Gönderiye bağlı taşıyıcı gönderileri.
      • consignments.shipments.price (number): Müşteri fiyatı.
      • consignments.shipments.carrier (string): Taşıyıcı adı.
      • consignments.shipments.parcels (object[]): Koliler.
      • consignments.shipments.lastStatus (object)
      • consignments.shipments.returnCode (string): İade kodu (iade gönderilerinde).
      • consignments.shipments.carrierCode (string): Taşıyıcı kodu.
      • consignments.shipments.carrierCost (number): Taşıyıcı maliyeti.
      • consignments.shipments.deliveryType (string): Teslimat tipi adı.
      • consignments.shipments.locationCode (string): Çıkış lokasyonu kodu.
      • consignments.shipments.trackingLink (string): Takip bağlantısı.
      • consignments.shipments.trackingNumber (string): Takip numarası.
      • consignments.shipments.statusHistories (object[]): Durum geçmişi (eskiden yeniye).
      • consignments.shipments.deliveryDuration (integer): Tahmini teslim süresi (gün).
      • consignments.shipments.deliverySlotType (string): Teslimat zaman dilimi adı.
      • consignments.shipments.deliveryTypeCode (string): Teslimat tipi kodu.
      • consignments.shipments.volumetricWeight (number): Bildirilen desi.
      • consignments.shipments.deliverySlotTypeCode (string): Teslimat zaman dilimi kodu.
      • consignments.shipments.estimatedDeliveryTime (string<date-time>): Tahmini teslim zamanı.
      • consignments.shipments.estimatedShippingTime (string<date-time>): Tahmini kargoya veriliş zamanı.
      • consignments.shipments.carrierVolumetricWeight (number): Taşıyıcının ölçtüğü desi.
    • consignments.carrierCode (string): Taşıyıcı kodu.
    • consignments.locationCode (string): Çıkış lokasyonu kodu.
    • consignments.consignmentNumber (string): Gönderi numarası.
    • consignments.consignmentStatus (object)
      • consignments.consignmentStatus.status (string): TMS durum açıklaması.
      • consignments.consignmentStatus.statusCode (string): TMS durum kodu.
      • consignments.consignmentStatus.statusDate (string<date-time>): Durum zamanı.
      • consignments.consignmentStatus.carrierStatus (string): Taşıyıcının durum açıklaması.
      • consignments.consignmentStatus.carrierStatusCode (string): Taşıyıcının durum kodu.
  • errorMessage (string): Sipariş bazında hata mesajı.
  • customizedTrackingLink (string): Hesabınıza özel takip sayfası bağlantısı.