Wiegeschein Export API

Wiegeschein Export API

Die Wiegeschein Export API ermoeglicht das Abrufen freigegebener Wiegescheindaten fuer die Uebernahme in wme.fact. Der Export erfolgt Wiegeschein fuer Wiegeschein - jeder Wiegeschein muss nach erfolgreichem Import bestaetigt werden.

---

Uebersicht der Endpoints

Endpoint	Methode	Beschreibung
/v1/released_wiegeschein_data	GET	Naechsten exportierbaren Wiegeschein abrufen
/v1/released_wiegeschein_data	POST	Export eines Wiegescheins bestaetigen
/v1/released_wiegeschein_data_count	GET	Anzahl der exportierbaren Wiegescheine

---

1. Naechsten Wiegeschein abrufen

Ruft den naechsten freigegebenen Wiegeschein inkl. Kostenstellenaufteilung ab.

Request

GET /v1/released_wiegeschein_data?apiKey=ihr-api-key

Response (200 OK)

{
  "id": 12345,
  "buchungsart": "Anlieferung",
  "auftragsnummer": "AUF-2026-001",
  "anliefererOderEmpfaenger": "100001",
  "belegdatum": "2026-01-15",
  "artikel": "0101",
  "lagerort": "LA01",
  "retouregrund": null,
  "garantiegeber": null,
  "gruppe": "Gruppe Nord",
  "isSenderWiegeschein": "T",
  "wiegescheinart": "T",
  "wiegescheinnummer": "WS-2026-00123",
  "kennzeichenLand": "D",
  "kennzeichenOrt": "HH",
  "kennzeichenFrei": "AB 1234",
  "befoerderungsart": "LKW",
  "uhrzeitBrutto": "08:30",
  "uhrzeitTara": "09:15",
  "gewichtBrutto": "25400",
  "gewichtTara": "12800",
  "nettokorrektur": "0",
  "gewichtNetto": "12600",
  "status": "freigegeben",
  "anlage": 16082,
  "anlagenKontoKlasse": 1,
  "bemerkungen": "Sonderlieferung",
  "kostenstellenAufteilungen": [
    {
      "kostenstellenNummer": "KST001",
      "prozentsatz": 60.0,
      "tonnage": 7.56
    },
    {
      "kostenstellenNummer": "KST002",
      "prozentsatz": 40.0,
      "tonnage": 5.04
    }
  ]
}

Response (404 Not Found)

Keine weiteren Wiegescheine zum Exportieren vorhanden.

Wiegeschein-Felder

Feld	Typ	Beschreibung
id	Integer	Eindeutige ID des Wiegescheins
buchungsart	String	Art der Buchung
auftragsnummer	String	Auftragsnummer
anliefererOderEmpfaenger	String	Kontonummer Anlieferer/Empfaenger
belegdatum	String	Belegdatum (YYYY-MM-DD)
artikel	String	Artikelnummer
lagerort	String	Lagerort
retouregrund	String	Retouregrund (falls zutreffend)
garantiegeber	String	Kontonummer Garantiegeber
gruppe	String	Gruppenname
isSenderWiegeschein	String	T = Sender, F = Empfaenger
wiegescheinart	String	T = Eingang, F = Ausgang
wiegescheinnummer	String	Wiegescheinnummer
kennzeichenLand	String	Laendercode Kennzeichen
kennzeichenOrt	String	Ortskennung (z.B. HH, M, B)
kennzeichenFrei	String	Freier Teil des Kennzeichens
befoerderungsart	String	Befoerderungsart (z.B. LKW)
uhrzeitBrutto	String	Uhrzeit Bruttowiegung (HH:MM)
uhrzeitTara	String	Uhrzeit Tarawiegung (HH:MM)
gewichtBrutto	String	Bruttogewicht in kg
gewichtTara	String	Taragewicht in kg
nettokorrektur	String	Nettokorrektur in kg
gewichtNetto	String	Nettogewicht in kg
status	String	Status des Wiegescheins
anlage	Integer	Anlagen-ID
anlagenKontoKlasse	Integer	Kontoklasse der Anlage
bemerkungen	String	Bemerkungen (max. 300 Zeichen)
kostenstellenAufteilungen	Array	Liste der Kostenstellenaufteilungen

Kostenstellenaufteilung-Felder

Feld	Typ	Beschreibung
kostenstellenNummer	String	Kostenstellennummer
prozentsatz	Double	Prozentualer Anteil (Summe = 100%)
tonnage	Double	Anteilige Tonnage in Tonnen

---

2. Export bestaetigen

Bestaetigt den erfolgreichen Import eines Wiegescheins. Nach Bestaetigung wird der Wiegeschein als exportiert markiert.

Request

POST /v1/released_wiegeschein_data
Content-Type: application/json

{
  "apiKey": "ihr-api-key",
  "wiegescheinId": 12345
}

Request mit Fehlermeldung (optional)

{
  "apiKey": "ihr-api-key",
  "wiegescheinId": 12345,
  "errorMessage": "Import fehlgeschlagen: Artikel nicht gefunden"
}

Response (200 OK)

Wiegeschein erfolgreich als exportiert markiert.

Request-Felder

Feld	Typ	Pflicht	Beschreibung
apiKey	String	Ja	API-Schluessel des Benutzers
wiegescheinId	Integer	Ja	ID des zu bestaetigenden Wiegescheins
errorMessage	String	Nein	Fehlermeldung falls Import fehlgeschlagen

---

3. Anzahl exportierbarer Wiegescheine

Gibt die Anzahl der noch zu exportierenden Wiegescheine zurueck.

Request

GET /v1/released_wiegeschein_data_count?apiKey=ihr-api-key

Response (200 OK)

42

(Einfache Zahl ohne JSON-Wrapper)

---

Response-Codes (alle Endpoints)

Code	Beschreibung
200	Anfrage erfolgreich
401	API-Key ungueltig
404	Keine Daten vorhanden / Wiegeschein nicht gefunden
500	Interner Serverfehler

---

Typischer Export-Ablauf

1. Anzahl pruefen: GET /v1/released_wiegeschein_data_count - Anzahl der zu exportierenden Wiegescheine ermitteln
2. Schleife starten: Solange count > 0:
   • GET /v1/released_wiegeschein_data - Naechsten Wiegeschein abrufen
   • Daten in wme.fact importieren
   • POST /v1/released_wiegeschein_data - Import bestaetigen
3. Fertig: Wenn GET den Status 404 zurueckgibt, sind alle Wiegescheine exportiert

---

Curl-Beispiele

# 1. Anzahl der exportierbaren Wiegescheine pruefen
curl -X GET "https://linux.wme-fact.online/api/v1/released_wiegeschein_data_count?apiKey=ihr-api-key"

# 2. Naechsten Wiegeschein abrufen
curl -X GET "https://linux.wme-fact.online/api/v1/released_wiegeschein_data?apiKey=ihr-api-key"

# 3. Export bestaetigen
curl -X POST "https://linux.wme-fact.online/api/v1/released_wiegeschein_data" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "ihr-api-key", "wiegescheinId": 12345}'

---

Wichtige Hinweise

• Wiegeschein fuer Wiegeschein: Der Export erfolgt einzeln. Jeder Wiegeschein muss nach erfolgreichem Import bestaetigt werden.
• Kostenstellenaufteilung: Falls vorhanden, enthaelt ein Wiegeschein 1-n Kostenstellenaufteilungen. Die Summe der Prozentsaetze betraegt immer 100%.
• Gewichte: Alle Gewichte werden in Kilogramm (kg) angegeben, Tonnage in Tonnen.
• Fehlerbehandlung: Bei Import-Fehlern kann eine errorMessage mitgegeben werden zur Protokollierung.
• Markierung: Nach Bestaetigung wird der Wiegeschein als exportiert markiert und erscheint nicht mehr bei weiteren Abrufen.