DocuSign API: '복합 템플릿'을 사용하여 여러 PDF를 병합하는 방법

슌팡

2026-02-13

3분

효율적인 문서 워크플로우를 위한 DocuSign API 탐색

빠르게 변화하는 디지털 비즈니스 운영 환경에서 DocuSign과 같은 전자 서명 플랫폼은 계약 관리를 간소화하고 서류 작업을 줄이는 데 필수적인 도구가 되었습니다. 소규모 팀부터 대기업에 이르기까지 이러한 도구는 안전하고 규정을 준수하는 서명 프로세스를 가능하게 합니다. DocuSign API 생태계의 핵심 기능 중 하나는 개발자가 여러 PDF를 서명을 위한 단일 봉투로 병합할 수 있는 복합 템플릿입니다. 이 기능은 다자간 계약 또는 자동화된 문서 조립과 같은 복잡한 워크플로우를 처리하는 기업에 특히 유용합니다. 이 기사에서는 공식 문서 및 실제 비즈니스 애플리케이션을 참조하여 DocuSign API에서 복합 템플릿을 구현하는 방법을 살펴보고 비즈니스 환경에서의 유용성에 대한 중립적인 관점을 유지합니다.

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

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

👉 무료 평가판 시작

PDF 병합을 위한 DocuSign API의 복합 템플릿 활용

복합 템플릿이란 무엇입니까?

DocuSign eSignature API의 복합 템플릿은 단일 봉투에서 여러 문서와 서명 구성을 결합하는 강력한 방법입니다. DocuSign 용어로 "봉투"는 서명이 필요한 하나 이상의 문서의 컨테이너입니다. 기존 봉투는 문서를 순차적으로 처리하지만 복합 템플릿은 병렬 조립을 지원하므로 특정 수신자에게 다른 PDF를 첨부하는 동시에 문서 전체에서 탭(서명 필드)을 정의할 수 있습니다. 이는 표지, 약관 PDF 및 공개 양식을 수동으로 병합하지 않고도 동일한 당사자가 서명해야 하는 대출 신청과 같은 시나리오에 적합합니다.

비즈니스 관점에서 볼 때 이 기능은 API 호출을 줄이고 문서 라우팅 오류를 최소화하며 처리 시간을 단축합니다. 이는 영업팀이 거래를 성사시키거나 인사팀이 온보딩 패키지를 처리하는 데 매우 중요합니다. DocuSign의 개발자 리소스에 따르면 복합 템플릿은 중간 및 고급 API 계층에서 사용할 수 있으며, 이러한 계획의 연간 요금은 중간 사용량의 경우 약 3,600달러부터 시작합니다.

복합 템플릿 사용에 대한 단계별 가이드

복합 템플릿을 사용하여 여러 PDF를 병합하려면 DocuSign REST API(버전 2.1 이상)와 상호 작용합니다. 전제 조건에는 DocuSign 개발자 계정(무료 샌드박스 제공)과 OAuth를 통해 획득한 API 자격 증명이 포함됩니다. 다음은 실제 작업 가이드입니다.

문서 및 템플릿 준비:
- PDF를 DocuSign의 임시 저장소에 업로드하거나 base64 인코딩을 통해 참조합니다. 예를 들어 pdf1.pdf(계약) 및 pdf2.pdf(부록)을 준비합니다.
- 재사용 가능한 경우 DocuSign 웹 애플리케이션에서 템플릿을 만듭니다. 각 템플릿에는 서명, 날짜 또는 텍스트 필드와 같은 미리 정의된 탭이 포함될 수 있습니다. DocuSign 대시보드에서 템플릿 ID를 기록합니다.

봉투 정의 설정:

/envelopes 엔드포인트를 사용하여 새 봉투를 만듭니다. JSON 요청 본문에서 compositeTemplates 배열을 구조화합니다.
주요 요소:
- document: 인라인 또는 원격 PDF.
- serverTemplates 또는 inlineTemplates: 기존 템플릿에 연결합니다.
- recipients: 서명자(예: 서명자 역할)를 정의하고 복합 템플릿에 첨부합니다.

예제 JSON 스니펫(Node.js 또는 유사한 도구를 사용하여 API 호출):

{
  "status": "sent",
  "emailSubject": "병합된 계약서에 서명해 주십시오.",
  "compositeTemplates": [
    {
      "compositeTemplateId": "template1",
      "document": {
        "documentBase64": "base64_of_pdf1",
        "name": "주 계약",
        "fileExtension": "pdf",
        "documentId": "1"
      },
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "your-template-id-1"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "1",
          "recipients": {
            "signers": [
              {
                "email": "signer@example.com",
                "name": "John Doe",
                "recipientId": "1",
                "tabs": {
                  "signHereTabs": [
                    {
                      "documentId": "1",
                      "pageNumber": "1",
                      "xPosition": "100",
                      "yPosition": "200"
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    },
    {
      "compositeTemplateId": "template2",
      "document": {
        "documentBase64": "base64_of_pdf2",
        "name": "부록",
        "fileExtension": "pdf",
        "documentId": "2"
      },
      "serverTemplates": [
        {
          "sequence": "2",
          "templateId": "your-template-id-2"
        }
      ]
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  }
}

이렇게 하면 pdf1과 pdf2가 단일 봉투로 병합됩니다. 첫 번째 복합 템플릿은 템플릿 1을 첫 번째 PDF에 첨부하고 서명 탭을 추가합니다. 두 번째 템플릿은 템플릿 2를 통해 부록을 추가합니다. 수신자는 별도의 봉투를 보지 않고 병합된 문서에 서명합니다.

병합 로직 처리:
- documentId를 사용하여 PDF를 고유하게 참조합니다. 템플릿의 탭은 특정 문서에 적용되지만 통합된 보기로 표시됩니다.
- 대량 병합의 경우 대량 전송 API(Business Pro 또는 Advanced 계획)와 통합합니다. 연간 사용자당 최대 약 100회 전송입니다.
- 오류 처리: base64 크기(문서당 최대 5MB)를 확인하고 OAuth 범위에 signature가 포함되어 있는지 확인합니다.
봉투 전송 및 모니터링:
- https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes에 POST합니다.
- /envelopes/{envelopeId}를 통해 상태를 검색합니다. 완료된 봉투는 API를 통해 병합된 PDF를 반환합니다.
- 비즈니스 팁: 프로덕션 환경에서는 서명 완료에 대한 실시간 알림을 위해 웹후크(Advanced 계획의 Connect 기능)를 사용합니다.
테스트 및 최적화:
- 샌드박스 테스트는 봉투 할당량을 부과하지 않습니다. API 대시보드에서 사용량을 모니터링하여 초과를 방지합니다. Starter 계획은 월 40개의 봉투로 제한됩니다.
- 복잡한 병합의 경우 PowerForms와 결합하여 공개 템플릿에 사용하고 전자 상거래 또는 파트너 온보딩의 확장성을 향상시킵니다.

업계 벤치마크에 따르면 이 방법을 사용하면 대량 환경에서 문서 준비 시간을 50-70% 단축할 수 있습니다. 그러나 기업의 경우 사용자 지정 통합에는 용량에 따라 가격이 책정되는 Enterprise API 계획이 필요할 수 있습니다.

DocuSign IAM CLM과의 통합

DocuSign의 지능형 계약 관리(IAM) 및 계약 라이프사이클 관리(CLM)는 복합 템플릿의 가치를 확장합니다. IAM은 AI 기반 위험 평가 및 약관 추출을 제공하고 CLM은 템플릿 라이브러리 및 분석을 포함한 엔드투엔드 워크플로우 자동화를 제공합니다. API 컨텍스트에서 이러한 기능은 CRM 시스템에서 데이터를 가져와 병합된 문서를 채우는 것과 같은 동적 PDF 생성을 위해 복합 템플릿과 통합됩니다. 금융과 같은 규제 대상 산업의 기업은 감사 추적 및 SSO와 같은 IAM의 규정 준수 도구의 이점을 누릴 수 있지만 인증과 같은 추가 기능에는 계량 요금이 부과됩니다.

경쟁 환경에서 전자 서명 플랫폼 평가

기업이 세계화됨에 따라 전자 서명 제공업체를 선택하려면 API 유연성, 규정 준수 및 비용의 균형을 맞춰야 합니다. DocuSign은 복합 템플릿과 같은 강력한 API 기능으로 선두를 달리고 있지만 대안은 다양한 이점을 제공합니다. Adobe Sign은 PDF 중심 프로세스에서 탁월하며 병합 전 고급 편집을 위해 Adobe Acrobat과 원활하게 통합됩니다. 해당 API는 "계약"을 통해 유사한 복합 구조를 지원하며 기본 계획은 사용자당 월 10달러부터 시작합니다.

HelloSign(현재 Dropbox Sign)은 간단한 병합을 위한 사용자 친화적인 API를 제공하며 SMB의 사용 편의성을 강조합니다. 월 15달러/사용자 계획은 무제한 템플릿을 제공합니다. 조건부 로직 측면에서 DocuSign의 깊이가 부족하지만 Google Workspace와 같은 도구와의 빠른 통합이 뛰어납니다.

eSignGlobal은 100개의 주요 국가 및 지역의 규정 준수를 지원하는 글로벌 경쟁자로 자리매김하고 있습니다. 전자 서명 규정이 파편화되고 높은 기준과 엄격한 규제를 받는 아시아 태평양 지역(APAC)에서 강점을 보입니다. 이는 미국과 유럽에서 흔히 볼 수 있는 프레임워크 기반 ESIGN/eIDAS 모델이 아닌 에코시스템 통합을 위한 솔루션이 필요한 경우가 많습니다. APAC은 이메일 확인 또는 자기 선언을 넘어 기술적 장벽을 높이는 정부 대 기업(G2B) 디지털 ID와의 심층적인 하드웨어/API 수준의 인터페이스가 필요합니다. eSignGlobal은 홍콩의 iAM Smart 및 싱가포르의 Singpass와 원활하게 통합되어 대량 전송 및 AI 계약 도구와 같은 기능을 제공합니다. 연간 16.6달러/월의 Essential 계획은 100회의 문서 전송, 무제한 사용자 시트 및 액세스 코드 확인을 허용합니다. 이는 규정 준수 기반에서 경쟁업체보다 약간의 비용 이점을 제공합니다. 이 플랫폼은 기존 리더에게 도전하기 위해 유럽 및 미주 시장으로 적극적으로 확장하고 있습니다.

esignglobal HK

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

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

👉 무료 평가판 시작

경쟁업체 비교표

기능/측면	DocuSign	Adobe Sign	eSignGlobal	HelloSign (Dropbox Sign)
API PDF 병합	복합 템플릿(고급)	PDF 조립이 포함된 계약 API	대량 전송 및 임베디드 API	기본 템플릿 병합
가격(엔트리 레벨)	$10/월(개인)	$10/사용자/월	$16.6/월(Essential, 무제한 사용자)	$15/사용자/월
규정 준수 초점	글로벌, 미국/EU 강세 (ESIGN/eIDAS)	Adobe 에코시스템, GDPR/ESIGN	100개 국가, APAC 심층 (iAM Smart/Singpass)	미국/EU 초점, 기본 글로벌
사용자 제한	시트별 라이선스	사용자별	무제한 사용자	사용자별
API 할당량	계층화(40-100+/월)	사용량 기반	Pro에 포함(유연함)	중간(무제한 템플릿)
강점	엔터프라이즈 기능, IAM/CLM	PDF 편집 통합	APAC 최적화, 높은 비용 효율성	단순성, Dropbox 동기화
제한 사항	높은 API/추가 기능 비용	복잡한 병합을 위한 API 깊이 부족	APAC 이외의 시장에서 신흥	고급 자동화 제한

이 표는 중립적인 절충안을 강조합니다. DocuSign은 대용량 API 요구 사항에 적합하고 다른 플랫폼은 경제성 또는 지역 적응성을 우선시합니다.

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

결론적으로 DocuSign의 복합 템플릿은 API를 통해 PDF를 병합하여 비즈니스 워크플로우의 효율성을 높이는 안정적인 방법을 제공합니다. 대안을 찾는 팀의 경우 eSignGlobal은 특히 APAC 운영을 위한 중립적이고 지역 규정을 준수하는 옵션으로 두각을 나타냅니다.