> ## 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.

# Huỷ đăng ký giao hàng vật chất



## OpenAPI

````yaml /vi/openapi/fireant-v1.yaml post /mxv/physical-delivery/cancel
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/cancel:
    post:
      tags:
        - MXV
      summary: Huỷ đăng ký giao hàng vật chất
      operationId: MXV_PhysicalDeliveryCancel
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/FireAnt.Api.Models.MXV.PhysicalCancelRequest
          text/json:
            schema:
              $ref: >-
                #/components/schemas/FireAnt.Api.Models.MXV.PhysicalCancelRequest
      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.PhysicalCancelRequest:
      description: "Request huỷ đăng ký giao hoặc nhận hàng vật chất\r\nChỉ thực hiện được trong giai đoạn FND -> LND"
      type: object
      properties:
        refConfirmationCode:
          description: "Mã xác nhận đăng ký do MXV trả về (confirmationCode) khi đăng ký thành công.\r\nEnd user cần lưu lại giá trị này sau mỗi lần đăng ký."
          type: string
    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.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.