🔌 스위티푸드 거래처 Open API

사업자 회원이 자기 프로그램으로 발주를 등록하고, 발주·송장·상품·예치금·클레임을 조회할 수 있는 REST API 입니다. 키 발급은 내 계정 → API 연동 키에서.

서버 주소: https://www.sweetiefood.com

인증: 승인된 사업자 OAuth2 client_credentials · Bearer 토큰(30일)

응답: { success, message, data }

한도: 분당 300회 · 일 20,000회(초과 429) · 허용 IP 지정 가능

1) 토큰 발급

POST https://www.sweetiefood.com/api/v1/oauth/token
Content-Type: application/x-www-form-urlencoded

client_id=<Client ID>&client_secret=<Secret Key>

→ { "data": { "token_type":"Bearer", "access_token":"...", "expires_in":2592000 } }

2) 상품·단가 조회 (scope: product.read)

GET https://www.sweetiefood.com/api/v1/seller/products
Authorization: Bearer <access_token>

→ data.products[] = {
  product_code, name, price,   // price = 도매가, product_code는 기존 발주 코드
  mall_product_id, option_id, product_name, option_name,
  image, origin, description, shipping_fee
}
// 몰 연결 상품은 공개·판매 가능 상태이며 해당 거래처에 허용된 것만 반환합니다.
// 미연결 기존 단가표 상품은 유지되며 몰 상세 필드는 null일 수 있습니다.
// shipping_fee는 상품에 설정된 참고 배송비이며 API 주문 합계에 자동 가산되지 않습니다.
// 조회 실패는 HTTP 503입니다. 빈 목록으로 간주하지 말고 다시 조회하세요.

3) 상품 매칭 (scope: order.write)

POST https://www.sweetiefood.com/api/v1/seller/product_matches
Authorization: Bearer <access_token>
Content-Type: application/json

{ "matches": [
  { "match_string": "내 상품명", "products": [ { "product_code": "<code>", "qty": 1 } ] }
] }

// 이후 발주 때 product_string 으로 "내 상품명" 을 쓰면 자동 변환(1:N 가능)

4) 발주 등록 (scope: order.write)

POST https://www.sweetiefood.com/api/v1/seller/orders
Authorization: Bearer <access_token>
Content-Type: application/json

{ "orders": [ {
  "customer_order_code": "MYORDER-1001",     // 주문마다 고유(중복방지)
  "receiver_name": "홍길동",
  "receiver_hp": "01012345678",
  "receiver_addr1": "서울시 ...",           // 기본주소
  "receiver_addr2": "○○아파트 101동 1001호",  // 상세주소(동/호수) — 아파트는 꼭!
  "receiver_zipcode": "01234",
  "delivery_msg": "부재시 문앞",
  "items": [ { "product_code": "<code>", "qty": 2 } ]
                // 또는 { "product_string": "내 상품명", "qty": 2 }
} ] }

→ data.results[] = { customer_order_code, ok, order_key, total_amount }
한 요청 최대 100건 · 주문당 100품목 · 본문 최대 2MB
재요청은 같은 customer_order_code 사용 · order_key는 반환값 그대로 보관

5) 발주·송장 조회 (scope: order.read)

GET https://www.sweetiefood.com/api/v1/seller/orders?limit=100
Authorization: Bearer <access_token>

→ data.orders[] = { order_key, customer_order_code, source_order_no, status,
                    tracking_numbers[], courier, items[] }
   API·엑셀·관리자 등록 등 모든 경로의 내 주문을 반환합니다.
   source_order_no는 원 주문번호가 저장되지 않은 주문이면 null입니다.
   다음 페이지: ?cursor=<next_cursor>

6) 변경분 델타 조회 (scope: order.read)

GET https://www.sweetiefood.com/api/v1/seller/orders/changed?updated_since=2026-08-30T00:00:00
Authorization: Bearer <access_token>

→ 그 시각 이후 생성·발송된 주문만. next_cursor 로 이어받기(폴링에 적합)

7) 예치금 잔액 · 클레임

GET https://www.sweetiefood.com/api/v1/seller/balance          (scope: balance.read)
   → data.deposit_balance

GET https://www.sweetiefood.com/api/v1/seller/claims?claim_type=cancel   (scope: order.read)
   claim_type = cancel | return | exchange, updated_since=<datetime>
   → data.orders[] = { claim_no, claim_type, claim_status, order_code, refund_total_amount }

8) 발주 취소 요청 (scope: order.write)

POST https://www.sweetiefood.com/api/v1/seller/orders/cancel
Authorization: Bearer <access_token>
Content-Type: application/json

{ "source_order_no": "2026091972890291", "reason": "중복 발주" }
// source_order_no 대신 order_key 사용 가능

→ data = { claim_no, order_key, source_order_no, claim_status }
   취소는 접수 후 관리자가 발송·공급사 전달 여부를 확인하여 승인합니다.
   같은 요청을 다시 보내도 기존 접수 결과를 반환합니다.

🔌 스위티푸드 거래처 Open API

서버 주소: https://www.sweetiefood.com

인증: 승인된 사업자 OAuth2 client_credentials · Bearer 토큰(30일)

응답: { success, message, data }

한도: 분당 300회 · 일 20,000회(초과 429) · 허용 IP 지정 가능

POST https://www.sweetiefood.com/api/v1/oauth/token Content-Type: application/x-www-form-urlencoded client_id=<Client ID>&client_secret=<Secret Key> → { "data": { "token_type":"Bearer", "access_token":"...", "expires_in":2592000 } }

GET https://www.sweetiefood.com/api/v1/seller/products Authorization: Bearer <access_token> → data.products[] = { product_code, name, price, // price = 도매가, product_code는 기존 발주 코드 mall_product_id, option_id, product_name, option_name, image, origin, description, shipping_fee } // 몰 연결 상품은 공개·판매 가능 상태이며 해당 거래처에 허용된 것만 반환합니다. // 미연결 기존 단가표 상품은 유지되며 몰 상세 필드는 null일 수 있습니다. // shipping_fee는 상품에 설정된 참고 배송비이며 API 주문 합계에 자동 가산되지 않습니다. // 조회 실패는 HTTP 503입니다. 빈 목록으로 간주하지 말고 다시 조회하세요.

POST https://www.sweetiefood.com/api/v1/seller/product_matches Authorization: Bearer <access_token> Content-Type: application/json { "matches": [ { "match_string": "내 상품명", "products": [ { "product_code": "<code>", "qty": 1 } ] } ] } // 이후 발주 때 product_string 으로 "내 상품명" 을 쓰면 자동 변환(1:N 가능)

POST https://www.sweetiefood.com/api/v1/seller/orders Authorization: Bearer <access_token> Content-Type: application/json { "orders": [ { "customer_order_code": "MYORDER-1001", // 주문마다 고유(중복방지) "receiver_name": "홍길동", "receiver_hp": "01012345678", "receiver_addr1": "서울시 ...", // 기본주소 "receiver_addr2": "○○아파트 101동 1001호", // 상세주소(동/호수) — 아파트는 꼭! "receiver_zipcode": "01234", "delivery_msg": "부재시 문앞", "items": [ { "product_code": "<code>", "qty": 2 } ] // 또는 { "product_string": "내 상품명", "qty": 2 } } ] } → data.results[] = { customer_order_code, ok, order_key, total_amount } 한 요청 최대 100건 · 주문당 100품목 · 본문 최대 2MB 재요청은 같은 customer_order_code 사용 · order_key는 반환값 그대로 보관

GET https://www.sweetiefood.com/api/v1/seller/orders?limit=100 Authorization: Bearer <access_token> → data.orders[] = { order_key, customer_order_code, source_order_no, status, tracking_numbers[], courier, items[] } API·엑셀·관리자 등록 등 모든 경로의 내 주문을 반환합니다. source_order_no는 원 주문번호가 저장되지 않은 주문이면 null입니다. 다음 페이지: ?cursor=<next_cursor>

GET https://www.sweetiefood.com/api/v1/seller/orders/changed?updated_since=2026-08-30T00:00:00 Authorization: Bearer <access_token> → 그 시각 이후 생성·발송된 주문만. next_cursor 로 이어받기(폴링에 적합)

GET https://www.sweetiefood.com/api/v1/seller/balance (scope: balance.read) → data.deposit_balance GET https://www.sweetiefood.com/api/v1/seller/claims?claim_type=cancel (scope: order.read) claim_type = cancel | return | exchange, updated_since=<datetime> → data.orders[] = { claim_no, claim_type, claim_status, order_code, refund_total_amount }

POST https://www.sweetiefood.com/api/v1/seller/orders/cancel Authorization: Bearer <access_token> Content-Type: application/json { "source_order_no": "2026091972890291", "reason": "중복 발주" } // source_order_no 대신 order_key 사용 가능 → data = { claim_no, order_key, source_order_no, claim_status } 취소는 접수 후 관리자가 발송·공급사 전달 여부를 확인하여 승인합니다. 같은 요청을 다시 보내도 기존 접수 결과를 반환합니다.