NAVER WORKS

안녕하세요. 결재 문서 작성 API로 회사 생성 서식 기안을 생성하려는데, 형식이 유효한 요청에도 지속적으로 500(INTERNAL_SERVER_ERROR)이 발생해 문의드립니다.

​

[요청]

POST https://www.worksapis.com/v1.0/business-support/approval/users/{userId}/documents

scope: businessSupport.approval

documentBody 예:

- CP_DATE (componentValue: { "date": "2026.07.28" })

- CP_EDITOR (componentValue: { "value": "테스트" })

​

[응답]

500 {"code":"INTERNAL_SERVER_ERROR","description":"An internal server error occurred. Please try again later."}

​

[요청 형식이 유효함을 확인한 근거 — 형식 검증은 통과, 그 다음 '생성' 단계에서만 500]

1) documentBody 컴포넌트 0~1개 → 400 "component count does not match", 2개 → 통과 (해당 서식 컴포넌트 수 = 2: CP_DATE + CP_EDITOR)

2) CP_EDITOR componentValue {value:""} → 400 "componentValue is required", 잘못된 키({text:...}) → 400, {value:"텍스트"} → 통과

3) CP_DATE {date:"2026-07-28"}(하이픈) → 400 "componentValue is invalid", {date:"2026.07.28"}(점) → 통과

즉 위 형식 검증을 모두 통과한 뒤에 문서 생성 단계에서 500이 발생합니다.

​

[동일하게 500이 재현되는 조건]

- 기안자 2명(일반 구성원 / 리더십 소속) 모두 500

- approvalLines 미포함(관리자 설정 결재선) / 포함(명시 결재자) 모두 500

​

[참고]

- 첨부 파일 추가 API(POST .../users/{userId}/documents/attachments)는 정상적으로 uploadUrl/fileId를 반환합니다 → 결재 쓰기 스코프/앱 권한 자체는 동작하는 것으로 보입니다.

- 커뮤니티에 Approval 작성 API를 정상 사용하는 사례가 있어, API 전면 장애가 아니라 특정 서식/설정 이슈로 추정됩니다.

​

[문의]

1. 위 요청에 대한 서버 로그 확인 및 문서 생성 500 원인 안내 부탁드립니다.

2. 서식측 설정(결재선/공유 설정 등)이 원인이라면 어떤 설정을 확인/변경해야 하는지 알려주세요.

3. 특정 회사 생성 서식이 API 작성을 지원하지 않는 조건이 있다면 안내 부탁드립니다.

​

* 도메인/서식 코드/계정 등 식별 정보는 비공개로 전달 가능합니다.