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.

Repository @dracome.social did:plc:66dyrt2bmghwlmdteyizs5l3 namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritylibrary.dracome.social
Indexed

Record

record · key tid

Properties

acquisitionType

requiredref

How the actor came to own this edition.

catalogSnapshot

requiredref

Point-in-time work/edition metadata capture, refreshed from current catalog data at write time.

catalogTarget

requiredref

The work, and edition, this acquisition is about.

createdAt

requiredstring · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.

ISO 4217 currency code (e.g. "USD", "EUR", "GBP").

  • maxLength: 3

Yes/No/unset - field absence means "unset". Must be true when invoiceNumber is set.

Invoice or receipt number, for tax/accounting reference. Implies invoiceAvailable: true.

  • maxLength: 512
  • maxGraphemes: 128

notes

string

User-visible free-text notes.

  • maxLength: 8000
  • maxGraphemes: 2000

Price 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 · datetime

Canonical 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.

Free-text source/supplier, e.g. "Piper Verlag", "Amazon", "Sarah".

  • maxLength: 1024
  • maxGraphemes: 256

supplier

string

Supplier/vendor name, distinct from receivedFrom for detailed accounting use cases.

  • maxLength: 1024
  • maxGraphemes: 256

updatedAt

string · datetime

Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.