Create Bill | Papertracc Docs

curl -X POST https://api.papertracc.com/v1/bills \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "rate": 50000,
      "detail": "Consulting hours",
      "quantity": 10,
      "currency_code": "NGN",
      "amount": 500000,
      "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
      "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
      "sku": "SKU-1001"
    }
  ],
  "bill_date": "2026-06-18T10:00:00.000Z",
  "vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
  "due_date": "2026-07-18T10:00:00.000Z",
  "allow_post": false,
  "adjustments": [
    {
      "name": "VAT",
      "type": "PERCENTAGE_RATE",
      "value": 7.5,
      "amount": 37500,
      "operation": "ADDITION",
      "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9"
    }
  ]
}'

{
  "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 created bill"
}

Creates a bill. bill_date, account_number, vendor_id, and items are required. allow_post is optional; when true, the bill is posted immediately after creation (the workspace must have allow_create_and_post enabled, otherwise the request is rejected with 400). Send payment_term_id to put the bill on a payment term, or due_date for a fixed date; the term wins when both are sent. With neither, the vendor’s default term is used when it has one.

Requires the can_create_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.

Request

This endpoint expects an object.

itemslist of objectsRequired

bill_datedatetimeRequired

vendor_idstringRequiredformat: "uuid"

due_datedatetimeOptional

payment_term_idstringOptionalformat: "uuid"

Payment term to apply. Takes precedence over due_date. The document’s due dates and any early-payment discount are worked out from the term and returned in payment_schedule.

exchange_ratedoubleOptional

allow_postbooleanOptional

adjustmentslist of objectsOptional

Response

Created

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error