Actions61
- Contact Actions
- Article Actions
- Voucher Actions
- Invoice Actions
- Down Payment Invoice Actions
- Quotation Actions
- Credit Note Actions
- Delivery Note Actions
- Dunning Actions
- File Actions
- Profile Actions
- Country Actions
- Payment Condition Actions
- Event Subscription Actions
- Recurring Template Actions
- Voucherlist Actions
- Trigger Actions
Overview
The node integrates with the Lexware Office API to retrieve country-related data. Specifically, for the "Country" resource and the "Get All" operation, it fetches a list of countries filtered by various criteria such as EU membership, support for specific invoicing standards, or valid tax rates. This is useful in scenarios where you need to dynamically obtain country information for financial, tax, or compliance purposes within automated workflows.
Practical examples include:
- Retrieving all EU member countries to apply region-specific tax rules.
- Getting countries that support XRechnung (a German e-invoicing standard) for invoice processing.
- Filtering countries based on valid tax rates at a given date for accurate tax calculations.
Properties
| Name | Meaning |
|---|---|
| Country Filter | Filter countries by specific criteria: - All Countries: Get all countries - EU Countries Only: Get only EU member countries - Non-EU Countries: Get only non-EU countries - XRechnung Support: Countries supporting XRechnung - Distance Sales Support: Countries supporting distance sales - Valid Tax Rates: Countries with valid tax rates |
| Tax Type Filter | When filtering by valid tax rates, specify a tax type to narrow results (e.g., vatfree, intraCommunitySupply). |
| Date Filter | When filtering by valid tax rates, specify a date (ISO format) to check which tax rates are valid at that time. |
| Return All | Boolean flag indicating whether to return all matching results or limit the number of results returned. |
| Limit | Maximum number of results to return if not returning all. Value between 1 and 250. |
| Page | Page number for pagination (0-based index). |
| Sort | Sort order for results. Options include sorting by creation date, update date, voucher date, name, or ID, each ascending or descending. |
| Cursor | Cursor string for cursor-based pagination. |
| Offset | Offset number for offset-based pagination (starting point in the result set). |
Output
The node outputs an array of JSON objects representing countries matching the specified filters. Each object contains detailed country data as provided by the Lexware Office API, including but not limited to country codes, names, tax rate information, and support flags for invoicing standards.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Lexware Office API.
- The node uses the Lexware Office API base URL configured in the credentials.
- No additional external dependencies are required beyond the API access.
Troubleshooting
- Missing Required Fields Error: If required parameters for the operation are not provided, the node throws an error listing missing fields. Ensure all mandatory inputs are set.
- API Authentication Failures: Errors related to invalid or missing API keys will occur if credentials are not properly configured.
- Pagination Issues: If using pagination parameters (limit, page, cursor, offset), ensure values are within allowed ranges to avoid empty or incomplete results.
- Filter Misconfiguration: Using incompatible filters together (e.g., taxTypeFilter without selecting "Valid Tax Rates" in countryFilter) may result in unexpected outputs or no data.
To resolve errors, verify input parameters, ensure valid credentials, and consult the Lexware Office API documentation for correct filter usage.
Links and References
- Lexware Office API Documentation (example placeholder, replace with actual URL if available)
- XRechnung Standard Information
- European Union Member States