חשבונית מס.
קריאת API אחת.

BASE=https://api.billos.co.il/v1

# draft a ₪350 invoice/receipt, paid by card
curl -X POST $BASE/businesses/$BID/documents \
  -H "X-Api-Key: bk_live_..." -H "Idempotency-Key: order-1001" \
  -d '{
    "docType": 320, "priceMode": "gross",
    "party": { "name": "דנה לוי", "phone": "0521111111" },
    "lines": [{ "description": "איפור ערב", "quantity": 1,
                "unitPriceExVat": 35000 }],
    "payments": [{ "method": 3, "amount": 35000 }]
  }'

# issue: the legal number is assigned and the PDF is signed
curl -X POST $BASE/businesses/$BID/documents/$DOC/issue \
  -H "X-Api-Key: bk_live_..."

const BASE = 'https://api.billos.co.il/v1'
const billos = (path, body) => fetch(BASE + path, {
  method: 'POST',
  headers: { 'X-Api-Key': KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify(body),
}).then((r) => r.json())

const { document } = await billos(`/businesses/${bid}/documents`, {
  docType: 320, priceMode: 'gross',
  party: { name: 'דנה לוי', phone: '0521111111' },
  lines: [{ description: 'איפור ערב', quantity: 1,
            unitPriceExVat: 35000 }],
  payments: [{ method: 3, amount: 35000 }],
})
const issued = await billos(
  `/businesses/${bid}/documents/${document.id}/issue`)
issued.document.docNumber   // 1042

import os, requests
API = "https://api.billos.co.il/v1"
H = {"X-Api-Key": os.environ["BILLOS_KEY"]}

doc = requests.post(f"{API}/businesses/{bid}/documents",
                    headers=H, json={
    "docType": 320, "priceMode": "gross",
    "party": {"name": "דנה לוי", "phone": "0521111111"},
    "lines": [{"description": "איפור ערב", "quantity": 1,
               "unitPriceExVat": 35000}],
    "payments": [{"method": 3, "amount": 35000}],
}).json()["document"]

url = f"{API}/businesses/{bid}/documents/{doc['id']}/issue"
issued = requests.post(url, headers=H).json()
print(issued["document"]["docNumber"])   # 1042

$ npm i -g billos
$ billos login
  a code appears; approve it in the console, the key arrives here

$ billos invoice --customer "דנה לוי" --amount 350 --type invoice-receipt
חשבונית מס/קבלה 1042  ·  ₪350.00  ·  דנה לוי

$ billos docs --json | jq '.documents[0].docNumber'
1042

// Claude, Cursor, or anything that speaks MCP. Nine tools, the same key, the same ledger.
{
  "mcpServers": {
    "billos": {
      "url": "https://api.billos.co.il/mcp",
      "headers": { "X-Api-Key": "bk_live_..." }
    }
  }
}

// "תוציא קבלה על 350 שקל לדנה לוי"  →  create_document  →  חשבונית מס/קבלה 1042

{ "document": { "id": "doc_k3t8…", "docNumber": 1042,
    "status": "issued", "totalIncVat": 35000, "vatAmount": 5339 } }