Tedarikçi Sipariş İptal - cancelPaysSupplierShipping()

Tedarikçi Sipariş İptal İşlemi

Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu üzerinde bulunan cancelPaysSupplierShipping() metodu, daha önce createPaysSupplierShipping() metodu ile oluşturulmuş tedarikçi öder tipinde bir sevk emrini, eğer ilgili sevk emri iptal şartlarına uyuyor ise iptal etmek için kullanılır. Eğer daha önce Horoz Lojistik sistemine createPaysSupplierShipping() metodu ile gönderilen sevk emri kaydı, Horoz Lojistik operasyonu tarafından onaylanıp, mal kabulü yapılarak operasyonel yaşam döngüsüne başladı ise, istemci cancelPaysSupplierShipping() metodu ile ilgili sevk emrinin iptalini denediğinde, entegrasyon üzerinden hata alacaktır. cancelPaysSupplierShipping() metodu ile ilgili önemli bilgiler ve Horoz sisteminde sevk emri iptal edilirken dikkat edilmesi gerekenler liste halinde aşağıda istemcilerin bilgisine sunulmuştur.

• cancelPaysSupplierShipping() metodu POST yöntem ile JSON formatta veri alan, bir RESFtul web servis metodudur.

• cancelPaysSupplierShipping() metodu ile Horoz sistemine daha önce gönderilmiş bir sevk emri için iptal işlemi yaparken, sipariş numarası metodun body kısmına JSON veri tipinde geçilmelidir. İstemciye ait processKey bilgisi metodun header kısmına parametre tipinde geçilmelidir. cancelPaysSupplierShipping() metodu ile yapılan gönderim UTF-8 olarak encode edilerek Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Web servisine iletilmelidir.

• createPaysSupplierShipping() metodu ile Horoz Lojistik sistemine iptal isteği gönderilecek siparişin, daha evvel createPaysSupplierShipping() metodu ile Horoz Lojistik Yurtiçi Dağıtım Entegrasyonu Webservisi aracılığı ile Horoz Lojistik sisteminde oluşturulmuş olması gerekir. Horoz Lojistik sisteminde mevcut olmayan sipariş iptal edilemez.

• cancelPaysSupplierShipping() metodu ile Horoz Lojistik sistemine iptal isteği gönderilecek siparişin, Horoz Lojistik tarafında onaylanmamış, mal kabul kaydının yapılmamış olması gerekir. Aksi halde cancelPaysSupplierShipping() metodu ile yapılan çağrı için istemciye hata dönülecektir.

• cancelPaysSupplierShipping() metodu iptal işlemini sipariş bazlı yapmaktadır. Daha önce createPaysSupplierShipping() metodu ile oluşturulmuş bir siparişin içerisindeki herhangi bir ürünün, herhangi bir parçası için parça bazlı iptal işlemi yapılamaz.

• cancelPaysSupplierShipping() metodu ile Horoz Lojistik sistemine iptal isteği gönderilirken istek içerisine, requestNumber alanına ek olarak, daha evvel createPaysSupplierShipping() metodu ile tedarikçi öder siparişi oluştururken geçilen senderCode bilgisi marketPlaceMerchantCode alanınında geçilmesi beklenir.

---

POST cancelPaysSupplierShipping()

ENDPOINT

http://b2btest.horoz.com.tr:7801/horozshipping_test/v1/cancelPaysSupplierShipping

Parametre Açıklamaları & Kuralları

Aşağıdaki tabloda cancelPaysSupplierShipping() işleminin giriş ve çıkış parametreleri ve bu parametrelerin tür ve formatları listelenmiştir.

Alanlar

Alanlar	Açıklama	Veri Tipi	Uzunluk	Alan Yeri	Zorunluluk
processKey	İstemci için tanımlanan processKey bilgisi	string	100	Header	Zorunlu
requestNumber	Sipariş numarası	string	50	inBody Request	Zorunlu
marketPlaceMerchantCode	Pazaryeri Satıcı Kodu	string	100	inBody Request	Zorunlu

Örnek İstek

{
  "requestNumber": "TEST-17052023-1",
  "marketPlaceMerchantCode": "801411"
}  

Örnek Cevap

{
    "response": {
        "responseCode": "STA-100",
        "responseMessage": "Kayit islemi basarili"
    }
}

---

Servis Cevapları

Response Kodu	Response Mesajı	Açıklama
STA-100	Kayit islemi basarili	Sevkiyat iptal işleminin başarılı olduğunu ifade eder.
ERR-20001	HATALI IŞLEM ANAHTARI	Geçilen processKey bilgisinin yanlış olduğunu belirtir.
ERR-20003	BU TALEP NUMARASI DAHA ÖNCE İPTAL EDİLMİŞ - Key: XXX TalepNo: XXX	Girilen requestNumber bilgisine sahip siparişin daha önce iptal edildiğini ifade eder.
ERR-20004	TALEP NUMARASI BULUNAMADI - Key: XXX TalepNo: XXX	İstekte geçilen requestNumber ile daha önce bir sevkiyat oluşturulmadığını ifade eder.
ERR-20010	TALEP ONAYLANDIĞINDAN İPTAL EDİLEMEZ	İlgili sevkiyat lojistik sürece girdiğinden dolayı iptal edilemeyeceğini ifade eder.
ERR-20036	marketPlaceMerchantCode BİLGİSİ BOŞ GEÇİLEMEZ.	marketPlaceMerchantCode bilgisinin eksik girildiğini ifade eder.
ERR-20036	requestNumber BİLGİSİ BOŞ GEÇİLEMEZ.	requestNumber bilgisinin eksik girildiğini ifade eder.