The ATL COM module generalInvoiceRequest is capable of
generating electronic and printed invoices & reminders
generating electronic and printed invoices & reminders
API browser of generalInvoiceRequest450 COM module
IGeneralInvoiceResult::GetDebitor method | |||
---|---|---|---|
Retrieves the debitor's EAN identifier as well as the structured address.
The structured address data is read via the methods of the returned IAddress interface instance. Please note, that dependent on the tiers mode a clone of the guarantor's address (TG) or the insurance's address (TP) is automatically assigned as debitor address in the IGeneralInvoiceRequest::Finalize method should the IGeneralInvoiceRequest::SetDebitor method not be called. |
|||
Restful webservice calling syntax | |||
[POST] | /baseURL/IGeneralInvoiceResult/GetDebitor | ||
[JSON input data] | pIGeneralInvoiceResult: | longValue, //interface address |
|
[JSON result data] | pbstrEAN: pIAddress: pbStatus: |
"utf8StringValue", { pbIsPrivateAddress: true, pbstrCompanyName: "utf8StringValue", pbstrDepartment: "utf8StringValue", pbstrSalutation: "utf8StringValue", pbstrTitle: "utf8StringValue", pbstrFamilyname: "utf8StringValue", pbstrGivenname: "utf8StringValue", pbstrSubaddressing: "utf8StringValue", pbstrStreet: "utf8StringValue", pbstrPoBox: "utf8StringValue", pbstrZip: "utf8StringValue", pbstrCity: "utf8StringValue", pbstrStateCode: "utf8StringValue", pbstrCountryCode: "utf8StringValue", pbstrPhone1: "utf8StringValue", pbstrPhone2: "utf8StringValue", pbstrPhone3: "utf8StringValue", pbstrFax: "utf8StringValue", pbstrEMail: "utf8StringValue", pbstrUrl: "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 GetDebitor( | BSTR
IAddress VARIANT_BOOL |
*pbstrEAN,
**pIAddress, *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 | |||
[out] BSTR | *pbstrEAN | The EAN number of the debitor as supplied by Stiftung Refdata.
If the debitor's EAN is undefined than an EAN from the private segment should be used (e.g. 2000000000008). |
|
[out] IAddress | **pIAddress | The instance of a IAddress interface that allows to read back the structured address data.
If no address is defined then the handle is NULL. |
|
[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. | |