매핑 일괄생성

경로 · 상품>매핑>매핑 일괄생성

여러 SKU의 채널 매핑을 한 번에 등록하는 화면입니다. 신규 채널 입점 시점 또는 대량 매핑 작업에 사용합니다.
엑셀 템플릿에 정보를 입력하고 파일을 업로드하여 쉽게 등록하세요.

💡 핵심 기능

✅ 템플릿 다운로드 → 양식 입력 → 업로드 → 검증 → 저장 의 3단계 흐름으로 진행합니다.
✅ 매핑할 SKU는 MOMS 시스템에 이미 등록되어 있어야합니다.
✅ 공급사, 채널, 브랜드 등의 일부정보는 코드화되어 있습니다. 엑셀 가이드를 확인해주세요.

💡템플릿 형식 : 템플릿을 다운받아 등록합니다.
💡엑셀 가이드 : 상단 우측 엑셀 가이드 버튼에서 채널·계정·채널상품코드 자릿수 규칙을 확인하세요.
💡 .xls / .xlsx 형식만 지원합니다.

📌사용자 흐름
1. 템플릿 다운로드
2. 엑셀 내용 작성
3. 파일을 업로드 → 자동 검증 → 결과 영역에서 결과 확인 → 우측 상단 Save 클릭

🧷 매핑 일괄생성

Step 1. 템플릿 다운로드

화면 중앙의 템플릿 다운로드 버튼을 클릭합니다.
⚠️여러 고객사를 관리하는 경우, 등록하려는 고객사를 꼭 선택하여주세요.

Step 2. 엑셀 작성

다운로드한 양식에 매핑 정보를 입력합니다. 필수 입력값은 * 표시되어 있습니다.

필수 컬럼	설명
*SKU	시스템에 이미 등록된 SKU
*채널ID	채널의 명칭, 가이드에서 확인
*채널상품코드	채널에서 발급된 상품단위 식별코드
*재고유형	`정상` 또는 `불량`
채널옵션코드	채널에서 발급된 상품>옵션단위 식별코드
재고연동	`Y`) / `N`

💡 채널 코드 아래 링크에서 가서 확인할 수 있어요!

💡채널별 매핑코드 찾기

Step 3. 업로드 후 저장

작성한 파일을 업로드 영역에 드래그&드롭하거나 엑셀 업로드 버튼으로 선택
자동 검증 → 결과 영역에서 결과 확인 → 우측 상단 Save 클릭
.xls / .xlsx 형식만 지원합니다. CSV는 업로드할 수 없습니다.

🔍 검증 결과

Step 1. 검증 단계

단계	검사 대상	결과로 분기
1. 무결성체크	파일 자체 문제 (데이터 중복, 필수값 누락 등)	파일실패 (A영역 X, B영역 O)
2. 유효성체크	정보값 오류	성공 / 부분실패 / 실패 (A영역 O, B영역 O)

Step 2. Result 표시

업로드 이력 (4가지 상태)

2025-11-13 14:30 | mapping_upload.xlsx | 성공 (성공 50)
2025-11-12 09:15 | mapping_upload.xls  | 부분실패 (실패 10 / 성공 100)
2025-11-12 09:15 | mapping_upload.xls  | 실패 (실패 100 / 성공 0)
2025-11-12 09:15 | mapping_upload.xls  | 파일실패 (파일 확인 필요)

행별 오류 예시

행   SKU                채널        오류 내용
2    SAMSUNG-S24-999    쿠팡        SKU가 MOMS에 존재하지 않습니다
15   LG-GRAM-17-001                  채널이 입력되지 않았습니다
5    SAMSUNG-S24-001    카페24      동일한 매핑이 이미 존재합니다
45   SONY-TV-001        쇼피파이    채널이 올바르지 않습니다

Step 3. 결과별 의미

표기	의미	조치
🟢 성공 (`성공 50`)	모든 행이 정상	일괄 저장
🟡 부분실패 (`실패 X / 성공 Y`)	일부 행만 실패	성공한 내역만 저장
🔴 실패 (`실패 X / 성공 0`)	전체 실패	엑셀 수정 후 재업로드
⚫ 파일실패 (`파일 확인 필요`)	파일 자체 문제 — A영역만 표기	파일 무결성 점검 후 재작성

❗자주 발생하는 오류

오류 메시지	원인	해결
SKU가 MOMS에 존재하지 않습니다	시스템에 없는 SKU	상품 일괄생성으로 SKU 먼저 등록 or 입력값수정
채널이 입력되지 않았습니다	채널 컬럼 누락	채널 코드 입력
채널이 올바르지 않습니다	채널 코드 오타 또는 미등록 채널	엑셀 가이드의 채널 코드 확인
동일한 매핑이 이미 존재합니다	같은 SKU + 같은 채널 + 같은 채널코드 조합으로 이미 매핑됨	기존 매핑 수정 또는 행 삭제 or 입력값수정
Condition 값이 올바르지 않습니다	`정상` / `불량`외의 값	정확한 값 입력

💾 저장

저장 시 성공한 내역만 생성됩니다.
저장 후에는 매핑 화면에서 새 매핑을 확인할 수 있고, 좌측 SKU 리스트의 매핑 정보 컬럼에 진행도(5/10, 10/10 등)가 갱신됩니다.
API 연동이 없는 채널은 주문등록시 SKU코드 입력하면 되므로, 매핑이 필요없습니다.