NextRouteNextRoute

Auto-Billing

Automatic monthly invoice generation, frequency-based billing calculations, and payment terms.

Auto-Billing

NextRoute can automatically generate invoices at the end of each billing period based on completed services. Auto-billing eliminates manual invoice creation and ensures accurate, timely billing.

How Auto-Billing Works

At the end of each month (or on your configured billing cycle), the auto-billing system:

  1. Identifies billable customers — active customers with at least one completed stop in the billing period
  2. Counts completed services — for each customer, counts completed stops grouped by property and plan
  3. Calculates line items — creates line items based on:
    • Plan price times number of completed services
    • Additional bin charges (if applicable)
    • Setup fees (for first-time invoices)
    • Credits (for missed services, if threshold is met)
  4. Applies tax — calculates tax using plan-level or tenant-level rate
  5. Creates draft invoices — one invoice per customer with all line items
  6. Sets due date — based on your configured payment terms

Frequency-Based Billing

The number of services billed depends on the plan's frequency and the customer's actual completed stops:

FrequencyExpected Monthly Services
Weekly4–5 (depending on the month)
Biweekly2–3
Monthly1
Quarterly0 or 1 (billed in quarter months)

The system bills based on completed stops, not expected frequency. If a customer received 3 out of 4 expected weekly services, they are billed for 3.

Payment Terms

Payment terms determine the due date on generated invoices. Configure this in Settings > Billing & Payments.

Common payment terms:

TermDue Date
Due on receiptSame day as invoice
Net 1515 days after invoice date
Net 3030 days after invoice date

Enabling Auto-Billing

  1. Go to Settings > Billing & Payments
  2. Configure your payment terms
  3. Set the default tax rate
  4. Connect Stripe for online payment processing (optional)

Manual Invoice Generation

If you prefer manual control, you can generate invoices from the dashboard:

  1. Go to Billing > Invoices
  2. Click Generate Invoices
  3. Select the billing period
  4. Review the generated invoices
  5. Send them to customers

Invoice Delivery

After invoices are generated, you can send them to customers via email:

  1. Select one or more invoices
  2. Click Send
  3. The customer receives an email with their invoice details and a link to view/pay online

The invoice status changes from draft to sent, and sent_at is recorded.

Payment Processing

Payments can be recorded in multiple ways:

MethodDescription
cardCredit/debit card via Stripe
achBank transfer via Stripe
stripe_onlineCustomer pays via invoice link
tap_to_payIn-person Tap to Pay via driver's phone
card_entryManual card entry
cashCash payment
checkCheck payment

When a payment is recorded, the invoice status changes to paid and paid_at is set.