social.dracome.library.acquisition
A record of how an actor came to own a specific book edition (purchased, gift, review copy, etc.). Multiple acquisitions per edition are allowed; like library.marker, library.review, and library.state, this record uses key: "tid", and its rkey is an opaque identity that never changes.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | library.dracome.social |
| Indexed |
Record
record · key tidProperties
How the actor came to own this edition.
Point-in-time work/edition metadata capture, refreshed from current catalog data at write time.
The work, and edition, this acquisition is about.
Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.
currencyCode
stringISO 4217 currency code (e.g. "USD", "EUR", "GBP").
maxLength: 3
invoiceAvailable
booleanYes/No/unset - field absence means "unset". Must be true when invoiceNumber is set.
invoiceNumber
stringInvoice or receipt number, for tax/accounting reference. Implies invoiceAvailable: true.
maxLength: 512maxGraphemes: 128
notes
stringUser-visible free-text notes.
maxLength: 8000maxGraphemes: 2000
priceMinorUnits
integerPrice in the currency's minor units (e.g. cents for EUR/USD), not a float. Zero is valid and meaningful (distinguishes a recorded free copy from no price recorded, which is this field absent).
minimum: 0
receivedDate
string · datetimeCanonical UTC instant for the calendar day the book was received, serialized as ISO 8601 with a trailing Z suffix. Writers store midnight UTC of that day; the time-of-day component is insignificant. Same convention as library.defs#progressLogEntry.date.
receivedFrom
stringFree-text source/supplier, e.g. "Piper Verlag", "Amazon", "Sarah".
maxLength: 1024maxGraphemes: 256
supplier
stringSupplier/vendor name, distinct from receivedFrom for detailed accounting use cases.
maxLength: 1024maxGraphemes: 256
updatedAt
string · datetimeCanonical UTC instant serialized as ISO 8601 with a trailing Z suffix.