srdorado/siigo-client-php

siigo api (https://siigoapi.docs.apiary.io/#) 的消费者客户端

v0.8.2 2024-07-27 23:16 UTC

This package is auto-updated.

Last update: 2024-09-27 23:49:06 UTC


README

srdorado 提供

License Packagist PHP Version Support Packagist Version Packagist Downloads Composer dependencies Test workflow Codecov composer.lock

此库消费 Siigo API,使其能够

  • 创建、更新和查询销售发票。

  • 向店家和客户发送销售发票。

  • 创建、查询、更新和删除客户(第三方)和产品/服务。

  • 创建和查询会计收据、贷项通知和现金收据。

  • 查询 Siigo Cloud 中的产品库存。

安装

composer require srdorado/siigo-client-php

如何使用它?

  • 获取令牌
    function getToken()
    {
        // Create client token
        $clientFactory = new \Srdorado\SiigoClient\Factory\ClientFactory();
        $clientTokenFactory = $clientFactory->create(\Srdorado\SiigoClient\Enum\ClientType::TOKEN);
        $clientToken = $clientTokenFactory->create();
        $clientToken->setBaseUrl('https://api.siigo.com/');

        // Create entity token
        $entity = new \Srdorado\SiigoClient\Model\Entity(\Srdorado\SiigoClient\Enum\ClientType::TOKEN);
        $entity->setData(
            [
                'username' => '',
                'access_key' => ''
            ]
        );

        // Request token
        return $clientToken->getToken($entity);
    }
  • 创建产品
    function getCustomClient()
    {
        // generate token
        $token = $this->getToken();

        // Create client
        $clientFactory = new \Srdorado\SiigoClient\Factory\ClientFactory();
        $clientProductFactory = $clientFactory->create(\Srdorado\SiigoClient\Enum\ClientType::PRODUCT);
        $clientProduct = $clientProductFactory->create();
        $clientProduct->setBaseUrl('https://api.siigo.com/');
        $clientProduct->setAccessKey($token);


        return $clientProduct;
    }



    function create()
    {
        $clientProduct = $this->getCustomClient();

        $entity = new \Srdorado\SiigoClient\Model\Entity(\Srdorado\SiigoClient\Enum\ClientType::PRODUCT);

        $dataEntity = $this->getExampleCompleteProduct();

        $entity->setData($dataEntity);

        $productId = $clientProduct->create($entity);

        $this->assertTrue(true);
    }

版本控制

版本号遵循 MAJOR.MINOR.PATCH 方案。向后兼容性破坏性更改将保持最小,但请注意,这些更改可能发生。在生产中锁定依赖关系并在升级时测试您的代码。

许可证

此捆绑包受 MIT 许可证的保护。有关完整的版权和许可证信息,请查看与源代码一起分发的 LICENSE 文件。

捐赠

paypal