문서(Document)

**문서(Document)**는 서명의 대상이 되는 한 건의 계약/서면입니다. 본문(HTML) 또는 업로드한 PDF를 담습니다.

객체 구조

{
  "id": "4859ccb5-1baf-41f6-...",
  "object": "document",
  "title": "업무 위탁 계약서",
  "status": "sent",
  "author_name": "주식회사 팩터리",
  "edit_locked_at": null,
  "participants": [ /* 서명자 배열 */ ],
  "fields": [ /* 서명 필드 배열 */ ],
  "created_at": "2026-06-05T09:30:00+09:00",
  "completed_at": null
}

생애주기

draft ──send──▶ sent ──(서명 진행)──▶ completed
                 │
                 ├─ 서명자 거절 ──▶ rejected
                 ├─ 만료 ──────────▶ expired
                 └─ 발신자 취소 ───▶ canceled

공개 API로는 draft에서만 본문·필드·서명자를 바꿀 수 있습니다. edit_locked_at은 편집 잠금 시각인 읽기 전용 필드이며, 값이 있으면 작성 중에도 편집할 수 없습니다. 잠금은 Pactery의 문서 설정에서 작성자 또는 조직 관리자가 변경합니다.

공유 링크로 여러 수신자가 각각 서명한 문서는 완료된 계약이 하나 이상 있으면 completed로 표시합니다. 이는 같은 링크의 추가 서명 접수를 닫는다는 뜻이 아닙니다. 새 버전의 초안이나 편집 잠금 여부와도 별개입니다. 공동 검토의 승인만으로는 서명 완료가 되지 않습니다.