基于NCIP协议的自助服务系统应用技术要则

（3）失败响应
①失败原因
【CheckOutItemResponse->Problem->ProcessingError->ProcessingErrorType->Value】
②失败的相关字段内容
【CheckOutItemResponse->Problem->ProcessingError->ProcessingErrorElement->ProcessingErrorElement->ProcessingErrorValue】
 
5.3.4【续借】
请求、成功响应、失败响应各节点位置均与CheckOutItem（参见本章5.3.3）一致，仅第一节点不同。
（1）请求
读者证号
【RenewItem->UniqueUserId->UserIdentifierValue】
 
（2）成功响应
读者证号
【RenewItemResponse->UniqueUserId->UserIdentifierValue】
 
（3）失败响应
失败原因
【RenewItemResponse->Problem->ProcessingError->ProcessingErrorType->Value】
 
5.3.5【读者借阅文献查询】
（1）请求
文献条码号
【LookupItem->UniqueItemId->ItemIdentifierValue】
 
（2）成功响应
①文献条码号
【LookupItemResponse->UniqueItemId->ItemIdentifierValue】
②最迟取书日期（此节点当且仅当⑦流通状态为待取书：Value=Available For Pickup时存在）
【LookupItemResponse->HoldPickupDate】
格式示例：2023-05-11T16:38:40Z
③读者证号
a)文献借出读者证号：
【LookupItemResponse->ItemTransaction->CurrentBorrower->UniqueUserId->UserIdentifierValue】
b)文献预借读者证号：
【LookupItemResponse->ItemTransaction->CurrentRequester->UniqueUserId->UserIdentifierValue】
④文献题名
【LookupItemResponse->ItemOptionalFields->BibliographicDescription->Title】
⑤位置信息
a)位置类型：
【LookupItemResponse->ItemOptionalFields->Location->LocationType->Value】
馆藏地点：Value=Permanent Location
服务地点：Value=Current Location
动态架位号：Value=Temporary Location
b)位置代码：
【LookupItemResponse->ItemOptionalFields->Location->LocationName->LocationNameInstance->LocationNameValue】
⑥索书号
【LookupItemResponse->ItemOptionalFields->ItemDescription->CallNumber】
⑦流通状态
【LookupItemResponse->ItemOptionalFields->CirculationStatus->Value】
已借出：Value=On Loan
待取书：Value=Available For Pickup
在馆：Available On Shelf
 
（3）失败响应
①失败原因
【LookupItemResponse->Problem->ProcessingError->ProcessingErrorType->Value】
②失败的相关字段内容
【LookupItemResponse->Problem->ProcessingError->ProcessingErrorElement->ProcessingErrorElement->ProcessingErrorValue】
 
5.3.6【读者认证及信息查询】
（1）请求
①读者证号、自助服务密码
a)类型：
【LookupUser->AuthenticationInput->AuthenticationInputType->Value】
读者证号：Value=Barcode Id
自助服务密码：Value=Password
b)值：
【LookupUser->AuthenticationInput->AuthenticationInputData】
②身份证号
a)证件号码类型：
【LookupUser->VisibleUserId->VisibleUserIdentifierType->Value】
身份证号：Value=Institution Id Number
b)证件号码：
【LookupUser->VisibleUserId->VisibleUserIdentifier】
 
（2）成功响应
①读者证号
【LookupUserResponse->UniqueUserId->UserIdentifierValue】
②财经信息
a)财经类型：
【LookupUserResponse->UserFiscalAccount->AccountDetails->FiscalTransactionInformation->FiscalTransactionType->Value】
押金：Value=Card Replacement Charge
欠款：Value=Fine
预付款：Value=Service Charge
b)数额：
【LookupUserResponse->UserFiscalAccount->AccountBalance->MonetaryValue】
③借书列表与请求列表
a)借书列表：
文献条码号：
【LookupUserResponse->UserTransaction->LoanedItem->UniqueItemId->ItemIdentifierValue】
还书日期：
【LookupUserResponse->UserTransaction->LoanedItem->DateDue】
b)请求列表：
文献条码号：
【LookupUserResponse->UserTransaction->RequestedItem->UniqueItemId->ItemIdentifierValue】
请求状态：
【LookupUserResponse->UserTransaction->RequestedItem->RequestStatusType->Value】
待取书：Value=Available For Pickup
最迟取书日期：
【LookupUserResponse->UserTransaction->RequestedItem->PickupExpiryDate】
格式示例：2023-05-11T16:34:41Z
④已借书总数
a)已借出文献状态：
【LookupUserResponse->LoanedItemsCount->CirculationStatus->Value】
已借出：Value=On Loan
b)已借出文献总数：
【LookupUserResponse->LoanedItemsCount->LoanedItemCountValue】
⑤请求总数
a)请求状态：
【LookupUserResponse->RequestedItemsCount->CirculationStatus->Value】
预约待取：Value=Available For Pickup
b)预约待取总数：
【LookupUserResponse->RequestedItemsCount->RequestedItemCountValue】
⑥读者姓名
【LookupUserResponse->UserOptionalFields->NameInformation->PersonalNameInformation->UnstructuredPersonalUserName】
⑦读者证类型
【LookupUserResponse->UserOptionalFields->UserPrivilege->UserPrivilegeDescription】
 
（3）失败响应
①失败原因
【LookupUserResponse->Problem->ProcessingError->ProcessingErrorType->Value】
②失败的相关字段内容
【LookupUserResponse->Problem->ProcessingError->ProcessingErrorElement->ProcessingErrorElement->ProcessingErrorValue】
 
5.3.7【办证】
（1）请求
①读者证号
【CreateUser->UniqueUserId->UserIdentifierValue】
②证件信息
a)证件号码类型：
【CreateUser->VisibleUserId->VisibleUserIdentifierType->Value】
身份证号：Value=Institution Id Number
b)证件号码：
【CreateUser->VisibleUserId->VisibleUserIdentifier】
③姓名
【CreateUser->NameInformation->PersonalNameInformation->UnstructuredPersonalUserName】
④地址信息
a)格式：
【CreateUser->UserAddressInformation->PhysicalAddress->UnstructuredAddress->UnstructuredAddressType->Value】
使用回车、换行符分割：Value=Carriage-Return, Newline-Delimited Text
b)地址内容：
【CreateUser->UserAddressInformation->PhysicalAddress->UnstructuredAddress->UnstructuredAddressData】
⑤办理读者证证类型及需要开通的服务列表
【CreateUser->UserPrivilege->UserPrivilegeDescription】
格式示例：2[11,13]
（注：2代表办理读者证证类型，11和13代表开通服务代码）
 
（2）成功响应
读者证号
【CreateUserResponse->UniqueUserId->UserIdentifierValue】
 
（3）失败响应
①失败原因
【CreateUserResponse->Problem->ProcessingError->ProcessingErrorType->Value】
②失败的相关字段内容
【CreateUserResponse->Problem->ProcessingError->ProcessingErrorElement->ProcessingErrorElement->ProcessingErrorValue】
 
5.3.8【读者财经服务】
（1）请求
①读者证号
【CreateUserFiscalTransaction->UniqueUserId->UserIdentifierValue】
②财经服务类型
a)执行动作类型：
【CreateUserFiscalTransaction->FiscalTransactionInformation->FiscalActionType->Value】
支付：Value=Payment
b)财经类型：
【CreateUserFiscalTransaction->FiscalTransactionInformation->FiscalTransactionType->Value】
押金：Value=Card Replacement Charge
欠款：Value=Fine
预付款：Value=Service Charge
c)数额：
【CreateUserFiscalTransaction->FiscalTransactionInformation->Amount->MonetaryValue】
d)支付方式：
【CreateUserFiscalTransaction->FiscalTransactionInformation->PaymentMethodType->Value】
现金：Value=Cash
微信支付：Value=Wxpay：唯一交易号
支付宝支付：Value=Alipay：唯一交易号
格式示例：Alipay：123-3435
（注：123-3435必须保证唯一，用来区分重复的财经服务请求）
③发送请求时间
【CreateUserFiscalTransaction->MandatedAction->DateEventOccurred】
格式示例：2023-06-10T15:32:19Z
（注：如果上条字段没有唯一交易号，便以发送请求时间为准来区分重复的财经服务请求）
 
（2）成功响应
①读者证号
【CreateUserFiscalTransactionResponse->UniqueUserId->UserIdentifierValue】
②读者财经账户记录号或者财经事务记录号
【CreateUserFiscalTransactionResponse->FiscalTransactionReferenceId->FiscalTransactionIdentifierValue】
 
（3）失败响应
①失败原因
【CreateUserFiscalTransactionResponse->Problem->ProcessingError->ProcessingErrorType->Value】
②失败的相关字段内容
【CreateUserFiscalTransactionResponse->Problem->ProcessingError->ProcessingErrorElement->ProcessingErrorElement->ProcessingErrorValue】

版权声明： 本站文章已获出版方或者作者方授权，如需转载，请保留网站地址和作者信息。部分文章来源于网络，著作权归于原作者，仅供学习交流使用。

很赞哦！ ( )