Billing Booth One icon

Billing Booth One

Interact with Billing Booth One API

Actions476

Overview

This node interacts with the Billing Booth One API to create an organisation. It is useful for automating the setup of new organisations within the Billing Booth One system, including specifying details such as name, address, tax rate, payment terms, and branding. Practical examples include integrating organisation creation into onboarding workflows or synchronizing organisation data from other systems.

Use Case Examples

  1. Creating a new organisation with specified name, address, and tax details.
  2. Automating the addition of organisations with custom invoice settings and contact information.

Properties

Name Meaning
Name Organisation name (required)
Theme Colour The branding theme colour in hexadecimal format (required)
Line 1 Address Line 1 (required)
Town Village or Town (required)
Postcode Post code or Zip code (required)
Country Country (required)
Tax Rate Standard taxation rate as a number (required)
Payment Terms Net payment terms in days (required)
Region Id Region unique identifier (required)
Invoice Tax Mode Mode of invoice tax calculation, either Aggregate or Per Line Item (required)
Additional Body Fields Optional additional fields for the organisation such as alternative invoice name, contact details, invoice prefixes, reminders, and other invoice-related settings

Output

JSON

  • json - Response data from the Billing Booth One API representing the created organisation

Dependencies

  • Billing Booth One API
  • An API key credential for authentication

Troubleshooting

  • Ensure all required fields are provided and correctly formatted, especially hexadecimal colour codes and numeric fields like tax rate and payment terms.
  • Check that the API base URL and authentication token are correctly configured in the credentials.
  • Common error messages may include missing required fields, invalid data formats, or authentication failures. Verify the error message details and adjust input accordingly.
  • If the node fails with a 'No routing information found' error, verify that the resource and operation parameters are correctly set to 'Organisations' and 'Create Organisation' respectively.

Links

Discussion