Cashnote 韩国小微商户销售与 MyData 数据 API

Korea Credit Data · 企业办公

캐시노트 - 사장님 필수앱（Cashnote）是 Korea Credit Data（KCD）为韩国小微商户老板（사장님）打造的记账首页。老板通过账号密码登录后，可以绑定一家或多家门店，并在同一个首页查看今日销售构成、按刷卡、现金、发票与外卖划分营收的月历、成本月历、把 Baemin、Yogiyo 与 Coupang Eats 回款分开列示的结算月历，以及汇总已连接韩元账户余额的银行账户看板。首页还会显示 Home Tax（홈택스）、刷卡、银行、POS 与 Crefia 的连接状态，以及韩国 MyData 银行与信用卡的授权关联、每日备忘和经过身份验证的店主资料。该应用在 Google Play 上仅以韩语面向韩国市场发布；当地店主往往把它与 POS 终端和三大外卖应用并排使用，而不是把它当作通用的费用记录工具。

门店身份以 registrationNumber 与 businessId 并列存放，而每日销售月历把同一天拆分为 card、cash、invoice、delivery 与 other 的韩元合计。结算日进一步把回款拆为 baemin、yogiyo 与 coupangEats，而提前一个月的预估图表则把 estimatedAmount 与 currentAmount 配对呈现。已连接的银行条目在 lastTransactedAt 旁给出 balance 与 accountType。

凭证标志位跟踪 Home Tax、Crefia、POS 与实时刷卡数据的抓取状态；凭以 jwt 签发的 Bearer 令牌，MyData 机构会返回 code、accountList 与 cardList。放贷系统、特许经营连锁的财务主管和外卖回款对账方，都可以把这些门店与每晚的销售数据关联起来，而无需再次抓取。openData Studio 把这一接口面变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

账号密码登录
POST /v1/sajang/session/id-password osint
用店主账号和明文密码换取 JWT，该 JWT 在会员、看板与 MyData 调用中用作 Bearer 认证。
认证方式：无（用于签发 jwt）。请求体为 login 与 plainPassword。后续调用发送 Authorization: Bearer <jwt>。
- login
- plainPassword
- jwt
- errorCode
- success
- message
- response
```
POST /v1/sajang/session/id-password HTTP/1.1
Content-Type: application/json

{
  "login": "[email protected]",
  "plainPassword": "********"
}
```
```
{
  "errorCode": 0,
  "success": true,
  "message": "",
  "response": {
    "jwt": "eyJhbGciOiJIUzI1NiJ9.example"
  }
}
```

刷新会员 JWT

GET /v1/sajang/session/rotate opendata

无需重新输入 login 与 plainPassword 即可轮换会员 JWT。

认证方式：来自登录的 Bearer JWT（jwt）。

jwt
errorCode
success
message
response

GET /v1/sajang/session/rotate HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "errorCode": 0,
  "success": true,
  "message": "",
  "response": {
    "jwt": "eyJhbGciOiJIUzI1NiJ9.refreshed"
  }
}

已绑定门店列表

GET /v1/sajang/storefronts osint

返回已登录店主名下的门店，附韩国营业执照号码与店主角色标志。

认证方式：来自登录的 Bearer JWT。

businesses
userId
userUUID
businessId
name
role
representativeVerified
registrationNumber
incorporated
errorCode
success

GET /v1/sajang/storefronts HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "errorCode": 0,
  "success": true,
  "message": "",
  "response": {
    "userId": 1843921,
    "userUUID": "usr_8f21c0a4",
    "businesses": [
      {
        "businessId": "biz_44102",
        "name": "한강분식 신촌점",
        "role": "OWNER",
        "representativeVerified": true,
        "registrationNumber": "123-45-67890",
        "incorporated": false
      }
    ]
  }
}

会员资料

GET /v1/sajang/owner-card osint

读取已登录店主的身份信息卡：真实姓名、电话、生日、MyData 用户标志与韩国运营商。

认证方式：来自登录的 Bearer JWT。

trackingId
id
name
realName
phoneNumber
birthday
age
gender
nationality
identityVerified
isMydataUser
telecommunicationServiceProvider

GET /v1/sajang/owner-card HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "errorCode": 0,
  "success": true,
  "message": "",
  "response": {
    "trackingId": "trk_9c12",
    "id": "1843921",
    "name": "김사장",
    "realName": "김민수",
    "phoneNumber": "010-1234-5678",
    "birthday": "1984-03-12",
    "age": 42,
    "gender": "MALE",
    "nationality": "KR",
    "identityVerified": true,
    "isMydataUser": true,
    "telecommunicationServiceProvider": "SKT"
  }
}

今日销售汇总

GET /v1/sajang/home/today-mix opendata

主屏幕上展示所选门店当日销售构成的卡片（label、text、type）。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

todaySummaries
icon
link
label
text
type

GET /v1/sajang/home/today-mix?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "todaySummaries": [
    {
      "icon": "https://cdn.example.com/icons/card.png",
      "link": "/sales/today",
      "label": "카드매출",
      "text": "1,240,000원",
      "type": "CARD"
    }
  ]
}

营收月历

GET /v1/sajang/ledgers/revenue-month openfinance

门店营收月历，按天拆分为刷卡、现金、发票、外卖与其他的韩元合计。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

link
isConnected
summaries
type
text
dailyData
date
total
card
cash
invoice
delivery
other

GET /v1/sajang/ledgers/revenue-month?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "link": "/sales/calendar",
  "isConnected": true,
  "summaries": [
    {"type": "CARD", "text": "카드 8,400,000원"},
    {"type": "CASH", "text": "현금 1,100,000원"},
    {"type": "DELIVERY", "text": "배달 2,300,000원"},
    {"type": "INVOICE", "text": "세금계산서 900,000원"},
    {"type": "OTHER", "text": "기타 120,000원"},
    {"type": "TOTAL", "text": "합계 12,820,000원"}
  ],
  "dailyData": [
    {
      "date": "2026-09-18",
      "total": 1282000,
      "card": 840000,
      "cash": 110000,
      "invoice": 90000,
      "delivery": 230000,
      "other": 12000,
      "link": "/sales/2026-09-18"
    }
  ]
}

成本月历

GET /v1/sajang/ledgers/cost-month opendata

门店成本月历，按天拆分为固定、变动与未分类的韩元合计。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

link
isConnected
summaries
dailyData
date
total
fixed
variable
uncategorized

GET /v1/sajang/ledgers/cost-month?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "link": "/costs/calendar",
  "isConnected": true,
  "summaries": [],
  "dailyData": [
    {
      "date": "2026-09-18",
      "total": 410000,
      "fixed": 250000,
      "variable": 140000,
      "uncategorized": 20000,
      "link": "/costs/2026-09-18"
    }
  ]
}

结算月历

GET /v1/sajang/ledgers/payout-month openfinance

预计回款月历，拆分为刷卡收单方，以及 Baemin、Yogiyo 与 Coupang Eats 的结算韩元金额。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

link
isConnected
summaries
dailyData
date
total
card
baemin
yogiyo
coupangEats

GET /v1/sajang/ledgers/payout-month?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "link": "/settlements/calendar",
  "isConnected": true,
  "summaries": [],
  "dailyData": [
    {
      "date": "2026-09-18",
      "total": 980000,
      "card": 420000,
      "baemin": 310000,
      "yogiyo": 150000,
      "coupangEats": 100000,
      "link": "/settlements/2026-09-18"
    }
  ]
}

月度营收预估

GET /v1/sajang/forecast/sales-month opendata

提前一个月的营收图表，把历史月度金额与 estimatedAmount 对比 currentAmount 配对呈现。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

pastData
month
text
amount
estimatedData
estimatedText
estimatedAmount
currentAmount
summary
title
highlightText
subTitle
hasEnoughData
url

GET /v1/sajang/forecast/sales-month?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "pastData": [
    {"month": "2026-08-01", "text": "8월", "amount": 11800000}
  ],
  "estimatedData": {
    "month": "2026-09-01",
    "estimatedText": "예상 1,250만원",
    "estimatedAmount": 12500000,
    "currentAmount": 8420000
  },
  "summary": {
    "title": "이번 달 매출 예상",
    "highlightText": "1,250만원",
    "subTitle": "지난달 대비",
    "hasEnoughData": true,
    "url": "/insights/revenue"
  }
}

月度成本预估

GET /v1/sajang/forecast/spend-month opendata

提前一个月的成本图表，把历史月度金额与 estimatedAmount 对比 currentAmount 配对呈现。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

pastData
month
text
amount
estimatedData
estimatedText
estimatedAmount
currentAmount
summary
title
highlightText
subTitle
hasEnoughData
url

GET /v1/sajang/forecast/spend-month?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "pastData": [
    {"month": "2026-08-01", "text": "8월", "amount": 4200000}
  ],
  "estimatedData": {
    "month": "2026-09-01",
    "estimatedText": "예상 450만원",
    "estimatedAmount": 4500000,
    "currentAmount": 3100000
  },
  "summary": {
    "title": "이번 달 비용 예상",
    "highlightText": "450만원",
    "subTitle": "지난달 대비",
    "hasEnoughData": true,
    "url": "/insights/costs"
  }
}

凭证连接状态

GET /v1/sajang/links/scrape-health opendata

按门店给出 Home Tax、Crefia、POS、实时刷卡、银行、信用卡与三大外卖应用的抓取与连接标志位。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

bank
card
crefia
hometax
mydataCard
pos
realTimeCard
realTimeCardCount
delivery
baemin
yogiyo
coupangEats
utilityBills

GET /v1/sajang/links/scrape-health?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "bank": "CONNECTED",
  "card": "CONNECTED",
  "crefia": "CONNECTING",
  "hometax": "CONNECTED",
  "mydataCard": "NOT_CONNECTED",
  "pos": "CONNECT_FAIL",
  "realTimeCard": "CONNECTED",
  "realTimeCardCount": 3,
  "delivery": {
    "baemin": "CONNECTED",
    "yogiyo": "CONNECTED",
    "coupangEats": "NOT_CONNECTED"
  },
  "utilityBills": {}
}

银行账户看板

GET /v1/sajang/wallets/krw-accounts openbanking

首页银行账户卡片，外加已连接门店账户的逐账户韩元余额、账户类型与最近一笔交易的时间戳。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

bankAccountCard
bankAccountList
accountType
balance
label
lastTransactedAt
logoUrl
title
url

GET /v1/sajang/wallets/krw-accounts?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "bankAccountCard": {
    "title": "연결 계좌",
    "url": "/bank-accounts"
  },
  "bankAccountList": [
    {
      "accountType": "CHECKING",
      "balance": 8421500,
      "label": "사업자통장",
      "lastTransactedAt": "2026-09-18T09:12:00+09:00",
      "logoUrl": "https://cdn.example.com/orgs/kb.png",
      "title": "KB국민은행",
      "url": "/wallets/ast_kb_1"
    }
  ]
}

看板备忘

GET /v1/sajang/home/daily-notes opendata

首页上所选门店带日期的店主备忘列表（memoDate、memoContent）。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

allMemoLink
memos
memoDate
memoContent
link

GET /v1/sajang/home/daily-notes?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "allMemoLink": "/memos",
  "memos": [
    {
      "memoDate": "2026-09-18",
      "memoContent": "배달비 정산 확인",
      "link": "/memos/881"
    }
  ]
}

看板商户信息卡片

GET /v1/sajang/home/biz-tiles osint

首页上展示门店身份文案（label 与 text）的卡片，例如显示在日历旁边的营业登记信息。

认证方式：来自登录的 Bearer JWT。查询参数为当前选中的 businessId。

businessInfo
iconUrl
link
label
text

GET /v1/sajang/home/biz-tiles?businessId=biz_44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "businessInfo": [
    {
      "iconUrl": "https://cdn.example.com/icons/biz.png",
      "link": "/business/profile",
      "label": "사업자등록번호",
      "text": "123-45-67890"
    }
  ]
}

MyData 机构目录

GET /v1/sajang/mydata/issuer-catalog openfinance

店主可授权的韩国 MyData 银行与信用卡发卡机构目录，以机构代码 code 为键。

认证方式：来自登录的 Bearer JWT。

name
code
thumbnail
url

GET /v1/sajang/mydata/issuer-catalog HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "organizations": [
    {
      "name": "KB국민은행",
      "code": "004",
      "thumbnail": "https://cdn.example.com/orgs/kb.png",
      "url": "https://www.example-bank.kr"
    }
  ]
}

已连接的 MyData 机构

GET /v1/sajang/mydata/consented-issuers openbanking

列出已授权的 MyData 银行与信用卡机构，附脱敏的账户与卡号以及授权到期状态。

认证方式：来自登录的 Bearer JWT。

success
response
bank
card
name
code
thumbnail
url
connected
expired
accountList
cardList
id
assetId
number

GET /v1/sajang/mydata/consented-issuers HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "success": true,
  "response": {
    "bank": [
      {
        "name": "KB국민은행",
        "code": "004",
        "thumbnail": "https://cdn.example.com/orgs/kb.png",
        "url": "https://www.example-bank.kr",
        "connected": true,
        "expired": false,
        "accountList": [
          {"id": 901, "assetId": "ast_kb_1", "name": "사업자통장", "number": "123-****-456"}
        ],
        "cardList": []
      }
    ],
    "card": [
      {
        "name": "삼성카드",
        "code": "365",
        "thumbnail": "https://cdn.example.com/orgs/samsungcard.png",
        "url": "https://www.example-card.kr",
        "connected": true,
        "expired": false,
        "accountList": [],
        "cardList": [
          {"id": 902, "assetId": "ast_sc_1", "name": "법인카드", "number": "5389-****-1234"}
        ]
      }
    ]
  }
}

MyData 用户通道

GET /v1/sajang/mydata/channel-bind openfinance

返回已登录店主的 MyData 通道绑定信息（channelId、channelAccountId）。

认证方式：来自登录的 Bearer JWT。

success
message
errorCode
response
id
channelId
channelAccountId

GET /v1/sajang/mydata/channel-bind HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example

{
  "success": true,
  "message": "",
  "errorCode": "0",
  "response": {
    "id": 55201,
    "channelId": "cashnote",
    "channelAccountId": "usr_8f21c0a4"
  }
}

刷新 MyData 资产
POST /v1/sajang/mydata/assets-reload openbanking
触发一次 MyData 资产刷新，使随后的已连接机构 accountList 与 cardList 条目得到更新。
认证方式：来自登录的 Bearer JWT。
- success
- message
```
POST /v1/sajang/mydata/assets-reload HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.example
```
```
{
  "success": true,
  "message": ""
}
```

数据类别

销售
成本
结算
MyData
商户
凭证连接
银行账户
身份信息

数据使用场景与案例

外卖回款对账
特许经营连锁的财务主管把每日的 baemin、yogiyo 与 coupangEats 结算韩元金额按门店 businessId 关联起来，使 Baemin、Yogiyo 与 Coupang Eats 的回款和 POS 日结对得上。
放贷系统的门店授信评估
韩国小微企业贷款机构拉取 registrationNumber，以及刷卡、现金、发票与外卖的月历合计、estimatedAmount 与 currentAmount 的对比和 bankAccountList.balance，据此核定营运资金额度，无需再额外抓取一次 Home Tax。
MyData 银行与信用卡授权监控
记账机器人监控已连接的 MyData 银行与信用卡机构（code、expired 与脱敏的 number），在授权即将到期时重新触发资产刷新。
Home Tax 与 Crefia 连接健康度
托管服务商（MSP）的看板按门店映射 hometax、crefia、pos 与 realTimeCard 标志位，使断开的国税厅（National Tax Service）数据抓取在月末结账前得到修复。

常见问题

Cashnote 每天暴露怎样的销售构成？

营收月历按天返回 card、cash、invoice、delivery 与 other 的韩元合计，另有一组 type/text 汇总行，涵盖 CARD、CASH、DELIVERY、INVOICE、OTHER 与 TOTAL。

Baemin、Yogiyo 与 Coupang Eats 的回款如何呈现？

结算月历的 dailyData 对象在刷卡收单回款旁边给出 baemin、yogiyo 与 coupangEats 的韩元金额；凭证连接状态接口则把这三个应用重复列为嵌套的 delivery 标志位。

Cashnote 是否包含韩国 MyData 银行与信用卡关联？

包含。机构目录列出 name、code、thumbnail 与 url；已授权机构还会加上 connected、expired、accountList 与 cardList，其中带脱敏的 number 与 assetId。另有单独的银行账户看板，按账户返回 balance 与 accountType。

店主如何完成身份认证？

账号密码登录会在由 errorCode、success、message 与 response 组成的外层结构里返回 jwt。后续调用把该值作为 Bearer 令牌发送；轮换接口可在无需重新输入密码的情况下刷新它。

与 캐시노트 - 사장님 필수앱 相似的应用

모바일 경리나라 — Webcash 的「모바일 경리나라」是韩国中小企业记账应用，可自动推送每日简报，并让店主实时查看银行余额、销售、采购与汇款。
더존 위하고 모바일 — Douzone Bizon 的「더존 위하고 모바일」是 WEHAGO 商务平台的手机端，注册 www.wehago.com 后可使用企业服务、一对一与群组协作以及文件共享。
자비스 매니저 — JOBIS&Villains 的「자비스 매니저」是 Jarvis 人工智能记账与税务客户的配套应用，用来拍摄收据、存款单和发票供专人录入。
토스 비즈니스 — Viva Republica 的「토스 비즈니스」是 Toss 面向韩国商家的应用，可在一处查看销售、费用与结算，并用于使用 Toss Place、Toss Ads 和 Toss Shopping。
Intuit QuickBooks for Business — Intuit QuickBooks 是面向小企业和个体经营者的手机会计应用，覆盖开票、费用跟踪、记账以及随时查看的现金流报表。
Zoho Books - Accounting App — Zoho Books 是 Zoho 的云端会计应用，用于开票、费用、项目、账单和税务报表，并在免费与付费方案中提供客户与供应商门户。
CashBook - Balance & Expense — CashBook 是数字现金出纳应用，用于记录每日现金流、收入与支出，并把账本导出到 Excel 或 Google 表格。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Cashnote 韩国小微商户销售与 MyData 数据 API

应用截图

API 端点一览

账号密码登录

刷新会员 JWT

已绑定门店列表

会员资料

今日销售汇总

营收月历

成本月历

结算月历

月度营收预估

月度成本预估

凭证连接状态

银行账户看板

看板备忘

看板商户信息卡片

MyData 机构目录

已连接的 MyData 机构

MyData 用户通道

刷新 MyData 资产

数据类别

数据使用场景与案例

外卖回款对账

放贷系统的门店授信评估

MyData 银行与信用卡授权监控

Home Tax 与 Crefia 连接健康度

常见问题

与 캐시노트 - 사장님 필수앱 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

需要集成这个 App 的数据 API？

Cashnote 韩国小微商户销售与 MyData 数据 API

应用截图

API 端点一览

账号密码登录

刷新会员 JWT

已绑定门店列表

会员资料

今日销售汇总

营收月历

成本月历

结算月历

月度营收预估

月度成本预估

凭证连接状态

银行账户看板

看板备忘

看板商户信息卡片

MyData 机构目录

已连接的 MyData 机构

MyData 用户通道

刷新 MyData 资产

数据类别

数据使用场景与案例

外卖回款对账

放贷系统的门店授信评估

MyData 银行与信用卡授权监控

Home Tax 与 Crefia 连接健康度

常见问题

相关应用

与 캐시노트 - 사장님 필수앱 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

需要集成这个 App 的数据 API？