문서(Document)
**문서(Document)**는 서명의 대상이 되는 한 건의 계약/서면입니다. 본문(HTML) 또는 업로드한 PDF를 담습니다.
객체 구조
{
"id": "doc_8sK2...",
"object": "document",
"title": "업무 위탁 계약서",
"status": "sent",
"author_name": "주식회사 팩터리",
"participants": [ /* 서명자 배열 */ ],
"fields": [ /* 서명 필드 배열 */ ],
"created_at": "2026-06-05T09:30:00+09:00",
"completed_at": null
}
생애주기
draft ──send──▶ sent ──(서명 진행)──▶ completed
│
├─ 서명자 거절 ──▶ rejected
├─ 만료 ──────────▶ expired
└─ 발신자 취소 ───▶ canceled
| 상태 | 의미 |
|---|---|
draft |
작성 중. 필드·서명자 수정 가능, 미발송 |
sent |
발송됨. 서명 진행 중 |
completed |
모든 필수 서명 완료 |
rejected |
서명자가 거절 |
expired |
마감일 경과 |
canceled |
발신자가 취소 |
draft에서만 본문·필드·서명자를 바꿀 수 있습니다. 발송 후에는 취소 후 새로 만들어야 합니다.