Ledger Entry

Stores financial transaction details. You must have the financials ConventionPrivilege to access this, or be the leader of the Group that controls the ledger. Ledger Entrys are accessed via /api/ledgerentry.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in LedgerEntryProperties.

Related Objects

See "Related Objects" in Introduction for how to use them.

convention

The Convention this ledger entry belongs to (if any).

conventionreceipt

The ConventionReceipt this ledger entry belongs to (if any).

group

The Group this ledger entry belongs to.

supplyorder

The SupplyOrder this ledger entry belongs to (if any).

Includes

See "Includes" in Introduction for how to use them.

receipt_payment

Includes payment information associated with the Ledger Entry. Requires the financials privilege. Field is returned in format:

 {
   "id" : "xxx",
   ...
   "receipt_payment" : {
     "receipt_order_number" : [integer],
     "payment_method" : [string],
     "payment_transaction_id" : [string],
   },
   ...
 }

Services

The services used to fetch and manipulate ledger entries.

Search Ledger Entries

This section describes basic searchability of Ledger Entries, which is now available across several endpoints.

Available Endpoints

To request badges, a user must make a request via an endpoint for a parent object.

Convention ledgerentries
Convention financials
ConventionReceipt
Group

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "category" : "badge",
          "amount" : 23.50,
          ...
        },
        ...
    ]
 }
Optional Params
Queryables

Pass a string query to search for a partial match in specifically allowed text fields.

Only the memo field can be queried.

memo
Qualifiers
amount
amount_real
badge_name

Use this field to do a partial search on badge name. (Like query but must be stated explicitly.)

cashdrawer_id
category

Options include:

adhoc_advertising
adhoc_av
adhoc_catering
adhoc_gifts
adhoc_guests
adhoc_misc
adhoc_venue
badge
badgediscount
booth
boothdiscount
boothaddon
boothaddondiscount
soldproduct
soldproductdiscount
sponsor
sponsordiscount
ticket
ticketdiscount
stripefees
ttefees
conveniencefees
tinyorderfees
refundfees
salestaxcharged
salestaxowed
convention_id
conventionreceipt_id
group_id
orderitem_type

Options are badge, booth, boothaddon, soldproduct, sponsor, ticket. For older conventions, use the category parameter instead. Otherwise, using the orderitem_type parameter should return pretty much the same results as using the same values for category.

orderitem_id

While you can use this field for searching, its real purpose is to allow you to easily get from a Ledger Entry to the order item it is for.

order_number

Limit ledger entries to a specific ConventionReceipt number.

payment_method

Options are stripe, cash.

refunds=1

A flag option, set to 1 or any non-empty/non-zero value. Returns all Ledger Entries for refunds.

supplyorder_id

Read Ledger Entry

 GET /api/ledgerentry/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "The Captain is Dead",
   ...
 }