PyMYOB
A Python API around the MYOB Business API (formerly AccountRight Live, and New Essentials).
Pre-getting started
Register for API Keys with MYOB. You'll find detailed instructions here.
Getting started
Install:
pip install pymyob
Create a PartnerCredentials instance and provide the Key, Secret and Redirect Uri as you've set up in MYOB, along with the data scopes your integration needs:
from myob.constants import AuthScope
from myob.credentials import PartnerCredentials
cred = PartnerCredentials(
consumer_key=<Key>,
consumer_secret=<Secret>,
callback_uri=<Redirect Uri>,
scopes=(
AuthScope.COMPANY_FILE,
AuthScope.GENERAL_LEDGER,
AuthScope.CONTACTS_CUSTOMER,
AuthScope.SALES,
),
)
MYOB grants access per data scope, so ask only for what you need: your users are shown each one on the consent screen, and are more likely to grant a short list. AuthScope enumerates all of them; AuthScope.COMPANY_FILE is needed by anything that resolves a business, so most integrations will want it alongside their data scopes.
Cache cred.state somewhere. You'll use this to rebuild the PartnerCredentials instance later.
This object includes a datetime object, so if your cache does not serialise datetime objects, you'll need to find an alternative, such as pickling and saving to a binary database column.
Redirect the user to cred.url. There, they will need to log in to MYOB and authorise partnership with your app1. Once they do, they'll be redirected to the Redirect Uri you supplied.
At the url they're redirected to, rebuild the PartnerCredentials then pick the verifier out of the request and use it to verify the credentials.
Alongside the verifier, MYOB hands back the businessId and businessName of the business the user consented to. Hang on to the businessId: it identifies the business for every subsequent call, and this redirect is the only place you're given it.
from myob.credentials import PartnerCredentials
def myob_authorisation_complete_view(request):
verifier = request.GET.get('code', None)
business_id = request.GET.get('businessId', None)
business_name = request.GET.get('businessName', None)
if verifier:
state = <cached_state_from_earlier>
if state:
cred = PartnerCredentials(**state)
cred.verify(verifier)
if cred.verified:
messages.success(request, 'OAuth verification successful.')
else:
messages.error(request, 'OAuth verification failed: verifier invalid.')
else:
messages.error(request, 'OAuth verification failed: nothing to verify.')
else:
messages.error(request, 'OAuth verification failed: no verifier received.')
Save cred.state once more, but this time you want it in persistent storage. So plonk it somewhere in your database.
With your application partnered with MYOB, you can now create a Myob instance from the verified credentials, and get at your data. Every call is made against a company file, which you build from the businessId saved off the redirect.
from myob import Myob
from myob.credentials import PartnerCredentials
cred = PartnerCredentials(**<persistently_saved_state_from_verified_credentials>)
myob = Myob(cred)
# Obtain a company file. `call=False` preps it for calling other endpoints without making a call
# yet; drop it to fetch the file's own details too (its name and product version), which needs
# `AuthScope.COMPANY_FILE`.
comp = myob.companyfiles.get(<business_id>, call=False)
# Obtain a list of customers (two ways to go about this).
customers = comp.contacts.all(Type='Customer')
customers = comp.contacts.customer()
# Obtain a list of sale invoices (two ways to go about this).
invoices = comp.invoices.all(InvoiceType='Item', orderby='Number desc')
invoices = comp.invoices.item(orderby='Number desc')
# Create an invoice.
comp.invoices.post_item(data=data)
# Obtain a specific invoice.
invoice = comp.invoices.get_item(uid=<invoice_uid>)
# Download PDF for a specific invoice.
invoice_pdf = comp.invoices.get_item(uid=<invoice_uid>, headers={'Accept': 'application/pdf'})
# Obtain a list of tax codes.
taxcodes = comp.general_ledger.taxcode()
# Obtain a list of inventory items.
inventory = comp.inventory.item()
# Use endswith, startswith, or substringof filters
search_text = 'Acme'
customers = comp.contacts.customer(raw_filter=f"substringof('{search_text}', CompanyName)")
If you don't know what you're looking for, the reprs of most objects (eg. myob, comp, comp.invoices above) will yield info on what managers/methods are available.
Each method corresponds to one API call to MYOB.
Note that not all endpoints are covered here yet; we've just been adding them on an as-needed basis. If there's a particular endpoint you'd like added, please feel free to throw it into the endpoints.py file and open up a PR. All contributions are welcome and will be reviewed promptly. :)
1: Your users can review their partner authorisations at https://secure.myob.com/. ↩
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pymyob-2.0.0-py3-none-any.whl.
File metadata
- Download URL: pymyob-2.0.0-py3-none-any.whl
- Upload date:
- Size: 13.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
Hatch/1.18.0 {"ci":null,"cpu":"arm64","distro":{"name":"macOS","version":"26.5.1"},"implementation":{"name":"CPython","version":"3.12.1"},"installer":{"name":"hatch","version":"1.18.0"},"openssl_version":"OpenSSL 3.0.12 24 Oct 2023","python":"3.12.1","system":{"name":"Darwin","release":"25.5.0"}} HTTPX2/2.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5deab9cd20e012e796c6c7d304c2470c5d567b53a5bf932d3e749d696b734115
|
|
| MD5 |
2b2f4b84e1980dafffcf200f119cd03a
|
|
| BLAKE2b-256 |
99882ffa47b0ae4b7341cf1707be1d0ab4528d579758370afb82ecdcd0d244fc
|
