Skip to content

Customers

The Customers entity represents individual users or clients within the system, including their authentication, financial state, and access permissions.

Fields

FieldTypeDescription
idIntegerUnique identifier (Primary Key).
nameStringFull name of the customer.
emailStringEmail address.
cardIdStringPhysical card identifier (e.g., RFID).
companyRelationThe company this customer belongs to.
externalIdStringExternal system reference ID.
isBlockedBooleanWhether the customer account is locked.
isCreditAllowedBooleanFlag indicating if the customer can have a negative balance.
totalDebtFloatCurrent total debt amount.
debtDataJSONDetailed technical debt information.
paymentCardStringLinked payment card identifier (masked).
defaultBooleanFlag for default system customers.
createdAtDateTimeMetadata: Creation timestamp.
updatedAtDateTimeMetadata: Last update timestamp.

Get List of Customers

Endpoint: POST /core/data/Customers/select

Example Request:

json
{
  "fields": {
    "id": true,
    "name": true,
    "email": true,
    "isBlocked": true,
    "company": { "id": true }
  },
  "conditions": {
    "operator": "and",
    "filters": [
      {
        "field": "isBlocked",
        "comparator": "=",
        "value": false
      }
    ]
  },
  "orderBy": [
    {
      "field": "name",
      "order": "asc"
    }
  ],
  "limit": 100,
  "offset": 0
}

Get Single Customer

Endpoint: POST /core/data/Customers/select

Example Request:

json
{
  "fields": {
    "id": true,
    "name": true,
    "cardId": true,
    "totalDebt": true,
    "isCreditAllowed": true
  },
  "conditions": {
    "filters": [
      {
        "field": "id",
        "comparator": "=",
        "value": 123
      }
    ]
  },
  "limit": 1
}

Create Customer

Endpoint: POST /core/data/Customers/insert

Example Request:

json
{
  "fields": [
    {
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "cardId": "A1B2C3D4",
      "company": { "id": 42 },
      "isCreditAllowed": true
    }
  ]
}

Update Customer

Endpoint: POST /core/data/Customers/update/{id}

Example Request:

json
{
  "fields": {
    "isBlocked": true,
    "name": "Jane Smith"
  }
}

Delete Customers

Endpoint: POST /core/data/Customers/remove

Example Request:

json
{
  "conditions": {
    "operator": "and",
    "filters": [
      {
        "field": "id",
        "comparator": "in",
        "value": [123, 124]
      }
    ]
  }
}