README

Shopgate Connect Integration SDK 是一组用于管理您的商店系统与Shopgate Connect之间通信的类。

在https://developer.shopgate.com创建开发者账户

要求

• PHP 5.6及以上

安装

composer require shopgate/connect-integration-sdk-php

或从发布页面下载并解压。

迁移到2.x

如果您从1.x升级到2.x，请阅读迁移指南。

快速入门

订单创建示例（请参阅订单API文档以获取完整的请求规范）

<?php
use Shopgate\ConnectSdk\ShopgateSdk;

$order = [
    'localeCode' => 'de-de',
    'currencyCode' => 'EUR',
    'addressSequences' => [...],
    'primaryBillToAddressSequenceIndex' => 0,
    'lineItems' => [...],
    'subTotal' => 109.99,
    'total' => 115.89,
    'submitDate' => '2019-09-02T09:02:57.733Z',
    'imported' => true
];

$config = [
    'merchantCode'  => 'MERCHANT_CODE',
    'clientId'      => 'my-client',
    'clientSecret'  => '*******',
    'username'      => 'my.address@my-domain.com',
    'password'      => '*******',
    'env'           => 'pg' // Optional. "dev", "pg" or empty (= production)
];

$sgSdk = new ShopgateSdk($config);

try {
    $response = $sgSdk->getOrderService()->addOrders([$order]);
    var_dump($resonse);
} catch (\Exception $e) {
    var_dump($e);
}

配置参数

• clientId（字符串）- OAuth2客户端ID
• clientSecret（字符串）- OAuth2客户端密钥
• merchantCode（字符串）- 注册时提供的商户代码
• username -（字符串）- Shopgate Next Admin中名为“Api Credentials”的用户的电子邮件地址
• password -（字符串）- Shopgate Next Admin中名为“Api Credentials”的用户的密码
• env（字符串，默认：production）- “dev”、“staging”、“production”之一

变更日志

有关更多信息，请参阅CHANGELOG.md文件。

贡献

有关更多信息，请参阅CONTRIBUTING.md文件。

关于Shopgate

Shopgate是领先的移动电子商务平台。

许可证

Shopgate Connect Integration SDK可在Apache许可证，版本2.0下使用。

有关更多信息，请参阅LICENSE.md文件。

高级

“baseUri”配置

针对echo服务进行测试时，可以覆盖baseUri配置。默认为https://{service}.shopgate{env}.io/{version}/merchants/{merchantCode}/，支持模板变量

• service - 请求的服务名称，每个请求不同
• env - Shopgate环境相关的域名后缀；它将自动替换为“dev”、“pg”（测试）或“”（生产）
• version - API版本，可能每个请求不同
• merchantCode - 配置中设置的商户代码