Core Concepts

Invoices

Understanding billing documents in Gilbert

Invoices are the billing documents that Gilbert generates for your customers. They detail what was charged, calculate taxes, and serve as official records of transactions. Gilbert generates invoices automatically from subscriptions at each billing period.

How Invoices are Created

Gilbert automatically creates invoices from subscriptions. At each billing period:

  1. Subscription reaches its billing date
  2. Gilbert calculates line items and taxes
  3. Invoice is created in Draft status

Invoices remain in Draft until you issue them. To issue an invoice:

  1. Open the invoice
  2. Review the details
  3. Click Issue

Once issued, the customer receives the invoice and payment is expected.


Invoice Statuses

Invoices move through these statuses:

StatusDescription
DraftBeing prepared. Can be confirmed or voided. Not sent to customer.
IssuedFinalized and sent. Cannot be modified. Awaits payment.
PaidPayment received. Complete and closed.
VoidCanceled. Remains for audit purposes.

Requirements for Issuing

Before issuing an invoice, ensure:

  1. Seller information is configured in Settings:
    • Business VAT number
    • Business address
  2. For reverse charge invoices (B2B cross-border):
    • Customer must have a valid VAT number

If requirements are not met, Gilbert displays an error explaining what's missing.

Issued → Paid or Issued → Void

Draft → Void: Drafts can be voided directly without issuing.

Issued invoices past their due date are marked as overdue in the UI.

Invoice Contents

Header Information

  • Invoice number — Unique identifier (format: INV-0001, INV-0002, etc.)
  • Issue date — When the invoice was finalized
  • Due date — Payment deadline (defaults to 30 days after issue date)
  • Seller details — Your business information (captured when issuing)
  • Customer details — Billing name, address, and VAT number
Seller details are captured at the moment of issuing, not when the invoice is created. This allows you to update your tenant settings before issuing drafts.

Line Items

Each line item shows:

FieldDescription
DescriptionProduct/service name
QuantityNumber of units
Unit PricePrice per unit
AmountQuantity × Unit Price

Tax Calculations

Gilbert calculates VAT automatically based on the tax type:

Standard VAT

ProductUnit PriceQtyTotal
Pro Plan€100.001€100.00
Net amount€100.00
Tax rate (21%)
€21.00
Total€121.00

Reverse Charge (B2B cross-border)

ProductUnit PriceQtyTotal
Pro Plan€100.001€100.00
Net amount€100.00
Tax rate (0%)
€0.00
Total€100.00

VAT to be accounted for by recipient (Reverse charge)

Billing Period

Subscription invoices display the billing period covered by the invoice.


Invoice Numbering

Gilbert automatically assigns sequential invoice numbers in the format INV-XXXX (e.g., INV-0001, INV-0002):

  • Sequence — Guaranteed unique and sequential
  • No gaps — Void invoices keep their numbers
  • Immutable — Numbers cannot be changed after issuing
Invoice numbers cannot be changed after the invoice is issued. This ensures audit compliance.

Tax Handling

VAT Calculation

Gilbert calculates VAT based on:

  1. Your business location
  2. Customer location
  3. Customer VAT status (B2B vs B2C)

See VAT & Tax for details.

Tax-Compliant Invoices

Gilbert invoices include all required VAT information:

  • Your VAT number
  • Customer VAT number (if B2B)
  • VAT amounts by rate
  • Reverse charge notices (when applicable)

Proration on Invoices

When a subscription is upgraded mid-period, the invoice shows the credit for the unused portion of the old plan offset against the charge for the new plan:

ProductUnit PriceQtyTotal
Pro Plan (Jan 1-15, credit)€-14.501€-14.50
Enterprise Plan (Jan 15-31)€49.501€49.50
Net amount€35.00
Tax rate (21%)
€7.35
Total€42.35

See Proration for calculation details.