feat: correct first

api_v1/views/business/README.md

@@ -108,7 +108,7 @@
 
 ### 4.1 列表
 - **GET** `/api/v1/payment-orders/`
-- 返回字段：`supplier_name`、`payment_date`、`amount`、`status` 等。
+- 返回字段：`supplier_name`、`payment_date`、`amount`、`status`、`is_external_source`、`external_source_id` 等。
 
 ### 4.2 创建
 - **POST** `/api/v1/payment-orders/`
@@ -120,6 +120,11 @@
 | `amount` | decimal | 付款金额（必须 > 0） |
 | `remarks` | str | 可选 |
 
+列表/详情响应补充字段：
+
+- `is_external_source`：是否来源于外部系统同步。
+- `external_source_id`：外部系统记录 ID，用于关联与审计。
+
 ### 4.3 审批 / 作废
 - **POST** `/api/v1/payment-orders/<id>/review/`
 - `{"action": "approve"}` 或 `{"action": "cancel"}`
@@ -136,6 +141,11 @@
 
 审批通过表示“确认收款”，作废则恢复为初始状态。
 
+列表/详情响应同样包含：
+
+- `is_external_source`
+- `external_source_id`
+
 ---
 
 ## 6. 错误示例

api_v1/views/business/payment/views.py

@@ -19,7 +19,7 @@ class PaymentOrderSerializer(serializers.ModelSerializer):
         fields = [
             'id', 'supplier', 'supplier_name', 'bank_account', 'bank_account_name',
             'payment_date', 'amount', 'discount_amount', 'settlement_amount',
-            'operator', 'operator_name', 'status',
+            'operator', 'operator_name', 'status', 'is_external_source', 'external_source_id',
             'remarks', 'markup', 'created_at', 'updated_at',
         ]
         read_only_fields = [
@@ -29,6 +29,8 @@ class PaymentOrderSerializer(serializers.ModelSerializer):
             'bank_account_name',
             'settlement_amount',
             'status',
+            'is_external_source',
+            'external_source_id',
             'created_at',
             'updated_at',
         ]

api_v1/views/business/receipt/views.py

@@ -19,7 +19,7 @@ class ReceiptOrderSerializer(serializers.ModelSerializer):
         fields = [
             'id', 'customer', 'customer_name', 'bank_account', 'bank_account_name',
             'receipt_date', 'amount', 'discount_amount', 'settlement_amount',
-            'operator', 'operator_name', 'status',
+            'operator', 'operator_name', 'status', 'is_external_source', 'external_source_id',
             'remarks', 'markup', 'created_at', 'updated_at',
         ]
         read_only_fields = [
@@ -29,6 +29,8 @@ class ReceiptOrderSerializer(serializers.ModelSerializer):
             'bank_account_name',
             'settlement_amount',
             'status',
+            'is_external_source',
+            'external_source_id',
             'created_at',
             'updated_at',
         ]

api_v1/views/business/statements/serializers.py

@@ -31,6 +31,7 @@ class StatementRecordSerializer(serializers.Serializer):
     cumulative_amount = serializers.CharField()
     current_balance = serializers.CharField()
     arrears_amount = serializers.CharField()
+    remarks = serializers.CharField(allow_blank=True)
     items = serializers.ListField(child=serializers.DictField())
     extra = serializers.DictField(required=False)