Sage X3: 3. Import-Vorlagen

Administrationsrechte nötig8 Min.Zuletzt aktualisiert: 25.08.2026

Bisher ging es um den Weg aus Sage X3 heraus. Es geht auch andersherum: Eine Adresse, die Sie in checkITeasy anlegen, kann als Kunde in Sage X3 entstehen. Dafür nutzt der Sync dieselben Vorlagen, nur in der anderen Richtung. Sage X3 prüft die Daten dabei genauso streng wie bei der Erfassung von Hand, und was es ablehnt, landet im Zwischenspeicher.

Die Felder, die Sie ergänzen sollten

Ein Feld brauchen beide Seiten, damit sie sich wiederfinden: die Nummer des checkITeasy-Datensatzes. Sage X3 hat dafür an der Adresse ein passendes Feld, es steht nur nicht in der Vorlage. Weitere Felder braucht es, wenn E-Mail und Website der Adresse, E-Mail und Mobilnummer der Ansprechpartner oder die Texte der Abrechnungspositionen mitwandern sollen.

Was dazukommt

VorlageKennzeichenTabelleFeldBedeutung
BPCABPADDRESSWEB(0)Die E-Mail-Adresse der Adresse. Dasselbe Feld nutzt auch der Weg aus Sage X3 heraus — einmal ergänzt, wirkt es in beide Richtungen.
BPCABPADDRESSFCYWEBDie Website der Adresse. Ebenfalls für beide Richtungen.
BPCABPADDRESSEXTNUMDie Nummer der Adresse aus checkITeasy. Damit lässt sich ein Kunde seinem Ursprung zuordnen, auch wenn beim Anlegen etwas schiefgeht.
BPCCCONTACTWEBDie E-Mail-Adresse des Ansprechpartners. Der Block führt sie nicht, ohne das Feld bleibt sie in Sage X3 leer.
BPCCCONTACTMOBDie Mobilnummer des Ansprechpartners. Ebenfalls nicht im Block enthalten.
SIHIMPCALLSINVOICEDITMDESDie Bezeichnung 1 der Abrechnungsposition. Ohne dieses Feld setzt Sage X3 in die Belegzeile die Bezeichnung aus dem Artikelstamm.
SIHIMPCALLSINVOICEDITMDES1Der Dimensionstext der Abrechnungsposition. Achtung: Das Feld fasst nur 30 Zeichen, längere Texte werden abgeschnitten — siehe FAQ.

So wird die Kundennummer vergeben

Sage X3 vergibt die Kundennummer in dieser Einrichtung nicht selbst, es verlangt sie beim Import. Deshalb bildet der Abgleich sie nach der Regel, die Ihr Bestand vorgibt: das Länderkürzel der Adresse und eine laufende Nummer. Aus einer neuen deutschen Adresse wird also der nächste freie Eintrag hinter DE033. Die Nummer schreibt er anschließend als ExterneId zurück; ab da gelten Änderungen als Aktualisierung.

Was Sage X3 beim Import prüft

FeldBedeutung
RufnummernGegen das Format des Landes. Für Deutschland sind es genau vierzehn Ziffern ohne Trennzeichen, deshalb entfernt der Abgleich alles außer Ziffern. Eine Nummer, die Ländervorwahl und Amtsnull mischt, weist Sage X3 ab.
PflichtfelderFehlt eine Angabe, nennt Sage X3 das Feld beim Namen und lehnt den ganzen Satz ab. Angelegt wird dann nichts.
Abgewiesene SätzeLanden im Zwischenspeicher unter „Import-/Exportvorlagen Zwischenspeicher" (GESAOW). Dort sehen Sie die Zeile und können sie korrigieren.

Adressen nach Sage X3 einschalten

  1. Ergänzen Sie die Felder aus der Tabelle in Sage X3, jeweils als letzte Zeile ihres Blocks. So behalten alle vorhandenen Felder ihre Position.

  2. Tragen Sie die Position in checkITeasy in der Feldzuordnung nach, als Schlüssel aus Kennzeichen, Punkt und Feldname — also „A.WEB", „A.FCYWEB", „A.EXTNUM", „C.WEB", „C.MOB" beziehungsweise „L.ITMDES" und „L.ITMDES1" im Abschnitt der Vorlage SIHIMPCAL.

  3. Starten Sie den SOAP-Pool neu. Er merkt sich die Feldliste beim Start und liefert sonst weiter die alte Fassung.

  4. Setzen Sie in der Administration den Eintrag „Adressen nach Sage X3" auf aktiv.

  5. Tragen Sie bei der Adresse als ExterneId das Wort „Sync" ein. Daran erkennt der Dienst, dass der Datensatz in Sage X3 noch nicht existiert.

  6. Setzen Sie an der Adresse den Haken für die Übertragung und stoßen Sie den Abgleich an.

  7. Prüfen Sie in Sage X3, ob der Kunde da ist, und in checkITeasy, ob die Nummer zurückgeschrieben wurde.

Aus Abrechnungen werden Rechnungen

Eine freigegebene Abrechnung wird in Sage X3 zur Ausgangsrechnung, samt aller Positionen. Die Nummer vergibt Sage X3 aus dem Nummernkreis und der Abgleich schreibt sie in die Abrechnung zurück. Möglich macht das ein Verweis, den der Beleg trägt: Sage X3 meldet die Nummer beim Import nicht zurück, also findet der Abgleich sie über diesen Verweis wieder. Derselbe Verweis verhindert doppelte Belege — auch wenn ein Lauf zwischen Anlegen und Quittieren abbricht.

Was in der Rechnung landet

FeldBedeutung
StandortAus der Einstellung „x3Standort". Bleibt sie leer, nimmt Sage X3 den Standort des technischen Benutzers — und der passt selten zum Kunden.
KundeDas Konto der Abrechnung mit seiner Kundennummer aus Sage X3.
WährungDie des Kunden, gelesen aus dem Kundenstamm in Sage X3. Die Abrechnung führt keine, der Import verlangt sie.
PositionenArtikel, Menge, Preis und Rabatt. Die Verkaufseinheit holt der Abgleich aus dem Artikelstamm — auch sie verlangt der Import an jeder Zeile.
PreisDer Einzelpreis aus der Abrechnung. Ist an der Position „Preisermittlung extern" gesetzt, gilt stattdessen der Verkaufspreis aus dem Artikelstamm in Sage X3 — sonst entstünde eine Rechnung über 0,00.
  1. Öffnen Sie in der Administration unter Sage X3 die „Feldzuordnung (JSON)".

  2. Setzen Sie im Abschnitt „entitaeten" den Eintrag mit der id „abrechnungen-nach-x3" auf aktiv. Bei „x3Objekt" muss SIHIMPCAL stehen.

  3. Tragen Sie bei „x3Standort" Ihren Vertriebsstandort ein, zum Beispiel DE012.

  4. Geben Sie eine einzelne Abrechnung frei, merken Sie sie zur Übertragung vor und stoßen Sie den Abgleich an.

  5. Prüfen Sie in Sage X3 die entstandene Rechnung und in checkITeasy, ob die Belegnummer in der Abrechnung steht.

Legt Sage X3 die Kundennummer nicht selbst an?
In dieser Einrichtung nicht. Beim Import verlangt Sage X3 die Nummer als Pflichtangabe, weil am Kundenobjekt kein Nummernkreis hängt. Bei Ansprechpartnern ist es umgekehrt, deren Nummer vergibt Sage X3 selbst.
Was passiert bei einer Adresse ohne Land?
Der Abgleich kann dann keine Nummer bilden und überspringt die Adresse mit einer Meldung im Protokoll. Tragen Sie das Land nach, dann läuft sie beim nächsten Durchgang mit.
Kann ich bestehende Kunden aus checkITeasy heraus ändern?
Ja. Sobald eine Adresse eine ExterneId trägt, gilt jede Übertragung als Änderung des vorhandenen Kunden. Angelegt wird nur, was noch keine Nummer hat.
Warum nicht die Exportvorlage SIH für die Rechnungen?
Weil sie zum Lesen gebaut ist. Mehrere Felder, die der Import als Pflicht verlangt, führt sie nicht — Rechnungsart, Zahlungspartner und Währung. SIHIMPCAL ist Sages Vorlage für den Rechnungsimport und führt alles Nötige, auch das Verweisfeld für die Belegnummer.
Der Abgleich meldet „Feld … : Eingabe erforderlich". Was fehlt?
Sage X3 prüft den Import genauso streng wie die Erfassung von Hand und nennt das fehlende Feld beim Namen. Am häufigsten fehlt der Standort: Ohne „x3Standort" landet die Rechnung beim Standort des technischen Benutzers, und der verlangt womöglich Angaben, die zu Ihrem Kunden nicht passen. Prüfen Sie außerdem, ob der Kunde in Sage X3 vollständig gepflegt ist.
Die Rechnung in Sage X3 steht auf 0,00 €.
Dann trugen die Positionen keinen Preis. Prüfen Sie, ob an der Abrechnungsposition „Preisermittlung extern" gesetzt ist: In diesem Fall holt der Abgleich den Verkaufspreis aus dem Artikelstamm in Sage X3, und der Artikel braucht dort einen. Ist der Haken nicht gesetzt, zählt der Einzelpreis aus der Abrechnung.
Die Rechnung ist in Sage X3 da, in checkITeasy fehlt aber die Belegnummer.
Dann konnte der Abgleich den Verweis nicht wiederfinden. Prüfen Sie in der Feldzuordnung, ob bei „x3Objekt" SIHIMPCAL steht und der Abschnitt „SIHIMPCAL" mit den Feldpositionen vorhanden ist. Die Abrechnung bleibt so lange vorgemerkt; ein zweiter Beleg entsteht dabei nicht.
Mein Dimensionstext ist länger als 60 Zeichen. Wie bekomme ich ihn vollständig in den Beleg?
Über die Importvorlage gar nicht. Die Verkaufsrechnungszeile in Sage X3 hat nur zwei Textfelder mit je 30 Zeichen; längere Texte gehören dort in den Langtext, und den kann keine Import-/Exportvorlage beschreiben. Reine Kommentarzeilen ohne Artikel gibt es in Sage X3 ebenfalls nicht. Dafür braucht es eine Anpassung auf Seiten Sage X3, die den Langtext zur Belegzeile schreibt und als Webservice bereitsteht.

Passt dazu