Create Serial Holdings Record

POST /api/.../serialholdingsrecords/

Create serial holdings record.

Request Information

Parameters
Name Type Required Description
dto DtoSerialHoldingsRecordCreateInfo Yes Define this parameter in the request body.
DtoSerialHoldingsRecordCreateInfo
Property Type Nullable Description
BibliographicRecordID Int No Bibliographic record control ID. This field should not be NULL. Variable control field 004. Foreign key reference to BibliographicRecords(BibliographicRecordID).
DestinationOrgID Int No Destination organization control ID. Foreign key reference to Organizations(OrganizationID).
DisplayInPac Boolean No Indicates whether or not the linked issues/parts will be displayed in PAC.
OrderType Int No Order type of serial holdings record. It can be either 7 (standing order) or 8 (subscription), but can not be NULL. Foreign key reference to OrderTypes(OrderTypeID).
DestinationCollectionID Int Yes Destination collection control ID. Foreign key reference to Collections(CollectionID).
CompletenessCodeH TinyInt Yes Record's completeness status code. Foreign key reference to MfhdCompleteness(CodeID).
CopyNumber Int Yes Copy number.
CallNoPrefix String Yes Call number prefix.
ClassificationNo String Yes Call number classification part.
CutterNo String Yes Call number cutter part.
Designated Boolean Yes Indicates whether the library receives a serial subscription because of a staff/faculty member's professional affiliation with an organization.
IntentToCancel DateTime Yes Subscription intent to cancel date.
ListServeAddr String Yes Electronic access server address. Is usually a URL.
MaterialType Int Yes Material type. Foreign key reference to MaterialTypes(MaterialTypeID).
NotePub String Yes public note
NoteNonPub String Yes Non public notes.
NoteStaff String Yes Staff notes or warnings.
OrganizationID Int Yes Organization ID where holdings record gets ordered. Foreign key reference to Organizations(OrganizationID).
MemberOrgName String Yes Name of the membership organization from which the library receives a serial subscription because of a staff/faculty member's professional affiliation with that organization.
MemberName String Yes Member name of a membership. The library receives a serial subscription because of a staff/faculty member's professional affiliation with an organization.
POLineItemSegmentID Int Yes Purchase order line segment ID.
PlanDescr String Yes Holdings record's purchase order plan description.
PlanName String Yes Holdings record's purchase order plan name.
RetDesignGenH Int Yes Retention designator ID on the serial holdings record. If multiple SHRs exist per location/bibliographic record, this ID field is shared by all the SHRs.
RetDesignSpec00813 String Yes Retention period indicator, latest (1) or previous (0), on serial holdings record. If multiple SHRs exist per location/bibliographic record, this indicator field is shared by all the SHRs.
RetDesignSpec00814 Int Yes Retention period on serial holdings record. If multiple SHRs exist per location/bibliographic record, this period field is shared by all the SHRs.
RetDesignSpec00815 String Yes Retention period term (y - year, m - month, w - week, i - issues, e - edition, etc.) on serial holdings record. If multiple SHRs exist per location/bibliographic record, this period term field is shared by all the SHRs.
StartDate DateTime Yes Subscription start date.
StartNumber String Yes Subscription start number.
SubscrExpDate DateTime Yes Subscription expiry date.
SupplierID Int Yes For a Standing Order SHR, this is its linked supplier control ID. For a subscription SHR, this is its linked subscription's supplier control ID. Foreign key reference to Suppliers(SupplierID).
SubsID Int Yes Linked subscription record control ID. Foreign key reference to Subscriptions(SubsID).
SubscrStatusH Int Yes Holdings record subscription status. Foreign key reference to CopySubsStatuses(StatusID).
ShelvingSchemeID Int Yes Shelving scheme ID. Foreign key reference to ShelvingSchemes(ShelvingSchemeID).
VendorTitleNumber String Yes Vendor title number.
SerialClaims List Yes List of DtoSerialCopyClaim.

PropertyType
CategoryIdInt
OrderNumberInt
DaysToWaitInt
DescriptionString
Example
application/json, text/json 
  {
    "BibRecordID":22,
    "POLineItemSegmentID":363714,
    "CompletenessCodeH":2,
    "CopyNumber":1,
    "DestinationCollectionID":1,
    "DestinationOrgID":3,
    "IntentToCancel":null,
    "ListServeAddr":null,
    "NoteNonPub":"Note Non Pub added via Swagger",
    "NotePub":null,
    "NoteStaff":null,
    "OrganizationID":3,
    "OrderType":8,
    "PlanDescr":null,
    "PlanName":null,
    "RetDesignCopy":null,
    "RetDesignGenH":null,
    "RetDesignSpec00813":null,
    "RetDesignSpec00814":0,
    "RetDesignSpec00815":null,
    "StartDate":"2014-06-19T11:35:37-04:00",
    "StartNumber":null,
    "SubscrExpDate":"2015-06-18T11:35:37-04:00",
    "SupplierID":62,
    "SubsID":71,
    "SubscrStatusH":4,
    "CallNoPrefix":"Prefix",
    "ClassificationNo":null,
    "CutterNo":null,
    "ShelvingSchemeID":2,
    "Designated":false,
    "MemberOrgName":null,
    "MemberName":null,
    "MaterialType":0,
    "VendorTitleNumber":null,
    "DisplayInPac":false,
    "SerialClaims": [{
        "CategoryId": 1,
        "OrderNumber": 1,
        "DaysToWait": 3,
        "Description": ""
      }, {
        "CategoryId": 1,
        "OrderNumber": 2,
        "DaysToWait": 1,
        "Description": ""
      }
    ]
}

Response Information

Newly created copy ID is returned upon success.

Example
application/json, text/json 
536

HTTP Response Codes

Code Description
200 OK. Success
400 FAILURE. Duplicates exist.

Required Permissions

Permission IDs found here.

    CR_AccessSerials_Allow (),
    CR_SerialCopyRecords_Create (based on destination organization)