기초 상품 옵션 매칭 컬럼

원가만 올려서는 마진이 나오지 않습니다. 판매된 옵션 하나가 어떤 기초 상품 몇 개로 이루어져 있는지까지 알려주셔야 그 옵션의 원가가 계산됩니다. 이 페이지는 그 연결 정보를 API로 직접 보내실 때 채워야 하는 항목을 안내합니다.

API로 보내는 방법은 고객사 쪽 개발이 필요합니다. 개발 없이 넣으실 수 있는 방법이 두 가지 더 있으니, 아래 중 편한 쪽을 고르시면 됩니다.

• 화면에서 직접 연결하기: [데이터 관리] → [마진율] → [판매 상품 옵션 - 기초 상품 연결]

• 템플릿 파일로 한 번에 올리기: 같은 화면에서 템플릿을 내려받아 채운 뒤 업로드 (자세히 보기)

• API로 직접 보내기: 이 페이지

이 데이터는 스프레드시트 연결로는 넣으실 수 없습니다.

연결보다 원가가 먼저입니다. 여기서 보내신 기초 상품 브랜드명 · 기초 상품번호 · 기초 상품명이 기초 상품 관리에 등록되어 있지 않으면, 보내신 연결은 접수되더라도 연결 목록에 나타나지 않습니다. 마진만 비는 것이 아니라 연결 자체가 없는 것으로 보이므로, 기초 상품 등록을 먼저 마치신 뒤 보내 주세요.

건을 구분하는 기준 (식별 키)

브랜드 + 판매 채널 + 상품번호 + 상품명 + 옵션코드 + 옵션정보 + 기초 상품 브랜드명 + 기초 상품번호 + 기초 상품명

아홉 개가 모두 키입니다. 앞의 여섯 개가 판매된 옵션을 가리키고, 뒤의 세 개가 거기에 들어가는 기초 상품을 가리킵니다.

기초 상품 쪽 세 항목까지 키에 들어가는 이유는, 옵션 하나에 기초 상품이 여러 개 들어가는 것이 정상이기 때문입니다. "도시락 세트" 옵션이 김밥과 제육볶음으로 이루어진 경우가 그렇습니다. 이 세 항목이 키가 아니면 김밥 행과 제육볶음 행이 같은 건으로 취급되어, 나중에 보낸 하나만 남고 나머지 구성품은 사라집니다.

아홉 항목이 모두 같은 값을 다시 보내시면 나중에 보낸 값이 최종값이 됩니다. 수량만 바꾸실 때는 나머지 여덟 항목을 그대로 두고 다시 보내 주세요.

한 옵션은 한 가지 방법으로만 넣어 주세요. 아홉 항목은 보내주신 데이터 안에서 건을 나누는 기준입니다. 그다음 단계에서 라플라스는 옵션 쪽 여섯 항목을 기준으로 넣으신 방법 하나만 채택합니다.

맨 위에 소개한 세 가지 방법 중 직접 입력(화면 연결·템플릿 업로드)과 이 API 는 서로 다른 방법으로 셉니다. 같은 옵션을 양쪽으로 넣으시면 한쪽의 구성품만 쓰이고 다른 쪽은 통째로 밀립니다. 두 쪽이 섞여 합쳐지지는 않으니, 구성품이 빠져 보인다면 같은 옵션을 두 방법으로 넣지 않았는지 확인해 주세요.

항목 목록 (11개)

사은품 여부를 뺀 열 개가 필수이고, 그중 아홉 개가 위의 식별 키입니다.

화면 표기	타입	필수	상수 입력
브랜드	문자	필수 (식별 키)	불가
판매 채널	문자	필수 (식별 키)	불가
상품번호	문자	필수 (식별 키)	불가
상품명	문자	필수 (식별 키)	불가
옵션코드	문자	필수 (식별 키)	불가
옵션정보	문자	필수 (식별 키)	불가
기초 상품 브랜드명	문자	필수 (식별 키)	불가
기초 상품번호	문자	필수 (식별 키)	불가
기초 상품명	문자	필수 (식별 키)	불가
기초 상품 수량	정수	필수	가능
사은품 여부	문자	-	가능

기초 상품 수량은 이 옵션 1개에 들어가는 기초 상품 개수이고, 사은품 여부는 사은품이면 Y, 아니면 비워 두시면 됩니다. 식별 키 아홉 개에 무슨 값을 넣어야 하는지는 아래 앞의 여섯 항목은 주문 데이터와 글자까지 같아야 합니다 절에 적었습니다.

API로 직접 보내실 때의 컬럼명입니다. 화면 표기와 짝지어 두었습니다.

브랜드 brand_name · 판매 채널 channel_name · 상품번호 product_id · 상품명 product_name · 옵션코드 option_id · 옵션정보 option_name · 기초 상품 브랜드명 item_brand_name · 기초 상품번호 item_id · 기초 상품명 item_name · 기초 상품 수량 item_qty · 사은품 여부 is_gift

기초 상품 수량이 비어 있으면 함께 보내신 데이터가 전부 저장되지 않습니다.

한 번에 보내신 데이터 묶음을 배치라고 부릅니다. 수량이 비어 있으면 원가를 몇 배 해야 할지 정할 수 없기 때문에, 그 행만 빼고 저장하지 않고 배치 전체를 되돌립니다. 999개가 멀쩡해도 한 행 때문에 1,000개가 모두 저장되지 않습니다.

되돌아간 데이터는 시간이 지나도 저절로 들어오지 않습니다. 수량을 채워 다시 보내 주셔야 저장됩니다.

수량에 음수를 보내시면 저장은 되지만 그 행은 연결에 쓰이지 않습니다. 오류가 표시되지 않고 해당 옵션의 마진만 비어 보이므로, 보내시기 전에 수량이 0 이상인지 확인해 주세요.

사은품 여부에는 대소문자 구분 없이 Y 또는 1을 넣으시면 사은품으로 처리됩니다. 그 밖의 값과 빈 값은 모두 사은품이 아닌 것으로 봅니다.

앞의 여섯 항목은 주문 데이터와 글자까지 같아야 합니다

브랜드 · 판매 채널 · 상품번호 · 상품명 · 옵션코드 · 옵션정보는 이미 라플라스에 들어와 있는 주문 데이터의 같은 값과 정확히 일치해야 연결됩니다. 띄어쓰기, 특수문자, 철자가 하나라도 다르면 다른 옵션으로 보고 연결되지 않습니다.

여섯 항목이 틀렸을 때 증상은 두 갈래입니다.

• 상품번호 · 상품명 · 옵션코드 · 옵션정보가 틀리면 그 옵션 하나만 연결되지 않습니다.

• 브랜드 · 판매 채널이 틀리면, 라플라스는 이 두 항목으로 먼저 판매처를 찾습니다. 찾지 못하면 그 판매처로 보내신 매칭이 한꺼번에 연결되지 않습니다. 한두 건이 아니라 보내신 묶음 전체가 비어 보인다면 이 두 항목부터 확인해 주세요.

라플라스 푸드  ≠  라플라스푸드
라플라스(도시락)  ≠  라플라스_도시락

기초 상품 브랜드명 · 기초 상품번호 · 기초 상품명 세 항목도 마찬가지로 기초 상품 관리에 등록하신 값과 정확히 같아야 합니다.

보내실 값이 확실하지 않으시면, [데이터 관리] → [마진율] → [판매 상품 옵션 - 기초 상품 연결] 화면에서 현재 옵션 목록을 내려받아 그 값을 그대로 쓰시는 것이 가장 안전합니다.

옵션 하나에 기초 상품 여러 개 넣기

구성품 하나가 한 행입니다. "도시락 세트" 옵션이 김밥 20개와 제육볶음 10개로 이루어져 있다면 두 행을 보내시면 됩니다.

상품명	옵션정보	기초 상품명	기초 상품 수량
DELICIOUS 도시락 SET	김밥 20개, 제육볶음 10개	김밥	20
DELICIOUS 도시락 SET	김밥 20개, 제육볶음 10개	제육볶음	10

두 행은 옵션 쪽 여섯 항목이 같고 기초 상품 쪽 세 항목만 다르므로, 서로 다른 건으로 남아 옵션 하나에 구성품 두 개가 연결됩니다.

결제금액은 원가 비중에 따라 구성품별로 나뉩니다. 계산 방식은 옵션 ↔ 기초 상품(SKU) 연결에서 확인해 주세요.

위 두 행을 실제로 보낼 때의 예시 (개발자용)

{"_insert_id": "rel-1", "data": {"brand_name": "라플라스푸드", "channel_name": "쿠팡", "product_id": "P-1001", "product_name": "DELICIOUS 도시락 SET", "option_id": "OPT-01", "option_name": "김밥 20개, 제육볶음 10개", "item_brand_name": "라플라스푸드", "item_id": "SKU-KIMBAP", "item_name": "김밥", "item_qty": 20}}
{"_insert_id": "rel-2", "data": {"brand_name": "라플라스푸드", "channel_name": "쿠팡", "product_id": "P-1001", "product_name": "DELICIOUS 도시락 SET", "option_id": "OPT-01", "option_name": "김밥 20개, 제육볶음 10개", "item_brand_name": "라플라스푸드", "item_id": "SKU-JEYUK", "item_name": "제육볶음", "item_qty": 10}}

요청 주소, 헤더, 본문 형식은 Push API 연결에 정리되어 있습니다.

구성품을 빼실 때는 같은 행을 다시 보내는 방법으로 지워지지 않습니다. API에는 삭제 요청이 따로 없습니다.

API로 보내신 연결은 [판매 상품 옵션 - 기초 상품 연결] 화면에서 수정하셔도 반영되지 않을 수 있습니다. 같은 옵션에 화면 연결과 API 연결이 함께 있으면 한쪽만 쓰이는데, 이때 API 쪽이 쓰일 수 있기 때문입니다. API로 보내신 연결을 끊거나 바꾸셔야 할 때는 전담 매니저에게 요청해 주세요. 화면에서 직접 넣으신 연결은 화면에서 수정하시면 됩니다.

값이 바뀔 때

상품명이나 옵션정보가 바뀌는 경우

상품번호는 그대로인데 상품명만 바뀌는 일이 있습니다. 매칭 키에 상품명이 들어 있으므로 라플라스는 이것을 다른 옵션으로 봅니다. 주문 데이터를 다시 보내실 때 상품명을 어느 시점의 값으로 보내시는지에 따라 하실 일이 갈립니다.

주문 당시의 값으로 보내는 경우. 과거 주문은 그대로 연결되어 있습니다. 새 이름으로 들어오는 주문분에 대해 같은 구성으로 한 행 더 보내 주시면 됩니다.

주문	주문 데이터의 상품명	보내실 매칭
이름 바뀌기 전	DELICIOUS 도시락 SET	기존 행을 그대로 둡니다
이름 바뀐 뒤	DELICIOUS 도시락 세트	같은 구성으로 한 행 추가

기존 행을 지우시면 이름 바뀌기 전 주문의 원가가 사라집니다. 옛 이름 행은 옛 주문에만 쓰이고 새 주문에는 걸리지 않으므로, 이름이 바뀔 때마다 행이 쌓이는 것이 정상입니다.

현재 값으로 보내는 경우. 과거 주문의 상품명까지 새 이름으로 바뀝니다. 새 이름 기준 매칭을 보내시기 전까지는 그 주문들의 원가가 비어 보이므로, 상품명을 바꾸실 때 매칭도 함께 보내 주세요.

옵션정보가 바뀌는 경우도 규칙이 같습니다. 상품번호와 옵션코드가 그대로라고 해서 연결이 따라오지는 않습니다.

연결할 기초 상품을 바꾸는 경우

옵션에 연결한 기초 상품을 다른 기초 상품으로 바꾸려고 새 기초 상품으로 다시 보내시면, 기존 연결은 지워지지 않고 새 연결이 추가됩니다. 기초 상품 쪽 세 항목도 식별 키이므로, 라플라스는 다시 보내신 행을 기존 행의 수정이 아니라 다른 구성품으로 봅니다.

보낸 순서	옵션정보	기초 상품명	기초 상품 수량
처음	김밥 20개	김밥	20
다시 보냄	김밥 20개	참치김밥	20

위처럼 보내시면 옵션 하나에 김밥과 참치김밥이 모두 연결되어, 원가가 두 기초 상품을 더한 값으로 계산됩니다. 오류는 표시되지 않고 마진만 실제보다 낮게 보입니다.

기초 상품을 바꾸셔야 할 때는 다시 보내지 마시고 전담 매니저에게 요청해 주세요. 수량이나 사은품 여부만 바꾸실 때는 아홉 항목을 그대로 두고 다시 보내시면 됩니다.

매칭에는 적용 시점이 없습니다

기초 상품 원가는 결제 날짜/시간을 함께 받아 기간별로 다른 원가를 적용합니다. 매칭은 그렇지 않습니다. 날짜 항목이 없고, 지금 등록된 상태 한 벌이 과거 주문까지 거슬러 적용됩니다.

그래서 "이번 달부터는 이 구성으로 바뀐다"를 매칭만으로 표현하실 수는 없습니다. 구성이 바뀌었는데 과거 주문은 옛 구성으로 남겨야 한다면, 옵션 쪽 여섯 항목 중 하나라도 달라져야 합니다.

보내기 전에 확인할 것

요청 주소, 인증 헤더, 압축 형식은 다른 데이터 종류와 같습니다. Push API 연결을 먼저 봐 주세요.

연결을 만드실 때 데이터 종류로 기초 상품 옵션 매칭을 골라 주세요. 데이터 종류마다 받는 항목이 다릅니다.

전담 매니저에게 요청하기

기초 상품 연결에 대해 더 궁금한 점이 있으신가요?

💬 채팅으로 문의하기

💬 홈페이지에서 문의하기

이메일 문의: [e-mail]