CustomerState

"""A customer entity representing a business or individual client"""
type CustomerState {
  """Unique identifier"""
  id: CustomerID!
  """Customer name (business or individual)"""
  name: String!
  """External system reference for integration"""
  externalId: String
  """Primary email address"""
  email: String
  """Primary phone number"""
  phone: String
  """General notes about the customer"""
  notes: String
  """Whether the customer is active"""
  isActive: Boolean!
  """Credit limit amount (nil = no limit enforced)"""
  creditLimit: Float
  """Currency for credit limit (ISO 4217)"""
  creditCurrency: CurrencyISO
  """Net payment terms in days (0 = prepayment, nil = not set)"""
  paymentTermsDays: Int
  """Whether the customer is on credit hold"""
  isCreditHold: Boolean!
  """Reason for credit hold"""
  creditHoldReason: String
  """Default tax code applied to this customer's documents"""
  defaultTaxCodeId: TaxCodeID
  """Whether the customer is tax exempt"""
  isTaxExempt: Boolean!
  """Tax exemption reference (e.g. VAT registration number)"""
  taxExemptReference: String
  """Creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
  """Contacts for this customer. Requires contact:list permission."""
  contacts: [ContactState!]!
  """Addresses for this customer. Requires address:list permission."""
  addresses: [AddressState!]!
}