For the complete documentation index, see llms.txt. This page is also available as Markdown.

SKU, 재고, 셀러 동기화(SFTP)

SFTP 인증 & 접속 정보

SFTP는 SSH Key 기반 인증(PEM) 만 지원해요. ID/PW 방식은 사용하지 않고, IP ACL도 함께 적용돼요.

항목
내용

Host

담당자 문의

Port

담당자 문의

계정

풀필먼트 제휴사별 개별 발급 (개발/운영 분리)

인증

SSH Key 기반(PEM). Public Key 전달 후 적용

outbound 허용 IP

3개 IP 등록 필요 (담당자 문의)

인증 절차

  1. [풀필먼트] SSH Key Pair(Private/Public)를 생성해요.

  2. [풀필먼트] 생성한 Public Key를 토스쇼핑 담당자에게 전달해요.

  3. [토스쇼핑] 서버 운영자가 Public Key를 SFTP 계정에 등록해요.

  4. [풀필먼트] Private Key(PEM)로 SFTP에 접속해요.

SSH Key Pair 생성, 실제 계정명, 접속 허용 IP 등록은 모두 담당자를 통해 진행해요. 보안상 이 문서에는 실제 계정명·IP를 싣지 않아요.

디렉토리 구조

/[fulfillment_name]/
  ├── merchant/recv/
  ├── product/recv/
  └── stock/recv/
  • recv/: 풀필먼트가 파일을 업로드하는 위치

[fulfillment_name]은 연동사별로 달라요. (예: 파스토는 /fassto/) 정확한 루트 경로는 담당자에게 확인해주세요.

파일명 규칙

구분
파일명 패턴
예시

일단위 전체 FEED

{Domain}_{yyyyMMdd}.jsonl

product_20260401.jsonl

각 파일은 JSONL(1줄 = 1 레코드) 형식이에요.

merchant 파일 (셀러-계정 매핑)

경로: /[fulfillment_name]/merchant/recv/ · 파일명: merchant_{yyyyMMdd}.jsonl

필드명
타입
필수
설명

fulfillmentAccountKey

String

O

풀필먼트 계정 식별자

fulfillmentAccountName

String

O

풀필먼트 계정 이름

clientId

String

O

토스쇼핑 셀러 식별자 (OAuth clientId)

isConnected

Boolean

O

토스 연동 여부 (false도 포함해서 전송)

terminatedReason

String

X

연결 해지 사유 (해지된 경우만)

updatedAt

DateTime

O

연결 상태 변경 일시

product 파일 (SKU 전체)

경로: /[fulfillment_name]/product/recv/ · 파일명: product_{yyyyMMdd}.jsonl

필드 구성은 4.2 SKU 메타데이터 동기화의 요청 필드와 동일해요. (1줄 = 1 SKU)

stock 파일 (재고 전체)

경로: /[fulfillment_name]/stock/recv/ · 파일명: stock_{yyyyMMdd}.jsonl 식별 기준: fulfillmentPartner + fulfillmentAccountKey + skuKey + fulfillmentCenterKey (1줄 = 1 SKU × 물류센터 조합)

필드 구성은 4.4 재고 동기화의 요청 필드와 동일해요.

Last updated

Was this helpful?