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 |
customCourierName | string | 아니오 | 기타 택배사 자유입력명. courierCode가 kr.*가 아닐 때만 저장됩니다 |
지원 택배사 — 기존과 동일합니다.
{
"applicationId": 123,
"trackingNumber": "1234567890",
"courierCode": "kr.cjlogistics"
}기타 택배사 — courierCode는 OTHER로 두고 택배사명은 customCourierName으로 보냅니다.
{
"applicationId": 123,
"trackingNumber": "1234567890",
"courierCode": "OTHER",
"customCourierName": "천일택배"
}customCourierName 저장 규칙
| 요청 | 저장 결과 |
|---|---|
courierCode가 kr.* | customCourierName은 무시되고 null로 초기화됩니다 (기타 → 지원 택배사로 교체 시 옛 이름이 남지 않도록) |
courierCode가 kr.*가 아님 + customCourierName 있음 | 입력값을 trim 후 저장 |
courierCode가 kr.*가 아님 + customCourierName 없음 | 기존 값 유지 (덮어쓰지 않음) |
courierCode에 한글 택배사명을 직접 넣는 기존 방식도 계속 동작하지만(legacy), 신규 연동은 courierCode: "OTHER" + customCourierName 조합을 사용하세요. 코드 필드와 표시명이 분리돼야 크리에이터 화면에서 택배사명이 정확히 나옵니다.
택배사 코드 (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 | 기타 (자동 추적 제외, 택배사명은 customCourierName으로 전송) |
응답
{
"status": 200,
"code": null,
"message": "운송장 번호가 저장되었습니다.",
"data": {
"id": 199,
"applicationId": 123,
"deliveryStatus": "shipping",
"trackingNumber": "1234567890",
"courierCode": "kr.cjlogistics",
"customCourierName": null,
"trackingDetail": null,
"createdAt": "2026-05-28T17:46:34",
"updatedAt": "2026-05-28T17:47:30"
}
}