fakturownia 0.2.2

目录

• Features
• Quickstart
• Running Tests
• Help wanted
• Credits
• History
  • 0.1.0 (2018-01-03)
  • 0.1.2 (2018-01-10)
  • 0.2.1 (2018-01-12)
  • 0.2.2 (2018-01-18)

Features

• {发票CRUD PLUS通过电子邮件发送和“标记已付”
• {欧盟成员国B2C交易的增值税税率助手
• {APIClient积垢
• ☆支付积垢
• ☆产品积垢
• ☆仓库文件积垢
• ☆账户管理

有关完整的API功能，请参阅fakturownia APIs。

Quickstart

安装Fakturownia

pip install fakturownia python

在python解释器中使用fakturownia APIs：

>>> import os
>>> os.environ.get('FAKTUROWNIA_API_TOKEN', 'Missing key')
'...'
>>> from fakturownia import get_api_client
>>> api = get_api_client()
>>> invoice = api.invoices.create(
...     seller_name='Kabaret Starszych Panów',
...     buyer_name='Odrażający drab',
...     positions=[{
...         'name': 'Smolna szczapa',
...         'quantity': 5,
...         'total_price_gross': 7.33,
...     }],
... )
>>> invoice.view_url
'...'

由于create只返回 数据属性，获取更新实例所需的所有信息。

如果您已启用付款，您可以调用get获取所有数据并检查付款url:

>>> invoice.get()
<fakturownia.endpoints.Invoice object at 0x...>
>>> invoice.payment_url
'...'

我们可以将此发票标记为已付款：

>>> invoice.mark_paid()
<fakturownia.endpoints.Invoice object at 0x...>

您可以连锁电话：

>>> invoice.put(buyer_email='kominek@niepodam.pl').send_by_email()
<fakturownia.endpoints.Invoice object at 0x...>

您可以在工厂中播放和测试您的方案：

pip install fakturownia[factories]
python

现在您可以这样做：

>>> from fakturownia.factories import InvoiceFactory
>>> InvoiceFactory(api_client='<your api key here>', kind='proforma').post().get().payment_url # doctest: +SKIP
'...'

同时基于 EU country specific VAT rates：

>>> InvoiceFactory(
...     api_client=api,
...     seller_country='PL',
...     buyer_country='DE',
...     buyer_tax_no=None,
... ).normalize_vat().post().view_url
'...'

整洁！：）

Running Tests

代码真的有用吗？

pipenv install --dev
pipenv shell
tox

我们建议使用pipenv，但创建virtualenv和安装需求的传统方法也应该有效。 请安装requirements/base.txt和requirements/development.txt以设置用于测试和开发的虚拟环境。

Help wanted

此库尚未完成。它做了最新的贡献者所需要的，但还可以做更多的事情。 您可以实现新的api端点并为它们编写测试，它实际上很简单，而且新的类也很简单， 但是测试需要一些努力。我们是懒散的测试编写者，因为我们不想损害覆盖范围，所以我们 推迟新的api，直到有人想要编写测试。

如果需要帮助，请参阅 contributing section在文档中获取更多信息。

Credits

这个包是用Cookiecutter和wooyek/cookiecutter-pylib项目模板创建的。

History