README

🔙 这是 API v2 的文档。您可以在这里找到 API v1 的包。

文档、安装和使用说明

请参阅文档获取详细的安装和使用说明。

composer require offline-agency/laravel-fatture-in-cloud-v2

功能说明

此包提供与 Fatture in Cloud APIs v2 的简单 Laravel 集成。让我们看看一些示例

$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_document->list('invoice', [
    'per_page' => 50
]);  

// return an array of invoices 
$issued_document_list->getItems();

// return pagination fields like page, per_page...
$issued_document_list->getPagination();

// return single product's fields
$product = new \OfflineAgency\LaravelFattureInCloudV2\Api\Product();
$product_detail = $product->detail($product_id);

功能

所有

此包提供 all() 方法，允许您获取所有结果的数组而不分页。它为所有提供分页列表方法的端点实现了此功能。让我们看看一个示例

$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_documents->all('invoice');

分页

此包提供了一种分页系统，允许您使用简单的方法在页面之间切换

$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_documents->list('invoice');

// check if the response has more than one page
$issued_document_list->getPagination()->isSinglePage();

// check if the document has a next page
$issued_document_list->getPagination()->hasNextPage();

// check if the document has a previous page
$issued_document_list->getPagination()->hasPrevPage();

// return documents of the next page
$issued_document_list->getPagination()->goToNextPage();

// return documents of the previous page
$issued_document_list->getPagination()->goToPrevPage();

// return documents of the first page
$issued_document_list->getPagination()->goToFirstPage();

// return documents of the last page
$issued_document_list->getPagination()->goToLastPage();

Bin

此包提供了用于获取已发布文档详情的 bin() 方法，这在将预付款转换为发票（删除预付款）并需要旧文档详情时非常有用。让我们看看一个示例

$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$response = $issued_documents->bin($document_id);

速率限制

此包提供了一种拦截节流错误（403、429）并自动重试的方法。您可以在配置中指定限制，请记住使用毫秒来表示时间

'limits' => [
    'default' => 300000,
    '403' => 300000,
    '429' => 3600000,
],

API 覆盖率

我们目前正在实施此包以实现所有端点。启用通知以在发布新 API 时通知您。

✅ 用户

✅ 公司

✅ 客户

✅ 供应商

✅ 产品

✅ 已发布文档

🔜 已发布电子发票

❌ 收到的文档

✅ 收据

❌ 税费

❌ 归档

❌ 现金账簿

🔜 信息

❌ 设置

测试

composer test

贡献

请参阅 CONTRIBUTING 获取详细信息。

安全性

如果您发现任何安全问题，请通过 support@offlineagency.com 发送电子邮件，而不是使用问题跟踪器。

致谢

关于我们

Offline Agency 是一家位于意大利帕多瓦的网络设计公司。您可以在我们的网站上找到我们项目的概述这里。

许可证

MIT许可证。请参阅许可证文件获取更多信息。

offline-agency / laravel-fatture-in-cloud-v2

维护者

详细信息