janyksteenbeek / laravel-moneybird-sync
将客户字段单向同步到Moneybird
v0.1
2023-02-22 21:16 UTC
Requires
- php: ^8.1
- illuminate/contracts: ^9.0|^10.0
- picqer/moneybird-php-client: ^0.34.1
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- laravel/pint: ^1.0
- nunomaduro/collision: ^6.0
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^7.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- spatie/laravel-ray: ^1.26
README
将Laravel应用程序中的联系人字段单向同步到Moneybird会计软件。
安装
您可以通过composer安装此包
composer require janyksteenbeek/laravel-moneybird-sync
您可以使用以下命令发布配置文件
php artisan vendor:publish --tag="moneybird-sync-config"
在配置文件或环境变量中设置所有必要的值。有关更多信息,请参阅“设置”部分。
接下来,将特性添加到您的User模型中
use Janyk\LaravelMoneybirdSync\Traits\IsMoneybirdContact; class User extends Authenticatable { use IsMoneybirdContact; }
设置说明
- 按照安装说明将包包含到您的应用程序中。
- 在您可以使用此包之前,您需要将应用程序注册到Moneybird。注册是一次性事件,开发者可以在此处进行。请确保您为个人使用注册了一个应用程序。
- 注册您的应用程序后,您将收到一个访问令牌。此令牌用于使用Moneybird验证您的应用程序。将此令牌设置在您的环境变量中作为
MONEYBIRD_TOKEN
。 - 导航回您的应用程序页面,将
Client ID
和Client secret
复制到您的环境变量中作为MONEYBIRD_CLIENT_ID
和MONEYBIRD_CLIENT_SECRET
。 MONEYBIRD_ADMINISTRATION_ID
是要同步的管理的ID。您可以在Moneybird管理的URL中找到此ID。例如,如果您的管理URL是https://moneybird.com/123456789/sales_invoices
,则ID为123456789
。请确保在您的环境变量中设置此ID。- 请确保您的应用程序中有一个
User
模型。此模型应有一个moneybird_id
列。此列将用于存储联系人的Moneybird ID。 - 请确保您想与Moneybird同步的其他字段在您的
User
模型中存在。您可以在配置文件中更改这些字段的映射。 - 将
IsMoneybirdContact
特性添加到您的User
模型中。
安全漏洞
如果您是外部协作者,并在本存储库中发现安全漏洞,请通过security-external@webmethod.nl将电子邮件发送到我们的安全团队。不要使用GitHub Issues来报告安全漏洞。所有安全漏洞都将得到及时处理。请始终遵守Webmethod协调漏洞披露指南。
致谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件。
免责声明
此包与Moneybird B.V.或其任何附属公司无关,也不受其支持。Moneybird商标的使用仅用于识别该公司及其产品。Moneybird是Moneybird B.V.的注册商标,与商标相关的所有权利都是商标所有者的专有财产。对Moneybird的所有引用仅用于识别目的,并不暗示Moneybird B.V.的任何认可或赞助。