Search
Duplicate

Crossmall API 연동 가이드

API 연동이란?

스마트십 시스템이 쇼핑몰의 주문을 가져오고, 주문 확인 및 발송 처리를 원격으로 하기 위해서는 API 연결이 필요합니다. 본 문서는 Crossmall 서비스에 대한 API 연결 설정 방법을 설명합니다.
스마트십이 쇼핑몰의 API를 사용할 때에는 판매자의 접근 권한을 필요로 합니다. 접속 시에 판매자의 로그인 인증 정보를 스마트십이 직접 저장할 수는 없기에, ‘API 키’라는 별도로 인증된 정보를 입력해야 합니다. API 키는 쇼핑몰별로 ‘파트너 키’, ‘비밀 키’ 등의 이름으로 불리기도 합니다.
준비사항
Crossmall 서비스에 대한 API 연결 설정을 위해서는 다음의 정보가 필요합니다.
•
샵 ID : Crossmall 판매자 ID
•
Company Code : Crossmall 에서 확인(아래 가이드 참고)
•
Api Key : Crossmall 에서 발급(아래 가이드 참고)

스마트십에 Crossmall API 설정하기

1. Crossmall API KEY 발급받기

Crossmall 서비스에서는 다음과 같은 단계에 따라 API 키를 조회/발급할 수 있습니다.
1.
Crossmall 에 로그인 한 후, システム設定 > 基本情報 > 基本情報 메뉴로 진입합니다.
2.
페이지 하단에 [設定] 버튼을 눌러주세요
3.
페이지 하단에 API設定의 [表示] 버튼을 누르면 API KEY을 확인하실 수 있습니다. Crossmall에서 제공하는 API 옵션은 유료옵션이므로, API KEY가 확인되지 않는 경우 Crossmall로 문의해주세요. API 설정 중 IP항목이 0.0.0.0으로 입력된 경우 이용이 불가능하므로 올바른 IP를 입력해주세요.

2. 스마트십에 Crossmall API KEY 등록하기

경로 : 주문 > 쇼핑몰 연동 > 쇼핑몰 API 설정
다음과 같은 단계에 따라 API 연동 설정을 할 수 있습니다.
1.
쇼핑몰 API 설정 페이지에 진입하신 후, 우측 상단의 [+신규등록]을 선택해주세요.
2.
“Crossmall”를 선택한 후, 하단의 "쇼핑몰 연동 등록"으로 스크롤을 이동해주세요.
3.
API 연동 설정에 필요한 정보들을 입력하고 등록해주세요.
•
쇼핑몰 샵ID: Crossmall ID를 기재합니다.
•
Company Code : 1. Crossmall에서 API KEY 발급받기 에서システム設定 > 基本情報 > 基本情報 메뉴의 ‘ 会社コード ‘부분이 Company Code 입니다.
•
API Key : 1. Crossmall에서 API KEY 발급받기 에서 발급받은 API KEY를 입력합니다.
•
API 연결 설정 옵션도 선택해주세요. 자세한 내용은 아래에서 확인하실 수 있습니다.

API 연결 설정 옵션

API 연결 설정 시에 주문 및 상품 연동 동작의 세부 사항을 조절할 수 있는 옵션이 있습니다.
•
자동 주문 연동
•
자동 주문 확인
•
자동 풀필먼트 출하지시
•
자동 재고 동기화 설정

API 설정 정보 확인

API 연결 정보를 추가한 후에는 정상적인 통신이 가능한지 확인합니다.
•
[연결 테스트하기] 버튼을 클릭하여 정상 연결 여부를 확인합니다.

Crossmall 주문 연동 가능 상태값

Crossmall에서 발생한 신규 주문 중 “発送待機” 상태의 주문을 가져옵니다.
システム設定 ＞ 処理フェーズ 메뉴에서 ”QXPRESS発送済み” 상태를 추가해주세요. 다른 명칭의 값으로 작성되면 배송 상태 업데이트가 불가능하므로 참고 부탁드립니다.

Crossmall 판매 상품에 스마트십 SKU 연결하기

재고 동기화 및 풀필먼트 서비스를 이용하시려는 경우, Crossmall 판매 상품에 스마트십 SKU를 연결해주세요.
경로 : 스마트십 > 재고관리 > 쇼핑몰 주문 SKU 연결
1.
스마트십에서 Crossmall의 상품명과 스마트십의 SKU를 연결할 수 있습니다. 이때 입력하시는 상품명/옵션값은 띄어쓰기 대소문자를 비롯하여 텍스트를 동일하게 입력해주세요.
경로 : Crossmall Seller Shop > 出品処理 ＞商品一括処理＞＞商品を検索 ＞商品コード（標準）をクリック ＞ 商品情報
2.
Crossmall에서 발급한 상품번호를 입력해주세요.
3.
Crossmall에서 등록한 상품의 옵션명을 속성1과 속성2를 조합하여 넣어주세요. ex) ホワイト,Sサイズ