generating electronic and printed invoices & reminders
 IGeneralInvoiceResult::GetFirstService method |
|||
|---|---|---|---|
|
Retrieves the first none-Tarmed service record
VARIANT_FALSE is returned if the end of the none-Tarmed service list is reached. |
 |
||
| C/C++ calling syntax |
|||
| HRESULT GetFirstService( | BSTR
BSTR BSTR double long DATE BSTR BSTR BSTR double double double double double YesNoType BSTR BSTR YesNoType long long VARIANT_BOOL |
*pbstrTariffType,
*pbstrCode, *pbstrReferenceCode, *pdQuantity, *plSessionNumber, *pdDate, *pbstrProviderEAN, *pbstrResponsibleEAN, *pbstrText, *pdUnit, *pdUnitFactor, *pdExternalScalingFactor, *pdAmount, *pdVatRate, *peIsObligatory, *pbstrRemark, *pbstrSectionCode, *peIgnoreValidate, *plServiceAttributes, *plID, *pbStatus); |
|
| Calling argument description |
|||
| [out] BSTR | *pbstrTariffType | The official tariff type as defined by Forum Datenaustausch | |
| [out] BSTR | *pbstrCode | The service code. | |
| [out] BSTR | *pbstrReferenceCode | The reference code if one must be supplied (otherwise bstrReferenceCode is ignored) | |
| [out] double | *pdQuantity | The floating point quantity.
Note that quantity changes the sign if a credit advice or a storno request is produced. |
|
| [out] long | *plSessionNumber | The session number - use a session value of 1 if no session concept is established for the used tariff | |
| [out] DATE | *pdDate | The date of the service's application | |
| [out] BSTR | *pbstrProviderEAN | EAN number of the service provider party.
Note if bstrProviderEAN is undefined and bstrResponsibleEAN is defined then bstrResponsibleEAN is copied into the bstrProviderEAN variable. If both variables are undefined the pseudo EAN "2099999999999" is set. |
|
| [out] BSTR | *pbstrResponsibleEAN | EAN number of the service responsible party.
Note if bstrResponsibleEAN is undefined and bstrProviderEAN is defined then bstrProviderEAN is copied into the bstrResponsibleEAN variable. If both variables are undefined the pseudo EAN "2099999999999" is set. |
|
| [out] BSTR | *pbstrText | The service name as defined by the used tariff | |
| [out] double | *pdUnit | Tax points of the service. | |
| [out] double | *pdUnitFactor | Tax point value of the service. | |
| [out] double | *pdExternalScalingFactor | The external scaling factor used to scale the tax point value e.g. to give a discount | |
| [out] double | *pdAmount | The amount in CHF of the service supplied in 2-digit precision.
Note that amount changes the sign if a credit advice or a storno request is produced. |
|
| [out] double | *pdVatRate | The VAT rate that should be applied to this service. | |
| [out] YesNoType | *peIsObligatory | Enumerator indicating whether the given service record is obligatory regarding the given law (UVG,KVG,...). If the enumerator is set to enObligationAutomatic then the status is set internally using some ad hoc rules. | |
| [out] BSTR | *pbstrRemark | An optional remark for the given service | |
| [out] BSTR | *pbstrSectionCode | An optional BfS section code where the service was applied as defined by Swiss Federal Statistical Office - this code is only given for eRoleType=enRoleHospital! | |
| [out] YesNoType | *peIgnoreValidate | Flag indicating whether the validation was ignored.
This flag might be useful in the following situation: the user wants to add the service even if the validation failed, perhaps he has a special agreement with the insurance or patient. |
|
| [out] long | *plServiceAttributes | lServiceAttributes is a 32-bit integer where each bit position defines a special information.
Currently only Bit 1 (0x000001) is defined. It applies to drug services only and means "Code 207" aka "Drug must not be substituted due to medical reasons". |
|
| [out] long | *plID | This is the internal ID of the service record.
This internal ID is used to append extra drug information to this service with the /IGeneralInvoiceRequest::SetXtraDrug method |
|
| [out, retval] VARIANT_BOOL | *pbStatus | Return status of the method. If pbStatus is VARIANT_FALSE the end of data is reached | |
| 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. | ||