← Home

Cin7 Core Data 테이블 명세 및 데이터 카탈로그

이 문서의 수치는 전부 실측이다

아래 행 수·채움률·고유값·범위는 2026-09-23에 시트 전체를 읽어 직접 집계한 값이다(추정 아님). 다만 원장은 계속 쌓이므로 절대값은 시간이 지나면 달라진다 — 구조와 비율을 참고하고, 정확한 최신 수치가 필요하면 다시 집계할 것.

1. 개요

항목값
파일명Cin7 Core Data (자동 동기화 · 직접편집 금지)
파일 ID1m30Aw4YJ-PtABJSLrrKO4u-v6Gt7xLg9GOpwpE2efjU
위치TA Drive 루트 — 수기 입력본 Turbo Air 시트와 같은 폴더
원천Cin7 Core(구 DEAR Systems) ERP API — 연동 상세는 Cin7 Core (Dear Systems) API 연동 검토
갱신rebuild-site.ps1 스텝 2.5155c(헤더 8탭 전체 새로고침) + 2.5155d(재무 2탭 증분), 매시간 09~18시

기계 소유 파일 — 직접 입력 금지

매 실행마다 각 탭을 비우고 다시 쓴다. 손으로 넣은 값·수식·추가 열은 다음 동기화 때 사라진다. 가공이 필요하면 별도 파일에서 IMPORTRANGE로 끌어다 쓸 것.

탭 한눈에 보기

탭성격행 수열Cin7 엔드포인트
판매목록 (SaleList)거래(주문 단위)12,69629saleList
구매목록 (PurchaseList)거래(발주 단위)1,51624purchaseList
상품 (Products)마스터73728product
고객 (Customers)마스터62020customer
공급자 (Suppliers)마스터27112supplier
창고위치 (Locations)참조611ref/location
회계과목 (ChartOfAccounts)참조10210ref/account
결제조건 (PaymentTerms)참조136ref/paymentTerm
매출라인 (InvoiceLines)거래(라인 단위)4,25420sale?ID= 상세
결제내역 (Payments)거래(입금 단위)1,43810sale?ID= 상세
_동기화정보메타———

2. 판매목록 (SaleList) — 12,696행 × 29열

한 행 = 판매주문 1건(라인이 아니라 주문 헤더). 2019-06-17 ~ 현재.

컬럼타입채움률실측 내용
SaleIDtext100%GUID, 고유 12,696 — 상세 조회(sale?ID=) 키
OrderNumbertext100%고유 12,696. TA-SO#E361202S 형식
Statusenum(15)100%COMPLETED 10,332 · INVOICED 810 · ESTIMATING 786 · ORDERED 214 · ESTIMATED 191 · CREDITED 145 · VOIDED 122 · BACKORDERED 32 …
OrderDatedate100%2019-06-17 ~ 2026-09-23
InvoiceDatedate89.3%비어있는 10.7%는 아직 인보이스 전(견적·수주 상태)
Customer / CustomerIDtext100%고유 602 / 600 — 이름이 ID보다 2개 많다(동명이인 표기 흔들림 가능성)
InvoiceNumbertext89.3%TA-#E064223 형식, 고유 11,332
CustomerReferencetext97.8%고객 PO번호·모델명 등 자유서식
InvoiceAmountnumber100%-129.2 ~ 122,793.83 — GST 포함. 음수는 크레딧노트
PaidAmountnumber100%-3,890.7 ~ 119,205.56
InvoiceDueDatedate89.3%~ 2026-10-14
CreditNoteNumbertext2.4%TA-CN#147258C 형식
QuoteStatusenum(4)100%AUTHORISED 11,727 · DRAFT 788 · VOIDED 122 · NOT AVAILABLE 59
OrderStatusenum(6)100%FULFILLED 11,282 · DRAFT 780 · AUTHORISED 281 · NOT AVAILABLE 229 · VOIDED 122 · SHORT STOCK 2
CombinedPickingStatusenum(4)100%PICKED 11,309 · NOT AVAILABLE 1,044 · NOT PICKED 325 · PICKING 16
CombinedPackingStatusenum(4)100%PACKED 11,307 · … · PACKING 5
CombinedShippingStatusenum(5)100%SHIPPED 11,294 · … · PARTIALLY SHIPPED 1
CombinedInvoiceStatusenum(4)100%INVOICED 11,017 · NOT AVAILABLE 1,046 · NOT INVOICED 332 · INVOICED / CREDITED 299
CombinedPaymentStatusenum(5)100%PAID 10,323 · UNPAID 2,021 · PARTIALLY PAID 200 · OVERPAID / CREDITED 107 · OVERPAID 43
CombinedPaymentTotalnumber100%-3,890.7 ~ 171,164.65
CreditNoteStatusenum(4)100%NOT AVAILABLE 12,273 · AUTHORISED 295 · VOIDED 122 · DRAFT 6
FulFilmentStatusenum(4)100%FULFILLED 11,294 · NOT AVAILABLE 1,044 · NOT FULFILLED 355 · PARTIALLY FULFILLED 1
Typeenum(2)100%Simple Sale 12,686 · Advanced Sale 10
OrderLocationIDtext100%고유 6 — 창고위치 탭 ID와 조인. Sydney Warehouse 10,659 / VIC Warhouse 2,025
Updateddatetime100%증분 동기화 기준 타임스탬프
BaseCurrency·CustomerCurrencytext100%전부 AUD 단일값 — 분석에 무의미
SourceChanneltext0%완전 공란 — 사용 불가

미수금(AR) 분석이 바로 가능하다

CombinedPaymentStatus가 UNPAID 2,021건 + PARTIALLY PAID 200건이고 InvoiceAmount−PaidAmount로 잔액이 나온다. 다만 오래된 VOIDED/견적 건이 섞여 있으므로 InvoiceDate가 있고 Status가 VOIDED/ESTIMATING이 아닌 행으로 먼저 거른 뒤 집계할 것.

번호체계는 사실상 단일하다 (2026-09-23 확인)

SALES ORDER#… / INV#… 형식의 구형 번호가 섞여 있으나 각각 2건뿐이며 전부 2019-06-17(가동 첫날) 건이다. 나머지 99.98%는 TA-SO#·TA-#이므로 조인 시 구형을 따로 처리할 실익은 없다.


3. 구매목록 (PurchaseList) — 1,516행 × 24열

한 행 = 발주(PO) 1건. 2019-06-19 ~ 2026-09-08.

컬럼타입채움률실측 내용
ID / OrderNumbertext100%고유 1,516. TA-PO#E00001P 형식
Statusenum(9)100%COMPLETED 1,378 · RECEIVED 76 · INVOICED 28 · CREDITED 12 · VOIDED 10 · ORDERED 6 …
Supplier / SupplierIDenum(15)100%Kitchen Knock 1,156(76%) · QINGDAO TURBO AIR INC 258 · Luren 47 · TA QLD 24 · TURBO KOREA 12 …
OrderDate / InvoiceDatedate100% / 99.2%2019-06-19 ~ 2026-09-08
InvoiceAmountnumber100%0 ~ 924,877.5 (컨테이너 단위 발주라 금액이 크다)
PaidAmountnumber100%0 ~ 837,984.53
CombinedReceivingStatusenum(4)100%FULLY RECEIVED 1,370 · NOT AVAILABLE 121 · NOT RECEIVED 22 · PARTIALLY RECEIVED 3
CombinedPaymentStatusenum(5)100%PAID 1,408 · UNPAID 43 · OVERPAID 42 · OVERPAID / CREDITED 12 · PARTIALLY PAID 11
CreditNoteNumbertext1%14건뿐
RequiredBydate0.3%5건뿐 — 사실상 미사용
Typetext100%전부 Simple Purchase — 단일값
IsServiceOnlyboolean100%전부 FALSE — 단일값
BaseCurrency·SupplierCurrencytext100%전부 AUD — 단일값
LastUpdatedDatedatetime100%2019-06-27 ~ 2026-09-17

매입처 집중도가 매우 높다

발주 1,516건 중 **Kitchen Knock 한 곳이 76%**다. 공급망 리스크·협상력 분석 시 이 집중도가 핵심 변수다.


4. 상품 (Products) — 737행 × 28열

컬럼타입채움률실측 내용
ID / SKUtext100%고유 737
Nametext100%고유 653 — SKU보다 84개 적다(동일 명칭이 복수 SKU에 존재)
Categoryenum(11)100%Spare parts 362(49%) · Refrigeration 238 · Freezer 81 · Other 22 · Combined fridge & freezer 13 · Food Display 6 · Cooking Equipment 5
Brandenum(3)91.7%Turbo Air 642 · K-master 32 · Main Freight 2
Typeenum(3)100%Non Inventory 374 · Stock 352 · Service 11
CostingMethodenum(3)100%FIFO 404 · Special - Serial Number 332 · FIFO - Serial Number 1
UOMenum(3)100%ea 396 · Unit 340 · Item 1
PriceTier1number100%-300 ~ 23,460 (음수는 조정·할인 항목)
AverageCostnumber100%0 ~ 7,540 — 마진 계산의 원가 기준
Length/Width/Height/Weightnumber100%0 포함. 단위는 DimensionsUnits(mm, 73.8%)·WeightUnits(kg, 46.7%)
LastModifiedOn / CreatedDatedatetime100%2019-06-17 ~ 2026-09-23
Barcode·HSCode·CountryOfOrigintext0%완전 공란 — 사용 불가
MinimumBeforeReorder·ReorderQuantity·CartonQuantitynumber100%/84.7%전부 0 — 재주문점 관리 미사용
Status·Sellable—100%전부 Active / TRUE — 단일값(단종 상품 식별 불가)
PriceTier2number100%0~160, 사실상 미사용
ShortDescriptiontext1.1%8건뿐

브랜드 구분 주의 — K-Master가 섞여 있다

이 탭에는 K-master 브랜드 상품 32개가 Turbo Air 642개와 한 테이블에 섞여 있다. CLAUDE.md의 브랜드 disambiguation 규칙상 브랜드 미명시 분석은 Turbo Air 기준이므로, 이 탭을 쓸 때는 Brand 컬럼으로 반드시 필터할 것. K-Master 매출 원장은 별도 시트(KM_Database)이며 이 파일과 합산하지 않는다 — K-Master Sales Data (DB) 테이블 명세 및 데이터 카탈로그 참고.

"상품"의 절반이 부품이다

Category = Spare parts가 362개(49%)다. 완제품 모델 분석 시 이 카테고리를 제외하지 않으면 모델 수가 2배로 부풀려진다.


5. 고객 (Customers) — 620행 × 20열

컬럼타입채움률실측 내용
ID / Nametext100%고유 620
PaymentTermenum(7)100%CBD, Cash before dispatch 551(89%) · 1 Week 36 · EOM+14 Day 16 · 2 Weeks 14 …
Discountnumber100%0 ~ 58 (%)
PriceTierenum(3)100%Tier 1 618 · Tier 2 1 · Tier 3 1 — 사실상 단일 티어
SalesRepresentativeenum(4)96.9%TA Sales 215 · DEFAULT business contact 185 · Sales VIC 121 · DEFAULT billing contact 80
Carrierenum(10)90.2%DEFAULT Carrier 188 · Customer Pickup 139 · Aonemaster 85 · Border express 46 · DHL 45 …
Locationenum(2)94.8%Sydney Warehouse 478 · VIC Warhouse 110
CreditLimitnumber100%0 ~ 30,000 — 고유값 3개뿐(대부분 0)
IsOnCreditHoldboolean100%TRUE 1건, 나머지 FALSE
CustomerParentNametext3.2%Epicure Food Solutions 5 · Elleo Group 5 · Zeus Street Greek 2 … — 그룹사 구조는 거의 미입력
Commentstext7.3%자유서식
TaxNumbertext1.6%10건뿐
Status·Currency·TaxRule·AccountReceivable—100%전부 단일값(Active / AUD / GST on Income / 610)
DisplayNametext0.8%5건뿐
Tagstext0%공란

결제조건이 거의 전부 선불(CBD)이다

620곳 중 551곳(89%)이 CBD, Cash before dispatch다. 즉 여신 리스크는 구조적으로 낮고, 미수금은 소수의 신용거래처에서만 발생한다. CreditLimit이 대부분 0인 것도 같은 맥락.


6. 공급자 (Suppliers) — 271행 × 12열

컬럼타입채움률실측 내용
ID / Nametext100%고유 271
PaymentTermenum(6)100%2 Weeks 257(95%) · 1 Week 8 · CBD 2 · 30 days 2 …
TaxRuleenum(3)100%GST on Expenses 267 · GST on Income 2 · GST Free Expenses 2
Discountnumber100%0 ~ 65
LastModifiedOndatetime100%2019-07-12 ~ 2026-08-10
Status·Currency·AccountPayable—100%전부 단일값(Active / AUD / 800)
TaxNumber·Tagstext0%공란
Commentstext0.4%1건

등록 공급자는 271곳이지만 실제 발주가 발생한 곳은 15곳뿐(구매목록 참고) — 나머지는 서비스 협력업체 등 비발주 거래처로 보인다(추정, 미확인).


7. 창고위치 (Locations) — 6행 × 11열

Name용도주소
Sydney Warehouse주 출고 창고(기본값, IsDefault=TRUE)Warwick Farm NSW 2170
VIC WarhouseVIC 출고 창고 (시트 원문 철자 그대로 — Warehouse 아님)Knoxfield VIC 3180
Sydney Showroom전시장Auburn NSW 2144
VIC Showroom전시장(주소 미입력)
Sydney Faulty Warehouse불량품 보관(주소 미입력)
VIC Faulty Warehouse불량품 보관(주소 미입력)
  • ID는 판매목록.OrderLocationID와 조인된다.
  • AddressLine1·City·State·PostCode는 6곳 중 3곳만 입력(50%), AddressLine2·ParentID는 공란.
  • IsDeprecated 전부 FALSE.

8. 회계과목 (ChartOfAccounts) — 102행 × 10열

Xero에서 동기화된 계정과목표다(상세 근거는 Cin7 Core (Dear Systems) API 연동 검토 §회계 데이터).

컬럼타입채움률실측 내용
Codetext100%고유 102. 200(Sales)·260(Freight & Handling)·610(AR)·800(AP)·601(Freedom Business) 등
Name / DisplayNametext100%DisplayName은 800: Accounts Payable 형식
Typeenum(11)100%EXPENSE 56 · CURRLIAB 17 · CURRENT 7 · FIXED 6 · REVENUE 4 · EQUITY 3 · TERMLIAB 3 … (Xero 고유 타입코드)
Classenum(5)100%EXPENSE 58 · LIABILITY 21 · ASSET 15 · REVENUE 5 · EQUITY 3
Statusenum(2)100%ACTIVE 100 · ARCHIVED 2
ForPaymentsboolean100%TRUE 16 — 입금/출금 계정으로 쓸 수 있는 과목
Descriptiontext79.4%—
SystemAccount/SystemAccountCodetext10.8%11건 — DEBTORS·CREDITORS·GST·RETAINEDEARNINGS 등 Xero 시스템계정

9. 결제조건 (PaymentTerms) — 13행 × 6열

Name(1 Week / 2 Weeks / 30 days / 45 days / 5 Months / 6 months / CBD …), Duration(0~180), Method(number of days 10 · last day of next month 1 · day of next month 1 · days since the end of the month 1), IsActive(TRUE 11 · FALSE 2), IsDefault(전부 FALSE).

고객·공급자 탭의 PaymentTerm이 이 Name을 참조한다.


10. 매출라인 (InvoiceLines) — 4,254행 × 20열

한 행 = 인보이스 라인 1건. Cin7 주문 상세(sale?ID=)에서만 나오는 데이터라 증분 수집한다(사유는 Cin7 Core (Dear Systems) API 연동 검토 참고). 2026-01-01 이후 생성된 인보이스 발행 주문 1,496건을 전부 수집한 상태(2026-09-23 백필 완료).

#컬럼내용
1~5주문번호·인보이스번호·인보이스상태·인보이스일자·고객판매목록과 조인되는 키
6~7SKU·품명상품 탭과 조인
8~11수량·단가·할인율(%)·GST단가는 정가, 할인율 적용 후가 합계
12합계(제외GST)= 단가 × 수량 × (1−할인율). GST 제외
13~14매출계정코드·매출계정명200 Sales / 260 Freight & Handling — 매출과 운임수익이 분리된다
15세금규칙GST on Income
16~18평균원가·COGS·매출총이익COGS = 평균원가 × 수량
19매출총이익률(%)= 매출총이익 ÷ 합계 × 100
20비고라인 코멘트(출고지 메모 등)

실측 (2026-09-23, 2026년분 4,254행)

항목값
매출계정별 합계(제외GST)**200 Sales 6,346,918** · `260 Freight & Handling` 143,378
매출총이익률중앙값 54.6% · 범위 -100% ~ 97.5%
음수 마진 라인5건 (원가 이하 판매 — 예: TOH-1200 판매 2,000 / 원가 2,642.62 = -32.1%)

운임 라인은 원가가 없다 — 마진 집계 시 분리할 것

매출계정명 = Freight & Handling 라인은 평균원가가 0이라 매출총이익률이 100%로 잡히거나 공란이 된다. 제품 마진을 볼 때는 매출계정코드 = 200만 필터할 것.

음수 마진은 버그가 아니다

원가 이하로 판매된 실제 건이다(전시품 처분·손상품 할인 등으로 추정, 미확인). 마진 분석 시 제외할지는 목적에 따라 판단할 것.

2026-09-23 초기 버전의 열 밀림 버그 (수정 완료)

최초 기록 시 헤더에 세금규칙 열이 빠져 있어 평균원가 자리에 GST on Income이 들어가고 마지막 비고가 잘려나가는 오류가 있었다. 헤더를 20열로 바로잡았고, 재발 방지를 위해 _google-sheets-write.mjs의 writeTableToTab()에 행/헤더 열 개수 불일치 시 예외를 던지는 검증을 추가했다. 이 탭을 2026-09-23 이전 스냅샷으로 분석한 결과가 있다면 폐기할 것.


11. 결제내역 (Payments) — 1,438행 × 10열

한 행 = 입금(또는 상계) 1건. 한 인보이스에 분할 입금이 있으면 여러 행이 된다. 결제일 범위 2026-01-05 ~ 2026-09-21.

주문번호 · 인보이스번호 · 고객 · 결제유형 · 결제금액 · 결제일 · 입금계정코드/입금계정명 · 참조 · 기록일

실측 (2026-09-23)

결제유형건수금액
현금입금 (601 Freedom Business)1,423$6,013,932
크레딧노트 상계15$51,998

Cin7은 입금계정 자리에 크레딧노트 번호를 넣는다 — 현금흐름에 섞으면 안 된다

크레딧노트가 인보이스에 상계될 때, 그 “결제” 레코드의 Account 필드에는 GL 계정코드가 아니라 크레딧노트 번호(TA-CN#147598C 형식) 가 들어온다. 즉 이 15건은 은행에 들어온 현금이 아니다. 그대로 합산하면 회수액이 $51,998 과대계상된다. 이 카탈로그 작성 중 발견해 결제유형 컬럼을 신설했다(2026-09-23) — 현금 회수 분석 시 결제유형 = 현금입금으로 필터할 것.

결제일(실제 입금일)과 기록일(Cin7 등록일)은 보통 하루 차이다 — 현금흐름 분석에는 **결제일**을 쓸 것.


12. 조인 키 정리

판매목록.SaleID          ─(1:N)→  매출라인 / 결제내역   (상세 API 키)
판매목록.OrderNumber     ─(1:1)→  매출라인.주문번호 · 결제내역.주문번호
판매목록.InvoiceNumber   ─(1:1)→  매출라인.인보이스번호
판매목록.OrderLocationID ─(N:1)→  창고위치.ID
판매목록.CustomerID      ─(N:1)→  고객.ID
구매목록.SupplierID      ─(N:1)→  공급자.ID
매출라인.SKU             ─(N:1)→  상품.SKU
매출라인.매출계정코드     ─(N:1)→  회계과목.Code
결제내역.입금계정코드     ─(N:1)→  회계과목.Code   ※ 결제유형=현금입금 행만 유효
고객.PaymentTerm         ─(N:1)→  결제조건.Name

수기 입력 Turbo Air 시트와의 연결

Cin7구글시트 Sales Data
판매목록.OrderNumber (TA-SO#E360844S)Order No (동일 체계)
판매목록.InvoiceNumber (TA-#E064223)Inv No (TA-# 접두사 제거)

금액 관계(GST·리베이트 보정식)와 대조 결과는 Cin7 Core (Dear Systems) API 연동 검토 §두 시스템을 잇는 키 참고.


13. 쓰기 전에 알아야 할 것 (요약)

  1. 단일값 컬럼은 버릴 것 — BaseCurrency·CustomerCurrency·SupplierCurrency(전부 AUD), Type(구매목록), IsServiceOnly, Status/Sellable(상품), AccountReceivable/AccountPayable. 분석에 정보량이 0이다.
  2. 완전 공란 컬럼 — SourceChannel(판매목록), Barcode·HSCode·CountryOfOrigin(상품), TaxNumber·Tags(공급자), Tags(고객), AddressLine2·ParentID(창고위치).
  3. 재주문점 미사용 — 상품의 MinimumBeforeReorder·ReorderQuantity·CartonQuantity가 전부 0이라 Cin7에서 자동 발주 로직은 돌지 않는다.
  4. 단종 상품을 식별할 수 없다 — Status가 전부 Active다. 판매 이력(매출라인)으로 역산해야 한다.
  5. 금액은 GST 포함/제외가 탭마다 다르다 — 판매목록.InvoiceAmount는 GST 포함, 매출라인.합계(제외GST)는 제외. 섞어 합산하면 10% 오차가 난다.
  6. 음수 금액이 정상적으로 존재한다 — 크레딧노트(반품·조정). 합계 시 순액이 되므로 의도한 바가 아니면 Status로 걸러낼 것.
  7. 현금 회수액을 볼 때는 결제내역.결제유형 = 현금입금으로 거를 것 — 크레딧노트 상계 15건($51,998)이 섞여 있다.
  8. 제품 마진은 매출라인.매출계정코드 = 200만 — 운임(260)은 원가가 없어 마진을 왜곡한다.

Bias Check

Counter-argument: 컬럼의 의미 해석은 컬럼명·값 분포·Cin7 문서에서 추론한 것으로, Turbo Air 내부 운영 규칙과 대조 검증된 바 없다. 특히 “등록 공급자 271곳 중 실발주 15곳은 서비스 협력업체로 보인다”, “CBD 89%라 여신 리스크가 낮다” 같은 업무적 해석은 추정이며 담당자 확인이 필요하다. 수치 자체(행 수·채움률·고유값)는 실측이므로 신뢰도가 다르다. Data gap: (1) 매출라인·결제내역은 2026-01-01 이후 생성 주문만 담는다(기본 수집 창). 2025년 이전 이력이 필요하면 --since 2025-01-01 --backfill-all로 확장해야 한다. (2) Status enum들의 업무적 의미(예: ESTIMATING과 ESTIMATED의 차이, NOT AVAILABLE이 뜨는 조건)는 확인되지 않았다. (3) Cin7 UI 화면 보고서와의 수치 정합성 대조는 여전히 미수행이다.