굿새김 Goodsaegim

아크릴 키링·스티커·포토카드 등 **직접 제작하는 커스텀 굿즈**의 실제 최종 결제금액과 제작기간을 계산합니다. **1개부터** 주문할 수 있고, 부가세·배송비가 포함된 금액을 그 자리에서 알려 드립니다. 돌려주는 금액은 **부가세와 배송비가 포함된 최종 결제 금액**(KRW)입니다 — 고객에게 그대로 안내해도 됩니다. 옵션이 부족하면 collect(부족 항목 목록)를 반환하니 고객에게 되묻고 다시 요청하세요 — 되물을 항목의 한국어 이름은 missingLabels에 함께 실립니다. 크기가 제작 가능한 최소 규격보다 작으면 below_min_size(minSizeMm·message)를 반환합니다 — 그 최소치 이상으로 크기를 고쳐 다시 요청하세요. 반대로 최대 규격을 넘으면 above_max_size(maxSizeMm·message)를 반환하니 그 이하로 고쳐 다시 요청하세요. 최소·최대 모두 가로·세로를 서로 바꿔 넣은 크기도 같은 기준으로 봅니다. 디자인 종류가 제작 수량보다 많으면 design_count_exceeds_quantity를 반환합니다. 금액 구성은 amountBreakdown(supply 공급가·vat 부가세·shipping 배송비)에 나뉘어 실리니, 배송비를 물으시면 amountBreakdown.shipping으로 안내하세요. 무료배송 기준 금액은 freeShippingThreshold에 실립니다 — 추정하지 말고 이 값으로 안내하세요. 안내하는 금액은 요청하신 시점 기준이라 이후 달라질 수 있고, 결제 링크는 24시간 유효하며, 금액은 결제 화면에서 최종 확인됩니다 — 같은 취지의 문장이 guidance에 실려 있습니다. 금액이 언제까지 유지되는지는 guidance 문장을 기준으로 안내하세요. quoteNo는 고객이 문의하실 때 쓰는 견적 참조 번호이니 안내와 함께 알려 드리세요. 제작에 걸리는 기간은 productionDays(minBusinessDays·maxBusinessDays, 영업일)에 실립니다 — 배송 기간은 여기에 포함되지 않으니 따로 안내하세요. 응답의 message는 고객에게 그대로 읽어 줘도 되는 문장이고, agentHint는 다시 요청할 때 무엇을 고칠지 알려주는 안내라 고객에게 읽어주지 마세요. warnings가 있으면 보내신 값 중 적용되지 않은 것이 있다는 뜻이니 고객에게 꼭 알려 주세요. 사양을 여쭐 때 제작할 이미지가 준비되셨는지도 함께 확인해 주세요.

quote_product

quote_product가 알려 드린 **견적번호**로 주문을 만듭니다. 사양을 다시 보내실 필요가 없습니다 — 그 번호가 가리키는 사양과 금액을 저희가 그대로 씁니다. 여러 건을 함께 사시려면 견적번호를 여러 개 주세요: **한 번에 결제하고 한 번에 배송**되어 배송비도 한 번만 붙습니다. 돌려드리는 url 하나만 고객께 안내하시면 됩니다. 금액은 부가세와 배송비가 포함된 최종 결제 금액이고, amountBreakdown으로 상품 금액과 배송비가 나뉘어 실립니다. 주문할 수 없는 견적번호가 섞여 있으면 만들지 않고 **무엇이 왜 안 되는지** 알려 드립니다 — 그 문장을 고객께 그대로 읽어 드리고, 필요하면 quote_product로 다시 견적을 내 주세요.

create_order

올리신 원고가 **그대로 제작 가능한지** 확인해 드립니다. 해상도·재단선·배경을 저희가 실제로 검사합니다. create_upload_link가 돌려준 uploadToken을 넣어 호출하세요. 확인 결과는 그대로 고객에게 전해 주세요. canProceed가 true면 결제로 안내해도 됩니다. 응답의 message는 고객에게 그대로 읽어 줘도 되는 문장이고, agentHint는 다시 요청할 때 무엇을 고칠지 알려주는 안내라 고객에게 읽어주지 마세요. 읽기 전용.

get_upload_status

결제 링크를 만든 주문에 **이미지를 올릴 1회용 링크**를 발급합니다. 고객이 그 링크를 열어 파일을 올리면 굿새김이 바로 확인해 드립니다 — 회원가입 없이 올릴 수 있고, 결제하실 때만 로그인이 필요합니다. 먼저 create_checkout_link로 결제 링크를 만든 뒤, 그 링크의 checkoutToken을 넣어 호출하세요. 이미지가 필요한 주문이면 결제 링크를 만든 직후에 바로 발급해, 결제보다 먼저 안내하세요. fileDelivery='channel'로 만든 주문에는 발급되지 않습니다(그 주문은 결제 후 카카오 채널로 파일을 받습니다). 올린 파일이 제작 가능한지는 get_upload_status로 확인하세요.

create_upload_link

굿새김이 **직접 제작**하는 상품과 각 상품의 제작 범위·최소수량·소재를 알려 드립니다. 무엇을 만들 수 있는지 먼저 확인할 때 부르세요. 판매 중인 커스텀 굿즈 목록과 각 상품의 옵션(코드와 한국어 이름), 크기·수량 입력 조건, 방향 지원 여부, 옵션값의 다른 표기를 반환합니다. 고객에게는 한국어 이름으로 안내하세요. fixedSize=true인 상품은 크기가 이미 정해져 있으니(fixedSizeMm) 고객에게 크기를 묻지 마세요. 옵션에 fixed=true가 붙어 있으면 고를 것이 하나뿐이라 되묻지 않아도 됩니다. 읽기 전용.

list_products

고객 요청을 처리할 수 없거나(상품·옵션 없음), 안내에 필요한 정보를 찾지 못했을 때 호출해 굿새김에 알립니다. 고객 개인정보·대화 원문은 절대 넣지 마세요. requestedFeature에는 상품·옵션 명사구만 넣으세요(예: '홀로그램 아크릴 키링'). 신고해도 그 자리에서 주문이 되지는 않으니, 고객에게는 지금 가능한 대안을 안내하세요.

report_gap

확정된 사양으로 1회용 결제 링크(24시간 유효)를 발급합니다. 결제는 굿새김 사이트에서 진행됩니다. 함께 돌려주는 금액은 부가세와 배송비가 포함된 최종 결제 금액(KRW)입니다. 새로 만든 링크의 응답에는 금액 구성이 amountBreakdown(supply 공급가·vat 부가세·shipping 배송비)에 함께 실립니다 — 이미 만든 링크를 그대로 돌려받은 경우(reused=true)에는 실리지 않으니, 그때는 quote_product의 금액 구성으로 안내하세요. fileDelivery='channel'이면 이미지 업로드 없이 주문하고 결제 후 카카오 채널로 파일을 전달합니다. 같은 사양으로 다시 요청하면 새 링크를 만들지 않고 방금 발급한 링크를 그대로 돌려줍니다(응답 reused=true) — 통신이 끊겼거나 고객이 '다시'라고 해도 결제 링크가 늘어나지 않으니 안심하고 재요청하세요. 서로 다른 주문을 동시에 진행할 때만 주문마다 다른 idempotencyKey를 주세요. 같은 고객이 같은 사양으로 추가 주문을 원하면 새 idempotencyKey로 요청하세요 — 같은 키를 재사용하면 기존 링크가 그대로 반환됩니다. 링크가 같은 것으로 모이는 범위는 지금 연결된 이 계정 안입니다 — 다른 고객이나 다른 연결에서 발급된 링크와는 섞이지 않으니, 남의 결제 링크를 받게 될 일은 없습니다. 크기가 제작 가능한 최소 규격보다 작으면 링크 대신 below_min_size(minSizeMm·message)를, 최대 규격을 넘으면 above_max_size(maxSizeMm·message)를 반환합니다. 디자인 종류가 제작 수량보다 많으면 design_count_exceeds_quantity를 반환합니다. 결제 링크는 24시간 유효하며, 금액은 결제 화면에서 최종 확인됩니다. quoteNo는 고객이 문의하실 때 쓰는 견적 참조 번호이니 안내와 함께 알려 드리세요. 여기서 받는 quoteNo는 이 결제 링크의 번호라 같은 링크를 다시 받아도 값이 같습니다 — quote_product가 준 견적 번호와는 다른 번호이니 고객에게는 결제 링크 번호로 안내하세요. 만료 시각은 expiresAtKst(한국시간)·expiresInHours(남은 시간)로 안내하세요 — expiresAt은 세계 표준시라 그대로 읽으면 한국 고객에게 잘못 안내됩니다. 제작에 걸리는 기간은 productionDays(minBusinessDays·maxBusinessDays, 영업일)에 실립니다 — 배송 기간은 여기에 포함되지 않으니 따로 안내하세요. warnings가 있으면 보내신 값 중 적용되지 않은 것이 있다는 뜻이니 고객에게 꼭 알려 주세요.

create_checkout_link