myBillBook data API: IRN, GSTIN and cash

Accounting | Inventory | GST Billing App · Business

myBillBook Invoice Billing App is FloBiz's Android GST invoicing, inventory and cash-book client for Indian retailers, wholesalers and small manufacturers who raise tax invoices from a phone. Merchants sign in with a mobile number and SMS OTP (Truecaller is an optional path), look up a customer's GST registration when adding a party, print IRN-stamped e-invoices, generate e-way bills for goods movement, adjust stock across godowns, and keep cash-and-bank books with UPI collect names on settlement accounts. WhatsApp share sheets send invoice links, Tally export is available for desktop books, and a companion FloBiz staff app covers attendance and salary. It competes for the same kirana and SME counters as Vyapar, Khatabook and TallyPrime, as an India-first GST billing product rather than a multi-country suite.

Ack-numbered irn stamps land on sale vouchers with ackNo, ackDate and a signed qr; a goods-movement row adds eWaybillNo and eWaybillUrl. Outstanding AR rides the same voucher as remainingAmount and paymentStatus, with each receipt carrying paymentId, paymentMode and paymentNumber. Catalogue SKUs key off hsnSacCode and gstPercentage; stock posts quantity through godownLinks and optional serialNumbers against a godown flagged isPrimary.

GST-portal party fills return gstNumber, panNumber, placeOfSupply and creditLimit. Treasury cards expose cashBalance, ifscCode, upiName and isSettlementAccount, while staff rows keep salaryAmount, loanAmount and closingBalance. Tax bots, collections jobs, warehouse counts and settlement reconciliation are the integrations this surface supports; openData Studio turns those fields into callable open data.

Screenshots

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

Request merchant login OTP
POST /v1/books/otp osint
Sends an SMS OTP to the merchant MSISDN and reports whether the number already has a FloBiz account.
Auth: No prior session. OTP bootstrap before the session call.
- mobileNumber
- otpChannel
- existingUser
```
POST /v1/books/otp HTTP/1.1
Content-Type: application/json

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

Authenticate OTP and issue Bearer token

POST /v1/books/session osint

Confirms the SMS OTP and returns token, userId and companyId. Later calls send the token as Authorization Bearer; companyId becomes the company-id header.

Auth: No prior session. OTP bootstrap before the session call.

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"
}

List sale invoices and vouchers

GET /v1/books/sales openfinance

Pages company sale vouchers with outstanding AR, e-invoice status, place of supply and a customer share link.

Auth: Authorization: Bearer <token> plus 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
    }
  ]
}

Register GST e-invoice IRN

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

Registers the sale with the IRP and returns acknowledgement number, IRN, signed QR and PDF URL used on the tax-invoice preview.

Auth: Authorization: Bearer <token> plus 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
}

List invoice payment history

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

Returns collections posted against a sale voucher: remaining AR, discounts and each receipt's mode and number.

Auth: Authorization: Bearer <token> plus 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
    }
  ]
}

List catalogue items

GET /v1/books/catalog opendata

Lists SKUs with HSN, GST rate, MRP/selling price and opening stock used on invoice line items.

Auth: Authorization: Bearer <token> plus 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
    }
  ]
}

Adjust item stock

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

Posts an add/reduce stock movement against a SKU, optionally split across godowns and serial numbers.

Auth: Authorization: Bearer <token> plus 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
}

Fetch party GST details

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

Resolves a GSTIN against the GST portal into legal name, PAN, billing address and phone for the party form.

Auth: Authorization: Bearer <token> plus 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"
}

List bank accounts

GET /v1/books/treasury/banks openbanking

Returns company bank books with IFSC, UPI collect name, settlement flag and live currentBalance.

Auth: Authorization: Bearer <token> plus 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"
    }
  ]
}

Read cash-and-bank dashboard stats
GET /v1/books/treasury/snapshot openbanking
Returns the home cash-and-bank card: till cash, combined book balance and unnamed-account remainder.
Auth: Authorization: Bearer <token> plus 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
}
```

List godowns

GET /v1/books/warehouses opendata

Lists warehouses used on stock adjustments and transfers, including the primary godown flag and on-hand stock.

Auth: Authorization: Bearer <token> plus 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
    }
  ]
}

List cash-and-bank transactions

GET /v1/books/treasury/movements openbanking

Pages cash-and-bank lines with running balance, payment mode and the bank book they hit.

Auth: Authorization: Bearer <token> plus 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"
    }
  ]
}

List staff employees

GET /v1/books/payroll/staff opendata

Lists employees on the staff-attendance books with salary cycle, loans and closing wage balance.

Auth: Authorization: Bearer <token> plus 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"
    }
  ]
}

Generate GST e-way bill

POST /v1/books/logistics/eway opendata

Creates a GST e-way bill for goods movement and returns eWaybillNo plus the PDF URL shown on the voucher.

Auth: Authorization: Bearer <token> plus 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"
}

List parties

GET /v1/books/parties osint

Pages company parties (customers and suppliers) with GSTIN, PAN, creditLimit, placeOfSupply and running ledger balance.

Auth: Authorization: Bearer <token> plus 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
}

Read voucher counts
GET /v1/books/sales/counts opendata
Returns filtered vs total sale-voucher counts used on the invoice list header.
Auth: Authorization: Bearer <token> plus company-id: <companyId>.
- filteredVoucherCount
- totalVoucherCount
```
GET /v1/books/sales/counts HTTP/1.1
Authorization: Bearer <token>
company-id: co_19f2
```
```
{
  "filteredVoucherCount": 1182,
  "totalVoucherCount": 2406
}
```

Where teams use this data

GST e-invoice IRN sync
Tax bots pull sale vouchers and stamp ackNo, ackDate, irn and qr onto the books, then attach eWaybillNo for goods movement so GSTR-1 packs match the IRP acknowledgement instead of a local invoice number.
Party ledger AR ageing
Collections jobs join remainingAmount and paymentStatus on vouchers with gstNumber, panNumber and creditLimit on parties, then match paymentId rows so overdue IRN invoices age correctly.
Godown stock reconciliation
Warehouse jobs apply quantity, type, unit and godownLinks from stock adjustments against hsnSacCode items and isPrimary godowns, including serialNumbers for serialized SKUs.
Cash-and-bank settlement
Treasury jobs read cashBalance and totalBalance on the dashboard, then match ifscCode / currentBalance bank accounts with runningBalance cash-and-bank lines.

Frequently asked questions

How does myBillBook authenticate merchants?

A mobileNumber plus otpChannel requests an SMS OTP; the session call returns token, userId and companyId. Later calls send Authorization Bearer plus a company-id header.

Which fields identify a GST e-invoice?

Sale vouchers carry eInvoiceStatus. After IRP registration the stamp returns ackNo, ackDate, irn, a signed qr, a pdf URL and cancelledAt.

How is inventory represented across warehouses?

Items expose hsnSacCode, gstPercentage, openingStock and isSerialized. Stock adjustments post quantity, type, unit, godownLinks and serialNumbers against a godown that has isPrimary and stock.

What cash-and-bank figures does the home dashboard show?

Dashboard stats return cashBalance, totalBalance and unnamedBalance. Bank accounts add accountNumber, ifscCode, currentBalance, upiName and isSettlementAccount; cash-and-bank lines keep runningBalance.

Apps similar to myBillBook Invoice Billing App

Vyapar Invoice GST Billing App — Vyapar is an Indian GST invoicing and inventory app that creates tax invoices, e-invoices and e-way bills and tracks stock for small shops and service businesses.
Khatabook — Khatabook is a digital credit-ledger app for Indian shops that records hisab (customer credit and debit) and sends payment-collection reminders.
OkCredit — OkCredit is a paperless udhar/khata ledger for Indian shopkeepers that records customer credit, collections, UPI receipts, billing and stock.
TallyPrime — TallyPrime is Tally Solutions' flagship business-management software from Bengaluru, covering accounting, inventory and GST compliance for Indian SMEs.
Zoho Books — Zoho Books is Zoho's cloud accounting product for GST-compliant businesses in India, covering invoices, bills, expenses, e-invoicing and GST filing from a phone or desktop.
Swipe — Swipe is an Indian GST billing and inventory app that generates GST invoices, files e-way bills and e-invoices with the GST portal, and tracks stock for retailers and wholesalers.
BUSY — BUSY is GST billing and accounting software for Indian MSMEs, with a mobile app that creates invoices, quotations and orders and syncs them with BUSY desktop books.

More Business apps

Topics

myBillBook API
GST IRN
e-invoice ackNo
godown stock
cashBalance
FloBiz billing
hsnSacCode
gstNumber

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

NDA + SOW on every engagement
Delivery in 3–7 days
Payment only after acceptance
Work scoped to authorized use

Get a quote

myBillBook data API: IRN, GSTIN and cash

Screenshots

API surface

Request merchant login OTP

Authenticate OTP and issue Bearer token

List sale invoices and vouchers

Register GST e-invoice IRN

List invoice payment history

List catalogue items

Adjust item stock

Fetch party GST details

List bank accounts

Read cash-and-bank dashboard stats

List godowns

List cash-and-bank transactions

List staff employees

Generate GST e-way bill

List parties

Read voucher counts

Data categories

Where teams use this data

GST e-invoice IRN sync

Party ledger AR ageing

Godown stock reconciliation

Cash-and-bank settlement

Frequently asked questions

Apps similar to myBillBook Invoice Billing App

More Business apps

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

Topics

Need this app's data API integrated?

myBillBook data API: IRN, GSTIN and cash

Screenshots

API surface

Request merchant login OTP

Authenticate OTP and issue Bearer token

List sale invoices and vouchers

Register GST e-invoice IRN

List invoice payment history

List catalogue items

Adjust item stock

Fetch party GST details

List bank accounts

Read cash-and-bank dashboard stats

List godowns

List cash-and-bank transactions

List staff employees

Generate GST e-way bill

List parties

Read voucher counts

Data categories

Where teams use this data

GST e-invoice IRN sync

Party ledger AR ageing

Godown stock reconciliation

Cash-and-bank settlement

Frequently asked questions

Related apps

Apps similar to myBillBook Invoice Billing App

More Business apps

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

Topics

Need this app's data API integrated?