The acfValidator provides methods to browse, search,
validate & group records of the ACF and/or LKAAT tariff
API browser of acfValidator100 COM module


/images/arrow_right.png IValidateTMA::GetFirstACFBase method space
Retrieves the first ACFBase element from the list of ACFBase elements.
 
VARIANT_FALSE is returned if the end of the service list is reached.
space
/images/arrow_right.png Restful webservice calling syntax
[POST] /baseURL/IValidateTMA/GetFirstACFBase
[JSON input data] pIValidateTMA: longValue,    //interface address
[JSON result data] plSessionNumber:
pbstrICDCode:
pbstrChapterCode:
pePatientSex:
pdPatientBirthdate:
peLaw:
plGroupingTries:
peGroupingSuccess:
pbstrACFCode:
pbStatus:		 longValue,
"utf8StringValue",
"utf8StringValue",
longValue,
"stringISODateValue",
longValue,
longValue,
longValue,
"utf8StringValue",
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.
space
/images/arrow_right.png C/C++ calling syntax
HRESULT GetFirstACFBase( long
BSTR
BSTR
SexType
DATE
LawType
long
YesNoType
BSTR
VARIANT_BOOL 		*plSessionNumber,
*pbstrICDCode,
*pbstrChapterCode,
*pePatientSex,
*pdPatientBirthdate,
*peLaw,
*plGroupingTries,
*peGroupingSuccess,
*pbstrACFCode,
*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.
space
/images/arrow_right.png Calling argument description
[out] long *plSessionNumber 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).
[out] BSTR *pbstrICDCode The ICD10 code that is used in the grouping process.
[out] BSTR *pbstrChapterCode The capitulum code e.g. 'Cap08', extracted from the chapter affiliation of the ICD10 code
[out] SexType *pePatientSex The patient's medical sex, either 'enMale' or 'enFemale'
[out] DATE *pdPatientBirthdate The patient's birthdate, that is primarely used for calculating the patient's age.
[out] LawType *peLaw The law under which the case is running.

Please note, that currently there is no law dependency, but this might change in future. So whatever you currently input is not used at the moment.
[out] long *plGroupingTries Initially set to 0, the lGroupingTries is incremented by 1 each time of grouping this ACFBase element.
Note that the variable is incremented if the grouping is successful or not.
[out] YesNoType *peGroupingSuccess A YesNoType that is enYes for a successful grouping with a resulting ACF code, otherwise enNo results.
[out] BSTR *pbstrACFCode If eGroupingSuccess=enYes than bstrACFCode holds the resulting ACF code, empty otherwise.
[out,retval] VARIANT_BOOL *pbStatus Return status of the method. If pbStatus is VARIANT_FALSE the end of data is reached
space