SAP S/4HANA
Durum: müşteri tarafından geliştirilmesi planlanan bağlantı. Mevcut kod hazır SAP S/4HANA bağlayıcısı, OAuth istemcisi veya SAP’ye yazma işlemi içermez. Webhook, API ve SDK mevcut entegrasyon araçlarıdır; SAP’ye özgü kayıt eşlemesi ve aktarım kurumun uygulamasında geliştirilir.
ABAP Başlangıç Taslağı
apps/docs/examples/sap-webhook-handler.abap dosyası,
zcl_mr_webhook_handler sınıfını tanımlar. handle metodu üç metin girdisi
alır: iv_idempotency_key, iv_signature ve iv_raw_body.
| Durum | Taslaktaki sonuç |
|---|---|
| Anahtar veya imza boş | rv_status_code = 400 |
| Anahtar ve imza dolu | rv_status_code = 202 |
| HMAC doğrulaması | Uygulanmamış; yorum olarak bırakılmış |
| Kalıcı tekilleştirme | Uygulanmamış; yorum olarak bırakılmış |
| MevzuatRadar API çağrısı | Uygulanmamış; yorum olarak bırakılmış |
| SAP’ye kayıt yazma | Uygulanmamış; yorum olarak bırakılmış |
Metodun döndürdüğü sayı, HTTP sunucusunda otomatik yanıt üretmez. Taslak
HTTP hizmet kaydı veya gelen başlıkları bu metoda bağlayan bir işleyici
içermez. 202 sonucu imzanın doğrulandığını, işin kalıcı kabul edildiğini
veya SAP kaydı oluşturulduğunu kanıtlamaz; taslak üretim alıcısı olarak
doğrudan kullanılmaz.
Planlanan Aktarım
Aşağıdaki akış müşteri uygulamasında tamamlanacak tasarımdır:
- Kurumun HTTPS alıcısı gelen ham gövdenin özgün baytlarını saklar.
X-Webhook-Signature-V2imzasını ve 300 saniyelik zaman toleransını alıcı sözleşmesine göre doğrular. - Olay türü, sürümü ve gövdesi denetlenir.
X-Webhook-Idempotency-Keyile iş kaydı kalıcı depoda atomik tutulur. Yalnız anahtarın yazılması, işin kabul edildiği anlamına gelmez. - İşleyici gerekli veriyi
https://api.mevzuatradar.comüzerinden API anahtarıyla okur. Node.js SDK’dalistChanges,listDeadlinesvegetEvidencePackmetotları bulunur; ABAP taslağı bu metotları çağırmaz. - SAP sürümü, hedef kayıt türü, alan eşlemesi ve kullanılacak arayüz kurum tarafından belirlenir. SAP tarafında OAuth gerekiyorsa istemci kaydı, yetkiler ve token alma işlemi bu bağlantı kapsamında ayrıca geliştirilir. MevzuatRadar API anahtarı SAP erişim bilgisi değildir.
- SAP kaydı, kalıcı tekilleştirme anahtarıyla ilişkilendirilir. İşleyici başarısız aktarımları kurumun kuyruğunda izler ve yeniden dener.
listChanges, doğrulama durumu PASSED olan ve yayın görünürlüğü ile kalite
koşullarını karşılayan kayıtları listeler. listDeadlines, kurumdaki vadesi
olan açık işlemleri; getEvidencePack, mevcut kanıt paketinin ayrıntısını
okur. Bu metotların tümü için genel bir “doğrulanmış veri” garantisi
verilmez. Yol ve izin kapsamları entegrasyon genel bakışında
yer alır.
Veri Biçimi ve İşletim
- API okuma yanıtları JSON’dır. Bu taslak SAP IDoc, CDS görünümü veya SAP’ye özgü bir dışa aktarma dosyası üretmez.
- Sırlar kurumun güvenli sır yönetiminde tutulur; kod veya örnek dosyaya gerçek erişim bilgisi yazılmaz.
- Alıcı kalıcı kabulden sonra
2xxdöndürür. SAP’ye yazma bu yanıttan sonra yapılıyorsa sonraki hataların sorumluluğu kurumun iş kuyruğundadır. - Kalıcı kabul yapılamıyorsa alıcı örneğin
503dönebilir. MevzuatRadar,4xxdahil başarısız HTTP yanıtlarını deneme sınırına kadar yeniden deneyebilir; taslak kendiliğinden503veya yeniden deneme üretmez.
Başlıklar, deneme sınırı ve zaman aşımı için Webhook Akışı ve entegrasyon sözleşmesi esas alınır.