Nhảy đến nội dung

getOrderByMarkerAndId

Lấy một đơn hàng theo marker và id từ đối tượng lưu trữ đơn hàng được tạo bởi người dùng. 🔐 Phương thức này yêu cầu ủy quyền.

Mô tả

Phương thức này truy xuất một đối tượng lưu trữ đơn hàng theo marker và id. Nó trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng IOrderByMarkerEntity.

Orders.getOrderByMarkerAndId(

marker, id, langCode

);

Sơ đồ tham số

Sơ đồ

marker(bắt buộc): string
Định danh văn bản của đối tượng lưu trữ đơn hàng
ví dụ: "order_storage_1"

id(bắt buộc): number
ID của đối tượng đơn hàng
ví dụ: 12345

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

Ví dụ

Ví dụ tối thiểu

const response = await Orders.getOrderByMarkerAndId('my-order', 1764);

Ví dụ với các thuộc tính

const response = await Orders.getOrderByMarkerAndId('my-order', 1764, 'en_US');

Ví dụ phản hồi

{
"id": 205,
"storageId": 1,
"createdDate": "2025-07-18T05:51:09.924Z",
"statusIdentifier": "inProgress",
"formIdentifier": "orderForm",
"formData": [
{
"marker": "order_name",
"type": "string",
"value": "Ivan"
}
],
"attributeSetIdentifier": "order_form",
"totalSum": "50.00",
"currency": "usd",
"paymentAccountIdentifier": "stripe",
"paymentAccountLocalizeInfos": {
"title": "Stripe"
},
"products": [
{
"id": 2954,
"title": "Box",
"sku": null,
"previewImage": null,
"price": 50,
"quantity": 1
}
],
"isCompleted": false
}

Sơ đồ phản hồi

Sơ đồ: IOrderByMarkerEntity

id: number
Định danh của đối tượng.
ví dụ: 125

storageId: number
Định danh của đối tượng lưu trữ đơn hàng.
ví dụ: 1

createdDate: string
Ngày khi đơn hàng được tạo.
ví dụ: "2023-10-01T12:00:00Z"

statusIdentifier: string
Định danh văn bản của trạng thái đơn hàng.
ví dụ: "order-status-1"

formIdentifier: string
Định danh văn bản của biểu mẫu.
ví dụ: "bar-orders-form"

formData: IOrdersFormData[]
Dữ liệu được gửi bởi biểu mẫu liên kết với kho đơn hàng.
ví dụ:

[
{
"marker": "order_name",
"value": "Ivan",
"type": "string"
}
]

attributeSetIdentifier: string | null
Định danh văn bản của bộ thuộc tính.
ví dụ: "attribute-set-1"

totalSum: string
Tổng số tiền của đơn hàng.
ví dụ: "100.00"

currency: string
Tiền tệ được sử dụng để thanh toán cho đơn hàng.
ví dụ: "USD"

paymentAccountIdentifier: string | null
Định danh văn bản cho việc thanh toán đơn hàng.
ví dụ: "payment-1"

paymentAccountLocalizeInfos: Record<string, any>
Tên tài khoản thanh toán với sự xem xét đến việc địa phương hóa.
ví dụ:

{
"en_US": "USD Payment",
"ru_RU": "Оплата в долларах США"
}

products: IOrderProducts[]
Mảng các sản phẩm được thêm vào đơn hàng.
ví dụ:

[
{
"id": 1,
"name": "Product 1",
"quantity": 2
}
]

isCompleted: boolean
Chỉ ra rằng đơn hàng đã được hoàn thành.
ví dụ: true