twinfield 2.1.2

Read and insert data using the Twinfield API.

Twinfield

---

Python package for reading Twinfield data using the Twinfield API.

Installation

---

pip install twinfield

Usage

for an extensive list of examples, please checkout the twinfield test suite.

from twinfield import TwinfieldApi

# logging in
tw = TwinfieldApi()

# sending browse request.
df = tw.query_by_year(code="030_3", year=2021)

# sending dimensions request
df = tw.dimensions(dim_type="CRD")

required environment variables

Twinfield works with OpenID Connect. OpenID Connect is a simple identity layer on top of the OAuth 2.0 protocol. In order to authenticate with the twinfield server, the following environment variables must be set. Please see the Twinfield webservice documentation on the walktrough how to obtain the refresh token and set the app registration.

"TWINFIELD_ORGANISATION"
"TWINFIELD_CLIENT_ID"
"TWINFIELD_CLIENT_SECRET"
"TWINFIELD_REFRESH_TOKEN"

How to set environment variables?

• Windows
• macOS
• Linux

---

api scoping (security) advice

Please note that there are different levels of API access in Twinfield app's. It is recommended to use level 3 access over level 1 access. Level 3 is sufficient for working with the dataservices.

Twinfield deprecation notices

• The module salesinvoice is only to be used if invoices need to be generated. If only the transaction registration is necessary, use the transactions endpoint.
• modules have versions, for instance the 030 module can be pulled with suffix _1 or _3. It is advised to use the latest version because the speed of the requests is greater.

---

Link to the Twinfield API documentation.

---

For business inquiries concerning this package, contact us at:

• [e-mail]
• [e-mail]