README

PHP应用程序与Cnova Marketplace API集成的非官方SDK (Extra.com.br, Pontofrio.com.br, Casasbahia.com.br)

使用要求

• PHP >= 5.6
• curl 扩展
• Composer 依赖管理器

此组件 不是一个独立的应用程序，其目的是用作库。其部署应由经验丰富的开发者执行。

这不是一个插件！

仅适用于命令行模式的选项仅用于开发模式的调试。

最重要的文档在单元测试中。如果您无法阅读单元测试，我建议您不要使用此库。

版权和许可证

此组件受 MIT 许可证 的保护

有关版权和许可证的信息，您必须阅读随此源代码一起分发的 许可证文件。

许可证摘要

要求

• 许可证和版权声明

允许

• 商业用途
• 修改
• 分发
• 再许可

禁止

• 责任保证

质量指标

感谢

• 感谢所有 贡献补丁的人；
• 感谢提出重要建议的人；
• 感谢创建了在此组件中使用的 库 的开发者。

- Gilmar Pupo

安装

使用 composer 将 cnova-sdk 包添加到您的项目中

composer require gpupo/cnova-sdk

使用

以下示例演示了从 Factory 开始的简化使用

///...
use Gpupo\CnovaSdk\Factory;

$cnovaSdk = Factory::getInstance()->setup([
    'client_id'     => 'foo',
    'access_token'  => 'bar',
    'version'       => 'sandbox',
 ]);

$manager = $cnovaSdk->factoryManager('product'));

访问已注册产品列表

$produtosCadastrados = $manager->fetch(); // Collection de Objetos Product

访问已知标识符的已注册产品信息

$produto = $manager->findById(9)); // Objeto Produto
echo $product->getTitle(); // Acesso ao nome do produto de Id 9

产品创建

$data = []; // Veja o formato de $data em Resources/fixture/Product/ProductId.json
$product = $cnovaSdk->createProduct($data);

产品发送至市场

$manager->save($product);

注册（日志）

//...
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
//..
$logger = new Logger('foo');
$logger->pushHandler(new StreamHandler('Resources/logs/main.log', Logger::DEBUG));
$cnovaSdk->setLogger($logger);

控制台

可用命令列表

./bin/main

您可以在命令行中检查您的Cnova凭据

./bin/main credential

您可以为您的自定义配置创建一个名为app.json的文件，这些配置将在命令行中使用

{
    "client_id": "foo",
    "access_token": "bar"
}

使用app.json.dist作为模板

提示：检查在Resources/logs/main.log生成的日志

链接

• Cnova-sdk Composer Package 在 packagist.org
• API V2 官方文档
• Marketplace-bundle Composer Package - 与 Symfony 集成此包
• 巴西电商的其他 SDK

开发

git clone --depth=1  git@github.com:gpupo/cnova-sdk.git
cd cnova-sdk;
ant;

自定义 phpunit 配置

cp phpunit.xml.dist phpunit.xml;

自定义参数！

提示：检查在 var/log/main.log 生成的日志

对象属性

待办事项

对象属性

CnovaSdk\Client\Client

• 成功设置选项
• 管理资源URI
• 请求对象具有头部
• 访问订单列表
• 访问产品列表

CnovaSdk\Entity\Order\Customer\Customer

• 是订单的属性
• 具有电话对象

CnovaSdk\Entity\Order\Customer\Phones\Phone

• 具有号码
• 具有类型标识

CnovaSdk\Entity\Order\Items\Items

• 具有产品对象集合
• 即使SKU相同，每个单元也有不同的ID
• 包含集合中现有ID的列表

CnovaSdk\Entity\Order\Items\Product\Product

• 具有每个单元的标识符
• 具有SKU标识符

CnovaSdk\Entity\Order\Manager

• 获取订单列表
• 获取待处理的刚批准的订单列表
• 恢复特定订单的信息
• 将订单移动到已发送状态
• 在没有完整信息的情况下无法将订单移动到已发送状态
• 将订单移动到已接收状态
• 将订单移动到已取消状态

CnovaSdk\Entity\OrderCollection

• 每个元素都是一个订单对象
• 每个元素都有正确的数据
• 是一个元数据容器对象
• 具有元数据对象
• 具有表示记录数量的指示器属性

CnovaSdk\Entity\Order\Order

• 列表中的每个项都是一个对象
• 每个订单都有一个计费对象
• 每个订单都有一个客户对象
• 每个订单都有一个运费对象
• 每个订单都有一个包含送货地址的对象
• 每个订单都有一个跟踪集合
• 每个订单都有一个产品集合

CnovaSdk\Entity\Order\Trackings\Tracking\Invoice

• 有CNPJ
• 有访问密钥

CnovaSdk\Entity\Order\Trackings\Tracking\Tracking

• 验证
• 有项目列表
• 有运输公司数据
• 无效，缺少跟踪信息
• 无效，缺少发票
• 无效，缺少运输公司
• 有效，数据完整
• 有订单更新的格式

CnovaSdk\Entity\Product\Loads\Loads

• 有产品集合
• 每个产品有状态
• 具有元数据对象

CnovaSdk\Entity\Product\Loads\Manager

• 获取产品状态列表
• 允许访问错误产品列表

CnovaSdk\Entity\Product\Loads\Metadata

• 是一个集合
• 元数据包含发送对象的数量
• 元数据包含当前偏移信息
• 元数据包含当前限制信息

CnovaSdk\Entity\Product\Manager

• 是产品管理员
• 有对象池
• 有客户端对象
• 获取已注册产品列表
• 根据ID恢复特定产品的信息
• 将产品保存在队列中以批量写入
• 管理产品批量写入
• 更新产品的价格和库存
• 不更新未更改的产品
• 如果只有一个属性更改，则仅更新库存

CnovaSdk\Entity\Product\Price

• 是产品的属性
• 有价格
• 有按价格
• 提供SKU价格更新的参数

CnovaSdk\Entity\Product\ProductCollection

• 有产品集合
• 是一个元数据容器对象
• 具有元数据对象
• 具有表示记录数量的指示器属性

CnovaSdk\Entity\Product\Product

• 有属性和对象
• 有一个属性集合
• 有价格对象
• 有库存对象
• 有尺寸对象
• 有包装对象
• 提供JSON

CnovaSdk\Entity\Product\Stock

• 是产品的属性
• 有数量
• 有产品准备时间
• 提供SKU库存更新的参数

CnovaSdk\Factory

• 集中访问管理者
• 集中创建对象

依赖项（库）列表