SaaS API기업 서비스 이용 계약서
PATCH /ai/admin/business-contracts/{businessId}/exception
관리자 — 예외 계정 설정/해제 (contract_sign_status = EXCEPTION/SIGNED/NONE)
예외 계정 설정/해제 (관리자)
특정 기업을 예외 계정으로 설정하면 계약서 서명 없이도 캠페인 생성이 가능합니다.
TB_BUSINESS.contract_sign_status 값을 직접 변경합니다.
| 항목 | 값 |
|---|---|
| 메서드 | PATCH |
| 경로 | /ai/admin/business-contracts/{businessId}/exception |
| 인증 | 관리자 |
요청
| 파라미터 | 위치 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
businessId | Path | String | 예 | 기업 회원 ID |
grant | Query | Boolean | 예 | true = 예외 설정, false = 예외 해제 |
adminId | Query | String | 예 | 처리 관리자 ID (감사 로그 기록용) |
# 예외 설정
PATCH /ai/admin/business-contracts/biz_user_001/exception?grant=true&adminId=admin_kim
# 예외 해제
PATCH /ai/admin/business-contracts/biz_user_001/exception?grant=false&adminId=admin_kimcontract_sign_status 변화
| 상황 | grant=true 결과 | grant=false 결과 |
|---|---|---|
| 임의의 시작 상태 | * → EXCEPTION | * → NONE (무조건 NONE) |
중요:
grant=false시 이전 SIGNED 상태로 자동 복구하지 않습니다.contract_sign_status = SIGNED진입 경로는 어드민의 검수 승인(/review?decision=APPROVED) 으로 단일화되어 있으므로, 예외 해제 후 캠페인 생성을 다시 허용하려면 재발송(/send) → 기업 sign → 어드민 검수 승인 사이클이 필요합니다.
응답 (200 OK)
{
"status": 200,
"code": null,
"message": "예외 계정으로 설정되었습니다.",
"data": null
}에러 응답
| 코드 | 설명 |
|---|---|
BIZ_C007 | 기업 정보를 찾을 수 없음 |