Imports Locations.

POST

/api/locations/import

Purpose:
This endpoint imports Locations for a company.

Authorization Policies Required:

md_inventory: Ensures the tenant has purchased or subscribed to the inventory module.

manage_inventory: Ensures the user has the required permissions to manage inventory.

Error Scenarios:

If the x-companyId header is missing or invalid, a 400 Bad Request response will be returned.

If the user lacks the required permissions, a 403 Forbidden response will be returned.

Responses:

204 No Content: The Locations were successfully imported.

400 Bad Request: The request was malformed or missing required parameters.

403 Forbidden: The user does not have permission to perform this operation.

Request

Header Params

Body Params application/json

Example

[
    {
        "id": "LOC-1",
        "name": "Central Location",
        "isActive": true,
        "address1": "Kifisias 44",
        "address2": "5th floor",
        "city": "Athens",
        "state": "Attica",
        "country": "Greece",
        "postalCode": "12345"
    },
    {
        "id": "LOC-2",
        "name": "Warehouse",
        "isActive": true,
        "address1": "Kifisias 44",
        "address2": "5th floor",
        "city": "Athens",
        "state": "Attica",
        "country": "Greece",
        "postalCode": "12345"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://platform.shopranos.eu/api/locations/import' \
--header 'x-companyId: b3e68ad4-06c8-4e70-965b-c02b38f66ef2' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "id": "LOC-1",
        "name": "Central Location",
        "isActive": true,
        "address1": "Kifisias 44",
        "address2": "5th floor",
        "city": "Athens",
        "state": "Attica",
        "country": "Greece",
        "postalCode": "12345"
    },
    {
        "id": "LOC-2",
        "name": "Warehouse",
        "isActive": true,
        "address1": "Kifisias 44",
        "address2": "5th floor",
        "city": "Athens",
        "state": "Attica",
        "country": "Greece",
        "postalCode": "12345"
    }
]'

Responses

🟢204No Content

application/json

Body

Example

{}

Modified at 2025-07-08 13:29:55

Location Delete

Retrieve the first location By location id