---
title: "Truy xuất nguồn gốc sản phẩm vật chất"
method: POST
path: "/mxv/traceability/product"
tags: ["MXV"]
---

# Truy xuất nguồn gốc sản phẩm vật chất

`POST /mxv/traceability/product`

## Request body

- FireAntApiModelsMXVMXVProductTraceabilityRequest — Request từ app FireAnt gửi lên backend khi quét QR trên thỏi Bạc. App gửi nguyên nội dung quét được (thường là URL dạng https://sp.phuquygroup.vn/Home/VM?id=CBETDRX12); backend tự tách mã sản phẩm.
  - `qrContent` string — Nội dung đầy đủ đọc được từ QR code (URL hoặc trực tiếp serial/id).

## Response `200`

Trả về thông tin sản phẩm

- FireAntApiModelsMXVMXVPhysicalDeliveryResponseFireAntApiModelsMXVMXVTraceabilityProduct — Wrapper response của MXV REST API cho các nghiệp vụ giao nhận hàng vật chất. Khác với MXVResponse<T> (dùng status/message/data), các API section 3.3/3.4 trả về success/code/msg/confirmationCode/payload.
  - `time` string — Thời điểm server xử lý
  - `success` boolean — true = thành công, false = lỗi
  - `code` string — Mã kết quả: "0" = thành công
  - `msg` string — Thông báo kết quả (VD: "[0]: Thành công!")
  - `confirmationCode` string — Mã xác nhận đăng ký do MXV cấp (top-level field). End user cần lưu lại để dùng cho API huỷ và truy vấn.
  - `payload` FireAntApiModelsMXVMXVTraceabilityProduct[] — Dữ liệu chi tiết (array, mỗi phần tử chứa confirmationcode)
    - `qrCode` string — Mã QR do nhà sản xuất cấp (VD: 0000541H3N1)
    - `serial` string — Serial sản phẩm (VD: CBETDRX12)
    - `productName` string — Tên sản phẩm (VD: Bạc Thanh Long Phú Quý 999 1KG -M)
    - `productCode` string — Mã sản phẩm (VD: BTL1KGM)
    - `material` string — Chất liệu (VD: Bạc 999)
    - `purity` integer — Hàm lượng (VD: 999)
    - `weightChi` string — Khối lượng quy đổi (chỉ)
    - `weightGram` string — Khối lượng (VD: 1 kg)
    - `origin` string — Xuất xứ (VD: Việt Nam)
    - `manufacturedAt` string, date-time — Ngày xuất xưởng
    - `inspectedAt` string, date-time — Ngày kiểm định
    - `inspectionUnit` string — Đơn vị kiểm định (VD: VGVLab)

## Other responses

- `400` — Thiếu dữ liệu hoặc chưa có tài khoản MXV
- `404` — Không tìm thấy sản phẩm

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) · [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fireant/fireant-restful-api/revisions/12bfdf99ab50/schema)