CustomerClients

Customer clients represent end customers of the business - typically companies or individuals who receive invoices. Used for B2B invoicing and customer relationship management.

Storage Location

{customer_id}-customer_client.json

Fields

Field	Type	Required	Description
id	guid	Yes	Unique customer client identifier.
customer_id	integer	Yes	Reference to Customer (tenant).
name	string	Yes	Customer client name (company or individual).
type	string	Yes	Client type: invoice, loyalty, etc.
groups	array	No	v1.3. Groups the client belongs to: array of {"id": <number>, "name": <string>}. Active groups only, ordered by name. Absent when the client has no active groups.

Example

{
  "id": "f9aebcee-e4fe-6a01-e053-0a01000a8e33",
  "customer_id": 10352,
  "name": "TREATS AS",
  "type": "invoice",
  "groups": [{"id": 7, "name": "VIP"}]
}

Example - Multiple Customer Clients

[
  {
    "id": "f9aebcee-e4fe-6a01-e053-0a01000a8e33",
    "customer_id": 10352,
    "name": "TREATS AS",
    "type": "invoice"
  },
  {
    "id": "f9aec709-a148-6ffe-e053-0a01000a2803",
    "customer_id": 10352,
    "name": "TRIPLETEX AS",
    "type": "invoice"
  },
  {
    "id": "fbcb6366-f777-b099-e053-0a01000aaece",
    "customer_id": 10352,
    "name": "EWORK GROUP NORWAY AS",
    "type": "invoice"
  },
  {
    "id": "0873a1b2-d710-7d4d-e065-022248dcba1a",
    "customer_id": 10352,
    "name": "NORGES BANK",
    "type": "invoice"
  }
]

Client Types

Type	Description
invoice	Invoice customer - receives invoices for orders
loyalty	Loyalty program member

Related Entities

• Customers - Parent customer/tenant
• Customer Client Groups - Groups that clients belong to
• CustomerClientCards - Loyalty/membership cards
• Payments - Payments reference customer client via customer_client_id