Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
vorgaenge:xrechnung [2023/03/03 08:18] – Andrea Müller | vorgaenge:xrechnung [2025/08/15 08:22] (aktuell) – [XRechnung.ini] Andrea Müller |
---|
====== Rechnungsversand per XRechnung ====== | ====== Rechnungsversand per XRechnung ====== |
| |
XRechnung ist ein XML-basiertes Format, das als Standard für elektronische Rechnungen aktuell etabliert wird, die an die öffentlichen Auftraggeber in Deutschland gesendet werden. | Die XRechnung, ein XML-basiertes Format, ist der aktuelle Standard für elektronische Rechnungen an öffentliche Auftraggeber in Deutschland. |
| |
| [[vorgaenge:xrechnung:felder|Hier]] finden Sie eine Übersicht der aktuell unterstützten Felder. |
| |
<html> | <html> |
<p><a href="doku.php?id=mandanten:konfigurationen" style="color:#56B04F;">Konfiguration</a> | <p><a href="doku.php?id=mandanten:konfigurationen" style="color:#56B04F;">Konfiguration</a> |
| |
521: Modulfunktionen in MPS Meldungen ausblenden<br><br>Sollen die Modulfunktionen "Ticket anlegen", "Vorgang anlegen" oder "Serviceauftrag anlegen" im Modul MPS Meldungen ausgeblendet werden, geschicht dies über die Eingabe des Kürzels TT, VO oder TA in der textuellen Einstellung. Bei mehreren Funktionen müssen die Kürzel durch Komma getrennt werden. | 522: Version XRechnung<br><br>Angabe der Version XRechnung |
</p><ul style="color: #333333;"> | </p><ul style="color: #333333;"> |
| |
<li> 0 - Nein, keine Funktionalität ausblenden | <li> 0 - aktuelle Version (aktuell implementierte Version) |
<li> 1 - Ja | <li> 1 - lt. Einstellung textuell |
| |
</ul> | </ul> |
| |
| |
<note warning>Da die XRechnungsversion halbjährlich aktualisiert werden, ist es zwingend notwendig, CO regelmäßig zu upzudaten. Nur dadurch kann gewährleistet werden, dass das Portal die XRechnung nicht ablehnt.</note> | <note warning>Da die XRechnungsversion halbjährlich aktualisiert werden, ist es zwingend notwendig, CO regelmäßig zu atualisieren. Nur dadurch kann gewährleistet werden, dass das Portal ihres Auftraggebers die XRechnung nicht ablehnt.</note> |
| |
| |
===== Einrichtung XRechnung ===== | ===== Einrichtung XRechnung ===== |
Für die Neuanlage wählen Sie im Grid in einer neuen Zeile die Gruppenart "Kundengruppe" im Drop-Down-Menü aus. Der Name XRechnung wird in der Spalte "Name" eingetragen. Das $ setzt sich automatisch nach dem Aktualisieren vor den Namen. | Für die Neuanlage wählen Sie im Grid in einer neuen Zeile die Gruppenart "Kundengruppe" im Drop-Down-Menü aus. Der Name XRechnung wird in der Spalte "Name" eingetragen. Das $ setzt sich automatisch nach dem Aktualisieren vor den Namen. |
| |
{{:vorgaenge:druckmanager-kundengruppe.png?direct&600|}} | {{:vorgaenge:druckmanager-kundengruppe.png|}} |
| |
Um nun dieser Gruppe Kunden hinzuzufügen, haben Sie zwei Möglichkeiten: | Um nun dieser Gruppe Kunden hinzuzufügen, haben Sie zwei Möglichkeiten: |
* Im //Druck-Manager// im Reiter "Gruppen und Mitglieder" können Sie nach Auswahl der Gruppe im unteren Abschnitt der Seite Kunden hinzufügen. | * Im //Druck-Manager// im Reiter "Gruppen und Mitglieder" können Sie nach Auswahl der Gruppe im unteren Abschnitt der Seite Kunden hinzufügen. |
* Dies geschieht über die Fernglas-Suche oder die Eingabe der Kundennummer. | * Dies geschieht über die Fernglas-Suche oder die Eingabe der Kundennummer. |
{{:vorgaenge:druckmanager-kunde-hinzufuegen-neu.png?direct&600|}} | {{:vorgaenge:druckmanager-kunde-hinzufuegen-neu.png|}} |
| |
2. über das Modul //Firmen//: | 2. über das Modul //Firmen//: |
* Wählen Sie einen Kunden aus und öffnen den Reiter "Kundendaten". | * Wählen Sie einen Kunden aus und öffnen den Reiter "Kundendaten". |
* Im Abschnitt "Allgemein" befindet sich die Auswahlmöglichkeit für die Druck-Kundengruppe. | * Im Abschnitt "Allgemein" befindet sich die Auswahlmöglichkeit für die Druck-Kundengruppe. |
{{:vorgaenge:firmen_druckkundengruppe.png?direct&600|}} | {{:vorgaenge:firmen_druckkundengruppe.png|}} |
| |
<note warning>Der Kunde, welcher die XRechnung erhalten soll, darf nur einer Email-Gruppe im Kontext von Rechnungen angehören!</note> | <note warning>Der Kunde, welcher die XRechnung erhalten soll, darf nur einer Email-Gruppe im Kontext von Rechnungen angehören!</note> |
* Kundengruppe – $XRechnung | * Kundengruppe – $XRechnung |
* Drucker – $EmailXRechnung | * Drucker – $EmailXRechnung |
* Absendeadresse – z.B. sendermail: xrechnung@firmenname.de, diese E-Mail-Adresse (welche im Portal als Rechnungs-Mail hinterlegt wurde) muss zwingend in der Spalte "Zusatzparameter" eingetragen werden | * Absenderadresse – z.B. sendermail: xrechnung@firmenname.de, diese E-Mail-Adresse (welche im Portal als Rechnungs-Mail hinterlegt wurde) muss **zwingend** in der Spalte "Zusatzparameter" eingetragen werden |
* Absender-Telefonnummer - z.B. senderphone: +49 123 / 456789 | * Absender-Telefonnummer - z.B. senderphone: +49 123 / 456789 //(wird verwendet, wenn am Sachbearbeiter keine Telefonnummer hinterlegt ist)// |
* Absendername - z.B. sendername: Max Müller | * Absendername - z.B. sendername: Max Müller //(Rückfallvariante, wenn 1. Sachbearbeiter am Auftrag/Vertrag=0 und/oder 2. angemeldeter Mitarbeiter/Sachbearbeiter keine qualifizierten Namensinformationen trägt)// |
| |
Sollen mehrere Informationen vorgegeben werden, werden die Informationen mit Komma getrennt in die Spalte "Zusatzparameter" eingetragen - z.B. sendermail: xrechnung@firmenname.de, senderphone: +49123/456789, sendername: Max Müller | Sollen mehrere Informationen vorgegeben werden, werden die Informationen mit Komma getrennt in die Spalte "Zusatzparameter" eingetragen - z.B. sendermail: xrechnung@firmenname.de, senderphone: +49123/456789, sendername: Max Müller |
Die Leitweg ID wird unter **Stammdaten** im Modul //Firmen// im Reiter "Mitarbeiter/Weiteres" in die Tabelle "Externe Kundennummern" in die Spalte "Fremdnummer" eingetragen. | Die Leitweg ID wird unter **Stammdaten** im Modul //Firmen// im Reiter "Mitarbeiter/Weiteres" in die Tabelle "Externe Kundennummern" in die Spalte "Fremdnummer" eingetragen. |
| |
{{:vorgaenge:firmen-leitwegid.png?direct&500|}} | {{:vorgaenge:firmen-leitwegid.png|}} |
| |
| Die Leitweg-ID ist nicht als Pflichtfeld bei der Ausgabe von XRechnungen ausgelegt. |
| Ist diese am Kunden bzw. der Anschrift nicht angegeben, setzt CO automatisch den Wert '(keine Zuordnung)‘ dafür ein. |
| |
| Es kann zudem ein individueller Standardwert (z.B. 'unbekannt‘) in der Konfigurationsdatei '< SysDataPfad > \ ImportExport \ XRechnung.ini‘ festgelegt werden: |
| |
| <code> |
| |
| [General] |
| BT-10=#unbekannt |
| |
| </code> |
| |
| |
| <note important>Beachten Sie bitte, dass die Leitweg-ID weiterhin bei Rechnungen für Behörden Pflicht ist und in den Stammdaten gepflegt werden muss.</note> |
| |
| |
| |
| Um die Angabe der Leitweg-ID in den Stammdaten zur Pflicht zu machen, muss ein leerer Standardwert in der XRechnung.ini hinterlegt werden. |
| Dann wird der Rechnungsdruck mit Ausgabe als XRechnung mit einem Fehler abgebrochen, wenn keine Leitweg-ID in den Stammdaten hinterlegt ist. |
| |
| <code> |
| |
| [General] |
| BT-10=# |
| </code> |
| |
| |
| |
| |
Die Portal-E-Mail wird ebenfalls im Modul //Firmen// eingetragen. Dafür öffnen Sie den Reiter "Eingabe". Unter "Verbindungen" wird die Ziel-Email in der Spalte "RechnungsMail" hinterlegt. | Die Portal-E-Mail wird ebenfalls im Modul //Firmen// eingetragen. Dafür öffnen Sie den Reiter "Eingabe". Unter "Verbindungen" wird die Ziel-Email in der Spalte "RechnungsMail" hinterlegt. |
| |
{{:vorgaenge:firmen-zielemail.png?direct&500|}} | {{:vorgaenge:firmen-zielemail.png|}} |
| |
==== Email-Einstellungen ==== | ==== Email-Einstellungen ==== |
Wenn die XRechnung über Outlook versendet werden soll, muss unter **Administration** im Modul //E-Mail Einstellungen// der E-Mail Client entsprechend ausgewählt werden. Dadurch wird bei dem Rechnungsdruck die XRechnung in den Ordner Entwürfe im Outlook gelegt und muss manuell gesendet werden. | Wenn die XRechnung über Outlook versendet werden soll, muss unter **Administration** im Modul //E-Mail Einstellungen// der E-Mail Client entsprechend ausgewählt werden. Dadurch wird bei dem Rechnungsdruck die XRechnung in den Ordner Entwürfe im Outlook gelegt und muss manuell gesendet werden. |
| |
{{:vorgaenge:email-einrichten.png?direct&600|}} | {{:vorgaenge:email-einrichten.png?600|}} |
| |
Soll die Rechnung über SMTP verschickt werden, muss unter dem Reiter "Smtp-Server" der Server entsprechend eingerichtet werden. Die XRechnung wird dadurch bei Rechnungsdruck sofort an den entsprechenden Empfänger gesendet. Hier muss in der Spalte Absender die einheitliche E-Mail Adresse (z.B. xrechnung@software-concept.de) eingetragen werden. Zusätzlich muss unter dem Reiter "E-Mail Einstellungen" der SMTP E-Mail Client ausgewählt werden. | Soll die Rechnung über SMTP verschickt werden, muss unter dem Reiter "Smtp-Server" der Server entsprechend eingerichtet werden. Die XRechnung wird dadurch bei Rechnungsdruck sofort an den entsprechenden Empfänger gesendet. Hier muss in der Spalte Absender die einheitliche E-Mail Adresse (z.B. xrechnung@software-concept.de) eingetragen werden. Zusätzlich muss unter dem Reiter "E-Mail Einstellungen" der SMTP E-Mail Client ausgewählt werden. |
Es wird geprüft, ob der im Auftrag bzw. Vertrag hinterlegte Geschäftsbereich (am Vertrag: der Geschäftsbereich für Miete, Wartung oder Klicks, je nach dem was im Vertrag hinterlegt wurde) auf eine Filiale verweist. | Es wird geprüft, ob der im Auftrag bzw. Vertrag hinterlegte Geschäftsbereich (am Vertrag: der Geschäftsbereich für Miete, Wartung oder Klicks, je nach dem was im Vertrag hinterlegt wurde) auf eine Filiale verweist. |
| |
{{:vorgaenge:geschaeftsbereich-filiale.png?500|}} | {{:vorgaenge:geschaeftsbereich-filiale.png?800|}} |
| |
Ist dies der Fall, so wird die Anschrift für die XRechnungs-Ausgabe nicht dem Mandanten, sondern der Filiale entnommen. | Ist dies der Fall, so wird die Anschrift für die XRechnungs-Ausgabe nicht dem Mandanten, sondern der Filiale entnommen. |
| |
{{:vorgaenge:filiale.png?500|}} | {{:vorgaenge:filiale.png|}} |
| |
Ist an der Filiale eine Kundennummer hinterlegt, so wird anhand dieser die Umsatzsteuer-ID ermittelt. | Ist an der Filiale eine Kundennummer hinterlegt, so wird anhand dieser die Umsatzsteuer-ID ermittelt. |
Hierfür muss in den weiteren Anschriften im Reiter //"Weiteres"// im Abschnitt "Warenwirtschaftsdaten" die geltende Leitweg-ID eingetragen werden. Wenn dieses Feld nicht ausgefüllt wird, greift CO automatisch auf die hinterlegte Leitweg-ID im Modul //Firmen// zurück. | Hierfür muss in den weiteren Anschriften im Reiter //"Weiteres"// im Abschnitt "Warenwirtschaftsdaten" die geltende Leitweg-ID eingetragen werden. Wenn dieses Feld nicht ausgefüllt wird, greift CO automatisch auf die hinterlegte Leitweg-ID im Modul //Firmen// zurück. |
| |
{{:vorgaenge:anschrift-leitweg-id.png?500|}} | {{:vorgaenge:anschrift-leitweg-id.png?800|}} |
| |
Gleiches gilt am Vertrag für Miete, Wartung oder Klick, je nachdem was in der Vertragsart freigegeben ist. | Gleiches gilt am Vertrag für Miete, Wartung oder Klick, je nachdem was in der Vertragsart freigegeben ist. |
| |
Ist die Leitweg-ID an der Anschrift leer, so wird die am Kunden hinterlegte Leitweg-ID verwendet. | Ist die Leitweg-ID an der Anschrift leer, so wird die am Kunden hinterlegte Leitweg-ID verwendet. |
| |
| ==== Stornorechnung XRechnung ==== |
| |
| Es gibt die Möglichkeit einzustellen, dass bei Storno einer Rechnung im Modul **Formulardruck** für Kunden, die XRechungen empfangen, eine Storno-XRechnung ausgegeben wird. Hierfür muss als Zusatzparameter //'stornobeleg:1'// in die Rechnungszeile im Druck-Manager eingetragen werden. |
| |
| Als < InvoiceTypeCode > wird dann der Wert 384 übergeben. Außerdem wird der Knoten <BillingReference> mit der ursprünglichen Rechnungsnummer befüllt. Als ID für die Stornorechnung wird die ursprüngliche Rechnungsnummer mit einem angehängten 'S' ausgegeben. |
| |
| ===== XRechnung.ini ===== |
| |
| Im Verzeichnis <SysData>\ImportExport wird die Datei XRechnung.ini unterstützt. Für ausgewählte X-Rechnungs-ID (BT-xx) können Werte angegeben werden, die die Verarbeitung steuern. |
| |
| <note>Ist die Steuerdatei nicht vorhanden, dann erfolgt die Ausgabe wie dem Wert 0 entsprechend.</note> |
| |
| === Per .ini steuerbare Felder === |
| ^Feldnummer ^Feldname ^CO-Punkt ^ ab Version ^Inhalt ^Verfügbar ab| |
| |BT-10 |Leitweg-ID | CO-44419 | 8.0 | siehe - [[vorgaenge:xrechnung#Leitweg-ID und Ziel-Email|Leitweg-ID]] | 8.2752.107 | |
| |BT-45 |Buyer electronic adress| CO-41589 | 7.0 | Externe Kostenstelle \\ 0 - Name Rechnungsempfänger \\ 1 - Ausgabe der Kostenstelle | 7.0.6635 | |
| |BT-70 |Deliver to Party name | CO-40919 | 8.0 | Name abweichende Lieferanschrift \\ 0 - nicht ausgeben \\ 1 - ausgeben | 8.1337.85 | |
| |BT-126|Invoice line identifier| CO-42154/CO-42314 | 7.0 | Vertragsabrechnungen\Vertragsabrechnungskorrekturen \\ 0 - interne Rechnung-Positionsnummer \\ 1 - Ausgabe MaschinenNr, SerinenNr, Stellplatz | 7.0.6652 / 8.1771.0 | |
| |
| Angaben können erfolgen: |
| |
| * global |
| * pro Mandant |
| * pro Kunde |
| |
| Bei der Ermittlung werden die gültigen Einstellungen kombiniert. |
| |
| **Beispiel:** |
| |
| Aktuell unterstützt wird ID ‚BT-70’, die im Rahmen einer kostenpflichtigen Anpassung (Name abweichende Lieferanschrift) implementiert wurde. |
| |
| Standardmäßig wird ‚BT-70‘ ausgegeben (falls keine XRechnung.ini) vorhanden ist. BT-70=1 wird ausgeben BT-70=0 wird unterdrückt (wie ohne .ini). |
| |
| <code> |
| |
| ; Steuert die Ausgabe der XRechnungen |
| ; Datei muss nicht vorhanden sein, dann greifen die programmseitigen Standardwerte |
| |
| |
| ; globale Einstellungen |
| [General] |
| |
| ;Deliver to party name BT-70 Text 0..1 58 |
| ;Der Name des Empfängers, an den die Waren geliefert bzw. für den die Dienstleistungen erbracht werden. |
| ;Das Informationselement ist zu verwenden, wenn der Empfänger vom Erwerber abweicht. |
| ; 1-ausgeben 0-nicht ausgeben |
| BT-70=1 |
| |
| ; Einstellungen für Mandant 98, übersteuert globale Einstellungen |
| [General_98] |
| BT-70=0 |
| |
| ; Einstellungen für Kunden 61, übersteuert globale und Mandanteneinstellungen |
| [Kunde_61] |
| ; Ausgabe unterdrücken |
| BT-70=0 |
| |
| </code> |