Link Search Menu Expand Document

Business Resource

The Business resource represents a physical store that belongs to a chain in the Spaaza platform. Each business has properties for location information, contact details, and operational settings.

Contents

Introduction

A Business in Spaaza represents a physical store location that is part of a retailer’s chain. The Business resource provides comprehensive information about store details including:

  • Basic information (name, contact details)
  • Location and address information
  • Geographic coordinates
  • Operational settings and preferences
  • Chain association and ownership details

The Business resource supports all standard REST operations and can be identified by either its numeric ID or a unique owner code within a chain.

Available Paths

The Business resource supports the following API paths:

Single Resource Operations

  • GET /resources/business/{id} - Retrieve a single business by ID
  • GET /resources/business?{identifier parameter}={value} - Retrieve a single business (by identifier parameter)
  • POST /resources/business - Create a new resource
  • PATCH /resources/business?{identifier parameter}={value} - Update an existing business (by identifier parameter)
  • PATCH /resources/business/{id} - Update an existing business (by ID)
  • PUT /resources/business?{identifier parameter}={value} - Update an existing business (by identifier parameter)
  • PUT /resources/business/{id} - Update an existing business (by ID)
  • DELETE /resources/business?{identifier parameter}={value} - Delete a business (by identifier parameter)
  • DELETE /resources/business/{id} - Delete a business (by ID)

Note: For single business retrieval by identifier parameter, you can use any property marked with identifier: true in the “Spaaza Vendor Attributes” column in the Properties table below.

Multiple Resource Operations

  • GET /resources/businesses - Retrieve a list of businesses with optional filtering and pagination

Properties

The Business resource includes the following properties, listed alphabetically:

Name Description Standard Attributes(details) Spaaza Vendor Attributes(details)
address_1 Store address line 1 type: string
nullable: true
maxLength: 255
recursionLevel: 2
address_2 Store address line 2 type: string
nullable: true
minLength: 1
maxLength: 255
recursionLevel: 2
address_3 Store address line 3 type: string
nullable: true
maxLength: 255
recursionLevel: 2
chain Chain to which the store belongs type: object
nullable: false
required: [“id”]
recursionLevel: 1
filter-property: true
immutable: true
chain_member Whether this business is a chain member type: boolean
nullable: false
default: true
recursionLevel: 4
operations: [“post”, “put”, “patch”]
country_code Store address ISO 3166-1 alpha-2 2-letter country code type: string
nullable: true
pattern: “^[A-Z]{2}$”
minLength: 2
maxLength: 2
example: “NL”
recursionLevel: 2
filter-property: true
id Business identifier type: integer
readOnly: true
nullable: false
recursionLevel: 0
filter-property: true
operations: [“get”, “put”, “patch”, “delete”]
latitude Store latitude type: float
nullable: true
minimum: -90
maximum: 90
recursionLevel: 2
longitude Store longitude type: float
nullable: true
minimum: -180
maximum: 180
recursionLevel: 2
name Store name type: string
nullable: false
minLength: 1
maxLength: 255
recursionLevel: 1
filter-property: true
required-in: [“post”]
operations: [“post”, “put”, “patch”]
owner_code Store owner code type: string
nullable: true
maxLength: 64
recursionLevel: 1
identifier: true
filter-property: true
operations: [“get”, “post”, “put”, “patch”, “delete”]
required-in: [“post”]
phone_number Store phone number type: string
nullable: true
maxLength: 32
recursionLevel: 2
postalcode Store address postal code type: string
nullable: true
maxLength: 20
recursionLevel: 2
region Store address region type: string
nullable: true
maxLength: 255
recursionLevel: 2
filter-property: true
towncity Store address town or city name type: string
nullable: true
maxLength: 255
recursionLevel: 2
filter-property: true

Property Notes

  • Chain Reference: The chain property refers to the Chain resource. For complete documentation of Chain properties, consult the Chain resource documentation (links will be added when available).
  • Identifier Properties: The owner_code property can be used as an alternative identifier to the numeric id for retrieving, updating, or deleting businesses. Properties marked with identifier: true can be used as identifier parameters for single resource operations.
  • Filter Properties: Properties marked with filter-property: true can be used to filter results when retrieving multiple businesses.
  • Recursion Levels: The recursionLevel attribute controls at which API response detail levels each property is included.
  • Required Fields: Properties marked with required-in: ["post"] are required when creating new businesses.
  • Operations: The operations attribute indicates which HTTP methods can use each property as a parameter.

Sample Business JSON

Here is an example of a Business resource as returned by the API:

{
  "address_1": "Damrak 123",
  "address_2": "Unit 4B",
  "address_3": null,
  "chain": {
    "id": 1743,
    "name": "Example Retail Chain"
  },
  "chain_member": true,
  "country_code": "NL",
  "id": 12345,
  "latitude": 52.3713,
  "longitude": 4.8910,
  "name": "Amsterdam Central Store",
  "owner_code": "AMS001",
  "phone_number": "+31 20 123 4567",
  "postalcode": "1012 LP",
  "region": "North Holland",
  "towncity": "Amsterdam"
}

This example shows a typical Business resource with location information, chain association, and operational settings.