Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

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.

DurumTaslaktaki sonuç
Anahtar veya imza boşrv_status_code = 400
Anahtar ve imza dolurv_status_code = 202
HMAC doğrulamasıUygulanmamış; yorum olarak bırakılmış
Kalıcı tekilleştirmeUygulanmamış; yorum olarak bırakılmış
MevzuatRadar API çağrısıUygulanmamış; yorum olarak bırakılmış
SAP’ye kayıt yazmaUygulanmamış; 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:

  1. Kurumun HTTPS alıcısı gelen ham gövdenin özgün baytlarını saklar. X-Webhook-Signature-V2 imzasını ve 300 saniyelik zaman toleransını alıcı sözleşmesine göre doğrular.
  2. Olay türü, sürümü ve gövdesi denetlenir. X-Webhook-Idempotency-Key ile iş kaydı kalıcı depoda atomik tutulur. Yalnız anahtarın yazılması, işin kabul edildiği anlamına gelmez.
  3. İşleyici gerekli veriyi https://api.mevzuatradar.com üzerinden API anahtarıyla okur. Node.js SDK’da listChanges, listDeadlines ve getEvidencePack metotları bulunur; ABAP taslağı bu metotları çağırmaz.
  4. 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.
  5. 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 2xx dö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 503 dönebilir. MevzuatRadar, 4xx dahil başarısız HTTP yanıtlarını deneme sınırına kadar yeniden deneyebilir; taslak kendiliğinden 503 veya 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.