DocuSign API: JSON으로 '알림' 및 '만료'를 설정하는 방법?

DocuSign API를 사용한 봉투 관리 이해

전자 서명 솔루션의 경쟁 환경에서 DocuSign의 API는 개발자가 자동화된 워크플로를 비즈니스 프로세스에 통합하는 데 여전히 핵심적인 역할을 합니다. 회사가 디지털 운영을 확장함에 따라 알림 및 만료 기능은 수동 감독 없이 문서가 제때 완료되도록 하는 데 중요한 역할을 합니다. 이 기사에서는 공식 문서 및 실제 구현 통찰력을 참조하여 JSON을 통해 DocuSign API에서 이러한 설정을 구성하는 방법을 살펴봅니다. 비즈니스 관점에서 이러한 API 요소를 마스터하면 계약 주기를 최적화하고, 관리 부담을 줄이며, 대용량 환경에서 규정 준수를 향상시킬 수 있습니다.

DocuSign 또는 Adobe Sign과 유사한 전자 서명 플랫폼을 비교하고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩 프로세스를 통해 보다 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

DocuSign API에서 알림 및 만료 설정: 단계별 가이드

DocuSign의 eSignature API를 사용하면 개발자가 봉투 생성 요청에 알림 및 만료 규칙을 직접 포함할 수 있습니다. 이러한 기능은 비즈니스 자동화에 필수적입니다. 알림은 서명되지 않은 문서에 대해 설정된 간격으로 서명자에게 알리고, 만료는 지정된 기간 후에 봉투를 무효화하여 워크플로 효율성을 보장하므로 후속 조치를 자동화하고 문서가 무기한 보류되는 것을 방지하기 때문입니다.

API 통합을 위한 전제 조건

JSON 페이로드를 자세히 살펴보기 전에 다음 사항이 있는지 확인하십시오.

• API 액세스 권한이 있는 DocuSign 개발자 계정(개발자 센터를 통해 얻을 수 있음).
• 안전한 API 호출을 위해 OAuth 2.0 또는 JWT를 사용하여 설정된 인증.
• Envelopes: create 엔드포인트(POST /accounts/{accountId}/envelopes)에 대한 숙지.

API는 RESTful 엔드포인트를 사용하며 모든 구성은 요청의 JSON 본문을 통해 전달됩니다. API 사용 가격은 DocuSign의 개발자 프로그램에 속하며 초기 테스트에 적합한 기본 봉투 할당량을 포함하여 입문 레벨에서 연간 $600부터 시작합니다.

JSON을 통해 알림 구성

알림은 봉투 정의의 reminders 객체에 정의됩니다. 이 객체는 빈도, 첫 번째 알림 전의 지연 및 시도 횟수를 지정합니다. 기업은 고객 계약 또는 직원 온보딩과 같은 시나리오에서 서명자를 독촉하여 포기율을 낮추기 위해 이 기능을 자주 사용합니다.

다음은 봉투 생성 요청의 예제 JSON 스니펫입니다.

{
  "status": "sent",
  "emailSubject": "이 문서를 서명하십시오",
  "documents": [
    {
      "documentBase64": "BASE64_ENCODED_DOCUMENT_CONTENT",
      "name": "샘플 계약",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "reminders": {
    "reminderDelay": 2,  // 첫 번째 알림 전의 일수(예: 발송 후 2일)
    "reminderFrequency": "daily",  // 옵션: daily, weekly, monthly
    "reminderOffset": 1,  // 알림 간의 일수
    "reminderMaxAttempts": 5  // 총 발송된 알림(예: 5회 시도)
  }
}

• reminderDelay: 초기 대기 기간(일 단위)을 설정합니다. 시간에 민감한 거래의 경우 1-3일 값이 일반적입니다.
• reminderFrequency: 간격을 규정합니다. 긴급한 문제에는 daily를 사용하고 표준 계약에는 weekly를 사용합니다.
• reminderOffset: 비즈니스 리듬과 일치하는 알림 간의 간격입니다.
• reminderMaxAttempts: 스팸을 방지하기 위해 총 횟수를 제한합니다. DocuSign은 봉투 양에 따라 3-7회를 권장합니다.

구현하려면 POST 요청을 통해 이 JSON을 Envelopes API로 보냅니다. 예를 들어 cURL을 사용합니다.

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '@envelope.json'

실제로 고급 API 계획($5760/년)을 사용하는 기업은 더 높은 할당량의 이점을 누려 대량 발송에서 강력한 알림 논리를 구현할 수 있습니다. 샌드박스 환경에서 테스트하면 구성이 규정 준수 요구 사항(예: 규제 산업의 감사 추적)을 충족하는지 확인합니다.

JSON을 통해 만료 구현

만료는 마감일 이후에 서명되지 않은 봉투를 자동으로 거부하여 API 할당량을 확보하고 리소스 낭비를 방지합니다. 이는 문서가 정체될 수 있는 고속 판매 파이프라인에서 특히 유용합니다.

expireAfter 및 expireNotify 설정은 봉투의 최상위 속성 아래에 중첩되거나 세분화된 제어를 위해 특정 수신자의 구성에 있습니다.

만료 예제 JSON:

{
  "status": "sent",
  "emailSubject": "조치 필요: 검토 및 서명",
  "documents": [
    // ... (위와 동일)
  ],
  "recipients": {
    "signers": [
      // ... (위와 동일)
    ]
  },
  "expireAfter": "30",  // 만료까지의 일수(예: 발송일로부터 30일)
  "expireNotify": true  // 만료 시 발신자에게 이메일을 보낼지 여부(true/false)
}

• expireAfter: 일 단위로 지정합니다(1-9999). 기업은 모멘텀을 유지하기 위해 긴급 계약에 대해 더 짧은 기간(7-14일)을 설정합니다.
• expireNotify: 기본값은 false입니다. 활성화하면 후속 조치를 위해 발신자에게 경고하고 CRM 시스템과 원활하게 통합됩니다.

수신자 수준 만료(다중 서명자 워크플로에 유용)의 경우 서명자 객체에 포함합니다.

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "expireAfter": "15",  // 서명자별 만료
    "expireNotify": "1"  // 발신자에게 알림(1 = 예, 0 = 아니오)
  }
]

알림과 만료를 결합하면 포괄적인 수명 주기 관리 전략을 만들 수 있습니다. 예를 들어 30일 만료에 5일 후의 매일 알림을 추가하면 업계 벤치마크에 따라 완료율이 20-30% 향상될 수 있습니다. 이러한 설정은 봉투 할당량을 소비합니다. 표준 계획은 ~100개의 봉투/사용자/년으로 제한되므로 중간 레벨 API 사용자($3600/년)는 자동화된 워크플로에 대한 유연성을 얻습니다.

모범 사례 및 일반적인 함정

비즈니스 관점에서 과도한 알림 구성은 SMS/추가 요금(메시지당 요금)을 늘릴 수 있고, 느슨한 만료는 좌석 기반 가격 책정 모델에서 좌석을 차지할 수 있습니다. 항상 DocuSign의 Swagger 문서를 사용하여 JSON이 API 스키마를 준수하는지 확인하십시오. 함정에는 시간대 불일치(글로벌 팀은 UTC를 사용)와 더 나은 분석을 위해 사용자 정의할 수 있는 거부 이유 무시가 포함됩니다.

아시아 태평양 지역에서는 대기 시간과 규정 준수가 복잡성을 더하고 API 통합은 SMS 전송과 같은 지역 추가 기능을 고려해야 하며, 이는 비용을 증가시킬 수 있습니다. 프로덕션 배포 전에 DocuSign 샌드박스에서 샘플 페이로드를 사용하여 테스트하는 것이 좋습니다.

이 API 기능은 개발자 친화적인 도구에 대한 DocuSign의 강점을 강조하지만 기업은 자동화 상한선(~10개/사용자/월)을 포함한 총 비용을 평가해야 합니다.

경쟁 환경: 전자 서명 플랫폼 비교

전자 서명이 디지털 전환의 핵심이 됨에 따라 DocuSign과 Adobe Sign, eSignGlobal 및 HelloSign(현재 Dropbox Sign)과 같은 대체 제품을 비교하면 다양한 강점이 드러납니다. DocuSign은 글로벌 API 견고성 측면에서 뛰어나지만 특히 API 집약적 사용자의 경우 가격 책정 확장성에 대한 조사를 받습니다. Adobe Sign은 Adobe 에코시스템과 깊이 통합되어 창의적인 워크플로에 적합합니다. eSignGlobal은 아시아 태평양 지역에 대한 현지화된 규정 준수를 제공하고 HelloSign은 SMB에 단순성을 제공합니다.

주요 플레이어 개요

DocuSign: 위에서 언급한 알림 및 만료를 포함한 포괄적인 API 기능을 갖춘 시장 리더입니다. 기업 수준의 보안 및 통합에 강점이 있지만 좌석 기반 가격 책정은 팀 업그레이드에 문제가 될 수 있습니다. 플랫폼은 더 높은 수준에서 무제한 봉투를 지원하지만 자동화된 발송은 제한됩니다.

Adobe Sign: Adobe의 솔루션은 PDF 도구 및 Acrobat과의 원활한 통합을 강조하며 문서 집약적인 산업에 적합합니다. 알림( “notification” 설정을 통해) 및 만료(최대 999일)에 대한 유사한 API 제어를 제공하며 JSON 페이로드는 DocuSign의 구조를 미러링합니다. 가격은 개인의 경우 사용자당 월 $10부터 시작하여 기업의 경우 사용자 정의 견적으로 확장됩니다. 미국 규정 준수 측면에서 특히 강력하지만 고급 API 사용에는 추가 요금이 발생할 수 있습니다.

eSignGlobal: 이 아시아 태평양 중심 제공업체는 100개의 주요 글로벌 국가 및 지역의 규정 준수를 지원하며 아시아 태평양 지역에서 상당한 이점을 제공합니다. 이 지역의 전자 서명 환경은 파편화되어 있으며 높은 표준과 엄격한 규정을 가지고 있습니다. 이는 미국/EU의 프레임워크 스타일 ESIGN/eIDAS와 대조됩니다. 아시아 태평양 지역에서는 정부 디지털 ID(G2B)와의 하드웨어/API 수준의 심층적인 도킹이 필요한 “에코시스템 통합” 접근 방식이 필요하며, 이는 서양에서 흔히 볼 수 있는 이메일 확인 또는 자기 선언 모델을 훨씬 능가합니다. eSignGlobal은 비용 효율적인 계획을 통해 미주 및 유럽을 포함하여 전 세계적으로 DocuSign 및 Adobe Sign과 직접 경쟁합니다. Essential 버전은 월 $16.6에 불과하며 최대 100개의 문서 서명, 무제한 사용자 좌석 및 액세스 코드 확인을 허용합니다. 이 모든 것이 규정 준수, 고가치 기반을 기반으로 합니다. 홍콩의 iAM Smart 및 싱가포르의 Singpass와 원활하게 통합되어 데이터 상주 및 대기 시간과 같은 지역적 문제점을 해결합니다.

HelloSign (Dropbox Sign): Dropbox에 인수된 이 회사는 사용자 친화적인 인터페이스와 파일 저장 협업을 우선시합니다. API는 JSON을 통해 알림 및 만료를 지원하며 더 간단한 할당량(예: 무료 레벨에서 월 20개의 봉투)을 제공합니다. 가격은 Essentials의 경우 월 $15부터 시작하여 소규모 팀에 매력적이지만 DocuSign에 비해 기업 API 요구 사항에 대한 확장성이 떨어집니다.

DocuSign의 더 스마트한 대안을 찾고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩 프로세스를 통해 보다 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

Markdown 비교 표

이 표는 중립적인 절충안을 강조합니다. DocuSign은 심층성, Adobe는 통합, eSignGlobal은 지역적 가치, HelloSign은 접근성을 제공합니다.

전자 서명 선택에 대한 최종 생각

결론적으로 JSON을 통해 DocuSign의 API에서 알림 및 만료를 구성하면 비즈니스 운영을 간소화할 수 있지만 올바른 플랫폼을 선택하는 것은 규모, 지역 및 예산에 따라 다릅니다. DocuSign의 대안을 찾는 사용자의 경우 eSignGlobal은 지역 규정 준수 및 강력한 글로벌 영향력으로 두각을 나타냅니다.