The acfValidator provides methods to browse, search,
validate & group records of the ACF and/or LKAAT tariff
validate & group records of the ACF and/or LKAAT tariff
API browser of acfValidator100 COM module
 IValidate005::AddService method |
 |
||
|---|---|---|---|
| Adds a new ACF service to the list of services which will be validated against all previously added services of the same session. If the code supplied passes all validations a VARIANT_TRUE value is returned. If the code was not accepted VARIANT_FALSE is returned and the variable plStatus contains the error code. | |||
| |||
| Restful webservice calling syntax |
|||
| [POST] | /baseURL/IValidate005/AddService | ||
| [JSON input data] | pIValidate005: bstrCode: bstrReferenceCode: dQuantity: lSessionNumber: dDate: eSide: dTP: dTPValue: dExternalFactor: eIgnoreValidate: lHook: |
longValue, //interface address "utf8StringValue", "utf8StringValue", doubleValue, longValue, variantDateValue | "stringISODateValue", longValue, doubleValue, doubleValue, doubleValue, longValue, longValue |
|
| [JSON result data] | pbStatus: | booleanValue |
|
| [HTTP result status] | 200 | Return status 200 signals a successful method call | |
| 204 | Return status 204 (noContent) signals that the end of an iteration is reached | ||
| >= 400 | Return status >= 400 signals an unsuccessful function call. The returned JSON{errorCode: code, errorText:"text"} supplies the error message the same as GetAbortInfo() would do. | ||
| |||
| C/C++ calling syntax |
|||
| HRESULT AddService( | BSTR
BSTR double long DATE SideType double double double YesNoType long VARIANT_BOOL |
bstrCode,
bstrReferenceCode, dQuantity, lSessionNumber, dDate, eSide, dTP, dTPValue, dExternalFactor, eIgnoreValidate, lHook, *pbStatus); |
|
| [C/C++ return value] | S_OK | This value is returned if the function call was successful. | |
| S_FALSE | This value is returned if the end of an iteration is reached | ||
| E_name | This value is returned if the function call was unsuccessful and an error exception was generated. Note that if you are using SmartPointers an exception is thrown under these conditions. | ||
| |||
| Calling argument description |
|||
| [in] BSTR | bstrCode | Code of the service | |
| [in] BSTR | bstrReferenceCode | The reference code of the service.
Since the ACF tariff does not have any reference codes, this variable can be used as an ICD-10 container. In other words, if a code is used here, it will be interpreted as an ICD-10 code. When invoicing, you will not need to input the ICD10 code by other means. |
|
| [in] double | dQuantity | Quantity of the service | |
| [in] long | lSessionNumber | The session number or patient contact ID.
Please note that the 'SessionNumber" plays a central role in the ACF/LKAAT tariffs, in that this ID serves as a grouping and connection object to combine services (even across days). Furthermore, the same ID is also used in the TMA tariff to bundle the services and link it to the corresponding global data (ICD and patient data). |
|
| [in] DATE | dDate | Date of the service to ensure that the validity date range is obeyed | |
| [in] SideType | eSide | The side for which the service is applied or enSideNone if there is noSideDependeny | |
| [in] double | dTP | Tax point of the service. If enIgnoreValidate=enNo and dTP=0 then the tax point is auto-expanded to the correct TP by the validator. If the upper bound of a variable TP service is undefined than TP is set 0 in the auto-expansion! |
|
| [in] double | dTPValue | Tax point value of the service Please note that there is no internal database for the various tax point values. Therefore, there is no auto-expansion of the TPV possible. |
|
| [in] double | dExternalFactor | The external factor is used and defined by OAAT as modulation factor within its cost neutrality project. | |
| [in] YesNoType | eIgnoreValidate | Flag indicating whether the validation should be ignored or not. To turn off the validation might be useful in the situation when a service should be added even if the validation failed due to a special agreement with the insurance or patient. |
|
| [in] long | lHook | The external hook, that was provided in the AddService call. The lHook ID primarily serves to identify this service when the services are read back. | |
| [out,retval] VARIANT_BOOL | *pbStatus | The principal validation status
|
|
|
|||