README

安装

在安装 syscover/pulsar-market 之前，您需要安装 syscover/pulsar-core、syscover/pulsar-admin 和 syscover/pulsar-crm。

1 - 安装 Laravel 框架后，在控制台执行以下命令

composer require syscover/pulsar-market

注册服务提供者，在文件 config/app.php 中将以下内容添加到 providers 数组中

Syscover\Market\MarketServiceProvider::class,

2 - 执行发布命令

php artisan vendor:publish --provider="Syscover\Market\MarketServiceProvider"

并

composer dump-autoload

3 - 执行迁移和数据库种子

php artisan migrate
php artisan db:seed --class="MarketTableSeeder"

4 - 执行加载所有更新的命令

php artisan migrate --path=vendor/syscover/pulsar-market/src/database/migrations/updates

5 - 在文件 app/Http/Kernel.php 中注册 TaxRule 中间件，将其添加到 web 组的 $middlewareGroups 数组中

'web' => [
    ...
    \Syscover\Market\Middleware\TaxRule::class
],

6 - 运行单元测试

./vendor/bin/phpunit

通用配置环境值

我们指出可用的配置变量，要更改它们，您需要从文件环境变量 .env 中进行操作。

订单号前缀[默认值为空]

您可以为所有订单设置一个前缀，例如，如果您想在所有订单上设置前缀 ORDER，请将此值设置在您的 .env 文件中。

MARKET_ORDER_ID_PREFIX=ORDER

默认计算税的国家[默认值为 ES]

要设置默认计算税的国家，您可以使用此参数，例如，要将默认值更改为 US，请将此值设置在您的 .env 文件中。

MARKET_DEFAULT_COUNTRY_TAX=US

默认客户类别税[默认值为 1]

设置默认客户类别 ID，以计算产品税额

MARKET_DEFAULT_CUSTOMER_CLASS_TAX=1

税率规则配置

当我们配置税率规则时，我们可以通过指定国家和领土区域来限定规则的应用。我们还有一个 ZIP 字段，我们可以使用一个模式。如果我们想在 ZIP 28001 和 28099 之间应用该税率，我们可以在 ZIP 字段中指定值 280**。

在创建税率规则时，需要考虑以下字段。

优先级 在此部分，我们使用一个数字来指示该税的优先级，当应用多个税时。如果应用了两个具有相同优先级的税务规则，则税收相加。如果应用了具有不同优先级配置的两个税收，则税收根据优先级顺序资本化。当税收是复合的，第一个优先级的税收是在未税金额上计算的，然后第二个优先级的税收是在未税金额加上第一个优先级税收金额上计算的。

顺序 在此部分，我们使用一个数字来指示税务规则在“管理税务规则”页面上的显示顺序。

设置产品价格税[默认值为 1]

定义在产品中引入的价格类型，当创建或更新产品时会查询此选项。您有以下值

• 值：1 不含税
• 值：2 含税

MARKET_PRODUCT_TAX_PRICES=1

设置运费价格税[默认值为 1]

定义在运费价格中引入的价格类型，当创建或更新运费价格时会查询此选项

• 值：1 不含税
• 值：2 含税

MARKET_TAX_SHIPPING_PRICES=1

设置产品显示价格税[默认值为 1]

定义您想要如何显示产品价格。您有以下值

• 值：1 不含税
• 值：2 含税

MARKET_PRODUCT_TAX_DISPLAY_PRICES=1

设置运费显示价格税[默认值为 1]

定义您想要如何显示运费价格

• 值：1 不含税
• 值：2 含税

MARKET_TAX_SHIPPING_DISPLAY_PRICES=1

PayPal 环境值

设置 PayPal 模式

• 值：sandbox 用于测试或开发环境
• 值：live 适用于生产环境

MARKET_PAYPAL_MODE=sandbox

PayPal沙盒值

MARKET_PAYPAL_SANDBOX_WEB_PROFILE=XX-XXXX-XXXX-XXXX-XXXX
MARKET_PAYPAL_SANDBOX_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MARKET_PAYPAL_SANDBOX_SECRET=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

PayPal实时值

MARKET_PAYPAL_LIVE_WEB_PROFILE=XX-XXXX-XXXX-XXXX-XXXX
MARKET_PAYPAL_LIVE_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MARKET_PAYPAL_LIVE_SECRET_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

PayPal翻译

如果您想在PayPal中设置运费描述，必须在common.php语言文件中创建以下键。

paypal_shipping_description

如果您想在PayPal中设置商品列表描述，必须在common.php语言文件中创建以下键。

paypal_item_list_description

Redsys环境值

设置Redsys模式

• 值：test 适用于测试或开发环境
• 值：live 适用于生产环境

MARKET_REDSYS_MODE=test

Redsys测试值

MARKET_REDSYS_TEST_MERCHANT_NAME="MERCHANT NAME (TEST)"
MARKET_REDSYS_TEST_MERCHANT_CODE=xxxxxxxxx
MARKET_REDSYS_TEST_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

Redsys实时值

MARKET_REDSYS_LIVE_MERCHANT_NAME="MERCHANT NAME"
MARKET_REDSYS_LIVE_MERCHANT_CODE=xxxxxxxxx
MARKET_REDSYS_LIVE_KEY=xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXx

事件

您可以在app/Providers/EventServiceProvider.php中注册这些事件以管理各种操作。

protected $listen = [
    ...
    'Syscover\...\Events\YourEvent' => [
        'App\Listeners\YourListener'
    ],
    ...
];

任何支付方式响应成功的时事件

Syscover\Market\Events\PaymentResponseSuccessful

任何支付方式响应错误时事件

Syscover\Market\Events\PaymentResponseError

从REDSYS服务器调用响应时事件

Syscover\Market\Events\RedsysAsyncResponse

REDSYS支付成功时事件

Syscover\Market\Events\RedsysResponseSuccessful

REDSYS支付错误时事件

Syscover\Market\Events\RedsysResponseError

PayPal支付成功时事件

Syscover\Market\Events\PaypalResponseSuccessful

PayPal支付错误时事件

Syscover\Market\Events\PaypalResponseError