propose_allocation

Tạo đề xuất khớp giao dịch với hoá đơn/bill. Thao tác này đưa vào hàng chờ duyệt hai người (approval_requests) với trạng thái pending_approval và actor mcp:<grant_id>. Người cấp quyền MCP đóng vai trò maker và KHÔNG THỂ tự duyệt.

Thông tin

• Tiêu đề: Đề xuất gạch nợ giao dịch
• Scope: reconcile:propose
• Nhóm tốc độ (rate_class): mcp
• Mount: full
• Có từ phiên bản: 0.1.0

Chú thích hành vi

Gợi ý	Giá trị	Ý nghĩa
Chỉ đọc (readOnlyHint)	false	Công cụ có thể tạo hoặc thay đổi dữ liệu.
Phá hủy (destructiveHint)	false	Không xóa và không ghi đè dữ liệu hiện có.
Idempotent (idempotentHint)	true	Gọi lặp lại với cùng tham số cho cùng kết quả.
Thế giới mở (openWorldHint)	false	Công cụ chỉ làm việc với dữ liệu trong Dòng Tiền Pro, không gọi hệ thống bên ngoài.

Tham số đầu vào

Tên	Kiểu	Bắt buộc	Mô tả
tx_id	string	Có	ID giao dịch cần khớp (tx_...)
amount	number	Không	Số tiền gạch nợ (VND, mặc định toàn bộ)
bill_id	string	Không	ID bill bán hàng đối ứng
dry_run	boolean	Không	Mặc định true: chỉ kiểm tra tính hợp lệ mà không tạo yêu cầu duyệt
invoice_id	string	Không	ID hoá đơn đối ứng
note	string	Không	Ghi chú giải trình đề xuất

Kết quả trả về

Công cụ này không có outputSchema.

REST tương ứng

• POST /v1/allocations · nhóm Đối soát · Xem trong Scalar