Shops

A shop represents a single sales location, either a brick-and-mortar store or a e-commerce site.

Fields

Mandatory fields

Field	Type	Description
external_id	string	Your unique identifier for the shop.

Optional fields

Field	Type	Description
name	string	Name of the store.
email	string	Email address.
shop_type	string	"offline" for brick-and-mortar stores and "online" for webstores and other online properties.
phone_number	phone_number	Phone number to the store, e.g. `+358101234567`.
street_address	string	Street address of the store, e.g. `Main Street 123`.
city	string	City that the store is in, e.g. `London`.
country	country_code	Two-letter country code, e.g. `GB`.
is_hidden	boolean	Determines whether the shop is hidden from the user interface; defaults to `false`.

Example

To upload new or changed shop information, you may pass them to Custobar using a HTTP POST command, e.g.

curl -X POST -u USER -H "Content-Type: application/json" \
    --data-binary @shops.json https://COMPANY.custobar.com/api/shops/upload/

The shop objects must be provided as a list, wrapped into a JSON object, with a key shops, as shown in the example below.

{
  "shops": [
    {
      "external_id": "BAKER-STREET",
      "name": "Baker Street Boutique",
      "shop_type": "offline",
      "city": "London",
      "country": "GB",
      "COMPANY__opening_hours": "24/7"
    }
  ]
}