Skip to main content

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": {}
}

Request Body Fields

FieldTypeRequiredDescriptionExample
idstringYesYour source system's company identifier.HTL-001
codestringYesShort company code.HTL001
business_typestringYesCompany business type. Must be HOTEL or RETAIL.HOTEL
timezonestringYesIANA timezone string.Asia/Jakarta
namestringYesCompany or property name.Grand Nusantara Hotel
total_roomnumberYesTotal number of rooms for the property.80
addressstringOptionalCompany or property address.Jl. Sudirman No. 1, Jakarta
countrystringOptionalCountry of the company or property.ID
google_map_urlstringOptionalGoogle Maps URL for the company or property.https://maps.google.com/
base_currency_codestringYesBase currency code used by the company or property.IDR
property_regionstringOptionalRegion associated with the property.JAVA
latitudenumberOptionalProperty latitude coordinate.-6.2
longitudenumberOptionalProperty longitude coordinate.106.8
logostringOptionalURL 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
}
}