https://github.com/folio-org/mod-organizations-storage
CRUD APIs used to manage organizations.
Collection of organization items.
Get list of organizations
GET /organizations-storage/organizationsA query expressed as a CQL string (see dev.folio.org/reference/glossary#cql) using valid searchable fields. The first example below shows the general form of a full CQL query, but those fields might not be relevant in this context.
with valid searchable fields: for example code
Example:
(username=="ab*" or personal.firstName=="ab*" or personal.lastName=="ab*") and active=="true" sortby personal.lastName personal.firstName barcode
["code", "MEDGRANT", "="]
How to calculate the totalRecords property. "exact" for the correct number, "estimated" for an estimation, "auto" to automatically select "exact" or "estimated", "none" for suppressing the totalRecords property. For details see https://github.com/folio-org/raml-module-builder#estimated-totalrecords
Example:
noneSkip over a number of elements by specifying an offset value for the query
Example:
0Limit the number of elements returned in the response
Example:
10Returns a list of organization items
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "Collection of organization records",
"type": "object",
"properties": {
"organizations": {
"description": "The list of organizations in this collection",
"type": "array",
"id": "organizationData",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The record of an organization",
"javaName": "Organization",
"properties": {
"id": {
"description": "The unique UUID for this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"name": {
"description": "The name of this organization",
"type": "string"
},
"code": {
"description": "The code for this organization",
"type": "string",
"pattern": "[\\S ]{1,}"
},
"description": {
"description": "The description for this organization",
"type": "string"
},
"exportToAccounting": {
"description": "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.",
"type": "boolean",
"default": false
},
"status": {
"description": "The status of this organization",
"type": "string",
"enum": [
"Active",
"Inactive",
"Pending"
]
},
"organizationTypes": {
"description": "A list of organization types assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an organization type record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"uniqueItems": true
},
"language": {
"description": "The language for this organization",
"type": "string"
},
"aliases": {
"id": "aliases",
"description": "The list of aliases for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization alias",
"properties": {
"value": {
"description": "The unique name of this alias",
"type": "string"
},
"description": {
"description": "The description of this alias",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"addresses": {
"id": "addresses",
"description": "The list of addresses for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An address record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"addressLine1": {
"description": "The first line of this address",
"type": "string"
},
"addressLine2": {
"description": "The second line of this address",
"type": "string"
},
"city": {
"description": "The city for this address",
"type": "string"
},
"stateRegion": {
"description": "The state or region for this address",
"type": "string"
},
"zipCode": {
"description": "The zip code for this address",
"type": "string"
},
"country": {
"description": "The country for this address",
"type": "string"
},
"isPrimary": {
"description": "Used to set this address as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization address",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization address",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false
}
},
"phoneNumbers": {
"id": "phoneNumbers",
"description": "The list of phone numbers for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A phone number record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"phoneNumber": {
"description": "The entire sequence of digits for this phone number",
"type": "string"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization phone",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"type": {
"description": "The type of this phone number",
"type": "string",
"enum": [
"Office",
"Mobile",
"Fax",
"Other"
]
},
"isPrimary": {
"description": "Used to set this phone number as primary for the contact",
"type": "boolean"
},
"language": {
"description": "The language for this organization phone",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"phoneNumber"
]
}
},
"emails": {
"id": "emailAddresses",
"description": "The list of emails for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An email record",
"properties": {
"id": {
"description": "The unique id of this email",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this email",
"type": "string"
},
"description": {
"description": "The description for this email",
"type": "string"
},
"isPrimary": {
"description": "Used to set this email as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization email",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization email",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"urls": {
"id": "urls",
"description": "The list of URLs for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A URL record",
"properties": {
"id": {
"description": "The unique id of this url",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this URL",
"type": "string",
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"description": {
"description": "The description for this URL",
"type": "string"
},
"language": {
"description": "The language for this organization URL",
"type": "string"
},
"isPrimary": {
"description": "Used to set this url as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization URL",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"notes": {
"description": "The notes for this organization URL",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"contacts": {
"id": "contact",
"description": "An array of contact record IDs",
"type": "array",
"items": {
"description": "UUID of a contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"privilegedContacts": {
"description": "An array of privileged contact record IDs",
"type": "array",
"items": {
"description": "UUID of a privileged contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"agreements": {
"id": "agreement",
"description": "The the list of agreements for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization agreement",
"properties": {
"name": {
"description": "The unique name of this agreement",
"type": "string"
},
"discount": {
"description": "The discount amount of this agreement",
"type": "number"
},
"referenceUrl": {
"description": "The reference url for this agreement",
"type": "string"
},
"notes": {
"description": "The notes of this agreement",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"name"
]
}
},
"erpCode": {
"description": "The ERP code for this organization",
"type": "string"
},
"paymentMethod": {
"description": "The payment method for this organization",
"type": "string"
},
"accessProvider": {
"description": "The access provider for this organization",
"type": "boolean"
},
"governmental": {
"description": "The setting to mark this organization as governmental",
"type": "boolean"
},
"licensor": {
"description": "The setting to mark this organization as a licensor",
"type": "boolean"
},
"materialSupplier": {
"description": "The setting to mark this organization as a material supplier",
"type": "boolean"
},
"vendorCurrencies": {
"id": "vendorCurrencies",
"description": "The list of currencies used by this organization",
"type": "array",
"items": {
"type": "string"
}
},
"claimingInterval": {
"description": "The claim interval for this organization",
"type": "integer"
},
"discountPercent": {
"description": "The discount percentage for this organization",
"type": "number"
},
"expectedActivationInterval": {
"description": "The expected activation interval (in days) for this organization",
"type": "integer"
},
"expectedInvoiceInterval": {
"description": "The expected invoice interval (in days) for this organization",
"type": "integer"
},
"renewalActivationInterval": {
"description": "The revewal activation interval (in days) for this organization",
"type": "integer"
},
"subscriptionInterval": {
"description": "The subscription interval (in days) for this organization",
"type": "integer"
},
"expectedReceiptInterval": {
"description": "The receipt interval (in days) for this organization",
"type": "integer"
},
"taxId": {
"description": "The tax ID for this organization",
"type": "string"
},
"liableForVat": {
"description": "The setting to mark this organization liable to collect VAT",
"type": "boolean"
},
"taxPercentage": {
"description": "The tax percentage value for this organization",
"type": "number"
},
"edi": {
"description": "The EDI object for this organization (only applicable when isVendor is true)",
"type": "object",
"properties": {
"vendorEdiCode": {
"description": "The organization code for this EDI",
"type": "string"
},
"vendorEdiType": {
"description": "The organization type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"libEdiCode": {
"description": "The library code for this EDI",
"type": "string"
},
"libEdiType": {
"description": "The library type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"prorateTax": {
"description": "The setting to prorate tax for this EDI",
"type": "boolean"
},
"prorateFees": {
"description": "The setting to prorate fees for this EDI",
"type": "boolean"
},
"ediNamingConvention": {
"description": "The naming convention for this EDI",
"type": "string"
},
"sendAcctNum": {
"description": "The setting to send the account number for this EDI",
"type": "boolean"
},
"supportOrder": {
"description": "The setting to support order for this EDI",
"type": "boolean"
},
"supportInvoice": {
"description": "The setting to support invoice for this EDI",
"type": "boolean"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
},
"ediFtp": {
"description": "The FTP object for this EDI",
"type": "object",
"properties": {
"ftpFormat": {
"description": "The FTP format for this EDI",
"type": "string",
"enum": [
"SFTP",
"FTP"
]
},
"serverAddress": {
"description": "The server address for this EDI",
"type": [
"string",
"null"
],
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"username": {
"description": "The login username for this EDI",
"type": "string"
},
"password": {
"description": "The login password for this EDI",
"type": "string"
},
"ftpMode": {
"description": "The FTP mode for this EDI",
"type": "string",
"enum": [
"ASCII",
"Binary"
]
},
"ftpConnMode": {
"description": "The FTP connection mode for this EDI",
"type": "string",
"enum": [
"Active",
"Passive"
]
},
"ftpPort": {
"description": "The port for this EDI",
"type": "integer"
},
"orderDirectory": {
"description": "The order directory for this EDI",
"type": "string"
},
"invoiceDirectory": {
"description": "The invoice directory for this EDI",
"type": "string"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
}
}
},
"ediJob": {
"description": "The job object for this EDI",
"type": "object",
"properties": {
"scheduleEdi": {
"description": "Activate the schedule for this EDI job",
"type": "boolean"
},
"schedulingDate": {
"description": "The date (MM/DD/YYYY) for this EDI job to start running",
"type": [
"string",
"null"
],
"format": "date-time"
},
"time": {
"description": "The time (h:mm A) for this EDI job",
"type": [
"string",
"null"
],
"format": "time"
},
"isMonday": {
"description": "The setting to run this EDI job on Mondays",
"type": "boolean"
},
"isTuesday": {
"description": "The setting to run this EDI job on Tuesdays",
"type": "boolean"
},
"isWednesday": {
"description": "The setting to run this EDI job on Wednesdays",
"type": "boolean"
},
"isThursday": {
"description": "The setting to run this EDI job on Thursdays",
"type": "boolean"
},
"isFriday": {
"description": "The setting to run this EDI job on Fridays",
"type": "boolean"
},
"isSaturday": {
"description": "The setting to run this EDI job on Saturdays",
"type": "boolean"
},
"isSunday": {
"description": "The setting to run this EDI job on Sundays",
"type": "boolean"
},
"sendToEmails": {
"description": "The comma delimited list of email addresses to notify when this EDI job runs",
"type": "string"
},
"notifyAllEdi": {
"description": "The setting to notify all receivers when this EDI job runs",
"type": "boolean"
},
"notifyInvoiceOnly": {
"description": "The setting to notify only the invoice receiver when this EDI job runs",
"type": "boolean"
},
"notifyErrorOnly": {
"description": "The setting to notiry on the error receiver when this EDI job runs",
"type": "boolean"
},
"schedulingNotes": {
"description": "The schedule notes for this EDI job",
"type": "string"
}
}
}
}
},
"interfaces": {
"id": "interfaces",
"description": "The list of interfaces assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an interface record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"accounts": {
"id": "accounts",
"description": "The list of accounts for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization account",
"properties": {
"name": {
"description": "The unique name of this account",
"type": "string"
},
"accountNo": {
"description": "The unique number of this account",
"type": "string"
},
"description": {
"description": "The description of this account",
"type": "string"
},
"appSystemNo": {
"description": "The unique name of this group",
"type": "string"
},
"paymentMethod": {
"description": "The method of payment for this account",
"type": "string",
"enum": [
"Cash",
"Credit Card",
"EFT",
"Deposit Account",
"Physical Check",
"Bank Draft",
"Internal Transfer",
"Other"
]
},
"accountStatus": {
"description": "The status of this account",
"type": "string"
},
"contactInfo": {
"description": "The contact info for the account",
"type": "string"
},
"libraryCode": {
"description": "The library code for this account",
"type": "string"
},
"libraryEdiCode": {
"description": "The EDI code for this account",
"type": "string"
},
"notes": {
"description": "The notes for this account",
"type": "string"
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organizations account",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
}
},
"additionalProperties": false,
"required": [
"name",
"accountNo",
"accountStatus"
]
}
},
"isVendor": {
"id": "isVendor",
"description": "Used to indicate that this organization is also a vendor",
"type": "boolean",
"default": false
},
"isDonor": {
"id": "isDonor",
"description": "Used to designate whether this organization is a donor",
"type": "boolean",
"default": false
},
"sanCode": {
"description": "The SAN code for this organization address",
"type": "string"
},
"changelogs": {
"id": "changelogs",
"description": "The list of changes applied to this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A changelog record",
"properties": {
"description": {
"description": "The description of the change",
"type": "string"
},
"timestamp": {
"description": "The timestamp for when the change occurred",
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false,
"required": [
"description",
"timestamp"
]
}
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organization",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"tags": {
"type": "object",
"description": "arbitrary tags associated with this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "tags.schema",
"title": "tags",
"properties": {
"tagList": {
"description": "List of tags",
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"name",
"status",
"code"
]
}
},
"totalRecords": {
"description": "The number of organization records returned in this collection",
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"organizations",
"totalRecords"
]
}Example:
{
"organizations": [
{
"id": "588b5c42-8634-4af7-bc9b-5e0116ed96b6",
"name": "GOBI",
"code": "AQ-GOBI",
"description": "This is Yankee Book Peddler.",
"exportToAccounting" : true,
"status": "Active",
"organizationTypes": [
"f04c7277-0019-43cf-84b3-02d894a9d81a"
],
"language": "en-us",
"isVendor": true,
"isDonor": true,
"aliases": [
{
"value": "YBP",
"description": "AKA"
},
{
"value": "Yankee Book Peddler",
"description": "Formerly known as"
}
],
"addresses": [
{
"addressLine1": "10 Estes Street",
"addressLine2": "",
"city": "Ipswich",
"stateRegion": "MA",
"zipCode": "01938",
"country": "USA",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6",
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en"
}
],
"phoneNumbers": [
{
"phoneNumber": "19789999999",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6"
],
"language": "en-us"
}
],
"emails": [
{
"value": "noreply@folio.org",
"description": "Main",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en-us"
}
],
"urls": [
{
"value": "http://folio.org",
"description": "",
"language": "en-us",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"notes": "note"
}
],
"contacts": [
"9a665b22-9fe5-4c95-b4ee-837a5433c95d"
],
"privilegedContacts": [
"785678a9-7966-4ad8-be46-22149513a386"
],
"agreements": [
{
"name": "History Follower Incentive",
"discount": 10,
"referenceUrl": "http://my_sample_agreement.com",
"notes": "note"
}
],
"erpCode": "AQ-GOBI-HIST",
"paymentMethod": "EFT",
"accessProvider": true,
"governmental": true,
"licensor": true,
"materialSupplier": true,
"vendorCurrencies": [
"USD",
"CAD",
"GBP"
],
"claimingInterval": 30,
"discountPercent": 10,
"expectedActivationInterval": 1,
"expectedInvoiceInterval": 5,
"renewalActivationInterval": 1,
"subscriptionInterval": 365,
"liableForVat": false,
"taxId": "TX-GOBI-HIST",
"taxPercentage": 5,
"edi": {
"vendorEdiCode": "AQ-GOBI-HIST",
"vendorEdiType": "014/EAN",
"libEdiCode": "MY-LIB-1",
"libEdiType": "014/EAN",
"prorateTax": true,
"prorateFees": true,
"ediNamingConvention": "name",
"sendAcctNum": true,
"supportOrder": true,
"supportInvoice": true,
"notes": "",
"ediFtp": {
"ftpFormat": "SFTP",
"serverAddress": "http://127.0.0.1",
"username": "edi_username",
"password": "edi_password",
"ftpMode": "ASCII",
"ftpConnMode": "Active",
"ftpPort": 22,
"orderDirectory": "/path/to/order/directory",
"invoiceDirectory": "/path/to/invoice/directory",
"notes": "My FTP notes"
},
"ediJob": {
"scheduleEdi": false,
"schedulingDate": null,
"time": null,
"isMonday": false,
"isTuesday": false,
"isWednesday": false,
"isThursday": false,
"isFriday": false,
"isSaturday": false,
"isSunday": false,
"sendToEmails": "email1@site.com, email2@site.com",
"notifyAllEdi": true,
"notifyInvoiceOnly": true,
"notifyErrorOnly": false
}
},
"interfaces": [
"9fc51738-e12a-4049-88dd-eb82b45da292",
"588b5c42-8634-4af7-bc9b-5e0116ed96b6"
],
"accounts": [
{
"name": "History Account",
"accountNo": "GOBI-HIST-12",
"description": "This is my account description.",
"appSystemNo": "FIN-GOBI-HIST-12",
"paymentMethod": "EFT",
"accountStatus": "Active",
"contactInfo": "Some basic contact information note.",
"libraryCode": "My Library",
"libraryEdiCode": "MY-LIB-1",
"notes": "note",
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
]
}
],
"changelogs": [
{
"description": "This is a sample note.",
"timestamp": "2008-05-15T03:53:00-07:00"
}
],
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
],
"tags" : {
"tagList" : [
"important"
]
},
"metadata": {
"createdDate": "2019-06-09T00:00:00.000+0000",
"createdByUserId": "16d2457c-d137-11e8-a8d5-f2802f1b9fd1"
}
}
],
"totalRecords": 1
}
Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.
Media type: text/plain
Type: any
Example:
unable to list organizations -- malformed parameter 'query', syntax error at column 6Not authorized to perform requested action
Media type: text/plain
Type: any
Example:
unable to list organizations -- unauthorizedValidation errors
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "errors.schema",
"description": "A set of errors",
"type": "object",
"properties": {
"errors": {
"description": "List of errors",
"id": "errors",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "error.schema",
"description": "An error",
"properties": {
"message": {
"type": "string",
"description": "Error message text"
},
"type": {
"type": "string",
"description": "Error message type"
},
"code": {
"type": "string",
"description": "Error message code"
},
"parameters": {
"description": "Error message parameters",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "parameters.schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
}
},
"required": [
"message"
]
}
},
"total_records": {
"description": "Total number of errors",
"type": "integer"
}
}
}Example:
{
"errors": [
{
"message": "may not be null",
"type": "1",
"code": "-1",
"parameters": [
{
"key": "moduleTo",
"value": "null"
}
]
}
]
}
Internal server error, e.g. due to misconfiguration
Media type: text/plain
Type: any
Example:
internal server error, contact administratorCreate a new organization item.
POST /organizations-storage/organizationsMedia type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The record of an organization",
"javaName": "Organization",
"type": "object",
"properties": {
"id": {
"description": "The unique UUID for this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"name": {
"description": "The name of this organization",
"type": "string"
},
"code": {
"description": "The code for this organization",
"type": "string",
"pattern": "[\\S ]{1,}"
},
"description": {
"description": "The description for this organization",
"type": "string"
},
"exportToAccounting": {
"description": "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.",
"type": "boolean",
"default": false
},
"status": {
"description": "The status of this organization",
"type": "string",
"enum": [
"Active",
"Inactive",
"Pending"
]
},
"organizationTypes": {
"description": "A list of organization types assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an organization type record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"uniqueItems": true
},
"language": {
"description": "The language for this organization",
"type": "string"
},
"aliases": {
"id": "aliases",
"description": "The list of aliases for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization alias",
"properties": {
"value": {
"description": "The unique name of this alias",
"type": "string"
},
"description": {
"description": "The description of this alias",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"addresses": {
"id": "addresses",
"description": "The list of addresses for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An address record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"addressLine1": {
"description": "The first line of this address",
"type": "string"
},
"addressLine2": {
"description": "The second line of this address",
"type": "string"
},
"city": {
"description": "The city for this address",
"type": "string"
},
"stateRegion": {
"description": "The state or region for this address",
"type": "string"
},
"zipCode": {
"description": "The zip code for this address",
"type": "string"
},
"country": {
"description": "The country for this address",
"type": "string"
},
"isPrimary": {
"description": "Used to set this address as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization address",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization address",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false
}
},
"phoneNumbers": {
"id": "phoneNumbers",
"description": "The list of phone numbers for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A phone number record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"phoneNumber": {
"description": "The entire sequence of digits for this phone number",
"type": "string"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization phone",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"type": {
"description": "The type of this phone number",
"type": "string",
"enum": [
"Office",
"Mobile",
"Fax",
"Other"
]
},
"isPrimary": {
"description": "Used to set this phone number as primary for the contact",
"type": "boolean"
},
"language": {
"description": "The language for this organization phone",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"phoneNumber"
]
}
},
"emails": {
"id": "emailAddresses",
"description": "The list of emails for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An email record",
"properties": {
"id": {
"description": "The unique id of this email",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this email",
"type": "string"
},
"description": {
"description": "The description for this email",
"type": "string"
},
"isPrimary": {
"description": "Used to set this email as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization email",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization email",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"urls": {
"id": "urls",
"description": "The list of URLs for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A URL record",
"properties": {
"id": {
"description": "The unique id of this url",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this URL",
"type": "string",
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"description": {
"description": "The description for this URL",
"type": "string"
},
"language": {
"description": "The language for this organization URL",
"type": "string"
},
"isPrimary": {
"description": "Used to set this url as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization URL",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"notes": {
"description": "The notes for this organization URL",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"contacts": {
"id": "contact",
"description": "An array of contact record IDs",
"type": "array",
"items": {
"description": "UUID of a contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"privilegedContacts": {
"description": "An array of privileged contact record IDs",
"type": "array",
"items": {
"description": "UUID of a privileged contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"agreements": {
"id": "agreement",
"description": "The the list of agreements for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization agreement",
"properties": {
"name": {
"description": "The unique name of this agreement",
"type": "string"
},
"discount": {
"description": "The discount amount of this agreement",
"type": "number"
},
"referenceUrl": {
"description": "The reference url for this agreement",
"type": "string"
},
"notes": {
"description": "The notes of this agreement",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"name"
]
}
},
"erpCode": {
"description": "The ERP code for this organization",
"type": "string"
},
"paymentMethod": {
"description": "The payment method for this organization",
"type": "string"
},
"accessProvider": {
"description": "The access provider for this organization",
"type": "boolean"
},
"governmental": {
"description": "The setting to mark this organization as governmental",
"type": "boolean"
},
"licensor": {
"description": "The setting to mark this organization as a licensor",
"type": "boolean"
},
"materialSupplier": {
"description": "The setting to mark this organization as a material supplier",
"type": "boolean"
},
"vendorCurrencies": {
"id": "vendorCurrencies",
"description": "The list of currencies used by this organization",
"type": "array",
"items": {
"type": "string"
}
},
"claimingInterval": {
"description": "The claim interval for this organization",
"type": "integer"
},
"discountPercent": {
"description": "The discount percentage for this organization",
"type": "number"
},
"expectedActivationInterval": {
"description": "The expected activation interval (in days) for this organization",
"type": "integer"
},
"expectedInvoiceInterval": {
"description": "The expected invoice interval (in days) for this organization",
"type": "integer"
},
"renewalActivationInterval": {
"description": "The revewal activation interval (in days) for this organization",
"type": "integer"
},
"subscriptionInterval": {
"description": "The subscription interval (in days) for this organization",
"type": "integer"
},
"expectedReceiptInterval": {
"description": "The receipt interval (in days) for this organization",
"type": "integer"
},
"taxId": {
"description": "The tax ID for this organization",
"type": "string"
},
"liableForVat": {
"description": "The setting to mark this organization liable to collect VAT",
"type": "boolean"
},
"taxPercentage": {
"description": "The tax percentage value for this organization",
"type": "number"
},
"edi": {
"description": "The EDI object for this organization (only applicable when isVendor is true)",
"type": "object",
"properties": {
"vendorEdiCode": {
"description": "The organization code for this EDI",
"type": "string"
},
"vendorEdiType": {
"description": "The organization type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"libEdiCode": {
"description": "The library code for this EDI",
"type": "string"
},
"libEdiType": {
"description": "The library type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"prorateTax": {
"description": "The setting to prorate tax for this EDI",
"type": "boolean"
},
"prorateFees": {
"description": "The setting to prorate fees for this EDI",
"type": "boolean"
},
"ediNamingConvention": {
"description": "The naming convention for this EDI",
"type": "string"
},
"sendAcctNum": {
"description": "The setting to send the account number for this EDI",
"type": "boolean"
},
"supportOrder": {
"description": "The setting to support order for this EDI",
"type": "boolean"
},
"supportInvoice": {
"description": "The setting to support invoice for this EDI",
"type": "boolean"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
},
"ediFtp": {
"description": "The FTP object for this EDI",
"type": "object",
"properties": {
"ftpFormat": {
"description": "The FTP format for this EDI",
"type": "string",
"enum": [
"SFTP",
"FTP"
]
},
"serverAddress": {
"description": "The server address for this EDI",
"type": [
"string",
"null"
],
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"username": {
"description": "The login username for this EDI",
"type": "string"
},
"password": {
"description": "The login password for this EDI",
"type": "string"
},
"ftpMode": {
"description": "The FTP mode for this EDI",
"type": "string",
"enum": [
"ASCII",
"Binary"
]
},
"ftpConnMode": {
"description": "The FTP connection mode for this EDI",
"type": "string",
"enum": [
"Active",
"Passive"
]
},
"ftpPort": {
"description": "The port for this EDI",
"type": "integer"
},
"orderDirectory": {
"description": "The order directory for this EDI",
"type": "string"
},
"invoiceDirectory": {
"description": "The invoice directory for this EDI",
"type": "string"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
}
}
},
"ediJob": {
"description": "The job object for this EDI",
"type": "object",
"properties": {
"scheduleEdi": {
"description": "Activate the schedule for this EDI job",
"type": "boolean"
},
"schedulingDate": {
"description": "The date (MM/DD/YYYY) for this EDI job to start running",
"type": [
"string",
"null"
],
"format": "date-time"
},
"time": {
"description": "The time (h:mm A) for this EDI job",
"type": [
"string",
"null"
],
"format": "time"
},
"isMonday": {
"description": "The setting to run this EDI job on Mondays",
"type": "boolean"
},
"isTuesday": {
"description": "The setting to run this EDI job on Tuesdays",
"type": "boolean"
},
"isWednesday": {
"description": "The setting to run this EDI job on Wednesdays",
"type": "boolean"
},
"isThursday": {
"description": "The setting to run this EDI job on Thursdays",
"type": "boolean"
},
"isFriday": {
"description": "The setting to run this EDI job on Fridays",
"type": "boolean"
},
"isSaturday": {
"description": "The setting to run this EDI job on Saturdays",
"type": "boolean"
},
"isSunday": {
"description": "The setting to run this EDI job on Sundays",
"type": "boolean"
},
"sendToEmails": {
"description": "The comma delimited list of email addresses to notify when this EDI job runs",
"type": "string"
},
"notifyAllEdi": {
"description": "The setting to notify all receivers when this EDI job runs",
"type": "boolean"
},
"notifyInvoiceOnly": {
"description": "The setting to notify only the invoice receiver when this EDI job runs",
"type": "boolean"
},
"notifyErrorOnly": {
"description": "The setting to notiry on the error receiver when this EDI job runs",
"type": "boolean"
},
"schedulingNotes": {
"description": "The schedule notes for this EDI job",
"type": "string"
}
}
}
}
},
"interfaces": {
"id": "interfaces",
"description": "The list of interfaces assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an interface record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"accounts": {
"id": "accounts",
"description": "The list of accounts for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization account",
"properties": {
"name": {
"description": "The unique name of this account",
"type": "string"
},
"accountNo": {
"description": "The unique number of this account",
"type": "string"
},
"description": {
"description": "The description of this account",
"type": "string"
},
"appSystemNo": {
"description": "The unique name of this group",
"type": "string"
},
"paymentMethod": {
"description": "The method of payment for this account",
"type": "string",
"enum": [
"Cash",
"Credit Card",
"EFT",
"Deposit Account",
"Physical Check",
"Bank Draft",
"Internal Transfer",
"Other"
]
},
"accountStatus": {
"description": "The status of this account",
"type": "string"
},
"contactInfo": {
"description": "The contact info for the account",
"type": "string"
},
"libraryCode": {
"description": "The library code for this account",
"type": "string"
},
"libraryEdiCode": {
"description": "The EDI code for this account",
"type": "string"
},
"notes": {
"description": "The notes for this account",
"type": "string"
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organizations account",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
}
},
"additionalProperties": false,
"required": [
"name",
"accountNo",
"accountStatus"
]
}
},
"isVendor": {
"id": "isVendor",
"description": "Used to indicate that this organization is also a vendor",
"type": "boolean",
"default": false
},
"isDonor": {
"id": "isDonor",
"description": "Used to designate whether this organization is a donor",
"type": "boolean",
"default": false
},
"sanCode": {
"description": "The SAN code for this organization address",
"type": "string"
},
"changelogs": {
"id": "changelogs",
"description": "The list of changes applied to this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A changelog record",
"properties": {
"description": {
"description": "The description of the change",
"type": "string"
},
"timestamp": {
"description": "The timestamp for when the change occurred",
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false,
"required": [
"description",
"timestamp"
]
}
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organization",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"tags": {
"type": "object",
"description": "arbitrary tags associated with this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "tags.schema",
"title": "tags",
"properties": {
"tagList": {
"description": "List of tags",
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"name",
"status",
"code"
]
}Example:
{
"name": "GOBI",
"code": "AQ-GOBI",
"description": "This is Yankee Book Peddler.",
"exportToAccounting" : true,
"status": "Active",
"organizationTypes": [
"f04c7277-0019-43cf-84b3-02d894a9d81a"
],
"language": "en-us",
"isDonor": true,
"sanCode": "1234567",
"aliases": [
{
"value": "YBP",
"description": "AKA"
},
{
"value": "Yankee Book Peddler",
"description": "Formerly known as"
}
],
"addresses": [
{
"addressLine1": "10 Estes Street",
"addressLine2": "",
"city": "Ipswich",
"stateRegion": "MA",
"zipCode": "01938",
"country": "USA",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6",
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en"
}
],
"phoneNumbers": [
{
"phoneNumber": "19789999999",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6"
],
"language": "en-us",
"type": "Office",
"isPrimary": true
}
],
"emails": [
{
"value": "noreply@folio.org",
"description": "Main",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en-us"
}
],
"urls": [
{
"value": "noreply@folio.org",
"description": "corporate",
"language": "en-us",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"notes": "note"
}
],
"contacts": [
"9a665b22-9fe5-4c95-b4ee-837a5433c95d"
],
"privilegedContacts": [
"785678a9-7966-4ad8-be46-22149513a386"
],
"agreements": [
{
"name": "History Follower Incentive",
"discount": 10,
"referenceUrl": "http://my_sample_agreement.com",
"notes": "note"
}
],
"erpCode": "AQ-GOBI-HIST",
"paymentMethod": "EFT",
"accessProvider": true,
"governmental": true,
"licensor": true,
"materialSupplier": true,
"vendorCurrencies": [
"USD",
"CAD",
"GBP"
],
"claimingInterval": 30,
"discountPercent": 10,
"expectedActivationInterval": 1,
"expectedInvoiceInterval": 5,
"renewalActivationInterval": 1,
"subscriptionInterval": 365,
"expectedReceiptInterval": 1,
"liableForVat": false,
"taxId": "TX-GOBI-HIST",
"taxPercentage": 5,
"edi": {
"vendorEdiCode": "AQ-GOBI-HIST",
"vendorEdiType": "014/EAN",
"libEdiCode": "MY-LIB-1",
"libEdiType": "014/EAN",
"prorateTax": true,
"prorateFees": true,
"ediNamingConvention": "",
"sendAcctNum": true,
"supportOrder": true,
"supportInvoice": true,
"notes": "",
"ediFtp": {
"ftpFormat": "SFTP",
"serverAddress": "http://127.0.0.1",
"username": "edi_username",
"password": "edi_password",
"ftpMode": "ASCII",
"ftpConnMode": "Active",
"ftpPort": 22,
"orderDirectory": "/path/to/order/directory",
"invoiceDirectory": "/path/to/invoice/directory",
"notes": "My FTP notes"
},
"ediJob": {
"scheduleEdi": false,
"schedulingDate": null,
"time": null,
"isMonday": false,
"isTuesday": false,
"isWednesday": false,
"isThursday": false,
"isFriday": false,
"isSaturday": false,
"isSunday": false,
"sendToEmails": "email1@site.com, email2@site.com",
"notifyAllEdi": true,
"notifyInvoiceOnly": true,
"notifyErrorOnly": false
}
},
"interfaces": [
"9fc51738-e12a-4049-88dd-eb82b45da292",
"588b5c42-8634-4af7-bc9b-5e0116ed96b6"
],
"accounts": [
{
"name": "History Account",
"accountNo": "GOBI-HIST-12",
"description": "This is my account description.",
"appSystemNo": "FIN-GOBI-HIST-12",
"paymentMethod": "EFT",
"accountStatus": "Active",
"contactInfo": "Some basic contact information note.",
"libraryCode": "My Library",
"libraryEdiCode": "MY-LIB-1",
"notes": "note",
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
]
}
],
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
],
"tags" : {
"tagList" : [
"important"
]
},
"changelogs": [
{
"description": "This is a sample note.",
"timestamp": "2008-05-15T03:53:00-07:00"
}
]
}
Returns a newly created item, with server-controlled fields like 'id' populated
URI to the created organization item
Media type: application/json
Type: any
Example:
{
"name": "GOBI",
"code": "AQ-GOBI",
"description": "This is Yankee Book Peddler.",
"exportToAccounting" : true,
"status": "Active",
"organizationTypes": [
"f04c7277-0019-43cf-84b3-02d894a9d81a"
],
"language": "en-us",
"isDonor": true,
"sanCode": "1234567",
"aliases": [
{
"value": "YBP",
"description": "AKA"
},
{
"value": "Yankee Book Peddler",
"description": "Formerly known as"
}
],
"addresses": [
{
"addressLine1": "10 Estes Street",
"addressLine2": "",
"city": "Ipswich",
"stateRegion": "MA",
"zipCode": "01938",
"country": "USA",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6",
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en"
}
],
"phoneNumbers": [
{
"phoneNumber": "19789999999",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6"
],
"language": "en-us",
"type": "Office",
"isPrimary": true
}
],
"emails": [
{
"value": "noreply@folio.org",
"description": "Main",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en-us"
}
],
"urls": [
{
"value": "noreply@folio.org",
"description": "corporate",
"language": "en-us",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"notes": "note"
}
],
"contacts": [
"9a665b22-9fe5-4c95-b4ee-837a5433c95d"
],
"privilegedContacts": [
"785678a9-7966-4ad8-be46-22149513a386"
],
"agreements": [
{
"name": "History Follower Incentive",
"discount": 10,
"referenceUrl": "http://my_sample_agreement.com",
"notes": "note"
}
],
"erpCode": "AQ-GOBI-HIST",
"paymentMethod": "EFT",
"accessProvider": true,
"governmental": true,
"licensor": true,
"materialSupplier": true,
"vendorCurrencies": [
"USD",
"CAD",
"GBP"
],
"claimingInterval": 30,
"discountPercent": 10,
"expectedActivationInterval": 1,
"expectedInvoiceInterval": 5,
"renewalActivationInterval": 1,
"subscriptionInterval": 365,
"expectedReceiptInterval": 1,
"liableForVat": false,
"taxId": "TX-GOBI-HIST",
"taxPercentage": 5,
"edi": {
"vendorEdiCode": "AQ-GOBI-HIST",
"vendorEdiType": "014/EAN",
"libEdiCode": "MY-LIB-1",
"libEdiType": "014/EAN",
"prorateTax": true,
"prorateFees": true,
"ediNamingConvention": "",
"sendAcctNum": true,
"supportOrder": true,
"supportInvoice": true,
"notes": "",
"ediFtp": {
"ftpFormat": "SFTP",
"serverAddress": "http://127.0.0.1",
"username": "edi_username",
"password": "edi_password",
"ftpMode": "ASCII",
"ftpConnMode": "Active",
"ftpPort": 22,
"orderDirectory": "/path/to/order/directory",
"invoiceDirectory": "/path/to/invoice/directory",
"notes": "My FTP notes"
},
"ediJob": {
"scheduleEdi": false,
"schedulingDate": null,
"time": null,
"isMonday": false,
"isTuesday": false,
"isWednesday": false,
"isThursday": false,
"isFriday": false,
"isSaturday": false,
"isSunday": false,
"sendToEmails": "email1@site.com, email2@site.com",
"notifyAllEdi": true,
"notifyInvoiceOnly": true,
"notifyErrorOnly": false
}
},
"interfaces": [
"9fc51738-e12a-4049-88dd-eb82b45da292",
"588b5c42-8634-4af7-bc9b-5e0116ed96b6"
],
"accounts": [
{
"name": "History Account",
"accountNo": "GOBI-HIST-12",
"description": "This is my account description.",
"appSystemNo": "FIN-GOBI-HIST-12",
"paymentMethod": "EFT",
"accountStatus": "Active",
"contactInfo": "Some basic contact information note.",
"libraryCode": "My Library",
"libraryEdiCode": "MY-LIB-1",
"notes": "note",
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
]
}
],
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
],
"tags" : {
"tagList" : [
"important"
]
},
"changelogs": [
{
"description": "This is a sample note.",
"timestamp": "2008-05-15T03:53:00-07:00"
}
]
}
Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.
Media type: text/plain
Type: any
Example:
"unable to add organization -- malformed JSON at 13:3"
Not authorized to perform requested action
Media type: text/plain
Type: any
Example:
unable to create organizations -- unauthorizedValidation errors
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "errors.schema",
"description": "A set of errors",
"type": "object",
"properties": {
"errors": {
"description": "List of errors",
"id": "errors",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "error.schema",
"description": "An error",
"properties": {
"message": {
"type": "string",
"description": "Error message text"
},
"type": {
"type": "string",
"description": "Error message type"
},
"code": {
"type": "string",
"description": "Error message code"
},
"parameters": {
"description": "Error message parameters",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "parameters.schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
}
},
"required": [
"message"
]
}
},
"total_records": {
"description": "Total number of errors",
"type": "integer"
}
}
}Example:
{
"errors": [
{
"message": "may not be null",
"type": "1",
"code": "-1",
"parameters": [
{
"key": "moduleTo",
"value": "null"
}
]
}
]
}
Internal server error, e.g. due to misconfiguration
Media type: text/plain
Type: any
Example:
Internal server error, contact administratorUpdate organization with 'organization_id'
PUT /organizations-storage/organizations/{id}The UUID of Organization
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The record of an organization",
"javaName": "Organization",
"type": "object",
"properties": {
"id": {
"description": "The unique UUID for this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"name": {
"description": "The name of this organization",
"type": "string"
},
"code": {
"description": "The code for this organization",
"type": "string",
"pattern": "[\\S ]{1,}"
},
"description": {
"description": "The description for this organization",
"type": "string"
},
"exportToAccounting": {
"description": "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.",
"type": "boolean",
"default": false
},
"status": {
"description": "The status of this organization",
"type": "string",
"enum": [
"Active",
"Inactive",
"Pending"
]
},
"organizationTypes": {
"description": "A list of organization types assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an organization type record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"uniqueItems": true
},
"language": {
"description": "The language for this organization",
"type": "string"
},
"aliases": {
"id": "aliases",
"description": "The list of aliases for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization alias",
"properties": {
"value": {
"description": "The unique name of this alias",
"type": "string"
},
"description": {
"description": "The description of this alias",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"addresses": {
"id": "addresses",
"description": "The list of addresses for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An address record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"addressLine1": {
"description": "The first line of this address",
"type": "string"
},
"addressLine2": {
"description": "The second line of this address",
"type": "string"
},
"city": {
"description": "The city for this address",
"type": "string"
},
"stateRegion": {
"description": "The state or region for this address",
"type": "string"
},
"zipCode": {
"description": "The zip code for this address",
"type": "string"
},
"country": {
"description": "The country for this address",
"type": "string"
},
"isPrimary": {
"description": "Used to set this address as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization address",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization address",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false
}
},
"phoneNumbers": {
"id": "phoneNumbers",
"description": "The list of phone numbers for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A phone number record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"phoneNumber": {
"description": "The entire sequence of digits for this phone number",
"type": "string"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization phone",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"type": {
"description": "The type of this phone number",
"type": "string",
"enum": [
"Office",
"Mobile",
"Fax",
"Other"
]
},
"isPrimary": {
"description": "Used to set this phone number as primary for the contact",
"type": "boolean"
},
"language": {
"description": "The language for this organization phone",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"phoneNumber"
]
}
},
"emails": {
"id": "emailAddresses",
"description": "The list of emails for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An email record",
"properties": {
"id": {
"description": "The unique id of this email",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this email",
"type": "string"
},
"description": {
"description": "The description for this email",
"type": "string"
},
"isPrimary": {
"description": "Used to set this email as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization email",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization email",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"urls": {
"id": "urls",
"description": "The list of URLs for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A URL record",
"properties": {
"id": {
"description": "The unique id of this url",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this URL",
"type": "string",
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"description": {
"description": "The description for this URL",
"type": "string"
},
"language": {
"description": "The language for this organization URL",
"type": "string"
},
"isPrimary": {
"description": "Used to set this url as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization URL",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"notes": {
"description": "The notes for this organization URL",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"contacts": {
"id": "contact",
"description": "An array of contact record IDs",
"type": "array",
"items": {
"description": "UUID of a contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"privilegedContacts": {
"description": "An array of privileged contact record IDs",
"type": "array",
"items": {
"description": "UUID of a privileged contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"agreements": {
"id": "agreement",
"description": "The the list of agreements for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization agreement",
"properties": {
"name": {
"description": "The unique name of this agreement",
"type": "string"
},
"discount": {
"description": "The discount amount of this agreement",
"type": "number"
},
"referenceUrl": {
"description": "The reference url for this agreement",
"type": "string"
},
"notes": {
"description": "The notes of this agreement",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"name"
]
}
},
"erpCode": {
"description": "The ERP code for this organization",
"type": "string"
},
"paymentMethod": {
"description": "The payment method for this organization",
"type": "string"
},
"accessProvider": {
"description": "The access provider for this organization",
"type": "boolean"
},
"governmental": {
"description": "The setting to mark this organization as governmental",
"type": "boolean"
},
"licensor": {
"description": "The setting to mark this organization as a licensor",
"type": "boolean"
},
"materialSupplier": {
"description": "The setting to mark this organization as a material supplier",
"type": "boolean"
},
"vendorCurrencies": {
"id": "vendorCurrencies",
"description": "The list of currencies used by this organization",
"type": "array",
"items": {
"type": "string"
}
},
"claimingInterval": {
"description": "The claim interval for this organization",
"type": "integer"
},
"discountPercent": {
"description": "The discount percentage for this organization",
"type": "number"
},
"expectedActivationInterval": {
"description": "The expected activation interval (in days) for this organization",
"type": "integer"
},
"expectedInvoiceInterval": {
"description": "The expected invoice interval (in days) for this organization",
"type": "integer"
},
"renewalActivationInterval": {
"description": "The revewal activation interval (in days) for this organization",
"type": "integer"
},
"subscriptionInterval": {
"description": "The subscription interval (in days) for this organization",
"type": "integer"
},
"expectedReceiptInterval": {
"description": "The receipt interval (in days) for this organization",
"type": "integer"
},
"taxId": {
"description": "The tax ID for this organization",
"type": "string"
},
"liableForVat": {
"description": "The setting to mark this organization liable to collect VAT",
"type": "boolean"
},
"taxPercentage": {
"description": "The tax percentage value for this organization",
"type": "number"
},
"edi": {
"description": "The EDI object for this organization (only applicable when isVendor is true)",
"type": "object",
"properties": {
"vendorEdiCode": {
"description": "The organization code for this EDI",
"type": "string"
},
"vendorEdiType": {
"description": "The organization type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"libEdiCode": {
"description": "The library code for this EDI",
"type": "string"
},
"libEdiType": {
"description": "The library type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"prorateTax": {
"description": "The setting to prorate tax for this EDI",
"type": "boolean"
},
"prorateFees": {
"description": "The setting to prorate fees for this EDI",
"type": "boolean"
},
"ediNamingConvention": {
"description": "The naming convention for this EDI",
"type": "string"
},
"sendAcctNum": {
"description": "The setting to send the account number for this EDI",
"type": "boolean"
},
"supportOrder": {
"description": "The setting to support order for this EDI",
"type": "boolean"
},
"supportInvoice": {
"description": "The setting to support invoice for this EDI",
"type": "boolean"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
},
"ediFtp": {
"description": "The FTP object for this EDI",
"type": "object",
"properties": {
"ftpFormat": {
"description": "The FTP format for this EDI",
"type": "string",
"enum": [
"SFTP",
"FTP"
]
},
"serverAddress": {
"description": "The server address for this EDI",
"type": [
"string",
"null"
],
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"username": {
"description": "The login username for this EDI",
"type": "string"
},
"password": {
"description": "The login password for this EDI",
"type": "string"
},
"ftpMode": {
"description": "The FTP mode for this EDI",
"type": "string",
"enum": [
"ASCII",
"Binary"
]
},
"ftpConnMode": {
"description": "The FTP connection mode for this EDI",
"type": "string",
"enum": [
"Active",
"Passive"
]
},
"ftpPort": {
"description": "The port for this EDI",
"type": "integer"
},
"orderDirectory": {
"description": "The order directory for this EDI",
"type": "string"
},
"invoiceDirectory": {
"description": "The invoice directory for this EDI",
"type": "string"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
}
}
},
"ediJob": {
"description": "The job object for this EDI",
"type": "object",
"properties": {
"scheduleEdi": {
"description": "Activate the schedule for this EDI job",
"type": "boolean"
},
"schedulingDate": {
"description": "The date (MM/DD/YYYY) for this EDI job to start running",
"type": [
"string",
"null"
],
"format": "date-time"
},
"time": {
"description": "The time (h:mm A) for this EDI job",
"type": [
"string",
"null"
],
"format": "time"
},
"isMonday": {
"description": "The setting to run this EDI job on Mondays",
"type": "boolean"
},
"isTuesday": {
"description": "The setting to run this EDI job on Tuesdays",
"type": "boolean"
},
"isWednesday": {
"description": "The setting to run this EDI job on Wednesdays",
"type": "boolean"
},
"isThursday": {
"description": "The setting to run this EDI job on Thursdays",
"type": "boolean"
},
"isFriday": {
"description": "The setting to run this EDI job on Fridays",
"type": "boolean"
},
"isSaturday": {
"description": "The setting to run this EDI job on Saturdays",
"type": "boolean"
},
"isSunday": {
"description": "The setting to run this EDI job on Sundays",
"type": "boolean"
},
"sendToEmails": {
"description": "The comma delimited list of email addresses to notify when this EDI job runs",
"type": "string"
},
"notifyAllEdi": {
"description": "The setting to notify all receivers when this EDI job runs",
"type": "boolean"
},
"notifyInvoiceOnly": {
"description": "The setting to notify only the invoice receiver when this EDI job runs",
"type": "boolean"
},
"notifyErrorOnly": {
"description": "The setting to notiry on the error receiver when this EDI job runs",
"type": "boolean"
},
"schedulingNotes": {
"description": "The schedule notes for this EDI job",
"type": "string"
}
}
}
}
},
"interfaces": {
"id": "interfaces",
"description": "The list of interfaces assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an interface record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"accounts": {
"id": "accounts",
"description": "The list of accounts for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization account",
"properties": {
"name": {
"description": "The unique name of this account",
"type": "string"
},
"accountNo": {
"description": "The unique number of this account",
"type": "string"
},
"description": {
"description": "The description of this account",
"type": "string"
},
"appSystemNo": {
"description": "The unique name of this group",
"type": "string"
},
"paymentMethod": {
"description": "The method of payment for this account",
"type": "string",
"enum": [
"Cash",
"Credit Card",
"EFT",
"Deposit Account",
"Physical Check",
"Bank Draft",
"Internal Transfer",
"Other"
]
},
"accountStatus": {
"description": "The status of this account",
"type": "string"
},
"contactInfo": {
"description": "The contact info for the account",
"type": "string"
},
"libraryCode": {
"description": "The library code for this account",
"type": "string"
},
"libraryEdiCode": {
"description": "The EDI code for this account",
"type": "string"
},
"notes": {
"description": "The notes for this account",
"type": "string"
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organizations account",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
}
},
"additionalProperties": false,
"required": [
"name",
"accountNo",
"accountStatus"
]
}
},
"isVendor": {
"id": "isVendor",
"description": "Used to indicate that this organization is also a vendor",
"type": "boolean",
"default": false
},
"isDonor": {
"id": "isDonor",
"description": "Used to designate whether this organization is a donor",
"type": "boolean",
"default": false
},
"sanCode": {
"description": "The SAN code for this organization address",
"type": "string"
},
"changelogs": {
"id": "changelogs",
"description": "The list of changes applied to this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A changelog record",
"properties": {
"description": {
"description": "The description of the change",
"type": "string"
},
"timestamp": {
"description": "The timestamp for when the change occurred",
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false,
"required": [
"description",
"timestamp"
]
}
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organization",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"tags": {
"type": "object",
"description": "arbitrary tags associated with this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "tags.schema",
"title": "tags",
"properties": {
"tagList": {
"description": "List of tags",
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"name",
"status",
"code"
]
}Example:
{
"name": "GOBI",
"code": "AQ-GOBI",
"description": "This is Yankee Book Peddler.",
"exportToAccounting" : true,
"status": "Active",
"organizationTypes": [
"f04c7277-0019-43cf-84b3-02d894a9d81a"
],
"language": "en-us",
"isDonor": true,
"sanCode": "1234567",
"aliases": [
{
"value": "YBP",
"description": "AKA"
},
{
"value": "Yankee Book Peddler",
"description": "Formerly known as"
}
],
"addresses": [
{
"addressLine1": "10 Estes Street",
"addressLine2": "",
"city": "Ipswich",
"stateRegion": "MA",
"zipCode": "01938",
"country": "USA",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6",
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en"
}
],
"phoneNumbers": [
{
"phoneNumber": "19789999999",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6"
],
"language": "en-us",
"type": "Office",
"isPrimary": true
}
],
"emails": [
{
"value": "noreply@folio.org",
"description": "Main",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en-us"
}
],
"urls": [
{
"value": "noreply@folio.org",
"description": "corporate",
"language": "en-us",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"notes": "note"
}
],
"contacts": [
"9a665b22-9fe5-4c95-b4ee-837a5433c95d"
],
"privilegedContacts": [
"785678a9-7966-4ad8-be46-22149513a386"
],
"agreements": [
{
"name": "History Follower Incentive",
"discount": 10,
"referenceUrl": "http://my_sample_agreement.com",
"notes": "note"
}
],
"erpCode": "AQ-GOBI-HIST",
"paymentMethod": "EFT",
"accessProvider": true,
"governmental": true,
"licensor": true,
"materialSupplier": true,
"vendorCurrencies": [
"USD",
"CAD",
"GBP"
],
"claimingInterval": 30,
"discountPercent": 10,
"expectedActivationInterval": 1,
"expectedInvoiceInterval": 5,
"renewalActivationInterval": 1,
"subscriptionInterval": 365,
"expectedReceiptInterval": 1,
"liableForVat": false,
"taxId": "TX-GOBI-HIST",
"taxPercentage": 5,
"edi": {
"vendorEdiCode": "AQ-GOBI-HIST",
"vendorEdiType": "014/EAN",
"libEdiCode": "MY-LIB-1",
"libEdiType": "014/EAN",
"prorateTax": true,
"prorateFees": true,
"ediNamingConvention": "",
"sendAcctNum": true,
"supportOrder": true,
"supportInvoice": true,
"notes": "",
"ediFtp": {
"ftpFormat": "SFTP",
"serverAddress": "http://127.0.0.1",
"username": "edi_username",
"password": "edi_password",
"ftpMode": "ASCII",
"ftpConnMode": "Active",
"ftpPort": 22,
"orderDirectory": "/path/to/order/directory",
"invoiceDirectory": "/path/to/invoice/directory",
"notes": "My FTP notes"
},
"ediJob": {
"scheduleEdi": false,
"schedulingDate": null,
"time": null,
"isMonday": false,
"isTuesday": false,
"isWednesday": false,
"isThursday": false,
"isFriday": false,
"isSaturday": false,
"isSunday": false,
"sendToEmails": "email1@site.com, email2@site.com",
"notifyAllEdi": true,
"notifyInvoiceOnly": true,
"notifyErrorOnly": false
}
},
"interfaces": [
"9fc51738-e12a-4049-88dd-eb82b45da292",
"588b5c42-8634-4af7-bc9b-5e0116ed96b6"
],
"accounts": [
{
"name": "History Account",
"accountNo": "GOBI-HIST-12",
"description": "This is my account description.",
"appSystemNo": "FIN-GOBI-HIST-12",
"paymentMethod": "EFT",
"accountStatus": "Active",
"contactInfo": "Some basic contact information note.",
"libraryCode": "My Library",
"libraryEdiCode": "MY-LIB-1",
"notes": "note",
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
]
}
],
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
],
"tags" : {
"tagList" : [
"important"
]
},
"changelogs": [
{
"description": "This is a sample note.",
"timestamp": "2008-05-15T03:53:00-07:00"
}
]
}
Item successfully updated
Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.
Media type: text/plain
Type: any
Example:
"unable to update organization -- malformed JSON at 13:4"
Item with a given ID not found
Media type: text/plain
Type: any
Example:
"organization not found"
Optimistic locking version conflict
Media type: text/plain
Type: any
Example:
version conflictValidation errors
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "errors.schema",
"description": "A set of errors",
"type": "object",
"properties": {
"errors": {
"description": "List of errors",
"id": "errors",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "error.schema",
"description": "An error",
"properties": {
"message": {
"type": "string",
"description": "Error message text"
},
"type": {
"type": "string",
"description": "Error message type"
},
"code": {
"type": "string",
"description": "Error message code"
},
"parameters": {
"description": "Error message parameters",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "parameters.schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
}
},
"required": [
"message"
]
}
},
"total_records": {
"description": "Total number of errors",
"type": "integer"
}
}
}Example:
{
"errors": [
{
"message": "may not be null",
"type": "1",
"code": "-1",
"parameters": [
{
"key": "moduleTo",
"value": "null"
}
]
}
]
}
Internal server error, e.g. due to misconfiguration
Media type: text/plain
Type: any
Example:
internal server error, contact administratorRetrieve organization item with given {organizationId}
GET /organizations-storage/organizations/{id}The UUID of Organization
Returns item with a given ID
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The record of an organization",
"javaName": "Organization",
"type": "object",
"properties": {
"id": {
"description": "The unique UUID for this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"name": {
"description": "The name of this organization",
"type": "string"
},
"code": {
"description": "The code for this organization",
"type": "string",
"pattern": "[\\S ]{1,}"
},
"description": {
"description": "The description for this organization",
"type": "string"
},
"exportToAccounting": {
"description": "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.",
"type": "boolean",
"default": false
},
"status": {
"description": "The status of this organization",
"type": "string",
"enum": [
"Active",
"Inactive",
"Pending"
]
},
"organizationTypes": {
"description": "A list of organization types assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an organization type record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"uniqueItems": true
},
"language": {
"description": "The language for this organization",
"type": "string"
},
"aliases": {
"id": "aliases",
"description": "The list of aliases for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization alias",
"properties": {
"value": {
"description": "The unique name of this alias",
"type": "string"
},
"description": {
"description": "The description of this alias",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"addresses": {
"id": "addresses",
"description": "The list of addresses for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An address record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"addressLine1": {
"description": "The first line of this address",
"type": "string"
},
"addressLine2": {
"description": "The second line of this address",
"type": "string"
},
"city": {
"description": "The city for this address",
"type": "string"
},
"stateRegion": {
"description": "The state or region for this address",
"type": "string"
},
"zipCode": {
"description": "The zip code for this address",
"type": "string"
},
"country": {
"description": "The country for this address",
"type": "string"
},
"isPrimary": {
"description": "Used to set this address as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization address",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization address",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false
}
},
"phoneNumbers": {
"id": "phoneNumbers",
"description": "The list of phone numbers for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A phone number record",
"properties": {
"id": {
"description": "UUID",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"phoneNumber": {
"description": "The entire sequence of digits for this phone number",
"type": "string"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization phone",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"type": {
"description": "The type of this phone number",
"type": "string",
"enum": [
"Office",
"Mobile",
"Fax",
"Other"
]
},
"isPrimary": {
"description": "Used to set this phone number as primary for the contact",
"type": "boolean"
},
"language": {
"description": "The language for this organization phone",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"phoneNumber"
]
}
},
"emails": {
"id": "emailAddresses",
"description": "The list of emails for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An email record",
"properties": {
"id": {
"description": "The unique id of this email",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this email",
"type": "string"
},
"description": {
"description": "The description for this email",
"type": "string"
},
"isPrimary": {
"description": "Used to set this email as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization email",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"language": {
"description": "The language for this organization email",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"urls": {
"id": "urls",
"description": "The list of URLs for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A URL record",
"properties": {
"id": {
"description": "The unique id of this url",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
},
"value": {
"description": "The value for this URL",
"type": "string",
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"description": {
"description": "The description for this URL",
"type": "string"
},
"language": {
"description": "The language for this organization URL",
"type": "string"
},
"isPrimary": {
"description": "Used to set this url as primary for the contact",
"type": "boolean"
},
"categories": {
"id": "categories",
"description": "The list of category ids for this organization URL",
"type": "array",
"items": {
"description": "UUID of the organization category",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"notes": {
"description": "The notes for this organization URL",
"type": "string"
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
},
"contacts": {
"id": "contact",
"description": "An array of contact record IDs",
"type": "array",
"items": {
"description": "UUID of a contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"privilegedContacts": {
"description": "An array of privileged contact record IDs",
"type": "array",
"items": {
"description": "UUID of a privileged contact record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"agreements": {
"id": "agreement",
"description": "The the list of agreements for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization agreement",
"properties": {
"name": {
"description": "The unique name of this agreement",
"type": "string"
},
"discount": {
"description": "The discount amount of this agreement",
"type": "number"
},
"referenceUrl": {
"description": "The reference url for this agreement",
"type": "string"
},
"notes": {
"description": "The notes of this agreement",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"name"
]
}
},
"erpCode": {
"description": "The ERP code for this organization",
"type": "string"
},
"paymentMethod": {
"description": "The payment method for this organization",
"type": "string"
},
"accessProvider": {
"description": "The access provider for this organization",
"type": "boolean"
},
"governmental": {
"description": "The setting to mark this organization as governmental",
"type": "boolean"
},
"licensor": {
"description": "The setting to mark this organization as a licensor",
"type": "boolean"
},
"materialSupplier": {
"description": "The setting to mark this organization as a material supplier",
"type": "boolean"
},
"vendorCurrencies": {
"id": "vendorCurrencies",
"description": "The list of currencies used by this organization",
"type": "array",
"items": {
"type": "string"
}
},
"claimingInterval": {
"description": "The claim interval for this organization",
"type": "integer"
},
"discountPercent": {
"description": "The discount percentage for this organization",
"type": "number"
},
"expectedActivationInterval": {
"description": "The expected activation interval (in days) for this organization",
"type": "integer"
},
"expectedInvoiceInterval": {
"description": "The expected invoice interval (in days) for this organization",
"type": "integer"
},
"renewalActivationInterval": {
"description": "The revewal activation interval (in days) for this organization",
"type": "integer"
},
"subscriptionInterval": {
"description": "The subscription interval (in days) for this organization",
"type": "integer"
},
"expectedReceiptInterval": {
"description": "The receipt interval (in days) for this organization",
"type": "integer"
},
"taxId": {
"description": "The tax ID for this organization",
"type": "string"
},
"liableForVat": {
"description": "The setting to mark this organization liable to collect VAT",
"type": "boolean"
},
"taxPercentage": {
"description": "The tax percentage value for this organization",
"type": "number"
},
"edi": {
"description": "The EDI object for this organization (only applicable when isVendor is true)",
"type": "object",
"properties": {
"vendorEdiCode": {
"description": "The organization code for this EDI",
"type": "string"
},
"vendorEdiType": {
"description": "The organization type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"libEdiCode": {
"description": "The library code for this EDI",
"type": "string"
},
"libEdiType": {
"description": "The library type for this EDI",
"type": "string",
"enum": [
"014/EAN",
"31B/US-SAN",
"091/Vendor-assigned",
"092/Customer-assigned"
]
},
"prorateTax": {
"description": "The setting to prorate tax for this EDI",
"type": "boolean"
},
"prorateFees": {
"description": "The setting to prorate fees for this EDI",
"type": "boolean"
},
"ediNamingConvention": {
"description": "The naming convention for this EDI",
"type": "string"
},
"sendAcctNum": {
"description": "The setting to send the account number for this EDI",
"type": "boolean"
},
"supportOrder": {
"description": "The setting to support order for this EDI",
"type": "boolean"
},
"supportInvoice": {
"description": "The setting to support invoice for this EDI",
"type": "boolean"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
},
"ediFtp": {
"description": "The FTP object for this EDI",
"type": "object",
"properties": {
"ftpFormat": {
"description": "The FTP format for this EDI",
"type": "string",
"enum": [
"SFTP",
"FTP"
]
},
"serverAddress": {
"description": "The server address for this EDI",
"type": [
"string",
"null"
],
"pattern": "^$|(([Hh][Tt][Tt][Pp]|[Ff][Tt][Pp])([Ss])?://.+$)"
},
"username": {
"description": "The login username for this EDI",
"type": "string"
},
"password": {
"description": "The login password for this EDI",
"type": "string"
},
"ftpMode": {
"description": "The FTP mode for this EDI",
"type": "string",
"enum": [
"ASCII",
"Binary"
]
},
"ftpConnMode": {
"description": "The FTP connection mode for this EDI",
"type": "string",
"enum": [
"Active",
"Passive"
]
},
"ftpPort": {
"description": "The port for this EDI",
"type": "integer"
},
"orderDirectory": {
"description": "The order directory for this EDI",
"type": "string"
},
"invoiceDirectory": {
"description": "The invoice directory for this EDI",
"type": "string"
},
"notes": {
"description": "The notes for this EDI",
"type": "string"
}
}
},
"ediJob": {
"description": "The job object for this EDI",
"type": "object",
"properties": {
"scheduleEdi": {
"description": "Activate the schedule for this EDI job",
"type": "boolean"
},
"schedulingDate": {
"description": "The date (MM/DD/YYYY) for this EDI job to start running",
"type": [
"string",
"null"
],
"format": "date-time"
},
"time": {
"description": "The time (h:mm A) for this EDI job",
"type": [
"string",
"null"
],
"format": "time"
},
"isMonday": {
"description": "The setting to run this EDI job on Mondays",
"type": "boolean"
},
"isTuesday": {
"description": "The setting to run this EDI job on Tuesdays",
"type": "boolean"
},
"isWednesday": {
"description": "The setting to run this EDI job on Wednesdays",
"type": "boolean"
},
"isThursday": {
"description": "The setting to run this EDI job on Thursdays",
"type": "boolean"
},
"isFriday": {
"description": "The setting to run this EDI job on Fridays",
"type": "boolean"
},
"isSaturday": {
"description": "The setting to run this EDI job on Saturdays",
"type": "boolean"
},
"isSunday": {
"description": "The setting to run this EDI job on Sundays",
"type": "boolean"
},
"sendToEmails": {
"description": "The comma delimited list of email addresses to notify when this EDI job runs",
"type": "string"
},
"notifyAllEdi": {
"description": "The setting to notify all receivers when this EDI job runs",
"type": "boolean"
},
"notifyInvoiceOnly": {
"description": "The setting to notify only the invoice receiver when this EDI job runs",
"type": "boolean"
},
"notifyErrorOnly": {
"description": "The setting to notiry on the error receiver when this EDI job runs",
"type": "boolean"
},
"schedulingNotes": {
"description": "The schedule notes for this EDI job",
"type": "string"
}
}
}
}
},
"interfaces": {
"id": "interfaces",
"description": "The list of interfaces assigned to this organization",
"type": "array",
"items": {
"description": "UUID of an interface record",
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"accounts": {
"id": "accounts",
"description": "The list of accounts for this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "An organization account",
"properties": {
"name": {
"description": "The unique name of this account",
"type": "string"
},
"accountNo": {
"description": "The unique number of this account",
"type": "string"
},
"description": {
"description": "The description of this account",
"type": "string"
},
"appSystemNo": {
"description": "The unique name of this group",
"type": "string"
},
"paymentMethod": {
"description": "The method of payment for this account",
"type": "string",
"enum": [
"Cash",
"Credit Card",
"EFT",
"Deposit Account",
"Physical Check",
"Bank Draft",
"Internal Transfer",
"Other"
]
},
"accountStatus": {
"description": "The status of this account",
"type": "string"
},
"contactInfo": {
"description": "The contact info for the account",
"type": "string"
},
"libraryCode": {
"description": "The library code for this account",
"type": "string"
},
"libraryEdiCode": {
"description": "The EDI code for this account",
"type": "string"
},
"notes": {
"description": "The notes for this account",
"type": "string"
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organizations account",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
}
},
"additionalProperties": false,
"required": [
"name",
"accountNo",
"accountStatus"
]
}
},
"isVendor": {
"id": "isVendor",
"description": "Used to indicate that this organization is also a vendor",
"type": "boolean",
"default": false
},
"isDonor": {
"id": "isDonor",
"description": "Used to designate whether this organization is a donor",
"type": "boolean",
"default": false
},
"sanCode": {
"description": "The SAN code for this organization address",
"type": "string"
},
"changelogs": {
"id": "changelogs",
"description": "The list of changes applied to this organization",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A changelog record",
"properties": {
"description": {
"description": "The description of the change",
"type": "string"
},
"timestamp": {
"description": "The timestamp for when the change occurred",
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false,
"required": [
"description",
"timestamp"
]
}
},
"acqUnitIds": {
"description": "Acquisition unit UUIDs associated with this organization",
"type": "array",
"items": {
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "The UUID format string",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"tags": {
"type": "object",
"description": "arbitrary tags associated with this organization",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "tags.schema",
"title": "tags",
"properties": {
"tagList": {
"description": "List of tags",
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"readonly": true,
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "metadata.schema",
"title": "Metadata Schema",
"description": "Metadata about creation and changes to records, provided by the server (client should not provide)",
"properties": {
"createdDate": {
"description": "Date and time when the record was created",
"type": "string",
"format": "date-time"
},
"createdByUserId": {
"description": "ID of the user who created the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"createdByUsername": {
"description": "Username of the user who created the record (when available)",
"type": "string"
},
"updatedDate": {
"description": "Date and time when the record was last updated",
"type": "string",
"format": "date-time"
},
"updatedByUserId": {
"description": "ID of the user who last updated the record (when available)",
"type": "string",
"pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$"
},
"updatedByUsername": {
"description": "Username of the user who last updated the record (when available)",
"type": "string"
}
},
"additionalProperties": false,
"required": [
"createdDate"
]
}
},
"additionalProperties": false,
"required": [
"name",
"status",
"code"
]
}Example:
{
"id": "588b5c42-8634-4af7-bc9b-5e0116ed96b6",
"name": "GOBI",
"code": "AQ-GOBI",
"description": "This is Yankee Book Peddler.",
"exportToAccounting" : true,
"status": "Active",
"organizationTypes": [
"f04c7277-0019-43cf-84b3-02d894a9d81a"
],
"language": "en-us",
"isVendor": true,
"sanCode": "1234567",
"aliases": [
{
"value": "YBP",
"description": "AKA"
},
{
"value": "Yankee Book Peddler",
"description": "Formerly known as"
}
],
"addresses": [
{
"addressLine1": "10 Estes Street",
"addressLine2": "",
"city": "Ipswich",
"stateRegion": "MA",
"zipCode": "01938",
"country": "USA",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6",
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en"
}
],
"phoneNumbers": [
{
"phoneNumber": "19789999999",
"categories": [
"0e3f9680-ab06-4565-af64-609b7364e6eb",
"996ecd31-7ca4-4d8d-9bbf-bc94dff5f6c6"
],
"language": "en-us"
}
],
"emails": [
{
"value": "noreply@folio.org",
"description": "Main",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"language": "en-us"
}
],
"urls": [
{
"value": "http://folio.org",
"description": "corporate",
"language": "en-us",
"categories": [
"112ae2e4-88ae-4fa5-a75b-2379d2035e52",
"56288fe8-8037-44da-8395-01d2d106dc54"
],
"notes": "note"
}
],
"contacts": [
"9a665b22-9fe5-4c95-b4ee-837a5433c95d"
],
"privilegedContacts": [
"785678a9-7966-4ad8-be46-22149513a386"
],
"agreements": [
{
"name": "History Follower Incentive",
"discount": 10,
"referenceUrl": "http://my_sample_agreement.com",
"notes": ""
}
],
"erpCode": "AQ-GOBI-HIST",
"paymentMethod": "EFT",
"accessProvider": true,
"governmental": true,
"licensor": true,
"materialSupplier": true,
"vendorCurrencies": [
"USD",
"CAD",
"GBP"
],
"claimingInterval": 30,
"discountPercent": 10,
"expectedActivationInterval": 1,
"expectedInvoiceInterval": 5,
"renewalActivationInterval": 1,
"subscriptionInterval": 365,
"expectedReceiptInterval": 1,
"liableForVat": false,
"taxId": "TX-GOBI-HIST",
"taxPercentage": 5,
"edi": {
"vendorEdiCode": "AQ-GOBI-HIST",
"vendorEdiType": "014/EAN",
"libEdiCode": "MY-LIB-1",
"libEdiType": "014/EAN",
"prorateTax": true,
"prorateFees": true,
"ediNamingConvention": "",
"sendAcctNum": true,
"supportOrder": true,
"supportInvoice": true,
"notes": "",
"ediFtp": {
"ftpFormat": "SFTP",
"serverAddress": "http://127.0.0.1",
"username": "edi_username",
"password": "edi_password",
"ftpMode": "ASCII",
"ftpConnMode": "Active",
"ftpPort": 22,
"orderDirectory": "/path/to/order/directory",
"invoiceDirectory": "/path/to/invoice/directory",
"notes": "My FTP notes"
},
"ediJob": {
"scheduleEdi": false,
"schedulingDate": null,
"time": null,
"isMonday": false,
"isTuesday": false,
"isWednesday": false,
"isThursday": false,
"isFriday": false,
"isSaturday": false,
"isSunday": false,
"sendToEmails": "email1@site.com, email2@site.com",
"notifyAllEdi": true,
"notifyInvoiceOnly": true,
"notifyErrorOnly": false
}
},
"interfaces": [
"9fc51738-e12a-4049-88dd-eb82b45da292",
"588b5c42-8634-4af7-bc9b-5e0116ed96b6",
"290c9e17-1434-5f47-a396-9d4875b3eaf7"
],
"accounts": [
{
"name": "History Account",
"accountNo": "GOBI-HIST-12",
"description": "This is my account description.",
"appSystemNo": "FIN-GOBI-HIST-12",
"paymentMethod": "EFT",
"accountStatus": "Active",
"contactInfo": "Some basic contact information note.",
"libraryCode": "My Library",
"libraryEdiCode": "MY-LIB-1",
"notes": "note",
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
]
}
],
"changelogs": [
{
"description": "This is a sample note.",
"timestamp": "2008-05-15T03:53:00-07:00"
}
],
"acqUnitIds": [
"1895e539-8dac-441e-b1f5-aab62b3fde60",
"47f504bd-0c1b-498e-a2ae-e2f0a0cea273"
],
"tags" : {
"tagList" : [
"important"
]
},
"metadata": {
"createdDate": "2019-06-09T00:00:00.000+0000",
"createdByUserId": "16d2457c-d137-11e8-a8d5-f2802f1b9fd1"
}
}
Item with a given ID not found
Media type: text/plain
Type: any
Example:
"organization not found"
Validation errors
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "errors.schema",
"description": "A set of errors",
"type": "object",
"properties": {
"errors": {
"description": "List of errors",
"id": "errors",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "error.schema",
"description": "An error",
"properties": {
"message": {
"type": "string",
"description": "Error message text"
},
"type": {
"type": "string",
"description": "Error message type"
},
"code": {
"type": "string",
"description": "Error message code"
},
"parameters": {
"description": "Error message parameters",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "parameters.schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
}
},
"required": [
"message"
]
}
},
"total_records": {
"description": "Total number of errors",
"type": "integer"
}
}
}Example:
{
"errors": [
{
"message": "may not be null",
"type": "1",
"code": "-1",
"parameters": [
{
"key": "moduleTo",
"value": "null"
}
]
}
]
}
Internal server error, e.g. due to misconfiguration
Media type: text/plain
Type: any
Example:
internal server error, contact administratorDelete organization item with given {organizationId}
DELETE /organizations-storage/organizations/{id}The UUID of Organization
Item deleted successfully
Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.
Media type: text/plain
Type: any
Example:
"unable to delete organization -- constraint violation"
Item with a given ID not found
Media type: text/plain
Type: any
Example:
"organization not found"
Validation errors
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "errors.schema",
"description": "A set of errors",
"type": "object",
"properties": {
"errors": {
"description": "List of errors",
"id": "errors",
"type": "array",
"items": {
"type": "object",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "error.schema",
"description": "An error",
"properties": {
"message": {
"type": "string",
"description": "Error message text"
},
"type": {
"type": "string",
"description": "Error message type"
},
"code": {
"type": "string",
"description": "Error message code"
},
"parameters": {
"description": "Error message parameters",
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "parameters.schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
}
},
"required": [
"message"
]
}
},
"total_records": {
"description": "Total number of errors",
"type": "integer"
}
}
}Example:
{
"errors": [
{
"message": "may not be null",
"type": "1",
"code": "-1",
"parameters": [
{
"key": "moduleTo",
"value": "null"
}
]
}
]
}
Internal server error, e.g. due to misconfiguration
Media type: text/plain
Type: any
Example:
Internal server error, contact administrator