BOP DatabopDATA
Tìm dữ liệu...⌘K
Sẵn sàng
VI
SCHEMA REGISTRY

Data Schemas

Trang này đọc trực tiếp schema-family registry. Không duy trì các schema mẫu riêng cho từng dataset.

Public dataset envelope

Mọi adapter bên ngoài dùng cùng một khung object.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
canonicalIdstringCó
Mã định danh bất biến của dataset.
identityobjectCó
Taxonomy, title, scope, geography, schema ID/version.
data.highlightsHighlightItem[]Có
Instant result có cấu trúc label + value + unit + context?.
data.columnsColumn[]Không
Định nghĩa cột bảng hiện hành.
data.recordsRecord[]Có
Các dòng dữ liệu có cấu trúc của dataset.
freshnessobjectCó
Version, trạng thái, ngày cập nhật, chu kỳ và chính sách refresh.
provenanceobjectCó
Nguồn, publisher, URL, source date, license và redistribution.
linksobjectCó
HTML, JSON, CSV và Embed của cùng dataset.

Schema families

19 hợp đồng family hiện có trong registry.

API contract →
bop.statistical-seriesChuỗi thống kê
v2.2.0
Family: statistical_seriesSemantic type: statistical_seriesRenderer: fallbackCoverage: requested-dimensions

Identity keys: name + geography + period

Coverage complete when: Every indicator/geography/period row in the named source table and declared scope is included; selected examples do not qualify.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
namestringCó
Tên / chỉ tiêu · semantic role: identity
periodperiodCó
Kỳ dữ liệu · semantic role: time
geographystringCó
Địa bàn · semantic role: geography
valuenumberCó
Giá trị · semantic role: measure
unitstringCó
Đơn vị · semantic role: classification
frequencystringKhông
Tần suất · semantic role: classification
methodologystringKhông
Phương pháp · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.statistical-cubeBảng thống kê đa chiều
v2.3.1
Family: statistical_cubeSemantic type: statistical_cubeRenderer: fallbackCoverage: requested-dimensions

Identity keys: name + period + geography + category + scenario + variable · name + period + geography + category + scenario · name + period + geography + category + variable · name + period + geography + category

Coverage complete when: All declared dimension combinations from one named published table or bounded query are present, including explicit missing/suppressed cells when the source defines them.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
namestringCó
Tên / chỉ tiêu · semantic role: identity
periodperiodCó
Kỳ dữ liệu · semantic role: time
geographystringCó
Địa bàn · semantic role: geography
categorystringCó
Phân tổ · semantic role: classification
valuenumberCó
Giá trị · semantic role: measure
unitstringCó
Đơn vị · semantic role: classification
scenariostringKhông
Kịch bản · semantic role: classification
variablestringKhông
Biến · semantic role: classification
methodologystringKhông
Phương pháp · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.entity-registryDanh mục thực thể
v2.2.0
Family: entity_registrySemantic type: entity_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · name + geography + category

Coverage complete when: Every entity in the specifically named current registry/list publication is included; the registry boundary and edition are identified.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
geographystringKhông
Địa bàn · semantic role: geography
categorystringKhông
Phân loại · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
effective_datedateKhông
Ngày hiệu lực · semantic role: time
descriptionstringKhông
Mô tả · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.facility-registryDanh mục cơ sở
v2.2.0
Family: facility_registrySemantic type: facility_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · name + facility_type + geography

Coverage complete when: Every facility in one named authoritative registry or bounded official publication is represented; do not imply a global inventory from samples.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
facility_typestringCó
Loại cơ sở · semantic role: classification
geographylocationCó
Địa bàn · semantic role: geography
operatorstringKhông
Đơn vị vận hành · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
capacitynumberKhông
Công suất · semantic role: measure
unitstringKhông
Đơn vị · semantic role: classification
addressstringKhông
Địa chỉ · semantic role: geography
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.organization-directoryDanh bạ tổ chức
v2.3.0
Family: organization_directorySemantic type: organization_directoryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · registry_id · name + geography + organization_type

Coverage complete when: All organizations in the named register or explicitly bounded official directory are included.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
organization_typestringKhông
Loại tổ chức · semantic role: classification
geographylocationKhông
Địa bàn · semantic role: geography
statusstringKhông
Trạng thái · semantic role: classification
registry_idstringKhông
Mã đăng ký · semantic role: classification
websitestringKhông
Website · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.service-directoryDanh mục dịch vụ
v2.3.0
Family: service_directorySemantic type: service_directoryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · name + provider

Coverage complete when: All entries in the complete authoritative service directory within the dataset's declared scope are included; identify the directory owner, publication/snapshot boundary, pagination and known exclusions.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
service_typestringCó
Loại dịch vụ · semantic role: classification
providerstringCó
Đơn vị cung cấp · semantic role: classification
geographystringKhông
Địa bàn · semantic role: geography
eligibilitystringKhông
Điều kiện tiếp cận · semantic role: classification
channelstringKhông
Kênh cung cấp · semantic role: classification
contactstringKhông
Liên hệ · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
official_urlurlKhông
Trang chính thức · semantic role: provenance
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.market-snapshotẢnh chụp thị trường
v2.3.0
Family: market_snapshotSemantic type: market_snapshotRenderer: fallbackCoverage: source-snapshot

Identity keys: name + metric + market + geography + observation_date · name + metric + geography + observation_date

Coverage complete when: All products/instruments and quote metrics (such as bid/ask or buy/sell) in the publisher board at one explicit observation time are included.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
namestringCó
Tên / chỉ tiêu · semantic role: identity
metricstringCó
Chỉ tiêu báo giá · semantic role: classification
observation_datedateCó
Ngày quan sát · semantic role: time
geographystringCó
Địa bàn · semantic role: geography
valuescalarCó
Giá trị · semantic role: measure
unitstringCó
Đơn vị · semantic role: classification
marketstringKhông
Thị trường · semantic role: classification
currencystringKhông
Tiền tệ · semantic role: classification
source_timestampstringKhông
Thời điểm nguồn · semantic role: time
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.crypto-market-pricesBảng giá tài sản số
v1.0.0
Family: crypto_market_pricesSemantic type: crypto_market_pricesRenderer: fallbackCoverage: source-snapshot

Identity keys: coin_id + source_timestamp

Coverage complete when: The declared top-10-by-market-cap CoinGecko asset snapshot is complete at the captured time; each row uses the same CoinGecko coin identity, USD and VND quotes, 24-hour percentage change, and USD market capitalization. Do not substitute a calculated VND conversion for CoinGecko’s VND quote.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
coin_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên coin · semantic role: identity
symbolstringCó
Mã tài sản · semantic role: identity
price_usdnumberCó
Giá (USD) · semantic role: measure · unit: USD/coin
price_vndnumberCó
Giá (VND) · semantic role: measure · unit: VND/coin
change_24h_percentnumberCó
Thay đổi 24 giờ (%) · semantic role: measure · unit: %
market_cap_usdnumberCó
Vốn hóa (USD) · semantic role: measure · unit: USD
source_timestampstringCó
Ngày snapshot nguồn · semantic role: time
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.legal-rule-tableBảng quy định pháp lý
v2.3.0
Family: legal_rule_tableSemantic type: legal_rule_tableRenderer: fallbackCoverage: source-snapshot

Identity keys: document_number + name · record_id · name + effective_date

Coverage complete when: All rules, thresholds, categories, and exceptions in the named law/version or bounded official table are represented.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
document_numberstringKhông
Số hiệu · semantic role: classification
issuing_authoritystringKhông
Cơ quan ban hành · semantic role: classification
effective_datedateKhông
Ngày hiệu lực · semantic role: time
issue_datestringKhông
Ngày ban hành · semantic role: classification
statusstringKhông
Tình trạng · semantic role: classification
categorystringKhông
Phân loại · semantic role: classification
descriptionstringCó
Nội dung · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.classification-referenceBảng mã và phân loại
v2.2.0
Family: classification_referenceSemantic type: classification_referenceRenderer: fallbackCoverage: source-snapshot

Identity keys: code + version · record_id · name + parent_code + version

Coverage complete when: All codes at each declared hierarchy level, including auxiliary/unspecified codes included by the source, are represented for the selected edition.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
codestringCó
Mã · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
parent_codestringKhông
Mã cấp trên · semantic role: classification
levelstringKhông
Cấp phân loại · semantic role: classification
categorystringKhông
Nhóm · semantic role: classification
descriptionstringKhông
Định nghĩa · semantic role: description
versionstringKhông
Phiên bản · semantic role: classification
published_atdateKhông
Thời điểm công bố · semantic role: time
geographystringKhông
Địa bàn · semantic role: geography
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.event-feedDòng sự kiện
v2.7.0
Family: event_feedSemantic type: event_feedRenderer: fallbackCoverage: bounded-window

Identity keys: record_id · name + occurred_at + geography

Coverage complete when: Every source item in the explicitly stated completed time window and event class is included; state pagination/window boundaries.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
occurred_atdateCó
Thời điểm xảy ra · semantic role: time
published_atdateKhông
Thời điểm công bố · semantic role: time
geographylocationKhông
Địa bàn · semantic role: geography
categorystring_or_string_listKhông
Loại sự kiện · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
descriptionstringKhông
Mô tả · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.alert-feedDòng cảnh báo
v2.2.0
Family: alert_feedSemantic type: alert_feedRenderer: fallbackCoverage: bounded-window

Identity keys: record_id · name + published_at + geography · name + published_at

Coverage complete when: All active alerts or alerts issued in the declared bounded window from the named official alert feed are included.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
published_atdateCó
Thời điểm công bố · semantic role: time
geographystringKhông
Địa bàn · semantic role: geography
categorystringKhông
Loại cảnh báo · semantic role: classification
severitystringKhông
Mức độ · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
descriptionstringKhông
Nội dung cảnh báo · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.permit-license-registryDanh mục giấy phép
v2.3.0
Family: permit_license_registrySemantic type: permit_license_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: license_number · record_id · name + authority

Coverage complete when: All licenses or licensed entities in the named authority register or bounded published list are included, with pagination and status filters accounted for; when the publication reports assessment outcomes rather than per-license particulars, preserve that distinction and use the publication edition as the snapshot date.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
license_numberstringKhông
Số giấy phép · semantic role: classification
holderstringKhông
Chủ thể được cấp · semantic role: classification
authoritystringCó
Cơ quan cấp · semantic role: classification
issue_datestringKhông
Ngày cấp · semantic role: classification
effective_datedateKhông
Ngày hiệu lực · semantic role: time
expiry_datestringKhông
Ngày hết hạn · semantic role: classification
statusstringCó
Trạng thái · semantic role: classification
geographylocationKhông
Địa bàn · semantic role: geography
categorystringKhông
Loại giấy phép · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.infrastructure-registryDanh mục hạ tầng
v2.2.0
Family: infrastructure_registrySemantic type: infrastructure_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · name + infrastructure_type + geography

Coverage complete when: Every named asset in the declared official registry/publication is included; planned assets are distinguished from commissioned assets.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
infrastructure_typestringCó
Loại hạ tầng · semantic role: classification
geographylocationCó
Địa bàn · semantic role: geography
capacitynumberKhông
Công suất · semantic role: measure
unitstringKhông
Đơn vị · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
operatorstringKhông
Đơn vị vận hành · semantic role: classification
commissioned_datestringKhông
Ngày vận hành · semantic role: classification
descriptionstringKhông
Mô tả · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.transport-network-registryMạng lưới giao thông
v2.3.0
Family: transport_network_registrySemantic type: transport_network_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · trip_code + origin + destination + departure_time · name + origin + destination + geography + departure_time · name + origin + destination + geography

Coverage complete when: All links/assets or services in one named official network plan, timetable, or bounded operational register are included; identify the publication boundary, validity window, and distinguish planned from operating infrastructure.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
network_typestringCó
Loại mạng lưới · semantic role: classification
originstringKhông
Điểm đầu · semantic role: classification
destinationstringKhông
Điểm cuối · semantic role: classification
geographylocationKhông
Địa bàn · semantic role: geography
lengthnumberKhông
Chiều dài · semantic role: measure
unitstringKhông
Đơn vị · semantic role: classification
capacitynumberKhông
Năng lực · semantic role: measure
statusstringKhông
Trạng thái · semantic role: classification
operatorstringKhông
Đơn vị vận hành · semantic role: classification
trip_codestringKhông
Mã chuyến/tuyến · semantic role: classification
departure_timestringKhông
Giờ khởi hành · semantic role: classification
arrival_timestringKhông
Giờ đến · semantic role: classification
operating_daysstring_listKhông
Ngày hoạt động · semantic role: classification
valid_fromdateKhông
Ngày bắt đầu áp dụng · semantic role: time
valid_todateKhông
Ngày kết thúc áp dụng · semantic role: time
effective_datedateKhông
Ngày hiệu lực · semantic role: time
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.environmental-observationQuan trắc môi trường
v2.5.0
Family: environmental_observationSemantic type: environmental_observationRenderer: fallbackCoverage: bounded-window

Identity keys: record_id · name + indicator + station + geography + observation_date · name + indicator + geography + observation_date · name + indicator + station + geography + period · name + indicator + geography + period

Coverage complete when: All measurements in the declared station/site or geographic set and completed observation window/source-defined period are present; station is optional when the source observation is geographically identified without a station. Latest notice alone is not a complete event or observation feed.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
indicatorstringCó
Chỉ tiêu · semantic role: classification
observation_datedateKhông
Ngày quan sát · semantic role: time
periodperiodKhông
Kỳ dữ liệu · semantic role: time
geographylocationCó
Địa bàn · semantic role: geography
stationstringKhông
Trạm/điểm · semantic role: classification
valuenumberCó
Giá trị · semantic role: measure
unitstringCó
Đơn vị · semantic role: classification
statusstringKhông
Trạng thái · semantic role: classification
descriptionstringKhông
Mô tả · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.project-registryDanh mục dự án
v2.3.1
Family: project_registrySemantic type: project_registryRenderer: fallbackCoverage: authoritative-registry

Identity keys: record_id · name + geography + project_type

Coverage complete when: All projects in the named official programme, permit batch, or bounded publication are included; distinguish approved, planned, under-construction, and completed status. If the source includes a parent project roll-up alongside a distinct child/component line that repeats the name, project_type is part of the composite identity and must distinguish the source row role.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
namestringCó
Tên / chỉ tiêu · semantic role: identity
project_typestringCó
Loại dự án · semantic role: classification
developerstringKhông
Chủ đầu tư · semantic role: classification
geographylocationCó
Địa bàn · semantic role: geography
statusstringCó
Trạng thái · semantic role: classification
capacitynumberKhông
Công suất · semantic role: measure
unitstringKhông
Đơn vị · semantic role: classification
investment_valuenumberKhông
Vốn đầu tư · semantic role: measure
currencystringKhông
Tiền tệ · semantic role: classification
start_datestringKhông
Ngày bắt đầu · semantic role: classification
completion_datestringKhông
Ngày hoàn thành · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.trade-cubeBảng thương mại đa chiều
v2.3.0
Family: trade_cubeSemantic type: trade_cubeRenderer: fallbackCoverage: requested-dimensions

Identity keys: period + reporter + partner + flow + commodity + source_table + classification · period + reporter + partner + flow + commodity + source_table · period + reporter + partner + flow + commodity + classification · period + reporter + partner + flow + commodity

Coverage complete when: Every reporter-partner-flow-commodity cell in every declared source table and explicitly bounded completed period/query is present; retain source-table partition where one publication exposes multiple tables.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
periodperiodCó
Kỳ dữ liệu · semantic role: time
reporterstringCó
Nước/vùng báo cáo · semantic role: classification
partnerstringCó
Đối tác · semantic role: classification
flowstringCó
Chiều thương mại · semantic role: classification
commoditystringCó
Hàng hóa/dịch vụ · semantic role: classification
classificationstringKhông
Hệ phân loại · semantic role: classification
source_tablestringKhông
Bảng nguồn · semantic role: classification
valuenumberCó
Giá trị · semantic role: measure
unitstringCó
Đơn vị · semantic role: classification
frequencystringKhông
Tần suất · semantic role: classification
source_urlurlKhông
URL nguồn · semantic role: provenance
bop.geographic-referenceDữ liệu địa lý tham chiếu
v2.2.0
Family: geographic_referenceSemantic type: geographic_referenceRenderer: fallbackCoverage: source-snapshot

Identity keys: code · record_id · name + geography + admin_level

Coverage complete when: All geographic codes/features within the named edition and jurisdiction are included, respecting hierarchy and source-declared omissions.

Trường (Field)Kiểu dữ liệu (Type)Bắt buộcMô tả & Quy cách
record_idstringKhông
Mã định danh · semantic role: identity
codestringKhông
Mã địa lý · semantic role: classification
namestringCó
Tên / chỉ tiêu · semantic role: identity
geographylocationKhông
Địa bàn · semantic role: geography
admin_levelstringKhông
Cấp địa giới · semantic role: classification
parent_codestringKhông
Mã cấp trên · semantic role: classification
latitudenumberKhông
Vĩ độ · semantic role: measure
longitudenumberKhông
Kinh độ · semantic role: measure
descriptionstringKhông
Mô tả · semantic role: description
source_urlurlKhông
URL nguồn · semantic role: provenance