zeuch/sevdesk-izettle-integration
Composer 安装命令：
composer require zeuch/sevdesk-izettle-integration
包简介
Zusammenspiel der API von sevDesk und der API von Zettle
README 文档
README
Da es für beide Systeme noch keine Plugins zur Verknüpfung etc. gibt und es auf beiden Seiten eine recht einfache API gibt habe ich begonnen in PHP eine Schnittstelle zwischen beiden Systemen zusammenzubasteln. Ich bin in PHP recht unerfahren und freue mich über jede Unterstützung per Pull-Requests.
Was ist sevDesk?
sevDesk ist eine mandantenfähige WebApp zur Finanzbuchhaltung für KMUs. Dort ist es bereits möglich die Transaktionen aus Bankkonten oder PayPal zu importieren. Ein Plugin für Zettle fehlt bislang. Hier geht es zur Doku.
Was ist Zettle?
Zettle ist ein schwedischer Zahlungsdienstleister (wurde von PayPal übernommen) welcher u.a. Kassenlösungen für Ladenlokale anbietet. Hier geht es zur Doku.
Installation
Über Composer kann das Projekt wie folgt in ein bestehendes Projekt eingebunden werden:
composer require zeuch/sevdesk-izettle-integration
Alternativ kann man einen Docker Container erstellen. Ein Image liegt im Docker Hub. Der daraus resultierende Container führt über einen Cronjob das Snippet syncPayments aus. Damit werden die Verkäufe (Bar/Karte) eines Tages von Zettle in sevDesk importiert. Dafür sind einige Einstellungen erforderlich. Diese können über Umgebungsvariablen hereingereicht werden. Alle verfügbaren Einstellungen findet ihr weiter unten unter "Properties".
Beispiele
Unter /Integration/snippets findet man ein paar Beispiele wie man die Schnittstelle benutzen kann.
Properties
| Property | Beschreibung |
|---|---|
| MWST | Mehrwertsteuer (z.B. "0.19") |
| LOG_LEVEL | Level des Loggings (Dieses Projekt verwendet Monolog) |
| LOG_PATH | (Optional) Absoluter Pfad für die "Log files". Zusätzlich wird in die Konsole geloggt. |
| SEVDESK_BASEURL | Die URL von der sevDesk API |
| SEVDESK_TOKEN | Der Token (Ist in sevDesk am Benutzer einzusehen) |
| SEVDESK_USERID | Die technische ID des Benutzers, in welchem Kontext die CRUD Aktionen durchgeführt werden sollen. Wird hier genutzt: \Zeuch\sevDesk\Repo\SevDeskRepo::getDefaultSevUser |
| SEVDESK_RECHNUNGSNUMMER_REGEX | Optional. Um Rechnungsnummern in Strings zu erkennen, kann man hier einen Regex eintragen. Wird u.a. benötigt, um beim Import eines Verkaufes in das Kassenbuch eine vorhandene Rechnung zu erkennen damit diese dann verbucht werden kann. |
| SEVDESK_AUFTRAGSNUMMER_REGEX | Optional. Um Auftragsnummern in Strings zu erkennen, kann man hier einen Regex eintragen. Beim Import eines Barverkaufes in das Kassenbuch wird hiermit die Auftragsnummer erkannt und geschaut, ob es schon eine Rechnung gibt. Wenn ja, wird diese verbucht. Wenn nein, wird eine Rechnung aus dem Auftrag heraus erzeugt und anschließend verbucht. |
| IZETTLE_CLIENT_ID | Zettle Client ID |
| IZETTLE_CLIENT_SECRET | Zettle Client Secret |
| IZETTLE_USERNAME | Zettle Benutzername |
| IZETTLE_PASSWORD | Zettle Passwort |
| ZETTLE_KONTO_IN_SEVDESK | Um Kartenzahlungen in sevDesk zu importieren, muss es in sevDesk ein Zahlungskonto vom Typ (online+csv) geben. Die Nummer dieses Zahlungskontos muss dann hier eingetragen werden. Für jeden Verkauf wird ein Eintrag mit dem Betrag des Verkaufes und zusätzlich ein weiterer Eintrag für die Zettle Gebühren erstellt. Der Eintrag für die Gebühren wird direkt mit einem neuen Ausgabe-Beleg verknüpft. |
| ZETTLE_KASSENKONTO_IN_SEVDESK | Um Barzahlungen in sevDesk zu importieren, muss es in sevDesk ein Zahlungskonto vom Typ (online+csv) geben. Barzahlungen werden dann hierhin importiert und zusätzlich wird jeweils eine Umbuchung auf das echte sevDesk Kassenbuch durchgeführt. |
| ZETTLE_LIEFERANT_KUNDENNUMMER | Für die Gebühren von Zettle werden Ausgabe-Belege erzeugt. Dort wird ein Kontakt eingetragen. Sinnvoll ist es hier, in sevDesk einen Kontakt für Zettle vom Typ "Lieferant" anzulegen und die Kundennummer hier einzutragen. |
| SEVDESK_BUCHUNGSKONTO_NUMMER_FUER_ZETTLE_GEBUEHR | Auf dem Ausgabe-Beleg für die Zettle Gebühren muss ein Buchungskonto angegeben werden. Die SKR03/SKR04 Nummer dieses Buchungskontos muss hier angegeben werden. Wir nutzen hierfür ein eigenes Buchungskonto "Nebenkosten des Geldverkehrs" mit der SKR03 Nummer "4970". Die Gebühren werden immer mit 0% MwSt. gebucht. Welches Buchungskonto hier am besten genutzt wird sollte vorher einmal mit dem Steuerberater besprochen werden. |
Funktionsweise
Wie der Import eines Verkaufs und einer Auszahlung von Zettle genau aufgebaut ist und was wann passiert, ist hier einmal in diesem PAP dargestellt.
Haftungsausschluss
Die Nutzung dieses Projekts geschieht auf eigene Gefahr. Ich übernehme keine Haftung für Schäden o.Ä.
zeuch/sevdesk-izettle-integration 适用场景与选型建议
zeuch/sevdesk-izettle-integration 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 8 次下载、GitHub Stars 达 0， 最近一次更新时间为 2020 年 10 月 07 日， 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向： 「api」 「SEVDESK」 「IZETTLE」 「SCHNITTSTELLE」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 zeuch/sevdesk-izettle-integration 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 zeuch/sevdesk-izettle-integration 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
与 zeuch/sevdesk-izettle-integration 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：
A helpful Sevdesk API client for Laravel.
A PSR-7 compatible library for making CRUD API endpoints
The only unofficial SDK that's always in sync with the official sevDesk API. Powered by j-mastr/sevdesk-api and the OpenAPI Generator.
A PHP package for consuming the SevDesk API based on Saloon
A helpful Sevdesk API client for Laravel.
This package was renamed to itsmind/sevdesk-php-sdk. Please use that package instead. To migrate, you only have to replace the dependency in your composer.json, everything else remains the same.
统计信息
- 总下载量： 8
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 0
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2020-10-07