DocuSign API: 미리 채워진 탭이 있는 템플릿에서 봉투 보내기

DocuSign API를 사용하여 문서 워크플로우 간소화하기

빠르게 변화하는 디지털 비즈니스 운영 세계에서 DocuSign과 같은 전자 서명 플랫폼은 계약 관리를 자동화하고 서류 작업을 줄이는 데 필수적인 도구가 되었습니다. DocuSign API는 특히 템플릿을 활용하여 봉투(서명 준비가 완료된 문서 패키지에 대한 DocuSign의 용어)를 미리 채워진 탭과 함께 보내는 복잡한 워크플로우를 처리하는 강력한 기능으로 두각을 나타냅니다. 이 기능은 시간을 절약할 뿐만 아니라 영업팀이나 법률 부서와 같은 대량 환경에서 오류를 최소화합니다. 비즈니스 관점에서 이러한 API를 통합하면 문서 처리 시간을 최대 80%까지 단축할 수 있다는 연구 결과에서 알 수 있듯이 효율성이 크게 향상될 수 있습니다.

DocuSign 또는 Adobe Sign과 전자 서명 플랫폼을 비교하시겠습니까?

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

👉 무료 평가판 시작

DocuSign API 마스터하기: 템플릿에서 봉투 보내기

DocuSign eSignature API는 기업이 서명 기능을 애플리케이션에 직접 내장할 수 있도록 하는 강력한 개발자 도구입니다. 핵심적으로 "봉투"는 서명, 승인 또는 기타 작업을 위해 라우팅할 수 있는 하나 이상의 문서를 담는 컨테이너입니다. DocuSign의 템플릿은 문서 레이아웃, 필드(탭이라고 함) 및 워크플로우를 미리 정의하여 온보딩 또는 송장 승인과 같은 반복 작업에 적합합니다.

미리 채워진 탭은 봉투를 보내기 전에 텍스트 상자, 날짜 또는 확인란과 같은 이러한 필드를 데이터로 채우는 것을 의미합니다. 이는 수신자 정보를 알고 있는 경우 특히 유용하며 보다 원활한 서명 경험을 보장합니다. 기업의 경우 이 기능은 Salesforce와 같은 CRM 시스템 또는 ERP 도구와 원활하게 통합되어 자동 데이터 추출을 가능하게 합니다.

API를 통해 이를 구현하기 위해 개발자는 일반적으로 RESTful 엔드포인트를 사용하며 인증은 OAuth 2.0 또는 JWT 권한 부여를 통해 처리됩니다. DocuSign의 개발자 샌드박스는 무료 테스트 환경을 제공하며 이는 생산 비용을 발생시키지 않고 통합을 반복하는 기업에 매우 중요합니다.

API 통합을 위한 전제 조건

코드를 자세히 살펴보기 전에 다음 사항을 확인하십시오.

• DocuSign 개발자 계정(무료 등록).
• 인증에 사용되는 통합 키(앱 ID) 및 API 토큰.
• API가 이 형식을 사용하여 통신하므로 JSON 페이로드에 대한 친숙함.
• HTTP 요청을 간소화하는 선호하는 언어의 DocuSign SDK(예: Java, .NET, Python).

기업은 API 가격 책정 계층도 고려해야 합니다. Starter 플랜은 연간 600달러로 소규모 통합에 적합한 월 최대 40개의 봉투를 지원하는 반면 Advanced 플랜은 연간 5,760달러로 대량 전송 및 웹후크를 잠금 해제하여 대규모 작업에 적합합니다.

미리 채워진 탭으로 봉투를 보내는 단계별 가이드

1단계: 템플릿 만들기 또는 검색하기

먼저 DocuSign 웹 애플리케이션에서 템플릿을 업로드하거나 API를 통해 업로드합니다. 템플릿에는 문서와 그 위에 배치된 탭이 포함됩니다. 탭은 다음과 같이 분류됩니다.

• 텍스트 탭: 이름, 주소 등에 사용됩니다.
• 날짜 탭: 현재 날짜 또는 사용자 지정 값을 자동으로 채웁니다.
• 확인란 탭: 계약에 사용됩니다.
• 이니셜/서명 탭: 서명자 작업에 사용됩니다.

Templates API를 사용하여 기존 템플릿을 나열합니다.

GET /restapi/v2.1/accounts/{accountId}/templates

그러면 템플릿의 JSON 배열이 반환됩니다. 후속 단계에서 사용할 templateId를 기록해 둡니다.

2단계: 봉투 정의 준비하기

템플릿을 참조하는 봉투 객체를 구성합니다. 페이로드에 수신자 데이터와 탭 값을 포함하여 탭을 미리 채웁니다.

다음은 봉투를 만드는 예제 JSON입니다(Node.js 및 DocuSign SDK를 사용하여 설명).

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'Please sign this document';
envelopeDefinition.status = 'sent'; // Options: 'created', 'sent', 'delivered'

// Reference the template
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // Matches template role
envelopeDefinition.templateReferences = [template];

// Define recipient and pre-fill tabs
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // For embedded signing if needed

// Pre-fill tabs (tabs from template)
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // Matches tab in template
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`Envelope ID: ${results.envelopeId}`);

이 코드는 템플릿에서 봉투를 만들고 “FullName” 텍스트 탭을 "John Doe"로 미리 채우고 날짜 탭을 오늘의 날짜로 채웁니다. tabLabel은 템플릿에서 탭에 할당된 레이블과 정확히 일치해야 합니다.

3단계: 인증 처리 및 보내기

JWT 또는 액세스 토큰을 사용하여 인증합니다. 프로덕션 환경에서는 계정 지역에 따라 NA1(미국) 또는 EU1(유럽) 기본 경로를 사용합니다. 다음을 사용하여 봉투를 보냅니다.

const accessToken = await getJwtToken(); // Your auth function
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

대량 시나리오의 경우 Advanced API 플랜은 월 최대 100개의 봉투를 지원하고 데이터베이스와 같은 외부 소스에서 데이터를 미리 채웁니다.

4단계: 상태 모니터링 및 검색하기

보낸 후에는 웹후크(Advanced 플랜의 Connect 기능) 또는 /envelopes/{envelopeId} 엔드포인트를 폴링하여 상태를 추적합니다. 이는 감사 추적 요구 사항을 준수하는 비즈니스 워크플로우에 매우 중요합니다.

일반적인 문제 및 해결 방법

• 탭 일치 오류: 탭이 고유하고 올바르게 참조되었는지 확인합니다. 먼저 Template API를 사용하여 탭 세부 정보를 가져옵니다.
• 수신자 라우팅: 다중 서명자 봉투의 경우 템플릿에서 역할을 할당하고 API 호출에서 해당 역할을 매핑합니다.
• 제한: 표준 플랜은 자동화된 전송을 연간 약 100개/사용자로 제한합니다. API 플랜에는 봉투 할당량이 있습니다.
• 오류 처리: API 응답에는 오류 코드(예: 400은 잘못된 탭을 나타냄)가 포함됩니다. 일시적인 문제에 대한 재시도를 구현합니다.

비즈니스 관점에서 이 API 통합은 수동 데이터 입력을 70% 줄일 수 있지만 기업은 비용(인증과 같은 API 추가 기능은 사용량에 따라 요금이 부과됨)을 고려해야 합니다.

DocuSign의 더 넓은 생태계 탐색하기

DocuSign은 기본 전자 서명을 넘어 Intelligent Agreement Management (IAM) CLM과 같은 제품을 제공하며 이는 계약 수명 주기 관리 솔루션입니다. IAM CLM은 초안 작성에서 협상 및 갱신에 이르기까지 전체 계약 프로세스를 자동화하고 조항 분석에 AI를 통합합니다. SSO 및 고급 분석 기능을 포함하는 Enhanced 플랜부터 시작하여 기업에 대한 사용자 지정 가격 책정입니다. 따라서 엔드 투 엔드 규정 준수가 필요한 중대형 기업에 적합합니다.

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

전자 서명 시장은 경쟁이 치열하며 DocuSign은 전 세계 채택 측면에서 선두를 달리고 있지만 전문적인 이점을 제공하는 경쟁업체에 직면해 있습니다. Adobe Sign은 Adobe Creative Suite와의 원활한 통합을 강조하며 문서 집약적인 워크플로우에 적합합니다. API를 통해 미리 채워진 양식을 지원하고 미국 ESIGN/UETA 및 유럽 eIDAS를 준수합니다. 가격은 개인의 경우 월 10달러부터 시작하여 모바일 서명 및 결제 수집과 같은 기능을 포함하는 기업 사용자 지정 플랜으로 확장됩니다.

eSignGlobal은 특히 전자 서명 규정이 파편화되고 높은 기준과 엄격한 규제를 받는 아시아 태평양 지역(APAC)에서 지역 강자로 자리매김하고 있습니다. 이메일 확인 또는 자체 신고에 의존하는 미국(ESIGN 법) 또는 유럽(eIDAS)의 프레임워크 표준과 달리 APAC는 “생태계 통합” 규정 준수를 요구합니다. 여기에는 정부 대 기업(G2B) 디지털 ID와의 심층적인 하드웨어/API 수준 통합이 포함되어 기술 장벽을 서구 모델보다 훨씬 높게 만듭니다. eSignGlobal은 100개의 주요 글로벌 국가 및 지역의 규정 준수를 지원하며 홍콩 및 싱가포르의 로컬 데이터 센터를 통해 APAC에서 이점을 제공합니다. 홍콩의 iAM Smart 및 싱가포르의 Singpass와 기본적으로 통합되어 강력한 인증을 가능하게 합니다. 가격은 더욱 쉽게 접근할 수 있습니다. Essential 플랜은 월 16.6달러로 최대 100개의 문서를 전자 서명할 수 있고 무제한 사용자 시트와 액세스 코드를 통한 문서/서명 확인을 제공하여 규정 준수 기반에서 강력한 가치를 제공합니다. eSignGlobal은 DocuSign 및 Adobe Sign의 경쟁 대안으로 약간 낮은 비용과 더 빠른 지역 성능으로 미주 및 유럽을 포함하여 전 세계적으로 확장되고 있습니다.

HelloSign(현재 Dropbox의 일부)은 SMB의 단순성에 중점을 두고 DocuSign과 유사한 템플릿 및 미리 채우기 API 지원을 제공하지만 시작 비용이 저렴합니다(월 15달러/사용자). Google Workspace와의 통합에 탁월하지만 기본 플랜에는 대량 전송과 같은 고급 기업 기능이 부족합니다.

이 표는 중립적인 절충안을 강조합니다. DocuSign은 규모에, Adobe는 디자인 워크플로우에, eSignGlobal은 APAC 효율성에, HelloSign은 사용 편의성에 적합합니다.

글로벌 전자 서명의 규제 미묘한 차이

제목은 API 메커니즘에 중점을 두지만 규정을 이해하면 구현을 향상시킬 수 있습니다. 미국에서 ESIGN 법과 UETA는 대부분의 상업 거래에 대해 습식 서명과 동등한 법적 효력을 제공합니다. 유럽의 eIDAS 프레임워크는 높은 보증 요구 사항에 대해 적격 전자 서명을 요구합니다. APAC는 다릅니다. 싱가포르의 전자 거래법은 eIDAS와 일치하지만 정부 업무에는 Singpass가 필요하고 홍콩의 조례는 iAM Smart를 통한 보안 인증을 강조합니다. DocuSign API를 사용하는 기업은 이러한 표준을 충족하기 위해 감사 로그와 같은 규정 준수 필드에 맞게 탭을 구성해야 합니다.

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

API 기반 자동화를 우선시하는 기업의 경우 DocuSign은 성숙한 생태계로 인해 여전히 견고한 선택입니다. 그러나 특히 APAC와 같은 지역 규정 준수 요구 사항의 경우 eSignGlobal과 같은 대안은 글로벌 범위를 희생하지 않고 맞춤형의 비용 효율적인 옵션을 제공합니다. 최적의 일치를 위해 규모, 통합 및 지리적 위치를 기준으로 평가하십시오.