DocuSign API: 데이터를 사용하여 태그를 미리 채우되 사용자가 편집할 수 있도록 하는 방법

DocuSign API 탐색: 사용자 편집을 활성화하면서 필드 미리 채우기

디지털 문서 관리의 끊임없이 진화하는 환경에서 DocuSign과 같은 전자 서명 플랫폼은 기업이 워크플로를 간소화하는 데 필수적인 도구가 되었습니다. DocuSign API는 유연성이 뛰어나 개발자가 서명 경험을 자동화하고 사용자 정의할 수 있습니다. 문서에 미리 채워진 데이터를 통합할 때 일반적인 과제는 필드(또는 DocuSign 용어로 “탭”)가 외부 소스에서 자동으로 채워지지만 필요한 조정을 수용하기 위해 서명자가 편집할 수 있도록 하는 것입니다. 이러한 균형은 효율성을 높이는 동시에 사용자 제어를 손상시키지 않아 금융, 부동산 및 인적 자원과 같은 산업에서 중요한 기능입니다.

비즈니스 관점에서 볼 때 이 기능은 수동 데이터 입력 오류를 줄이고 계약 주기를 가속화하여 업계 보고서에 따르면 처리 시간을 최대 50%까지 단축할 수 있습니다. 그러나 구현하려면 필드가 조기에 잠기지 않도록 API를 신중하게 처리해야 합니다.

DocuSign 또는 Adobe Sign으로 전자 서명 플랫폼을 비교하고 계십니까?

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

👉 무료 평가판 시작

DocuSign API에서 미리 채우기 마스터하기: 기술 가이드

DocuSign eSignature REST API v2.1은 텍스트 상자, 확인란 및 날짜 필드와 같이 문서에 배치된 대화형 요소인 탭을 관리하는 강력한 도구를 제공합니다. 이러한 탭을 미리 채우려면 봉투 생성 중에 API 호출을 통해 데이터를 주입하는 동시에 서명자가 수정할 수 있도록 속성을 설정해야 합니다. 이 방법은 초기 데이터가 CRM 시스템 또는 양식에서 가져오지만 서명자가 세부 정보를 확인하거나 조정해야 하는 시나리오에 특히 적합합니다.

핵심 개념: 탭 및 해당 속성

DocuSign의 탭은 API 페이로드의 signHere 또는 text 객체의 tabs 배열에 정의됩니다. 미리 채우려면 value 속성을 사용하되 편집을 활성화하려면 탭의 documentId 및 pageNumber가 올바르게 정렬되어 있는지 확인하고 읽기 전용 플래그를 피하십시오. 중요한 것은 locked 또는 required 속성을 통해 명시적으로 설정하지 않는 한 탭은 기본적으로 잠기지 않아 자연스러운 편집이 가능하다는 것입니다.

예를 들어 판매 계약에서 구매자의 이름을 데이터베이스에서 미리 채울 수 있지만 연락처 세부 정보가 변경될 경우 수정을 허용할 수 있습니다. 이렇게 하면 사용자를 좌절시키고 문서가 포기되는 경직된 워크플로를 방지할 수 있습니다.

단계별 구현

1. 인증 및 봉투 준비: 먼저 OAuth 2.0을 통해 액세스 토큰을 가져옵니다. /envelopes 엔드포인트를 사용하여 봉투를 만듭니다. 문서를 base64로 인코딩된 파일로 업로드하거나 기존 템플릿을 참조하십시오.

   예제 페이로드 스니펫(JSON):

   {
     "status": "sent",
     "emailSubject": "계약 검토 및 서명",
     "documents": [
       {
         "documentBase64": "<base64-encoded-PDF>",
         "name": "Contract.pdf",
         "fileExtension": "pdf",
         "documentId": "1"
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "tabs": {
             "textTabs": [
               {
                 "tabLabel": "BuyerName",
                 "documentId": "1",
                 "pageNumber": "1",
                 "xPosition": "100",
                 "yPosition": "200",
                 "width": "150",
                 "height": "20",
                 "value": "API에서 미리 채워진 이름",  // 필드를 미리 채웁니다.
                 "locked": "false",  // 편집 가능성을 보장합니다.
                 "required": "false"  // 선택 사항; 필수인 경우 true로 설정합니다.
               }
             ]
           }
         }
       ]
     }
   }
   

   여기서 value 속성은 데이터를 주입하고 locked: false(기본값)는 서명자가 편집할 수 있도록 합니다. 좌표(xPosition, yPosition)는 PDF에서 탭을 정확하게 배치합니다.

2. 템플릿 기반 미리 채우기 처리: 템플릿(/templates/{templateId}/envelopes를 통해)을 사용하는 경우 먼저 GET 요청을 사용하여 /envelopes/{envelopeId}/documents/{documentId}/tabs로 탭을 추출합니다. 그런 다음 tabLabel 또는 위치를 변경하지 않고 value를 추가하도록 응답을 수정합니다. 업데이트된 봉투를 보냅니다. 이 방법은 동적 데이터를 주입하면서 구조를 유지하는 재사용 가능한 양식에 적합합니다.

3. API 호출 실행: 페이로드와 함께 /accounts/{accountId}/envelopes에 POST를 사용합니다. Node.js 또는 Python용 DocuSign SDK와 같은 라이브러리는 이 프로세스를 간소화합니다.

   # Python 예제(docusign-esign 라이브러리 사용)
   from docusign_esign import ApiClient, EnvelopesApi, EnvelopeDefinition
   
   api_client = ApiClient()
   api_client.host = 'https://demo.docusign.net/restapi'  # 라이브의 경우 프로덕션 사용
   envelopes_api = EnvelopesApi(api_client)
   
   envelope_definition = EnvelopeDefinition(
       status='sent',
       email_subject='서명해 주세요',
       documents=[/* 문서 */],
       recipients=/* 위의 탭 포함 */
   )
   
   results = envelopes_api.create_envelope(account_id, envelope_definition)
   

   Webhooks를 통해 완료를 모니터링하여 편집 내용이 감사 로그에 캡처되도록 합니다.

4. 편집 가능성에 대한 모범 사례:

   • 유효성 검사: 보내기 전에 validateTabs 엔드포인트를 사용하여 탭 배치 및 데이터 무결성을 확인합니다.
   • 조건부 논리: 고급 사례의 경우 API를 통해 Business Pro 기능과 통합하여 규칙을 적용합니다(예: 미리 채워진 값이 조건을 충족하는 경우에만 편집 가능한 필드 표시).
   • 오류 처리: 미리 채우기가 실패하면(예: 탭이 일치하지 않음) API는 400 오류를 반환합니다. 디버깅을 위해 기록합니다.
   • 테스트: 항상 DocuSign 개발자 샌드박스를 사용하십시오. 봉투 할당량에 유의하십시오. Starter API 플랜은 월별 약 40개를 허용하며 계층에 따라 연간 $5,760의 프리미엄으로 확장됩니다.

5. 일반적인 함정 및 해결 방법:

   • 과도한 잠금: 탭이 편집할 수 없는 것으로 표시되면 readOnly 또는 사용자 정의 유효성 검사가 적용되지 않았는지 확인합니다. 해결 방법: 탭 속성에서 editable: true를 명시적으로 설정합니다.
   • 데이터 덮어쓰기: 서명자의 변경 사항은 API 값을 원활하게 덮어쓰지만 규정 준수가 필요한 경우 originalValue를 통해 추적합니다.
   • 다중 서명자 시나리오: recipientId별로 탭을 할당합니다. 혼동을 피하기 위해 관련 서명자만 미리 채웁니다.
   • 규정 준수 참고 사항: 미리 채워진 데이터는 ESIGN Act(미국) 또는 eIDAS(EU)와 같은 규정을 준수해야 하며 감사 추적이 편집 내용을 캡처하도록 해야 합니다.

이 프로세스는 기본 통합의 경우 일반적으로 구현하는 데 10-20분이 걸리며 완전한 사용자 정의는 복잡성을 더합니다. 기업은 DocuSign 사례 연구에 따르면 구현 후 서명 속도가 30-40% 향상되었다고 보고합니다.

비즈니스 환경에서의 이점

편집 가능한 탭을 미리 채우면 온보딩, 대출 신청 및 공급업체 계약이 간소화됩니다. 예를 들어 부동산에서 에이전트는 MLS 데이터에서 구매자 정보를 자동으로 채워 현장에서 조정을 허용할 수 있습니다. 또한 Salesforce와 같은 CRM과 잘 통합되어 데이터 사일로를 줄입니다.

DocuSign 및 해당 생태계 개요

DocuSign은 2003년부터 전자 서명 분야의 선두 주자였으며 eSignature, CLM(계약 수명 주기 관리) 및 API 도구를 포함한 포괄적인 제품군을 제공합니다. 해당 API는 원활한 통합을 가능하게 하여 1,000개 이상의 애플리케이션을 지원합니다. 가격은 개인용의 경우 월 $10부터 시작하여 Business Pro의 경우 사용자당 월 $40로 확장되며 API 플랜은 연간 $600부터 시작합니다. 대량 전송 및 인증과 같은 고급 기능은 사용량에 따라 비용이 추가되어 강력한 자동화가 필요한 기업에 적합합니다.

DocuSign의 IAM(ID 및 액세스 관리)은 SSO 및 감사 추적을 통해 보안을 강화하고 CLM은 계약 협상, 추출 및 분석을 자동화하여 대량 계약을 처리하는 법률 팀에 적합합니다.

경쟁 환경: Adobe Sign, eSignGlobal 및 HelloSign

Adobe Sign: 엔터프라이즈용 통합

Adobe Sign은 Adobe Document Cloud의 일부이며 PDF 중심 워크플로에서 탁월하며 Acrobat과 깊이 통합되어 있습니다. DocuSign과 유사한 API를 통해 미리 채우기를 지원하며 필드 태그를 사용하여 편집 가능한 채우기를 지원합니다. 가격은 개인의 경우 사용자당 월 $10부터 시작하여 팀의 경우 사용자당 월 $40까지이며 엔터프라이즈 버전은 사용자 정의 견적입니다. 장점으로는 AI 기반 양식 채우기 및 모바일 서명이 있지만 API 할당량은 대량 사용에 제한이 있을 수 있습니다. ESIGN 및 eIDAS와 같은 글로벌 표준을 준수하며 창의적이고 문서 집약적인 산업에 적합합니다.

eSignGlobal: APAC에 초점을 맞춘 글로벌 플레이어

eSignGlobal은 전 세계 100개 주요 국가에서 규정을 준수하는 다용도 대안으로 자리매김하고 있으며 특히 아시아 태평양(APAC) 지역에서 탁월합니다. APAC의 전자 서명 환경은 파편화되어 있으며 높은 표준과 엄격한 규정을 가지고 있습니다. 이는 이메일 확인 또는 자체 선언에 의존하는 프레임워크 기반 ESIGN(미국) 또는 eIDAS(EU) 모델과 다릅니다. APAC은 정부 대 기업(G2B) 디지털 ID와의 심층적인 하드웨어/API 통합이 필요한 “생태계 통합” 접근 방식을 요구하여 기술 장벽을 서구 표준보다 훨씬 높입니다.

eSignGlobal은 홍콩 iAM Smart 및 싱가포르 Singpass와 같은 시스템에 대한 기본 지원을 통해 이 문제를 해결하여 원활하고 규정을 준수하는 워크플로를 보장합니다. DocuSign 및 Adobe Sign과 경쟁하기 위해 유럽과 아메리카로 적극적으로 확장하고 있으며 경쟁력 있는 가격을 제공합니다. Essential 플랜은 월 $16.6로 최대 100개의 문서를 보낼 수 있고 무제한 사용자 시트를 허용하며 액세스 코드를 통해 유효성을 검사합니다. 이는 시트당 요금을 부과하지 않고 높은 가치의 규정 준수를 제공합니다. 이 모델은 금융 및 인적 자원과 같은 규제 산업의 확장된 팀에 매력적입니다.

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

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

👉 무료 평가판 시작

HelloSign(현재 Dropbox Sign): SMB를 위한 단순성

2019년에 Dropbox에서 인수한 HelloSign은 사용자 친화적인 서명에 중점을 두고 템플릿을 통해 API 미리 채우기 편집 가능한 필드를 지원합니다. 빠른 설정과 Google Workspace와의 통합으로 찬사를 받고 있습니다. 가격은 무료 버전(월 3개 문서)부터 시작하여 Essentials 월 $15, Premium 월 사용자당 $25까지입니다. ESIGN/UETA를 준수하지만 고급 IAM과 같은 일부 엔터프라이즈급 기능이 부족하여 중소기업에 적합하지만 글로벌 규정 준수 요구 사항에는 충분히 강력하지 않습니다.

전자 서명 플랫폼의 나란히 비교

이 표는 절충점을 강조합니다. DocuSign은 성숙도에서 앞서고 있으며 대안은 비용 또는 지역 적합성과 같은 틈새 이점을 제공합니다.

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

전자 서명 플랫폼을 선택하는 것은 규모, 지역 및 통합 요구 사항에 따라 다릅니다. DocuSign은 포괄적인 API 기반 워크플로를 위한 안정적인 선택입니다. 특히 APAC의 복잡한 규제 환경에서 지역 규정 준수를 강조하는 대안의 경우 eSignGlobal은 균형 잡히고 비용 효율적인 옵션을 제공합니다. 효율성과 준수를 최적화하기 위해 비즈니스 우선 순위에 따라 평가하십시오.