SaaS APIProgress Table
PUT /ai/progress-table/application/delivery/tracking
운송장 번호 저장/수정
운송장 번호 저장/수정
applicationId로 배송 정보를 저장하거나 수정합니다. 운송장 번호 입력 시 배송 상태가 shipping으로 자동 전환되며, 지원 택배사(kr.*)인 경우 이후 10분 주기 자동 배송조회 폴링 대상이 됩니다.
HTTP 요청
PUT /ai/progress-table/application/delivery/tracking
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationId | long | 예 | 신청 ID |
trackingNumber | string | 예 | 운송장 번호 |
courierCode | string | 예 | 택배사 코드. 지원 9개는 아래 표의 코드(kr.xxx), 그 외는 한글 택배사명 또는 OTHER |
{
"applicationId": 123,
"trackingNumber": "1234567890",
"courierCode": "kr.cjlogistics"
}택배사 코드 (courierCode)
프론트 드롭다운은 아래 코드값을 전송하고, 표시는 한글명을 사용합니다. kr.* 코드만 자동 배송조회 대상이며, OTHER(또는 한글 자유입력)는 자동 추적되지 않습니다.
| 코드 (전송값) | 표시명 |
|---|---|
kr.cjlogistics | CJ대한통운 |
kr.lotte | 롯데택배 |
kr.hanjin | 한진택배 |
kr.logen | 로젠택배 |
kr.epost | 우체국택배 |
kr.coupangls | 쿠팡(CLS) |
kr.cvsnet | GS편의점(CVSnet) |
kr.kdexp | 경동택배 |
kr.daesin | 대신택배 |
OTHER | 기타 (자동 추적 제외, 한글 택배사명 입력 가능) |
응답
{
"status": 200,
"code": null,
"message": "운송장 번호가 저장되었습니다.",
"data": {
"id": 199,
"applicationId": 123,
"deliveryStatus": "shipping",
"trackingNumber": "1234567890",
"courierCode": "kr.cjlogistics",
"trackingDetail": null,
"createdAt": "2026-05-28T17:46:34",
"updatedAt": "2026-05-28T17:47:30"
}
}