Customer

Customer Type

Represents a customer entity in the system. Customers are typically associated with picking orders and outbound shipments.

Fields

Field	Type	Description
id	ID!	Unique identifier of the customer
tenantID	UUID!	Tenant identifier
createdAt	Time!	Creation timestamp
createdBy	UUID!	User identifier who created the customer
updatedAt	Time	Last update timestamp
updatedBy	UUID!	User identifier who last updated the customer
deletedAt	Time	Deletion timestamp
deletedBy	UUID!	User identifier who deleted the customer
dataTypeID	UUID	Data type identifier
dataTypeSlug	String	Data type slug
data	Map	Custom data associated with the customer
name	String!	Customer name
code	String	Customer code/identifier
email	String	Customer email address
phone	String	Customer phone number
address	Map	Customer address information
pickingOrders	[PickingOrder!]	Orders associated with this customer

Interfaces

• Node

Usage Example

query {
  customers(
    where: {
      name_CONTAINS: "Acme"
    }
  ) {
    edges {
      node {
        id
        name
        code
        email
        data
        pickingOrders {
          id
          createdAt
          orderitems {
            quantity
            item {
              sku
            }
          }
        }
      }
    }
  }
}

mutation {
  createCustomer(
    input: {
      name: "Acme Corporation",
      code: "ACME-001",
      email: "[email protected]",
      dataTypeSlug: "b2b_customer",
      data: {
        "taxId": "12-3456789",
        "creditLimit": 50000,
        "paymentTerms": "NET30",
        "primaryContact": {
          "name": "John Smith",
          "phone": "[phone]",
          "email": "[email protected]"
        }
      }
    }
  ) {
    customer {
      id
      name
      code
    }
  }
}

Notes

• Customers can have custom data fields via dataType

• Often linked to virtual repositories for shipping

• Can track order history through pickingOrders relationship

• Supports both B2B and B2C scenarios through flexible data model