Oracle Hospitality OPERA Cloud Web Self-Service Profile Config Service Web Service Reference. October 2017

Transcription

1 Oracle Hospitality OPERA Cloud Web Self-Service Profile Config Service Web Service Reference October 2017

2 Copyright 2017, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle. 2

3 Preface... 4 Contents Audience... 4 Customer Support... 4 Documentation... 4 Revision History ProfileConfigService... 5 ProfileConfigService Web Service... 6 Methods: ProfileConfigService... 7 Complex Types: ProfileConfigService... 9 Elements: ProfileConfigService... 17

4 Preface This document describes the ProfileConfig Service web service. The document describes methods, complex types, and elements. Audience This document is intended for developers who develop applications that interface with OPERA through OPERA Cloud Web Self-Service. Customer Support To contact Oracle Customer Support, access My Oracle Support at the following URL: When contacting Customer Support, please provide the following: Product version and program/module name Functional and technical description of the problem (include business impact) Detailed step-by-step instructions to re-create Exact error message received and any associated log files Screen shots of each step you take Documentation Oracle Hospitality product documentation is available on the Oracle Help Center at Revision History Date of Change October 2017 Initial publication 4

5 1 ProfileConfigService Sources Name ProfileConfigService The Profile Config Service web service provides the ability to configure the Master Data needed for Profiles. 5

6 ProfileConfigService Web Service Name ProfileConfigService The Profile Config Service web service provides the ability to configure the Master Data needed for Profiles. See Also Methods Elements Complex Types 6

7 Methods: ProfileConfigService Methods Name FetchPreferences Ping Fetches configured preferences. Sends a response to a ping. Method: FetchPreferences Fetches configured preferences. Input The input of this method is the document element FetchPreferencesRQ having the structure defined by the following table. Output Name Type Required? Occurs OperaContext OperaContextType No 0..1 Refer to Generic common types document. Criteria ConfigHotelPreferencesSearchType Yes Criteria used for searching preferences. The output of this method is the document element FetchPreferencesRS having the structure defined by the following table. Name Type Required? Occurs Yes Errors ErrorsType No 0..1 Refer to Generic common types document. Yes HotelPreferences ConfigHotelPreferencesType Yes Collection of preferences specified at the hotel level. Method: Ping Sends a response to a ping. Input The input of this method is the document element PingRQ having the structure defined by the following table. Output Name Type Required? Occurs OperaContext OperaContextType No 0..1 Refer to Generic common types document. OperaPingInput OperaPingRequestType No 0..1 Optional Input for Ping operation. The output of this method is the document element PingRS having the structure defined by the following table. Name Type Required? Occurs Yes 7

8 Name Type Required? Occurs Errors ErrorsType No 0..1 Refer to Generic common types document. Yes OperaVersion OperaVersionNumberType No 0..1 OPERA version number. 8

9 Complex Types: ProfileConfigService Complex Type: CodeListType Component Type Occurs Code CodeType 0..* Code Complex Type: ConfigBasePreferencesSearchType Base details common between both template and property level preference searches. Component Type Occurs PreferenceCodes CodeListType 0..1 Preference codes to be searched. PreferenceGroups CodeListType 0..1 Preference groups to be searched. Complex Type: ConfigBasePreferenceType Base details common between both template and property level preferences. Name Type Required? Code CodeType No Specifies the preference code. PreferenceGroup CodeType No Specifies the preference group to which the preference belongs. Housekeeping boolean No Flag to indicate if this preference should be available on the Task Sheet Workflow configuration. It is only applicable for preference types FLOOR and SPECIALS. OrderSequence double No Display order sequence. Component Type Occurs StringLength The description of the preference. Complex Type: ConfigHotelPreferencesSearchType Search criteria to fetch preferences at property level. 9

10 Component Type Occurs PreferenceCodes CodeListType 0..1 Preference codes to be searched. PreferenceGroups CodeListType 0..1 Preference groups to be searched. HotelCodes CodeListType 0..1 Specifies the hotel codes for which preferences have to be searched. CreatedBy UserIDsType 0..1 Specifies the created by User IDs list for which preferences have to be searched. Complex Type: ConfigHotelPreferencesType This type holds a collection of preferences at the property level. Component Type Occurs HotelPreference ConfigHotelPreferenceType 0..* Collection of preferences at the hotel level Complex Type: ConfigHotelPreferenceType This gives detailed information about a preference at the property level. Name Type Required? HotelCode CodeType No Specifies the hotel code for which the preference is specified. Code CodeType No Specifies the preference code. PreferenceGroup CodeType No Specifies the preference group the preference belongs to. Housekeeping boolean No Flag to indicate if this preference should be available on the Task Sheet Workflow configuration. It is only applicable for preference types FLOOR and SPECIALS. OrderSequence double No Display order sequence. Component Type Occurs StringLength The description of the preference. Complex Type: ErrorsType A collection of errors that occurred during the processing of a message. 10

11 Component Type Occurs Error ErrorType An error that occurred during the processing of a message. Complex Type: ErrorType Standard way to indicate that an error occurred during the processing of an OpenTravel message. If the message successfully processes, but there are business errors, those errors should be passed in the warning element. Name Type Required? Type CodeType Yes The Error element MUST contain the Type attribute that uses a recommended set of values to indicate the error type. The validating XSD can expect to accept values that it has NOT been explicitly coded for and process them by using Type ="Unknown". Refer to OpenTravel Code List Error Warning Type (EWT). ShortText string No An abbreviated version of the error in textual format. Code CodeType No If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to OpenTravel Code List Error Codes (ERR). DocURL string No If present, this URL refers to an online description of the error that occurred. Status string No If present, recommended values are those enumerated in the OTA_ErrorRS (Not Processed, Incomplete, Complete, and Unknown). However, the data type is designated as string data, recognizing that trading partners may identify additional status conditions not included in the enumeration. Tag string No If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. It is recommended that the Tag attribute use XPath notation to identify the location of a tag in the event that more than one tag of the same name is present in the document. Alternatively, the tag name alone can be used to identify missing data [Type=ReqFieldMissing]. 11

12 Name Type Required? RecordID string No If present, this attribute allows for batch processing and the identification of the record that failed amongst a group of records. This value may contain a concatenation of a unique failed transaction ID with specific record(s) associated with that transaction. NodeList string No An XPath expression that selects all the nodes whose data caused this error. Further, this expression should have an additional constraint which contains the data of the node. This will provide the offending data back to systems that cannot maintain the original message. Complex Type: FreeTextType Textual information to provide descriptions and/or additional information. Name Type Required? Language language No Language identification. Complex Type: OperaContextType Instructions common to all messages to set a certain context in the OPERA Database before serving the message request. Component Type Occurs UserLanguage language 0..1 The user's language code. CROCode CodeType 0..1 Central Reservation office (CRO) code. HotelCode CodeType 0..1 The hotel code. Language CodeType 0..1 The hotel's language code. RunningApplication StringLength Running Application. (Not supported) TerminalId StringLength Terminal ID from where this request originated. LogLevel LogLevelType 0..1 Log level to debug the code, such as FINE, FINER, and so on. ExternalSystem StringLength80 The external system code. Override boolean 0..1 OPERA context is derived internally by request but in case client wants to override the OPERA Context it can send true and then the OperaContext will override the above settings, such as HotelCode. 12

13 Component Type Occurs TargetExternalSystem StringLength This element carries ID of the External System that serves this request. It is needed only while making a call to external web services from OPERA UI through integration. UseLocal boolean 0..1 Determines whether local system should be used and ignore the external system instead. Complex Type: OperaWebServiceRQBaseType This Request base type is used as a base for an extension for OPERA Web Services Requests to provide uniform implementation. Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding web service message throughout the processing of the web service message. Component Type Occurs OperaContext OperaContextType 0..1 Refer to Generic common types document. Complex Type: OperaWebServiceRSBaseType This Response base type is used as an extension for OPERA Web Services Responses to provide a uniform implementation. 13

14 Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the Web service message. Component Type Occurs Errors ErrorsType 0..1 Refer to Generic common types document. Success SuccessType 0..1 Refer to Generic common types document. Warnings WarningsType 0..1 Refer to Generic common types document. Complex Type: SuccessType Returning an empty element of this type indicates the successful processing of an OpenTravel message. This is used in conjunction with the Warning Type to report any warnings or business errors. Complex Type: UserIDsType Component Type Occurs UserID int 0..* Complex Type: WarningsType A collection of warnings. 14

15 Component Type Occurs Warning WarningType 0..* Used in conjunction with the Success element to define a business error. Complex Type: WarningType Used when a message has been successfully processed to report any warnings or business errors that occurred. Name Type Required? Type CodeType Yes The Warning element MUST contain the Type attribute that uses a recommended set of values to indicate the warning type. The validating XSD can expect to accept values that it has NOT been explicitly coded for and process them by using Type ="Unknown". Refer to OpenTravel Code List Error Warning Type (EWT). ShortText string No An abbreviated version of the error in textual format. Code CodeType No If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to OpenTravel Code List Error Codes (ERR). DocURL string No If present, this URL refers to an online description of the error that occurred. Status string No If present, recommended values are those enumerated in the OTA_ErrorRS (Not Processed, Incomplete, Complete, and Unknown). However, the data type is designated as string data, recognizing that trading partners may identify additional status conditions not included in the enumeration. Tag string No If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. It is recommended that the Tag attribute use XPath notation to identify the location of a tag in the event that more than one tag of the same name is present in the document. Alternatively, the tag name alone can be used to identify missing data [Type=ReqFieldMissing]. RecordID string No If present, this attribute allows for batch processing and the identification of the record that failed amongst a group of records. This value may contain a concatenation of a unique failed transaction ID with specific record(s) associated with that transaction. 15

16 Name Type Required? RPH RPH_Type No Reference Place Holder used as an index for this warning. 16

17 Elements: ProfileConfigService Element: Code [type CodeListType] Element: CreatedBy [type ConfigHotelPreferencesSearchType] Specifies the created by User IDs list for which preferences have to be searched. Component Type Occurs UserID int 0..* Specifies the created by User IDs list for which preferences have to be searched. Element: Criteria [element FetchPreferencesRQ] Criteria used for searching preferences. Component Type Occurs PreferenceCodes CodeListType 0..1 Preference codes to be searched. PreferenceGroups CodeListType 0..1 Preference groups to be searched. HotelCodes CodeListType 0..1 Specifies the hotel codes for which preferences have to be searched. CreatedBy UserIDsType 0..1 Specifies the created by User IDs list for which preferences have to be searched. Element: CROCode [type OperaContextType] Central Reservation office (CRO) code. Element: [type ConfigBasePreferenceType] The description of the preference. Element: Error [type ErrorsType] An error that occurred during the processing of a message. 17

18 Name Type Required? Type CodeType Yes The Error element MUST contain the Type attribute that uses a recommended set of values to indicate the error type. The validating XSD can expect to accept values that it has NOT been explicitly coded for and process them by using Type ="Unknown". Refer to OpenTravel Code List Error Warning Type (EWT). ShortText string No An abbreviated version of the error in textual format. Code CodeType No If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to OpenTravel Code List Error Codes (ERR). DocURL string No If present, this URL refers to an online description of the error that occurred. Status string No If present, recommended values are those enumerated in the OTA_ErrorRS (Not Processed, Incomplete, Complete, and Unknown). However, the data type is designated as string data, recognizing that trading partners may identify additional status conditions not included in the enumeration. Tag string No If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. It is recommended that the Tag attribute use XPath notation to identify the location of a tag in the event that more than one tag of the same name is present in the document. Alternatively, the tag name alone can be used to identify missing data [Type=ReqFieldMissing]. RecordID string No If present, this attribute allows for batch processing and the identification of the record that failed amongst a group of records. This value may contain a concatenation of a unique failed transaction ID with specific record(s) associated with that transaction. NodeList string No An XPath expression that selects all the nodes whose data caused this error. Further, this expression should have an additional constraint which contains the data of the node. This will provide the offending data back to systems that cannot maintain the original message. Element: Errors [type OperaWebServiceRSBaseType] Refer to Generic common types document. 18

19 Component Type Occurs Error ErrorType An error that occurred during the processing of a message. Element: ExternalSystem [type OperaContextType] The external system code. Element: FetchPreferencesRQ Request object for fetching preferences at the property level. Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the Web service message. Component Type Occurs OperaContext OperaContextType 0..1 Refer to Generic common types document. Criteria ConfigHotelPreferencesSearchType Criteria used for searching preferences. Element: FetchPreferencesRS Response object for fetching preferences at the property level. 19

20 Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the Web service message. Component Type Occurs Errors ErrorsType 0..1 Refer to Generic common types document. Success SuccessType 0..1 Refer to Generic common types document. Warnings WarningsType 0..1 Refer to Generic common types document. HotelPreferences ConfigHotelPreferencesType Collection of preferences specified at the hotel level. Element: HotelCode [type OperaContextType] The hotel code. Element: HotelCodes [type ConfigHotelPreferencesSearchType] Specifies the property codes for which preferences have to be searched. Component Type Occurs Code CodeType 0..* Specifies the hotel codes for which preferences have to be searched. Element: HotelPreference [type ConfigHotelPreferencesType] 20

21 Name Type Required? HotelCode CodeType No Specifies the Hotel code for which the preference is specified. Code CodeType No Specifies the preference code. PreferenceGroup CodeType No Specifies the preference group the preference belongs to. Housekeeping boolean No Flag to indicate if this preference should be available on the Task Sheet Workflow configuration. It is only applicable for preference types FLOOR and SPECIALS. OrderSequence double No Display order sequence. Component Type Occurs StringLength The description of the preference. Element: HotelPreferences [element FetchPreferencesRS] Collection of preferences specified at the property level. Component Type Occurs HotelPreference ConfigHotelPreferenceType 0..* Collection of preferences specified at the Hotel level Element: Language [type OperaContextType] The hotel's language code. Element: LogLevel [type OperaContextType] Log level to debug the code, such as FINE, FINER, and so on. Enumeration Value SEVERE WARNING INFO CONFIG FINE FINER 21

22 Value FINEST ERROR MESSAGE DEBUG TRACE Element: OperaContext [type OperaWebServiceRQBaseType] Refer to Generic common types document. Component Type Occurs UserLanguage language 0..1 The user's language code. CROCode CodeType 0..1 Central Reservation office (CRO) code. HotelCode CodeType 0..1 The hotel code. Language CodeType 0..1 The hotel's language code. RunningApplication StringLength Running Application. (Not supported) TerminalId StringLength Terminal ID from where this request originated. LogLevel LogLevelType 0..1 Log level to debug the code, such as FINE, FINER, and so on. ExternalSystem StringLength80 The external system code. Override boolean 0..1 OPERA context is derived internally by request but in case client wants to override the OPERA Context it can send true and then the OperaContext will override the above settings, such as HotelCode. TargetExternalSystem StringLength This element carries ID of the External System that serves this request. It is needed only while making a call to external web services from OPERA UI through integration. UseLocal boolean 0..1 Determines whether local system should be used and ignore the external system instead. Element: OperaPingInput [element PingRQ] Optional input for Ping operation. Element: OperaVersion [element PingRS] OPERA version number. Element: Override [type OperaContextType] 22

23 OPERA context is derived internally by request. In case the client wants to override the OPERA Context, the client can send true and then the OperaContext will override the above settings, such as HotelCode. Element: PingRQ Request for Ping operation. Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the Web service message. Component Type Occurs OperaContext OperaContextType 0..1 Refer to Generic common types document. OperaPingInput OperaPingRequestType 0..1 Optional input for Ping operation. Element: PingRS Response for Ping operation. Name Type Required? EchoToken StringLength128 No A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value. 23

24 Name Type Required? TimeStamp datetime No Indicates the creation date and time of the message in UTC using the following format specified by ISO 8601; YYYY-MM-DDThh:mm:ssZ with time values using the 24 hour clock (for example, 20 November 2003, 1:59:38 pm UTC becomes T13:59:38Z). Version StringLength40 No For all OPERA versioned messages, the version of the message is indicated by an OPERA Version value. CorrelationID StringLength80 No Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the Web service message. Component Type Occurs Errors ErrorsType 0..1 Refer to Generic common types document. Success SuccessType 0..1 Refer to Generic common types document. Warnings WarningsType 0..1 Refer to Generic common types document. OperaVersion OperaVersionNumberType 0..1 OPERA version number. Element: PreferenceCodes [type ConfigBasePreferencesSearchType] Preference codes to be searched. Component Type Occurs Code CodeType 0..* Preference codes to be searched. Element: PreferenceGroups [type ConfigBasePreferencesSearchType] Preference groups to be searched. Component Type Occurs Code CodeType 0..* Preference groups to be searched. 24

25 Element: RunningApplication [type OperaContextType] Running Application. (Not supported) Element: Success [type OperaWebServiceRSBaseType] Refer to Generic common types document. Element: TargetExternalSystem [type OperaContextType] This element carries ID of the External System that serves this request. It is needed only while making a call to external web services from OPERA UI through integration. Element: TerminalId [type OperaContextType] Terminal ID from where this request originated. Element: UseLocal [type OperaContextType] Determines if the local system should be used and the external system ignored. Element: UserID [type UserIDsType] Element: UserLanguage [type OperaContextType] User's language code. Element: Warning [type WarningsType] Used in conjunction with the Success element to define a business error. Name Type Required? Type CodeType Yes The Warning element MUST contain the Type attribute that uses a recommended set of values to indicate the warning type. The validating XSD can expect to accept values that it has NOT been explicitly coded for and process them by using Type ="Unknown". Refer to OpenTravel Code List Error Warning Type (EWT). ShortText string No An abbreviated version of the error in textual format. Code CodeType No If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to OpenTravel Code List Error Codes (ERR). 25

26 Name Type Required? DocURL string No If present, this URL refers to an online description of the error that occurred. Status string No If present, recommended values are those enumerated in the OTA_ErrorRS (Not Processed, Incomplete, Complete, and Unknown). However, the data type is designated as string data, recognizing that trading partners may identify additional status conditions not included in the enumeration. Tag string No If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. It is recommended that the Tag attribute use XPath notation to identify the location of a tag in the event that more than one tag of the same name is present in the document. Alternatively, the tag name alone can be used to identify missing data [Type=ReqFieldMissing]. RecordID string No If present, this attribute allows for batch processing and the identification of the record that failed amongst a group of records. This value may contain a concatenation of a unique failed transaction ID with specific record(s) associated with that transaction. RPH RPH_Type No Reference Place Holder used as an index for this warning. Element: Warnings [type OperaWebServiceRSBaseType] Refer to Generic common types document. Component Type Occurs Warning WarningType 0..* Used in conjunction with the Success element to define a business error. 26