Extracted Table Documentation
Documentation: erm_agreements_coverage_statement
Source:
Module: mod_agreements
Interface: coverage_statement
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
cs_id | UUID for coverage_statement | |
cs_start_issue | Earliest issue of the resource available as part of this coverage | |
cs_end_issue | Latest issue of the resource available as part of this coverage | |
cs_start_volume | Earliest volume of the resource available as part of this coverage | |
cs_end_volume | Latest volume of the resource available as part of this coverage | |
cs_resource_fk | The ID of the erm_resource to which this coverage_statement applies | |
cs_start_date | Earliest date of publication of material from the resource available as part of this coverage | |
cs_end_date | Latest date of publication of material from resource available as part of this coverage |
Documentation: erm_agreements_entitlement
Source:
Module: mod_agreements
Interface: entitlement
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
ent_id | UUID of Entitlement (aka Agreement Line) | |
ent_owner_fk | ID of Agreement (mod_agreements.subscription_agreement.sa_id) to which the entitlement belongs | |
ent_resource_fk | ID of the resource (mod_agreements.erm_resource.id, mod_agreements.package.id, mod_agreements.package_content_item.id ) which the Entitlement gives access to | |
ent_active_from | Date from which the entitlement was active in format yyyy-MM-dd. No time or timezone | |
ent_active_to | Date to which the entitlement was active in format yyyy-MM-dd. No time or timezone | |
ent_authority | Where an entitlement gives access to a resource described in a source other than the mod_agreements internal knowledgebase, the ent_authority is a way of identifying where the definition of the resource is held | |
ent_reference | Where an entitlement gives access to a resource described in a source other than the mod_agreements internal knowledgebase, the ent_reference is the ID for the resource in the source identified by ent_authority | |
ent_note | A textual note about the entitlement |
Documentation: erm_agreements_erm_resource
Source:
Module: mod_agreements
Interface: erm_resource
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | ID of erm_resource | |
res_name | Name of the resource (can be name of a package or other resource type or the title of a published work such as a book or journal) | |
res_type_fk | ID of reference data value for the type of resource. | |
res_subtype_fk | ID of reference data value for the subtype of resource |
Documentation: erm_agreements_holdings_coverage
Source:
Module: mod_agreements
Interface: holdings_coverage
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
co_id | UUID for holdings_coverage | |
co_start_issue | Earliest issue of the resource linked to the entitlement available as part of this coverage | |
co_end_issue | Latest issue of the resource linked to the entitlement available as part of this coverage | |
co_start_volume | Earliest volume of the resource linked to the entitlement available as part of this coverage | |
co_end_volume | Latest volume of the resource linked to the entitlement available as part of this coverage | |
co_ent_fk | The ID of the entitlement to which this holdings_coverage applies | |
co_start_date | Earliest date of publication of material from the resource linked to the entitlement available as part of this coverage | |
co_end_date | Latest date of publication of material from resourc linked to the entitlemente available as part of this coverage |
Documentation: erm_agreements_identifier
Source:
Module: mod_agreements
Interface: identifier
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id_id | UUID of identifier | |
id_ns_fk | ID of identifier namespace | |
id_value | Value of the identifier (i.e. the identifier string) |
Documentation: erm_agreements_identifier_namespace
Source:
Module: mod_agreements
Interface: identifier_namespace
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
idns_id | UUID of identifier_namespace | |
idns_value | Value of the namespace (i.e. the namespace name as a string) |
Documentation: erm_agreements_identifier_occurrence
Source:
Module: mod_agreements
Interface: identifier_occurrence
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
io_id | UUID of identifier occurrence | |
io_ti_fk | ID of title_instance which is linked to the identifier | |
io_status | ID of reference data value (mod_agreements.refdata_value.rdv_id) which describes the status of the identifier occurrence | |
io_identifier_fk | ID of the identifier which is ‘occurring’ against a title_instance |
Documentation: erm_agreements_order_line
Source:
Module: mod_agreements
Interface: order_line
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
pol_id | UUID of order_line record | |
pol_orders_fk | ID of purchase order line in Orders app | |
pol_owner_fk | ID of entitlement (mod_agreements.entitlement.ent_id) to which purchase order line is linked |
Documentation: erm_agreements_package
Source:
Module: mod_agreements
Interface: package
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | ID of package | |
pkg_vendor_id | ID of the package provider organisation (in mod_agreements.orgs) | |
pkg_source | String describing the source of the package data | |
pkg_remote_kb | ID of the remote knowledgebase from which the package data was obtained (in mod_agreements.remotekb) | |
pkg_reference | ID or reference for the package in an external system |
Documentation: erm_agreements_package_content_item
Source:
Module: mod_agreements
Interface: package_content_item
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | ID of the package content item | |
pci_pti_fk | ID of the platform_title_instance that the package_content_item is linked to | |
pci_pkg_fk | ID of the package that the package_content_item belongs to | |
pci_access_start | The date on which a package_content_item was first accessible in a package | |
pci_access_end | The date on which a package_content_item was last accessible in a package |
Documentation: erm_agreements_platform
Source:
Module: mod_agreements
Interface: platform
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
pt_id | UUID of Platform | |
pt_name | Name/label of the platform |
Documentation: erm_agreements_platform_title_instance
Source:
Module: mod_agreements
Interface: platform_title_instance
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | ID of the platform_title_instance | |
pti_pt_fk | The ID of the platform that the platform_title_instance belongs to | |
pti_ti_fk | The ID of the title_instance to which the platform_title_instance is linked | |
pti_url | The URL of the platform_title_instance |
Documentation: erm_agreements_subscription_agreement
Source:
Module: mod_agreements
Interface: subscription_agreement
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
sa_id | UUID of Agreement | |
sa_name | A name for the agreement assigned by the institution | |
sa_description | A description for the agreement assigned by the institution | |
sa_agreement_status | ID of reference data value (mod_agreements.refdata_value.rdv_id) which describes the current status of the agreement (e.g. Active, Closed) | |
sa_reason_for_closure | ID of reference data value (mod_agreements.refdata_value.rdv_id) which describes for a closed agreement, the reason the agreement has been closed (a closed agreement is one with status == “Closed” - set via sa_agreement_status) | |
sa_renewal_priority | ID of reference data value (mod_agreements.refdata_value.rdv_id) which describes whether an agreement should be renewed, reviewed or cancelled | |
sa_is_perpetual | ID of reference data value (mod_agreements.refdata_value.rdv_id) which describes whether the agreement is a perpetual agreement or not | |
sa_local_reference | Where an agreement has been created through an integration / data import from an external system the sa_local_reference is used to store a reference/identifier for the agreement in the external system to support ongoing data synchronisation/updates | |
sa_license_note | To record any general information about the license for the Agreement | |
custom_properties_id | ID used to link custom_properties (aka supplementary properties) via mod_agreements.custom_properties.parent_id to an agreement. (n.b. each agreement can have zero to many custom_properties) |
Documentation: erm_agreements_title_instance
Source:
Module: mod_agreements
Interface: title_instance
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | ID of the title_instance | |
ti_work_fk | The ID of the work to which the title_instance is linked | |
ti_date_monograph_published | For monographs (books), the date the monograph was first published in the media specified by the linked erm_resource subtype (typically “print” or “electronic”) | |
ti_first_author | For monographs (books), the last name of the book’s first author. | |
ti_monograph_edition | For monographs (books), the last name of the book’s first author. | |
ti_monograph_volume | For monographs (books), the volume number of the book | |
ti_first_editor | For monographs (books), the last name of the book’s first editor. |
Documentation: erm_agreements_work
Source:
Module: mod_agreements
Interface: work
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
w_id | UUID of Work | |
w_title | Title of the work |
Documentation: audit_circulation_logs
Source:
Module: mod-audit
Interface: /audit-data/circulation/logs
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
eventId | string | The UUID format string |
userBarcode | string | User barcode |
items | array | Notice items |
items/itemBarcode | string | Item barcode |
items/itemId | string | The UUID format string |
items/instanceId | string | The UUID format string |
items/holdingId | string | The UUID format string |
items/loanId | string | The UUID format string |
object | string | The purchase order line format |
action | string | The purchase order line format |
date | string | Event date |
servicePointId | string | The UUID format string |
source | string | Source |
description | string | Description |
linkToIds | object | Additional data for details |
linkToIds/userId | string | The UUID format string |
linkToIds/requestId | string | The UUID format string |
linkToIds/feeFineId | string | The UUID format string |
linkToIds/templateId | string | The UUID format string |
linkToIds/noticePolicyId | string | The UUID format string |
Documentation: audit_acquisition_order
Source:
Module: mod-audit
Interface: /audit-data/acquisition/order
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
action | string | The action of the audit event |
orderId | string | The UUID format string |
userId | string | The UUID format string |
eventDate | string | Date time when event triggered |
actionDate | string | Date time when order action occurred |
orderSnapshot | object | Full snapshot of the order |
Documentation: audit_acquisition_order_line
Source:
Module: mod-audit
Interface: /audit-data/acquisition/order-line
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
action | string | The action of the audit event |
orderId | string | The UUID format string |
orderLineId | string | The UUID format string |
userId | string | The UUID format string |
eventDate | string | Date time when event triggered |
actionDate | string | Date time when order action occurred |
orderLineSnapshot | object | Full snapshot of the order line |
Documentation: circulation_cancellation_reasons
Source:
Module: mod-circulation-storage
Interface: /cancellation-reason-storage/cancellation-reasons
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | Reason name |
description | string | Internal reason description |
publicDescription | string | Public reason description |
requiresAdditionalInformation | boolean | Flag that indicates whether reason requires additional information |
source | string | Origin of the cancellation reason record, e.g. ‘System’, ‘User’, ‘Consortium’ etc. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_check_ins
Source:
Module: mod-circulation-storage
Interface: /check-in-storage/check-ins
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
occurredDateTime | string | Date and time when the check-in occurred |
itemId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
itemStatusPriorToCheckIn | string | Item status prior to check-in |
requestQueueSize | integer | Request queue size for the item |
itemLocationId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
servicePointId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
performedByUserId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: circulation_fixed_due_date_schedules
Source:
Module: mod-circulation-storage
Interface: /fixed-due-date-schedule-storage/fixed-due-date…
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique ID (generated UUID) |
name | string | Schedule name |
description | string | Schedule description |
schedules | array | List date ranges with a due date for each |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_loan_history
Source:
Module: mod-circulation-storage
Interface: /loan-storage/loan-history
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique ID (generated UUID) of the snapshot of the loan record |
operation | string | Type of change that triggered this loan record snapshot: I for insert, U for update, D for delete |
creationDate | string | When this snapshot was created |
loan | object | Links the item with the patron and applies certain conditions based on policies |
loan/id | string | Unique ID (generated UUID) of the loan |
loan/userId | string | ID of the patron the item was lent to. Required for open loans, not required for closed loans (for anonymization). |
loan/proxyUserId | string | ID of the user representing a proxy for the patron |
loan/itemId | string | ID of the item lent to the patron |
loan/itemEffectiveLocationIdAtCheckOut | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
loan/status | object | Overall status of the loan |
loan/status/name | string | Name of the status (currently can be any value, values commonly used are Open and Closed) |
loan/loanDate | string | Date time when the loan began (typically represented according to rfc3339 section-5.6. Has not had the date-time format validation applied as was not supported at point of introduction and would now be a breaking change) |
loan/dueDate | string | Date time when the item is due to be returned |
loan/returnDate | string | Date time when the item is returned and the loan ends (typically represented according to rfc3339 section-5.6. Has not had the date-time format validation applied as was not supported at point of introduction and would now be a breaking change) |
loan/systemReturnDate | string | Date time when the returned item is actually processed |
loan/action | string | Last action performed on a loan (currently can be any value, values commonly used are checkedout and checkedin) |
loan/actionComment | string | Comment to last action performed on a loan |
loan/itemStatus | string | Last item status used in relation to this loan (currently can be any value, values commonly used are Checked out and Available) |
loan/renewalCount | integer | Count of how many times a loan has been renewed (incremented by the client) |
loan/loanPolicyId | string | ID of last policy used in relation to this loan |
loan/checkoutServicePointId | string | ID of the Service Point where the last checkout occured |
loan/checkinServicePointId | string | ID of the Service Point where the last checkin occured |
loan/patronGroupIdAtCheckout | string | Patron Group Id at checkout |
loan/dueDateChangedByRecall | boolean | Indicates whether or not this loan had its due date modified by a recall on the loaned item |
loan/isDcb | boolean | Indicates whether or not this loan is associated for DCB use case |
loan/declaredLostDate | string | Date and time the item was declared lost during this loan |
loan/claimedReturnedDate | string | Date and time the item was claimed returned for this loan |
loan/overdueFinePolicyId | string | ID of overdue fines policy at the time the item is check-in or renewed |
loan/lostItemPolicyId | string | ID of lost item policy which determines when the item ages to lost and the associated fees or the associated fees if the patron declares the item lost. |
loan/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
loan/metadata/createdDate | string | Date and time when the record was created |
loan/metadata/createdByUserId | string | ID of the user who created the record (when available) |
loan/metadata/createdByUsername | string | Username of the user who created the record (when available) |
loan/metadata/updatedDate | string | Date and time when the record was last updated |
loan/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
loan/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
loan/agedToLostDelayedBilling | object | Aged to Lost Delayed Billing processing |
loan/agedToLostDelayedBilling/lostItemHasBeenBilled | boolean | Indicates if the aged to lost fee has been billed (for use where delayed billing is set up) |
loan/agedToLostDelayedBilling/dateLostItemShouldBeBilled | string | Indicates when the aged to lost fee should be billed (for use where delayed billing is set up) |
loan/agedToLostDelayedBilling/agedToLostDate | string | Date and time the item was aged to lost for this loan |
loan/reminders | object | Information about reminders for overdue loan |
loan/reminders/lastFeeBilled | object | Information about the most recent reminder fee billing |
loan/reminders/lastFeeBilled/number | integer | Last reminder fee billed, sequence number |
loan/reminders/lastFeeBilled/date | string | Last reminder fee billed, date |
Documentation: circulation_loan_policies
Source:
Module: mod-circulation-storage
Interface: /loan-policy-storage/loan-policies
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | The name of the policy. |
description | string | Description of the loan policy |
loanable | boolean | Flag that indicates whether this policy allows loans |
loansPolicy | object | Settings for loans |
loansPolicy/profileId | string | Loan profile |
loansPolicy/period | object | Time interval defined by its duration |
loansPolicy/period/duration | integer | Duration of the period, number of times the interval repeats |
loansPolicy/period/intervalId | string | Interval for the period, e.g. hours, days or weeks |
loansPolicy/closedLibraryDueDateManagementId | string | Closed library due date management |
loansPolicy/gracePeriod | object | Time interval defined by its duration |
loansPolicy/gracePeriod/duration | integer | Duration of the period, number of times the interval repeats |
loansPolicy/gracePeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
loansPolicy/openingTimeOffset | object | Time interval defined by its duration |
loansPolicy/openingTimeOffset/duration | integer | Duration of the period, number of times the interval repeats |
loansPolicy/openingTimeOffset/intervalId | string | Interval for the period, e.g. hours, days or weeks |
loansPolicy/fixedDueDateScheduleId | string | Fixed due date schedule (due date limit) |
loansPolicy/itemLimit | integer | Number of items allowed |
renewable | boolean | Is item renewable |
renewalsPolicy | object | Settings for renewals |
renewalsPolicy/unlimited | boolean | Unlimited renewals |
renewalsPolicy/numberAllowed | number | Number of renewals allowed |
renewalsPolicy/renewFromId | string | Renew from date |
renewalsPolicy/differentPeriod | boolean | Renewal period different from original loan |
renewalsPolicy/period | object | Time interval defined by its duration |
renewalsPolicy/period/duration | integer | Duration of the period, number of times the interval repeats |
renewalsPolicy/period/intervalId | string | Interval for the period, e.g. hours, days or weeks |
renewalsPolicy/alternateFixedDueDateScheduleId | string | Alternate fixed due date schedule (due date limit) for renewals |
requestManagement | object | Settings for various request types |
requestManagement/recalls | object | Settings for recall requests |
requestManagement/recalls/alternateGracePeriod | object | Time interval defined by its duration |
requestManagement/recalls/alternateGracePeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/recalls/alternateGracePeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/recalls/minimumGuaranteedLoanPeriod | object | Time interval defined by its duration |
requestManagement/recalls/minimumGuaranteedLoanPeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/recalls/minimumGuaranteedLoanPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/recalls/recallReturnInterval | object | Time interval defined by its duration |
requestManagement/recalls/recallReturnInterval/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/recalls/recallReturnInterval/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/recalls/allowRecallsToExtendOverdueLoans | boolean | Whether recalls are allowed to extend overdue loans |
requestManagement/recalls/alternateRecallReturnInterval | object | Time interval defined by its duration |
requestManagement/recalls/alternateRecallReturnInterval/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/recalls/alternateRecallReturnInterval/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/holds | object | Settings for hold requests |
requestManagement/holds/alternateCheckoutLoanPeriod | object | Time interval defined by its duration |
requestManagement/holds/alternateCheckoutLoanPeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/holds/alternateCheckoutLoanPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/holds/renewItemsWithRequest | boolean | Allow renewal of items with active, pending hold request |
requestManagement/holds/alternateRenewalLoanPeriod | object | Time interval defined by its duration |
requestManagement/holds/alternateRenewalLoanPeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/holds/alternateRenewalLoanPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/pages | object | Settings for page requests |
requestManagement/pages/alternateCheckoutLoanPeriod | object | Time interval defined by its duration |
requestManagement/pages/alternateCheckoutLoanPeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/pages/alternateCheckoutLoanPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
requestManagement/pages/renewItemsWithRequest | boolean | Allow renewal of items with active, pending page request |
requestManagement/pages/alternateRenewalLoanPeriod | object | Time interval defined by its duration |
requestManagement/pages/alternateRenewalLoanPeriod/duration | integer | Duration of the period, number of times the interval repeats |
requestManagement/pages/alternateRenewalLoanPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_loans
Source:
Module: mod-circulation-storage
Interface: /loan-storage/loans
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique ID (generated UUID) of the loan |
userId | string | ID of the patron the item was lent to. Required for open loans, not required for closed loans (for anonymization). |
proxyUserId | string | ID of the user representing a proxy for the patron |
itemId | string | ID of the item lent to the patron |
itemEffectiveLocationIdAtCheckOut | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
status | object | Overall status of the loan |
status/name | string | Name of the status (currently can be any value, values commonly used are Open and Closed) |
loanDate | string | Date time when the loan began (typically represented according to rfc3339 section-5.6. Has not had the date-time format validation applied as was not supported at point of introduction and would now be a breaking change) |
dueDate | string | Date time when the item is due to be returned |
returnDate | string | Date time when the item is returned and the loan ends (typically represented according to rfc3339 section-5.6. Has not had the date-time format validation applied as was not supported at point of introduction and would now be a breaking change) |
systemReturnDate | string | Date time when the returned item is actually processed |
action | string | Last action performed on a loan (currently can be any value, values commonly used are checkedout and checkedin) |
actionComment | string | Comment to last action performed on a loan |
itemStatus | string | Last item status used in relation to this loan (currently can be any value, values commonly used are Checked out and Available) |
renewalCount | integer | Count of how many times a loan has been renewed (incremented by the client) |
loanPolicyId | string | ID of last policy used in relation to this loan |
checkoutServicePointId | string | ID of the Service Point where the last checkout occured |
checkinServicePointId | string | ID of the Service Point where the last checkin occured |
patronGroupIdAtCheckout | string | Patron Group Id at checkout |
dueDateChangedByRecall | boolean | Indicates whether or not this loan had its due date modified by a recall on the loaned item |
isDcb | boolean | Indicates whether or not this loan is associated for DCB use case |
declaredLostDate | string | Date and time the item was declared lost during this loan |
claimedReturnedDate | string | Date and time the item was claimed returned for this loan |
overdueFinePolicyId | string | ID of overdue fines policy at the time the item is check-in or renewed |
lostItemPolicyId | string | ID of lost item policy which determines when the item ages to lost and the associated fees or the associated fees if the patron declares the item lost. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
agedToLostDelayedBilling | object | Aged to Lost Delayed Billing processing |
agedToLostDelayedBilling/lostItemHasBeenBilled | boolean | Indicates if the aged to lost fee has been billed (for use where delayed billing is set up) |
agedToLostDelayedBilling/dateLostItemShouldBeBilled | string | Indicates when the aged to lost fee should be billed (for use where delayed billing is set up) |
agedToLostDelayedBilling/agedToLostDate | string | Date and time the item was aged to lost for this loan |
reminders | object | Information about reminders for overdue loan |
reminders/lastFeeBilled | object | Information about the most recent reminder fee billing |
reminders/lastFeeBilled/number | integer | Last reminder fee billed, sequence number |
reminders/lastFeeBilled/date | string | Last reminder fee billed, date |
Documentation: circulation_patron_action_sessions
Source:
Module: mod-circulation-storage
Interface: /patron-action-session-storage/patron-action-se…
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
sessionId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
patronId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
loanId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
actionType | string | Defines action type |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_patron_notice_policies
Source:
Module: mod-circulation-storage
Interface: /patron-notice-policy-storage/patron-notice-pol…
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Patron notice policy id, UUID |
name | string | Patron notice policy name |
description | string | Patron notice policy description |
active | boolean | A flag to determine if a patron notice policy is active |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
loanNotices | array | List of loan notices |
loanNotices/name | string | Notice name |
loanNotices/templateId | string | Template id, UUID |
loanNotices/templateName | string | Template name |
loanNotices/format | string | Notice format, send through email, sms etc. |
loanNotices/frequency | string | Frequency, send it once or more |
loanNotices/realTime | boolean | Is this real time event |
loanNotices/sendOptions | object | Notice sending options |
loanNotices/sendOptions/sendHow | string | Defines how notice should be sent, before, after or upon |
loanNotices/sendOptions/sendWhen | string | Triggering event |
loanNotices/sendOptions/sendBy | object | Time interval |
loanNotices/sendOptions/sendBy/duration | integer | Interval duration, number of time units |
loanNotices/sendOptions/sendBy/intervalId | string | Unit of time |
loanNotices/sendOptions/sendEvery | object | Time interval |
loanNotices/sendOptions/sendEvery/duration | integer | Interval duration, number of time units |
loanNotices/sendOptions/sendEvery/intervalId | string | Unit of time |
feeFineNotices | array | List of fee/fine notices |
feeFineNotices/name | string | Notice name |
feeFineNotices/templateId | string | Template id, UUID |
feeFineNotices/templateName | string | Template name |
feeFineNotices/format | string | Notice format, send through email, sms etc. |
feeFineNotices/frequency | string | Frequency, send it once or more |
feeFineNotices/realTime | boolean | Is this real time event |
feeFineNotices/sendOptions | object | Notice sending options |
feeFineNotices/sendOptions/sendHow | string | Defines how notice should be sent: after or upon |
feeFineNotices/sendOptions/sendWhen | string | Triggering event |
feeFineNotices/sendOptions/sendBy | object | Time interval |
feeFineNotices/sendOptions/sendBy/duration | integer | Interval duration, number of time units |
feeFineNotices/sendOptions/sendBy/intervalId | string | Unit of time |
feeFineNotices/sendOptions/sendEvery | object | Time interval |
feeFineNotices/sendOptions/sendEvery/duration | integer | Interval duration, number of time units |
feeFineNotices/sendOptions/sendEvery/intervalId | string | Unit of time |
requestNotices | array | List of request notice |
requestNotices/name | string | Notice name |
requestNotices/templateId | string | Template id, UUID |
requestNotices/templateName | string | Template name |
requestNotices/format | string | Notice format, send through email, sms etc. |
requestNotices/frequency | string | Frequency, send it once or more |
requestNotices/realTime | boolean | Is this real time event |
requestNotices/sendOptions | object | Notice sending options |
requestNotices/sendOptions/sendHow | string | Defines how notice should be sent, before, after or upon |
requestNotices/sendOptions/sendWhen | string | User initiated and time driven events for request related notices |
requestNotices/sendOptions/sendBy | object | Time interval |
requestNotices/sendOptions/sendBy/duration | integer | Interval duration, number of time units |
requestNotices/sendOptions/sendBy/intervalId | string | Unit of time |
requestNotices/sendOptions/sendEvery | object | Time interval |
requestNotices/sendOptions/sendEvery/duration | integer | Interval duration, number of time units |
requestNotices/sendOptions/sendEvery/intervalId | string | Unit of time |
Documentation: circulation_request_policies
Source:
Module: mod-circulation-storage
Interface: /request-policy-storage/request-policies
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique request policy ID |
name | string | Unique request policy name, required |
description | string | Description of request policy |
requestTypes | array | Whether the item should be held upon return, recalled or paged for |
allowedServicePoints | object | Allowed pickup service point IDs by request type |
allowedServicePoints/Page | [‘array’, ‘null’] | List of allowed pickup service point IDs |
allowedServicePoints/Hold | [‘array’, ‘null’] | List of allowed pickup service point IDs |
allowedServicePoints/Recall | [‘array’, ‘null’] | List of allowed pickup service point IDs |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_request_preference
Source:
Module: mod-circulation-storage
Interface: /request-preference-storage/request-preference
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique request preference ID |
userId | string | UUID of user associated with this request preference |
holdShelf | boolean | Whether ‘Hold Shelf’ option is available to the user. |
delivery | boolean | Whether ‘Delivery’ option is available to the user. |
defaultServicePointId | string | UUID of default service point for ‘Hold Shelf’ option |
defaultDeliveryAddressTypeId | string | UUID of user’s address type |
fulfillment | string | Preferred fulfillment type. Possible values are ‘Delivery’, ‘Hold Shelf’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_requests
Source:
Module: mod-circulation-storage
Interface: /request-storage/requests
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | UUID of the request |
requestLevel | string | Level of the request - Item or Title |
requestType | string | Whether the item should be held upon return, recalled or paged for |
ecsRequestPhase | string | Stage in ECS request process, absence of this field means this is a single-tenant request |
requestDate | string | Date the request was made |
patronComments | string | Comments made by the patron |
requesterId | string | ID of the requesting patron (user) |
proxyUserId | string | ID of the user representing a proxy for the patron |
instanceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
holdingsRecordId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
itemId | string | ID of the item being requested |
status | string | Status of the request |
cancellationReasonId | string | The id of the relevant request reason |
cancelledByUserId | string | The id of the user that cancelled the request |
cancellationAdditionalInformation | string | Potential relevant information regarding a cancellation |
cancelledDate | string | Date the request was cancelled |
position | integer | Position of the request in the unified request queue |
instance | object | Copy of some instance metadata (used for searching and sorting) |
instance/title | string | title of the item |
instance/identifiers | array | An extensible set of name-value pairs of identifiers associated with the resource |
instance/identifiers/value | string | Resource identifier value |
instance/identifiers/identifierTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
item | object | Copy of some item metadata (used for searching and sorting) |
item/barcode | string | barcode of the item |
item/itemEffectiveLocationId | string | Item’s effective location |
item/itemEffectiveLocationName | string | Item’s effective location name |
item/retrievalServicePointId | string | Item’s location primary service point |
item/retrievalServicePointName | string | Item’s location primary service point name |
requester | object | Copy of some requesting patron metadata (used for searching and sorting) |
requester/firstName | string | first name of the requesting patron |
requester/lastName | string | last name of the requesting patron |
requester/middleName | string | middle name of the requesting patron |
requester/barcode | string | barcode of the requesting patron |
requester/patronGroup | string | DEPRECATED, to be removed in subsequent major version |
proxy | object | Copy of some proxy patron metadata (used for searching and sorting) |
proxy/firstName | string | first name of the proxy patron |
proxy/lastName | string | last name of the proxy patron |
proxy/middleName | string | middle name of the proxy patron |
proxy/barcode | string | barcode of the proxy patron |
proxy/patronGroup | string | DEPRECATED, to be removed in subsequent major version |
fulfillmentPreference | string | How should the request be fulfilled (whether the item should be kept on the hold shelf for collection or delivered to the requester) |
deliveryAddressTypeId | string | Deliver to the address of this type, for the requesting patron |
requestExpirationDate | string | Date when the request expires |
holdShelfExpirationDate | string | Date when an item returned to the hold shelf expires |
pickupServicePointId | string | The ID of the Service Point where this request can be picked up |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
printDetails | object | PrintDetails |
printDetails/printCount | integer | Number of times print slip generated. |
printDetails/requesterId | string | UUID of print slip requester. |
printDetails/isPrinted | boolean | Whether print slip was printed in past. |
printDetails/printEventDate | string | Date and time when print slip was generated last time. |
awaitingPickupRequestClosedDate | string | A date when the request with awaiting pickup status was closed |
searchIndex | object | Request fields used for search |
searchIndex/callNumberComponents | object | Effective call number components |
searchIndex/callNumberComponents/callNumber | string | Effective Call Number is an identifier assigned to an item or its holding and associated with the item. |
searchIndex/callNumberComponents/prefix | string | Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item. |
searchIndex/callNumberComponents/suffix | string | Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item. |
searchIndex/shelvingOrder | string | A system generated normalization of the call number that allows for call number sorting in reports and search results |
searchIndex/pickupServicePointName | string | The name of the request pickup service point |
itemLocationCode | string | Allow specifying item location when creating title-level requests |
isDcbReRequestCancellation | boolean | Indicates if the request was cancelled during a DCB transaction update. This determines whether the Kafka event will be handled and if an email notification will be sent |
Documentation: circulation_scheduled_notices
Source:
Module: mod-circulation-storage
Interface: /scheduled-notice-storage/scheduled-notices
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
loanId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
requestId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
feeFineActionId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
recipientUserId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
sessionId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
nextRunTime | string | Next run time |
triggeringEvent | string | Scheduled notice triggering event |
noticeConfig | object | Scheduled notice configuration |
noticeConfig/timing | string | Timing represents when we need to send notice, before, at or after loan due date |
noticeConfig/recurringPeriod | object | Time interval defined by its duration |
noticeConfig/recurringPeriod/duration | integer | Duration of the period, number of times the interval repeats |
noticeConfig/recurringPeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
noticeConfig/templateId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
noticeConfig/format | string | Notice format |
noticeConfig/sendInRealTime | boolean | Real time notice flag |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: circulation_staff_slips
Source:
Module: mod-circulation-storage
Interface: /staff-slips-storage/staff-slips
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | Staff slip name |
description | string | Staff slip description |
active | boolean | Flag that indicates whether staff slip is active |
isRawHtml | boolean | Flag that indicates whether staff slip should be maintained as raw HTML rather than using the WYSIWYG editor. This has no implications for the back-end code, as is merely a note from the UI to itself. |
template | string | Staff slip template |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: configuration_entries
Source:
Module: mod-configuration
Interface: /configurations/entries
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
module | string | |
configName | string | |
code | string | |
description | string | |
default | boolean | |
enabled | boolean | |
value | string | |
userId | string | |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_copyrightstatuses
Source:
Module: mod-courses
Interface: /coursereserves/copyrightstatuses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of the type |
description | string | A description of this type |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_courselistings
Source:
Module: mod-courses
Interface: /coursereserves/courselistings
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
registrarId | string | The registration id |
externalId | string | An external identifier associated with this listing |
servicepointId | string | A UUID |
servicepointObject | object | The service point associated with this listing’s reserves |
servicepointObject/id | string | Id of service-point object |
servicepointObject/name | string | service-point name, a required field |
servicepointObject/code | string | service-point code, a required field |
servicepointObject/discoveryDisplayName | string | display name, a required field |
servicepointObject/description | string | description of the service-point |
servicepointObject/shelvingLagTime | integer | shelving lag time |
servicepointObject/pickupLocation | boolean | indicates whether or not the service point is a pickup location |
servicepointObject/holdShelfExpiryPeriod | object | schema for time-period, which contains time interval ‘duration’ and the time unit |
servicepointObject/holdShelfExpiryPeriod/duration | integer | Duration interval |
servicepointObject/holdShelfExpiryPeriod/intervalId | string | Unit of time for the duration |
servicepointObject/staffSlips | array | List of staff slips for this service point |
servicepointObject/staffSlips/id | string | The ID of the staff slip |
servicepointObject/staffSlips/printByDefault | boolean | Whether or not to print the staff slip by default |
locationId | string | A UUID |
locationObject | object | The location associated with this listing’s reserves |
locationObject/id | string | id of this (shelf) location record as UUID. |
locationObject/name | string | Name of the (shelf) location |
locationObject/code | string | Code of the (shelf) location, usually an abbreviation of the name. |
locationObject/description | string | Description of the (shelf) location. |
locationObject/discoveryDisplayName | string | Name of the (shelf) location to be shown in the discovery. |
locationObject/isActive | boolean | Whether this (shelf) location is active. Inactive (shelf) locations can no longer been used. |
locationObject/institutionId | string | The UUID of the institution, the first-level location unit, this (shelf) location belongs to. |
locationObject/campusId | string | The UUID of the campus, the second-level location unit, this (shelf) location belongs to. |
locationObject/libraryId | string | The UUID of the library, the third-level location unit, this (shelf) location belongs to. |
locationObject/details | object | Details about this (shelf) location. |
locationObject/primaryServicePoint | string | The UUID of the primary service point of this (shelf) location. |
locationObject/servicePointIds | array | All service points that this (shelf) location has. |
termId | string | A UUID |
termObject | object | Temporal periods that listings exist in |
termObject/id | string | A UUID |
termObject/name | string | The name of period |
termObject/startDate | string | The beginning of the time period |
termObject/endDate | string | The ending of the time period |
termObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
termObject/metadata/createdDate | string | Date and time when the record was created |
termObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
termObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
termObject/metadata/updatedDate | string | Date and time when the record was last updated |
termObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
termObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
courseTypeId | string | A UUID |
courseTypeObject | object | The type of course a listing is |
courseTypeObject/id | string | A UUID |
courseTypeObject/name | string | The name of the type |
courseTypeObject/description | string | A description of this type |
courseTypeObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
courseTypeObject/metadata/createdDate | string | Date and time when the record was created |
courseTypeObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
courseTypeObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
courseTypeObject/metadata/updatedDate | string | Date and time when the record was last updated |
courseTypeObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
courseTypeObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
instructorObjects | array | A listing of associated instructor objects |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_courses
Source:
Module: mod-courses
Interface: /coursereserves/courses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of course |
description | string | A description of the course |
departmentId | string | A UUID |
departmentObject | object | The department a course belongs to |
departmentObject/id | string | A UUID |
departmentObject/name | string | The name of the department |
departmentObject/description | string | A description of this department |
departmentObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
departmentObject/metadata/createdDate | string | Date and time when the record was created |
departmentObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
departmentObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
departmentObject/metadata/updatedDate | string | Date and time when the record was last updated |
departmentObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
departmentObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
courseListingId | string | A UUID |
courseListingObject | object | An actual instantiation in time and space of a course |
courseListingObject/id | string | A UUID |
courseListingObject/registrarId | string | The registration id |
courseListingObject/externalId | string | An external identifier associated with this listing |
courseListingObject/servicepointId | string | A UUID |
courseListingObject/servicepointObject | object | The service point associated with this listing’s reserves |
courseListingObject/servicepointObject/id | string | Id of service-point object |
courseListingObject/servicepointObject/name | string | service-point name, a required field |
courseListingObject/servicepointObject/code | string | service-point code, a required field |
courseListingObject/servicepointObject/discoveryDisplayName | string | display name, a required field |
courseListingObject/servicepointObject/description | string | description of the service-point |
courseListingObject/servicepointObject/shelvingLagTime | integer | shelving lag time |
courseListingObject/servicepointObject/pickupLocation | boolean | indicates whether or not the service point is a pickup location |
courseListingObject/servicepointObject/holdShelfExpiryPeriod | object | schema for time-period, which contains time interval ‘duration’ and the time unit |
courseListingObject/servicepointObject/holdShelfExpiryPeriod/duration | integer | Duration interval |
courseListingObject/servicepointObject/holdShelfExpiryPeriod/intervalId | string | Unit of time for the duration |
courseListingObject/servicepointObject/staffSlips | array | List of staff slips for this service point |
courseListingObject/servicepointObject/staffSlips/id | string | The ID of the staff slip |
courseListingObject/servicepointObject/staffSlips/printByDefault | boolean | Whether or not to print the staff slip by default |
courseListingObject/locationId | string | A UUID |
courseListingObject/locationObject | object | The location associated with this listing’s reserves |
courseListingObject/locationObject/id | string | id of this (shelf) location record as UUID. |
courseListingObject/locationObject/name | string | Name of the (shelf) location |
courseListingObject/locationObject/code | string | Code of the (shelf) location, usually an abbreviation of the name. |
courseListingObject/locationObject/description | string | Description of the (shelf) location. |
courseListingObject/locationObject/discoveryDisplayName | string | Name of the (shelf) location to be shown in the discovery. |
courseListingObject/locationObject/isActive | boolean | Whether this (shelf) location is active. Inactive (shelf) locations can no longer been used. |
courseListingObject/locationObject/institutionId | string | The UUID of the institution, the first-level location unit, this (shelf) location belongs to. |
courseListingObject/locationObject/campusId | string | The UUID of the campus, the second-level location unit, this (shelf) location belongs to. |
courseListingObject/locationObject/libraryId | string | The UUID of the library, the third-level location unit, this (shelf) location belongs to. |
courseListingObject/locationObject/details | object | Details about this (shelf) location. |
courseListingObject/locationObject/primaryServicePoint | string | The UUID of the primary service point of this (shelf) location. |
courseListingObject/locationObject/servicePointIds | array | All service points that this (shelf) location has. |
courseListingObject/termId | string | A UUID |
courseListingObject/termObject | object | Temporal periods that listings exist in |
courseListingObject/termObject/id | string | A UUID |
courseListingObject/termObject/name | string | The name of period |
courseListingObject/termObject/startDate | string | The beginning of the time period |
courseListingObject/termObject/endDate | string | The ending of the time period |
courseListingObject/termObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
courseListingObject/termObject/metadata/createdDate | string | Date and time when the record was created |
courseListingObject/termObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
courseListingObject/termObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
courseListingObject/termObject/metadata/updatedDate | string | Date and time when the record was last updated |
courseListingObject/termObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
courseListingObject/termObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
courseListingObject/courseTypeId | string | A UUID |
courseListingObject/courseTypeObject | object | The type of course a listing is |
courseListingObject/courseTypeObject/id | string | A UUID |
courseListingObject/courseTypeObject/name | string | The name of the type |
courseListingObject/courseTypeObject/description | string | A description of this type |
courseListingObject/courseTypeObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
courseListingObject/courseTypeObject/metadata/createdDate | string | Date and time when the record was created |
courseListingObject/courseTypeObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
courseListingObject/courseTypeObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
courseListingObject/courseTypeObject/metadata/updatedDate | string | Date and time when the record was last updated |
courseListingObject/courseTypeObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
courseListingObject/courseTypeObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
courseListingObject/instructorObjects | array | A listing of associated instructor objects |
courseListingObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
courseListingObject/metadata/createdDate | string | Date and time when the record was created |
courseListingObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
courseListingObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
courseListingObject/metadata/updatedDate | string | Date and time when the record was last updated |
courseListingObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
courseListingObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
courseNumber | string | A unique code identifying this course |
sectionName | string | A text field denoting this course’s section |
numberOfStudents | integer | The number of students enrolled in this course |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_coursetypes
Source:
Module: mod-courses
Interface: /coursereserves/coursetypes
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of the type |
description | string | A description of this type |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_departments
Source:
Module: mod-courses
Interface: /coursereserves/departments
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of the department |
description | string | A description of this department |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_processingstatuses
Source:
Module: mod-courses
Interface: /coursereserves/processingstatuses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of the status |
description | string | A description of this status |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_reserves
Source:
Module: mod-courses
Interface: /coursereserves/reserves
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
courseListingId | string | A UUID |
itemId | string | A UUID |
processingStatusId | string | A UUID |
processingStatusObject | object | The processing status for a reserve |
processingStatusObject/id | string | A UUID |
processingStatusObject/name | string | The name of the status |
processingStatusObject/description | string | A description of this status |
processingStatusObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
processingStatusObject/metadata/createdDate | string | Date and time when the record was created |
processingStatusObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
processingStatusObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
processingStatusObject/metadata/updatedDate | string | Date and time when the record was last updated |
processingStatusObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
processingStatusObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
startDate | string | The beginning of the time period for this reserve |
endDate | string | The ending of the time period for this reserve |
copiedItem | object | Cached fields from the item record, for searching |
copiedItem/barcode | string | Item barcode, from item |
copiedItem/temporaryLocationId | string | Temporary Location ID, from item |
copiedItem/temporaryLocationObject | object | Location record populated from inventory for course-reserves |
copiedItem/temporaryLocationObject/id | string | |
copiedItem/temporaryLocationObject/name | string | name, copied from inventory |
copiedItem/temporaryLocationObject/code | string | code, copied from inventory |
copiedItem/temporaryLocationObject/description | string | description, copied from inventory |
copiedItem/temporaryLocationObject/discoveryDisplayName | string | discoveryDisplayName, copied from inventory |
copiedItem/temporaryLocationObject/isActive | boolean | isActive, copied from inventory |
copiedItem/temporaryLocationObject/institutionId | string | institutionId, copied from inventory |
copiedItem/temporaryLocationObject/campusId | string | campusId, copied from inventory |
copiedItem/temporaryLocationObject/libraryId | string | libraryId, copied from inventory |
copiedItem/temporaryLocationObject/details | object | details, copied from inventory |
copiedItem/temporaryLocationObject/primaryServicePoint | string | primaryServicePoint, copied from inventory |
copiedItem/temporaryLocationObject/servicePointIds | array | servicePointIds, copied from inventory |
copiedItem/permanentLocationId | string | Permanent Location ID, from item |
copiedItem/permanentLocationObject | object | Location record populated from inventory for course-reserves |
copiedItem/permanentLocationObject/id | string | |
copiedItem/permanentLocationObject/name | string | name, copied from inventory |
copiedItem/permanentLocationObject/code | string | code, copied from inventory |
copiedItem/permanentLocationObject/description | string | description, copied from inventory |
copiedItem/permanentLocationObject/discoveryDisplayName | string | discoveryDisplayName, copied from inventory |
copiedItem/permanentLocationObject/isActive | boolean | isActive, copied from inventory |
copiedItem/permanentLocationObject/institutionId | string | institutionId, copied from inventory |
copiedItem/permanentLocationObject/campusId | string | campusId, copied from inventory |
copiedItem/permanentLocationObject/libraryId | string | libraryId, copied from inventory |
copiedItem/permanentLocationObject/details | object | details, copied from inventory |
copiedItem/permanentLocationObject/primaryServicePoint | string | primaryServicePoint, copied from inventory |
copiedItem/permanentLocationObject/servicePointIds | array | servicePointIds, copied from inventory |
copiedItem/title | string | Title, from Instance |
copiedItem/contributors | array | Contributor information, from Instance |
copiedItem/contributors/name | string | Personal name, corporate name, meeting name |
copiedItem/contributors/contributorTypeId | string | ID for the contributor type term defined as a referencetable in settings |
copiedItem/contributors/contributorTypeText | string | Free text element for adding contributor type terms other that defined by the MARC code list for relators |
copiedItem/contributors/contributorNameTypeId | string | Contributor type terms defined by the MARC code list for relators |
copiedItem/contributors/primary | boolean | Whether this is the primary contributor |
copiedItem/publication | array | List of publication items, from Instance |
copiedItem/publication/publisher | string | Name of publisher, distributor, etc. |
copiedItem/publication/place | string | Place of publication, distribution, etc. |
copiedItem/publication/dateOfPublication | string | Date (year YYYY) of publication, distribution, etc. |
copiedItem/publication/role | string | The role of the publisher, distributor, etc. |
copiedItem/callNumber | string | The item’s call number |
copiedItem/uri | string | A URI to access the item |
copiedItem/volume | string | PENDING |
copiedItem/copy | string | PENDING |
copiedItem/enumeration | string | PENDING |
copiedItem/url | string | PENDING |
copiedItem/instanceId | string | The id of the associated instance record |
copiedItem/instanceHrid | string | The HRID of the associated instance record |
copiedItem/instanceDiscoverySuppress | boolean | Whether the associated instance record has been marked as suppressed from discovery |
copiedItem/holdingsId | string | The id of the associated holdings record |
temporaryLoanTypeId | string | A UUID |
temporaryLoanTypeObject | object | A loan type |
temporaryLoanTypeObject/id | string | |
temporaryLoanTypeObject/name | string | label for the loan type |
copyrightTracking | object | Information about copyright status, volume of material used, etc. |
copyrightTracking/additionalSectionsUsed | boolean | Additional sections of this item used in this course |
copyrightTracking/copyrightStatusId | string | A UUID |
copyrightTracking/copyrightStatusObject | object | The copyright status of a reserve |
copyrightTracking/copyrightStatusObject/id | string | A UUID |
copyrightTracking/copyrightStatusObject/name | string | The name of the type |
copyrightTracking/copyrightStatusObject/description | string | A description of this type |
copyrightTracking/copyrightStatusObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
copyrightTracking/copyrightStatusObject/metadata/createdDate | string | Date and time when the record was created |
copyrightTracking/copyrightStatusObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
copyrightTracking/copyrightStatusObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
copyrightTracking/copyrightStatusObject/metadata/updatedDate | string | Date and time when the record was last updated |
copyrightTracking/copyrightStatusObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
copyrightTracking/copyrightStatusObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
copyrightTracking/totalPagesInItem | integer | PENDING |
copyrightTracking/totalPagesUsed | integer | PENDING |
copyrightTracking/percentOfPages | string | Percent of pages used |
copyrightTracking/paymentBasis | string | PENDING |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_roles
Source:
Module: mod-courses
Interface: /coursereserves/roles
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of the role |
description | string | A description of this role |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: course_terms
Source:
Module: mod-courses
Interface: /coursereserves/terms
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A UUID |
name | string | The name of period |
startDate | string | The beginning of the time period |
endDate | string | The ending of the time period |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: email_email
Source:
Module: mod-email
Interface: /email
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
notificationId | string | notification identifier |
from | string | sender’s address |
to | string | address of the recipient |
header | string | subject of email |
outputFormat | string | format type: text/html or text/plain |
body | string | text of email |
attachments | array | attachment list |
status | string | status of email |
shouldRetry | boolean | Should retry sending email |
attemptCount | integer | Number of email sending attempts |
message | string | Server error message or other cause of the error |
date | string | The date the email was sent to the SMTP server |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: feesfines_accounts
Source:
Module: mod-feesfines
Interface: /accounts
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
amount | number | Amount of the fine/fee |
remaining | number | Remaining of the fine/fee |
dateCreated | string | Date and time the account of the fine/fee was created |
dateUpdated | string | Date and time the account of the fine/fee was updated |
status | object | Overall status of the fee/fine |
status/name | string | Name of the status (values used are Open and Closed) |
paymentStatus | object | Overall status of the payment/waive/transfer/refund/cancel |
paymentStatus/name | string | Name of the status |
feeFineType | string | Fee/fine that is up to the desecration of the user |
feeFineOwner | string | Owner of the fee/fine defined by the library and is associated with specific fees/fines |
title | string | The title associated with the item |
callNumber | string | Identifier (Call number) assigned to an item |
barcode | string | Text, with input likely validated by the barcode scanner |
materialType | string | Material type what define what type of thing the item is |
itemStatus | object | The status of the item |
itemStatus/name | string | Name of the item state |
location | string | Effective location is used to know the current home location for the item |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
dueDate | string | Date time when the item is due to be returned |
returnedDate | string | Date time when the item is returned and the loan ends, if the user does not have a loan associated, hyphen (-) is added as default |
loanId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
userId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
itemId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
materialTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
feeFineId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
ownerId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
holdingsRecordId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
instanceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
contributors | array | List of contributors |
contributors/name | string | Personal name, corporate name, meeting name |
loanPolicyId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
overdueFinePolicyId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
lostItemFeePolicyId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
processId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_comments
Source:
Module: mod-feesfines
Interface: /comments
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
paid | boolean | A flag to determine when paying if it is mandatory to add additional information |
waived | boolean | A flag to determine when waiving if it is mandatory to add additional information |
refunded | boolean | A flag to determine when refunding if it is mandatory to add additional information |
transferredManually | boolean | A flag to determine when transferring if it is mandatory to add additional information |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_feefineactions
Source:
Module: mod-feesfines
Interface: /feefineactions
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
dateAction | string | Date and time the transaction of the fine/fee was created |
typeAction | string | Type of activity including the type of transaction |
comments | string | Additional information entered as part of the activity or on this screen as a ‘Staff info only’ activity |
notify | boolean | A flag to determine if a patron should be notified or not |
amountAction | number | Amount of activity |
balance | number | Calculated amount of remaining balance based on original fee/fine and what has been paid/waived/transferred/refunded |
transactionInformation | string | Number or other transaction id related to payment |
createdAt | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
originalCreatedAt | string | Original invalid (non-UUID) value of ‘createdAt’ moved here when UUID-validation was enabled for ‘createdAt’ |
source | string | Person who processed activity (from login information) |
paymentMethod | string | Overall status of the action-setting |
accountId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
userId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_feefines
Source:
Module: mod-feesfines
Interface: /feefines
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
automatic | boolean | A flag to indicate that fee/fine was created automatically. |
feeFineType | string | Description of fee/fine that is up to the discretion of the user |
defaultAmount | number | Amount of fee or fine, which may be overridden. |
chargeNoticeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
actionNoticeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
ownerId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_lost_item_fees_policies
Source:
Module: mod-feesfines
Interface: /lost-item-fees-policies
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
name | string | Lost item fee policy name, is a required field |
description | string | Lost item fee policy description |
itemAgedLostOverdue | object | Period to lost item |
itemAgedLostOverdue/duration | integer | Duration of the number of times the interval repeats |
itemAgedLostOverdue/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
patronBilledAfterAgedLost | object | Period to lost item |
patronBilledAfterAgedLost/duration | integer | Duration of the number of times the interval repeats |
patronBilledAfterAgedLost/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
recalledItemAgedLostOverdue | object | Period to lost item |
recalledItemAgedLostOverdue/duration | integer | Duration of the number of times the interval repeats |
recalledItemAgedLostOverdue/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
patronBilledAfterRecalledItemAgedLost | object | Period to lost item |
patronBilledAfterRecalledItemAgedLost/duration | integer | Duration of the number of times the interval repeats |
patronBilledAfterRecalledItemAgedLost/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
chargeAmountItem | object | Charge amount for item |
chargeAmountItem/chargeType | string | Charge type amount for item may be Actual cost or an amount |
chargeAmountItem/amount | number | Charge amount for item may be Actual cost or an amount |
lostItemProcessingFee | number | Lost item processing fee, must be = 0 or > 0 |
chargeAmountItemPatron | boolean | A flag to determine charge lost item processing fee if item declared lost by patron must be Yes or No, with default set to Yes |
chargeAmountItemSystem | boolean | A flag to determine charge lost item processing fee if item aged to lost by system must be Yes or No, with default set to Yes |
lostItemChargeFeeFine | object | Period to lost item |
lostItemChargeFeeFine/duration | integer | Duration of the number of times the interval repeats |
lostItemChargeFeeFine/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
returnedLostItemProcessingFee | boolean | A flag to determine if lost item returned, remove lost item processing fee |
replacedLostItemProcessingFee | boolean | A flag to determine if lost item replaced, remove lost item processing fee |
replacementProcessingFee | number | Amount for replacement process fee |
replacementAllowed | boolean | A flag to determine replacement allowed |
lostItemReturned | string | Option to lost item returned may be Charge overdues based on returned date up to maximum (if applicable) or Remove overdue fines, with a default of _Charge overdues based on returned date up to maximum (if applicable) |
feesFinesShallRefunded | object | Period to lost item |
feesFinesShallRefunded/duration | integer | Duration of the number of times the interval repeats |
feesFinesShallRefunded/intervalId | string | Interval for the period, e.g. Hours, Days or Weeks |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_manualblocks
Source:
Module: mod-feesfines
Interface: /manualblocks
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
type | string | Type of patron block |
desc | string | Patron block description |
code | string | Code of the template if block is defined based on a template (optional) |
staffInformation | string | Additional information to staff (optional) |
patronMessage | string | Message to patron (optional) |
expirationDate | string | Date and time the patron block expiration if is provided the patron block should be automatically removed on that date |
borrowing | boolean | A flag to determine borrowing block action |
renewals | boolean | A flag to determine renewal block action |
requests | boolean | A flag to determine request block action |
userId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_overdue_fines_policies
Source:
Module: mod-feesfines
Interface: /overdue-fines-policies
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
name | string | Overdue fine policy name |
description | string | Overdue fine policy description |
overdueFine | object | Amount of times the interval repeats |
overdueFine/quantity | number | Fine amount per interval |
overdueFine/intervalId | string | Interval for the period, e.g. hour, day, week, month or year |
countClosed | boolean | A flag to determine if a fine is count closed |
maxOverdueFine | number | Maximum overdue fine |
forgiveOverdueFine | boolean | A flag to determine forgive overdue fine if item renewed |
overdueRecallFine | object | Amount of times the interval repeats |
overdueRecallFine/quantity | number | Fine amount per interval |
overdueRecallFine/intervalId | string | Interval for the period, e.g. hour, day, week, month or year |
gracePeriodRecall | boolean | Grace period for recall |
maxOverdueRecallFine | number | Maximum overdue recall fine |
reminderFeesPolicy | object | Reminder fee policy as part of overdue fine policy |
reminderFeesPolicy/countClosed | boolean | A flag to determine if a reminder fee should take closed days into account |
reminderFeesPolicy/ignoreGracePeriodRecall | boolean | Ignore grace period for recall |
reminderFeesPolicy/ignoreGracePeriodHolds | boolean | Ignore grace period for holds |
reminderFeesPolicy/allowRenewalOfItemsWithReminderFees | boolean | Allow renewal of items with reminder fee(s) |
reminderFeesPolicy/clearPatronBlockWhenPaid | boolean | Clear patron block when paid |
reminderFeesPolicy/reminderSchedule | array | Ordered list of reminder notices |
reminderFeesPolicy/reminderSchedule/interval | integer | Number of units of time before notice should be sent |
reminderFeesPolicy/reminderSchedule/timeUnitId | string | Time unit of interval |
reminderFeesPolicy/reminderSchedule/reminderFee | number | Fee amount accrued by reminder notice |
reminderFeesPolicy/reminderSchedule/noticeFormat | string | Method of sending notice |
reminderFeesPolicy/reminderSchedule/noticeTemplateId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
reminderFeesPolicy/reminderSchedule/blockTemplateId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_owners
Source:
Module: mod-feesfines
Interface: /owners
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
owner | string | Service desk (known as a fee/fine owner) is library-defined and is associated with specific fees/fines |
desc | string | Owner description |
servicePointOwner | array | Service points associated to a Owner |
servicePointOwner/value | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
servicePointOwner/label | string | Service-point name label |
defaultChargeNoticeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
defaultActionNoticeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_payments
Source:
Module: mod-feesfines
Interface: /payments
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
nameMethod | string | Payment method name |
allowedRefundMethod | boolean | A flag to determine if refund method is allowed default at ‘Yes’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
ownerId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_refunds
Source:
Module: mod-feesfines
Interface: /refunds
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
nameReason | string | Refund reason is required field |
description | string | Refund reason description |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
accountId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_transfer_criterias
Source:
Module: mod-feesfines
Interface: /transfer-criterias
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
criteria | string | Not implemented yet |
type | string | Not implemented yet |
value | number | Not implemented yet |
interval | string | Not implemented yet |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_transfers
Source:
Module: mod-feesfines
Interface: /transfers
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
accountName | string | Transfer account name |
desc | string | Transfer account description |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
ownerId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: feesfines_waives
Source:
Module: mod-feesfines
Interface: /waives
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
nameReason | string | Waive reason name |
description | string | Waive reason description |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
accountId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: finance_budgets
Source:
Module: mod-finance-storage
Interface: /finance-storage/budgets
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
name | string | The name of the budget |
budgetStatus | string | The status of the budget |
allowableEncumbrance | number | The encumbrance percentage limit for this budget |
allowableExpenditure | number | The expenditure percentage limit for this budget |
allocated | number | The amount currently allocated to this budget |
awaitingPayment | number | The amount currently awaiting payment for this budget |
available | number | The amount currently available for this budge |
credits | number | The amount currently credited for this budget |
encumbered | number | The amount currently encumbered for this budget |
expenditures | number | The amount currently expended for this budget |
netTransfers | number | Summing all the transfers on this budget |
unavailable | number | Unavailable amount for this budget |
overEncumbrance | number | The amount currently over-encumbered for this budget |
overExpended | number | Amount the budget is over expended. |
fundId | string | The UUID format string |
fiscalYearId | string | The UUID format string |
acqUnitIds | array | acquisition unit ids associated with this budget |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
initialAllocation | number | The amount of the first allocation made to this budget |
allocationTo | number | The sum of all allocation transaction amounts made TO this budget not including the Initial allocation |
allocationFrom | number | The sum of all allocation transaction amounts made FROM this budget not including the Initial allocation |
totalFunding | number | budget.allocated + budget.netTransfers |
cashBalance | number | Total Funding minus Expended |
Documentation: finance_expense_classes
Source:
Module: mod-finance-storage
Interface: /finance-storage/expense-classes
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
code | string | The code of the expense class |
externalAccountNumberExt | string | An external account number extension |
name | string | The name of the expense class |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: finance_fiscal_years
Source:
Module: mod-finance-storage
Interface: /finance-storage/fiscal-years
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
acqUnitIds | array | UUIDs of the acquisition units associated with this fiscal year |
name | string | The name of the fiscal year |
code | string | The code of the fiscal year |
currency | string | Currency code which is recorded when the FY ends, otherwise the system currency can be assumed |
description | string | The description of the fiscal year |
periodStart | string | The start date of the fiscal year |
periodEnd | string | The end date of the fiscal year |
series | string | The fiscal year series |
financialSummary | object | Funding information and Financial activity |
financialSummary/allocated | number | Summary of all related to this fiscal year budgets allocated |
financialSummary/available | number | Summary of all related to this fiscal year budgets available |
financialSummary/unavailable | number | Summary of all related to this fiscal year budgets unavailable |
financialSummary/initialAllocation | number | Summary of all related to this fiscal year budgets initialAllocation |
financialSummary/allocationTo | number | Summary of all related to this fiscal year budgets allocationTo |
financialSummary/allocationFrom | number | Summary of all related to this fiscal year budgets allocationFrom |
financialSummary/totalFunding | number | Summary of all related to this fiscal year budgets totalFunding |
financialSummary/cashBalance | number | Summary of all related to this fiscal year budgets cashBalance |
financialSummary/awaitingPayment | number | Summary of all related to this fiscal year budgets awaitingPayment |
financialSummary/credits | number | Summary of all related to this fiscal year budgets credits |
financialSummary/encumbered | number | Summary of all related to this fiscal year budgets encumbered |
financialSummary/expenditures | number | Summary of all related to this ledger budgets expenditures |
financialSummary/overEncumbrance | number | Summary of all related to this ledger budgets overEncumbrance |
financialSummary/overExpended | number | Summary of all related to this ledger budgets overExpended |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: finance_fund_types
Source:
Module: mod-finance-storage
Interface: /finance-storage/fund-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
name | string | Name of fund type |
Documentation: finance_funds
Source:
Module: mod-finance-storage
Interface: /finance-storage/funds
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
allocatedFromIds | array | All the funds that this fund is allowed to receive money from. This would be 1 fund or none. If this field is blank their is no restriction on allocating to this fund |
allocatedToIds | array | All the funds that this fund is allowed to send money to. This could be one or many. |
code | string | Fund code format |
description | string | The description of this fund |
externalAccountNo | string | Corresponding account in the financial system. Will be recorded in payment generated as well. |
fundStatus | string | The current status of this fund |
fundTypeId | string | The UUID format string |
ledgerId | string | The UUID format string |
name | string | The name of this fund |
acqUnitIds | array | acquisition unit ids associated with this fund |
donorOrganizationIds | array | donor organization ids associated with this fund |
restrictByLocations | boolean | restrict usage of this fund by locations |
locations | array | Locations associated with this fund |
locations/locationId | string | The UUID format string |
locations/tenantId | string | Tenant id of the associated location |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: finance_group_fund_fiscal_years
Source:
Module: mod-finance-storage
Interface: /finance-storage/group-fund-fiscal-years
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
budgetId | string | The UUID format string |
groupId | string | The UUID format string |
fiscalYearId | string | The UUID format string |
fundId | string | The UUID format string |
Documentation: finance_groups
Source:
Module: mod-finance-storage
Interface: /finance-storage/groups
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
acqUnitIds | array | UUIDs of the acquisition units associated with this group |
code | string | The code of the group |
description | string | The description of the group |
name | string | The name of the group |
status | string | The status of the group |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: finance_ledgers
Source:
Module: mod-finance-storage
Interface: /finance-storage/ledgers
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
name | string | The name of the ledger |
code | string | The code for the ledger |
description | string | The description of the ledger |
fiscalYearOneId | string | The UUID format string |
ledgerStatus | string | The status of the ledger |
allocated | number | The amount currently allocated to this ledger |
available | number | The amount currently available in this ledger |
netTransfers | number | Summing all the transfers from/to this ledger. Amount can be negative |
unavailable | number | The amount already utilized from the allocated amount |
currency | string | The ISO code for currency |
acqUnitIds | array | acquisition unit ids associated with this ledger |
restrictEncumbrance | boolean | If true, imposes restrictions on encumbrances |
restrictExpenditures | boolean | If true, imposes restrictions on payments |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
initialAllocation | number | Summary of all related to this ledger budgets initialAllocation |
allocationTo | number | Summary of all related to this ledger budgets allocationTo |
allocationFrom | number | Summary of all related to this ledger budgets allocationFrom |
totalFunding | number | Summary of all related to this ledger budgets totalFunding |
cashBalance | number | Summary of all related to this ledger budgets cashBalance |
awaitingPayment | number | Summary of all related to this ledger budgets awaitingPayment |
credits | number | Summary of all related to this ledger budgets credits |
encumbered | number | Summary of all related to this ledger budgets encumbered |
expenditures | number | Summary of all related to this ledger budgets expenditures |
overEncumbrance | number | Summary of all related to this ledger budgets overEncumbrance |
overExpended | number | Summary of all related to this ledger budgets overExpended |
Documentation: finance_transactions
Source:
Module: mod-finance-storage
Interface: /finance-storage/transactions
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
amount | number | The amount of this transaction. For encumbrances: This is initialAmountEncumbered - (amountAwaitingPayment + amountExpended) |
awaitingPayment | object | Awaiting payment schema |
awaitingPayment/encumbranceId | string | The UUID format string |
awaitingPayment/releaseEncumbrance | boolean | Whether or not remaining encumbered money should be released |
currency | string | Currency code for this transaction - from the system currency |
description | string | Description of this transaction |
encumbrance | object | The encumbrance associated with the payment/credit taking place |
encumbrance/amountAwaitingPayment | number | Deprecated! Going to be removed in next release. The amount of awaiting for payment |
encumbrance/amountCredited | number | The amount currently credited to this encumbrance |
encumbrance/amountExpended | number | The amount currently expended by this encumbrance |
encumbrance/initialAmountEncumbered | number | The initial amount of this encumbrance. Shouldn’t change once create |
encumbrance/status | string | The status of this encumbrance |
encumbrance/orderType | string | Taken from the purchase order |
encumbrance/orderStatus | string | Taken from the purchase order |
encumbrance/subscription | boolean | Taken from the purchase Order,for fiscal year rollover |
encumbrance/reEncumber | boolean | Taken from the purchase Order,for fiscal year rollover |
encumbrance/sourcePurchaseOrderId | string | The UUID format string |
encumbrance/sourcePoLineId | string | The UUID format string |
expenseClassId | string | The UUID format string |
fiscalYearId | string | The UUID format string |
fromFundId | string | The UUID format string |
invoiceCancelled | boolean | Indicates that related invoice was cancelled |
paymentEncumbranceId | string | The UUID format string |
source | string | The readable identifier of the record that resulted in the creation of this transaction |
sourceFiscalYearId | string | The UUID format string |
sourceInvoiceId | string | The UUID format string |
sourceInvoiceLineId | string | The UUID format string |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
toFundId | string | The UUID format string |
transactionType | string | This describes the type of transaction |
voidedAmount | number | Voided amount, not to be counted in budget totals |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_alternative_title_types
Source:
Module: mod-inventory-storage
Interface: /alternative-title-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the alternative title type; a UUID |
name | string | name of the alternative title type |
source | string | label indicating where the alternative title type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_bound_with_part
Source:
Module: mod-inventory-storage
Interface: /inventory-storage/bound-with-parts
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
holdingsRecordId | string | the ID of the holdings record representing a part of a bound-with; a UUID |
itemId | string | the ID of the item representing the bind; a UUID |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_call_number_types
Source:
Module: mod-inventory-storage
Interface: /call-number-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the call number type; a UUID |
name | string | name of the call number type |
source | string | label indicating where the call number type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_campuses
Source:
Module: mod-inventory-storage
Interface: /location-units/campuses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | name of the location |
code | string | distinct code for the location |
institutionId | string | ID of the first-level location unit that the second-level unit belongs to |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_classification_types
Source:
Module: mod-inventory-storage
Interface: /classification-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the classification type |
source | string | label indicating where the classification type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_contributor_name_types
Source:
Module: mod-inventory-storage
Interface: /contributor-name-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the type of contributor name |
ordering | string | used for ordering of contributor name types in displays, i.e. in select lists |
source | string | origin of the contributor name type record, e.g. ‘local’, ‘consortium’ etc. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_contributor_types
Source:
Module: mod-inventory-storage
Interface: /contributor-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the contributor type |
code | string | distinct code for the contributor type |
source | origin of the contributor type record | |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_electronic_access_relationships
Source:
Module: mod-inventory-storage
Interface: /electronic-access-relationships
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the type of relationship between a URL and an Instance |
source | string | Origin of the electronic access relationship record, e.g. ‘local’, ‘consortium’ etc. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_holdings
Source:
Module: mod-inventory-storage
Interface: /holdings-storage/holdings
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
_version | integer | Record version for optimistic locking |
sourceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
hrid | string | the human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID |
holdingsTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
formerIds | array | Previous ID(s) assigned to the holdings record |
instanceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
permanentLocationId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
temporaryLocationId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
effectiveLocationId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
electronicAccess | array | List of electronic access items |
callNumberTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
callNumberPrefix | string | Prefix of the call number on the holding level. |
callNumber | string | Call Number is an identifier assigned to an item, usually printed on a label attached to the item. |
callNumberSuffix | string | Suffix of the call number on the holding level. |
shelvingTitle | string | Indicates the shelving form of title. |
acquisitionFormat | string | Format of holdings record acquisition |
acquisitionMethod | string | Method of holdings record acquisition |
receiptStatus | string | Receipt status (e.g. pending, awaiting receipt, partially received, fully received, receipt not required, and cancelled) |
administrativeNotes | array | Administrative notes |
notes | array | Notes about action, copy, binding etc. |
illPolicyId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
retentionPolicy | string | Records information regarding how long we have agreed to keep something. |
digitizationPolicy | string | Records information regarding digitization aspects. |
holdingsStatements | array | Holdings record statements |
holdingsStatementsForIndexes | array | Holdings record indexes statements |
holdingsStatementsForSupplements | array | Holdings record supplements statements |
copyNumber | string | Item/Piece ID (usually barcode) for systems that do not use item records. Ability to designate the copy number if institution chooses to use copy numbers. |
numberOfItems | string | Text (Number) |
receivingHistory | object | Receiving history of holdings record |
receivingHistory/displayType | string | Display hint. 1: Display fields separately. 2: Display fields concatenated |
receivingHistory/entries | array | Entries of receiving history |
discoverySuppress | boolean | records the fact that the record should not be displayed in a discovery system |
statisticalCodeIds | array | List of statistical code IDs |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_holdings_note_types
Source:
Module: mod-inventory-storage
Interface: /holdings-note-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the holdings note type; a UUID |
name | string | name of the holdings note type |
source | string | label indicating where the holdings note type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_holdings_sources
Source:
Module: mod-inventory-storage
Interface: /holdings-sources
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
name | string | Name of the holdings records source |
source | string | The holdings records source |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_holdings_types
Source:
Module: mod-inventory-storage
Interface: /holdings-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the holdings type; a UUID |
name | string | name of the holdings type |
source | string | label indicating where the holdings type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_identifier_types
Source:
Module: mod-inventory-storage
Interface: /identifier-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the identifier type |
source | string | label indicating where the identifier type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_ill_policies
Source:
Module: mod-inventory-storage
Interface: /ill-policies
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the ILL policy; UUID |
name | string | name of the policy |
source | string | label indicating where the ILL policy entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_formats
Source:
Module: mod-inventory-storage
Interface: /instance-formats
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the Instance format |
code | string | distinct code for the Instance format |
source | string | origin of the Instance format record |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_note_types
Source:
Module: mod-inventory-storage
Interface: /instance-note-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
name | string | name of the Instance note type |
source | string | label indicating where the Instance note type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_relationship_types
Source:
Module: mod-inventory-storage
Interface: /instance-relationship-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the relationship type |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_relationships
Source:
Module: mod-inventory-storage
Interface: /instance-storage/instance-relationships
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
superInstanceId | string | ID (a UUID) of the super-instance. References an Instance record |
subInstanceId | string | ID (a UUID) of the sub-instance. References an Instance record |
instanceRelationshipTypeId | string | ID (a UUID) of the InstanceRelationshipType. References controlled vocabulary InstanceRelationshipTypes. Indicates the type of relationship between two Instance records. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_statuses
Source:
Module: mod-inventory-storage
Interface: /instance-statuses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
code | string | distinct code for an instance status |
name | string | label for the instance status |
source | string | origin of an instance status record |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instance_types
Source:
Module: mod-inventory-storage
Interface: /instance-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the resource type |
code | string | distinct code for the resource type |
source | origin of a resource type record | |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_instances
Source:
Module: mod-inventory-storage
Interface: /instance-storage/instances
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
_version | integer | Record version for optimistic locking |
hrid | string | The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID |
matchKey | string | A unique instance identifier matching a client-side bibliographic record identification scheme, in particular for a scenario where multiple separate catalogs with no shared record identifiers contribute to the same Instance in Inventory. A match key is typically generated from select, normalized pieces of metadata in bibliographic records |
source | string | The metadata source and its format of the underlying record to the instance record. (e.g. FOLIO if it’s a record created in Inventory; MARC if it’s a MARC record created in MARCcat or EPKB if it’s a record coming from eHoldings; CONSORTIUM-MARC or CONSORTIUM-FOLIO for sharing Instances). |
title | string | The primary title (or label) associated with the resource |
indexTitle | string | Title normalized for browsing and searching; based on the title with articles removed |
alternativeTitles | array | List of alternative titles for the resource (e.g. original language version title of a movie) |
alternativeTitles/alternativeTitleTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
alternativeTitles/alternativeTitle | string | An alternative title for the resource |
alternativeTitles/authorityId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
editions | array | The edition statement, imprint and other publication source information |
series | array | List of series titles associated with the resource (e.g. Harry Potter) |
series/value | string | Series title value |
series/authorityId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
identifiers | array | An extensible set of name-value pairs of identifiers associated with the resource |
identifiers/value | string | Resource identifier value |
identifiers/identifierTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
identifiers/identifierTypeObject | object | Information about identifier type, looked up from identifierTypeId |
contributors | array | List of contributors |
contributors/name | string | Personal name, corporate name, meeting name |
contributors/contributorTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
contributors/contributorTypeText | string | Free text element for adding contributor type terms other that defined by the MARC code list for relators |
contributors/contributorNameTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
contributors/authorityId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
contributors/contributorNameType | object | Dereferenced contributor-name type |
contributors/primary | boolean | Whether this is the primary contributor |
subjects | array | List of subject headings |
subjects/value | string | Subject heading value |
subjects/authorityId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
subjects/sourceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
subjects/typeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
classifications | array | List of classifications |
classifications/classificationNumber | string | Classification (e.g. classification scheme, classification schedule) |
classifications/classificationTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
classifications/classificationType | object | Dereferenced classification schema |
publication | array | List of publication items |
publication/publisher | string | Name of publisher, distributor, etc. |
publication/place | string | Place of publication, distribution, etc. |
publication/dateOfPublication | string | Date (year YYYY) of publication, distribution, etc. |
publication/role | string | The role of the publisher, distributor, etc. |
publicationFrequency | array | List of intervals at which a serial appears (e.g. daily, weekly, monthly, quarterly, etc.) |
publicationRange | array | The range of sequential designation/chronology of publication, or date range |
electronicAccess | array | List of electronic access items |
electronicAccess/uri | string | uniform resource identifier (URI) is a string of characters designed for unambiguous identification of resources |
electronicAccess/linkText | string | The value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated |
electronicAccess/materialsSpecification | string | Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record) |
electronicAccess/publicNote | string | URL public note to be displayed in the discovery |
electronicAccess/relationshipId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
dates | object | Instance Dates |
dates/dateTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
dates/date1 | string | Date 1 |
dates/date2 | string | Date 2 |
instanceTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
instanceFormatIds | array | UUIDs for the unique terms for the format whether it’s from the RDA carrier term list of locally defined |
instanceFormats | array | List of dereferenced instance formats |
physicalDescriptions | array | Physical description of the described resource, including its extent, dimensions, and such other physical details as a description of any accompanying materials and unit type and size |
languages | array | The set of languages used by the resource |
notes | array | Bibliographic notes (e.g. general notes, specialized notes) |
notes/instanceNoteTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
notes/note | string | Text content of the note |
notes/staffOnly | boolean | If true, determines that the note should not be visible for others than staff |
administrativeNotes | array | Administrative notes |
modeOfIssuanceId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
catalogedDate | string | Date or timestamp on an instance for when is was considered cataloged |
previouslyHeld | boolean | Records the fact that the resource was previously held by the library for things like Hathi access, etc. |
staffSuppress | boolean | Records the fact that the record should not be displayed for others than catalogers |
discoverySuppress | boolean | Records the fact that the record should not be displayed in a discovery system |
deleted | boolean | Indicates whether the record was marked for deletion |
statisticalCodeIds | array | List of statistical code IDs |
sourceRecordFormat | string | Format of the instance source record, if a source record exists (e.g. FOLIO if it’s a record created in Inventory, MARC if it’s a MARC record created in MARCcat or EPKB if it’s a record coming from eHoldings) |
statusId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
statusUpdatedDate | string | Date [or timestamp] for when the instance status was updated |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
holdingsRecords2 | array | List of holdings records |
natureOfContentTermIds | array | Array of UUID for the Instance nature of content (e.g. bibliography, biography, exhibition catalogue, festschrift, newspaper, proceedings, research report, thesis or website) |
Documentation: inventory_institutions
Source:
Module: mod-inventory-storage
Interface: /location-units/institutions
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | name of location |
code | string | distinct code for location |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_item_damaged_statuses
Source:
Module: mod-inventory-storage
Interface: /item-damaged-statuses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the item damage status; a UUID |
name | string | name of the item damage status |
source | string | label indicating where the item damage status entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_item_note_types
Source:
Module: mod-inventory-storage
Interface: /item-note-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the item note type; a UUID |
name | string | name of the item note type |
source | string | label indicating where the item note type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_items
Source:
Module: mod-inventory-storage
Interface: /item-storage/items
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Unique ID of the item record |
_version | integer | Record version for optimistic locking |
hrid | string | The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID |
holdingsRecordId | string | ID of the holdings record the item is a member of. |
formerIds | array | Previous identifiers assigned to the item |
discoverySuppress | boolean | Records the fact that the record should not be displayed in a discovery system |
displaySummary | string | Display summary about the item |
accessionNumber | string | Also called inventar number |
barcode | string | Unique inventory control number for physical resources, used largely for circulation purposes |
effectiveShelvingOrder | string | A system generated normalization of the call number that allows for call number sorting in reports and search results |
itemLevelCallNumber | string | Call Number is an identifier assigned to an item, usually printed on a label attached to the item. The call number is used to determine the items physical position in a shelving sequence, e.g. K1 .M44. The Item level call number, is the call number on item level. |
itemLevelCallNumberPrefix | string | Prefix of the call number on the item level. |
itemLevelCallNumberSuffix | string | Suffix of the call number on the item level. |
itemLevelCallNumberTypeId | string | Identifies the source of the call number, e.g., LCC, Dewey, NLM, etc. |
effectiveCallNumberComponents | object | Elements of a full call number generated from the item or holding |
effectiveCallNumberComponents/callNumber | string | Effective Call Number is an identifier assigned to an item or its holding and associated with the item. |
effectiveCallNumberComponents/prefix | string | Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item. |
effectiveCallNumberComponents/suffix | string | Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item. |
effectiveCallNumberComponents/typeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
volume | string | Volume is intended for monographs when a multipart monograph (e.g. a biography of George Bernard Shaw in three volumes). |
enumeration | string | Enumeration is the descriptive information for the numbering scheme of a serial. |
chronology | string | Chronology is the descriptive information for the dating scheme of a serial. |
yearCaption | array | In multipart monographs, a caption is a character(s) used to label a level of chronology, e.g., year 1985. |
itemIdentifier | string | Item identifier number, e.g. imported from the union catalogue (read only). |
copyNumber | string | Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; one copy of a multi-volume, (e.g. Copy 1, or C.7.) |
numberOfPieces | string | Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set). |
descriptionOfPieces | string | Description of item pieces. |
numberOfMissingPieces | string | Number of missing pieces. |
missingPieces | string | Description of the missing pieces. |
missingPiecesDate | string | Date when the piece(s) went missing. |
itemDamagedStatusId | string | Item dame status id identifier. |
itemDamagedStatusDate | string | Date and time when the item was damaged. |
administrativeNotes | array | Administrative notes |
notes | array | Notes about action, copy, binding etc. |
notes/itemNoteTypeId | string | ID of the type of note |
notes/itemNoteType | object | Type of item’s note |
notes/note | string | Text content of the note |
notes/staffOnly | boolean | If true, determines that the note should not be visible for others than staff |
circulationNotes | array | Notes to be displayed in circulation processes |
circulationNotes/id | string | The id of the circulation note |
circulationNotes/noteType | string | Type of circulation process that the note applies to |
circulationNotes/note | string | Text to display |
circulationNotes/source | object | The user who added/updated the note. The property is generated by the server and needed to support sorting. Points to /users/{id} resource. |
circulationNotes/source/id | string | The id of the user who added/updated the note. The user information is generated by the server and needed to support sorting. Points to /users/{id} resource. |
circulationNotes/source/personal | object | Personal information about the user |
circulationNotes/source/personal/lastName | string | The user’s last name |
circulationNotes/source/personal/firstName | string | The user’s first name |
circulationNotes/date | string | Date and time the record is added/updated. The property is generated by the server and needed to support sorting. |
circulationNotes/staffOnly | boolean | Flag to restrict display of this note |
status | object | The status of the item |
status/name | string | Name of the status e.g. Available, Checked out, In transit |
status/date | string | Date and time when the status was last changed |
materialTypeId | string | Material type, term. Define what type of thing the item is. |
materialType | object | Item’s material type |
permanentLoanTypeId | string | The permanent loan type, is the default loan type for a given item. Loan types are tenant-defined. |
temporaryLoanTypeId | string | Temporary loan type, is the temporary loan type for a given item. |
permanentLocationId | string | Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. |
permanentLocation | object | The permanent shelving location in which an item resides |
temporaryLocationId | string | Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. |
temporaryLocation | object | Temporary location, shelving location, or holding which is a physical place where items are stored, or an Online location |
effectiveLocationId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
electronicAccess | array | References for accessing the item by URL. |
electronicAccess/uri | string | uniform resource identifier (URI) is a string of characters designed for unambiguous identification of resources |
electronicAccess/linkText | string | the value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated |
electronicAccess/materialsSpecification | string | materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record) |
electronicAccess/publicNote | string | URL public note to be displayed in the discovery |
electronicAccess/relationshipId | string | relationship between the electronic resource at the location identified and the item described in the record as a whole |
inTransitDestinationServicePointId | string | Service point an item is intended to be transited to (should only be present when in transit) |
statisticalCodeIds | array | List of statistical code IDs |
purchaseOrderLineIdentifier | string | ID referencing a remote purchase order object related to this item |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
holdingsRecord2 | object | Fake property for mod-graphql to determine record relationships. |
lastCheckIn | object | Information about when an item was last scanned in the Inventory app. |
lastCheckIn/dateTime | string | Date and time of the last check in of the item. |
lastCheckIn/servicePointId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
lastCheckIn/staffMemberId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
Documentation: inventory_libraries
Source:
Module: mod-inventory-storage
Interface: /location-units/libraries
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | name of the location |
code | string | distinct code for the location |
campusId | string | ID of the second-level location unit that the third-level unit belongs to |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_loan_types
Source:
Module: mod-inventory-storage
Interface: /loan-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the loan type |
source | string | Origin of the loan type record, e.g. ‘System’, ‘User’, ‘Consortium’ etc. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_locations
Source:
Module: mod-inventory-storage
Interface: /locations
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | id of this (shelf) location record as UUID. |
name | string | Name of the (shelf) location |
code | string | Code of the (shelf) location, usually an abbreviation of the name. |
description | string | Description of the (shelf) location. |
discoveryDisplayName | string | Name of the (shelf) location to be shown in the discovery. |
isActive | boolean | Whether this (shelf) location is active. Inactive (shelf) locations can no longer been used. |
institutionId | string | The UUID of the institution, the first-level location unit, this (shelf) location belongs to. |
institution | object | The institution, the first-level location unit, this (shelf) location belongs to. |
campusId | string | The UUID of the campus, the second-level location unit, this (shelf) location belongs to. |
campus | object | The campus, the second-level location unit, this (shelf) location belongs to |
libraryId | string | The UUID of the library, the third-level location unit, this (shelf) location belongs to. |
library | object | The library, the third-level location unit, this (shelf) location belongs to. |
details | object | Details about this (shelf) location. |
primaryServicePoint | string | The UUID of the primary service point of this (shelf) location. |
primaryServicePointObject | object | A service point |
primaryServicePointObject/id | string | Id of service-point object |
primaryServicePointObject/name | string | service-point name, a required field |
primaryServicePointObject/code | string | service-point code, a required field |
primaryServicePointObject/discoveryDisplayName | string | display name, a required field |
primaryServicePointObject/description | string | description of the service-point |
primaryServicePointObject/shelvingLagTime | integer | shelving lag time |
primaryServicePointObject/pickupLocation | boolean | indicates whether or not the service point is a pickup location |
primaryServicePointObject/holdShelfExpiryPeriod | object | expiration period for items on the hold shelf at the service point |
primaryServicePointObject/holdShelfClosedLibraryDateManagement | string | enum for closedLibraryDateManagement associated with hold shelf |
primaryServicePointObject/staffSlips | array | List of staff slips for this service point |
primaryServicePointObject/staffSlips/id | string | The ID of the staff slip |
primaryServicePointObject/staffSlips/printByDefault | boolean | Whether or not to print the staff slip by default |
primaryServicePointObject/ecsRequestRouting | boolean | Indicates a service point used for the ECS functionality |
primaryServicePointObject/metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
primaryServicePointObject/metadata/createdDate | string | Date and time when the record was created |
primaryServicePointObject/metadata/createdByUserId | string | ID of the user who created the record (when available) |
primaryServicePointObject/metadata/createdByUsername | string | Username of the user who created the record (when available) |
primaryServicePointObject/metadata/updatedDate | string | Date and time when the record was last updated |
primaryServicePointObject/metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
primaryServicePointObject/metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
servicePointIds | array | All service points that this (shelf) location has. |
isFloatingCollection | boolean | Items checked in/out from this location can be checked in/out to other locations with the same flag. |
servicePoints | array | List of dereferenced service points |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_material_types
Source:
Module: mod-inventory-storage
Interface: /material-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the material type |
source | string | origin of the material type record |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_modes_of_issuance
Source:
Module: mod-inventory-storage
Interface: /modes-of-issuance
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | |
name | string | label for the mode of issuance |
source | string | label indicating where the mode of issuance entry originates from, i.e. ‘rdamodeissue’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_nature_of_content_terms
Source:
Module: mod-inventory-storage
Interface: /nature-of-content-terms
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
name | string | term for the nature of content |
source | string | label indicating where the term originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_service_points
Source:
Module: mod-inventory-storage
Interface: /service-points
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Id of service-point object |
name | string | service-point name, a required field |
code | string | service-point code, a required field |
discoveryDisplayName | string | display name, a required field |
description | string | description of the service-point |
shelvingLagTime | integer | shelving lag time |
pickupLocation | boolean | indicates whether or not the service point is a pickup location |
holdShelfExpiryPeriod | object | schema for time-period, which contains time interval ‘duration’ and the time unit |
holdShelfExpiryPeriod/duration | integer | Duration interval |
holdShelfExpiryPeriod/intervalId | string | Unit of time for the duration |
holdShelfClosedLibraryDateManagement | string | enum for closedLibraryDateManagement associated with hold shelf |
staffSlips | array | List of staff slips for this service point |
staffSlips/id | string | The ID of the staff slip |
staffSlips/printByDefault | boolean | Whether or not to print the staff slip by default |
ecsRequestRouting | boolean | Indicates a service point used for the ECS functionality |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_service_points_users
Source:
Module: mod-inventory-storage
Interface: /service-points-users
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The id of record as a UUID. |
userId | string | Id of the user as a UUID. |
servicePointsIds | array | The list of service points a user is allowed to work at. |
defaultServicePointId | string | The id of the user’s default service point as UUID. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_statistical_code_types
Source:
Module: mod-inventory-storage
Interface: /statistical-code-types
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the statistical code type; a UUID |
name | string | name of a statistical code type |
source | string | label indicating where the statistical code type entry originates from, i.e. ‘folio’ or ‘local’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: inventory_statistical_codes
Source:
Module: mod-inventory-storage
Interface: /statistical-codes
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | unique ID of the statistical code; a UUID |
code | string | statistical code; a distinct label |
name | string | name or description of a statistical code |
statisticalCodeTypeId | string | a UUID referencing a statistical code type |
source | label indicating where the statistical code originates from, i.e. ‘folio’ or ‘local’ | |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: invoice_invoices
Source:
Module: mod-invoice-storage
Interface: /invoice-storage/invoices
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
accountingCode | string | Number that represents the vendor is an external accounting system which may include details like “Address code” in it. This is the number as stated on the invoice |
adjustments | array | List of invoice level adjustments. The adjustments can be pro-rated which are defined at the invoice level, but are applied to the invoice lines. A generic example is a shipping fee which should be spread out across all of the invoice lines so that all funds involved pay some portion of the fee. |
adjustmentsTotal | number | Total amount which is sum of all invoice line adjustments and all non-prorated invoice level adjustments. This amount is always calculated by system. |
approvedBy | string | The UUID format string |
approvalDate | string | Date the invoice was approved for processing |
batchGroupId | string | UUID of the batch group to use when generating batch vouchers |
billTo | string | The UUID format string |
chkSubscriptionOverlap | boolean | IF TRUE the system will check if there is another invoice for this subscription and whether the dates overlap. IF the dates overlap, the system should issue an alert. |
cancellationNote | string | The reason of the invoice cancellation. |
currency | string | Ideally this is the ISO code and not something the user defines |
enclosureNeeded | boolean | Indicates that an enclosure is needed |
exchangeRate | number | Exchange rate |
exportToAccounting | boolean | This would keep the invoice from being feed into the batch process (i.e. not generate an external voucher/payment) but would still move values in the system. This might be defined by the vendor relationship and exposed for override on the invoice. |
folioInvoiceNo | string | Invoice number in folio system |
invoiceDate | string | Invoice date |
lockTotal | number | Total amount which manually set by user. The calculated total must match this before the invoice can be approved |
note | string | Invoice note |
paymentDue | string | When this is required to be paid. Generally governed by the relationship with the Vendor |
paymentDate | string | When the invoice was actually paid |
paymentTerms | string | Invoice payment terms |
paymentMethod | string | Inherited from vendor record |
status | string | Open: Record has been created, Reviewed: details have been verified, Approved: Funds are release, Paid: confirmation that funds have been exchanged and check number has been returned amounts are frozen, cancelled. |
Note: invoices are never partially paid. | ||
source | string | This does not denote a user ID but describes how the record was created. Eg. User, API, EDI |
subTotal | number | Invoice amount before adjustments are applied. This is sum of all subTotal amounts of the corresponding invoice lines. This amount is always calculated by system. |
total | number | The total amount is calculated “on the fly” of this invoice which is sum of subTotal and adjustmentsTotal. Must be the same with existed “lockTotal”, when approve invoice. |
vendorInvoiceNo | string | This is the number from the vendor’s invoice, which is different from the folioInvoiceNo |
disbursementNumber | string | The identifier for the physical transaction corresponding to a payment (Eg. Check #, EFT # etc.) Brought in from external source |
voucherNumber | string | Number generated by folio that will eventually identify the payment request sent out to external financial system. |
paymentId | string | The UUID format string |
disbursementDate | string | Date payment was made from financial system (eg. corresponding check date) |
poNumbers | array | May or may not be provided; references the PO associated to the invoice |
vendorId | string | The UUID format string |
fiscalYearId | string | The UUID format string |
accountNo | string | The unique number of the organization account |
manualPayment | boolean | This would keep the invoice from being feed into the batch process (Not generate a external voucher/payment) but would still move values in the system. Note: this is ideally defined by the vendor relationship and exposed for override on the invoice. |
acqUnitIds | array | acquisition unit ids associated with this invoice |
nextInvoiceLineNumber | integer | Number that will be used next time an invoice line is created |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
Documentation: invoice_lines
Source:
Module: mod-invoice-storage
Interface: /invoice-storage/invoice-lines
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
accountingCode | string | Pulled based on account number. |
accountNumber | string | Account number that the vendor assigned |
adjustments | array | Defined in settings - the amount field will be editable and pro-rate toggle will be editable if enabled for that adjustment |
adjustmentsTotal | number | Sum of all invoice line adjustments. This amount is always calculated by system. |
comment | string | Free form commentary |
description | string | Title as captured in the Purchase Order Line. In the absence of a POL link this could be used to describe the POL |
fundDistributions | array | List of fund distributions |
invoiceId | string | The UUID format string |
invoiceLineNumber | string | Sequentially generated and not editable by the user. |
invoiceLineStatus | string | Invoice line status |
poLineId | string | The UUID format string |
productId | string | product identifier |
productIdType | string | The UUID corresponding to the type of product id |
quantity | integer | quantity |
releaseEncumbrance | boolean | This is intended to not only release encumbrances but to indicate that this is the final invoice line for corresponding order line. This should take into account the fiscal year. We may release encumbrance for this FY but for on-going orders expect to encumber again next year. |
subscriptionInfo | string | The user should use this field to provide info on the subscription (eg. which volumes are being invoiced). It is MANDATORY if the chk_subscription_overlap is FALSE AND there is no start date provided |
subscriptionStart | string | Subscription start date |
subscriptionEnd | string | Subscription end date |
subTotal | number | Invoice line amount before adjustments are applied |
total | number | Invoice line total amount which is sum of subTotal and adjustmentsTotal. This amount is always calculated by system. |
referenceNumbers | array | Reference number items array |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
Documentation: invoice_voucher_lines
Source:
Module: mod-invoice-storage
Interface: /voucher-storage/voucher-lines
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
amount | number | Total amount of this voucher |
externalAccountNumber | string | All distributions that come from funds with the same account number are grouped by voucher line |
fundDistributions | array | List of fund distributions |
sourceIds | array | UUID of invoice lines. There could be many invoice lines against a single voucher line. These are group on a voucher line based on External account number |
subTransactionId | string | The UUID format string |
voucherId | string | The UUID format string |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: invoice_vouchers
Source:
Module: mod-invoice-storage
Interface: /voucher-storage/vouchers
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
accountingCode | string | Number that represents the vendor is an external accounting system which may include details like “Address code” in it. This is the number as stated on the invoice |
accountNo | string | The unique number of the organization account |
amount | number | The amount that is actually paid |
batchGroupId | string | UUID of the batch group to use when generating batch vouchers |
disbursementNumber | string | The identifier for the physical transaction corresponding to a payment;Brought in from external source |
disbursementDate | string | Date payment was made from financial system |
disbursementAmount | number | The amount of the payment made outside of FOLIO |
enclosureNeeded | boolean | Indicates that an enclosure is needed |
invoiceCurrency | string | The currency in which invoice was originally defined |
invoiceId | string | The UUID format string |
exchangeRate | number | Exchange rate used to generate transaction |
exportToAccounting | boolean | Export this payment record to a financial system |
status | string | Status of the voucher |
systemCurrency | string | The currency in which the voucher was paid |
type | string | Indicates type of payment to account |
voucherDate | string | The date the invoice status changes to approved |
voucherNumber | string | Number generated by folio that will eventually identify the payment request sent out to external financial system. |
vendorId | string | The UUID format string |
vendorAddress | object | An address record |
vendorAddress/addressLine1 | string | The first line of this address |
vendorAddress/addressLine2 | string | The second line of this address |
vendorAddress/city | string | The city for this address |
vendorAddress/stateRegion | string | The state or region for this address |
vendorAddress/zipCode | string | The zip code for this address |
vendorAddress/country | string | The country for this address |
acqUnitIds | array | acquisition unit ids associated with this voucher |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: notes
Source:
Module: mod-notes
Interface: /notes
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
typeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
type | string | Type of note (configured in settings) |
domain | string | Domain associated with this note |
title | string | Note title |
content | string | Content of the note |
status | string | Status of note - applies when searching by link.id and status |
creator | object | User Display Information |
creator/lastName | string | Last name of the user |
creator/firstName | string | First name of the user |
creator/middleName | string | Middle name or initial of the user |
updater | object | User Display Information |
updater/lastName | string | Last name of the user |
updater/firstName | string | First name of the user |
updater/middleName | string | Middle name or initial of the user |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
links | array | Collection of links to associated objects |
Documentation: acquisition_method
Source:
Module: mod-orders-storage
Interface: /orders-storage/acquisition-methods
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
value | string | The value of this acquisition method |
source | string | Source of acquisition method |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: acquisitions_memberships
Source:
Module: mod-orders-storage
Interface: /acquisitions-units-storage/memberships
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | UUID of this membership record |
userId | string | The UUID of the user to associate with the acquisitions unit |
acquisitionsUnitId | string | The acquisition unit the user is a member of |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: acquisitions_units
Source:
Module: mod-orders-storage
Interface: /acquisitions-units-storage/units
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
name | string | a name for this acquisitions unit |
description | string | The description of this acq unit |
isDeleted | boolean | If true, the record is marked for deletion at some point. This prevents it from being assigned to any record. |
protectCreate | boolean | if true, only members can create records associated with this acq unit. |
protectRead | boolean | if true, only members can read/view records associated with this acq unit. |
protectUpdate | boolean | if true, only members can update records associated with this acq unit. |
protectDelete | boolean | if true, only members can delete records associated with this acq unit. |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: po_lines
Source:
Module: mod-orders-storage
Interface: /orders-storage/po-lines
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
edition | string | edition of the material |
checkinItems | boolean | if true this will toggle the Check-in workflow for details associated with this PO line |
agreementId | string | The UUID format string |
acquisitionMethod | string | The UUID format string |
automaticExport | boolean | if true then line will be marked as available to export in the EDIFACT format or other format |
cancellationRestriction | boolean | whether or not there are cancellation restrictions for this purchase order line |
cancellationRestrictionNote | string | free-form notes related to cancellation restrictions |
claims | array | claims associated with this purchase order line |
claimingActive | boolean | Indicates if there is an active claim or dispute |
claimingInterval | integer | Specifies the time interval, in days, within which claims or disputes must be initiated |
collection | boolean | whether or not this purchase order line is for a collection |
contributors | array | list of contributors to the material |
cost | object | purchase order line cost record |
cost/listUnitPrice | number | The per-item list price for physical or resources of ‘Other’ order format |
cost/listUnitPriceElectronic | number | The e-resource per-item list price |
cost/currency | string | An ISO currency code |
cost/additionalCost | number | Lump sum that is added to the total estimated price - not affected by discount |
cost/discount | number | Percentage (0 to 100) or amount (positive number) that is subtracted from the list price time quantities calculation before additional cost |
cost/discountType | string | Percentage or amount discount type |
cost/exchangeRate | number | Exchange rate |
cost/quantityPhysical | integer | Quantity of physical items or resources of ‘Other’ order format in this purchase order line |
cost/quantityElectronic | integer | Quantity of electronic items in this purchase order line |
cost/poLineEstimatedPrice | number | The calculated total estimated price for this purchase order line: list price time quantities minus discount amount plus additional cost |
cost/fyroAdjustmentAmount | number | Adjustment amount if rollover was happen |
description | string | description of the material |
details | object | purchase order line details |
details/receivingNote | string | notes regarding receiving instructions |
details/isAcknowledged | boolean | Flag for acknowledge receiving note |
details/isBinderyActive | boolean | Indicates that this POL is designated as required binding |
details/productIds | array | a list of product identifiers |
details/subscriptionFrom | [‘string’, ‘null’] | the start date of the subscription |
details/subscriptionInterval | integer | the subscription interval in days |
details/subscriptionTo | [‘string’, ‘null’] | the end date of the subscription |
donor | string | the donor contributing to this purchase order line |
donorOrganizationIds | array | donor organization ids associated with this fund |
eresource | object | purchase order line e-resource details |
eresource/activated | boolean | whether or not this resource is activated |
eresource/activationDue | integer | number of days until activation, from date of order placement |
eresource/createInventory | string | Shows what inventory objects need to be created for electronic resource |
eresource/trial | boolean | whether or not this is a trial |
eresource/expectedActivation | string | expected date the resource will be activated |
eresource/userLimit | string | the concurrent user-limit |
eresource/accessProvider | string | UUID of the access provider |
eresource/license | object | purchase order line license record |
eresource/license/code | string | license code |
eresource/license/description | string | license description |
eresource/license/reference | string | license reference |
eresource/materialType | string | UUID of the material Type |
eresource/resourceUrl | string | Electronic resource can be access via this URL |
fundDistribution | array | Fund distribution records for this purchase order line |
instanceId | string | The UUID format string |
isPackage | boolean | Indicates that this POL is for a package |
locations | array | Location records for this purchase order line |
searchLocationIds | array | location ids used for search |
lastEDIExportDate | string | The last date when line was exported in the EDIFACT file |
orderFormat | string | The purchase order line format |
packagePoLineId | string | The UUID format string |
paymentStatus | string | Payment/Receipt status |
physical | object | purchase order line physical material details |
physical/createInventory | string | Shows what inventory objects need to be created for physical resource |
physical/materialType | string | UUID of the material Type |
physical/materialSupplier | string | UUID of the material supplier record |
physical/expectedReceiptDate | [‘string’, ‘null’] | vendor agreed date prior to the Receipt Due date item is expected to be received by |
physical/receiptDue | [‘string’, ‘null’] | date item should be received by |
physical/volumes | array | list of volumes included to the physical material |
poLineDescription | string | purchase order line description |
poLineNumber | string | A human readable number assigned to this PO line (assigned automatically) |
publicationDate | string | date (year) of the material’s publication |
publisher | string | publisher of the material |
purchaseOrderId | string | The UUID format string |
receiptDate | [‘null’, ‘string’] | date the purchase order line was received |
receiptStatus | string | The purchase order line receipt status |
renewalNote | string | Renewal note for this purchase order line |
requester | string | who requested this purchase order line |
rush | boolean | whether or not this is a rush order |
selector | string | who selected this material |
source | string | The source of the Order |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
titleOrPackage | string | title of the material |
vendorDetail | object | purchase order line vendor details |
vendorDetail/instructions | string | special instructions for the vendor |
vendorDetail/noteFromVendor | string | free-form notes from the vendor |
vendorDetail/vendorAccount | string | the accound number on the vendor’s end associated with this purchase order line |
vendorDetail/referenceNumbers | array | Reference number items array |
customFields | object | Object that contains custom field |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: po_order_invoice_relns
Source:
Module: mod-orders-storage
Interface: /orders-storage/order-invoice-relns
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | UUID of this relationship record |
purchaseOrderId | string | Purchase order id |
invoiceId | string | Invoice id |
Documentation: po_order_templates
Source:
Module: mod-orders-storage
Interface: /orders-storage/order-templates
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
templateName | string | The order template name |
templateCode | string | The order template code |
templateDescription | string | The order template description |
hiddenFields | object | Fields for hidden from end user |
categoryIds | array | UUIDs of order template categories |
Documentation: po_pieces
Source:
Module: mod-orders-storage
Interface: /orders-storage/pieces
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
displaySummary | string | Display summary information |
comment | string | Free form commentary |
format | string | The format of the piece |
itemId | string | The UUID format string |
bindItemId | string | The UUID format string |
bindItemTenantId | string | Bind item tenant for ECS-enabled clusters |
locationId | string | The UUID format string |
poLineId | string | The UUID format string |
titleId | string | The UUID format string |
holdingId | string | The UUID format string |
receivingTenantId | string | Receiving tenant for ECS-enabled clusters |
displayOnHolding | boolean | Whether or not receiving history should be displayed in holding record view |
displayToPublic | boolean | Whether or not the piece data should display to patrons at point of receipt |
enumeration | string | Enumeration is the descriptive information for the numbering scheme of a serial. Synchronized with inventory item. |
chronology | string | Chronology is the descriptive information for the dating scheme of a serial. Synchronized with inventory item. |
barcode | string | Barcode is the descriptive information for the barcode of a serial. Synchronized with inventory item. |
accessionNumber | string | AccessionNumber is the descriptive information for the accession number of a serial. Synchronized with inventory item. |
callNumber | string | CallNumber is the descriptive information for the call number of a serial. Synchronized with inventory item. |
discoverySuppress | boolean | Records the fact that the record should not be displayed in a discovery system |
copyNumber | string | Copy number of the piece |
receivingStatus | string | The status of a piece |
supplement | boolean | Whether or not this is supplementary material |
isBound | boolean | Whether or not piece has already been bound |
receiptDate | string | Date that associated item is expected to arrive |
receivedDate | string | The date associated item is actually received |
statusUpdatedDate | string | Date when the status of this piece was last updated |
claimingInterval | integer | Time interval (in days) for processing claims related to this piece |
internalNote | string | Internal note for Send Claim action |
externalNote | string | External note for Send Claim action to share with Vendor |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: po_purchase_orders
Source:
Module: mod-orders-storage
Interface: /orders-storage/purchase-orders
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
approved | boolean | whether or not the purchase order has been approved |
approvedById | string | The UUID format string |
approvalDate | string | Date and time when purchase order was approved |
assignedTo | string | The UUID format string |
billTo | string | The UUID format string |
closeReason | object | purchase order closing reason record |
closeReason/reason | string | close reason description |
closeReason/note | string | free-form notes related to closing reason |
dateOrdered | string | Date and time when purchase order was opened |
manualPo | boolean | if true, order cannot be sent automatically, e.g. via EDI |
notes | array | free-form notes associated with this purchase order |
poNumber | string | A human readable ID assigned to this purchase order |
poNumberPrefix | string | Purchase order number prefix |
poNumberSuffix | string | Purchase order number suffix |
orderType | string | the purchase order type |
reEncumber | boolean | indicates this purchase order should be re-encumbered each fiscal year. Only applies to ongoing orders |
ongoing | object | Ongoing details for Purchase Order |
ongoing/interval | integer | Renewal interval (in days) |
ongoing/isSubscription | boolean | Whether or not this is a subscription |
ongoing/manualRenewal | boolean | Whether or not this is a manual renewal |
ongoing/notes | string | Notes associated with the Ongoing order |
ongoing/reviewPeriod | integer | Time prior to renewal where changes can be made to subscription |
ongoing/renewalDate | string | The date this Ongoing PO’s order lines were renewed |
ongoing/reviewDate | string | Date when Order has to be reviewed |
shipTo | string | The UUID format string |
template | string | The UUID format string |
vendor | string | The UUID format string |
workflowStatus | string | Composite workflow status |
acqUnitIds | array | acquisition unit ids associated with this purchase order |
nextPolNumber | integer | Number that will be used next time a purchase order line is created |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
customFields | object | Object that contains custom field |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: po_receiving_history
Source:
Module: mod-orders-storage
Interface: /orders-storage/receiving-history
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
displaySummary | string | Display summary information |
checkin | boolean | If true this piece is for the Check-in workflow |
chronology | string | Chronology is the descriptive information for the dating scheme of a serial. Synchronized with inventory item. |
comment | string | Free form commentary |
dateOrdered | string | Date and time when purchase order was opened |
discoverySuppress | boolean | Records the fact that the record should not be displayed in a discovery system |
displayOnHolding | boolean | Whether or not receiving history should be displayed in holding record view |
enumeration | string | Enumeration is the descriptive information for the numbering scheme of a serial. Synchronized with inventory item. |
copyNumber | string | Copy number of the piece |
instanceId | string | The UUID format string |
itemId | string | The UUID format string |
locationId | string | The UUID format string |
pieceFormat | string | The format of the piece |
poLineId | string | The UUID format string |
poLineNumber | string | A human readable number assigned to this PO line |
poLineReceiptStatus | string | The purchase order line receipt status |
purchaseOrderId | string | The UUID format string |
receiptDate | string | Date that this item is expected to arrive |
receivedDate | string | date received |
receivingNote | string | A note at the poLine level pertaining to receiving/check-in |
receivingStatus | string | the status of this piece |
supplement | boolean | Whether or not this is supplementary material |
title | string | Title of the instance this poLine is associated with |
Documentation: organization_addresses
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/addresses
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
addressLine1 | string | The first line of this address |
addressLine2 | string | The second line of this address |
city | string | The city for this address |
stateRegion | string | The state or region for this address |
zipCode | string | The zip code for this address |
country | string | The country for this address |
isPrimary | boolean | Used to set this address as primary for the contact |
categories | array | The list of category ids for this organization address |
language | string | The language for this organization address |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_categories
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/categories
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
value | string | The value of this category |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_contacts
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/contacts
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
_version | integer | Record version for optimistic locking |
prefix | string | The prefix for this contact person |
firstName | string | The first name of this contact person |
lastName | string | The last name of this contact person |
language | string | The preferred language for this contact person |
notes | string | The notes for this contact person |
phoneNumbers | array | The list of phone numbers for this contact person |
emails | array | The list of emails for this contact person |
addresses | array | The list of addresses for this contact person |
urls | array | The list of URLs for this contact person |
categories | array | The list of category ids for this organization contact person |
inactive | boolean | Used to indicate that a contact is no longer active |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_emails
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/emails
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
value | string | The value for this email |
description | string | The description for this email |
isPrimary | boolean | Used to set this email as primary for the contact |
categories | array | The list of category ids for this organization email |
language | string | The language for this organization email |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_interfaces
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/interfaces
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
name | string | The name of this interface |
uri | string | The URI of this interface |
notes | string | The notes for this interface |
available | boolean | The availability setting for this interface |
deliveryMethod | string | The delivery method for this interface |
statisticsFormat | string | The format of the statistics for this interface |
locallyStored | string | The locally stored location of this interface |
onlineLocation | string | The online location for this interface |
statisticsNotes | string | The notes regarding the statistics for this interface |
type | array | Interface types |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_organizations
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/organizations
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
name | string | The name of this organization |
code | string | The code for this organization |
description | string | The description for this organization |
exportToAccounting | boolean | This would keep the invoice from being feed into the batch process (i.e. not generate an external voucher/payment) but would still move values in the system. This might be defined by the vendor relationship and exposed for override on the invoice. |
status | string | The status of this organization |
organizationTypes | array | A list of organization types assigned to this organization |
language | string | The language for this organization |
aliases | array | The list of aliases for this organization |
addresses | array | The list of addresses for this organization |
phoneNumbers | array | The list of phone numbers for this organization |
emails | array | The list of emails for this organization |
urls | array | The list of URLs for this organization |
contacts | array | An array of contact record IDs |
privilegedContacts | array | An array of privileged contact record IDs |
agreements | array | The the list of agreements for this organization |
erpCode | string | The ERP code for this organization |
paymentMethod | string | The payment method for this organization |
accessProvider | boolean | The access provider for this organization |
governmental | boolean | The setting to mark this organization as governmental |
licensor | boolean | The setting to mark this organization as a licensor |
materialSupplier | boolean | The setting to mark this organization as a material supplier |
vendorCurrencies | array | The list of currencies used by this organization |
claimingInterval | integer | The claim interval for this organization |
discountPercent | number | The discount percentage for this organization |
expectedActivationInterval | integer | The expected activation interval (in days) for this organization |
expectedInvoiceInterval | integer | The expected invoice interval (in days) for this organization |
renewalActivationInterval | integer | The revewal activation interval (in days) for this organization |
subscriptionInterval | integer | The subscription interval (in days) for this organization |
expectedReceiptInterval | integer | The receipt interval (in days) for this organization |
taxId | string | The tax ID for this organization |
liableForVat | boolean | The setting to mark this organization liable to collect VAT |
taxPercentage | number | The tax percentage value for this organization |
edi | object | The EDI object for this organization (only applicable when isVendor is true) |
edi/vendorEdiCode | string | The organization code for this EDI |
edi/vendorEdiType | string | The organization type for this EDI |
edi/libEdiCode | string | The library code for this EDI |
edi/libEdiType | string | The library type for this EDI |
edi/prorateTax | boolean | The setting to prorate tax for this EDI |
edi/prorateFees | boolean | The setting to prorate fees for this EDI |
edi/ediNamingConvention | string | The naming convention for this EDI |
edi/sendAcctNum | boolean | The setting to send the account number for this EDI |
edi/supportOrder | boolean | The setting to support order for this EDI |
edi/supportInvoice | boolean | The setting to support invoice for this EDI |
edi/notes | string | The notes for this EDI |
edi/ediFtp | object | The FTP object for this EDI |
edi/ediFtp/ftpFormat | string | The FTP format for this EDI |
edi/ediFtp/serverAddress | [‘string’, ‘null’] | The server address for this EDI |
edi/ediFtp/username | string | The login username for this EDI |
edi/ediFtp/password | string | The login password for this EDI |
edi/ediFtp/ftpMode | string | The FTP mode for this EDI |
edi/ediFtp/ftpConnMode | string | The FTP connection mode for this EDI |
edi/ediFtp/ftpPort | integer | The port for this EDI |
edi/ediFtp/orderDirectory | string | The order directory for this EDI |
edi/ediFtp/invoiceDirectory | string | The invoice directory for this EDI |
edi/ediFtp/notes | string | The notes for this EDI |
edi/ediJob | object | The job object for this EDI |
edi/ediJob/scheduleEdi | boolean | Activate the schedule for this EDI job |
edi/ediJob/schedulingDate | [‘string’, ‘null’] | The date (MM/DD/YYYY) for this EDI job to start running |
edi/ediJob/time | [‘string’, ‘null’] | The time (h:mm A) for this EDI job |
edi/ediJob/isMonday | boolean | The setting to run this EDI job on Mondays |
edi/ediJob/isTuesday | boolean | The setting to run this EDI job on Tuesdays |
edi/ediJob/isWednesday | boolean | The setting to run this EDI job on Wednesdays |
edi/ediJob/isThursday | boolean | The setting to run this EDI job on Thursdays |
edi/ediJob/isFriday | boolean | The setting to run this EDI job on Fridays |
edi/ediJob/isSaturday | boolean | The setting to run this EDI job on Saturdays |
edi/ediJob/isSunday | boolean | The setting to run this EDI job on Sundays |
edi/ediJob/sendToEmails | string | The comma delimited list of email addresses to notify when this EDI job runs |
edi/ediJob/notifyAllEdi | boolean | The setting to notify all receivers when this EDI job runs |
edi/ediJob/notifyInvoiceOnly | boolean | The setting to notify only the invoice receiver when this EDI job runs |
edi/ediJob/notifyErrorOnly | boolean | The setting to notiry on the error receiver when this EDI job runs |
edi/ediJob/schedulingNotes | string | The schedule notes for this EDI job |
interfaces | array | The list of interfaces assigned to this organization |
accounts | array | The list of accounts for this organization |
isVendor | boolean | Used to indicate that this organization is also a vendor |
isDonor | boolean | Used to designate whether this organization is a donor |
sanCode | string | The SAN code for this organization address |
changelogs | array | The list of changes applied to this organization |
acqUnitIds | array | Acquisition unit UUIDs associated with this organization |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_phone_numbers
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/phone-numbers
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
phoneNumber | string | The entire sequence of digits for this phone number |
categories | array | The list of category ids for this organization phone |
type | string | The type of this phone number |
isPrimary | boolean | Used to set this phone number as primary for the contact |
language | string | The language for this organization phone |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: organization_urls
Source:
Module: mod-organizations-storage
Interface: /organizations-storage/urls
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The UUID format string |
value | string | The value for this URL |
description | string | The description for this URL |
language | string | The language for this organization URL |
isPrimary | boolean | Used to set this url as primary for the contact |
categories | array | The list of category ids for this organization URL |
notes | string | The notes for this organization URL |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: patron_blocks_user_summary
Source:
Module: mod-patron-blocks
Interface: /user-summary
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
_version | integer | Record version for optimistic locking |
userId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
openLoans | array | User’s open loans |
openLoans/loanId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
openLoans/dueDate | string | Due date of the loan |
openLoans/recall | boolean | Indicates if the item was recalled |
openLoans/itemLost | boolean | Indicates if the item associated with the loan is in status ‘Aged to lost’ or ‘Declared lost’ |
openLoans/itemClaimedReturned | boolean | Indicates if the item associated with the loan is in status ‘Claimed returned’ |
openLoans/gracePeriod | object | Period of time, a number of minutes, hours, days, weeks or months |
openLoans/gracePeriod/duration | integer | Duration of the period, number of times the interval repeats |
openLoans/gracePeriod/intervalId | string | Interval for the period, e.g. hours, days or weeks |
openFeesFines | array | User’s open fees/fines |
openFeesFines/feeFineId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
openFeesFines/feeFineTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
openFeesFines/loanId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
openFeesFines/balance | number | Balance |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: perm_permissions
Source:
Module: mod-permissions
Interface: /perms/permissions
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
permissionName | string | The unique name of the permission |
displayName | string | The human-readable name of the permission |
id | string | The globally unique (UUID) identifier for the permission |
description | string | A description of the permission |
tags | array | A list of tags for searching |
subPermissions | array | A list of child permissions granted by this permission |
childOf | array | A list of permissions that ‘own’ this permission |
grantedTo | array | A list of permission users to whom this permission has been granted |
mutable | boolean | Whether or not this permission changes at runtime |
visible | boolean | Whether or not this permission is visible to users |
dummy | boolean | Is this a temporary dummy permission |
deprecated | boolean | Indicates whether this permissions has been marked for deletion (soft deleted) |
moduleName | string | The name of the module (not including version) that defined this permission |
moduleVersion | string | The version of the module that defined this permission |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: perm_users
Source:
Module: mod-permissions
Interface: /perms/users
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | The primary key (UUID) of this permissionUser record |
userId | string | A foreign key to the id field (UUID) of the user record in the users module |
permissions | array | A list of permission names owned by this user |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: template_engine_template
Source:
Module: mod-template-engine
Interface: /templates
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | Template id |
description | string | Template description |
outputFormats | array | Array of output formats |
templateResolver | string | Template engine name |
localizedTemplates | object | List of localized templates |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: user_addresstypes
Source:
Module: mod-users
Interface: /addresstypes
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
addressType | string | A unique name for this address type |
desc | string | An explanation of this address type |
id | string | A UUID identifying this address type |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: user_departments
Source:
Module: mod-users
Interface: /departments
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
id | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
name | string | The unique name of this department |
code | string | The unique code of this department |
usageNumber | integer | Number of users that have this department |
source | string | Origin of the department record, i.e. ‘System’ or ‘User’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: user_groups
Source:
Module: mod-users
Interface: /groups
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
group | string | The unique name of this group |
desc | string | An explanation of this group |
id | string | A UUID identifying this group |
expirationOffsetInDays | integer | The default period in days after which a newly created user that belongs to this group will expire |
source | string | Origin of the group record, i.e. ‘System’ or ‘User’ |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: user_proxiesfor
Source:
Module: mod-users
Interface: /proxiesfor
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
userId | string | The id of the user for whom this proxy pertains |
proxyUserId | string | The id of the user acting as the proxy |
id | string | A UUID identifying this proxy relationship |
requestForSponsor | string | Can the user request a sponsor (yes/no) |
createdDate | string | Deprecated |
notificationsTo | string | Where notifications are sent |
accrueTo | string | Where fees and fines accrue |
status | string | Active or Inactive |
expirationDate | string | The date this proxy relationship expires |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
Documentation: user_users
Source:
Module: mod-users
Interface: /users
Attributes:
Property Name | Property Type | Property Description |
---|---|---|
username | string | A unique name belonging to a user. Typically used for login |
id | string | A globally unique (UUID) identifier for the user |
externalSystemId | string | A unique ID that corresponds to an external authority |
barcode | string | The unique library barcode for this user |
active | boolean | A flag to determine if the user’s account is effective and not expired. The tenant configuration can require the user to be active for login. Active is different from the loan patron block |
type | string | The class of user like staff or patron; this is different from patronGroup; it can store shadow, system user and dcb types also |
patronGroup | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
departments | array | A list of UUIDs corresponding to the departments the user belongs to, see /departments API |
meta | object | Deprecated |
proxyFor | array | Deprecated |
personal | object | Personal information about the user |
personal/pronouns | string | The user’s pronouns |
personal/lastName | string | The user’s surname |
personal/firstName | string | The user’s given name |
personal/middleName | string | The user’s middle name (if any) |
personal/preferredFirstName | string | The user’s preferred name |
personal/email | string | The user’s email address |
personal/phone | string | The user’s primary phone number |
personal/mobilePhone | string | The user’s mobile phone number |
personal/dateOfBirth | string | The user’s birth date |
personal/addresses | array | Physical addresses associated with the user |
personal/addresses/id | string | A unique id for this address |
personal/addresses/countryId | string | The country code for this address |
personal/addresses/addressLine1 | string | Address, Line 1 |
personal/addresses/addressLine2 | string | Address, Line 2 |
personal/addresses/city | string | City name |
personal/addresses/region | string | Region |
personal/addresses/postalCode | string | Postal Code |
personal/addresses/addressTypeId | string | A universally unique identifier (UUID), this is a 128-bit number used to identify a record and is shown in hex with dashes, for example 6312d172-f0cf-40f6-b27d-9fa8feaf332f; the UUID version must be from 1-5; see https://dev.folio.org/guides/uuids/ |
personal/addresses/primaryAddress | boolean | Is this the user’s primary address? |
personal/preferredContactTypeId | string | Id of user’s preferred contact type like Email, Mail or Text Message, see /addresstypes API |
personal/profilePictureLink | string | Link to the profile picture |
enrollmentDate | string | The date in which the user joined the organization |
expirationDate | string | The date for when the user becomes inactive |
createdDate | string | Deprecated |
updatedDate | string | Deprecated |
metadata | object | Metadata about creation and changes to records, provided by the server (client should not provide) |
metadata/createdDate | string | Date and time when the record was created |
metadata/createdByUserId | string | ID of the user who created the record (when available) |
metadata/createdByUsername | string | Username of the user who created the record (when available) |
metadata/updatedDate | string | Date and time when the record was last updated |
metadata/updatedByUserId | string | ID of the user who last updated the record (when available) |
metadata/updatedByUsername | string | Username of the user who last updated the record (when available) |
tags | object | List of simple tags that can be added to an object |
tags/tagList | array | List of tags |
customFields | object | Object that contains custom field |
preferredEmailCommunication | array | Preferred email communication types |