결재 처리상태 전송

✅ 해당 기능이 제공되는 다우오피스 상품 유형

무료	서비스형		엔터프라이즈형
스탠다드	스탠다드	프리미엄	스탠다드	프리미엄
❌	❌	❌	✅	✅

👉🏼 유형별 제품 안내 보기

이 API는 다우오피스에서 결재 상태 변경 이벤트 발생 시, 연동 시스템으로 상태값을 전달하는 용도입니다.
즉, 고객사에서 다우오피스로 호출하는 API가 아니라, 다우오피스가 고객사의 연동시스템(CallBackUrl)으로 호출하는 API입니다.

[결재 기안 API] 호출 시 callbackUrl을 함께 전달
해당 문서에서 결재 이벤트 발생 시, 다우오피스가 callbackUrl로 상태값 전송
연동 시스템에서 수신 후 정상 처리 시 HTTP 200 응답 반환

HTTP 200 이외의 응답을 반환하면 다우오피스 내 결재 상태 변경 이벤트가 취소됩니다.

✔️ Request URL

결재 기안 API에서 전달받은 callbackUrl

예) https://partner.domain.com:8080/do/document/status

✔️ HTTP Method

POST (Content-Type: application/json; charset=UTF-8)

✉️ Request Body

변수	타입	필수	사전발급	설명
docId	String	✅	⛔	다우오피스 결재 문서의 고유번호 다른 다우오피스 결재 연동(문서조회 등)을 위한 고유키 정보
docNum	String	✅	⛔	다우오피스 결재 문서번호
partnerStatusCode	String	⛔	✅	업무시스템 고객사 정의 문서 상태 코드
docStatusCode	String	✅	⛔	다우오피스 결재 문서 상태 코드 (DRAFT/COMPLETE/RETURN/FORCED_RETURN/CANCEL/ DELETE/FORCE_DELETE/TEMPSAVE/INPROGRESS/RECV_WAITING/RECEIVED)
docStatusName	String	✅	⛔	다우오피스 결재 문서 상태 명 (기안/완료/반려/강제반려/취소/삭제/강제삭제/임시저장/진행중/접수대기/접수)
allianceInfo	Object	⛔	⛔	결재 공유정보를 위한 배열

allianceinfo(업무 시스템에서 전달하고자 하는 배열값으로 필요시에만 작성)

변수	타입	필수	사전발급	설명
{업무시스템 생성}#1	String	⛔	⛔	업무시스템에서 전달하는 연동관련 고유정보 #1
{업무시스템 생성}#2	String	⛔	⛔	업무시스템에서 전달하는 연동관련 고유정보 #2
{업무시스템 생성}#3	String	⛔	⛔	업무시스템에서 전달하는 연동관련 고유정보 #3

✉️ Request 예시

POST /do/document/status HTTP/1.1
partner.domain.com:8080
Content-Type : application/json; charset=UTF-8

{

"docId" :"다우오피스 결재 문서의 고유번호(123456)",
"docNum" : "다우오피스 결재 문서번호(다우오피스-API-001234)",
"partnerStatusCode" :"업무시스템 고객사 정의 문서 상태 코드(E)",
"docStatusCode" : "결재문서상태코드(COMPLETE)",
"docStatusName" : "결재문서상태명(완료)",
"allianceInfo" : "{"key":"","code":"","info":"","detail":{"no":"","value":""}}"

}

📬Response Body

data 객체

변수	타입	필수	사전발급	설명
code	String	✅	⛔	API 호출결과 코드
message	String	✅	⛔	API 호출결과 메시지

📬Response 예시

Content-Type: application/json;charset=UTF-8

{

"code" : "200",
"message" : "OK",
}

🚫 주요 오류 코드 예시

코드	내용	설명(Description)
901	유효하지 않은 client ID	client ID를 확인하세요.
902	유효하지 않은 Client Secret	client Secret을 확인하세요.
955	도메인 코드 오류	oooo는 존재하지 않는 도메인 코드입니다.

결재 처리상태 전송