> ## Documentation Index > Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Đăng ký nhận hàng vật chất (bên mua) ## OpenAPI ````yaml /vi/openapi/fireant-v1.yaml post /mxv/physical-receive/register openapi: 3.1.0 info: version: v1 title: FireAnt RESTFUL API description: Tài liệu đặc tả FireAnt RESTFUL API v1.0.0 servers: - url: https://api.fireant.vn security: [] paths: /mxv/physical-receive/register: post: tags: - MXV summary: Đăng ký nhận hàng vật chất (bên mua) operationId: MXV_PhysicalReceiveRegister requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.PhysicalReceiveRegisterRequest text/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.PhysicalReceiveRegisterRequest responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.MXVPhysicalDeliveryResponseOfMXVPhysicalDeliveryPayload text/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.MXVPhysicalDeliveryResponseOfMXVPhysicalDeliveryPayload security: - oauth2: - user-data-write components: schemas: FireAnt.Api.Models.MXV.PhysicalReceiveRegisterRequest: description: "Request đăng ký nhận hàng vật chất (bên mua) - API 3.3.3\r\nGiai đoạn FND -> LND" type: object properties: area: description: 'Khu vực nhận hàng: "HN" (Hà Nội) hoặc "HCM" (TP HCM)' type: string contract: description: 'Mã hợp đồng kỳ hạn (VD: SIV0326)' type: string quantity: format: int32 description: Số lượng lot đăng ký nhận (phải > 0) type: integer email: description: >- 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) type: string phone: description: >- 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) type: string authorization: $ref: '#/components/schemas/FireAnt.Api.Models.MXV.MXVAuthorizationInfo' description: Thông tin người uỷ quyền đến kho nhận Bạc (nếu có) FireAnt.Api.Models.MXV.MXVPhysicalDeliveryResponseOfMXVPhysicalDeliveryPayload: description: "Wrapper response của MXV REST API cho các nghiệp vụ giao nhận hàng vật chất.\r\nKhác với MXVResponse<T> (dùng status/message/data),\r\ncác API section 3.3/3.4 trả về success/code/msg/confirmationCode/payload." type: object properties: time: description: Thời điểm server xử lý type: string success: description: true = thành công, false = lỗi type: boolean code: description: 'Mã kết quả: "0" = thành công' type: string msg: description: 'Thông báo kết quả (VD: "[0]: Thành công!")' type: string confirmationCode: description: "Mã xác nhận đăng ký do MXV cấp (top-level field).\r\nEnd user cần lưu lại để dùng cho API huỷ và truy vấn." type: string payload: description: Dữ liệu chi tiết (array, mỗi phần tử chứa confirmationcode) type: array items: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.MXVPhysicalDeliveryPayload FireAnt.Api.Models.MXV.MXVAuthorizationInfo: description: "Thông tin người được uỷ quyền giao/nhận Bạc tại kho MSB.\r\nKH chỉ uỷ quyền được khi đã có mã CIF tại kho chỉ định." type: object properties: fullName: description: Họ và tên đầy đủ type: string dateOfBirth: description: Ngày sinh (YYYYMMDD) type: string idNumber: description: Số CCCD/CMND/Hộ chiếu type: string idIssueDate: description: Ngày cấp CCCD type: string idIssuePlace: description: Nơi cấp CCCD type: string address: description: Địa chỉ type: string idImageFront: description: Ảnh CCCD mặt trước (base64 string) type: string idImageBack: description: Ảnh CCCD mặt sau (base64 string) type: string email: description: Email type: string phone: description: Số điện thoại type: string FireAnt.Api.Models.MXV.MXVPhysicalDeliveryPayload: description: "Payload item trả về từ các API đăng ký/huỷ giao nhận vật chất.\r\nLưu ý: MXV trả về tên field là \"confirmationcode\" (chữ thường)." type: object properties: confirmationcode: type: string securitySchemes: oauth2: type: oauth2 flows: implicit: scopes: accounts-read: Đọc danh sách tài khoản giao dịch chứng khoán accounts-write: Liên kết tài khoản chứng khoán orders-read: Đọc danh sách lệnh giao dịch chứng khoán orders-write: Đặt, sửa, hủy lệnh giao dịch chứng khoán companies-read: Đọc thông tin doanh nghiệp companies-write: Tạo mới, cập nhật, xóa thông tin doanh nghiệp individuals-read: Đọc thông tin cá nhân individuals-write: Tạo mới, cập nhật, xóa thông tin cá nhân finance-read: Đọc thông tin tài chính finance-write: Tạo mới, cập nhật, xóa thông tin tài chính posts-write: Đăng bài viết posts-read: Lấy nội dung các bài viết của cộng đồng symbols-read: Đọc thông tin mã chứng khoán symbols-write: Tạo mới, cập nhật, xóa mã chứng khoán users-read: Đọc dữ liệu công khai của người dùng user-data-read: Đọc tất cả dữ liệu của người dùng hiện tại user-data-write: Cập nhật tất cả dữ liệu của người dùng hiện tại search: Tìm kiếm academy-read: Đọc dữ liệu các khóa học academy-write: Đăng ký khóa học blog-read: Đọc dữ liệu blog investopedia-read: Đọc dữ liệu thuật ngữ commodities-read: Đọc dữ liệu hàng hóa phái sinh all_claims: All roles: Role authorizationUrl: https://accounts.fireant.vn/connect/authorize description: OAuth2 Implicit Grant ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.