İade kodu oluştur

POST /openapi/Return/SaveReturnCode — TMS API · İade

Müşterinin kargoya vereceği iade için iade kodu tanımlar.

  • Kimlik (organizasyon/hesap) token'dan çözülür. clientCode/accountCode göndermeye devam ederseniz eski (kod tabanlı) akış çalışır; bu alanlar kullanımdan kalkacaktır.
  • orderNumber verilirse müşteri bilgisi siparişten alınır. orderNumber boşsa customer ve pickupAddress zorunludur.
  • Randevulu iadede (chosenPickupDate) pickupAddress her durumda zorunludur; uygun tarihleri GetAvailableReturnDates ile alın.
  • returnCodeMaxUsageCount iade kodunun en fazla kaç kez kullanılabileceğini belirler.

İstek gövdesi

  • clientCode (string): Kullanımdan kalkıyor: kimlik token'dan alınır. Gönderilirse eski (kod tabanlı) akış çalışır.
  • accountCode (string): Kullanımdan kalkıyor: kimlik token'dan alınır. Gönderilirse eski (kod tabanlı) akış çalışır.
  • returnCodes (object[], zorunlu): Tanımlanacak iade kodları.
    • returnCodes.reason (string): İade nedeni.
    • returnCodes.customer (oneOf): İadeyi yapan müşteri. orderNumber boşsa zorunlu; verilirse siparişteki müşteriye göre önceliklidir ve pickupAddress de gerekir.
    • returnCodes.returnCode (string, zorunlu): İade kodu.
    • returnCodes.carrierCode (string): İade taşıyıcısı kodu.
    • returnCodes.orderNumber (string): İadenin ait olduğu sipariş numarası. Boşsa customer ve pickupAddress zorunludur.
    • returnCodes.locationCode (string): İadenin döneceği lokasyon kodu.
    • returnCodes.pickupAddress (oneOf): Alım adresi. orderNumber boşsa ve randevulu iadede zorunlu.
    • returnCodes.isVendorReturn (boolean): Satıcıya (vendor) iade mi.
    • returnCodes.chosenPickupDate (string): Randevulu iadede seçilen alım tarihi (bkz. GetAvailableReturnDates).
    • returnCodes.vendorAgreementTypeId (integer): Satıcı anlaşma tipi kimliği.
    • returnCodes.returnCodeMaxUsageCount (integer): İade kodunun en fazla kullanım sayısı.
    • returnCodes.returnCodeVolumetricWeight (number): İade desisi.

Yanıtlar

  • 200: İade kodu oluşturuldu
  • 400: Doğrulama hatası
  • 401: Token yok/geçersiz ya da token hesap bilgisi içermiyor

200 yanıt alanları