MYOB icon

MYOB

Interact with MYOB Business API - Sales Orders, Customers, Items, Invoices, and more
Join our community

Actions12

Overview

This node integrates with the MYOB Business API to manage invoices, among other resources. Specifically, the Invoice - List operation retrieves a list of invoices from MYOB, optionally filtered by an OData filter expression and limited in number.

This operation is useful when you want to:

  • Retrieve recent or specific invoices for reporting or processing.
  • Filter invoices based on criteria such as status, date, or custom fields using OData filters.
  • Limit the number of invoices fetched to control data volume.

Example use cases:

  • Fetch the last 50 active invoices for reconciliation.
  • Retrieve invoices filtered by a specific customer or date range.
  • Integrate invoice data into another system or workflow for further automation.

Properties

Name Meaning
Limit Maximum number of invoice records to return. Default is 100.
Filter Optional OData filter expression to narrow down the invoices returned. Example: IsActive eq true.

Output

The output is a JSON array where each item represents the response from the MYOB API for the invoice list request. The structure includes:

  • Items: An array of invoice objects retrieved from MYOB.
  • Count: Total number of invoices matching the query.
  • Additional metadata may be included depending on the API response.

No binary data is output by this operation.

Dependencies

  • Requires an OAuth2 API credential for authenticating with the MYOB Business API.
  • Needs the company file GUID from the authenticated credentials to construct API requests.
  • Uses the internal helper function to make HTTP requests to MYOB endpoints.

Troubleshooting

  • Empty or invalid filter expression: If the OData filter syntax is incorrect, the API may return errors or no results. Verify the filter string format.
  • Limit too high: Setting an excessively high limit might cause slow responses or timeouts. Use reasonable limits or implement pagination if supported.
  • Authentication issues: Ensure the OAuth2 credential is valid and has access to the correct company file.
  • No input data error: The node expects input items; if none are provided, it throws an error.
  • API response errors: If MYOB returns an unexpected response or error, check network connectivity and API permissions.

Links and References

Discussion