Ödeme İşlemlerini ERP’ye Aktarma

Açıklama

Ödeme işlemlerinin ERP’ye aktarıldığını işaretlemek için kullanılır. Başarılı çağrıda ilgili işlemin vposTransactionDetails.erpTransactionCode ve vposTransactionDetails.erpTransactionCodeUpdateDate alanları set edilir. Servis idempotenttir; daha önce işaretlenmiş kayıtlar tekrar güncellenmez.

• URL: /api/setPaymentErpCode
• Method: PUT
• Header:
  Authorization: Bearer <AccessToken> (Bkz: 2.1 AccessToken Oluşturma)
  Content-Type: application/json
• Filters: (Bu servis bir işaretleme işlemidir; sorgu filtreleri yerine gövdede parametre alır.)

İstek (Request) Gövdesi

Aşağıdaki alanlar gönderilir:

Parametre	Tip	Zorunlu	Açıklama
referenceCode	string	Evet	Netahsilat işlem referansı
erpTransactionCode	string	Evet	ERP’ye gönderilen işlem kodu

Response Yapısı

İşlem sonucu özet olarak döner. Dizi elemanları aşağıdaki alanları içerir:

Alan	Tip	Açıklama
ReferenceCode	string	Netahsilat işlem referansı
ClientReferenceCode	string	Müşteri tarafından belirlenen referans (varsa)
ErpTransactionCode	string	null
Message	string	Sonuç mesajı: “Başarılı”, “Daha Önce Aktarılmış”, “Kayıt Bulunamadı”
MessageCode	string	Sonuç kodu: "00" (Başarılı), "100" (Bilgi/uyarı)

Notlar

• “Daha Önce Aktarılmış” mesajı, kaydın daha önce işaretlendiğini belirtir; yeniden güncelleme yapılmaz (idempotent davranış).

• İşaretleme sonrasında GetPayments ile sorgulayarak kaydın ERP alanlarının dolduğunu doğrulayabilirsiniz.

• Hata durumları için bkz. 4. Genel Hata Modeli & Kodlar.

Örnek Yanıt(Response)

[  
  {  
    "ReferenceCode": "NT78451238475",  
    "ClientReferenceCode": "NT78451238475",  
    "ErpTransactionCode": "120.01.1020",  
    "Message": "Başarılı",  
    "MessageCode": "00"  
  },  
  {  
    "ReferenceCode": "NT78451238475",  
    "ClientReferenceCode": "NT78451238475",  
    "ErpTransactionCode": "120.01.1020",  
    "Message": "Daha Önce Aktarılmış",  
    "MessageCode": "100"  
  },  
  {  
    "ReferenceCode": "NT78451238475",  
    "ClientReferenceCode": "NT78451238475",  
    "ErpTransactionCode": null,  
    "Message": "Kayıt Bulunamadı",  
    "MessageCode": "100"  
  }  
]

Örnek CURL

curl --location 'https://test_erpproxy.ecozum.com/api/setPaymentErpCode' \  
  -X PUT \  
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \  
  --header 'Content-Type: application/json' \  
  --data '{  
    "referenceCode": "NTH2P00000001926",  
    "erpTransactionCode": "DENEMEAktarim"  
  }'