# Configure & Setup

{% hint style="info" %}
Invoicing requires billing features be active in your StayOnHire account and that your account has the appropriate permissions to view, create, edit and delete billing data. Refer to [Activate Billing](https://docs.stayonhire.com/billing/invoicing/getting-started/..#id-1.-activate) and [User Permissions](https://docs.stayonhire.com/billing/invoicing/getting-started/..#id-3.-user-permissions) for more information.
{% endhint %}

## Configure & Setup

### Invoice Numbering&#x20;

Navigate to [Settings > Billing > Invoice Numbering](https://app.stayonhire.com/org/billing/invoice-numbering)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FcGKDQFlVT8sjTc3Dyzq1%2FScreenshot%202024-05-08%20at%207.37.06%E2%80%AFAM%202.png?alt=media&#x26;token=775097f1-05ac-4de7-8130-1954b41fab40" alt=""><figcaption></figcaption></figure>

By default, new StayOnHire accounts will begin their invoice numbering schedule with:

* Invoice Number Prefix: "None"
* &#x20;Next Invoice Number: "01"
* Invoice Number Padding: "2"

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FzLqEPVamI2FLGxyxFerE%2FScreenshot%202024-05-08%20at%2011.43.09%E2%80%AFAM.png?alt=media&#x26;token=1eeb5c25-62fe-4092-a6fc-e009de240690" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Some businesses customer their invoice numbering to differentiate between invoices generated in StayOnHire compared to those created in an integrated accounting system. \
\
For example, invoices in StayOnHire can be configured to increment as *"SOH-001, SOH-002, SOH-003"* etc. while letting your accounting integration increment as *"INV-001, INV0-002, INV-003"* etc.
{% endhint %}

### Due Date

Navigate to [Settings > Billing > Due Date](https://app.stayonhire.com/org/billing/invoice-due-date)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FvWl001uGx4TIyXTUYnVH%2FScreenshot%202024-05-08%20at%207.37.06%E2%80%AFAM%202%202.png?alt=media&#x26;token=9d9bb40a-f384-46e4-9e29-88493da9243e" alt=""><figcaption></figcaption></figure>

By default, new StayOnHire accounts will have their default invoice date set to pre-fill as:

* Due Date: "Today's Date"

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F4ZttX4xxEzjnybwfsp1W%2FScreenshot%202024-05-08%20at%2012.01.00%E2%80%AFPM.png?alt=media&#x26;token=445692e6-b4a0-4e4c-ace4-a6fd8570d145" alt=""><figcaption></figcaption></figure>

By changing this to one of the listed options available, any newly drafted invoice in StayOnHire will insert a due date better suited to your business needs.&#x20;

### Billing Cycles

'Billing cycles' determine how many invoices will be drafted between the start and end of a job, in order to invoice your customers accurately in sync with your calendar and on/off hire times.

A company may have multiple billing cycles and apply them differently on each job, for example:

*Customer 1 is invoiced on the '1st of the month', for the calendar month*&#x20;

*Customer 2 is invoiced on 'Monday weekly'*

These cycles can be saved to an individual contact or set each time you create a new job.

#### Create a new billing cycle

1. Navigate to [Settings > Billing > Default Billing Cycle](https://app.stayonhire.com/org/billing/default-billing-cycle) and click the 'Manage' option

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FciAEPb57mlv4UfcwqX7R%2FScreenshot%202024-07-01%20at%203.17.32%E2%80%AFPM.png?alt=media&#x26;token=ab131fad-5f66-4e09-8fa0-04b40b0d6dfe" alt=""><figcaption><p>The manage billing cycles settings button</p></figcaption></figure>

2. Click the add "+" button located In the top right-hand side of the page

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FFMisUlOoNVZNt7JCWGUa%2FScreenshot%202024-07-01%20at%203.21.35%E2%80%AFPM.png?alt=media&#x26;token=aef48827-d7f7-4f86-b34b-025ce1ec02d2" alt=""><figcaption><p>A popup modal will appear asking for a few variables</p></figcaption></figure>

3. Answer each of the following fields to create a new cycle

* "Frequency" displays the most common types of recurring configurations&#x20;
* "Invoice From" allows you to change when and how you want this cycle to begin invoicing\
  (commonly 'after the first asset is on hired' or ' on the contract start date')
* "Invoice Until" allows you to change when and how you want this cycle to stop invoicing \
  (commonly 'after the last asset is off hired' or ' on the contract end date')
* "Cycle Name" will appear as an option when you toggle on the desire to "Save this billing cycle for future use". This is intended to be a short nickname that everyone in your company can recognise, such as '1st of the month'

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F44WnsBKOl7Mf95xHdB8k%2FScreenshot%202024-07-01%20at%203.22.30%E2%80%AFPM.png?alt=media&#x26;token=b49e8c23-62ca-4686-a794-7d0d9d5e93f3" alt=""><figcaption></figcaption></figure>

#### Set a default billing cycle

Navigate to [Settings > Billing > Default Billing Cycle](https://app.stayonhire.com/org/billing/default-billing-cycle)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FvaCnZuWUpDqwH8ZZ3nKp%2FScreenshot%202024-05-08%20at%207.37.06%E2%80%AFAM%202%203.png?alt=media&#x26;token=64692983-0cdf-4b3a-8551-7a9feb3fc526" alt=""><figcaption></figcaption></figure>

By default, new StayOnHire accounts will have their default billing cycle set to:

* Default Billing Cycle: "Today's Date"

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F4ZttX4xxEzjnybwfsp1W%2FScreenshot%202024-05-08%20at%2012.01.00%E2%80%AFPM.png?alt=media&#x26;token=445692e6-b4a0-4e4c-ace4-a6fd8570d145" alt=""><figcaption></figcaption></figure>

By changing this to one of the listed options available, any newly drafted invoice in StayOnHire will insert a due date better suited to your business needs.&#x20;

### Invoice Customisation

Navigate to [Settings > Billing > Customise Invoice](https://app.stayonhire.com/org/billing/customise-invoice)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FHIMc3APykYmI3S8yRw3o%2FScreenshot%202024-05-08%20at%207.37.06%E2%80%AFAM%202%204.png?alt=media&#x26;token=f85ea38e-3e44-40a3-8b63-1fd339ef4cb8" alt=""><figcaption></figcaption></figure>

#### Invoice Reference

By default, new StayOnHire accounts will have their default invoice reference field set to pre-fill as:

* Reference: None

Adding a StayOnHire [{{ReferenceTag}}](https://docs.stayonhire.com/documents/templates/reference-tags) into this field will pre-fill newly drafted invoice with a reference to StayOnHire data.&#x20;

This can then allow unique job data to be sent to third party accounting integrations.

{% hint style="info" %}
Common examples used include **`{{JobPONumber}}`** or **`{{JobSiteAddress}}`**.
{% endhint %}

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F0y99MvHESe2NJ94X0jpN%2FScreenshot%202024-05-08%20at%202.47.42%E2%80%AFPM%202.png?alt=media&#x26;token=4e79f6e0-5200-4f05-ac50-26185e6c5438" alt=""><figcaption></figcaption></figure>

#### Custom Reference Tags

There is currently only one customisable reference tag: **`{{InvoiceNotes}}`**

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FyDc35zfz3xJRO5GAKFFh%2FScreenshot%202024-05-08%20at%202.47.42%E2%80%AFPM.png?alt=media&#x26;token=5156f39e-a2fb-4d76-b5e0-6ee6620ee6d5" alt=""><figcaption></figcaption></figure>

This tags can be inserted around billing documents and by default, this will be set to the bottom of default StayOnHire invoices:

> {{InvoiceNotes}}: Please make payment to the following recipient with "{{InvNumber}}" as the payment description/reference, thank you.
>
> {{OrgName}} \
> BSB: {{OrgBankBSB}} \
> Account #: {{OrgBankAccountNumber}}

Adding StayOnHire [Reference Tags](https://docs.stayonhire.com/documents/templates/reference-tags) into this field will pre-fill newly drafted invoice with a reference to StayOnHire data.&#x20;

### Auto-invoice Drafting

Navigate to [Settings > Billing > Auto-invoice drafting](https://app.stayonhire.com/org/billing/invoice-auto-drafting)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2Fz48WkBKRmmrvULH3x8zJ%2FScreenshot%202024-05-08%20at%207.37.06%E2%80%AFAM%202%205.png?alt=media&#x26;token=22a4f911-c41f-443e-b3fa-ed7d1269a656" alt=""><figcaption></figcaption></figure>

#### Auto-invoice drafting

By default, new StayOnHire accounts will have their default auto-invoice drafting settings set as:

* Create drafts: "Never"

By changing this setting, you are enabling turning on the automatic generation of new draft invoices based on your calendar and schedule.&#x20;

{% hint style="info" %}
Draft invoices do not sync to third party accounting integrations. Unwanted draft invoices can be deleted with ease.
{% endhint %}

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FPmrEhVOaY6pSYMjDDPdf%2FScreenshot%202024-05-08%20at%203.07.37%E2%80%AFPM.png?alt=media&#x26;token=3c1bba74-8072-4f00-b948-bf3a16b31d1b" alt=""><figcaption></figcaption></figure>

#### Invoice duration of hire pre-fill

By default, new StayOnHire accounts will have their default auto-invoice drafting settings set as:

* Row pre-fill: "Confirmed on hire times"

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2Fl3gfnoQ8HQPxrXA69oz9%2FScreenshot%202024-05-08%20at%203.07.48%E2%80%AFPM.png?alt=media&#x26;token=3809ac0b-620e-4ce2-a32d-2c0e949123e6" alt=""><figcaption></figcaption></figure>

By changing this to one of the listed options available, any newly drafted invoice in StayOnHire will insert a due date better suited to your business needs.
