•
대상 : 이벗WMS(3PL) , 자이언트+ 이상 회원사
이벗WMS 이벤트 훅 정의
•
고객사별 "이벤트 훅 API" URL을 설정하였다면 이벗WMS에서 발생하는 이벤트 정보를 수신할 수 있습니다.
•
수신 가능한 이벤트 유형은 현재 "출고처리" 등 물류사의 출고 작업 단계별 발생하는 이벤트를 수신할 수 있습니다.
추후 송장출력 등 필요한 이벤트가 추가될 예정입니다.
이벤트 훅 API 호출 인증 및 URL
•
발생한 이벤트 훅 호출 건은 유효한 HTTP 호출임을 증명하기 위해 Payload에 사전에 등록된 토큰 값을 제공하여 발송합니다.
•
판매자께서는 "이벤트 훅 API" 개발 시 Payload의 토큰 값을 인증하는 방식으로 개발해야 합니다.
•
이벤트 훅 수신을 위한 URL은 이벤트 타입별로 고객사(판매자) 재량으로 결정합니다.
•
URL과 토큰 값은 기초정보 > 고객사코드 > 추가등록사항에서 생성합니다.
이제 이벗WMS에서 설정하는 방법을 구체적으로 알려드릴게요.
사용설정하기
•
기초정보 > 환경설정/결제 > 기본정보 탭으로 이동합니다
•
웹훅사용을 ‘예’로 체크 후 저장합니다.
•
이벤트별 수신 URL 및 토큰생성하기
•
기초정보 > 고객사코드 메뉴로 이동합니다
•
고객사별 --> 이벤트별 URL과 토큰을 생성합니다.
•
웹훅타입 : 이벤트 타입을 선택합니다.
•
수신URL : 이벤트별 데이타를 수신할 판매자(고객사) 시스템의 URL을 입력합니다.
•
토큰 : 토큰생성 버튼을 이용해 자동 생성하거나 직접 입력해서 등록합니다. Payload 토큰 이름으로 전송됩니다.
출고완료 이벤트
•
이벗WMS에서 출고완료 처리시 등록된 URL로 POST 요청을 발송합니다.
•
발송되는 Payload값은 아래와 같습니다.
필드정의
필드이름 | 필드구분 | 비고 |
token | 토큰 | |
eventType | 이벤트타입 | DISPATCHED : 출고완료 |
orderNo | 주문번호 | |
invcDDate | 출고일 | 20251124 |
invcExprNo | 택배사 | |
invcExprNo | 송장번호 |
샘플
{
"total":3,
"data":[
{
"invcExprNo":"520993907795",
"orderNo":"202511128153451",
"eventType":"DISPATCHED",
"invcDDate":"20251124",
"token":"63ae62b474fa9cf14ae163e34f5aef12",
"invcExpr":"CJ대한통운"
},
{
"invcExprNo":"520993907795",
"orderNo":"202511128153451",
"eventType":"DISPATCHED",
"invcDDate":"20251124",
"token":"63ae62b474fa9cf14ae163e34f5aef12",
"invcExpr":"CJ대한통운"
},
{
"invcExprNo":"520993907784",
"orderNo":"202511128153451",
"eventType":"DISPATCHED",
"invcDDate":"20251124",
"token":"63ae62b474fa9cf14ae163e34f5aef12",
"invcExpr":"CJ대한통운"
}
]
}
Plain Text
복사
이벗WMS 스케줄러가 5분 단위로 Outgoing 웹훅을 발송합니다.
위 내용과 관련해서 궁금한 사항은 고객센터나 메일로 문의하세요.
감사합니다.
•
자이언트+ 회원사 이용 가능 서비스