Stores

Frequency:

Store (customer) master data changes are required to be sent in near real-time. Any change in any field listed in this interface should trigger sending the store to DSMDS.

Expected data:

Only active stores and their master data updates are expected by default.

When a store becomes inactive, send an update with is_active = false. After that, no further updates are expected for that store unless it becomes active again.

When a store becomes active again, send the full store master data for that store.

Technical:

If a store record does not exist in DSMDS, the record will be created.

If a store record already exists in DSMDS, the existing record will be updated with the new data.

Stores are matched by id within the organization.

An update replaces the whole store: an omitted street, city or country is cleared, and an omitted is_active makes the store inactive. Always send the full record.

A store with a blank id is skipped with the warning Customer data does not have an ID, and a store with a blank title is skipped with the warning Customer data does not have a title. The other stores are still processed. These warnings do not identify the skipped record.

The request is processed in a single transaction. If a store cannot be saved (e.g., a value is longer than 255 characters), the request fails with 409 and no stores from the request are saved.

---

POST https://{url}/stores/v1

Create or update stores.

The same endpoint is also available as POST https://{url}/customers/v1.

Request Body

The request body is a JSON array of objects with the following fields.

Name	Type	Required	Description
id	string	Yes	Store unique identifier in the external system, stable over time
title	string	Yes	Store name
street	string	No	Street address
city	string	No	City
country	string	No	ISO 3166-1 alpha-2 country code expected (e.g., LV, LT, SE). Not validated; stored as sent
is_active	boolean	No	Whether the store is active. Defaults to false if omitted

Request Example

[
    {
        "id": "P0000035",
        "title": "Store Riga",
        "street": "Brivibas iela 154",
        "city": "Riga",
        "country": "LV",
        "is_active": true
    },
    {
        "id": "P0000036",
        "title": "Store Vilnius",
        "street": "Gedimino pr. 158",
        "city": "Vilnius",
        "country": "LT",
        "is_active": true
    }
]

Response

200: OK — Success

{
    "success": true,
    "message": "",
    "data": null,
    "warnings": []
}

200: OK — Success with warnings

{
    "success": true,
    "message": null,
    "data": null,
    "warnings": [
        "Customer data does not have a title"
    ]
}

200: OK — Error

{
    "success": false,
    "message": "Failed to map JSON",
    "data": null,
    "warnings": []
}