HILLBILLY-CREW WIKIWISSEN. OHNE SUCHEREI.

# AgrarMarkt Connector: Fehlercodes und Fehlermeldungen

Hier findest du die Meldungen, die der AgrarMarkt Connector selbst anzeigt oder von der Online-API zurückbekommt. Der Artikel bezieht sich auf die untersuchten Quellen vom 29.09.2026 (Connector v0.22.13 mit Marktübersicht und Teststand v0.22.13-BelegFix). Bei einer anderen installierten Version können Wortlaut und Codes abweichen.

So liest du eine Fehlermeldung#

Im Connector-Protokoll steht häufig Auftrag am-…xml fehlgeschlagen und darunter ApiRequestError: API 409: …. Die XML-Datei bezeichnet den Auftrag; die eigentliche Ursache steht hinter API und im nachfolgenden Text. Der Python-Traceback ist Teil desselben Fehlers. Einige neuere Stände liefern zusätzlich einen technischen error_code; ältere EXE-Stände zeigen meist nur Status und Text.

HTTP 400/422 bedeutet meist ungültige Eingaben, 401/403 fehlende Berechtigung, 404 einen nicht gefundenen Eintrag, 409 einen Konflikt beim Handel, 429 ein Limit und 503 vorübergehende Nichtverfügbarkeit. Der genaue Code steht jeweils unten.

Häufige Fehler und was du tun kannst#

• market_commit_proof_mismatch (409): „Marktbestätigung stimmt nicht mit dem Spielserverbeleg überein.“ Der Markt hat den Abschlussbeleg abgewiesen. Eine mögliche Ursache sind Änderungen von Geld oder Ware während des Handels; das lässt sich am einzelnen Protokolleintrag allein nicht beweisen. Prüfe Mod- und Connector-Version. Notiere Uhrzeit und Auftragsnamen für den Support.
• transaction_not_committed (409): „Diese Transaktion wurde nicht am Markt abgeschlossen.“ Oft ein Folgefehler zu einer bereits abgewiesenen Marktbestätigung. Suche im Protokoll direkt davor nach dem ersten 409-Fehler.
• stock_insufficient (409): „Nicht genügend globaler Bestand verfügbar.“ Kaufe eine kleinere Menge oder warte, bis wieder Ware verfügbar ist.
• transaction_expired (409): Die Reservierung ist abgelaufen. Starte den Handel neu und kontrolliere die Verbindung.
• buy_rate_limit / sell_rate_limit / market_daily_limit (429): Handelslimit erreicht. Warte auf die Freigabe beziehungsweise den nächsten Tag. Ein Neustart des Connectors setzt das Limit nicht zurück.
• tester_required (403): Diese Zusatzfunktion ist nur für registrierte Tester freigeschaltet. Der öffentliche Weltmarkt benötigt keinen Tester-Code.
• client_unknown / client_blocked / installation_mismatch (403): Registrierung oder Zuordnung stimmt nicht. Prüfe die Connector-Meldung und wende dich mit dem Fehlertext an den Support; verwende keine fremde Identität.
• maintenance_mode (503): Der Online-Markt ist vorübergehend nicht erreichbar. Versuche es später erneut.

Schrittweise Fehlersuche#

1. Fehlertext und Zeitpunkt festhalten. Öffne das Connector-Protokoll und lies die erste Fehlermeldung zum betroffenen Auftrag. Weitere am-commit-…xml-Fehler können Folgen dieses ersten Fehlers sein. Notiere den Auftragsnamen, die Ware und die Menge.
2. Im Spiel gegenprüfen. Kontrolliere Hofgeld, Silobestand beziehungsweise Online-Lager und ob ein Kauf oder Verkauf tatsächlich abgeschlossen wurde. Bei unterschiedlichen Anzeigen keine zusätzlichen Testkäufe auslösen, bis der Vorgang geklärt ist.
3. Versionen vergleichen. Prüfe, ob Mod und Connector aus demselben freigegebenen Paket stammen. Ein alter Mod kann einen Abschluss mehrfach melden. Den Teststand v0.22.13-BelegFix nur nutzen, wenn er ausdrücklich für deine Mod-Version freigegeben ist.
4. Verbindung kontrollieren. Bei API-Aufruf … unterbrochen Internetverbindung prüfen und abwarten, ob der automatische Wiederholungsversuch erfolgreich ist. Bei einem Dedicated Server zusätzlich prüfen, ob die richtige Queue verbunden ist und Dateien zwischen Spielserver und Connector ankommen.
5. Keine Aufträge auf Verdacht löschen. Queue-Dateien, Registrierungsdaten und Tester-Code nicht manuell entfernen oder neu erzeugen. Bei unklarem Handelsstand zuerst den Support kontaktieren, damit ein bereits gebuchter Vorgang nicht doppelt behandelt wird.

Hinweise zu weiteren Codes#

• nonce_invalid, timestamp_invalid, signature_invalid (401): Systemuhr und Zeitzone des Rechners prüfen, anschließend die Verbindung neu testen. Bleibt die Meldung bestehen, mit dem genauen Code beim Support melden; keine Identitätsdateien austauschen.
• replay_detected / market_replay_detected / transfer_replay_detected (409): Derselbe Anfragenachweis wurde schon verwendet. Nicht mehrfach manuell absenden; zuerst prüfen, ob der Vorgang im Spiel oder Online-Lager bereits sichtbar ist.
• transaction_expired / transfer_expired (409): Reservierung lief ab. Nach Klärung des alten Vorgangs neu beginnen; bei wiederholtem Auftreten Verbindung und Uhrzeit protokollieren.
• tester_code_invalid, tester_code_used, tester_code_revoked (403/409/422): Code aus dem Bewerbungsticket exakt prüfen. Bereits verwendete oder gesperrte Codes lassen sich nicht durch wiederholte Eingabe freigeben; Support mit dem Fehlercode kontaktieren, aber Code nicht öffentlich posten.
• farm_not_active / farm_not_linked (409): Den Connector des betreffenden Hofs starten, Verbindungstest durchführen und danach die Hofkopplung prüfen. Der öffentliche Weltmarkt bleibt von Testerfunktionen zu unterscheiden.
• player_stock_insufficient, barter_stock_insufficient, wallet_insufficient, player_storage_full (409): Freien Bestand, reservierte Angebote, Marktguthaben beziehungsweise Lagerplatz prüfen. Bereits für Angebote reservierte Ware oder Guthaben kann nicht nochmals verwendet werden.
• liters_invalid, listing_values_invalid, transfer_goods_invalid (422): Menge, Ware und gegebenenfalls Preis neu eingeben. Auf die Einheit achten: Marktpreise gelten in der Regel je 1.000 Liter.
• product_not_found / fill_type_disabled (404/422): Diese Ware wird im gewählten Markt derzeit nicht gehandelt. Eine andere angebotene Ware wählen.
• vehicle_market_closed / market_closed (403): Gebrauchtmarkt und Viehmarkt sind noch geschlossen. Diese Meldung ist eine Funktionssperre, kein Defekt des Connectors.

Meldungen des Connector-Programms#

Verbindungs- und Statusanzeigen: Einrichtung erforderlich, Neuregistrierung erforderlich, Neuregistrierung fehlgeschlagen, Verbindung fehlgeschlagen, Verbindungsaufbau fehlgeschlagen, Start fehlgeschlagen, Verbindung unterbrochen · neuer Versuch in … s. Verbindung wird geprüft …, Verbindung wird aufgebaut … und Wird gestartet … sind zunächst Statusmeldungen, keine Fehler.

Protokoll: API-Aufruf … unterbrochen, Versuch …/3 oder API-Aufruf … fehlgeschlagen (…), Versuch …/3 bedeutet, dass der Connector einen erneuten Versuch unternimmt. Auftrag … vom Markt abgelehnt: API 429: … bezeichnet ein Limit. Bei Auftrag … fehlgeschlagen findest du den Servertext im darunterliegenden Fehler.

Lokale Einrichtung und Queue:

• API-Aufruf konnte nicht abgeschlossen werden.
• Windows-Datenschutz konnte die Connector-Identität nicht verarbeiten.
• Der Connector hat noch keine gültige Marktzuordnung.
• Der Markt-Snapshot ist ungültig oder noch nicht erzeugt.
• Diese Connector-Registrierung wurde serverseitig gelöscht oder ist nicht mehr gültig. Die lokale Freigabe wurde automatisch zurückgesetzt. Bitte registriere den Connector erneut.
• Für FTP/FTPS werden ftp_host, ftp_username und ftp_queue_directory benötigt.
• Für SFTP werden Server, Benutzername und Queue-Pfad benötigt.
• SFTP-Unterstützung fehlt. Bitte Paramiko installieren oder die aktuelle Connector-EXE verwenden.
• Unbekanntes Format der geschützten Connector-Identität.
• transport muss local, ftp, ftps oder sftp sein.
• Bitte Lokal, FTPS oder FTP als Verbindung wählen.
• Bitte den lokalen Queue-Ordner auswählen.
• Bitte eine vollständige API-Adresse mit https:// eintragen.
• Bitte zuerst einen eigenen, eindeutigen Hof- oder Servernamen eingeben. Der Standardname darf nicht verwendet werden.
• Das Abfrageintervall muss mindestens 0,2 Sekunden betragen.
• Der Client-Typ muss Singleplayer oder Dedicated Server sein.
• Der FTP-Port muss zwischen 1 und 65535 liegen.
• Der Timeout muss mindestens 2 Sekunden betragen.
• Der lokale Queue-Ordner konnte nicht angelegt werden.
• Die Konfigurationsdatei enthält kein gültiges Objekt.
• Bitte Lokal, SFTP, FTPS oder FTP als Verbindung wählen.
• Bitte Lokales Spiel/Host oder Dedicated Server auswählen.
• Bitte den einmaligen Tester-Code aus deinem Discord-Bewerbungsticket eingeben.
• Bitte zuerst einen eigenen, eindeutigen Hof- oder Servernamen eingeben.
• Der Server-Port muss zwischen 1 und 65535 liegen.
• Der Tester-Code hat kein gültiges Format.
• Die feste AgrarMarkt-API-Adresse ist ungültig.
• Die bisherige Connector-Registrierung wurde entfernt. Die lokale Freigabe wurde zurückgesetzt; bitte registriere den Connector erneut.
• Die bisherige Connector-Registrierung wurde entfernt. Die lokale Freigabe wurde zurückgesetzt; bitte registriere den Connector erneut.

API-Fehlercodes nach Bereich#

Die folgenden Codes sind mögliche Serverantworten auf Connector-Anfragen. Der Wortlaut kann je nach Vorgang leicht abweichen; die technische Kennung ist aussagekräftiger. Einige Fehler treten nur bei bereits freigeschalteten Tester-Funktionen auf.

Registrierung und Berechtigung#

• auth_missing (HTTP 401): Authentifizierungsdaten fehlen.
• client_blocked (HTTP 403): Client nicht zugelassen.
• client_unknown (HTTP 403): Client ist nicht registriert.
• installation_mismatch (HTTP 403): Dieser Connector ist an eine andere Installation gebunden. Bitte wende dich an den Support.
• nonce_invalid (HTTP 401): Nonce ungültig.
• replay_detected (HTTP 409): Anfrage wurde bereits verwendet.
• signature_invalid (HTTP 401): Signatur ungültig.
• timestamp_invalid (HTTP 401): Zeitstempel ungültig.
• client_type_invalid (HTTP 422): Client-Typ ungültig.
• display_name_invalid (HTTP 422): Bitte einen eigenen Hof- oder Servernamen verwenden.
• display_name_locked (HTTP 403): Der Server-/Hofname ist nach der ersten Registrierung fest gebunden. Änderungen sind nur über den Support möglich.
• display_name_taken (HTTP 409): Dieser Connector-Name ist bereits registriert. Bitte wende dich an den Support oder verwende beim ersten Start einen anderen eindeutigen Namen. / Dieser Connector-Name wird bereits verwendet.
• installation_id_invalid (HTTP 422): Installations-ID ungültig.
• json_object_required (HTTP 400): JSON-Objekt erwartet.
• maintenance_mode (HTTP 503): AgrarMarkt befindet sich vorübergehend im Wartungsmodus.
• market_closed (HTTP 403): Gebrauchtmarkt und Viehmarkt sind während des öffentlichen Tests geschlossen.
• player_trade_closed (HTTP 403): Spielerhandel ist vorübergehend nicht verfügbar; der genaue Hinweis steht in der Serverantwort.
• registration_closed (HTTP 403): Registrierung ist derzeit geschlossen.
• route_not_found (HTTP 404): Endpunkt nicht gefunden.
• tester_access_not_ready (HTTP 503): Tester-Zugang ist vorübergehend nicht verfügbar.
• tester_already_active (HTTP 409): Dieser Connector ist bereits als Tester registriert.
• tester_code_invalid (HTTP 403): Tester-Code ungültig. Bitte prüfe den Code aus deinem Discord-Bewerbungsticket.
• tester_code_invalid (HTTP 422): Tester-Code ungültig.
• tester_code_revoked (HTTP 403): Dieser Tester-Code wurde gesperrt. Bitte wende dich an den Support.
• tester_code_unavailable (HTTP 403): Tester-Code ungültig oder bereits verbraucht.
• tester_code_used (HTTP 409): Dieser Tester-Code wurde bereits verwendet. Bitte wende dich an den Support.
• tester_required (HTTP 403): Dieser Bereich ist registrierten Testern vorbehalten. / Für diese Funktion benötigst du einen registrierten Tester-Zugang. / Hofkopplung und Online-Lager sind nur für registrierte Tester verfügbar.

Öffentlicher Weltmarkt#

• buy_rate_limit (HTTP 429): Kauf-/Verkaufslimit erreicht; Anzahl und Zeitraum stehen in der Serverantwort.
• sell_rate_limit (HTTP 429): Kauf-/Verkaufslimit erreicht; Anzahl und Zeitraum stehen in der Serverantwort.
• client_not_found (HTTP 404): Client nicht gefunden.
• direction_invalid (HTTP 422): Richtung muss sell oder buy sein.
• fill_type_invalid (HTTP 422): FillType ungültig.
• idempotency_invalid (HTTP 422): Idempotency-Key ungültig.
• liters_invalid (HTTP 422): Menge außerhalb des erlaubten Bereichs.
• market_commit_proof_mismatch (HTTP 409): Marktbestätigung stimmt nicht mit dem Spielserverbeleg überein.
• market_daily_limit (HTTP 429): Das tägliche Handelsvolumen dieser Installation ist erreicht.
• market_replay_detected (HTTP 409): Dieser Spielserverbeleg wurde bereits verwendet.
• product_not_found (HTTP 404): Produkt wird auf diesem Markt nicht gehandelt.
• rate_limit (HTTP 429): Zu viele Transaktionen. Bitte kurz warten.
• stock_insufficient (HTTP 409): Nicht genügend globaler Bestand verfügbar.
• transaction_expired (HTTP 409): Reservierung ist abgelaufen.
• transaction_not_committed (HTTP 409): Diese Transaktion wurde nicht am Markt abgeschlossen.
• transaction_not_found (HTTP 404): Transaktion nicht gefunden.

Spielerhandel, Lager und Transfers#

• auction_bid_required (HTTP 422): Bei einer Auktion muss ein Gebot abgegeben werden.
• auction_closed (HTTP 409): Diese Auktion ist bereits beendet.
• auction_has_bid (HTTP 409): Eine Auktion mit aktivem Gebot kann nicht mehr storniert werden.
• auction_values_invalid (HTTP 422): Menge, Startpreis oder Gebotsschritt ist ungültig.
• barter_same_product (HTTP 422): Beim Tausch müssen zwei unterschiedliche Waren gewählt werden.
• barter_stock_insufficient (HTTP 409): Dir fehlt die verlangte Ware im Online-Marktlager.
• barter_values_invalid (HTTP 422): Die Tauschmengen liegen außerhalb des erlaubten Bereichs.
• bid_invalid (HTTP 422): Gebot ist ungültig.
• bid_too_low (HTTP 409): Das Mindestgebot in € je 1.000 l wurde unterschritten.
• farm_not_active (HTTP 409): Hof ist nicht aktiv verbunden.
• farm_not_found (HTTP 404): Ein beteiligter Hof wurde nicht gefunden. / Hof nicht gefunden.
• fill_type_disabled (HTTP 422): Diese Ware ist am AgrarMarkt derzeit deaktiviert.
• fill_type_invalid (HTTP 422): Produkttyp ungültig.
• goods_[Richtung]_volume_limit (HTTP 429): Stundenlimit für Warentransfers erreicht; die Serverantwort nennt die zulässige Literzahl.
• idempotency_invalid (HTTP 422): Idempotenzschlüssel ungültig.
• listing_closed (HTTP 409): Dieses Angebot ist nicht mehr verfügbar. / Dieses Tauschangebot ist nicht mehr verfügbar.
• listing_forbidden (HTTP 403): Dieses Angebot gehört zu einem anderen Hof.
• listing_not_auction (HTTP 422): Dieser Auftrag ist keine Auktion.
• listing_not_barter (HTTP 422): Dieser Auftrag ist kein Tausch.
• listing_not_found (HTTP 404): Angebot nicht gefunden.
• listing_side_invalid (HTTP 422): Angebotsart muss Verkauf oder Kaufgesuch sein.
• listing_values_invalid (HTTP 422): Menge oder Preis liegt außerhalb des erlaubten Bereichs.
• liters_invalid (HTTP 422): Handelsmenge ungültig.
• minimum_fill (HTTP 422): Gewählte Menge liegt unter der Mindestmenge.
• partial_not_allowed (HTTP 409): Dieses Angebot muss vollständig übernommen werden.
• player_stock_insufficient (HTTP 409): Nicht genügend freie Tauschware im Online-Marktlager. / Nicht genügend freie Ware im Online-Marktlager.
• player_stock_missing (HTTP 409): Keine Ware dieses Typs im Online-Marktlager.
• player_storage_full (HTTP 409): Im Online-Marktlager ist nicht genügend Platz.
• reservation_broken (HTTP 409): Die reservierte Tauschware ist nicht mehr vollständig vorhanden. / Reservierte Verkäuferware ist nicht mehr vollständig vorhanden. / Reserviertes Käuferguthaben ist nicht mehr vollständig vorhanden.
• sale_listing_limit (HTTP 429): Dein Konto darf höchstens [Anzahl] aktive Verkaufsangebote gleichzeitig haben.
• self_bid (HTTP 409): Auf die eigene Auktion kann nicht geboten werden.
• self_trade (HTTP 409): Der eigene Auftrag kann nicht selbst erfüllt werden. / Der eigene Tausch kann nicht angenommen werden.
• transfer_amount_invalid (HTTP 422): Geldbetrag ungültig.
• transfer_commit_proof_mismatch (HTTP 409): Transferbestätigung stimmt nicht mit dem Serverbeleg überein.
• transfer_daily_limit (HTTP 429): Das tägliche Einzahlungslimit dieser Installation ist erreicht.
• transfer_expired (HTTP 409): Transferreservierung ist abgelaufen.
• transfer_goods_invalid (HTTP 422): Ware oder Menge ungültig.
• transfer_not_found (HTTP 404): Transfer nicht gefunden.
• transfer_replay_detected (HTTP 409): Dieser Serverbeleg wurde bereits verwendet.
• transfer_type_invalid (HTTP 422): Transferart ungültig.
• wallet_balance_limit (HTTP 409): Das Marktguthaben hat seine Obergrenze erreicht; zahle zuerst Guthaben ins Spiel aus.
• wallet_insufficient (HTTP 409): Nicht genügend verfügbares Marktguthaben für dieses Gebot. / Nicht genügend verfügbares Marktguthaben.
• [Vorgang]_[Richtung]_rate_limit (HTTP 429): Kauf-/Verkaufslimit erreicht; Anzahl und Zeitraum stehen in der Serverantwort.

Gebrauchtmarkt (Vorschau)#

• farm_not_linked (HTTP 409): Der Hof muss zuerst mit einem laufenden Connector verbunden werden. / Der Käuferhof muss zuerst mit dem Connector verbunden werden.
• idempotency_key_missing (HTTP 422): Idempotency-Key fehlt.
• vehicle_already_listed (HTTP 409): Dieses Fahrzeug ist bereits im Gebrauchtmarkt. / Ein identisches Fahrzeug deines Hofes ist bereits im Gebrauchtmarkt oder wird gerade übertragen.
• vehicle_category_invalid (HTTP 422): Das Objekt konnte nicht als Fahrzeug oder Anbaugerät bestätigt werden.
• vehicle_listing_demo_only (HTTP 409): Dieses Beispielangebot kann nicht gekauft werden.
• vehicle_listing_not_found (HTTP 404): Fahrzeugangebot nicht gefunden.
• vehicle_listing_unavailable (HTTP 409): Eigenes Angebot ist nicht mehr abrufbar. / Fahrzeug ist nicht mehr verfügbar.
• vehicle_market_closed (HTTP 403): Der Gebrauchtmarkt befindet sich im geschützten Testbetrieb. Angebote können angesehen, aber noch nicht gekauft oder verkauft werden.
• vehicle_market_not_ready (HTTP 503): Fahrzeugmarkt ist noch nicht eingerichtet.
• vehicle_object_not_tradeable (HTTP 422): Dieses Verbrauchsgut ist kein Fahrzeug oder Anbaugerät. / Paletten, BigBags, Ballen und Verbrauchsgüter dürfen nicht im Fahrzeugmarkt angeboten werden.
• vehicle_own_listing (HTTP 409): Das eigene Fahrzeug kann nicht gekauft werden.
• vehicle_payload_invalid (HTTP 422): Dieses Fahrzeug wird im Test noch nicht unterstützt.
• vehicle_payload_missing (HTTP 422): Fahrzeugdaten fehlen.
• vehicle_price_invalid (HTTP 422): Fahrzeugpreis ist ungültig.
• vehicle_transfer_not_found (HTTP 404): Fahrzeugtransfer nicht gefunden.
• wallet_insufficient (HTTP 409): Marktguthaben reicht nicht aus.

Wenn du Hilfe benötigst#

Notiere die genaue Meldung, Uhrzeit, Mod- und Connector-Version, ob du Singleplayer oder Multiplayer nutzt und die betroffene Ware. Teile bei einem fehlgeschlagenen Auftrag den Namen der Queue-Datei mit, aber veröffentliche keine Tester-Codes oder Zugangsdaten. Bei einem 409-Fehler helfen besonders die unmittelbar vorhergehenden Protokollzeilen.

Reine INFO-Zeilen wie „Transaktion vorbereitet“ oder „Transaktion abgeschlossen“ sind keine Fehlermeldung. Allgemeine Windows-, Netzwerk- und Datei-Fehler können zusätzliche, vom System abhängige Texte enthalten.