README

此 PHP 客户端可用于连接到 billit.io API .

注意：Billit.io 还与 zapier.com 集成，请联系我们以获取我们 beta 版 zapier 应用程序的访问权限。

安装

通过 Composer

$ composer require drakakisgeo/billit

Laravel 框架

如果您使用 Laravel 框架，则需要提供您的 Billit API 密钥和基础 URL，因此请将密钥添加到您的 config/services.php 文件中，如下所示：

'billit' => [
        'token' => env('BILLIT_API_TOKEN'),
        'sandbox' => env('BILLIT_API_IS_SANDBOX'),
        'version' => 'v1',
        'timeout' => 2.0
    ]

初始化客户端只需调用如下：

$client = resolve('billit');

当然，您也可以像这样使用 Billit Facade：

Billit::myAccount();

示例

列出联系人

use Drakakisgeo\Billit\Billit;

$client = new Billit('yourToken');
$client->contacts();

获取账户详情

$client->myAccount();

获取客户

$client->contacts();

创建联系人

$client->contactCreate([
    'customerType' => 'company',
    'company' => 'Awesome S.A.',
    'inCharge' => 'Kalampakopoulos George',
    'lang' => 'el',
    'VatId'=>'075101010'
]);

更新联系人

$client->contactUpdate([
    'customerType' => 'company',
    'company' => 'Awesome S.A.',
    'inCharge' => 'Kalampakopoulos George',
    'lang' => 'el',
    'VatId'=>'075101010'
]);

获取联系人

$client->contactShow(1010);

删除联系人

$client->contactDelete(1010);

创建发票

一个相对复杂但完整的示例，MyData 已启用

$client->invoiceCreate([
    "customerId"=>694,
    "sendMail"=> false,
    "excludeMydata"=> true,
    "invoiceDate"=>"2021-04-15",
    "invoiceTypeId"=>349,
    "isPaid" => true,
    "mydataInvoiceType" => "2.1",
    "taxes"=> [
        [
            "taxId"=> 514
        ],
        [
            "taxId"=> 524,
            "taxVatShow"=> 1
        ]
    ],
    "products"=> [
        [
            "productId"=> null,
            "details"=> "test",
            "measurementUnit"=> 1,
            "vatId" => 376,
            "price" => 123.32,
            "quantity"=> 1,
            "incomeClassificationCat"=>"category1_3",
            "incomeClassificationType"=>"E3_561_001"
        ]
    ],
    "tags" => ["billit","test-tag"],
    "mydataPayment"=>[
        "paidAmount"=> 0.32,
        "paymentMethod"=> 3,
        "epiPistosi"=> 10
    ]
]
);

有关每个情况下可用的选项，请参阅 src/Billit.php 和官方 API 的其余方法。

drakakisgeo / billit

维护者

详细信息