​

Business Associate Agreement (BAA)

Bu, kiracıya ait bir HIPAA kontrolüdür (tenant-owned): PHI’nin kapsamda olup olmadığına siz karar verirsiniz, sözleşmeyi bilinçli olarak yürütürsünüz ve yıllık süresi dolmadan yeniden yürütürsünüz. Devotel e-imza hattını sağlar — şablon oluşturma, yazılan imza yakalama, değişmez denetim sabitleme ve saklanan yürütülmüş PDF — ancak PHI’nin kapsamda olduğuna dair yasal belirleme size aittir.

​

baa_status durumları

{
  "baa_status": "executed",
  "baa_executed_at": "2026-08-10T14:22:31.410Z",
  "baa_template_version": "v1",
  "baa_signer_name": "Jane Roe",
  "baa_signer_email": "jane@example.com",
  "baa_pdf_gcs_url": "gs://…/baa/org_…/baa_….pdf",
  "hipaa_required": true,
  "expires_at": "2027-08-10T14:22:31.410Z",
  "days_until_expiry": 342
}

​

Akış neden bir beyanla başlar

​

Uç nokta akışı

​

1. Geçerli durumu oku

curl "https://api.orbit.devotel.io/api/v1/compliance/baa" \
  -H "Authorization: Bearer sk_live_..."

​

2. Şablonu önizle

curl "https://api.orbit.devotel.io/api/v1/compliance/baa/template?version=v1" \
  -H "Authorization: Bearer sk_live_..."

{
  "version": "v1",
  "covered_entity_name": "Acme Health Ltd",
  "format": "markdown",
  "body": "# Business Associate Agreement\n\nThis Business Associate Agreement..."
}

​

3. PHI’nin kapsamda olduğunu beyan et

curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/baa/require" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "We began sending patient appointment reminders that contain PHI." }'

​

4. İsmi yazarak e-imza ile yürüt

curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/baa/execute" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "signer_name": "Jane Roe",
    "signer_email": "jane@example.com",
    "typed_attestation": "Jane Roe"
  }'

1. Şablonu imzalayıcı ayrıntıları, yürütme zaman damgaları ve oluşturulmuş bir belge referansı ile oluşturur
2. Oluşturulmuş belgeyi kanonik yürütülmüş PDF olarak saklar
3. Kuruluşu imzalayıcı, şablon sürümü ve yürütme zaman damgası ile executed olarak damgalar ve süre dolma tarihini kaydeder (yürütme artı standart bir yıllık süre)
4. İmza yöntemi (type_the_name) ile birlikte denetim günlüğüne bir compliance.baa.executed girişi yazar — denetim girişi beyanın yasal kanıtıdır ve saklanan PDF kanonik belgedir

{
  "baa_status": "executed",
  "baa_executed_at": "2026-08-24T09:41:12.008Z",
  "baa_template_version": "v1",
  "baa_signer_name": "Jane Roe",
  "baa_signer_email": "jane@example.com",
  "baa_id": "baa_9f2k…",
  "expires_at": "2027-08-24T09:41:12.008Z",
  "days_until_expiry": 365,
  "hipaa_required": true
}

​

5. Yürütülmüş kopyayı indir

curl "https://api.orbit.devotel.io/api/v1/compliance/baa/download" \
  -H "Authorization: Bearer sk_live_..."

{
  "url": "https://storage.googleapis.com/…/baa/org_…/baa_….pdf?X-Goog-Signature=…",
  "expires_in_seconds": 86400
}

​

6. Platform varsayılanına geri dön

curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/baa/revert" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Organization no longer processes PHI; returning to default posture." }'

​

Decline: PHI’nin kapsamda olmadığını beyan etme

​

Roller ve denetim zinciri

​

Bir BAA yürütüldüğünde ne değişir

1. PHI gönderim kapısını kaldırır. hipaa_required doğru iken ve süresi içinde bir BAA kayıtlı olmadığında, PHI’ye dokunan giden gönderimler 422 HIPAA_BAA_REQUIRED ile reddedilir. Yürütülmüş bir BAA bu reddi kaldırır. (Kapının kararı ve fail-closed davranışı Gönderim kapıları altında belgelenmiştir.)
2. HIPAA modunun engelini kaldırır. HIPAA modunun etkinleştirilmesi baa_status = "executed" gerektirir; yürütmeden önce denemek 403 döndürür. HIPAA modu açıldığında, HIPAA uyumluluk kontrolleri — PHI erişim günlüğü, veri saklama ve geri kalanlar — çalışma alanına uygulanır.

​

Pano akışı

1. Durum kartı — geçerli baa_status, yürütme tarihi, imzalayıcı ve süre dolmaya 60 gün kaldığında bir yeniden yürütme bandı gösterir
2. Şablon önizlemesi — kuruluşunuzun adı doldurulmuş olarak oluşturulmuş sözleşme
3. Beyan formu — imzalayıcının adı ve e-postası ile isim yazma imza alanı; durum pending olduğunda owner’lara gösterilir
4. İndirme — yürütüldükten sonra yürütülmüş kopyaya bir bağlantı; her istekte yeni bir 24 saatlik URL ile

​

SSS