software

BoldSign API로 문서 만료 연장하여 서명 프로세스 유지

발행: (2025년 12월 8일 오후 05:46 GMT+9)
6 min read
원문: Dev.to

Source: Dev.to

문서 만료 연장을 통한 서명 프로세스 활성 유지 (BoldSign API 사용)

eSignature 흐름을 API로 운영하고 있다면, 다음과 같은 성가신 상황을 겪어봤을 것입니다. 자동화는 완벽히 동작하지만 서명자가 예상보다 오래 걸릴 경우 문서가 조용히 만료됩니다. 계약은 아직 진행 중인데 말이죠.

바로 이때 API를 통한 문서 만료 연장이 lifesaver가 됩니다. 만료를 고정값이 아니라 현재 시스템 상황—예: 파이프라인에 남아 있는 기회, 관리자의 승인 대기, 법무 검토 중인 계약—에 따라 실시간으로 조정할 수 있게 되는 것이죠.

이 블로그에서는 간단한 BoldSign API 호출로 만료를 연장하여 서명 프로세스를 매끄럽게 유지하는 방법을 살펴보겠습니다. 깨지기 쉬운 해킹, 시끄러운 재시도, 좌절하는 이해관계자를 없앨 수 있습니다.

문서 만료를 연장해야 하는 이유

  • 예기치 않은 만료 방지: 서명자가 부재 중이거나 마감일을 놓쳤을 때 시간을 더 줍니다.
  • 진행 중인 협상 지원: 논의가 계속되는 동안 문서를 활성 상태로 유지합니다.
  • 문서 재전송 회피: 템플릿이나 필드를 다시 설정하지 않고 만료만 업데이트합니다.
  • 규정 준수 보장: 규제된 워크플로는 종종 연장된 검토 시간을 요구합니다.

BoldSign의 만료 유형

BoldSign은 세 가지 만료 설정을 지원합니다:

  • 일(Days): yyyy-MM-dd (예: 2025-10-15)
  • 시간(Hours): 정수 (예: 12)
  • 특정 날짜 및 시간: ISO 포맷 (예: 2025-10-15T10:58:04Z)

BoldSign API로 만료 연장하기

단계 1: 문서 속성 조회

문서 만료 날짜를 연장하기 전에 현재 expiryDateType와 expiryValue를 확인해야 합니다. BoldSign API를 사용해 문서 속성을 가져옵니다:

GET /v1/document/properties

공식 문서: Get Document Properties API

응답에는 문서에 추가된 양식 및 만료 설정(expiryDateType, expiryValue)을 포함한 모든 관련 상세 정보가 들어 있습니다.

단계 2: 만료 날짜 연장

expiryDateType을 확인한 뒤, 아래 요청을 사용해 문서 만료를 업데이트합니다:

curl -X PATCH "https://api.boldsign.com/v1/document/extendExpiry?documentId={documentId}" \
     -H 'X-API-KEY: {your API key}' \
     -H "Content-Type: application/json" \
     -d '{"newExpiryValue": "2025-12-15", "warnPrior": true}'

만료 날짜 업데이트 시 중요한 속성 및 규칙

  • documentId – 업데이트할 문서의 ID.
  • newExpiryValue – 원래 만료 유형에 따라 포맷이 달라집니다:
    • Days → yyyy-MM-dd
    • Hours → 정수값
    • Specific Date & Time → ISO 포맷
  • warnPrior – 알림 동작을 제어합니다:
    • true – 만료 1일 전에 알림 전송
    • false – 알림 비활성화
    • null – 기존 설정 유지

추가 규칙:

  • 새 만료는 현재 만료보다 늦어야 합니다.
  • 만료는 문서 생성일 기준 180일을 초과할 수 없습니다.

성공적인 업데이트는 200 OK와 함께 새로운 만료 상세 정보를 반환합니다.

문서 만료 연장의 주요 장점

  • 높은 유연성: 프로젝트 일정이나 클라이언트 가용성 변화에 맞춰 만료일을 조정해 처음부터 다시 시작할 필요가 없습니다.
  • 완료율 향상: 수신자에게 더 많은 시간을 제공하면 서명 및 반환 가능성이 높아집니다.
  • 우수한 사용자 경험: 지연이 불가피할 때 추가 시간을 제공하면 서명자가 크게 만족합니다.
  • 워크플로 효율성 강화: 만료된 링크 때문에 파이프라인이 중단되지 않아 문서 흐름이 원활하게 유지됩니다.

결론

지연은 불가피하지만 서명 워크플로를 처음부터 다시 시작할 필요는 없습니다. BoldSign의 만료 연장 API를 활용하면 일상적인 도전에 유연하게 대응하고 문서를 지속적으로 진행시킬 수 있습니다.

시도해 볼 준비가 되셨나요?
B​oldSign API 문서에서 API 레퍼런스를 확인하고, 무료 샌드박스 계정에 가입해 바로 시작해 보세요.

이 블로그는 원래 boldsign.com에서 게시되었습니다.

Back to Blog

관련 글

더 보기 »