Prepare Bill | Papertracc Docs

{
  "data": {
    "id": "45c6e26d-e132-4548-8e2e-5bfc467cf94a",
    "items": [
      {
        "rate": "50000.00",
        "amount": "500000.00",
        "detail": "Consulting hours",
        "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "quantity": 10,
        "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
        "inventory_id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
        "currency_code": "NGN",
        "sku": "SKU-1001"
      }
    ],
    "amount": "250000.00",
    "status": "PENDING",
    "vendor": {
      "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
      "display_name": "Global Softworks"
    },
    "approval": 0,
    "due_date": "2026-07-18T10:00:00Z",
    "approvals": [],
    "bill_date": "2026-06-18T10:00:00Z",
    "documents": [],
    "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
    "created_at": "2026-06-18T10:00:00Z",
    "project_id": "spruce-demo",
    "adjustments": [
      {
        "name": "VAT",
        "type": "PERCENTAGE_RATE",
        "value": "7.50",
        "amount": "37500.00",
        "operation": "ADDITION",
        "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9"
      }
    ],
    "payment_schedule": null,
    "prepared_by": "user-token-hash",
    "currency_code": "NGN",
    "exchange_rate": "1.00",
    "bill_reference": "BILL-0001",
    "journal_status": "UNPOSTED"
  },
  "status": true,
  "message": "Successfully prepared bill"
}

Marks a bill as prepared for approval.

Requires the can_prepare_bill permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Path parameters

idstringRequired

Response

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error