mdInvoiceRequest  -  the modules for generating
XML and/or paper based invoices of physicians
mdInvoiceRequest
    API DocBrowser   ·  Revision history
    Download area
    FAQ
 
home
system
integrators
search the
site
 

validator
modules
invoice
modules
credit
modules
miscellaneous
modules
tools

  Design by TMR AG
  © by sumex1.net
 
IMDInvoiceRequestManager::CreateMDInvoiceRequest property

 Description  V4.00/ 6 Dec 2004 
Creates the MDInvoiceRequest instance.

New feature: by supplying a well-formed and valid V4.0 XML content or XML file path in the variable bstrSoftwarePackage the IMDInvoiceRequest interface is generated and populated with these XML data. The variable lSoftwareVersion is used to control the timestamp, resendID, and annulment status (cf. below). Subsequently one can e.g. print the invoice or re-generate the XML content.
Of course, the IMDInvoiceRequest::Initalize method should NOT be called under these circumstances.

 C/C++ syntax
[get]  HRESULT  CreateMDInvoiceRequest( LanguageType   eLanguage,
BSTR   bstrSoftwarePackage,
long   lSoftwareVersion,
long   lSoftwareID,
IMDInvoiceRequest   **ppIMDInvoiceRequest);

 Parameter description
[in]   LanguageType   eLanguage   Language type.
[in]   BSTR   bstrSoftwarePackage   Name of the main software using this DLL.

New feature: if the variable holds either

  • a XML content coded in UNICODE
  • an accessible full path to an XML file
the supplied XML data is loaded into the IMDInvoiceRequest interface. See description of lSoftwareVersion as well.
BEWARE: the XML content must be well-formed, valid and of version V4.0 otherwise an error is generated.
[in]   long   lSoftwareVersion   Version of the main software using this DLL.

New feature: if the variable bstrSoftwarePackage is used to load external XML data then lSoftwareVersion is used to control the timestamp and resend status.

  • lSoftwareVersion=0: use the XML supplied timestamp and resend status. This is the default if none of the defined values apply
  • lSoftwareVersion=1: use the XML supplied timestamp and set the resend status to original (resendID=0)
  • lSoftwareVersion=2: use the XML supplied timestamp and set the resend status to copy (resendID=1)
  • lSoftwareVersion=3: generate a new timestamp and use the XML supplied resend status
  • lSoftwareVersion=4: generate a new timestamp and set the resend status to original (resendID=0)
  • lSoftwareVersion=5: generate a new timestamp and set the resend status to copy (resendID=1)
  • lSoftwareVersion=6: generate an annulment invoice with an resend status of original (resendID=0). Beware that the supplied XML data is not already an annulment invoice otherwise the original invoice is produced!
  • lSoftwareVersion=7: generate an annulment invoice with an resend status of copy (resendID=1). Beware that the supplied XML data is not already an annulment invoice otherwise the original invoice is produced!
[in]   long   lSoftwareID   Identification number of the main software using this DLL
[out, retval]   IMDInvoiceRequest   **ppIMDInvoiceRequest   IMDInvoiceRequest interface. The handle is NULL if an error occurred.

 C/C++ return value
S_OK This value is returned if the function call was successful.
E_name This value is returned if the function call was unsuccessful and an error exception was generated.
Note that an exception is thrown under these conditions if you are using SmartPointers.

 Remarks
If you are using SmartPointers the function names and calls are rewritten by Microsoft into the form:
mdInvoiceRequest
  IMDInvoiceRequestManager
    CreateMDInvoiceRequest