The ATL COM module generalInvoiceRequest is capable of
generating electronic and printed invoices & reminders
						generating electronic and printed invoices & reminders
	
API browser of generalInvoiceRequest500 COM module
 
							
							
						
|  IGeneralInvoiceResult::GetFirstXtraService method |  | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Gets the first token=value pair from the list of token=value pairs for a supplied service ID. VARIANT_FALSE is returned if the end of the section/location list is reached. | |||||||||||||
|  | |||||||||||||
|  Restful webservice calling syntax | |||||||||||||
| [POST] | /baseURL/IGeneralInvoiceResult/GetFirstXtraService | ||||||||||||
| [JSON input data] | pIGeneralInvoiceResult: lID: | longValue,    //interface address longValue | |||||||||||
| [JSON result data] | pbstrToken: pbstrValue: pbStatus: | "utf8StringValue", "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. | ||||||||||||
|  | |||||||||||||
|  C/C++ calling syntax | |||||||||||||
| HRESULT GetFirstXtraService( | long BSTR BSTR VARIANT_BOOL | lID, *pbstrToken, *pbstrValue, *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 | |||||||||||||
| [in] long | lID | The unique ID of the prior defined service for which the xtra service data should be retrieved. | |||||||||||
| [out] BSTR | *pbstrToken | The well defined  token of the token=value pair. Forum Datenaustausch has defined the following tokens as of November 2024 
 | |||||||||||
| [out] BSTR | *pbstrValue | The value of the token=value pair | |||||||||||
| [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. | |||||||||||
|  | |||||||||||||
