> ## 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ý giao hàng vật chất (bên bán) ## OpenAPI ````yaml /vi/openapi/fireant-v1.yaml post /mxv/physical-delivery/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-delivery/register: post: tags: - MXV summary: Đăng ký giao hàng vật chất (bên bán) operationId: MXV_PhysicalDeliveryRegister requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.PhysicalDeliveryRegisterRequest text/json: schema: $ref: >- #/components/schemas/FireAnt.Api.Models.MXV.PhysicalDeliveryRegisterRequest 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.PhysicalDeliveryRegisterRequest: description: "Request đăng ký giao hàng vật chất (bên bán) - API 3.3.1\r\nGiai đoạn FND -> LND" type: object properties: contract: description: 'Mã hợp đồng kỳ hạn (VD: SIV0326)' type: string quantity: format: int32 description: Số lượng lot đăng ký giao (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 nhận lại Bạc (trong trường hợp bên bán đến nhận lại Bạc).\r\nChỉ cung cấp khi KH đã có mã CIF tại kho MSB chỉ định." 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.