Metadata-Version: 2.1
Name: plenty-api
Version: 0.2.11.0
Summary: Interface for the PlentyMarkets API.
Home-page: https://pypi.org/project/plenty_api
License: GPLv3
Keywords: plentymarkets,python,api,plenty,data
Author: Sebastian Fricke
Author-email: sebastian.fricke@posteo.net
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 1 - Planning
Classifier: License :: Other/Proprietary License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: keyring (>=23.11.0,<24.0.0)
Requires-Dist: pandas (>=1.5.1,<2.0.0)
Requires-Dist: python-gnupg (>=0.5.0,<0.6.0)
Requires-Dist: requests (>=2.28.1,<3.0.0)
Requires-Dist: simplejson (>=3.17.6,<4.0.0)
Requires-Dist: tqdm (>=4.64.1,<5.0.0)
Project-URL: Repository, https://github.com/initBasti/python_plentymarkets_api
Description-Content-Type: text/markdown

# Overview

Interface for the PlentyMarkets API.

# Setup

## Requirements

* Python 3.7.8+

## Installation

Install it directly into an activated virtual environment:

```text
$ pip install python_plenty_api
```

or add it to your [Poetry](https://poetry.eustace.io/) project:

```text
$ poetry add plenty_api
```

# Usage

After installation, the package can imported:

```text
$ python
>>> import plenty_api
>>> plenty_api.__version__
```
## Examples

```
import plenty_api

def main():
    # Get the bearer token and set the basic attributes for an endpoint
    plenty = plenty_api.PlentyApi(base_url='https://{your-shop}.plentymarkets-cloud01.com',  # available under setup->settings->API->data
                                  use_keyring=True,  # Save the credentials into your system wide Keyring or not
                                  data_format='json',  # Choose the output format (default JSON)
                                  debug=True)  # display the constructed endpoint before making the request

    orders = plenty.plenty_api_get_orders_by_date(start='2020-09-20',
                                                  end='2020-09-24',
                                                  date_type='payment',  # Get orders that were payed in between [start] and [end]
                                                  additional=['documents', 'locations'],  # Include additional attributes to the response
                                                  refine={'orderType': '1', 'referrerId': '1'})  # Only get orders with type 1 and from referrer 1

if __name__ == '__main__':
    main()
```

# Contact

Author: Sebastian Fricke, Company: Panasiam, Email: sebastian.fricke.linux@gmail.com

