---
title: "Xác nhận nhận hàng vật chất chỉ định (bên mua)"
method: POST
path: "/mxv/physical-receive/designated"
tags: ["MXV"]
---

# Xác nhận nhận hàng vật chất chỉ định (bên mua)

`POST /mxv/physical-receive/designated`

## Request body

- FireAntApiModelsMXVPhysicalReceiveDesignatedRequest — Request xác nhận nhận hàng chỉ định (bên mua bị TTBT chỉ định) Xác nhận thành công khi ký quỹ khả dụng >= ký quỹ giao nhận hàng hoá. Thời hạn: T+1 -> T+5 sau ngày giao dịch cuối cùng
  - `pairingCode` string — Mã nhận hàng chỉ định do MXV gửi qua WebSocket event (warehouseReceiptStatus).
  - `rejectedByReceiver` string — Lựa chọn của bên mua: "0" = Đồng ý tự thực hiện giao nhận, "1" = Uỷ quyền TTBT thực hiện thay (chịu phạt theo quy định MXV)
  - `email` string — Email liên hệ (chỉ điền nếu khác với thông tin trên tài khoản giao dịch)
  - `phone` string — Số điện thoại liên hệ (chỉ điền nếu khác với thông tin trên tài khoản giao dịch)
  - `authorization` FireAntApiModelsMXVMXVAuthorizationInfo — Thông tin người được uỷ quyền giao/nhận Bạc tại kho MSB. KH chỉ uỷ quyền được khi đã có mã CIF tại kho chỉ định.
    - `fullName` string — Họ và tên đầy đủ
    - `dateOfBirth` string — Ngày sinh (YYYYMMDD)
    - `idNumber` string — Số CCCD/CMND/Hộ chiếu
    - `idIssueDate` string — Ngày cấp CCCD
    - `idIssuePlace` string — Nơi cấp CCCD
    - `address` string — Địa chỉ
    - `idImageFront` string — Ảnh CCCD mặt trước (base64 string)
    - `idImageBack` string — Ảnh CCCD mặt sau (base64 string)
    - `email` string — Email
    - `phone` string — Số điện thoại

## Response `200`

OK

- FireAntApiModelsMXVMXVPhysicalDeliveryResponseFireAntApiModelsMXVMXVPhysicalDeliveryPayload — 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` FireAntApiModelsMXVMXVPhysicalDeliveryPayload[] — Dữ liệu chi tiết (array, mỗi phần tử chứa confirmationcode)
    - `confirmationcode` string

---

[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)