로그인
상품매핑

매핑

공개mappings

경로 · 상품 > 매핑 > 매핑

SKU에 채널상품코드를 연결하여 1)주문을 수집하고 2)재고를 자동으로 채널로 전송되도록 설정하는 화면입니다.


💡 핵심 기능

채널이 이미 등록된 코드를 MOMS에 매핑만 하여도 주문수집과 재고연동이 가능합니다.
✅ 그 연결고리가 "매핑"이며, 매핑된 MOMS SKU가 기준점이 됩니다.
SKU 1 : Mapping N 구조 — 한 SKU에 여러 채널 매핑 가능, 하나의 채널에도 여러 코드 설정 가능합니다.
✅우측 상단 내보내기버튼으로 현재 매핑 현황을 Excel/CSV로 추출할 수 있습니다.
대량 매핑은 매핑 일괄생성 메뉴에서 엑셀로 한 번에 처리할 수 있습니다.
✅ API 연동이 없는 채널은 주문등록시 SKU코드 입력하면 되므로, 매핑이 필요없습니다.

📌 사용자 흐름
1. 좌측에서 SKU 선택
2. 우측 상단에서 상품·연동 상태 확인
3. 우측 하단에서 매핑 추가/수정/삭제




🧷 매핑 화면

매핑 화면은 3분할 구조입니다.

영역

역할

1영역 : 좌측 패널

상품 리스트 : SKU 목록 + 매핑 진행도

2영역 : 우측 상단

상품 정보 : 선택한 SKU의 상품 정보 + 판매상태 + 재고연동

3영역 : 우측 하단

매핑영역 : 채널코드 매핑 목록 + 매핑 추가


[1영역] 상품 리스트

칼럼

설명

체크박스

매핑대기/매핑보류된 상품 일괄 재시도, 상품 체크 ➣Sync 아이콘

상품명

상품명

SKU

시스템 SKU

매핑 정보

SKU내에 매핑 진행도 ( 예시 : 0/0, 5/10, 10/10)

전체 : MOMS에 등록된 상품 전체
완료 : SKU코드가 매핑된 정보값이 모두 정상적으로 매핑완료 상태
미완료 : 매핑이 1개라도 미완료되어 있는 경우
💡 매핑이 빠져있거나 이상이 있는 경우 미완료 SKU를 빠르게 찾아 처리할 수 있습니다.



[2영역] 상품정보

항목

설명

타이틀

SKU + 상품명 함께 표기

판매상태

상품의 판매상태 판매중 / 품절
재고 수량과는 독립적으로 사용자가 수동 변경할 수 있습니다.

재고업데이트

판매 채널로 재고연동을 보낼지 말지 결정하는 상태 연동 / 연동해제
재고연동의 상태에 따라 재고 연동여부가 결정됩니다.

여기에서 재고업데이트를 연동해제 하면
3영역에서 개별설정된 재고연동도 일괄적으로 해제(설정값 무시)됩니다.

🖋️ 수정버튼

상품 정보 직접 수정 : 이곳에서 수정가능한 정보는 판매상태재고업데이트

저장 버튼

정보값 변경 후 저장

💡 여기서 변경한 판매상태, 재고연동 업데이트정보는 상품 관리의 Product 정보에도 그대로 업데이트 됩니다.


[3영역] 매핑영역

컬럼

설명

체크박스

선택 시 수정 활성화

채널

셀렉

채널상품코드

채널 상품코드 입력

채널옵션코드

채널 옵션코드 입력(선택)

재고연동

개별 값마다 연동 제어

매핑상태

매핑대기 / 매핑보류 / 매핑완료

재고상태

정상 / 불량

매핑 완료일자

매핑이 완료된 시간

🗑️휴지통 버튼

매핑 삭제







🧷 매핑 관리

Step 1. 매핑 상태 이해하기

💡매핑상태 (Mapping) : MOMS와 판매채널의 상품코드를 매핑한 상태, 매핑 후 주문수집과 재고연동이 활성화

상태 (EN)

상태 (KR)

의미

Pending

매핑대기

채널코드와 아직 매핑되지 않은 상태. 재고/판매상태 전송 없음

On hold

매핑보류

매핑 시도 시 검증 오류가 발생한 상태.

(채널상품코드, 채널옵션코드 재확인 필요)

Completed

매핑완료  

채널코드 매핑 정상 완료. 이 상태에서만 재고연동 활성화 할 수 있음

  • 매핑 상태 단계
    매핑대기→ 수정 → 검증 OK → 매핑완료
    매핑대기→ 수정 → 검증 오류 → 매핑보류

  • 재고연동 (Connection)
    ⚠️2영역인 상품정보에서 재고 업데이트 연동 해제 시
    매핑된 채널코드의 설정해 두었던 연동여부 값은 그대로 유지되지만(과거 이력 보존), 정보 업데이트는 모두 Stop됩니다.
    프론트에서는 사용자 인식을 위해 "읽기상태"로 변하며 엑스아이콘 처리됩니다.


Step 2. 매핑 추가

우측 하단의 매핑 추가 버튼으로 새 매핑을 등록합니다.

항목

입력 형식

*채널

셀렉

*채널상품코드

채널 상품코드 입력

채널옵션코드

채널 옵션코드 입력 (선택)

재고연동

개별 값마다 연동 제어

*재고상태

정상 / 불량

  • 저장 후 매핑은 자동으로 매핑대기) → 검증 → 매핑완료 또는 매핑보류로 전이됩니다.
    ⚠️매핑보류가 되는 경우 채널상품코드를 정상적으로 입력했는지 재확인 해주세요.

  • API 연동이 없는 채널은 주문등록시 SKU코드 입력하면 되므로, 매핑이 필요없습니다.

💡 매핑에 넣을 채널상품코드와 채널옵션코드는 아래 링크에서 확인할 수 있어요!


Step 3. 매핑 수정·삭제

동작

방법

결과

수정

체크박스 선택 → 셀 직접 편집

상태가 자동으로 매핑대기 전환 후 재검증

삭제

🗑️ 휴지통 아이콘

매핑 해제 (해당 채널 재고 동기화 중단)

⚠️ 운영 중인 매핑을 삭제하기 전 위 연동 해제 경고문을 반드시 확인하세요.



💾 저장

  1. 각 영역의 변경 사항은 우측 상단 저장버튼으로 저장됩니다.

  2. Product Detail 영역에서 변경한 판매상태·재고연동은 상품 관리의 Product 정보에도 즉시 업데이트됩니다.

  3. 매핑 영역에서 수정·삭제한 내역은 저장 시 자동으로 재검증이 진행됩니다.

  4. 대량 매핑은 매핑 일괄생성 화면에서 엑셀 템플릿으로 한 번에 처리할 수 있습니다.

  5. API 연동이 없는 채널은 주문등록시 SKU코드 입력하면 되므로, 매핑이 필요없습니다.

Q&A

이 문서의 자주 묻는 질문

[매핑] ●실패 메세지가 떴어요. 어떻게 처리하나요?

🏷️ 매핑 (Mapping) 실패메세지

에러 메시지

발생 사유

처리 방법

MappingCode is duplicated.

동일 MappingCode가 이미 존재

상품 목록에서 기존 SKU 확인.
신규 등록이면 다른 SKU 코드 사용

Supplier information registered withSupplierMappingCode does not exist:{공급사코드}

입력한 공급사 유효하지 않음

엑셀가이드에서 공급사코드 다시 찾아 입력

재고연동 상태가 '연동해제'로 표시되면 어떻게되나요?

재고연동 상태가 '연동해제(Disconnected)'로 되어있다면 해당 SKU는 채널로 재고 업데이트가 전송되지 않습니다.
재고연동을 하고싶으면 "재고연동"을 연동상태로 시도해주세요. (비행기 아이콘)
만약 "재고연동"을 시도했는데도 "연동보류"상태이면 실패메시지를 확인 하고 처리해주세요.


채널 매핑을 해야 하는 이유가 무엇인가요?

각 판매 채널의 상품·옵션 코드를 MOMS SKU와 연결해야, 채널에서 주문이 들어올 때 MOMS가 어떤 SKU인지 자동으로 인식합니다. 매핑이 없으면 주문등록 자체를 실패합니다.
매핑을 하면 주문수집과 재고연동을 모두 사용할 수 있습니다. 꼭 매핑을 진행해주세요!

채널상품코드와 채널옵션코드는 어디서 찾나요?

#채널매핑코드 찾기
여기 링크에 자세히 정리해놓았어요!

채널 코드를 잘못 입력했어요. 주문이 안 들어오나요?

채널코드와 채널옵션코드가 불일치하면 채널 주문 연동 시 MOMS가 SKU를 인식하지 못해 주문을 등록할 수 없는 이슈가 발생합니다. 코드를 수정 다시 진행하여 주문을 다시 수집해보세요. 참고로, 코드가 맞지않으면 당연히 재고연동도 동작하지않아요!

마지막 수정 · 2026. 7. 6.v78
MOMSMOMS
전체 매뉴얼·자주 묻는 질문·MOMS 앱 · mintoms@mxncommerce.com·© 2026 mxn commerce, inc.