Sumex1.net/labValidator/C++ API: IValidate::AddService method

API browser of labValidator100 COM module

IValidate::AddService method
Adds a new service that will be validated against all the previously entered services of the same session. If the code passed all the 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. As of 01.01.2021 the service space is additionally filtered by the currently defined provider type, thus restricting the set of services by availability and accessibility. Please note, that the services 4707.00 ff. of tariff 317 have a different rules space dependent on the inputted role/place. If the role and place are not set or is unknown, there is a patch available to define the rule space - "how to set a special provider type". Furthermore, some features like the expandChapter4Services has no explicit interface representation and these features are defined as well by the setParameter mechanism. Please consult referenced documentation for the syntax and target features, that can be addressed.

Restful webservice calling syntax
[POST]	/baseURL/IValidate/AddService
[JSON input data]	pIValidate: bstrCode: dQuantity: dTP: dTPValue: dDate: eIgnoreValidate: lHook:	longValue, //interface address "utf8StringValue", doubleValue, doubleValue, doubleValue, variantDateValue \| "stringISODateValue", longValue, longValue
[JSON result data]	plStatus: pbStatus:	longValue, 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(	long BSTR double double double DATE YesNoType long VARIANT_BOOL	plStatus, bstrCode, dQuantity, dTP, dTPValue, dDate, 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
[out] long	*plStatus	The principal validation status =0 is returned for success >0 indicates that a validation rule was not fulfilled. Use the GetAbortInfo to get an error description string. <0 indicates that the service was not added (cf. the AbortValidateType enumeration for possible codes).
[in] BSTR	bstrCode	Code of the service. Pseudo codes of the form *setParameter(cmd=value)* can be used to alter the default behavior. It is especially important that a special provider type can be defined by this patch - cf. (how to set a provider type).
[in] double	dQuantity	Quantity value.
[in] double	dTP	Tax point of the service. A zero value will be substituted by the tax point form the catalog.
[in] double	dTPValue	Tax point value of the service. A zero value will be substituted by the tax point value form the catalog.
[in] DATE	dDate	Date of the service.
[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	External hook. The software house can provide for example the record ID of the service to identify the service later on.
[out,retval] VARIANT_BOOL	*pbStatus	Return status. VARIANT_TRUE means S_OK, VARIANT_FALSE means S_FALSE (e.g. in an iterator) or an error (E_name). In the later case check for possible errors with the GetAbortInfo method.