SaaS API기업 서비스 이용 계약서
GET /ai/business/contract/status
진행 중인 기업 계약 상태 조회 — contractStatus + contractSignStatus 반환
계약 상태 조회
현재 진행 중인(미서명) 계약 상태를 조회합니다.
| 항목 | 값 |
|---|---|
| 메서드 | GET |
| 경로 | /ai/business/contract/status |
요청
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
memberId | String | 예 | 기업 회원 ID |
GET /ai/business/contract/status?memberId=biz_user_001 HTTP/1.1
Host: api.glowb.com응답 (200 OK)
{
"status": 200,
"code": null,
"message": "계약 상태 조회 성공",
"data": {
"contractStatus": "FILLED",
"contractSignStatus": "NONE",
"stampImageUrl": "https://glowb-input.s3.ap-southeast-1.amazonaws.com/contract/business/stamp/...",
"finalPdfUrl": null,
"sentAt": null,
"openedAt": "2026-04-27T10:00:00",
"filledAt": "2026-04-27T10:05:00",
"signedAt": null
}
}응답 필드 설명
| 필드 | 타입 | 설명 |
|---|---|---|
contractStatus | String | 계약 진행 상태 — PENDING|SENT|OPENED|FILLED|SIGNED|REJECTED |
contractSignStatus | String | 캠페인 허용 여부 — NONE|PENDING|SIGNED|EXCEPTION |
approvalStatus | String|null | 어드민 검수 상태 — NULL(서명 전) / PENDING_APPROVAL / APPROVED / REJECTED |
rejectionReason | String|null | 거절 사유 (검수 거절 시) |
voidedPdfUrl | String|null | 거절 시 VOID 워터마크 합성본 PDF (원본 finalPdfUrl 은 그대로 보존) |
stampImageUrl | String|null | 등록된 인감 이미지 URL |
finalPdfUrl | String|null | SIGNED 상태일 때 최종 계약서 PDF URL |
sentAt | DateTime|null | 관리자 발송 시각 |
openedAt | DateTime|null | 최초 열람 시각 |
filledAt | DateTime|null | 기업 정보 입력 시각 |
signedAt | DateTime|null | 서명(인감 업로드) 완료 시각 |
contractSignStatus 값
| 값 | 의미 | 캠페인 생성 | 프론트 안내 예시 |
|---|---|---|---|
NONE | 서명된 계약 없음 또는 검수 거절됨 | ❌ 403 차단 | "계약서 작성이 필요합니다" |
PENDING | 서명 완료, 어드민 검수 대기 중 | ❌ 403 차단 | "Glowb에서 계약서를 확인 중입니다" |
SIGNED | 어드민 검수 승인 완료 | ✅ 가능 | — |
EXCEPTION | 관리자 지정 예외 계정 | ✅ 가능 | — |
PENDING은 기업이 sign(인감 업로드)을 완료했지만 아직 어드민이 검수하지 않은 상태입니다. 검수가 통과되면 SIGNED, 거절되면 NONE이 됩니다.