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
| 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
}
}