tbz-repos/aktuelle.kurse
1
0
Fork 0
mirror of https://gitlab.com/harald.mueller/aktuelle.kurse.git synced 2024-10-19 09:55:03 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
de39f38f91
aktuelle.kurse/m122/uebungs-aufgaben/ebill_1_handwerkerrechnungen/README.md

410 lines
12 KiB
Markdown
Raw Normal View History

muh
2023-02-06 20:06:56 +01:00
# LB2
muh
2023-01-17 11:21:58 +01:00
muh
2023-01-17 11:59:43 +01:00
## ebill von Handwerkerrechnungen
muh
2023-01-17 11:21:58 +01:00
muh
2023-02-08 00:01:05 +01:00
### Ausgangslage, Ihr "Use Case"
muh
2023-01-17 11:59:43 +01:00
Sie arbeiten in einer Firma, die sich zum Ziel gesetzt hat,
für ihre Kunden und auch um neue Kunden zu gewinnen, die
Rechnungen, die die Handwerker für deren Kunden erstelle,
den elektronischen Zahlungsweg anzubieten.
muh
2023-01-17 12:02:41 +01:00
Der elektronische Zahlungsweg wird nicht über das Verschicken
einer PDF-Rechnung gemacht, wo der Kunde die Rechnung über das
Eintippen der Zahlungsdaten im eBanking machen muss, sondern als
muh
2023-01-17 14:42:34 +01:00
[ebill](https://ebill.ch). Also als eine Rechnung, die dem Kunden
des Handwerkers direkt in sein eBanking hineingeschickt wird und
von dort aus direkt mit zwei Klicks bezahlt werden kann.
muh
2023-01-17 14:40:53 +01:00
muh
2023-02-08 00:01:05 +01:00
**Resultat**
muh
2023-02-08 00:18:05 +01:00
![x-ressourcen/example-qr-bill-de.six-image.original.1020.png](x-ressourcen/example-qr-bill-de.six-image.original.1020.png)
muh
2023-02-08 00:01:05 +01:00
## Aufgabenstellung
![ebill-uebersicht.jpg](x-ressourcen/ebill-uebersicht.jpg)
Sie bekommen auf dem System des Rechnungsstellers in einem
eigenen Format direkt von den Kassensystemen Rechnungsdateien
mit allen Informationen, die es für die Rechnungsstellung
über e-Bill braucht.
Sie holen diese per FTP ab und erstellen daraus
- 1.) eine Rechnung im Klartext (Zur Vereinfachung nur als Text-Format, produktiv wäre das ein PDF)
- 2.) eine Rechnung im XML-Format für das SIX-PaymentServices-Format (Schweizer Marktleader)
Diese beiden Dateien geben Sie per FTP in das «Zahlungssystem» ab.
Dann erfolgt, für Sie im Hintergrund die Weiterleitung
ins Bankensystem. Ob das geklappt hat, wissen Sie erst,
in dem das Zahlungssystem eine Quittungsdatei produziert
hat und Ihnen zur Verfügung stellt.
Ihrem Kunden (dem Rechnungssteller =Biller) stellen Sie
diese Quittungsdatei sowohl per E-Mail wie auch im
Rechnungsstellungs-System in einem Archiv (.zip) zur
Verfügung, damit er überprüfen kann, ob die Rechnung
korrekt verschickt wurde.
**Biller-System**
Sie bekommen vom Biller-Sytem **eine oder mehrere** solche
Dateien
muh
2023-02-08 00:04:39 +01:00
muh
2023-02-08 00:01:05 +01:00
Dateiname: rechnung21003.data
Rechnung_21003;Auftrag_A003;Zürich;21.07.2021;10:22:54;ZahlungszielInTagen_30
Herkunft;41010000001234567;K821;Adam Adler;Bahnhofstrasse 1;8000 Zuerich;CHE-111.222.333 MWST;harald.mueller@tbz.ch
Endkunde;41301000000012497;Autoleasing AG;Gewerbestrasse 100;5000 Aarau
RechnPos;1;Einrichten E-Mailclients;5;25.00;125.00;MWST_0.00%
RechnPos;2;Konfig & Schulung Scanningcnter;1;1000.00;1000.00;MWST_0.00%
Erstellen müssen Sie 2 Files:
- ein TXT-File
- ein XML-File
Die Dateinamen werden aus den Daten der .data-Files gebildet:
muh
2023-02-08 00:18:05 +01:00
<br>(aus Kundennummer K821 und aus der Rechnungsnummer 21003)
muh
2023-02-08 00:01:05 +01:00
muh
2023-02-08 00:18:05 +01:00
<br>Dateiname: K821_21003_invoice.txt
<br>Dateiname: K821_21003_invoice.xml
muh
2023-02-08 00:01:05 +01:00
Inhalt von K821_21003_invoice.txt:
(auf den QR-Code im Einzahlungsschein-Bereich wird hier vwerzichtet)
muh
2023-02-08 00:18:05 +01:00
-------------------------------------------------
muh
2023-02-08 00:01:05 +01:00
Adam Adler
Bahnhofstrasse 1
8000 Zuerich
CHE-111.222.333 MWST
Uster, den 21.07.2021 Autoleasing AG
muh
2023-02-08 00:04:39 +01:00
Gewerbestrasse 100
5000 Aarau
muh
2023-02-08 00:01:05 +01:00
Kundennummer: K821
Auftragsnummer: A003
Rechnung Nr 21003
-----------------------
1 Einrichten E-Mailclients 5 25.00 CHF 125.00 0.00%
2 Konfig & Schulung Scanningcenter 1 1200.00 CHF 1200.00 0.00%
-----------
Total CHF 1325.00
MWST CHF 0.00
Zahlungsziel ohne Abzug 30 Tage (20.08.2021)
Empfangsschein Zahlteil
muh
2023-02-08 00:04:39 +01:00
Adam Adler ------------------------ Adam Adler
Bahnhofstrasse 1 | | Bahnhofstrasse 1
8000 Zuerich | | 8000 Zuerich
| |
| |
00 00000 00000 00000 00000 | | 00 00000 00000 00000 00000
| |
Autoleasing AG | | Autoleasing AG
Gewerbestrasse 100 | | Gewerbestrasse 100
5000 Aarau | | 5000 Aarau
------------------------
muh
2023-02-08 00:01:05 +01:00
--------------------
muh
2023-02-08 00:18:05 +01:00
<br>
<br>
<br>
muh
2023-02-08 00:01:05 +01:00
Inhalt von K821_21003_invoice.xml
<XML-FSCM-INVOICE-2003A>
<INTERCHANGE>
<IC-SENDER>
<Pid>41010000001234567</Pid>
</IC-SENDER>
<IC-RECEIVER>
<Pid>41301000000012497</Pid>
</IC-RECEIVER>
<IR-Ref />
</INTERCHANGE>
<INVOICE>
<HEADER>
<FUNCTION-FLAGS>
<Confirmation-Flag />
<Canellation-Flag />
</FUNCTION-FLAGS>
<MESSAGE-REFERENCE>
<REFERENCE-DATE>
<Reference-No>202107164522001</Reference-No>
<Date>20210731</Date>
</REFERENCE-DATE>
</MESSAGE-REFERENCE>
<PRINT-DATE>
<Date>20210731</Date>
</PRINT-DATE>
<REFERENCE>
<INVOICE-REFERENCE>
<REFERENCE-DATE>
<Reference-No>21003</Reference-No>
<Date>20210731</Date>
</REFERENCE-DATE>
</INVOICE-REFERENCE>
<ORDER>
<REFERENCE-DATE>
<Reference-No>A003</Reference-No>
<Date>20210731</Date>
</REFERENCE-DATE>
</ORDER>
<REMINDER Which="MAH">
<REFERENCE-DATE>
<Reference-No></Reference-No>
<Date></Date>
</REFERENCE-DATE>
</REMINDER>
<OTHER-REFERENCE Type="ADE">
<REFERENCE-DATE>
<Reference-No>202107164522001</Reference-No>
<Date>20210731</Date>
</REFERENCE-DATE>
</OTHER-REFERENCE>
</REFERENCE>
<BILLER>
<Tax-No>CHE-111.222.333 MWST</Tax-No>
<Doc-Reference Type="ESR-ALT "></Doc-Reference>
<PARTY-ID>
<Pid>41010000001234567</Pid>
</PARTY-ID>
<NAME-ADDRESS Format="COM">
<NAME>
<Line-35>Adam Adler</Line-35>
<Line-35>Bahnhofstrasse 1</Line-35>
<Line-35>8000 Zürich</Line-35>
<Line-35></Line-35>
<Line-35></Line-35>
</NAME>
<STREET>
<Line-35></Line-35>
<Line-35></Line-35>
<Line-35></Line-35>
</STREET>
<City></City>
<State></State>
<Zip></Zip>
<Country></Country>
</NAME-ADDRESS>
<BANK-INFO>
<Acct-No></Acct-No>
<Acct-Name></Acct-Name>
<BankId Type="BCNr-nat" Country="CH">001996</BankId>
</BANK-INFO>
</BILLER>
<PAYER>
<PARTY-ID>
<Pid>41301000000012497</Pid>
</PARTY-ID>
<NAME-ADDRESS Format="COM">
<NAME>
<Line-35>Autoleasing AG</Line-35>
<Line-35>Gewerbestrasse 100</Line-35>
<Line-35>5000 Aarau</Line-35>
<Line-35></Line-35>
<Line-35></Line-35>
</NAME>
<STREET>
<Line-35></Line-35>
<Line-35></Line-35>
<Line-35></Line-35>
</STREET>
<City></City>
<State></State>
<Zip></Zip>
<Country></Country>
</NAME-ADDRESS>
</PAYER>
</HEADER>
<LINE-ITEM />
<SUMMARY>
<INVOICE-AMOUNT>
<Amount>0000135000</Amount>
</INVOICE-AMOUNT>
<VAT-AMOUNT>
<Amount></Amount>
</VAT-AMOUNT>
<DEPOSIT-AMOUNT>
<Amount></Amount>
<REFERENCE-DATE>
<Reference-No></Reference-No>
<Date></Date>
</REFERENCE-DATE>
</DEPOSIT-AMOUNT>
<EXTENDED-AMOUNT Type="79">
<Amount></Amount>
</EXTENDED-AMOUNT>
<TAX>
<TAX-BASIS>
<Amount></Amount>
</TAX-BASIS>
<Rate Categorie="S">0</Rate>
<Amount></Amount>
</TAX>
<PAYMENT-TERMS>
<BASIC Payment-Type="ESR" Terms-Type="1">
<TERMS>
<Payment-Period Type="M" On-Or-After="1" Reference-Day="31">30</Payment-Period>
<Date>20210830</Date>
</TERMS>
</BASIC>
<DISCOUNT Terms-Type="22">
<Discount-Percentage>0.0</Discount-Percentage>
<TERMS>
<Payment-Period Type="M" On-Or-After="1" Reference-Day="31"></Payment-Period>
<Date></Date>
</TERMS>
<Back-Pack-Container Encode="Base64"> </Back-Pack-Container>
</DISCOUNT>
</PAYMENT-TERMS>
</SUMMARY>
</INVOICE>
</XML-FSCM-INVOICE-2003A>
-----------------
muh
2023-01-17 11:59:43 +01:00
muh
2023-02-08 00:18:05 +01:00
<br>
<br>
<br>
<br>
<br>
<br>
muh
2023-01-17 12:02:41 +01:00
muh
2023-01-17 15:57:59 +01:00
https://haraldmueller.ch/schueler (Passwort: tbz)
muh
2023-02-08 00:18:05 +01:00
FTP-Zugang:
muh
2023-01-17 14:32:57 +01:00
muh
2023-02-08 00:01:05 +01:00
HOST: ftp.haraldmueller.ch
USER: schueler
PASS: studentenpasswort
PATH: /M122-[KLASSE]/NachName
muh
2023-02-08 00:18:05 +01:00
<br>https://haraldmueller.ch/schoolerinvoices/out (Passwort auf html-Seite: tbz)
<br>https://haraldmueller.ch/schoolerinvoices/in
muh
2023-02-08 00:01:05 +01:00
![ebill-ueberischt-details.jpg](x-ressourcen/ebill-ueberischt-details.jpg)
https://coinditorei.com/zahlungssystem (Passwort: tbz)
<br>https://coinditorei.com/zahlungssystem/in
<br>https://coinditorei.com/zahlungssystem/out
muh
2023-02-08 00:18:05 +01:00
<br>
muh
2023-02-08 00:01:05 +01:00
muh
2023-02-08 00:18:05 +01:00
Die Dateien müssen einen bestimmten Namen haben:
- [Kundennummer]_[Rechnungsnummer]_invoice.xml (Konkret ‘K821_21003_invoice.xml’)
- [Kundennummer]_[Rechnungsnummer]_invoice.txt (Konkret ‘K821_21003_invoice.txt’)
muh
2023-02-08 00:01:05 +01:00
Testfiles können Sie finden unter: https://coinditorei.com/zahlungssystem/testfiles
Kontrollen
Bauen Sie Kontrollen ein, um festzustellen, ob «die» Rechnung richtig verarbeitet wurde, bzw. ob und wann und wie ein allfälliger Abbruch stattgefunden hat. Am einfachsten sind Log-Files.
Konfiguration
Gut ist, wenn das System ‘von aussen’ konfiguriert / eingestellt werden kann (separates Config-File).
muh
2023-01-17 14:27:54 +01:00
muh
2023-01-17 14:32:57 +01:00
muh
2023-02-08 00:01:05 +01:00
## Bewertung und Note
muh
2023-01-17 11:21:58 +01:00
muh
2023-02-08 00:01:05 +01:00
**Funktionalität**
muh
2023-01-17 11:21:58 +01:00
muh
2023-02-08 00:01:05 +01:00
Der automatische Ablauf und die korrekten Resultate bestimmen die Note.
muh
2023-02-06 20:06:56 +01:00
muh
2023-02-08 00:01:05 +01:00
Die Bewertung geschieht über einen Live-Test mit von der Lehrperson erstellten Test-Dateien. Es gibt eine normale ‘richtiges’ Testdatei und eine Testdatei, die unmöglich zu verarbeiten ist. Dabei wird geschaut, ob das System korrekt läuft. Die korrekt Testdatei soll richtig verarbeitet werden. Die inkorrekte Testdatei darf nicht verarbeitet werden. Dies müssen Sie nachvollziehen können.
**Dokumentation**
Keine Doku notwendig, die Aufgabenstellung ist Doku genug.
**Benotung**
Note 4:
Viele Teile der Vorgabe wurden erreicht, aber es fehlt noch etwas damit alles automatisch funktioniert.
Note 5:
Das System funktioniert aus Sicht des Kunden, wenn alles richtig definiert war (keine Fehler in der Rechnungsdatei oder wenn die Quittung nicht vom Zahlungssystem bereitgestellt wurde).
muh
2023-02-06 20:33:41 +01:00
muh
2023-02-08 00:01:05 +01:00
Note 6:
Komplette Verarbeitung der Vorgaben inklusive Log-Dateien zur Rekonstruktion des Ablaufes.
Alle Abläufe sind automatisiert und können per Konfigurationsdatei beeinflusst werden (FTP-Server Einstellungen).
Es sind diverse Sicherheitsmechanismen eingebaut (Fehlermeldungen mit aussagekräftigem und nützlichem Inhalt).
muh
2023-02-06 20:33:41 +01:00
muh
2023-02-08 00:01:05 +01:00
**Detailberechnung der Note**
muh
2023-02-06 20:33:41 +01:00
muh
2023-02-08 00:18:05 +01:00
- (2P) Filedownload (.data) via FTP (aus dem [Kundenserver]/out/XX21xMustermann)
muh
2023-02-06 20:33:41 +01:00
- [1] Ein Dateidownload funktioniert
- [1] es können auch mehrere Dateien "gleichzeitig" verarbeitet werden
muh
2023-02-08 00:18:05 +01:00
- (5P) Lesen der Input-Datei (.data)
muh
2023-02-06 20:33:41 +01:00
- [3] Aufspalten der Informationen
- [1] Erkennen falscher Informationen
- [1] Rückweisen falscher/inkorrekter Rechnung
muh
2023-02-08 00:18:05 +01:00
- (12P) Erstellung der _Invoice.txt
muh
2023-02-06 20:33:41 +01:00
- [1] Richtiger Filename (gem. definierter Vorgabe)
- [4] Korrekte Darstellung und Formatierung der Rechnung mit Einrückung und Kollonierung der Rechnungzeilen
- [3] Richtige Berechnung der End-Summe inkl. Darstellung (2-Nummen nach dem Dez-Punkt)
- [2] Einrücken und Darstellung des Einzahlungsschein-Abschnitts (Beträge haben Abstand beim Dezimalpunkt)
- [2] Richtige Berechnung und Position des Zahlungsziel-Datum (Rechnungsdatum + Zahlungsziel), -> nicht Verarbeitungsdatum!!
muh
2023-02-08 00:18:05 +01:00
- (6P) Erstellung der _Invoice.xml
muh
2023-02-06 20:33:41 +01:00
- [1] Richtiger Filename (gem. definierter Vorgabe)
- [1] Rechnungsnummer eingesetzt
- [2] Summe korrekt (ohne Punkt, mit führenden Nullen)
- [2] Zahlungsziel & Zahlungszieldatum (Korr. Datum und Formattierung YYYYmmdd)
muh
2023-02-08 00:18:05 +01:00
- (2P) Fileupload (2 Files (.txt und .xml) pro Rechnung)
muh
2023-02-06 20:33:41 +01:00
- [2] via FTP (auf den zweiten Server nach [Zahlungsserver]/in/XX21xMustermann)
muh
2023-02-08 00:18:05 +01:00
- [-1] Abzug 1P dafür, falls die fehlerhafte Rechnung auch noch da steht
muh
2023-02-06 20:33:41 +01:00
muh
2023-02-08 00:18:05 +01:00
- (3P) Zip- oder tar-File Erstellung
muh
2023-02-06 20:33:41 +01:00
- [2] Zip-/tar-File mit korrektem Inhalt und Dateinamen (2 Files)
- [1] Fileupload via FTP (auf den [Kundenserver]/in/XX21xMustermann)
muh
2023-02-08 00:18:05 +01:00
- (5P) Mail
muh
2023-02-06 20:33:41 +01:00
- [2] Mail-Versand (kommt an der richtigen Adresse "heute/jetzt" an (Mailadr im Input))
- [2] Mail-Text und Absender fehlerlos, den Anforderungen entsprechend
- [1] Mail-Attachment (.zip/.tar) geschickt/vorhanden
muh
2023-02-08 00:18:05 +01:00
- (5P) Konfiguration und Projektdateiorganisation
muh
2023-02-06 20:33:41 +01:00
- [2] "gute" Struktur der Projektdateien, Verarbeitungsdaten nicht bei den Verarbeitungs-Skript(s)
- [2] Log-File mit vernünftigen/aussagekräftigen Informationen, z.B. Erkennung von fehlerhafter Verarbeitung
- [1] separate Konfigurationsdatei
muh
2023-02-08 00:18:05 +01:00
- (2P) Automatisierung
muh
2023-02-06 20:33:41 +01:00
- [2] Scheduler eingerichtet und funktioniert (Linux "crontab" oder Win "Aufgabenplaner")
muh
2023-02-08 00:18:05 +01:00
- (42P = Total)
<br>evtl. Bonus Kurzquartale I (Total = 37P)
<br>evtl. Bonus Kurzquartale II (Total = 34P)
Reference in New Issue Copy Permalink