Interface IVariousAddressesApi
Represents a collection of functions to interact with the API endpoints
Inherited Members
Namespace: Simplic.Datev.Swagger.Api
Assembly: Simplic.Datev.IO.Swagger.dll
Syntax
public interface IVariousAddressesApi : IApiAccessor
Methods
| Improve this Doc View SourceClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGet(String, String, String, String, Nullable<Int32>, String)
Retrieve a list of various addresses
Declaration
List<VariousAddress> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGet(string clientId, string fiscalYearId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| System.Collections.Generic.List<VariousAddress> | List<VariousAddress> |
Remarks
Retrieve the various addresses of a client/company. With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various address object will be requested without subordinate objects (bank, address, and communication details).<br><br> Filter Filters to condense the scope of the results are not available.<br><br> Paging When accessing large quantities of data, it may happen that these cannot be delivered in a single request. In this case, paging has to be used in order to reduce the amount of data in a single request. Please use top and skip for this purpose. Various addresses will be sorted by address number. |Parameter|Description | |:- -- -- -:|- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --| | skip | Number of various addresses that should be skipped. Example: skip=40| | top | Number of various addresses that should be read as a result of the request. Example: top=20 | Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.<br><br> URI examples Retrieving of the first 10 various addresses:<br> .../various-addresses?top=10 Retrieving of the next 10 various addresses:<br> .../various-addresses?top=10&skip=10
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetAsync(String, String, String, String, Nullable<Int32>, String)
Retrieve a list of various addresses
Declaration
Task<List<VariousAddress>> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetAsync(string clientId, string fiscalYearId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<System.Collections.Generic.List<VariousAddress>> | Task of List<VariousAddress> |
Remarks
Retrieve the various addresses of a client/company. With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various address object will be requested without subordinate objects (bank, address, and communication details).<br><br> Filter Filters to condense the scope of the results are not available.<br><br> Paging When accessing large quantities of data, it may happen that these cannot be delivered in a single request. In this case, paging has to be used in order to reduce the amount of data in a single request. Please use top and skip for this purpose. Various addresses will be sorted by address number. |Parameter|Description | |:- -- -- -:|- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --| | skip | Number of various addresses that should be skipped. Example: skip=40| | top | Number of various addresses that should be read as a result of the request. Example: top=20 | Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.<br><br> URI examples Retrieving of the first 10 various addresses:<br> .../various-addresses?top=10 Retrieving of the next 10 various addresses:<br> .../various-addresses?top=10&skip=10
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetAsyncWithHttpInfo(String, String, String, String, Nullable<Int32>, String)
Retrieve a list of various addresses
Declaration
Task<ApiResponse<List<VariousAddress>>> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetAsyncWithHttpInfo(string clientId, string fiscalYearId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<ApiResponse<System.Collections.Generic.List<VariousAddress>>> | Task of ApiResponse (List<VariousAddress>) |
Remarks
Retrieve the various addresses of a client/company. With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various address object will be requested without subordinate objects (bank, address, and communication details).<br><br> Filter Filters to condense the scope of the results are not available.<br><br> Paging When accessing large quantities of data, it may happen that these cannot be delivered in a single request. In this case, paging has to be used in order to reduce the amount of data in a single request. Please use top and skip for this purpose. Various addresses will be sorted by address number. |Parameter|Description | |:- -- -- -:|- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --| | skip | Number of various addresses that should be skipped. Example: skip=40| | top | Number of various addresses that should be read as a result of the request. Example: top=20 | Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.<br><br> URI examples Retrieving of the first 10 various addresses:<br> .../various-addresses?top=10 Retrieving of the next 10 various addresses:<br> .../various-addresses?top=10&skip=10
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetWithHttpInfo(String, String, String, String, Nullable<Int32>, String)
Retrieve a list of various addresses
Declaration
ApiResponse<List<VariousAddress>> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesGetWithHttpInfo(string clientId, string fiscalYearId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| ApiResponse<System.Collections.Generic.List<VariousAddress>> | ApiResponse of List<VariousAddress> |
Remarks
Retrieve the various addresses of a client/company. With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various address object will be requested without subordinate objects (bank, address, and communication details).<br><br> Filter Filters to condense the scope of the results are not available.<br><br> Paging When accessing large quantities of data, it may happen that these cannot be delivered in a single request. In this case, paging has to be used in order to reduce the amount of data in a single request. Please use top and skip for this purpose. Various addresses will be sorted by address number. |Parameter|Description | |:- -- -- -:|- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --| | skip | Number of various addresses that should be skipped. Example: skip=40| | top | Number of various addresses that should be read as a result of the request. Example: top=20 | Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.<br><br> URI examples Retrieving of the first 10 various addresses:<br> .../various-addresses?top=10 Retrieving of the next 10 various addresses:<br> .../various-addresses?top=10&skip=10
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPost(String, String, VariousAddress)
Create a new various address
Declaration
ErrorMessage ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPost(string clientId, string fiscalYearId, VariousAddress variousAddress)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| VariousAddress | variousAddress | Master data of a various address |
Returns
| Type | Description |
|---|---|
| ErrorMessage | ErrorMessage |
Remarks
A new various address will be created with the next available number (various-address-id). With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> GoBD finalization of accounting sequences Pursuant to guideline 1 of the principles regarding the proper keeping and retention of books, records, and documents in electronic form and regarding data access (GoBD), changes to the business partner master data (various addresses) will be logged in Rechnungswesen. A log of all import activities can be retrieved within Rechnungswesen under: Bestand | Importieren | Importprotokoll.<br><br> Date specification with time zone The given time zone in the various address (for example, addresses and banks, temporary billing blocks) should correspond to the time zone set on the server, since otherwise dates may be deferred. As a rule, the given time zone is the Central European time zone (CET/CEST).<br><br> It is recommended that the time is set in this specific format 00:00:00.000 (hh:mm:ss.f).<br> Example: 2016-12-30T00:00:00.000+01:00<br> If 23:59.59.999 is specified as the exact date and time, depending on the database field, the next day may be displayed due to rounding differences. For example: JSON = 2016-01-01T23:59:59.999+01:00 (01.01.2016) | database = 2016-01-02T00:00.000 +01.00 (02.01.2016)<br><br> See also the official site of Microsoft:<br> English article: https://technet.microsoft.com/en-us/library/ms187819.aspx <br> German article: https://technet.microsoft.com/de-de/library/ms187819.aspx <br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostAsync(String, String, VariousAddress)
Create a new various address
Declaration
Task<ErrorMessage> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostAsync(string clientId, string fiscalYearId, VariousAddress variousAddress)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| VariousAddress | variousAddress | Master data of a various address |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<ErrorMessage> | Task of ErrorMessage |
Remarks
A new various address will be created with the next available number (various-address-id). With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> GoBD finalization of accounting sequences Pursuant to guideline 1 of the principles regarding the proper keeping and retention of books, records, and documents in electronic form and regarding data access (GoBD), changes to the business partner master data (various addresses) will be logged in Rechnungswesen. A log of all import activities can be retrieved within Rechnungswesen under: Bestand | Importieren | Importprotokoll.<br><br> Date specification with time zone The given time zone in the various address (for example, addresses and banks, temporary billing blocks) should correspond to the time zone set on the server, since otherwise dates may be deferred. As a rule, the given time zone is the Central European time zone (CET/CEST).<br><br> It is recommended that the time is set in this specific format 00:00:00.000 (hh:mm:ss.f).<br> Example: 2016-12-30T00:00:00.000+01:00<br> If 23:59.59.999 is specified as the exact date and time, depending on the database field, the next day may be displayed due to rounding differences. For example: JSON = 2016-01-01T23:59:59.999+01:00 (01.01.2016) | database = 2016-01-02T00:00.000 +01.00 (02.01.2016)<br><br> See also the official site of Microsoft:<br> English article: https://technet.microsoft.com/en-us/library/ms187819.aspx <br> German article: https://technet.microsoft.com/de-de/library/ms187819.aspx <br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostAsyncWithHttpInfo(String, String, VariousAddress)
Create a new various address
Declaration
Task<ApiResponse<ErrorMessage>> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostAsyncWithHttpInfo(string clientId, string fiscalYearId, VariousAddress variousAddress)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| VariousAddress | variousAddress | Master data of a various address |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<ApiResponse<ErrorMessage>> | Task of ApiResponse (ErrorMessage) |
Remarks
A new various address will be created with the next available number (various-address-id). With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> GoBD finalization of accounting sequences Pursuant to guideline 1 of the principles regarding the proper keeping and retention of books, records, and documents in electronic form and regarding data access (GoBD), changes to the business partner master data (various addresses) will be logged in Rechnungswesen. A log of all import activities can be retrieved within Rechnungswesen under: Bestand | Importieren | Importprotokoll.<br><br> Date specification with time zone The given time zone in the various address (for example, addresses and banks, temporary billing blocks) should correspond to the time zone set on the server, since otherwise dates may be deferred. As a rule, the given time zone is the Central European time zone (CET/CEST).<br><br> It is recommended that the time is set in this specific format 00:00:00.000 (hh:mm:ss.f).<br> Example: 2016-12-30T00:00:00.000+01:00<br> If 23:59.59.999 is specified as the exact date and time, depending on the database field, the next day may be displayed due to rounding differences. For example: JSON = 2016-01-01T23:59:59.999+01:00 (01.01.2016) | database = 2016-01-02T00:00.000 +01.00 (02.01.2016)<br><br> See also the official site of Microsoft:<br> English article: https://technet.microsoft.com/en-us/library/ms187819.aspx <br> German article: https://technet.microsoft.com/de-de/library/ms187819.aspx <br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostWithHttpInfo(String, String, VariousAddress)
Create a new various address
Declaration
ApiResponse<ErrorMessage> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesPostWithHttpInfo(string clientId, string fiscalYearId, VariousAddress variousAddress)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| VariousAddress | variousAddress | Master data of a various address |
Returns
| Type | Description |
|---|---|
| ApiResponse<ErrorMessage> | ApiResponse of ErrorMessage |
Remarks
A new various address will be created with the next available number (various-address-id). With various addresses, you can edit the addresses of various business partners. These are business partners that do not have their own account, but that are managed with other business partners under a single joint account number. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> GoBD finalization of accounting sequences Pursuant to guideline 1 of the principles regarding the proper keeping and retention of books, records, and documents in electronic form and regarding data access (GoBD), changes to the business partner master data (various addresses) will be logged in Rechnungswesen. A log of all import activities can be retrieved within Rechnungswesen under: Bestand | Importieren | Importprotokoll.<br><br> Date specification with time zone The given time zone in the various address (for example, addresses and banks, temporary billing blocks) should correspond to the time zone set on the server, since otherwise dates may be deferred. As a rule, the given time zone is the Central European time zone (CET/CEST).<br><br> It is recommended that the time is set in this specific format 00:00:00.000 (hh:mm:ss.f).<br> Example: 2016-12-30T00:00:00.000+01:00<br> If 23:59.59.999 is specified as the exact date and time, depending on the database field, the next day may be displayed due to rounding differences. For example: JSON = 2016-01-01T23:59:59.999+01:00 (01.01.2016) | database = 2016-01-02T00:00.000 +01.00 (02.01.2016)<br><br> See also the official site of Microsoft:<br> English article: https://technet.microsoft.com/en-us/library/ms187819.aspx <br> German article: https://technet.microsoft.com/de-de/library/ms187819.aspx <br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGet(String, String, String, String, String, Nullable<Int32>, String)
Retrieve a specific various address
Declaration
VariousAddress ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGet(string clientId, string fiscalYearId, string variousAddressId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | variousAddressId | Various address number |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| VariousAddress | VariousAddress |
Remarks
Retrieve a specific various address of a client/company. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various addresse object will be requested without subordinate objects (bank, address, and communication details).<br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetAsync(String, String, String, String, String, Nullable<Int32>, String)
Retrieve a specific various address
Declaration
Task<VariousAddress> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetAsync(string clientId, string fiscalYearId, string variousAddressId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | variousAddressId | Various address number |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<VariousAddress> | Task of VariousAddress |
Remarks
Retrieve a specific various address of a client/company. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various addresse object will be requested without subordinate objects (bank, address, and communication details).<br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetAsyncWithHttpInfo(String, String, String, String, String, Nullable<Int32>, String)
Retrieve a specific various address
Declaration
Task<ApiResponse<VariousAddress>> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetAsyncWithHttpInfo(string clientId, string fiscalYearId, string variousAddressId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | variousAddressId | Various address number |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<ApiResponse<VariousAddress>> | Task of ApiResponse (VariousAddress) |
Remarks
Retrieve a specific various address of a client/company. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various addresse object will be requested without subordinate objects (bank, address, and communication details).<br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |
ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetWithHttpInfo(String, String, String, String, String, Nullable<Int32>, String)
Retrieve a specific various address
Declaration
ApiResponse<VariousAddress> ClientsClientIdFiscalYearsFiscalYearIdVariousAddressesVariousAddressIdGetWithHttpInfo(string clientId, string fiscalYearId, string variousAddressId, string select = null, string skip = null, int? top = null, string expand = null)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | clientId | ID of central client/company |
| System.String | fiscalYearId | ID of the fiscal year |
| System.String | variousAddressId | Various address number |
| System.String | select | Comma separated list of properties to which the results will then be limited. Example: select=id (optional) |
| System.String | skip | States how many elements in the total number of items should be skipped. Example: skip=10 (optional) |
| System.Nullable<System.Int32> | top | States the maximum number of elements that should be contained within the total. Example: top=10 (optional) |
| System.String | expand | Parameter that allows reading a resource with subordinate objects. When specifying "all", all subordinate objects are loaded (no indication corresponds to "none"). Example: expand=all (optional) |
Returns
| Type | Description |
|---|---|
| ApiResponse<VariousAddress> | ApiResponse of VariousAddress |
Remarks
Retrieve a specific various address of a client/company. For more information, please refer to the document <a href="../../../node/316" target="_blank">Supplementary information for the interface documentation of DATEVconnect</a>.<br><br> Retrieving various addresses with subordinate objects By including the parameter expand=all in the URI, the full scope of a various addresse object will be requested. In the standard case, without the expand parameter, the various addresse object will be requested without subordinate objects (bank, address, and communication details).<br><br> Use multiple data paths It is necessary to know the correct data path to address the correct data stock. If the correct data path cannot be determined in DATEVconnect, the desired data path can be defined by a configuration file to resolve this data path collision. Further information is provided in Info Database, document 1071637.
Exceptions
| Type | Condition |
|---|---|
| ApiException | Thrown when fails to make API call |