Shipping

Abrechnung1 EndpunkteBilling / Shipping

Liefert ein Dummy-Angebot mit berechnetem Versandpreis.

GET/api/invoice/shipping_price/calculate/{countryCode}/{zipCode}/{shippingType}

Pfad-Parameter

`countryCode`Pflichtstring
`zipCode`Pflichtstring
`shippingType`Pflichtstring

Query-Parameter

`searchString`string	Text, nach dem in der Liste gesucht wird
`orderFieldName`string	Name des Bestellfelds
`orderFieldSort`string	SortiermodusErlaubt: `DESCASC`
`page`integer	Seite der Liste
`pageSize`integer	Anzahl der Einträge je Seite
`withMaxPageNumber`string	gibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert ein Dummy-Angebot mit berechnetem Versandpreis.Offer5

Felder anzeigen (33)

idinteger
Primärschlüssel des Rechnungsdokuments. Interne ID.
tokenstring
Token, das das Dokument für den öffentlichen Zugriff identifiziert.
numberinteger
Laufende Belegnummer.
manual_number_prefixstring
Präfix einer manuell eingegebenen Dokumentnummer.
manual_numberinteger
Manuell eingegebene Dokumentnummer.
number_stringstring
Belegnummer, wie sie den Benutzern angezeigt wird.
generation_datestring (date-time)
Datum, an dem das Dokument erstellt wurde.
number_datestring (date-time)
Datum, das für die Belegnummer verwendet wird.
messagestring
Auf dem Dokument gedruckte Nachricht.
currencystring
Währung des Dokuments.
namestring
Name des Dokuments.
due_datestring (date-time)
Fälligkeitsdatum des Dokuments.
netto_valuenumber (float)
Nettosumme des Dokuments.
brutto_valuenumber (float)
Bruttogesamtbetrag des Dokuments.
tax_valuenumber (float)
Gesamter Steuerbetrag des Dokuments.
taxTaxPflicht
Auf das Dokument angewendeter Steuersatz.
Felder anzeigen (6)
- idinteger
  Primärschlüssel des Steuersatzes. Interne ID.
- namestringPflicht
  Name des Steuersatzes, zum Beispiel 19 Prozent.
- valuenumber (float)
  Steuersatz in Prozent.
- deletedboolean
  Der Steuersatz wird gelöscht.
- global_defaultboolean
  Standard-Steuersatz für neue Artikel.
- datev_tax_keyinteger
  DATEV Steuerschlüssel für Umsatzsteuer (Ausgangsrechnungen). Wird von BuchhaltungsButler und DATEV-Export genutzt. Standardwerte: 0 = Kein Steuerausweis (0%) 2 = Umsatzsteuer 7% (ermäßigt) 3 = Umsatzsteuer 19% (Regelsteuersatz) Für Vorsteuer (Eingangsrechnungen) gibt es eine spiegelbildliche Zuordnung: 0 = Keine Vorsteuer (0%) 5 = Vorsteuer 7% 8 = Vorsteuer 19%
linked_number_titlestring
Titel der verknüpften Dokumentnummer.
linked_numberstring
Nummer des verknüpften Belegs.
statusstring
Status des Dokuments.
previous_statusstring
Status vor der letzten Änderung.
status_updatedstring (date-time)
Zeitpunkt, zu dem der Status zuletzt geändert wurde.
archivedboolean
Ob das Dokument archiviert ist.
last_pdf_exportstring (date-time)
Zeitpunkt, zu dem das PDF zuletzt exportiert wurde.
last_status_exportstring
Status beim letzten Export.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
offer_accounting_typeOfferAccountingTypePflicht
Buchungsart des Angebots.
Felder anzeigen (7)
- idinteger
  Primärschlüssel des Angebots-Buchungstyps. Interne ID.
- namestringPflicht
  Name der Buchungsart.
- cancelled_namestring
  Name, der verwendet wird, wenn ein Angebot dieses Typs storniert wird.
- typestringPflicht
  Art des Buchungstyps, zum Beispiel Angebot oder Vertrag.
- conditionsstring
  Auf dem Angebot abgedruckte Bedingungen.
- number_descriptionstring
  Beschreibung des Zahlenformats des Angebots.
- deletedboolean
  Die Buchungsart wird gelöscht.
itemsarray<OfferItem5>
Positionen des Angebots.
Felder anzeigen (16)
- idinteger
  Primärschlüssel der Rechnungsposition. Interne ID.
- descriptionstring
  Beschreibung der Rechnungsposition.
- price_is_bruttoboolean
  Ob der Preis ein Bruttopreis inklusive Steuer ist.
- skustring
  Artikelnummer (Stock Keeping Unit)
- barcodestring
  Barcode (ISBN, UPC, GTIN usw.)
- item_typestring
  Typ (Item, Shipping)
- netto_valuenumber (float)
  Nettowert der Rechnungsposition.
- brutto_valuenumber (float)
  Bruttowert der Rechnungsposition.
- tax_valuenumber (float)
  Steuerbetrag der Rechnungsposition.
- quantitynumber (float)Pflicht
  Menge der Rechnungsposition.
- pricenumber (float)Pflicht
  Einzelpreis der Rechnungsposition.
- namestringPflicht
  Name der Rechnungsposition.
- unitstringPflicht
  Einheit der Rechnungsposition.
- taxTax
  Auf die Rechnungsposition angewendeter Steuersatz.
- offerOffer5
  Angebot, zu dem der Gegenstand gehört.
- custom_productCustomizedBillingItem4
  Angepasstes Produkt, das für den Posten verwendet wird.
buyerOfferBuyer5
Käufer des Angebots.
Felder anzeigen (22)
- idinteger
  Primärschlüssel des Clients. Interne ID.
- namestring
  Name des Kunden auf der Rechnung.
- vat_idstring
  USt-IdNr. des Kunden.
- taxnumberstring
  Steuernummer des Kunden.
- buyer_reference_idstring
  Leitweg-ID oder vom Kunden definierte individuelle Referenz-ID
- secondary_namestring
  Zweite Namenszeile des Kunden auf der Rechnung.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- numberstring
  Kundennummer des Käufers.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- offerOffer5
  Angebot, zu dem der Käufer gehört.
accepted_datestring (date-time)
Datum, an dem das Angebot angenommen wurde.
is_accepted_date_from_ext_serviceboolean
Das Annahmedatum stammt von einem externen Dienst.
projectCRMProject13
Projekt, zu dem das Angebot gehört.
Felder anzeigen (19)
- idinteger
  Primärschlüssel des Projekts. Interne ID.
- namestring
  Name des Projekts.
- closedstring (date-time)
  Zeitpunkt, zu dem das Projekt geschlossen wurde.
- billedstring (date-time)
  Zeitpunkt, zu dem das Projekt abgerechnet wurde.
- numberstring
  Nummer des Projekts.
- startstring (date-time)
  Beginn des Projekts.
- endstring (date-time)
  Ende des Projekts.
- descriptionstring
  Beschreibung des Projekts.
- companyCRMCompany
  Unternehmen, zu dem das Projekt gehört.
- internal_main_contactUser14
  Interner Benutzer, der Hauptansprechpartner ist.
- categoryCRMProjectCategory
  Kategorie des Projekts.
- archivedboolean
  Das Projekt ist archiviert.
- visible_for_customerboolean
  Das Projekt ist in der Kunden-App sichtbar.
- name_for_customerstring
  Name des Projekts, das Kunden angezeigt wird.
- invoice_emailstring
  E-Mail-Adresse für Rechnungen des Projekts.
- time_report_emailstring
  E-Mail-Adresse für Zeitberichte des Projekts.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
invoicesarray<Invoice21>
Aus dem Angebot erstellte Rechnungen.
Felder anzeigen (38)
- idinteger
  Primärschlüssel des Rechnungsdokuments. Interne ID.
- tokenstring
  Token, das das Dokument für den öffentlichen Zugriff identifiziert.
- numberinteger
  Laufende Belegnummer.
- manual_number_prefixstring
  Präfix einer manuell eingegebenen Dokumentnummer.
- manual_numberinteger
  Manuell eingegebene Dokumentnummer.
- number_stringstring
  Belegnummer, wie sie den Benutzern angezeigt wird.
- generation_datestring (date-time)
  Datum, an dem das Dokument erstellt wurde.
- number_datestring (date-time)
  Datum, das für die Belegnummer verwendet wird.
- messagestring
  Auf dem Dokument gedruckte Nachricht.
- currencystring
  Währung des Dokuments.
- namestring
  Name des Dokuments.
- due_datestring (date-time)
  Fälligkeitsdatum des Dokuments.
- netto_valuenumber (float)
  Nettosumme des Dokuments.
- brutto_valuenumber (float)
  Bruttogesamtbetrag des Dokuments.
- tax_valuenumber (float)
  Gesamter Steuerbetrag des Dokuments.
- taxTaxPflicht
  Auf das Dokument angewendeter Steuersatz.
- linked_number_titlestring
  Titel der verknüpften Dokumentnummer.
- linked_numberstring
  Nummer des verknüpften Belegs.
- statusstring
  Status des Dokuments.
- previous_statusstring
  Status vor der letzten Änderung.
- status_updatedstring (date-time)
  Zeitpunkt, zu dem der Status zuletzt geändert wurde.
- archivedboolean
  Ob das Dokument archiviert ist.
- last_pdf_exportstring (date-time)
  Zeitpunkt, zu dem das PDF zuletzt exportiert wurde.
- last_status_exportstring
  Status beim letzten Export.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- accounting_typeAccountingTypePflicht
  Buchungsart der Rechnung.
- payment_typePaymentType
  Zahlungsart der Rechnung.
- payment_goalPaymentGoal
  Zahlungsbedingung der Rechnung.
- expense_categoryExpenseCategory10
  EÜR-Kategorie für diese Rechnung (Einnahmen-Zuordnung) Wenn nicht gesetzt, wird die Default-Kategorie des AccountingTypes verwendet
- buyerInvoiceBuyer20
  Käufer der Rechnung.
- payment_datestring (date-time)
  Datum, an dem die Rechnung bezahlt wurde.
- vat_categorystring
  Der umsatzsteuerliche Sachverhalt. Der Steuersatz sagt nicht, in welche Zeile der Voranmeldung ein Umsatz gehört. Null Prozent stehen an einer innergemeinschaftlichen Lieferung (Kennzahl 41), an einer Ausfuhr (43), an einer Leistung nach § 13b UStG (60) und an einem steuerfreien Umsatz nach § 4 UStG (48) - vier verschiedene Zeilen, derselbe Steuersatz. Hier ist die einzige Stelle, an der jemand das weiß: beim Schreiben der Rechnung ist bekannt, ob der Kunde eine USt-IdNr. hat und wohin die Ware geht. Später ist es nicht mehr rekonstruierbar. Ohne Angabe der Regelfall - alles andere war bisher nicht erfassbar.
- is_payment_date_from_ext_serviceboolean
  Das Zahlungsdatum stammt von einem externen Dienst.
- direct_debit_exportedboolean
  Die Rechnung wurde für das Lastschriftverfahren exportiert.
- cancel_datestring (date-time)
  Datum, an dem die Rechnung storniert wurde.
- cancel_textstring
  Text der Stornierung.
- start_datestring (date-time)
  Beginn des abgerechneten Zeitraums.
- end_datestring (date-time)
  Ende des abgerechneten Zeitraums.
base_event_sign_upBaseEventSignUp10
Anmeldung, für die das Angebot angelegt wurde.
Felder anzeigen (54)
- bib_range_idinteger
- age_classstring
  Altersklasse nach DLV, z. B. M40 – berechnet aus Geburtstag, Geschlecht und Veranstaltungsdatum.
- idinteger
  Primärschlüssel der Anmeldung. Interne ID.
- genderstring
  Geschlecht des Teilnehmers.
- tokenstring
  Öffentlicher Token der Anmeldung. In Links anstelle der ID verwendet.
- moments_tokenstring
  Teilnehmerbezogenes Momente-Token: erlaubt dieser Person die Nutzung der Veranstaltungs-Momente (digitales Gästebuch); Uploads über dieses Token werden der Person zugeordnet.
- waitingboolean
  Die Anmeldung steht auf der Warteliste.
- confirmedboolean
  Die Anmeldung ist bestätigt.
- externalboolean
  Die Anmeldung wurde von einer externen Stelle vorgenommen.
- deletion_reasonstring
  Grund für die Stornierung der Anmeldung.
- billedboolean
  Die Anmeldung wurde abgerechnet.
- direct_billingboolean
- direct_billing_check_datestring (date-time)
- direct_billing_tokenstring
- wait_list_confirmation_tokenstring
- wait_list_confirmation_sent_atstring (date-time)
- wait_list_confirmation_deadlinestring (date-time)
- wait_list_confirmed_atstring (date-time)
- wait_list_pending_confirmationboolean
- wait_list_sort_orderinteger
- birthdaystring (date-time)
  Geburtstag des Teilnehmers.
- trialboolean
  Schnuppertermin-Anmeldung (Schnuppern): eine Terminanmeldung ohne Kursplatz, die eine Einheit des Schnupper-Kontingents der Person verbraucht (eventAccessBudget mit sourceType trial)
- trial_channelstring
  Wer den Probetermin gebucht hat: App, Trainer, Büro
- trial_session_numberinteger
  Nummer dieses Probetermins innerhalb des Durchgangs (1 = erster), für "Schnuppern 2/3"
- trial_session_maxinteger
  Schnuppertermine des Passes, für "Schnuppern 2/3"
- nace_sectionstring
  NACE-Abschnittscode (Buchstabe A-U)
- nace_codestring
  NACE-Code (numerisch, z. B. 01.11, 62.01)
- bib_numberinteger
  Startnummer (Zähler). Bei PER_PREFIX nur zusammen mit dem Präfix eindeutig. Wird nur über BibNumberAssigner gesetzt, stornierte Anmeldungen behalten sie.
- bib_labelstring
  Angezeigte Startnummer inkl. Präfix, z. B. W0123. Pro Veranstaltung eindeutig.
- bib_number_assigned_atstring (date-time)
  Zeitpunkt, zu dem die Startnummer vergeben wurde.
- chip_codestring
  Transponder- oder QR-Kennung fuer die Zeitmessung. Pro Event eindeutig.
- timing_tracking_consentboolean
  Einwilligung in das GPS-Live-Tracking während des Events.
- createdstring (date-time)
  Zeitpunkt, zu dem der Datensatz angelegt wurde.
- updatedstring (date-time)
  Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
- addressstring
  Adresse als Text.
- address_streetstring
  Straße der Adresse.
- address_house_numberstring
  Hausnummer der Adresse.
- address_street_levelstring
  Straße und Hausnummer der Adresse.
- address_costring
  Care-of-Zeile der Adresse.
- address_citystring
  Ort der Adresse.
- address_zipstring
  Postleitzahl der Adresse.
- address_admin_level1string
  Erste Verwaltungsebene der Adresse, z. B. das Bundesland.
- address_countrystring
  Ländercode der Adresse.
- address_full_countrystring
  Vollständiger Name des Landes der Adresse.
- address_geo_latstring
  Breitengrad der Adresse.
- address_geo_lngstring
  Längengrad der Adresse.
- address_external_provider_idstring
  Feld zur Speicherung der externen Anbieter-ID der Adresse, z. B. Google-Maps-PlaceID wie google:ChIJVcKw5r90sEcRhdjNq6NItqE
- namestring
  Name der Einheit.
- main_phonestring
  Haupttelefonnummer.
- main_faxstring
  Haupt-Faxnummer.
- main_emailstring
  Haupt-E-Mail-Adresse.
- websitestring
  Website-Adresse.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- orderinteger
  Position des Datensatzes in der Reihenfolge.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/invoice/shipping_price/calculate/42/30163/42"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/billing_shipping_price_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await BillingShippingPriceController.get('42', '30163', '42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "tax": {
    "name": "Beispiel",
    "id": 42,
    "value": 1.5,
    "deleted": true,
    "global_default": true,
    "datev_tax_key": 1
  },
  "offer_accounting_type": {
    "name": "Beispiel",
    "type": "string",
    "id": 42,
    "cancelled_name": "Beispiel",
    "number_description": "Text",
    "conditions": "string",
    "deleted": true
  },
  "id": 42,
  "currency": "EUR",
  "name": "Beispiel",
  "linked_number_title": "Beispiel",
  "token": "string",
  "number": 1,
  "manual_number_prefix": "string",
  "manual_number": 1
}