myBillBook 数据 API：IRN、GSTIN 与现金

Accounting | Inventory | GST Billing App · 企业办公

myBillBook Invoice Billing App 是 FloBiz 面向印度零售商、批发商和小型制造商的 Android GST 开票、库存与现金账客户端，商户用手机开具税务发票。登录靠手机号加短信 OTP（可选 Truecaller），新增往来时可按 GSTIN 回填登记资料，销售可打印带 IRN 的电子发票，货物移动可开电子运单，库存按仓库调整，现金银行账记下结算账户的 UPI 收款名。WhatsApp 分享页发送发票链接，桌面账可导出 Tally，配套的 FloBiz 员工端覆盖考勤与工资。它和 Vyapar、Khatabook、TallyPrime 抢同一批烟杂店与中小商户，是印度优先的 GST 开票产品，而不是多国套件。

销售凭证把带回执号的 irn 盖在 GST 电子发票上，并带上 ackNo、ackDate 与签名 qr；货物移动行补上 eWaybillNo 与 eWaybillUrl。未收应收挂在同一张凭证的 remainingAmount 与 paymentStatus 上，每笔收款带 paymentId、paymentMode 与 paymentNumber。目录 SKU 以 hsnSacCode 和 gstPercentage 为键；库存通过 godownLinks 和可选 serialNumbers 过账 quantity，对上标了 isPrimary 的仓库。

GST 门户回填的往来给出 gstNumber、panNumber、placeOfSupply 与 creditLimit。资金卡片暴露 cashBalance、ifscCode、upiName 与 isSettlementAccount；员工行记下 salaryAmount、loanAmount 与 closingBalance。税务同步、催收账龄、仓库盘点与结算对账是这一面支撑的集成；openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

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

请求商户登录 OTP
POST /v1/books/otp osint
向商户手机号发送短信 OTP，并回报该号码是否已有 FloBiz 账户。
认证方式：无前置会话。签发会话之前的 OTP 引导。
- mobileNumber
- otpChannel
- existingUser
```
POST /v1/books/otp HTTP/1.1
Content-Type: application/json

{
  "mobileNumber": "9876543210",
  "otpChannel": "SMS"
}
```
```
{
  "existingUser": true
}
```

校验 OTP 并签发 Bearer 令牌

POST /v1/books/session osint

确认短信 OTP，返回 token、userId 与 companyId。后续调用以 Authorization Bearer 发送 token；companyId 成为 company-id 请求头。

认证方式：无前置会话。签发会话之前的 OTP 引导。

mobileNumber
otpCode
fcmToken
manufacturer
deviceModel
utmDetails
token
userId
companyId
name
email
gender
zipcode

POST /v1/books/session HTTP/1.1
Content-Type: application/json

{
  "mobileNumber": "9876543210",
  "otpCode": "482913",
  "fcmToken": "<fcm>",
  "manufacturer": "samsung",
  "deviceModel": "SM-A546B",
  "utmDetails": {}
}

{
  "token": "<token>",
  "userId": "usr_7c11ab",
  "companyId": "co_19f2",
  "mobileNumber": "9876543210",
  "name": "Ravi Sharma",
  "email": "[email protected]",
  "gender": "male",
  "zipcode": "110001"
}

列出销售发票与凭证

GET /v1/books/sales openfinance

分页返回公司销售凭证，含未收应收、电子发票状态、供应地与客户分享链接。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
number
partyId
partyName
amount
voucherAmount
receivedAmount
remainingAmount
paymentStatus
dueDate
eInvoiceStatus
placeOfSupply
tcsAmount
tdsAmount
shareLink
eWayBillUrl
items

GET /v1/books/sales HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "inv_88c1",
      "number": "INV-24-1182",
      "partyId": "pty_44",
      "partyName": "Mill Store Traders",
      "amount": 11800.0,
      "voucherAmount": 11800.0,
      "receivedAmount": 5000.0,
      "remainingAmount": 6800.0,
      "paymentStatus": "PARTIAL",
      "dueDate": "2026-10-20",
      "eInvoiceStatus": "GENERATED",
      "placeOfSupply": "07",
      "tcsAmount": 0,
      "tdsAmount": 0,
      "shareLink": "https://links.example/inv_88c1",
      "eWayBillUrl": null
    }
  ]
}

登记 GST 电子发票 IRN

POST /v1/books/sales/{id}/irn opendata

向 IRP 登记该笔销售，返回回执号、IRN、签名二维码与税务发票预览用的 PDF 地址。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

ackNo
ackDate
irn
qr
pdf
cancelledAt

POST /v1/books/sales/inv_88c1/irn HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
Content-Type: application/json

{}

{
  "ackNo": "112410012345678",
  "ackDate": "2026-10-08T11:42:00+05:30",
  "irn": "a1b2c3d4e5f67890irnexamplehash",
  "qr": "<signed-qr>",
  "pdf": "https://files.example/einvoice/inv_88c1.pdf",
  "cancelledAt": null
}

列出发票收款历史

GET /v1/books/sales/{id}/receipts openfinance

返回记在该销售凭证上的收款：剩余应收、折扣，以及每笔收据的方式与编号。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

remainingAmount
initialPaymentAmount
totalDiscount
totalAmountReceived
payments
paymentId
amount
voucherType
date
paymentNumber
paymentMode
discount

GET /v1/books/sales/inv_88c1/receipts HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "remainingAmount": 6800.0,
  "initialPaymentAmount": 0,
  "totalDiscount": 0,
  "totalAmountReceived": 5000.0,
  "payments": [
    {
      "paymentId": "pay_21",
      "amount": 5000.0,
      "voucherType": "RECEIPT",
      "date": "2026-10-08",
      "paymentNumber": "RCT-24-090",
      "paymentMode": "UPI",
      "discount": 0
    }
  ]
}

列出商品目录

GET /v1/books/catalog opendata

列出带 HSN、GST 税率、MRP/售价与期初库存的 SKU，供发票行使用。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
name
hsnSacCode
code
gstPercentage
mrp
sellingPrice
pricePerUnit
quantity
openingStock
categoryName
isTaxIncluded
isSerialized

GET /v1/books/catalog HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "itm_9a",
      "name": "Cotton Shirt M",
      "hsnSacCode": "61091000",
      "code": "SHIRT-M",
      "gstPercentage": 12.0,
      "mrp": 999.0,
      "sellingPrice": 799.0,
      "pricePerUnit": 799.0,
      "quantity": 42.0,
      "openingStock": 50.0,
      "categoryName": "Apparel",
      "isTaxIncluded": false,
      "isSerialized": false
    }
  ]
}

调整商品库存

POST /v1/books/catalog/{id}/stock-move opendata

对 SKU 过账增加/减少库存，可按仓库与序列号拆分。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

quantity
notes
transactionDate
type
unit
godownLinks
serialNumbers

POST /v1/books/catalog/itm_9a/stock-move HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
Content-Type: application/json

{
  "quantity": 10,
  "notes": "Opening count",
  "transactionDate": "2026-10-08",
  "type": "ADD",
  "unit": "PCS",
  "godownLinks": [{"godownId": "gd_1", "quantity": 10}],
  "serialNumbers": []
}

{
  "id": "itm_9a",
  "quantity": 52.0,
  "openingStock": 50.0
}

获取往来 GST 资料

POST /v1/books/parties/tax-profile osint

把 GSTIN 对 GST 门户解析为法定名称、PAN、开票地址与电话，供往来表单使用。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

name
fetchedFromGstPortal
billingAddress
mobileNumber
panNumber
gstNumber

POST /v1/books/parties/tax-profile HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
Content-Type: application/json

{
  "gstNumber": "07AAPFU0939F1ZV"
}

{
  "name": "MILL STORE TRADERS PRIVATE LIMITED",
  "fetchedFromGstPortal": true,
  "billingAddress": "Connaught Place, New Delhi 110001",
  "mobileNumber": "9876543210",
  "panNumber": "AAPFU0939F"
}

列出银行账户

GET /v1/books/treasury/banks openbanking

返回公司银行账，含 IFSC、UPI 收款名、结算标志与实时 currentBalance。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
accountNumber
ifscCode
bankName
currentBalance
openingBalance
upiName
accountHolderName
isSettlementAccount
active
aliasName
bankAccountType
branchName

GET /v1/books/treasury/banks HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "ba_3",
      "accountNumber": "50100012345678",
      "ifscCode": "HDFC0000123",
      "bankName": "HDFC Bank",
      "currentBalance": 245000.5,
      "openingBalance": 180000.0,
      "upiName": "millstore@hdfcbank",
      "accountHolderName": "Mill Store Traders",
      "isSettlementAccount": true,
      "active": true,
      "aliasName": "HDFC CA",
      "bankAccountType": "CURRENT",
      "branchName": "Connaught Place"
    }
  ]
}

读取现金银行仪表盘统计
GET /v1/books/treasury/snapshot openbanking
返回首页现金银行卡片：柜台现金、合计账面余额与未命名账户余数。
认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。
- cashBalance
- totalBalance
- unnamedBalance
```
GET /v1/books/treasury/snapshot HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
```
```
{
  "cashBalance": 18500.0,
  "totalBalance": 263500.5,
  "unnamedBalance": 0
}
```

列出仓库

GET /v1/books/warehouses opendata

列出库存调整与调拨使用的仓库，含主仓标志与现存量。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
name
address
isPrimary
status
stock

GET /v1/books/warehouses HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "gd_1",
      "name": "Main Store",
      "address": "Okhla Phase 2",
      "isPrimary": true,
      "status": "ACTIVE",
      "stock": 1280.0
    }
  ]
}

列出现金银行流水

GET /v1/books/treasury/movements openbanking

分页返回现金银行流水，含滚动余额、收付方式与对应银行账。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
amount
bankAccountId
contactName
date
paymentMode
runningBalance
serialNumber
type

GET /v1/books/treasury/movements HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "cnb_77",
      "amount": 5000.0,
      "bankAccountId": "ba_3",
      "contactName": "Mill Store Traders",
      "date": "2026-10-08",
      "paymentMode": "UPI",
      "runningBalance": 245000.5,
      "serialNumber": "CNB-24-441",
      "type": "IN"
    }
  ]
}

列出员工

GET /v1/books/payroll/staff opendata

列出员工考勤账上的雇员，含发薪周期、借款与工资结余。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
name
mobileNumber
salaryAmount
salaryCycle
loanAmount
closingBalance
openingBalance
perHourSalary
payoutTypeStr

GET /v1/books/payroll/staff HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "data": [
    {
      "id": "emp_12",
      "name": "Amit Kumar",
      "mobileNumber": "9810000001",
      "salaryAmount": 18000.0,
      "salaryCycle": 1,
      "loanAmount": 2000.0,
      "closingBalance": 16000.0,
      "openingBalance": 0,
      "perHourSalary": 0,
      "payoutTypeStr": "SALARY"
    }
  ]
}

生成 GST 电子运单

POST /v1/books/logistics/eway opendata

为货物移动生成 GST 电子运单，返回 eWaybillNo 以及凭证上展示的 PDF 地址。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

id
vehicleNumber
eWaybillNo
eWaybillUrl

POST /v1/books/logistics/eway HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
Content-Type: application/json

{
  "id": "inv_88c1",
  "vehicleNumber": "DL01AB1234"
}

{
  "eWaybillNo": "381012345678",
  "eWaybillUrl": "https://files.example/eway/381012345678.pdf"
}

列出往来单位

GET /v1/books/parties osint

分页返回公司往来（客户与供应商），含 GSTIN、PAN、creditLimit、供应地与往来余额。

认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。

partyId
partyName
contactPersonName
balance
openingBalance
closingBalance
type
mobileNumber
gstNumber
panNumber
placeOfSupply
creditPeriod
creditLimit
ledgerCategoryName
loyaltyPoints
linkedStatus
page
hasContacts

GET /v1/books/parties HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2

{
  "partyList": [
    {
      "partyId": "pty_44",
      "partyName": "Mill Store Traders",
      "contactPersonName": "Ravi Sharma",
      "balance": 6800.0,
      "openingBalance": 0,
      "closingBalance": 6800.0,
      "type": "CUSTOMER",
      "mobileNumber": "9876543210",
      "gstNumber": "07AAPFU0939F1ZV",
      "panNumber": "AAPFU0939F",
      "placeOfSupply": "07",
      "creditPeriod": 15,
      "creditLimit": "50000",
      "ledgerCategoryName": "Trade Debtors",
      "loyaltyPoints": 120,
      "linkedStatus": "LINKED"
    }
  ],
  "page": 1,
  "hasContacts": true
}

读取凭证计数
GET /v1/books/sales/counts opendata
返回筛选后与全部销售凭证数量，供发票列表页头展示。
认证方式： Authorization: Bearer <token>，另加 company-id: <companyId>。
- filteredVoucherCount
- totalVoucherCount
```
GET /v1/books/sales/counts HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
```
```
{
  "filteredVoucherCount": 1182,
  "totalVoucherCount": 2406
}
```

数据类别

发票
GST
库存
往来
现金银行
电子发票
电子运单
员工

数据使用场景与案例

GST 电子发票 IRN 同步
税务机器人拉取销售凭证，把 ackNo、ackDate、irn 与 qr 盖进账本，再挂上货物移动的 eWaybillNo，让 GSTR-1 与 IRP 回执对齐，而不是本地发票号。
往来应收账龄
催收任务把凭证上的 remainingAmount、paymentStatus 与往来的 gstNumber、panNumber、creditLimit 拼接，再对上 paymentId 行，让逾期 IRN 发票按账龄滚动。
仓库库存对账
仓储任务用库存调整里的 quantity、type、unit、godownLinks 去对 hsnSacCode 商品和 isPrimary 仓库，序列化 SKU 还要对 serialNumbers。
现金银行结算
资金任务读取仪表盘上的 cashBalance 与 totalBalance，再用 ifscCode / currentBalance 银行账户去对 runningBalance 现金银行流水。

常见问题

myBillBook 如何验证商户身份？

用 mobileNumber 加 otpChannel 请求短信 OTP；会话接口返回 token、userId 与 companyId。之后的调用携带 Authorization Bearer 以及 company-id 请求头。

GST 电子发票用哪些字段标识？

销售凭证带 eInvoiceStatus。向 IRP 登记后，盖章返回 ackNo、ackDate、irn、签名 qr、pdf 地址与 cancelledAt。

库存如何按仓库表示？

商品暴露 hsnSacCode、gstPercentage、openingStock 与 isSerialized。库存调整提交 quantity、type、unit、godownLinks 与 serialNumbers，对上带 isPrimary 与 stock 的仓库。

首页仪表盘展示哪些现金银行数字？

仪表盘统计返回 cashBalance、totalBalance 与 unnamedBalance。银行账户补充 accountNumber、ifscCode、currentBalance、upiName 与 isSettlementAccount；现金银行流水带 runningBalance。

与 myBillBook Invoice Billing App 相似的应用

Vyapar Invoice GST Billing App — Vyapar 是印度 GST 开票与库存应用，面向小店和服务商户，可开具税务发票、电子发票和电子运单，并跟踪库存。
Khatabook — Khatabook 是面向印度商铺的数字赊账账本，记录客户往来（hisab），并发送催款提醒。
OkCredit — OkCredit 是面向印度店主的无纸化赊账账本，记录客户赊欠、催收、UPI 收款、开票和库存。
TallyPrime — TallyPrime 是班加罗尔 Tally Solutions 的旗舰企业管理软件，面向印度中小企业，覆盖会计、库存与 GST 合规。
Zoho Books — Zoho Books 是 Zoho 面向印度 GST 合规企业的云端会计产品，可在手机或电脑上开具发票、录入账单与费用、处理电子发票并申报 GST。
Swipe — Swipe 是印度 GST 开票与库存应用，可生成 GST 发票、向 GST 门户提交电子运单和电子发票，并为零售商和批发商跟踪库存。
BUSY — BUSY 是面向印度中小微企业的 GST 开票与会计软件，手机端可开具发票、报价和订单，并与桌面账套同步。

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

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

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

获取报价

myBillBook 数据 API：IRN、GSTIN 与现金

应用截图

API 端点一览

请求商户登录 OTP

校验 OTP 并签发 Bearer 令牌

列出销售发票与凭证

登记 GST 电子发票 IRN

列出发票收款历史

列出商品目录

调整商品库存

获取往来 GST 资料

列出银行账户

读取现金银行仪表盘统计

列出仓库

列出现金银行流水

列出员工

生成 GST 电子运单

列出往来单位

读取凭证计数

数据类别

数据使用场景与案例

GST 电子发票 IRN 同步

往来应收账龄

仓库库存对账

现金银行结算

常见问题

与 myBillBook Invoice Billing App 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

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

myBillBook 数据 API：IRN、GSTIN 与现金

应用截图

API 端点一览

请求商户登录 OTP

校验 OTP 并签发 Bearer 令牌

列出销售发票与凭证

登记 GST 电子发票 IRN

列出发票收款历史

列出商品目录

调整商品库存

获取往来 GST 资料

列出银行账户

读取现金银行仪表盘统计

列出仓库

列出现金银行流水

列出员工

生成 GST 电子运单

列出往来单位

读取凭证计数

数据类别

数据使用场景与案例

GST 电子发票 IRN 同步

往来应收账龄

仓库库存对账

现金银行结算

常见问题

相关应用

与 myBillBook Invoice Billing App 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

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