창고 및 제품 구성하기
본 문서는 앤트포켓 스페이스에서 재고관리의 기반이 되는 데이터(제품, 제품 카테고리, 창고, 거래처) 를 설정하는 방법을 안내합니다. 좌측 메뉴의 데이터 관리 (/space/schema) 영역에서 모두 다룰 수 있습니다.
1. 데이터를 먼저 설정해야 하는 이유
재고관리는 "어떤 제품을, 어느 창고에, 어느 거래처와 주고받는가" 를 기록하는 활동입니다. 따라서 입출고 같은 액션을 수행하기 전에 그 액션의 대상이 되는 데이터가 먼저 정의되어 있어야 합니다.
- 제품(item) 이 등록되어 있지 않으면 입고/출고할 대상이 없습니다.
- 창고(place) 가 등록되어 있지 않으면 재고가 쌓일 위치가 없습니다.
- 거래처(trader) 가 등록되어 있지 않으면 입고처/출고처를 선택할 수 없습니다.
- 제품 카테고리(category) 와 그에 속한 속성(property) 이 정의되어 있어야 제품별 추가 정보(사이즈, 색상 등)를 일관되게 관리할 수 있습니다.
스페이스를 새로 만들었다면 다음 순서로 설정하시는 것을 권장합니다.
- 창고 등록 → 재고를 쌓을 공간을 먼저 만듭니다.
- 거래처 등록 → 입출고 시 선택할 거래 상대를 만듭니다.
- 제품 카테고리와 속성 정의 → 제품을 분류하고 추가 속성을 설계합니다.
- 제품 등록 → 카테고리와 창고가 준비된 상태에서 제품을 등록합니다.
데이터의 추가/수정/삭제에는 데이터 관리(schema.writable) 권한이 필요합니다. 스페이스 소유자는 기본적으로 해당 권한을 가지며, 팀원 및 권한 페이지에서 다른 멤버에게 위임할 수 있습니다.
2. 창고 관리
페이지 경로: 데이터 관리 > 창고
창고(place)는 재고가 실제로 보관되는 위치를 의미합니다. 물리적인 창고뿐 아니라 상황에 따라 "본사 보관함", "전시장", "차량 적재분" 같은 논리적 구역도 창고로 표현할 수 있습니다.
창고 생성
- 페이지 우측 하단의
창고 생성버튼을 클릭합니다. - 다이얼로그에서 창고명을 입력합니다. (필수)
확인을 누르면 등록됩니다.
창고 수정 / 삭제
각 창고 카드 우측 상단의 연필 아이콘을 클릭하면 메뉴가 열립니다.
- 수정: 창고명과 순번(order) 을 변경할 수 있습니다. 순번은 정수이며, 작은 값일수록 목록 앞쪽에 표시됩니다.
- 삭제: 삭제 시 복원할 수 없으니 신중히 진행해 주세요.
내려받기
내려받기 버튼을 누르면 등록된 창고 목록을 엑셀(CSV) 파일로 내보낼 수 있습니다.
3. 거래처 관리
페이지 경로: 데이터 관리 > 거래처
거래처(trader)는 입고 및 출고 액션 시 함께 기록되는 상대방을 의미합니다. 일반적인 거래 업체뿐 아니라 "쿠팡", "스마트스토어" 같은 판매 채널이나 지역명도 거래처로 등록할 수 있습니다.
거래처 등록
- 페이지의
거래처 등록버튼을 클릭합니다. - 다이얼로그에서 거래처명을 입력합니다. (필수)
제출을 누르면 등록됩니다.
거래처 수정 / 삭제
각 거래처 카드 우측 상단의 연필 아이콘으로 메뉴를 엽니다.
- 수정: 거래처명과 순번을 변경할 수 있습니다.
- 삭제: 삭제 시 복원할 수 없습니다.
내려받기
내려받기 버튼으로 등록된 거래처 목록을 엑셀 파일로 내보낼 수 있습니다.
4. 제품 카테고리 관리
페이지 경로: 데이터 관리 > 제품 카테고리
제품 카테고리(category)는 제품을 분류하기 위한 그룹입니다. 예를 들어 신발 제조판매업이라면 운동화, 깔창 같은 카테고리를 만들 수 있습니다.
카테고리를 사용하면 다음과 같은 이점이 있습니다.
- 제품 목록을 카테고리로 필터링할 수 있습니다.
- 카테고리별로 추가 속성(property) 을 정의하여 제품 정보를 확장할 수 있습니다.
카테고리 등록
카테고리 등록버튼을 클릭합니다.- 다이얼로그에서 카테고리명을 입력합니다. (필수)
확인을 누르면 등록됩니다.
카테고리 수정 / 삭제
각 카테고리 카드 우측 상단의 연필 아이콘으로 메뉴를 엽니다.
- 수정: 카테고리명과 순번을 변경할 수 있습니다.
- 삭제: 삭제 시 해당 카테고리의 속성 설정도 함께 사라집니다.
속성(property) 관리
카테고리 카드의 속성관리 버튼을 누르면 해당 카테고리에 속한 속성 목록이 표시됩니다. 속성은 카테고리에 속한 제품들이 공통으로 갖는 부가 정보입니다. (예: "운동화" 카테고리에서 사이즈, 색상)
속성 추가
속성추가버튼을 클릭합니다.- 다음 항목을 입력합니다.
- 속성명: 예) 사이즈, 색상
- 속성의 값 타입:
- 정수: 정수값만 입력 가능. 예) 신발 사이즈 230, 240, 250 …
- 텍스트: 문자/소수점 등 자유로운 형식. 예) 색상 "빨강", 규격 "200 x 300", 가격 "2.73"
- 값이 정수가 아니거나 문자가 포함될 수 있다면 텍스트를 선택하세요.
속성 수정 / 삭제
- 수정 시 속성명과 순번을 변경할 수 있습니다. (단, 값 타입은 생성 후 변경할 수 없습니다.)
- 삭제는 즉시 반영되며, 해당 속성에 입력된 제품 데이터에는 더 이상 노출되지 않습니다.
5. 제품 관리
페이지 경로: 데이터 관리 > 제품
제품(item)은 재고관리의 가장 중심이 되는 데이터입니다. 앤트포켓에서는 일반적으로 사용하는 "상품/아이템" 대신 "제품" 이라는 용어를 사용합니다.
5.1 제품 검색
페이지 상단의 검색 폼에서 다음 조건으로 제품을 검색할 수 있습니다.
- 카테고리: 등록된 카테고리 중 하나를 선택하거나 "전체"로 검색
- 키워드: 제품명 또는 제품코드로 부분 일치 검색
- 정렬: 순번 오름/내림차순, 최신/오래된 등록순 중 선택
- 선택한 정렬 기준은 브라우저에 저장되어 다음 방문 시에도 유지됩니다.
검색 결과는 페이지네이션 되어 표시되며, 총 검색 건수가 상단에 표시됩니다.
5.2 제품 개별 등록
등록하기버튼을 클릭합니다.- 다이얼로그에서 아래 항목을 입력합니다.
기본속성
- 제품명 (필수, 최대 255자)
- 제품코드: 제품을 식별하는 코드. (최대 64자, 형식 제약 있음) 제품명은 같을 수 있지만 제품코드는 같을 수 없습니다.
- 제품단가: 단가는 정수(양수)로 입력합니다. (자산 조회 권한이 있는 사용자에게만 노출)
추가속성
- 카테고리: 등록된 카테고리 중 하나를 선택합니다. 카테고리를 선택하면, 그 카테고리에 설정된 속성들이 자동으로 입력 폼에 나타납니다.
- 각 속성 값을 입력합니다. 빈 값으로 둔 속성은 저장되지 않습니다.
창고 내 최초 수량 (신규 등록 시에만 표시)
- 등록된 모든 창고가 나열됩니다.
- 등록 시점에 해당 창고에 보관되어 있는 수량을 입력합니다. 비워두면 0으로 처리됩니다.
- 정확한 수량을 모른다면 빈 값으로 둔 뒤, 나중에 재고관리의 조정 액션으로 맞출 수 있습니다.
기타
- 바코드: 제품에 연결할 바코드 코드를 입력합니다. (선택) 자세한 내용은 바코드로 재고관리하기를 참고하세요.
확인을 누르면 제품이 등록됩니다.
5.3 제품 수정
- 제품 목록의 행에서 수정 동작을 선택하면 위와 동일한 다이얼로그가 열립니다.
- 수정 모드에서는 순번도 함께 변경할 수 있습니다.
- 바코드 입력란을 비워서 저장하면 기존에 연결된 바코드가 해제됩니다.
5.4 제품 일괄등록: 엑셀
페이지 경로: 데이터 관리 > 제품 > 일괄등록: 엑셀
대량의 제품을 한 번에 등록할 때 사용합니다.
- 제품 목록 페이지에서
일괄등록: 엑셀버튼을 누릅니다. - 등록할 제품들의 카테고리를 선택합니다. (선택안함도 가능)
- 일괄등록 페이지로 이동되면
엑셀 양식 다운로드링크를 통해 양식을 받습니다.- 양식에는 제품명(필수), 제품코드(선택), 선택한 카테고리에 정의된 속성 컬럼, 그리고 등록된 창고별 초기수량 컬럼이 포함됩니다.
- 양식에 데이터를 채워 저장한 뒤, 페이지의 업로드 영역에 파일을 드래그&드롭 하거나 클릭하여 업로드합니다. (xlsx 형식, 최대 3MByte)
- 업로드된 데이터가 화면에 표 형태로 표시됩니다. 확인 후 등록을 진행합니다.
일괄등록 기능은 비지니스 등급 이상의 플랜에서만 사용할 수 있습니다. 기본(basic) 플랜에서는 업그레이드 안내 다이얼로그가 표시됩니다.
5.5 제품 일괄등록: 쿠팡
페이지 경로: 데이터 관리 > 제품 > 쿠팡으로 등록하기
쿠팡(쿠팡 윙)에 등록된 상품 정보를 가져와 앤트포켓의 제품으로 일괄 등록할 수 있습니다.
- 제품 목록에서
일괄등록: 쿠팡버튼을 누르거나, 메뉴에서 쿠팡으로 등록하기로 이동합니다. - 앤트포켓과 연동된 쿠팡 계정 목록이 표시됩니다.
- 연동된 계정이 없다면
연동하러가기링크를 통해 쿠팡 인증 연동을 먼저 진행합니다.
- 연동된 계정이 없다면
- 사용할 쿠팡 계정 카드의
쿠팡으로 제품일괄등록 진행하기버튼을 누릅니다. - 확인 다이얼로그에서 확인을 누르면 작업이 시작됩니다. (최대 10분 소요)
- 페이지 하단의 작업조회 영역에서 진행 상태를 확인할 수 있습니다.
동작 규칙
- 상태가
APPROVED인 쿠팡 상품만 대상이 됩니다. - 쿠팡 상품의 옵션 하나당 앤트포켓 제품 하나가 1:1로 생성됩니다.
- 예) "빨간색", "파란색" 두 옵션이 있는 쿠팡 상품은 앤트포켓에서 2개의 제품으로 등록됩니다.
- 이미 쿠팡 연동을 통해 등록된 제품은 중복 생성되지 않고 정보가 갱신됩니다. 따라서 일괄등록을 여러 번 실행해도 안전합니다.
5.6 선택 삭제
- 제품 목록의 체크박스로 여러 제품을 선택한 뒤
선택 삭제버튼을 눌러 한 번에 삭제할 수 있습니다. - 삭제 전 확인 다이얼로그가 표시되며, 확인 후 즉시 삭제됩니다.
5.7 카테고리 관리 바로가기
제품 목록 상단의 관리: 제품 카테고리 버튼을 누르면 제품 카테고리 관리 페이지로 바로 이동합니다.
부록: 용어 정리
| 용어 | 설명 |
|---|---|
| 스페이스(space) | 재고관리의 단위. 팀 또는 기업 단위로 사용합니다. |
| 제품(item) | 재고관리의 대상. 화면에서는 "제품"으로 표기합니다. |
| 제품 카테고리(category) | 제품을 분류하는 그룹. 그룹별로 속성을 정의할 수 있습니다. |
| 속성(property) | 카테고리에 속한 제품들이 공통으로 갖는 부가 정보 (예: 사이즈, 색상). |
| 창고(place) | 재고가 보관되는 위치. |
| 거래처(trader) | 입고/출고 시 함께 기록되는 상대방 (업체, 채널, 지역 등). |
| 액션(action) | 창고에 대해 수행되는 입고/출고/이동/조정 동작. |
| 입출고명세서(bucket) | 액션을 수행하기 전에 미리 담아두는 명세서. |