Skip to main content

창고 및 제품 구성하기

본 문서는 앤트포켓 스페이스에서 재고관리의 기반이 되는 데이터(제품, 제품 카테고리, 창고, 거래처) 를 설정하는 방법을 안내합니다. 좌측 메뉴의 데이터 관리 (/space/schema) 영역에서 모두 다룰 수 있습니다.


1. 데이터를 먼저 설정해야 하는 이유

재고관리는 "어떤 제품을, 어느 창고에, 어느 거래처와 주고받는가" 를 기록하는 활동입니다. 따라서 입출고 같은 액션을 수행하기 전에 그 액션의 대상이 되는 데이터가 먼저 정의되어 있어야 합니다.

  • 제품(item) 이 등록되어 있지 않으면 입고/출고할 대상이 없습니다.
  • 창고(place) 가 등록되어 있지 않으면 재고가 쌓일 위치가 없습니다.
  • 거래처(trader) 가 등록되어 있지 않으면 입고처/출고처를 선택할 수 없습니다.
  • 제품 카테고리(category) 와 그에 속한 속성(property) 이 정의되어 있어야 제품별 추가 정보(사이즈, 색상 등)를 일관되게 관리할 수 있습니다.

스페이스를 새로 만들었다면 다음 순서로 설정하시는 것을 권장합니다.

  1. 창고 등록 → 재고를 쌓을 공간을 먼저 만듭니다.
  2. 거래처 등록 → 입출고 시 선택할 거래 상대를 만듭니다.
  3. 제품 카테고리와 속성 정의 → 제품을 분류하고 추가 속성을 설계합니다.
  4. 제품 등록 → 카테고리와 창고가 준비된 상태에서 제품을 등록합니다.
권한 안내

데이터의 추가/수정/삭제에는 데이터 관리(schema.writable) 권한이 필요합니다. 스페이스 소유자는 기본적으로 해당 권한을 가지며, 팀원 및 권한 페이지에서 다른 멤버에게 위임할 수 있습니다.


2. 창고 관리

페이지 경로: 데이터 관리 > 창고

창고(place)는 재고가 실제로 보관되는 위치를 의미합니다. 물리적인 창고뿐 아니라 상황에 따라 "본사 보관함", "전시장", "차량 적재분" 같은 논리적 구역도 창고로 표현할 수 있습니다.

창고 생성

  1. 페이지 우측 하단의 창고 생성 버튼을 클릭합니다.
  2. 다이얼로그에서 창고명을 입력합니다. (필수)
  3. 확인 을 누르면 등록됩니다.

창고 수정 / 삭제

각 창고 카드 우측 상단의 연필 아이콘을 클릭하면 메뉴가 열립니다.

  • 수정: 창고명과 순번(order) 을 변경할 수 있습니다. 순번은 정수이며, 작은 값일수록 목록 앞쪽에 표시됩니다.
  • 삭제: 삭제 시 복원할 수 없으니 신중히 진행해 주세요.

내려받기

내려받기 버튼을 누르면 등록된 창고 목록을 엑셀(CSV) 파일로 내보낼 수 있습니다.


3. 거래처 관리

페이지 경로: 데이터 관리 > 거래처

거래처(trader)는 입고 및 출고 액션 시 함께 기록되는 상대방을 의미합니다. 일반적인 거래 업체뿐 아니라 "쿠팡", "스마트스토어" 같은 판매 채널이나 지역명도 거래처로 등록할 수 있습니다.

거래처 등록

  1. 페이지의 거래처 등록 버튼을 클릭합니다.
  2. 다이얼로그에서 거래처명을 입력합니다. (필수)
  3. 제출 을 누르면 등록됩니다.

거래처 수정 / 삭제

각 거래처 카드 우측 상단의 연필 아이콘으로 메뉴를 엽니다.

  • 수정: 거래처명과 순번을 변경할 수 있습니다.
  • 삭제: 삭제 시 복원할 수 없습니다.

내려받기

내려받기 버튼으로 등록된 거래처 목록을 엑셀 파일로 내보낼 수 있습니다.


4. 제품 카테고리 관리

페이지 경로: 데이터 관리 > 제품 카테고리

제품 카테고리(category)는 제품을 분류하기 위한 그룹입니다. 예를 들어 신발 제조판매업이라면 운동화, 깔창 같은 카테고리를 만들 수 있습니다.

카테고리를 사용하면 다음과 같은 이점이 있습니다.

  • 제품 목록을 카테고리로 필터링할 수 있습니다.
  • 카테고리별로 추가 속성(property) 을 정의하여 제품 정보를 확장할 수 있습니다.

카테고리 등록

  1. 카테고리 등록 버튼을 클릭합니다.
  2. 다이얼로그에서 카테고리명을 입력합니다. (필수)
  3. 확인 을 누르면 등록됩니다.

카테고리 수정 / 삭제

각 카테고리 카드 우측 상단의 연필 아이콘으로 메뉴를 엽니다.

  • 수정: 카테고리명과 순번을 변경할 수 있습니다.
  • 삭제: 삭제 시 해당 카테고리의 속성 설정도 함께 사라집니다.

속성(property) 관리

카테고리 카드의 속성관리 버튼을 누르면 해당 카테고리에 속한 속성 목록이 표시됩니다. 속성은 카테고리에 속한 제품들이 공통으로 갖는 부가 정보입니다. (예: "운동화" 카테고리에서 사이즈, 색상)

속성 추가

  1. 속성추가 버튼을 클릭합니다.
  2. 다음 항목을 입력합니다.
    • 속성명: 예) 사이즈, 색상
    • 속성의 값 타입:
      • 정수: 정수값만 입력 가능. 예) 신발 사이즈 230, 240, 250 …
      • 텍스트: 문자/소수점 등 자유로운 형식. 예) 색상 "빨강", 규격 "200 x 300", 가격 "2.73"
    • 값이 정수가 아니거나 문자가 포함될 수 있다면 텍스트를 선택하세요.

속성 수정 / 삭제

  • 수정 시 속성명과 순번을 변경할 수 있습니다. (단, 값 타입은 생성 후 변경할 수 없습니다.)
  • 삭제는 즉시 반영되며, 해당 속성에 입력된 제품 데이터에는 더 이상 노출되지 않습니다.

5. 제품 관리

페이지 경로: 데이터 관리 > 제품

제품(item)은 재고관리의 가장 중심이 되는 데이터입니다. 앤트포켓에서는 일반적으로 사용하는 "상품/아이템" 대신 "제품" 이라는 용어를 사용합니다.

5.1 제품 검색

페이지 상단의 검색 폼에서 다음 조건으로 제품을 검색할 수 있습니다.

  • 카테고리: 등록된 카테고리 중 하나를 선택하거나 "전체"로 검색
  • 키워드: 제품명 또는 제품코드로 부분 일치 검색
  • 정렬: 순번 오름/내림차순, 최신/오래된 등록순 중 선택
    • 선택한 정렬 기준은 브라우저에 저장되어 다음 방문 시에도 유지됩니다.

검색 결과는 페이지네이션 되어 표시되며, 총 검색 건수가 상단에 표시됩니다.

5.2 제품 개별 등록

  1. 등록하기 버튼을 클릭합니다.
  2. 다이얼로그에서 아래 항목을 입력합니다.

기본속성

  • 제품명 (필수, 최대 255자)
  • 제품코드: 제품을 식별하는 코드. (최대 64자, 형식 제약 있음) 제품명은 같을 수 있지만 제품코드는 같을 수 없습니다.
  • 제품단가: 단가는 정수(양수)로 입력합니다. (자산 조회 권한이 있는 사용자에게만 노출)

추가속성

  • 카테고리: 등록된 카테고리 중 하나를 선택합니다. 카테고리를 선택하면, 그 카테고리에 설정된 속성들이 자동으로 입력 폼에 나타납니다.
  • 각 속성 값을 입력합니다. 빈 값으로 둔 속성은 저장되지 않습니다.

창고 내 최초 수량 (신규 등록 시에만 표시)

  • 등록된 모든 창고가 나열됩니다.
  • 등록 시점에 해당 창고에 보관되어 있는 수량을 입력합니다. 비워두면 0으로 처리됩니다.
  • 정확한 수량을 모른다면 빈 값으로 둔 뒤, 나중에 재고관리조정 액션으로 맞출 수 있습니다.

기타

  1. 확인 을 누르면 제품이 등록됩니다.

5.3 제품 수정

  • 제품 목록의 행에서 수정 동작을 선택하면 위와 동일한 다이얼로그가 열립니다.
  • 수정 모드에서는 순번도 함께 변경할 수 있습니다.
  • 바코드 입력란을 비워서 저장하면 기존에 연결된 바코드가 해제됩니다.

5.4 제품 일괄등록: 엑셀

페이지 경로: 데이터 관리 > 제품 > 일괄등록: 엑셀

대량의 제품을 한 번에 등록할 때 사용합니다.

  1. 제품 목록 페이지에서 일괄등록: 엑셀 버튼을 누릅니다.
  2. 등록할 제품들의 카테고리를 선택합니다. (선택안함도 가능)
  3. 일괄등록 페이지로 이동되면 엑셀 양식 다운로드 링크를 통해 양식을 받습니다.
    • 양식에는 제품명(필수), 제품코드(선택), 선택한 카테고리에 정의된 속성 컬럼, 그리고 등록된 창고별 초기수량 컬럼이 포함됩니다.
  4. 양식에 데이터를 채워 저장한 뒤, 페이지의 업로드 영역에 파일을 드래그&드롭 하거나 클릭하여 업로드합니다. (xlsx 형식, 최대 3MByte)
  5. 업로드된 데이터가 화면에 표 형태로 표시됩니다. 확인 후 등록을 진행합니다.
플랜 안내

일괄등록 기능은 비지니스 등급 이상의 플랜에서만 사용할 수 있습니다. 기본(basic) 플랜에서는 업그레이드 안내 다이얼로그가 표시됩니다.

5.5 제품 일괄등록: 쿠팡

페이지 경로: 데이터 관리 > 제품 > 쿠팡으로 등록하기

쿠팡(쿠팡 윙)에 등록된 상품 정보를 가져와 앤트포켓의 제품으로 일괄 등록할 수 있습니다.

  1. 제품 목록에서 일괄등록: 쿠팡 버튼을 누르거나, 메뉴에서 쿠팡으로 등록하기로 이동합니다.
  2. 앤트포켓과 연동된 쿠팡 계정 목록이 표시됩니다.
    • 연동된 계정이 없다면 연동하러가기 링크를 통해 쿠팡 인증 연동을 먼저 진행합니다.
  3. 사용할 쿠팡 계정 카드의 쿠팡으로 제품일괄등록 진행하기 버튼을 누릅니다.
  4. 확인 다이얼로그에서 확인을 누르면 작업이 시작됩니다. (최대 10분 소요)
  5. 페이지 하단의 작업조회 영역에서 진행 상태를 확인할 수 있습니다.

동작 규칙

  • 상태가 APPROVED 인 쿠팡 상품만 대상이 됩니다.
  • 쿠팡 상품의 옵션 하나당 앤트포켓 제품 하나가 1:1로 생성됩니다.
    • 예) "빨간색", "파란색" 두 옵션이 있는 쿠팡 상품은 앤트포켓에서 2개의 제품으로 등록됩니다.
  • 이미 쿠팡 연동을 통해 등록된 제품은 중복 생성되지 않고 정보가 갱신됩니다. 따라서 일괄등록을 여러 번 실행해도 안전합니다.

5.6 선택 삭제

  • 제품 목록의 체크박스로 여러 제품을 선택한 뒤 선택 삭제 버튼을 눌러 한 번에 삭제할 수 있습니다.
  • 삭제 전 확인 다이얼로그가 표시되며, 확인 후 즉시 삭제됩니다.

5.7 카테고리 관리 바로가기

제품 목록 상단의 관리: 제품 카테고리 버튼을 누르면 제품 카테고리 관리 페이지로 바로 이동합니다.


부록: 용어 정리

용어설명
스페이스(space)재고관리의 단위. 팀 또는 기업 단위로 사용합니다.
제품(item)재고관리의 대상. 화면에서는 "제품"으로 표기합니다.
제품 카테고리(category)제품을 분류하는 그룹. 그룹별로 속성을 정의할 수 있습니다.
속성(property)카테고리에 속한 제품들이 공통으로 갖는 부가 정보 (예: 사이즈, 색상).
창고(place)재고가 보관되는 위치.
거래처(trader)입고/출고 시 함께 기록되는 상대방 (업체, 채널, 지역 등).
액션(action)창고에 대해 수행되는 입고/출고/이동/조정 동작.
입출고명세서(bucket)액션을 수행하기 전에 미리 담아두는 명세서.