---
title: "Lấy danh sách đăng ký giao/nhận hàng vật chất"
method: GET
path: "/mxv/physical-delivery/history"
tags: ["MXV"]
---

# Lấy danh sách đăng ký giao/nhận hàng vật chất

`GET /mxv/physical-delivery/history`

## Query parameters

- `type` string
- `status` string
- `contract` string
- `fromDate` string
- `toDate` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- FireAntApiModelsMXVMXVPhysicalDeliveryRecord[]
  - `id` integer
  - `userName` string
  - `investorCode` string
  - `type` string — DELIVERY | RECEIVE | DEPOSIT
  - `action` string — REGISTER | DESIGNATED
  - `contract` string
  - `quantity` integer
  - `area` string — HN | HCM (chỉ có khi Type = RECEIVE)
  - `warehouse` string — HN | HCM (chỉ có khi Type = DEPOSIT)
  - `deliveryDate` string — Ngày dự kiến giao Bạc (YYYYMMDD)
  - `refRequestCode` string — Mã TVKD tự sinh từ backend FireAnt
  - `refConfirmationCode` string — Mã MXV cấp khi duyệt thành công - dùng để huỷ/truy vấn
  - `deliveryCode` string — Mã giao hàng (có sau khi TTBT ghép cặp, bên bán dùng cho API designated)
  - `pairingCode` string — Mã nhận hàng (có sau khi TTBT ghép cặp, bên mua dùng cho API designated)
  - `status` string — P=Chờ duyệt | A=Đã duyệt | R=Từ chối | D=Đã giao | RV=Đã nhận
  - `rejectReason` string
  - `transactionDate` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

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