Company

Overview

The company module synchronizes company or property master data. Company is the root entity for the Master Data Integration. Other modules reference the company through company_id, so company data must be synchronized before dependent records for a new property.

Request

• Method: POST
• Path: {{base_url}}/api/sync-master-data

Request Envelope

The Company module uses the standard Open API request envelope with company as the module and a single company object as data.

{
  "module": "company", 
  "data": {},
  "chunk_metadata": {}
}

For details on when to use sync modules versus initialization_* modules, see Module Behavior.

Request Body Fields

Field	Type	Required	Description	Example
id	string	Yes	Your source system's company identifier.	HTL-001
code	string	Yes	Short company code.	HTL001
business_type	string	Yes	Company business type. Must be HOTEL or RETAIL.	HOTEL
timezone	string	Yes	IANA timezone string.	Asia/Jakarta
name	string	Yes	Company or property name.	Grand Nusantara Hotel
total_room	number	Yes	Total number of rooms for the property.	80
address	string	Optional	Company or property address.	Jl. Sudirman No. 1, Jakarta
country	string	Optional	Country of the company or property.	ID
google_map_url	string	Optional	Google Maps URL for the company or property.	https://maps.google.com/
base_currency_code	string	Yes	Base currency code used by the company or property.	IDR
property_region	string	Optional	Region associated with the property.	JAVA
latitude	number	Optional	Property latitude coordinate.	-6.2
longitude	number	Optional	Property longitude coordinate.	106.8
logo	string	Optional	URL of the company or property logo.	https://cdn.example.com/htl001/logo.png

Request Example

{
  "module": "company",
  "data": {
    "id": "HTL-001",
    "code": "HTL001",
    "business_type": "HOTEL",
    "timezone": "Asia/Jakarta",
    "name": "Grand Nusantara Hotel",
    "total_room": 80,
    "address": "Jl. Sudirman No. 1, Jakarta",
    "country": "ID",
    "google_map_url": "https://maps.google.com/",
    "base_currency_code": "IDR",
    "property_region": "JAVA",
    "latitude": -6.2,
    "longitude": 106.8,
    "logo": "https://cdn.example.com/htl001/logo.png"
  },
  "chunk_metadata": {
    "process_id": "sync-htl001-2026-08-30",
    "chunk_sequence": 1,
    "is_last_chunk": true,
    "total_records_in_chunk": 1
  }
}