fix(카페24): 옵션 팝업에서 추가한 옵션값이 저장 후 사라지는 버그

- 원인: 카페24 PUT options 는 옵션값 추가를 지원하지 않음(문서). 끝에 덧붙여 보내면
  오류 없이 무시되는데 화면은 "반영했습니다"로 표시하고 다시 읽으면 사라짐
- 기존 옵션에 새 행이 있으면 「저장」이 확인창을 거쳐 옵션 재생성(DELETE → POST →
  자체코드·추가금액·진열/판매·썸네일 재반영)으로 저장. 품목코드는 새로 부여됨
- 서버 build_update_options_request: 옵션값 개수 증가를 400 으로 거부(재생성 안내),
  덧붙이기 경로(allow_append·wait_for_variants·added) 제거
- 테스트·문서 갱신, cafe24-options.js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-06 16:45:36 +09:00
parent ab6c243ab7
commit e385b38885
8 changed files with 48 additions and 99 deletions
+13 -24
View File
@@ -7,9 +7,9 @@
옵션이 없는 상품: 행을 자유롭게 추가/삭제해 두고 저장하면 옵션 생성(POST options,
카페24가 품목을 자동 생성) → 부여된 품목코드를 받아 → 자체코드/추가금액을 품목에
PUT → 썸네일이 있으면 옵션 PUT. 저장 뒤 다시 읽어 품목코드가 바로 보인다.
품목 추가: 「+ 행 추가」로 넣은 행은 저장 시 옵션값을 **뒤에 덧붙여** PUT 한다
(앞쪽 위치는 그대로라 기존 이름이 밀리지 않는다). 카페24가 품목을 자동 생성하면
그 코드로 자체코드/추가금액을 이어서 PUT 한다. 거부하면 오류를 그대로 보여준다.
품목 추가: 카페24 PUT options 는 옵션값 추가를 지원하지 않는다(덧붙여 보내면 오류 없이
무시되어 저장 후 사라졌다 — 2026-11-06). 「+ 행 추가」·불러오기로 넣은 새 행이 있으면
「저장」이 확인창을 거쳐 「옵션 재생성」으로 반영한다(품목코드 새로 부여).
품목 삭제: 행의 ✕ → DELETE /variants/{code} (문서에 있는 유일한 제거 수단). 옵션값
자체는 남을 수 있어(품목 없는 옵션값) 하단에 따로 보여주고, 정리는 「옵션 재생성」
(전체 삭제 → 현재 행으로 다시 생성 → 코드/금액/썸네일 재반영, 품목코드가 바뀜)으로.
@@ -417,7 +417,7 @@
html += '<p class="cf24-side-note cf24-u-note">' +
(isNew
? "저장하면 옵션(조합형)을 만들고 카페24가 품목을 자동 생성합니다. 부여된 품목코드를 받아 자체 품목코드·추가금액·썸네일까지 함께 반영합니다."
: "「+ 행 추가」한 값은 저장 시 옵션값 끝에 덧붙여 품목을 만듭니다. ✕ 는 품목을 바로 삭제합니다. " +
: "「+ 행 추가」한 값은 카페24 API 가 옵션값 추가를 지원하지 않아 저장 시 「옵션 재생성」으로 반영합니다(품목코드 새로 부여). ✕ 는 품목을 바로 삭제합니다. " +
(canDrag ? "행을 드래그하면 품목 진열순서로 저장됩니다. " : "") +
"썸네일은 표시방식이 「미리보기(이미지)」일 때 쇼핑몰에 보입니다.") +
"</p>" +
@@ -780,6 +780,12 @@
function saveUnified(isNew, tbody, msg) {
var rows = collectUnified(tbody);
// 카페24 PUT options 는 옵션값 추가를 지원하지 않는다(덧붙여 보내면 오류 없이 무시 → 저장 후 사라짐).
// 새 행이 있으면 유일한 방법인 옵션 재생성(삭제 후 다시 등록)으로 넘긴다.
if (!isNew && rows.some(function (r) { return r.isNew; })) {
rebuildFlow(tbody, msg, "카페24 API 는 기존 옵션에 옵션값 추가를 지원하지 않아, 추가한 행을 저장하려면 옵션을 재생성해야 합니다.\n\n");
return;
}
var problem = validateNames(rows);
if (problem) { window.erpAlert(problem); return; }
var optName = body.querySelector('[name="option_name"]').value.trim();
@@ -803,11 +809,6 @@
if (r.text !== ov.option_text || r.image !== (ov.option_image_file || "") || r.link !== (ov.option_link_image || "")) optionsChanged = true;
return { option_text: r.text, option_image_file: r.image, option_link_image: r.link, option_color: ov.option_color || "" };
});
var newRows = rows.filter(function (r) { return r.isNew; });
newRows.forEach(function (r) {
edited.push({ option_text: r.text, option_image_file: r.image, option_link_image: r.link, option_color: "" });
optionsChanged = true;
});
var orderChanged = tbody.classList.contains("is-order-dirty");
var patches = [];
rows.forEach(function (r) {
@@ -818,7 +819,7 @@
if (!optionsChanged && !patches.length) { setMsg(msg, "바뀐 값이 없습니다.", ""); return; }
var lines = [];
if (optionsChanged) lines.push("옵션명·옵션값 이름/썸네일/표시방식" + (newRows.length ? " (+ 옵션값 " + newRows.length + "개 추가 → 품목 생성)" : ""));
if (optionsChanged) lines.push("옵션명·옵션값 이름/썸네일/표시방식");
if (patches.length) lines.push("품목 " + patches.length + "건 (자체코드·추가금액·진열/판매" + (orderChanged ? "·순서" : "") + ")");
window.erpConfirm("카페24에 바로 반영합니다. 계속할까요?\n\n- " + lines.join("\n- ")).then(function (ok) {
if (!ok) return;
@@ -833,18 +834,6 @@
}).then(function (data) {
state.option = data.option;
if (data.variants) state.variants = data.variants;
if (newRows.length) {
// 새 품목코드를 이름으로 짝지어 자체코드·추가금액·진열/판매 패치를 만든다
var map = codesByValue(state.variants);
var missing = 0;
newRows.forEach(function (r) {
var code = map[norm(r.text)];
if (!code) { missing++; return; }
var p = newRowPatch(r, code);
if (p) patches.push(p);
});
if (missing) setMsg(msg, "옵션값은 추가됐지만 품목 " + missing + "건은 카페24 품목 조회가 늦어 자체코드/추가금액을 넣지 못했습니다 — 저장 후 다시 시도하세요.", "is-err");
}
});
});
}
@@ -930,7 +919,7 @@
}
// 옵션 재생성 — 전체 삭제 후 현재 행(이름·코드·금액·진열/판매·썸네일)으로 다시 만든다.
function rebuildFlow(tbody, msg) {
function rebuildFlow(tbody, msg, intro) {
var rows = collectUnified(tbody);
var problem = validateNames(rows.map(function (r) { return { text: r.text, isNew: false }; }));
if (problem) { window.erpAlert(problem); return; }
@@ -939,7 +928,7 @@
if (!optName) { window.erpAlert("옵션명을 입력하세요."); return; }
var saveBtn = body.querySelector("#cf24-u-save");
var orphanNote = state.orphans.length ? "\n- 품목 없는 옵션값 " + state.orphans.length + "개는 사라집니다." : "";
window.erpConfirm("옵션을 전부 지우고 현재 " + rows.length + "행으로 다시 만듭니다.\n\n- 모든 품목코드가 새로 부여됩니다(주문 이력·외부 연동이 품목코드를 참조하면 영향).\n- 재고 수량은 초기화될 수 있습니다." + orphanNote + "\n\n되돌릴 수 없습니다. 계속할까요?")
window.erpConfirm((intro || "") + "옵션을 전부 지우고 현재 " + rows.length + "행으로 다시 만듭니다.\n\n- 모든 품목코드가 새로 부여됩니다(주문 이력·외부 연동이 품목코드를 참조하면 영향).\n- 재고 수량은 초기화될 수 있습니다." + orphanNote + "\n\n되돌릴 수 없습니다. 계속할까요?")
.then(function (ok) { if (ok) createFromRows(rows, optName, optType, saveBtn, msg, true); });
}