API browser of generalInvoiceRequest450 COM module


/images/arrow_right.png IGeneralInvoiceRequest::Finalize method
Finalizes and validates all data set so far in the IGeneralInvoiceRequest interface. This method is the counterpart to the Initialize method.
 
This method should be called after all data have been set in the IGeneralInvoiceRequest interface since higher-level validation rules can only be called at the end of input phase. Therefore, be prepared to get validation errors at that point.
 
Please note, that apart from validation tasks there are automatic assignments of addresses as well, should such an address be missing.
Eventually the following addresses are cloned in the given sequence:
  • if the guarantor address is missing than it is cloned from the patient's address
  • if the debitor address is missing than dependent on the tiers mode it is clone from the guarantor's address (TG) or the insurance's address (TP)
  • if the ESR creditor address is missing than it is cloned from the biller's address
space
 
/images/arrow_right.png C/C++ calling syntax
HRESULT Finalize( double
VARIANT_BOOL
*pdRoundDifference,
*pbStatus);
 
/images/arrow_right.png Calling argument description
[out] double *pdRoundDifference Supplies the rounding difference as defined by
«dRoundDiff = amount(hU) - amount(2d)»

where the amount(2d) is 2-digit precision total amount of all services and
amount(hU) is that total amount rounded half up ("Kaufmännisches Runden")
[out, retval] VARIANT_BOOL *pbStatus Return status of the method. If pbStatus is VARIANT_FALSE then an error occurred and GetAbortInfo should be called to retrieve the error string.
 
/images/arrow_right.png C/C++ return value
S_OK This value is returned if the function call was successful or if the return value of a boolean method signalling a true value. In this case the VARIANT_BOOL is set to VARIANT_TRUE.
S_FALSE This is the return value of a boolean method signalling a false return value. In this case the VARIANT_BOOL is set to VARIANT_FALSE.
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.