@sayren/store-sdk 0.10.0 → 0.12.0

package/dist/index.mjs

@@ -34,6 +34,11 @@ const errorDetailSchema = z.object({
 	message: z.string(),
 	traceId: z.string().optional(),
 	/**
+	* 이 에러 코드를 설명하는 문서 URL(선택). 서버가 코드별 매핑을 가진 코드에만 실린다 —
+	* 없으면 필드가 아예 없으므로 소비측은 있을 때만 쓴다
+	*/
+	docs: z.url().optional().catch(void 0),
+	/**
 	* 에러 코드별 보조 데이터(선택). 예: 관리 API `LIVE_GATE_NOT_MET`·`LIVE_PAYMENTS_DISABLED`의
 	* `{ conditions: LiveGateCondition[] }`. 형태는 에러 코드마다 다르므로 소비측이 코드별 스키마로 다시 파싱한다
 	*/
@@ -69,13 +74,15 @@ var ApiError = class extends Error {
 	traceId;
 	body;
 	details;
-	constructor(status, code, message, traceId, body, details) {
+	docs;
+	constructor(status, code, message, traceId, body, details, docs) {
 		super(message);
 		this.status = status;
 		this.code = code;
 		this.traceId = traceId;
 		this.body = body;
 		this.details = details;
+		this.docs = docs;
 		this.name = "ApiError";
 	}
 };
@@ -88,7 +95,7 @@ var ApiError = class extends Error {
 function toApiError(status, raw) {
 	const envelope = envelopeSchema.safeParse(raw);
 	const detail = envelope.success ? envelope.data.error : errorDetailSchema.safeParse(raw).data ?? null;
-	if (detail) return new ApiError(status, detail.code, detail.message, detail.traceId, raw, detail.details);
+	if (detail) return new ApiError(status, detail.code, detail.message, detail.traceId, raw, detail.details, detail.docs);
 	const oauth = envelope.success ? null : oauthErrorSchema.safeParse(raw).data;
 	if (oauth) return new ApiError(status, oauth.error, oauth.error_description ?? oauth.error, void 0, raw);
 	return new ApiError(status, "UNKNOWN", `HTTP ${status}`, void 0, raw);
@@ -467,7 +474,8 @@ const apiLogListQuerySchema = z.object({
 	principalType: z.union([z.string(), z.array(z.string())]).transform((value) => (Array.isArray(value) ? value : [value]).flatMap((part) => part.split(",")).map((part) => part.trim()).filter((part) => part.length > 0)).pipe(z.array(apiLogPrincipalTypeSchema).min(1)).optional().describe("호출 주체 유형 필터. 여러 개는 쉼표로 구분한다 (예: `PAT,CLIENT`). 파싱 결과는 배열로 정규화된다"),
 	principalId: z.string().optional().describe("호출 주체 ID 필터"),
 	status: apiLogStatusFilterSchema.optional(),
-	q: z.string().optional().describe("경로 부분 일치 검색어"),
+	q: z.string().optional().describe("경로 부분 일치 검색어. 리소스 id(예: `ord_…`)를 넣으면 그 리소스를 건드린 요청만 남으므로 웹훅 전송 기록의 `resource.id`와 짝지어 쓴다"),
+	traceId: z.string().optional().describe("추적 ID 필터(정확히 일치). 에러 응답 `error.traceId` 값을 그대로 넣어 그 요청 한 건을 찾는다"),
 	cursor: z.string().optional().describe("이전 응답의 `nextCursor`. 생략하면 가장 최신부터"),
 	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50)")
 });
@@ -722,6 +730,21 @@ const claimReasonSchema = z.enum([
 	"DIFFERENT_FROM_PAGE",
 	"DELAY"
 ]);
+/**
+* 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
+* 상품이 반품지를 따로 지정했으면 그 주소다.
+*
+* 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
+* 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
+*/
+const claimReturnAddressSchema = z.object({
+	name: z.string().describe("주소 이름(셀러가 붙인 별칭). 예: 본사 물류센터"),
+	contactName: z.string().describe("수취인 이름"),
+	phone: z.string().describe("연락처"),
+	zipCode: z.string(),
+	address1: z.string(),
+	address2: z.string().nullable()
+});
 const claimSchema = z.object({
 	claimId: z.string(),
 	type: claimTypeSchema,
@@ -750,7 +773,8 @@ const claimSchema = z.object({
 	/** 보류 중이면 자동 해제 시각(ISO 8601), 아니면 null */
 	holdExpiresAt: z.string().nullable(),
 	/** 보류를 이미 썼는지 — 보류는 클레임당 1회라 해제·만료 뒤에도 true */
-	holdUsed: z.boolean()
+	holdUsed: z.boolean(),
+	returnAddress: claimReturnAddressSchema.nullable().describe("수거 안내에 쓸 반품지(이슈 #30). 상품이 지정한 반품지, 없으면 스토어 기본 반품지다. 취소 클레임과 반품지를 등록하지 않은 스토어는 null")
 });
 /** `GET /v1/claims` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
 const claimListQuerySchema = z.object({
@@ -1164,6 +1188,44 @@ const webhookDeliveryErrorCodeSchema = z.enum([
 	"NON_2XX",
 	"WEBHOOK_SUSPENDED"
 ]).describe("전송 실패 사유. `TIMEOUT`=10초 안에 응답 없음, `CONNECTION_FAILED`=연결 실패(DNS·TLS 포함), `BLOCKED_ADDRESS`=사설·루프백 등 전송이 허용되지 않는 주소, `NON_2XX`=2xx가 아닌 응답(리다이렉트 포함), `WEBHOOK_SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨");
+/**
+* 실패 원인 분류의 **현재** 값. 응답 스키마(`webhookFailureReasonSchema`)는 문자열로 열려 있다 —
+* 서버가 값을 더해도 이전 SDK가 목록 파싱에 실패하지 않게 한다(택배 추적 `stage`와 같은 이유).
+* 모르는 값은 `errorCode`로 판단한다.
+*/
+const WEBHOOK_FAILURE_REASONS = [
+	"DNS",
+	"TLS",
+	"TIMEOUT",
+	"CONNECTION",
+	"HTTP_4XX",
+	"HTTP_5XX",
+	"HTTP_OTHER",
+	"SSRF_BLOCKED",
+	"SUSPENDED"
+];
+const webhookFailureReasonSchema = z.string().describe("실패 원인 분류(진단용). 현재 값은 `DNS`=호스트 이름을 주소로 바꾸지 못함, `TLS`=인증서·핸드셰이크 실패, `TIMEOUT`=10초 안에 응답 없음, `CONNECTION`=연결 거부·끊김, `HTTP_4XX`·`HTTP_5XX`=그 대역의 응답, `HTTP_OTHER`=2xx·4xx·5xx가 아닌 응답(리다이렉트 등), `SSRF_BLOCKED`=사설·루프백 등 전송이 허용되지 않는 주소, `SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨. `errorCode`보다 잘게 나눈 값이며 둘은 함께 쓸 수 있다. 값이 추가될 수 있으므로 모르는 값은 `errorCode`로 판단한다");
+/**
+* 대상 리소스 종류의 **현재** 값. 응답 스키마는 문자열로 열려 있다(새 이벤트가 새 리소스를 가리킬 수 있다).
+*/
+const WEBHOOK_RESOURCE_TYPES = [
+	"ORDER",
+	"CLAIM",
+	"PRODUCT",
+	"REVIEW",
+	"INQUIRY"
+];
+const webhookResourceTypeSchema = z.string().describe("이벤트가 가리키는 리소스 종류. 현재 값은 `ORDER`·`CLAIM`·`PRODUCT`·`REVIEW`·`INQUIRY`이고 값이 추가될 수 있다");
+/** 이벤트가 가리키는 대상 리소스 — 전송 기록을 주문·상품과 잇는 키 */
+const webhookDeliveryResourceSchema = z.object({
+	type: webhookResourceTypeSchema,
+	id: z.string().describe("리소스 ID. 전송 기록 조회의 `resourceId`, API 로그 조회의 `q`로 그대로 넣을 수 있다")
+});
+/** 발송 요청 헤더 한 줄 (값 마스킹) */
+const webhookRequestHeaderSchema = z.object({
+	name: z.string().describe("헤더 이름"),
+	value: z.string().nullable().describe("헤더 값. 서명(`Sayren-Signature`)처럼 비밀이 섞이는 헤더는 이름만 주고 값은 null이다")
+});
 /** 웹훅 전송 기록 한 건 (전송 기록 조회 항목) */
 const webhookDeliverySchema = z.object({
 	deliveryId: z.string().describe("전송 기록 ID. 수신 요청의 `Sayren-Delivery-Id` 헤더 값"),
@@ -1173,8 +1235,10 @@ const webhookDeliverySchema = z.object({
 	status: webhookDeliveryStatusSchema,
 	responseStatusCode: z.number().int().nullable().describe("마지막 시도의 HTTP 응답 코드. 미시도·연결 실패·타임아웃·차단이면 null"),
 	responseTimeMs: z.number().int().nullable().describe("마지막 시도의 응답 시간(ms). 미시도·연결 실패면 null"),
-	responseBodyExcerpt: z.string().nullable().describe("마지막 시도의 응답 본문 앞부분(최대 1,024자). 응답이 없으면 null"),
+	responseBodyExcerpt: z.string().nullable().describe("마지막 시도의 응답 본문 앞부분(최대 4,096자). 응답이 없으면 null. 가린 뒤에 자른다. 키 이름에 `authorization`·`token`·`secret`·`password`·`key`·`signature`·`credential`·`cookie`가 **들어 있으면**(부분 일치, 대소문자 무시. 예: `apiKey`·`access_token`·`keyword`) 그 값을 `***`로 가린다. 값이 객체·배열이면 통째로 가린다. 평문 `Authorization: …` 같은 헤더 줄, `Bearer <토큰>`, 쿼리 형식 `access_token=…`, 끝에서 잘려 닫히지 않은 값도 가린다"),
 	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("마지막 시도의 실패 사유. 성공했거나 미시도면 null"),
+	failureReason: webhookFailureReasonSchema.nullable().describe("마지막 시도의 실패 원인 분류. 성공했거나 미시도면 null. `errorCode`를 더 잘게 나눈 진단 값이다"),
+	resource: webhookDeliveryResourceSchema.nullable().describe("이벤트가 가리키는 대상 리소스. 리소스를 특정할 수 없는 이벤트면 null. 이 값으로 전송 기록(`resourceId`)과 API 로그(`q`)를 오갈 수 있다"),
 	attemptCount: z.number().int().min(0).describe("지금까지의 시도 횟수. 최초 시도 1회 + 재시도 최대 4회"),
 	createdAt: z.string().describe("전송 기록이 적재된 일시 (ISO 8601)"),
 	attemptedAt: z.string().nullable().describe("마지막 시도 일시 (ISO 8601). 미시도면 null"),
@@ -1182,9 +1246,20 @@ const webhookDeliverySchema = z.object({
 	redeliveryOf: z.string().nullable().describe("수동 재전송으로 생긴 기록이면 원본 전송 기록 ID. 아니면 null"),
 	redeliveredAs: z.string().nullable().describe("이 기록을 원본으로 수동 재전송해 생긴 기록의 전송 기록 ID. 아직 재전송하지 않았으면 null. 재전송은 원본당 1회다")
 });
+/** 발송 본문 최대 노출 길이(바이트). 넘으면 잘라 주고 `payloadTruncated`가 true다 */
+const WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES = 16384;
+/** 웹훅 전송 기록 상세 — `GET /webhooks/{id}/deliveries/{deliveryId}`. 목록 항목 + 요청 본문·헤더 */
+const webhookDeliveryDetailSchema = webhookDeliverySchema.extend({
+	payload: z.string().describe(`수신 서버로 보낸 요청 본문 그대로(JSON 문자열). 서명은 이 문자열을 대상으로 계산한다. 최대 ${WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES / 1024}KB까지 주고 넘으면 잘라 준다`),
+	payloadTruncated: z.boolean().describe("본문이 길어서 잘렸으면 true. true면 `payload`는 유효한 JSON이 아니다"),
+	payloadMasked: z.boolean().describe("민감 키 마스킹(`responseBodyExcerpt`와 같은 키 이름 규칙)이 본문을 바꿨으면 true. true면 `payload`는 보낸 본문과 달라 서명을 맞춰 볼 수 없다. 이벤트 본문에는 보통 민감 키가 없어 false다"),
+	requestHeaders: z.array(webhookRequestHeaderSchema).describe("발송 요청에 실은 헤더. 값은 전송 시점 그대로이나 서명 헤더는 이름만 주고 값은 null이다. `Content-Length`는 실제로 보낸 본문(마스킹·자르기 전)의 바이트 수다. 매 시도가 같은 헤더 집합을 쓰고 서명·타임스탬프만 달라진다")
+});
 /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
 const webhookDeliveryListQuerySchema = z.object({
 	status: webhookDeliveryStatusSchema.optional().describe("전송 상태 필터. 생략하면 전체"),
+	eventType: eventTypeSchema.optional().describe("이벤트 타입 필터. 생략하면 전체"),
+	resourceId: z.string().optional().describe("대상 리소스 ID 필터(정확히 일치). 주문·클레임·상품·리뷰·문의 id를 넣으면 그 리소스의 이벤트만 남는다. 같은 id로 API 로그를 `q`로 검색하면 그 리소스를 건드린 API 요청을 볼 수 있다"),
 	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50). 최신 적재순으로 반환하며 보관 기간은 30일이다")
 });
 /** 실패 건 일괄 재전송 응답 — `POST /webhooks/{id}/deliveries/redeliver-failed` */
@@ -1194,7 +1269,11 @@ const webhookTestRequestSchema = z.object({ eventType: eventTypeSchema.describe(
 const webhookTestResultSchema = z.object({
 	responseStatusCode: z.number().int().nullable().describe("수신 서버의 HTTP 응답 코드. 연결 실패·타임아웃·차단이면 null"),
 	responseTimeMs: z.number().int().nullable().describe("응답 시간(ms). 연결 실패면 null"),
-	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("실패 사유. 2xx 응답이면 null")
+	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("실패 사유. 2xx 응답이면 null"),
+	failureReason: webhookFailureReasonSchema.nullable().describe("실패 원인 분류. 2xx 응답이면 null"),
+	responseBodyExcerpt: z.string().nullable().describe("응답 본문 앞부분(최대 4,096자). 규칙은 전송 기록의 `responseBodyExcerpt`와 같다. 응답이 없으면 null"),
+	requestHeaders: z.array(webhookRequestHeaderSchema).describe("보낸 요청 헤더. 서명 헤더는 이름만 주고 값은 null이다"),
+	payload: z.string().describe("보낸 요청 본문 그대로(JSON 문자열). 샘플 이벤트다")
 });
 const webhookRequestSchema = z.object({
 	url: z.url().startsWith("https://", "웹훅 URL은 HTTPS만 허용됩니다"),
@@ -1488,6 +1567,42 @@ const paymentRecordStatusSchema = z.enum([
 	"FAILED"
 ]);
 const paymentAttemptStatusSchema = z.string().describe("시도 상태 — ready·approving·approved·unknown·declined·prepare_failed·canceled·failed·abandoned·voided. 새 값이 추가될 수 있으니 모르는 값은 '진행 중이 아닌 시도'로 다룬다");
+/**
+* 현금영수증 상태 — 값이 추가될 수 있어 응답은 문자열로 받는다. 화면 분기는 이 목록으로 하고 모르는 값은 처리 중으로 다룬다.
+* - `REQUESTED`: 구매자가 신청했고 결제 승인 전이다
+* - `PENDING`: 발급·취소를 기다린다(승인 직후, 또는 일시 오류로 자동 재시도 대기)
+* - `ISSUED`: 발급됐다. 부분 환불이 있었으면 그만큼 취소(또는 재발급)된 금액이다
+* - `CANCELED`: 전액 환불로 취소됐다
+* - `FAILED`: 발급·취소가 실패했고 자동 재시도가 끝났다. `failCode`·`failMessage`를 보고 재발급한다
+* - `SKIPPED`: 발급 대상이 아니다(승인된 결제수단이 계좌이체·가상계좌가 아님)
+*/
+const CASH_RECEIPT_STATUS_VALUES = [
+	"REQUESTED",
+	"PENDING",
+	"ISSUED",
+	"CANCELED",
+	"FAILED",
+	"SKIPPED"
+];
+const cashReceiptSchema = z.object({
+	cashReceiptId: z.string(),
+	status: z.string().describe("상태. `REQUESTED` 결제 전 · `PENDING` 발급 대기 · `ISSUED` 발급 · `CANCELED` 취소 · `FAILED` 실패 · `SKIPPED` 발급 대상 아님. 값이 추가될 수 있다"),
+	type: z.string().describe("용도. `INCOME_DEDUCTION` 소득공제 · `EXPENSE_PROOF` 지출증빙"),
+	identityType: z.string().describe("식별 번호 종류. `PHONE` 휴대폰 · `CARD` 현금영수증카드 · `BUSINESS` 사업자등록번호"),
+	identityNumberMasked: z.string().describe("가린 식별 번호 (예: 010****5678). 원문은 조회할 수 없다"),
+	amount: z.number().int().describe("발급해야 할 금액 = 결제 금액 − 환불 완료 금액. 승인 전에는 결제 금액"),
+	issuedAmount: z.number().int().describe("PG에 현재 발급돼 있는 금액. 취소됐거나 발급 전이면 0"),
+	provider: pgProviderSchema.nullable().describe("발급 PG — 결제를 승인한 PG. 승인 전에는 null"),
+	issueNumber: z.string().nullable().describe("현금영수증 승인 번호"),
+	receiptUrl: z.string().nullable().describe("현금영수증 확인 주소"),
+	issuedAt: z.string().nullable().describe("최근 발급 시각 (ISO 8601)"),
+	canceledAt: z.string().nullable().describe("최근 취소 시각 (ISO 8601)"),
+	failCode: z.string().nullable().describe("마지막 실패 코드. 성공하면 비운다"),
+	failMessage: z.string().nullable().describe("마지막 실패 사유"),
+	reissuable: z.boolean().describe("콘솔 재발급으로 다시 시도할 수 있는가 (`FAILED`·`PENDING`)"),
+	requestedAt: z.string().describe("신청 시각 (ISO 8601)"),
+	updatedAt: z.string().describe("마지막 변경 시각 (ISO 8601)")
+});
 const paymentRecordSchema = z.object({
 	paymentId: z.string().describe("결제 건 id. 상세 조회 키"),
 	orderId: z.string().nullable().describe("승인돼 만들어진 주문. 승인 전에 끝난 결제는 null"),
@@ -1507,7 +1622,8 @@ const paymentRecordSchema = z.object({
 	failCode: z.string().nullable().describe("실패 코드. 실패로 끝난 결제만"),
 	failMessage: z.string().nullable().describe("실패 사유"),
 	paidAt: z.string().nullable().describe("승인 시각 (ISO 8601)"),
-	createdAt: z.string().describe("결제 시작 시각 (ISO 8601)")
+	createdAt: z.string().describe("결제 시작 시각 (ISO 8601)"),
+	cashReceiptStatus: z.string().nullable().optional().default(null).describe("현금영수증 상태(`cashReceiptSchema.status`와 같은 값). 신청이 없으면 null. 서버는 항상 싣는다")
 });
 const paymentRecordPageSchema = pageSchema(paymentRecordSchema);
 const paymentAttemptRecordSchema = z.object({
@@ -1541,7 +1657,8 @@ const paymentRecordDetailSchema = paymentRecordSchema.extend({
 	refundableAmount: z.number().int().describe("환불 가능 잔액 = 승인 금액 - 환불 완료 금액"),
 	merchantId: z.string().nullable().describe("가맹점 식별자 지문 (토스 clientKey, 포트원 Store ID). 비밀 값은 없다"),
 	attempts: z.array(paymentAttemptRecordSchema).describe("시도 이력. 순번 오름차순"),
-	refunds: z.array(paymentRefundRecordSchema).describe("환불 이력. 실패한 요청도 남는다")
+	refunds: z.array(paymentRefundRecordSchema).describe("환불 이력. 실패한 요청도 남는다"),
+	cashReceipt: cashReceiptSchema.nullable().optional().default(null).describe("현금영수증. 구매자가 신청하지 않았으면 null. 서버는 항상 싣는다")
 });
 /** `GET /v1/payments` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
 const paymentListQuerySchema = z.object({
@@ -1630,7 +1747,8 @@ const orderSchema = z.object({
 		deliveryFee: z.number().int(),
 		discountAmount: z.number().int(),
 		totalAmount: z.number().int(),
-		paidAt: z.string().nullable()
+		paidAt: z.string().nullable(),
+		cashReceipt: cashReceiptSchema.nullable().optional().default(null).describe("현금영수증. 구매자가 계좌이체·가상계좌 결제에서 신청했을 때만 있고 그 밖에는 null. 서버는 항상 싣는다")
 	}),
 	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요"),
 	items: z.array(orderItemSchema)
@@ -1677,7 +1795,14 @@ const dispatchRequestSchema = z.object({
 	deliveryMethod: deliveryMethodSchema,
 	carrierCode: z.string().optional(),
 	trackingNumber: z.string().optional(),
-	dispatchedAt: z.string().optional()
+	/**
+	* 발송 시각. ISO 8601이고 시간대(`Z` 또는 `+09:00`)를 포함해야 한다. 생략하면 현재 시각이다.
+	*
+	* 전에는 `z.string()`이라 아무 문자열이나 그대로 저장됐다. 이 값은 배송 정보 jsonb에 들어가
+	* 자동 배송완료·추적 동기화 잡의 대상 선별 조건이 된다 — 잘못된 한 행이 스토어 구분 없이 도는
+	* 잡 전체를 멈출 수 있어 입력에서 좁혔다. 검증을 통과한 값도 저장 전에 UTC ISO로 정규화한다.
+	*/
+	dispatchedAt: z.iso.datetime({ offset: true }).optional()
 }).refine((value) => value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING" ? true : !!value.carrierCode && !!value.trackingNumber, { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" });
 const deliveryInfoSchema = z.object({
 	orderItemId: z.string(),
@@ -1694,12 +1819,26 @@ const deliveryInfoSchema = z.object({
 	dispatchedAt: z.string(),
 	deliveredAt: z.string().nullable()
 });
+/**
+* 택배 추적 단계. 응답에서는 문자열로 받는다(값이 추가될 수 있다) — 현재 값은 `ACCEPTED`(접수)·`IN_TRANSIT`(이동 중)·
+* `OUT_FOR_DELIVERY`(배송 출발)·`DELIVERED`(배송완료)다.
+*/
+const trackingStageResponseSchema = z.string();
 /** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
-const deliveryStatusSchema = deliveryInfoSchema.extend({ trackingEvents: z.array(z.object({
-	status: z.string(),
-	location: z.string(),
-	occurredAt: z.string()
-})).optional() });
+const deliveryStatusSchema = deliveryInfoSchema.extend({
+	trackingEvents: z.array(z.object({
+		status: z.string().describe("택배사가 알려 준 처리 내용(예: 집화처리, 배송출발)"),
+		location: z.string().describe("처리 장소. 모르면 빈 문자열"),
+		occurredAt: z.string(),
+		stage: trackingStageResponseSchema.nullable().optional().default(null).describe("이 이벤트의 추적 단계. 배달 실패처럼 단계로 나눌 수 없는 이벤트는 null. 서버는 항상 싣는다. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다")
+	})).optional().describe("배송 추적 이력. 시각 오름차순(오래된 것부터)"),
+	tracking: z.object({
+		result: z.string().nullable().describe("마지막 추적 조회 결과. 조회에 성공한 적이 없으면 null. 현재 값은 `FOUND`(조회됨)·`NOT_FOUND`(택배사 전산에 송장 없음)·`UNSUPPORTED_CARRIER`(추적을 지원하지 않는 택배사)이고 값이 추가될 수 있어 문자열로 받는다"),
+		stage: trackingStageResponseSchema.nullable().describe("현재 추적 단계. 조회되지 않았으면 null. 현재 값은 `ACCEPTED`·`IN_TRANSIT`·`OUT_FOR_DELIVERY`·`DELIVERED`이고 값이 추가될 수 있어 문자열로 받는다"),
+		checkedAt: z.string().nullable().describe("택배사에서 추적 정보를 마지막으로 받아 온 시각(ISO 8601)"),
+		carrierDeliveredAt: z.string().nullable().describe("택배사가 알려 준 배송완료 시각(ISO 8601). 추적으로 배송완료가 반영되면 주문상품의 `deliveredAt`은 반영 시각이라 이 값과 다를 수 있다")
+	}).nullable().optional().default(null).describe("택배 추적 요약. 택배 발송이 아니거나 추적을 쓰지 않으면 null. 추적이 배송완료면 주문상품이 자동으로 배송완료된다. 서버는 항상 싣는다")
+});
 /** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
 const trackingUpdateResultSchema = z.object({
 	orderItemId: z.string(),
@@ -1774,7 +1913,7 @@ const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())
 * 한 주문에 정책이 섞이면 **상품별로 계산한다**. 배송비 묶음도 상품 단위다(주문서·장바구니의
 * 배송비 합산과 같은 규칙: 같은 상품의 주문상품이 한 묶음이고 묶음마다 배송비가 붙는다).
 */
-const descriptions = {
+const descriptions$1 = {
 	preShipmentDeliveryFeeRefund: "발송 전 취소로 배송 묶음(같은 상품의 주문상품)이 모두 취소되면 그 묶음의 배송비를 환불한다. false면 배송비를 환불하지 않는다. 기본 true",
 	returnDeliveryFee: "단순 변심(구매자 귀책) 반품의 반품 배송비. 원 단위. 환불액에서 뺀다. 기본 0(무료). 상품별 정책에서 이 값을 주면 상품의 `returnFee`도 같은 값으로 맞춘다",
 	exchangeDeliveryFee: "단순 변심(구매자 귀책) 교환의 교환 배송비. 원 단위. 구매자에게 청구할 금액을 안내값으로 싣는다. 기본 0(무료). 상품별 정책에서 이 값을 주면 상품의 `exchangeFee`도 같은 값으로 맞춘다",
@@ -1783,11 +1922,11 @@ const descriptions = {
 };
 /** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
 const refundPolicySchema = z.object({
-	preShipmentDeliveryFeeRefund: z.boolean().describe(descriptions.preShipmentDeliveryFeeRefund),
-	returnDeliveryFee: z.number().int().min(0).describe(descriptions.returnDeliveryFee),
-	exchangeDeliveryFee: z.number().int().min(0).describe(descriptions.exchangeDeliveryFee),
-	sellerFaultFreeShipping: z.boolean().describe(descriptions.sellerFaultFreeShipping),
-	conditionalFreeShortfallCharge: z.boolean().describe(descriptions.conditionalFreeShortfallCharge)
+	preShipmentDeliveryFeeRefund: z.boolean().describe(descriptions$1.preShipmentDeliveryFeeRefund),
+	returnDeliveryFee: z.number().int().min(0).describe(descriptions$1.returnDeliveryFee),
+	exchangeDeliveryFee: z.number().int().min(0).describe(descriptions$1.exchangeDeliveryFee),
+	sellerFaultFreeShipping: z.boolean().describe(descriptions$1.sellerFaultFreeShipping),
+	conditionalFreeShortfallCharge: z.boolean().describe(descriptions$1.conditionalFreeShortfallCharge)
 });
 /**
 * 스토어가 정하지 않았을 때 서버가 쓰는 값.
@@ -1809,11 +1948,11 @@ const REFUND_POLICY_DEFAULTS = {
 * 믿는데 정책은 기본값으로 남는다.
 */
 const refundPolicyPatchSchema = z.strictObject({
-	preShipmentDeliveryFeeRefund: z.boolean().optional().describe(descriptions.preShipmentDeliveryFeeRefund),
-	returnDeliveryFee: z.number().int().min(0).optional().describe(descriptions.returnDeliveryFee),
-	exchangeDeliveryFee: z.number().int().min(0).optional().describe(descriptions.exchangeDeliveryFee),
-	sellerFaultFreeShipping: z.boolean().optional().describe(descriptions.sellerFaultFreeShipping),
-	conditionalFreeShortfallCharge: z.boolean().optional().describe(descriptions.conditionalFreeShortfallCharge)
+	preShipmentDeliveryFeeRefund: z.boolean().optional().describe(descriptions$1.preShipmentDeliveryFeeRefund),
+	returnDeliveryFee: z.number().int().min(0).optional().describe(descriptions$1.returnDeliveryFee),
+	exchangeDeliveryFee: z.number().int().min(0).optional().describe(descriptions$1.exchangeDeliveryFee),
+	sellerFaultFreeShipping: z.boolean().optional().describe(descriptions$1.sellerFaultFreeShipping),
+	conditionalFreeShortfallCharge: z.boolean().optional().describe(descriptions$1.conditionalFreeShortfallCharge)
 });
 /**
 * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
@@ -2161,6 +2300,21 @@ const variantStockSchema = z.object({
 	variantId: z.string(),
 	stockQuantity: z.number().int()
 });
+/**
+* 출고지·반품지 지정 문구 — POST·PUT·PATCH가 같은 규칙을 쓰므로 설명도 한 곳이다 (이슈 #30).
+*
+* 세 값이 뜻이 다르다. **생략**은 「정하지 않음」이라 서버가 그 시점 스토어 기본 주소를 박아 저장하고,
+* **null**은 「스토어 기본을 따른다」는 명시적 비우기다. 주소록 항목은 상품이 참조 중이면 지울 수 없어
+* (`409 ADDRESS_IN_USE`) 참조를 푸는 수단이 필요한데, 생략을 기본값으로 되채우면 기본 주소는 영원히
+* 풀리지 않는다 — null이 그 경로다. 배송 묶음 판정은 null을 그 시점 스토어 기본 출고지로 정규화하므로
+* 두 표현이 배송비를 갈라놓지 않는다.
+*/
+const ADDRESS_DESCRIPTIONS = {
+	shipping: "출고지 주소 id(`GET /v1/seller-addresses?type=SHIPPING`). 생략하면 스토어 기본 출고지를 저장하고, `null`이면 비워 둔다(스토어 기본 출고지를 따른다). 이 스토어의 `SHIPPING` 주소가 아니면 거부한다",
+	return: "반품지 주소 id(`GET /v1/seller-addresses?type=RETURN`). 생략하면 스토어 기본 반품지를 저장하고, `null`이면 비워 둔다(스토어 기본 반품지를 따른다). 이 스토어의 `RETURN` 주소가 아니면 거부한다",
+	patchShipping: "출고지 주소 id. **생략은 바꾸지 않음**이고 `null`은 비우기다(스토어 기본 출고지를 따른다). 이 스토어의 `SHIPPING` 주소가 아니면 거부한다",
+	patchReturn: "반품지 주소 id. **생략은 바꾸지 않음**이고 `null`은 비우기다(스토어 기본 반품지를 따른다). 이 스토어의 `RETURN` 주소가 아니면 거부한다"
+};
 const productCreateRequestSchema = z.object({
 	name: z.string().min(1).max(100),
 	categoryId: z.string().min(1, "카테고리를 선택해주세요"),
@@ -2178,19 +2332,21 @@ const productCreateRequestSchema = z.object({
 		value: z.string()
 	})).optional(),
 	deliveryType: deliveryTypeSchema.default("PAID").describe("배송비 유형. FREE 무료, PAID 유료, CONDITIONAL_FREE 조건부 무료"),
-	deliveryFee: z.number().int().default(0).describe("배송비. 원 단위"),
+	deliveryFee: z.number().int().min(0).optional().describe("배송비. 원 단위. **생략하면 스토어 기본 배송비**(`GET /v1/store`의 `shippingPolicy.baseDeliveryFee`)를 쓴다. `deliveryType`이 FREE면 0으로 저장한다"),
 	conditionalFreeAmount: z.number().int().optional().describe("CONDITIONAL_FREE일 때 무료 배송이 되는 주문 금액. 원 단위"),
 	returnFee: z.number().int().default(0).describe("반품 배송비. 원 단위. `refundPolicy.returnDeliveryFee`와 같은 값이다"),
 	exchangeFee: z.number().int().default(0).describe("교환 배송비. 원 단위. `refundPolicy.exchangeDeliveryFee`와 같은 값이다"),
 	refundPolicy: refundPolicyPatchSchema.nullish().describe("상품별 환불 정책 — 준 항목만 스토어 기본을 덮어쓴다. `null`이나 생략은 스토어 기본을 그대로 쓴다는 뜻이다. `returnDeliveryFee`·`exchangeDeliveryFee`를 주면 `returnFee`·`exchangeFee`도 같은 값으로 맞춘다"),
-	shippingAddressId: z.string().optional(),
-	returnAddressId: z.string().optional()
+	shippingAddressId: z.string().nullable().optional().describe(ADDRESS_DESCRIPTIONS.shipping),
+	returnAddressId: z.string().nullable().optional().describe(ADDRESS_DESCRIPTIONS.return)
 }).extend(optionModelRequestSchema.shape);
 const productPatchRequestSchema = z.object({
 	name: z.string().max(100).optional(),
 	salePrice: z.number().int().multipleOf(10).optional(),
 	status: productStatusSchema.optional(),
-	deliveryFee: z.number().int().optional()
+	deliveryFee: z.number().int().optional(),
+	shippingAddressId: z.string().nullable().optional().describe(ADDRESS_DESCRIPTIONS.patchShipping),
+	returnAddressId: z.string().nullable().optional().describe(ADDRESS_DESCRIPTIONS.patchReturn)
 }).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
 const productSortSchema = z.enum([
 	"createdAt.desc",
@@ -2223,6 +2379,441 @@ const discountRequestSchema = z.object({
 	endAt: z.string().optional()
 });
 //#endregion
+//#region src/schemas/shipping-policy.ts
+/**
+* 배송비 규칙 (이슈 #29) — 배송비를 **몇 번, 얼마나** 부과하는지를 정한다.
+*
+* 세 축이다.
+* 1. **배송 묶음**: 같은 출고지 + 같은 배송 정책인 주문상품은 한 묶음이고 배송비가 한 번만 붙는다
+*    (`deliveryBundleKeyOf`). 이슈 #25의 「묶음 = 같은 상품」 규칙을 일반화한 것이다 — 키를 상품 id에서
+*    정책 지문으로 바꿨고, 주문상품이 주문 시점 키를 스냅샷해(`order_items.delivery_bundle_key`)
+*    환불 정산(`refund-settlement.ts`)과 주문 스냅샷(`orders.delivery_fee_settlements`)이 같은 키를 쓴다.
+* 2. **무료 기준**: 상품별 조건부 무료(`CONDITIONAL_FREE`, 묶음 소계 기준)와 스토어 전체 무료 기준
+*    (`freeThreshold`, 주문 상품 금액 합 기준)이 있다. 둘 중 하나라도 충족하면 그 배송비는 0이다.
+* 3. **지역 추가 배송비**: 우편번호가 제주·도서산간이면 **묶음마다** 추가된다. 묶음이 곧 한 번의 발송이라
+*    두 출고지에서 각각 보내면 추가 운임도 두 번 든다.
+*
+* 지역 추가 배송비는 **무료배송과 무관하게 부과한다.** 무료 기준은 셀러가 기본 운임을 부담하겠다는
+* 뜻이지, 도서 지역 추가 운임까지 부담하겠다는 뜻은 아니다(국내 택배사 공통 관행).
+*
+* 계산은 `quoteDelivery` 하나다. 장바구니·주문서·결제 시작·환불 정산이 모두 이 함수를 쓴다 —
+* 네 곳이 각자 계산하면 화면 금액과 결제 금액이 갈라진다.
+*/
+const descriptions = {
+	baseDeliveryFee: "스토어 기본 배송비. 원 단위. 상품 등록·수정에서 `deliveryFee`를 생략하면 이 값을 쓴다. 기본 3000",
+	freeThreshold: "스토어 전체 무료배송 기준액. 주문 상품 금액 합이 이 값 이상이면 모든 묶음의 배송비가 0이다. null이면 전체 무료배송을 쓰지 않는다(상품별 조건부 무료는 그대로 동작한다). 기본 null",
+	jejuSurcharge: "제주 지역 추가 배송비. 원 단위. **배송 묶음마다** 더한다. 기본 0",
+	isolatedSurcharge: "도서산간 지역 추가 배송비. 원 단위. **배송 묶음마다** 더한다. 기본 0"
+};
+/** 유효 배송비 정책 — 스토어가 정하지 않은 항목은 `SHIPPING_POLICY_DEFAULTS`로 채운 값이다 */
+const shippingPolicySchema = z.object({
+	baseDeliveryFee: z.number().int().min(0).describe(descriptions.baseDeliveryFee),
+	freeThreshold: z.number().int().min(1).nullable().describe(descriptions.freeThreshold),
+	jejuSurcharge: z.number().int().min(0).describe(descriptions.jejuSurcharge),
+	isolatedSurcharge: z.number().int().min(0).describe(descriptions.isolatedSurcharge)
+});
+/**
+* 스토어가 정하지 않았을 때 서버가 쓰는 값.
+*
+* `as const`가 아니라 `ShippingPolicy`로 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
+* `null` 자리에 숫자를 넣을 수 없다(`REFUND_POLICY_DEFAULTS`와 같은 이유).
+*/
+const SHIPPING_POLICY_DEFAULTS = {
+	baseDeliveryFee: 3e3,
+	freeThreshold: null,
+	jejuSurcharge: 0,
+	isolatedSurcharge: 0
+};
+/**
+* 부분 정책 — `PATCH /v1/store`의 `shippingPolicy`가 쓴다. 준 항목만 바뀐다.
+*
+* `strictObject`라 모르는 키는 400이다. 오타를 조용히 무시하면 셀러는 저장됐다고 믿는데
+* 정책은 기본값으로 남는다(`refundPolicyPatchSchema`와 같은 이유).
+*/
+const shippingPolicyPatchSchema = z.strictObject({
+	baseDeliveryFee: z.number().int().min(0).optional().describe(descriptions.baseDeliveryFee),
+	freeThreshold: z.number().int().min(1).nullable().optional().describe(descriptions.freeThreshold),
+	jejuSurcharge: z.number().int().min(0).optional().describe(descriptions.jejuSurcharge),
+	isolatedSurcharge: z.number().int().min(0).optional().describe(descriptions.isolatedSurcharge)
+});
+/** 유효 정책 해석 — 스토어가 정한 항목 + `SHIPPING_POLICY_DEFAULTS` */
+function resolveShippingPolicy(patch) {
+	if (!patch) return { ...SHIPPING_POLICY_DEFAULTS };
+	const given = Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== void 0));
+	return {
+		...SHIPPING_POLICY_DEFAULTS,
+		...given
+	};
+}
+/** 지역 구분 — 우편번호로 판정한다 */
+const remoteAreaSchema = z.enum([
+	"NONE",
+	"JEJU",
+	"ISOLATED"
+]);
+/**
+* 제주·도서산간 우편번호 범위 — **코드 상수다.** 금액은 스토어가 정하고 범위는 플랫폼이 고정한다.
+*
+* 국내 택배사가 공표하는 제주·도서산간 할증 구간을 5자리 우편번호 범위로 옮긴 표다. 셀러마다
+* 범위가 다르면 같은 주소에 다른 금액이 나가고 CS가 셀러 수만큼 갈라진다. 스토어별 범위 편집은
+* 후속 과제이고, 지금은 이 표가 유일한 원천이다.
+*
+* ## 근거
+*
+* 원천은 **CJ대한통운이 공표한 「제주 및 도서산간 지역 추가 운송비」 표**(구간 시작·끝 우편번호와
+* 지역명이 붙은 그 표)다. 같은 표가 한진택배 공지와 쇼핑몰 솔루션 안내에도 같은 값으로 실린다.
+* 서로 다른 게시자의 전재본 네 곳이 인천·전남·경남 구간까지 글자 그대로 일치하는 것을 확인했다.
+*
+* - CJ대한통운 표 전재 (구간별 금액 포함): https://ichibanhouse.com/article/공지뉴스/1/16/
+* - 같은 표의 다른 전재본: https://peppytail.com/article/공지사항/1/4046/
+* - 시행 시점(2020-02-01)과 구간별 행정구역명을 함께 적은 전재본:
+*   https://tosstoss.co.kr/bbs/content.php?co_id=pilotage
+* - 솔루션 안내 「제주도 및 도서산간 지역 기준표」:
+*   https://help.campaignus.me/ko/articles/제주도-및-도서산간-지역-기준표-342d2e5e
+*
+* 라벨의 행정구역명은 우편번호 배정을 따로 확인해 고쳤다. 택배사 표의 지역명은 축약·오기가 있다.
+* 확인한 것만 남기고, 확인하지 못한 구간은 이 표에서 뺀다 — 판정하지 못하면 받지 않는 쪽이
+* `remoteAreaOf`의 규칙과 같다.
+*
+* ## 표에서 뺀 구간
+*
+* - **54000**: 택배사 표는 「경남 통영 섬지역3」으로 적었지만 이 번호는 **전북 군산시 옥도면**이다.
+*   게다가 공정거래위원회가 2025-10-07 발표에서 연륙교로 이어진 신시도·야미도·선유도와 비연륙
+*   도서(방축도·관리도)가 같은 우편번호를 쓰는 대표 사례로 이 지역을 들었다. 라벨도 부과 근거도
+*   확정하지 못해 뺀다.
+* - **강화군 본섬(23000~23003, 23011~23099)**: 택배사 표의 강화 할증 구간은 23004~23010
+*   (교동면·삼산면·서도면)뿐이다. 강화대교·초지대교로 이어진 본섬은 도선료가 없어 어느 택배사도
+*   할증하지 않는다. 「누락」이 아니라 대상이 아니다.
+*
+* ## 한계
+*
+* 우편번호 단위 판정은 한 번호 안에 연륙도서와 비연륙도서가 섞인 구간에서 과대 부과가 된다.
+* 공정위가 2025-10-07에 온라인몰 13곳의 이 방식을 시정하게 한 지적이 그것이다
+* (https://eiec.kdi.re.kr/policy/materialView.do?num=272070). 아래 구간 중 33411(보령 오천면,
+* 원산도가 해저터널로 연결), 46768~46771(강서구 가덕도, 거가대교로 연결)이 그런 혼재 구간이다.
+* 도로명주소·건물관리번호 단위 판정은 후속 과제다.
+*
+* 범위는 **닫힌 구간**(`from` ≤ zip ≤ `to`)이고 겹치지 않는다. 앞에서부터 처음 맞는 항목을 쓴다.
+* 순서는 콘솔 「추가 배송비 지역」 표의 행 순서이기도 하다(`remoteAreaGroups`). 제주를 먼저 두고
+* 도서산간은 우편번호 오름차순으로 둔다.
+*/
+const REMOTE_AREA_ZIP_RANGES = [
+	{
+		area: "JEJU",
+		from: 63e3,
+		to: 63644,
+		label: "제주특별자치도"
+	},
+	{
+		area: "ISOLATED",
+		from: 22386,
+		to: 22388,
+		label: "인천 영종구 무의동"
+	},
+	{
+		area: "ISOLATED",
+		from: 23004,
+		to: 23010,
+		label: "인천 강화군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 23100,
+		to: 23116,
+		label: "인천 옹진군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 23124,
+		to: 23136,
+		label: "인천 옹진군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 31708,
+		to: 31708,
+		label: "충남 당진시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 32133,
+		to: 32133,
+		label: "충남 태안군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 33411,
+		to: 33411,
+		label: "충남 보령시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 40200,
+		to: 40240,
+		label: "경북 울릉군"
+	},
+	{
+		area: "ISOLATED",
+		from: 46768,
+		to: 46771,
+		label: "부산 강서구 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 52570,
+		to: 52571,
+		label: "경남 사천시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 53031,
+		to: 53033,
+		label: "경남 통영시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 53089,
+		to: 53104,
+		label: "경남 통영시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 56347,
+		to: 56349,
+		label: "전북 부안군 위도면"
+	},
+	{
+		area: "ISOLATED",
+		from: 57068,
+		to: 57069,
+		label: "전남 영광군 낙월면"
+	},
+	{
+		area: "ISOLATED",
+		from: 58760,
+		to: 58762,
+		label: "전남 목포시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 58800,
+		to: 58810,
+		label: "전남 신안군"
+	},
+	{
+		area: "ISOLATED",
+		from: 58816,
+		to: 58818,
+		label: "전남 신안군"
+	},
+	{
+		area: "ISOLATED",
+		from: 58826,
+		to: 58826,
+		label: "전남 신안군"
+	},
+	{
+		area: "ISOLATED",
+		from: 58828,
+		to: 58866,
+		label: "전남 신안군"
+	},
+	{
+		area: "ISOLATED",
+		from: 58953,
+		to: 58958,
+		label: "전남 진도군 조도면"
+	},
+	{
+		area: "ISOLATED",
+		from: 59102,
+		to: 59103,
+		label: "전남 완도군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59106,
+		to: 59106,
+		label: "전남 완도군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59127,
+		to: 59127,
+		label: "전남 완도군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59129,
+		to: 59129,
+		label: "전남 완도군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59137,
+		to: 59166,
+		label: "전남 완도군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59421,
+		to: 59421,
+		label: "전남 보성군 장도"
+	},
+	{
+		area: "ISOLATED",
+		from: 59531,
+		to: 59531,
+		label: "전남 고흥군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59551,
+		to: 59551,
+		label: "전남 고흥군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59563,
+		to: 59563,
+		label: "전남 고흥군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59568,
+		to: 59568,
+		label: "전남 고흥군 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59650,
+		to: 59650,
+		label: "전남 여수시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59766,
+		to: 59766,
+		label: "전남 여수시 도서"
+	},
+	{
+		area: "ISOLATED",
+		from: 59781,
+		to: 59790,
+		label: "전남 여수시 도서"
+	}
+];
+/**
+* 우편번호 → 지역 구분. 5자리 숫자가 아니면 `NONE`이다.
+*
+* 형식 검증은 배송지 스키마(`/^[0-9]{5}$/`)가 하고, 여기서는 **판정하지 못하면 추가 배송비를 받지 않는다**.
+* 반대로 두면 우편번호를 잘못 넣은 주문에 근거 없는 금액이 붙는다.
+*/
+function remoteAreaOf(zipCode) {
+	if (!zipCode || !/^[0-9]{5}$/.test(zipCode)) return "NONE";
+	const zip = Number.parseInt(zipCode, 10);
+	for (const range of REMOTE_AREA_ZIP_RANGES) if (zip >= range.from && zip <= range.to) return range.area;
+	return "NONE";
+}
+/** 지역 구분의 안내 이름 — 판정된 범위의 `label`이다. 판정되지 않으면 null */
+function remoteAreaLabelOf(zipCode) {
+	if (!zipCode || !/^[0-9]{5}$/.test(zipCode)) return null;
+	const zip = Number.parseInt(zipCode, 10);
+	return REMOTE_AREA_ZIP_RANGES.find((r) => zip >= r.from && zip <= r.to)?.label ?? null;
+}
+/** 묶음 하나에 붙는 지역 추가 배송비 */
+function remoteSurchargeOf(policy, area) {
+	if (area === "JEJU") return policy.jejuSurcharge;
+	if (area === "ISOLATED") return policy.isolatedSurcharge;
+	return 0;
+}
+/**
+* 배송 묶음 키 — **같은 출고지 + 같은 배송 정책이면 같은 키다.**
+*
+* 키는 주문 시점에 주문상품 행에 스냅샷된다(`order_items.delivery_bundle_key`). 셀러가 주문 뒤
+* 출고지나 배송비를 바꿔도 그 주문의 묶음은 움직이지 않는다 — 움직이면 이미 환불한 묶음의 키가
+* 달라져 `orders.delivery_fee_settlements`의 이중 환불 방지 표시가 무력해진다.
+*
+* `-`는 「값 없음」이다. 사람이 읽을 수 있게 남기고, 값 자체에 `:`가 들어갈 수 없는 형식만 쓴다
+* (주소 id는 `adr_…`, 나머지는 열거형·정수).
+*/
+function deliveryBundleKeyOf(product) {
+	const origin = product.shippingAddressId ?? "-";
+	const threshold = product.deliveryType === "CONDITIONAL_FREE" ? product.conditionalFreeAmount ?? 0 : "-";
+	const fee = product.deliveryType === "FREE" ? 0 : product.deliveryFee;
+	return `b:${origin}:${product.deliveryType}:${fee}:${threshold}`;
+}
+/**
+* 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
+*
+* 환불 정산이 근거를 구분해야 한다. 조건부 무료 기준 미달 차감은 **상품별 조건부 무료(`CONDITIONAL`)로
+* 면제된 묶음만** 대상이다. 스토어 전체 무료 기준(`STORE_THRESHOLD`)이나 무료배송 상품(`FREE`)은 셀러가
+* 배송비를 받지 않기로 한 것이므로, 일부 취소로 기준이 깨져도 구매자에게 배송비를 물리지 않는다.
+*
+* 세 값이 겹치면 `FREE` → `STORE_THRESHOLD` → `CONDITIONAL` 순으로 센 근거를 남긴다.
+*/
+const deliveryFeeWaiverSchema = z.enum([
+	"FREE",
+	"STORE_THRESHOLD",
+	"CONDITIONAL"
+]);
+/**
+* 배송비 계산 — **순수 함수다.** 장바구니 요약, 주문서 금액, 결제 시작의 최종 확정,
+* 주문 배송비 스냅샷이 모두 이 한 곳을 쓴다.
+*
+* 순서가 규칙이다. 묶음별 조건부 무료를 먼저 보고, 그다음 스토어 전체 무료 기준으로 기본 배송비를
+* 한꺼번에 0으로 만들고, 마지막에 지역 추가 배송비를 묶음마다 더한다. 추가 배송비는 무료 기준에
+* 걸리지 않는다.
+*/
+function quoteDelivery(input) {
+	const { policy } = input;
+	const area = remoteAreaOf(input.zipCode);
+	const surcharge = remoteSurchargeOf(policy, area);
+	const groups = /* @__PURE__ */ new Map();
+	let productAmount = 0;
+	for (const line of input.lines) {
+		const product = input.productOf(line.productId);
+		if (!product) continue;
+		productAmount += line.amount;
+		const key = deliveryBundleKeyOf(product);
+		const group = groups.get(key) ?? {
+			product,
+			ids: /* @__PURE__ */ new Set(),
+			sum: 0
+		};
+		group.ids.add(line.productId);
+		group.sum += line.amount;
+		groups.set(key, group);
+	}
+	const freeByThreshold = policy.freeThreshold !== null && productAmount >= policy.freeThreshold && groups.size > 0;
+	const bundles = [];
+	for (const [bundleKey, group] of groups) {
+		const { product } = group;
+		const freeThreshold = product.deliveryType === "CONDITIONAL_FREE" && product.conditionalFreeAmount !== null ? product.conditionalFreeAmount ?? 0 : null;
+		const listFee = product.deliveryType === "FREE" ? 0 : product.deliveryFee;
+		const waivedBy = product.deliveryType === "FREE" ? "FREE" : freeByThreshold ? "STORE_THRESHOLD" : freeThreshold !== null && group.sum >= freeThreshold ? "CONDITIONAL" : null;
+		bundles.push({
+			bundleKey,
+			productIds: [...group.ids],
+			fee: waivedBy === null ? listFee : 0,
+			waivedBy,
+			listFee,
+			freeThreshold,
+			remoteSurcharge: surcharge
+		});
+	}
+	const baseFee = bundles.reduce((sum, b) => sum + b.fee, 0);
+	const remoteSurcharge = bundles.reduce((sum, b) => sum + b.remoteSurcharge, 0);
+	return {
+		bundles,
+		baseFee,
+		remoteSurcharge,
+		deliveryFee: baseFee + remoteSurcharge,
+		remoteArea: area,
+		freeByThreshold
+	};
+}
+//#endregion
 //#region src/schemas/store.ts
 /**
 * 스토어 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
@@ -2322,6 +2913,7 @@ const updateStoreRequestSchema = z.object({
 	autoDeliverDays: z.number().int().min(0).max(30).optional().describe(autoDeliverDaysDescription),
 	autoConfirmDays: z.number().int().min(0).max(30).optional().describe(autoConfirmDaysDescription),
 	refundPolicy: refundPolicyPatchSchema.optional().describe("스토어 기본 환불 정책 — 준 항목만 바꾼다. 상품별 정책(`products.refundPolicy`)이 없는 상품에 적용된다"),
+	shippingPolicy: shippingPolicyPatchSchema.optional().describe("스토어 배송비 규칙 — 준 항목만 바꾼다. 기본 배송비, 전체 무료배송 기준액, 제주·도서산간 추가 배송비다. 바꾼 값은 **새 주문서부터** 적용된다(이미 만든 주문서·주문의 배송비는 스냅샷이 원천이다)"),
 	termsVersion: policyVersionSchema.optional().describe("이용약관 버전. 올리면 이 약관에 동의한 구매자에게 재동의를 요구한다(`GET /storefront/v1/me`의 `reconsentRequired`)"),
 	privacyVersion: policyVersionSchema.optional().describe("개인정보 수집이용 동의 버전. 올리면 구매자에게 재동의를 요구한다"),
 	termsUrl: policyDocumentUrlSchema.optional().describe("이용약관 문서 주소(https). 동의 시점의 값이 동의 이력에 복사된다. `null`을 주면 지운다"),
@@ -2346,6 +2938,7 @@ const storeSchema = z.object({
 	autoDeliverDays: z.number().int().describe(autoDeliverDaysDescription),
 	autoConfirmDays: z.number().int().describe(autoConfirmDaysDescription),
 	refundPolicy: refundPolicySchema.describe("스토어 기본 환불 정책. 스토어가 정하지 않은 항목은 플랫폼 기본값으로 채워 항상 전부 싣는다"),
+	shippingPolicy: shippingPolicySchema.describe("스토어 배송비 규칙. 스토어가 정하지 않은 항목은 플랫폼 기본값으로 채워 항상 전부 싣는다"),
 	termsVersion: z.string().describe("현재 이용약관 버전. 가입·재동의가 이 값으로 이력에 남는다"),
 	privacyVersion: z.string().describe("현재 개인정보 수집이용 동의 버전"),
 	termsVersionUpdatedAt: z.string().nullable().describe("이용약관 버전을 마지막으로 바꾼 시각. 바꾼 적이 없으면 null"),
@@ -2614,7 +3207,12 @@ function createStoreClient(options) {
 			* 그 밖의 값은 400 `INVALID_PARAMETER`. 행마다 `testPayment`가 붙는다.
 			*/
 			list: (params) => storeHttp.request("GET", "/orders", pageSchema(orderSummarySchema), { query: params }),
-			get: (orderId) => storeHttp.request("GET", path`/orders/${orderId}`, orderSchema)
+			get: (orderId) => storeHttp.request("GET", path`/orders/${orderId}`, orderSchema),
+			/**
+			* `POST /v1/orders/{orderId}/cash-receipt/reissue` — 실패했거나 재시도 대기 중인 현금영수증을 지금 다시 발급·취소한다.
+			* 콘솔 OWNER·ADMIN 전용(PAT·M2M 403 `INSUFFICIENT_ROLE`). 404 `CASH_RECEIPT_NOT_FOUND`, 409 `CASH_RECEIPT_NOT_REISSUABLE`
+			*/
+			reissueCashReceipt: (orderId) => storeHttp.request("POST", path`/orders/${orderId}/cash-receipt/reissue`, cashReceiptSchema)
 		},
 		orderItems: {
 			/** `GET /v1/order-items`. `testPayment` 필터는 `orders.list`와 같다 */
@@ -2857,6 +3455,12 @@ get: (params) => storeHttp.request("GET", "/sales-report", salesReportSchema, {
 			/** 전송 기록 (최신 적재순, 기본 50건·최대 100건, 보관 30일) */
 			listDeliveries: (webhookId, params) => storeHttp.request("GET", path`/webhooks/${webhookId}/deliveries`, z.array(webhookDeliverySchema), { query: params }),
 			/**
+			* 전송 기록 한 건의 상세. 목록 항목에 보낸 요청 본문(최대 16KB)과 요청 헤더가 더해진다.
+			* 실패 원인 분류(`failureReason`)·응답 본문(`responseBodyExcerpt`)으로 원인을 찾고,
+			* `resource.id`를 API 로그 조회의 `q`로 넘겨 같은 리소스의 API 요청과 맞춰 본다.
+			*/
+			getDelivery: (webhookId, deliveryId) => storeHttp.request("GET", path`/webhooks/${webhookId}/deliveries/${deliveryId}`, webhookDeliveryDetailSchema),
+			/**
 			* FAILED 전송 기록 한 건을 같은 eventId로 다시 보낸다(202). 새로 적재된 기록을 돌려주며
 			* `redeliveryOf`가 원본 deliveryId다. 원본이 FAILED가 아니면 409 `DELIVERY_NOT_FAILED`,
 			* 원본이 이미 재전송됐으면 409 `DELIVERY_ALREADY_REDELIVERED`(원본당 1회, 원본의 `redeliveredAs` 참고),
@@ -3296,4 +3900,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { ApiError, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, RESERVED_STORE_CODES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, resolveRefundPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookRedeliverFailedResultSchema, webhookRequestSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };
+export { ApiError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };