looped.shDocs
Looped Invoices

Clients

Manage the people and organizations you invoice

Clients are the "billed to" side of every invoice. Before you can send an invoice, you need at least one client with an email address.

The clients page is at app.looped.sh/invoices/clients.

Anatomy of a client

FieldRequired?Used for
NameYes"Billed to" on documents. Unique per company (case-insensitive)
Client codeoptionalYour account code for the client, such as ABELIA. Shows in the client list, pickers, statements, reports and on documents
EmailYesSending invoices and quotes by email
PhoneoptionalShown on documents for contact
VAT numberoptionalShown on documents where it's required
AddressYes"Billed to" address: line 1 and postal code at least. The client list says No address when there isn't one
Delivery addressoptionalShip-to address, if different
Category and Own price leveloptionalWhich price level the client buys at
Sales codeoptionalThe sales rep the client's quotes and invoices are credited to

A client can be a person (Jane Doe) or a business (Acme Corp). Looped doesn't distinguish.

Creating a client

Two ways:

From the clients page

  1. Open Clients in the Invoices nav.
  2. Click Add Client.
  3. Fill the form and Save.

From a quote or invoice

When the client doesn't exist yet, choose New client in the client picker on a quote or invoice. A modal opens to create them without leaving the document.

The client is saved, becomes the invoice's "billed to", and shows up on the clients page going forward.

Editing a client

Open the client row → Edit (or just click on the client). Change anything except the name (which stays unique per company).

Changes affect future invoices only. An invoice already sent retains the client snapshot it had at send time.

Deleting a client

If a client has no invoices, Delete removes the row.

If they have invoices, deletion is blocked — you'll see a warning. Either:

  • Keep the client around (it doesn't cost anything), or
  • Delete or void the invoices first, then delete the client

This safeguard prevents orphaning invoices that reference a client that no longer exists.

Searching

The clients page has a search bar that matches the client code, name, email, phone and VAT number. Every word you type has to match, in any order. Choose 25, 50 or 100 clients a page.

Pickers on documents show each client as "CODE · Name" and search by either.

The client page

Click a client to open their page: their Balance (or In credit), their documents, and the prices they pay.

Prices for a client

If your company uses Inventory, Prices for this client lists the items the client has their own price for, and All items shows every item at the price they pay now and where it comes from: Their list (their own price level), Category list (their category's level) or Item price (the item's own selling price). Search every item by name or code, then type a price under Their price for the exceptions.

To give the client a printable list of their prices, start a client price list from their page.

Why does each client need an email?

The send action needs somewhere to send the email to. The send button on an invoice is disabled if its client has no email — the tooltip explains why.

If you only ever invoice in person and don't need email sends, that's fine — leave the email blank, save the invoice, and download the PDF manually. But the bulk of the value comes from email + the Pay portal which requires the email.

Importing clients

Bulk import isn't built yet. Until then:

  • Add them one at a time, or
  • Use the Public API (POST /v1/invoices/clients) to script imports from your CRM

Are you an AI? Visit llms.txt — these docs as plain markdown.

On this page