Core resources
Steuersätze
Abrufen einer Liste der verfügbaren Steuersätze für verschiedene Länder und Regionen
Übersicht
Der Endpunkt „Tax Rates“ gibt alle Steuersätze zurück, die für Ihr Konto auf der Curosa-Plattform konfiguriert sind. Steuersatz-IDs werden beim Erstellen oder Aktualisieren von Produkten referenziert, um den korrekten Steuersatz mit der Website-Preisgestaltung eines Produkts zu verknüpfen.
Authentifizierung
Dieser Endpunkt erfordert eine Authentifizierung. Geben Sie Ihr API-Token im Header Authorization an. Weitere Informationen zum Erhalt eines Tokens finden Sie im Leitfaden zur Authentifizierung.
Alle Steuersätze auflisten
Rufen Sie eine Liste aller für Ihr Konto verfügbaren Steuersätze ab.
Endpunkt: GET https://curosa.com/api/v1/tax-rates
Anfrage
curl --location 'https://curosa.com/api/v1/tax-rates' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Antwort
Gibt ein 200 OK mit einem data-Array zurück, das alle verfügbaren Steuersätze enthält:
{
"data": [
{
"id": 1,
"name": "Standard Rate",
"rate": "20.00",
"country_code": "GB",
"state_code": null,
"display_name": "Standard Rate (20%)"
}
]
}
Antwortfelder:
| Feld | Typ | Beschreibung |
|---|---|---|
id |
Integer | Eindeutige Kennung für den Steuersatz. Wird verwendet, wenn auf einen Steuersatz in anderen API-Aufrufen verwiesen wird |
name |
String | Name des Steuersatzes (z. B. "Standard Rate") |
rate |
String | Prozentsatz der Steuer als Dezimalzeichenfolge (z. B. "20.00" für 20 %) |
country_code |
String | ISO 3166-1 Alpha-2-Ländercode, für den dieser Satz gilt (z. B. "GB") |
state_code |
String|null | Code für Bundesland oder Provinz, falls der Satz regionsspezifisch ist. null bedeutet, dass der Satz für das gesamte Land gilt |
display_name |
String | Formatierte Bezeichnung, die Name und Prozentsatz kombiniert (z. B. "Standard Rate (20%)") |
Verwendung von Steuersatz-IDs
Wenn Sie die Website-Preisgestaltung für ein Produkt festlegen, verweisen Sie auf den Steuersatz über seine id:
{
"site_pricing": [
{
"site_code": "UK",
"price": "50.00",
"price_currency": "GBP",
"tax_rate_id": 1
}
]
}
Ratenbegrenzung
Dieser Endpunkt ist auf 3.600 Anfragen pro Stunde begrenzt. Das aktuelle Limit und die verbleibenden Anfragen werden in den Antwort-Headern als x-ratelimit-limit und x-ratelimit-remaining zurückgegeben.