zeuch/sevdesk-izettle-integration

sevDesk 和 Zettle API 的协同工作

维护者

详情

gitlab.com/philippzeuch/sevdesk-izettle-integration

主页

源代码

问题

安装: 7

依赖关系: 0

建议者: 0

安全: 0

星标: 0

分支: 0

1.1.7 2021-10-16 15:58 UTC

Requires

MIT fe72087172101eaae89a673326fee31e375c64d8

  • Philipp Zeuch <p.zeuch.woop@druck-drauf.de>

apiSEVDESKIZETTLESCHNITTSTELLE

This package is auto-updated.

Last update: 2024-09-16 20:11:34 UTC

README

由于目前两个系统都没有用于连接等的插件，并且两个系统都有一个相对简单的API，因此我开始使用PHP编写一个连接两个系统的接口。我在PHP方面不是很擅长，因此非常欢迎通过Pull-Requests提供帮助。

什么是sevDesk？

sevDesk是一个适用于中小企业的财务会计Web应用程序。在那里，可以导入来自银行账户或PayPal的交易。目前还没有Zettle插件。有关文档，请参阅此处。

什么是Zettle？

Zettle是一家瑞典支付服务提供商（被PayPal收购），提供包括商店收银解决方案在内的多种服务。有关文档，请参阅此处。

安装

可以通过以下方式将项目集成到现有项目中：Composer

composer require zeuch/sevdesk-izettle-integration

或者，可以创建一个Docker容器。可以在Docker Hub上找到镜像。由此产生的容器通过Cron作业执行syncPayments片段。这将把Zettle一天的销售额（现金/卡）导入到sevDesk中。为此需要一些设置。这些可以通过环境变量提供。所有可用的设置可以在下面的“属性”部分找到。

示例

在/Integration/snippets下可以找到一些如何使用接口的示例。

属性

属性描述
MWST增值税（例如，“0.19”）
LOG_LEVEL日志级别（该项目使用Monolog）
LOG_PATH（可选）"日志文件"的绝对路径。此外，还会在控制台记录。
SEVDESK_BASEURLsevDesk API的URL
SEVDESK_TOKEN令牌（可在sevDesk中查看用户）
SEVDESK_USERID用户的ID，在执行CRUD操作时应使用的上下文。这里使用：\Zeuch\sevDesk\Repo\SevDeskRepo::getDefaultSevUser
SEVDESK_RECHNUNGSNUMMER_REGEX（可选）。为了识别字符串中的发票编号，可以在此处输入正则表达式。例如，在将销售导入现金账本时，用于识别现有发票，以便进行入账。
SEVDESK_AUFTRAGSNUMMER_REGEX（可选）。为了识别字符串中的订单编号，可以在此处输入正则表达式。在将现金销售导入现金账本时，使用此识别订单编号，并检查是否存在发票。如果存在，则进行入账。如果不存在，则从订单生成发票，然后进行入账。
IZETTLE_CLIENT_IDZettle客户端ID
IZETTLE_CLIENT_SECRETZettle客户端密钥
IZETTLE_USERNAMEZettle用户名
IZETTLE_PASSWORDZettle密码
ZETTLE_KONTO_IN_SEVDESK要在sevDesk中导入信用卡支付，必须在sevDesk中创建一个类型为（在线+csv）的支付账户。然后在此处输入此支付账户的编号。对于每一笔销售，将创建一个包含销售金额的条目，以及为Zettle费用创建另一个条目。费用条目将直接与一个新的支出凭证关联。
ZETTLE_KASSENKONTO_IN_SEVDESK要在sevDesk中导入现金支付，必须在sevDesk中创建一个类型为（在线+csv）的支付账户。现金支付将导入此处，并额外执行一次对实际sevDesk现金账簿的转账。
ZETTLE_LIEFERANT_KUNDENNUMMER对于Zettle的费用，将生成支出凭证。在那里将输入一个联系人。在此处创建一个类型为“供应商”的sevDesk联系人并在此处输入客户编号是有意义的。
SEVDESK_BUCHUNGSKONTO_NUMMER_FUER_ZETTLE_GEBUEHR在Zettle费用的支出凭证中必须指定一个账目。在此处输入此账目的SKR03/SKR04编号。我们使用一个自己的账目“货币交易杂费”作为SKR03编号“4970”。费用总是以0%增值税入账。在此处使用哪个账目最好应该事先与税务顾问讨论。

功能

在此处展示了Zettle销售和提现的具体导入结构以及何时发生什么。 工作流程

免责声明

使用此项目自行承担风险。我对此类损害等不承担任何责任。