getCustomers

GET

/getCustomers

This endpoint shall be implemented by the customer system and called by PearlPOS to search for customers.

PearlPOS provides two customer search modes: Simple Search and Advanced Search.

Simple Search

Only B2C customers are supported

Only the following request fields are allowed: "searchString" and "businessUnitID"

Advanced Search

Both B2B and B2C customers are supported

All request fields are allowed except for: "searchString"

Common

All provided request fields should be evaluated using AND logic

Fields that are not applicable for a customer shall be omitted from the response or be set to null

Request

Query Params

Responses

🟢200Success

application/json

Body

🟠404Not found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/getCustomers?searchString&customer&name&phoneNumber&email&street&postCode&city&businessUnitID'

Response Example

200 - B2C customer

[
    {
        "customer": "0005169437",
        "country": false,
        "name": "Customer name",
        "city": "Gjerdsvika",
        "postCode": "6083",
        "region": null,
        "street": "Dekkevegen 5",
        "phoneNumber": "90104922",
        "title": null,
        "email": "test@test.com",
        "image": "sap-icon://customer",
        "creditAmount": 0,
        "customerClub": true,
        "discountReasonCodes": [
            {
                "key": "1b90db4d-13dc-4bea-9ea6-aaf800e8f8d4",
                "text": "300 kr rabatt på alle salgsvarer",
                "descr": "300 kr ekstra rabtt på alle salgsvarer. Gjelder nett og butikk.",
                "source": "NAME_OF_CUSTOMER_CLUB",
                "value": 300,
                "valueType": "MONEY",
                "currency": "NOK"
            },
            {
                "key": "2c34dc5e-56ef-4f89-8abc-de120e567f9a",
                "text": "20% rabatt på nyheter",
                "descr": "20% rabatt på alle nyheter. Gjelder kun i butikk.",
                "source": "NAME_OF_CUSTOMER_CLUB",
                "value": 20,
                "valueType": "PERCENT",
                "currency": null
            }
        ]
    }
]

Modified at 2025-12-12 08:37:07

POSlog

getCustomerOrders