{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/user/avatar":{"post":{"summary":"Upload Current User Avatar","operationId":"upload_current_user_avatar_user_avatar_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_current_user_avatar_user_avatar_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/google/config":{"get":{"summary":"Google Login Config","operationId":"google_login_config_user_google_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/user/google/login":{"post":{"summary":"Google Login","operationId":"google_login_user_google_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCredential"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/google/bind":{"post":{"summary":"Google Bind","operationId":"google_bind_user_google_bind_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCredential"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/google/status":{"get":{"summary":"Google Binding Status","operationId":"google_binding_status_user_google_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/register":{"post":{"summary":"Register","operationId":"register_user_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/login":{"post":{"summary":"Login For Access Token","operationId":"login_for_access_token_user_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/me":{"get":{"summary":"Read User Me","operationId":"read_user_me_user_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/userInfo":{"get":{"summary":"Read Users Me","operationId":"read_users_me_user_userInfo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/get_hash":{"post":{"summary":"Get String Hash","description":"获取字符串的哈希值","operationId":"get_string_hash_user_get_hash_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_get_string_hash_user_get_hash_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/users/list":{"post":{"summary":"Get Users List","description":"管理员获取所有用户列表（全量获取，不分页）\n按照注册时间倒序，只返回用户基本信息，包含role_id，不包含role和auths","operationId":"get_users_list_user_admin_users_list_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/users/update-type":{"post":{"summary":"Update User Type","description":"管理员修改用户类型","operationId":"update_user_type_user_admin_users_update_type_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateTypeParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/users/create":{"post":{"summary":"Create User Admin","description":"管理员创建新用户\n需要输入账号和密码，可以设置role_id","operationId":"create_user_admin_user_admin_users_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreateAdminParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/users/update":{"post":{"summary":"Update User Admin","description":"管理员维护用户信息\n包含name、mobile、email、avatar、mark、role_id","operationId":"update_user_admin_user_admin_users_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateAdminParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/users/update-self":{"post":{"summary":"Update User Self","description":"普通用户维护自己的用户信息\n包含name、mobile、email、avatar","operationId":"update_user_self_user_users_update_self_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateSelfParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/roles/list":{"post":{"summary":"Get Roles List","description":"管理员获取所有角色列表（全量获取，不分页）\n返回角色及其关联的权限列表","operationId":"get_roles_list_user_admin_roles_list_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/roles/{role_id}":{"get":{"summary":"Get Role Detail","description":"管理员获取角色详情（包含关联的权限列表）","operationId":"get_role_detail_user_admin_roles__role_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Role Id"},"name":"role_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"delete":{"summary":"Delete Role","description":"管理员删除角色\n注意：如果角色已被用户使用，需要先解除关联","operationId":"delete_role_user_admin_roles__role_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Role Id"},"name":"role_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/roles/create":{"post":{"summary":"Create Role","description":"管理员创建角色并绑定权限","operationId":"create_role_user_admin_roles_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/roles/update":{"post":{"summary":"Update Role","description":"管理员更新角色信息（名称和权限）","operationId":"update_role_user_admin_roles_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/auths/list":{"post":{"summary":"Get Auths List","description":"管理员查询所有权限列表\n支持翻页，按照创建时间倒序，支持通过名称、code查询","operationId":"get_auths_list_user_admin_auths_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/user/admin/auths/all":{"get":{"summary":"Get All Auths","description":"管理员获取所有权限（全量获取，不分页）\n用于角色管理时选择权限","operationId":"get_all_auths_user_admin_auths_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/productsku/upload":{"post":{"summary":"Upload Productsku Image Api","description":"上传/覆盖 SKU 图片，固定路径 productsku/{sku_code}.png","operationId":"upload_productsku_image_api_oss_productsku_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_productsku_image_api_oss_productsku_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/productsku/delete":{"post":{"summary":"Delete Productsku Image Api","description":"删除 SKU 图片 productsku/{sku_code}.png","operationId":"delete_productsku_image_api_oss_productsku_delete_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_productsku_image_api_oss_productsku_delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/brand/upload":{"post":{"summary":"Upload Brand Image Api","description":"上传/覆盖品牌图，固定路径 brand/{brand.name}.png","operationId":"upload_brand_image_api_oss_brand_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_brand_image_api_oss_brand_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/brand/delete":{"post":{"summary":"Delete Brand Image Api","description":"删除品牌图 brand/{brand.name}.png","operationId":"delete_brand_image_api_oss_brand_delete_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_brand_image_api_oss_brand_delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierorder/{supplier_order_id}/upload":{"post":{"summary":"Upload Supplierorder File Api","description":"上传供应商订单相关文件","operationId":"upload_supplierorder_file_api_oss_supplierorder__supplier_order_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Order Id"},"name":"supplier_order_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_supplierorder_file_api_oss_supplierorder__supplier_order_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierorder/{supplier_order_id}/list":{"post":{"summary":"Get Supplierorder Files Api","description":"获取供应商订单相关文件列表","operationId":"get_supplierorder_files_api_oss_supplierorder__supplier_order_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Order Id"},"name":"supplier_order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierorder/{supplier_order_id}/delete":{"post":{"summary":"Delete Supplierorder File Api","description":"删除供应商订单文件","operationId":"delete_supplierorder_file_api_oss_supplierorder__supplier_order_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Order Id"},"name":"supplier_order_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_supplierorder_file_api_oss_supplierorder__supplier_order_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/suppliershippinginfo/{supplier_shipping_info_id}/upload":{"post":{"summary":"Upload Suppliershippinginfo File Api","description":"上传供应链货运信息相关文件，支持多文件。file_key 为字段名。","operationId":"upload_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Shipping Info Id"},"name":"supplier_shipping_info_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/suppliershippinginfo/{supplier_shipping_info_id}/list":{"post":{"summary":"Get Suppliershippinginfo Files Api","description":"获取供应链货运信息某字段下的文件列表。","operationId":"get_suppliershippinginfo_files_api_oss_suppliershippinginfo__supplier_shipping_info_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Shipping Info Id"},"name":"supplier_shipping_info_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_get_suppliershippinginfo_files_api_oss_suppliershippinginfo__supplier_shipping_info_id__list_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/suppliershippinginfo/{supplier_shipping_info_id}/delete":{"post":{"summary":"Delete Suppliershippinginfo File Api","description":"删除供应链货运信息文件。filename 为 OSS 对象名最后一段。","operationId":"delete_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Shipping Info Id"},"name":"supplier_shipping_info_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierinvoice/{supplier_invoice_id}/upload":{"post":{"summary":"Upload Supplierinvoice File Api","description":"上传供应商发票相关文件","operationId":"upload_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Invoice Id"},"name":"supplier_invoice_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierinvoice/{supplier_invoice_id}/list":{"post":{"summary":"Get Supplierinvoice Files Api","description":"获取供应商发票相关文件列表","operationId":"get_supplierinvoice_files_api_oss_supplierinvoice__supplier_invoice_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Invoice Id"},"name":"supplier_invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/supplierinvoice/{supplier_invoice_id}/delete":{"post":{"summary":"Delete Supplierinvoice File Api","description":"删除供应商发票文件","operationId":"delete_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Invoice Id"},"name":"supplier_invoice_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/taxinvoice/{tax_invoice_id}/upload":{"post":{"summary":"Upload Taxinvoice File Api","description":"上传税票相关文件","operationId":"upload_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Tax Invoice Id"},"name":"tax_invoice_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/taxinvoice/{tax_invoice_id}/list":{"post":{"summary":"Get Taxinvoice Files Api","operationId":"get_taxinvoice_files_api_oss_taxinvoice__tax_invoice_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Tax Invoice Id"},"name":"tax_invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/taxinvoice/{tax_invoice_id}/delete":{"post":{"summary":"Delete Taxinvoice File Api","operationId":"delete_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Tax Invoice Id"},"name":"tax_invoice_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleorder/{sale_order_id}/upload":{"post":{"summary":"Upload Saleorder File Api","description":"上传销售订单相关文件","operationId":"upload_saleorder_file_api_oss_saleorder__sale_order_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Order Id"},"name":"sale_order_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_saleorder_file_api_oss_saleorder__sale_order_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleorder/{sale_order_id}/list":{"post":{"summary":"Get Saleorder Files Api","description":"获取销售订单相关文件列表","operationId":"get_saleorder_files_api_oss_saleorder__sale_order_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Order Id"},"name":"sale_order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleorder/{sale_order_id}/delete":{"post":{"summary":"Delete Saleorder File Api","description":"删除销售订单文件","operationId":"delete_saleorder_file_api_oss_saleorder__sale_order_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Order Id"},"name":"sale_order_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_saleorder_file_api_oss_saleorder__sale_order_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleinvoice/{sale_invoice_id}/upload":{"post":{"summary":"Upload Saleinvoice File Api","description":"上传销售发票相关文件","operationId":"upload_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Invoice Id"},"name":"sale_invoice_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleinvoice/{sale_invoice_id}/list":{"post":{"summary":"Get Saleinvoice Files Api","description":"获取销售发票相关文件列表","operationId":"get_saleinvoice_files_api_oss_saleinvoice__sale_invoice_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Invoice Id"},"name":"sale_invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/saleinvoice/{sale_invoice_id}/delete":{"post":{"summary":"Delete Saleinvoice File Api","description":"删除销售发票文件","operationId":"delete_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sale Invoice Id"},"name":"sale_invoice_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/warehouseio/{warehouse_io_id}/upload":{"post":{"summary":"Upload Warehouse Io File Api","description":"上传出入库记录图片","operationId":"upload_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__upload_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Io Id"},"name":"warehouse_io_id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/warehouseio/{warehouse_io_id}/list":{"post":{"summary":"Get Warehouse Io Files Api","description":"获取出入库记录图片列表","operationId":"get_warehouse_io_files_api_oss_warehouseio__warehouse_io_id__list_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Io Id"},"name":"warehouse_io_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/warehouseio/{warehouse_io_id}/delete":{"post":{"summary":"Delete Warehouse Io File Api","description":"删除出入库记录图片","operationId":"delete_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Io Id"},"name":"warehouse_io_id","in":"path"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_delete_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__delete_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/temp-url":{"post":{"summary":"Get Temp File Url Api","description":"获取文件的临时访问URL\n路径格式：user_id/xxx/xxx，需要校验用户权限","operationId":"get_temp_file_url_api_oss_temp_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TempFileUrlParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/oss/share-code/temp-url":{"post":{"summary":"Get Temp File Url By Share Code Api","description":"通过分享码获取文件的临时访问URL\n需要校验分享码是否有效、是否过期，以及文件是否属于该服务","operationId":"get_temp_file_url_by_share_code_api_oss_share_code_temp_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCodeTempFileUrlParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/avatar":{"post":{"summary":"Upload Avatar Json","description":"Set the authenticated user's avatar; JSON API keys require explicit manage delegation.","operationId":"upload_avatar_json_files_avatar_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarUploadParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/ocr":{"post":{"summary":"Recognize Document Json","description":"Read ID-card or passport fields from a JPEG/PNG/WebP, without storing the image.","operationId":"recognize_document_json_files_ocr_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OCRParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/images/{kind}/{resource_id}":{"get":{"summary":"Get Business Image","description":"Check the exact tenant-owned object before retrying an uncertain image write.","operationId":"get_business_image_files_images__kind___resource_id__get","parameters":[{"required":true,"schema":{"type":"string","enum":["brand","productsku"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/images/{kind}/{resource_id}/upload":{"post":{"summary":"Upload Business Image","description":"Upload a tenant-owned brand or SKU PNG through a JSON/MCP-compatible route.","operationId":"upload_business_image_files_images__kind___resource_id__upload_post","parameters":[{"required":true,"schema":{"type":"string","enum":["brand","productsku"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageUploadParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/images/{kind}/{resource_id}/delete":{"post":{"summary":"Delete Business Image","description":"Delete the image of a tenant-owned brand or SKU.","operationId":"delete_business_image_files_images__kind___resource_id__delete_post","parameters":[{"required":true,"schema":{"type":"string","enum":["brand","productsku"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/{kind}/{resource_id}/upload":{"post":{"summary":"Upload Document File","description":"Upload an account-owned document using raw base64, maximum 10 MiB decoded.","operationId":"upload_document_file_files__kind___resource_id__upload_post","parameters":[{"required":true,"schema":{"type":"string","enum":["supplierorder","suppliershippinginfo","supplierinvoice","saleorder","saleinvoice","taxinvoice","warehouseio"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/{kind}/{resource_id}/list":{"post":{"summary":"List Document Files","description":"List permitted attachments, including temporary private download URLs.","operationId":"list_document_files_files__kind___resource_id__list_post","parameters":[{"required":true,"schema":{"type":"string","enum":["supplierorder","suppliershippinginfo","supplierinvoice","saleorder","saleinvoice","taxinvoice","warehouseio"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/{kind}/{resource_id}/delete":{"post":{"summary":"Delete Document File","description":"Delete only a filename inside the selected, permitted document.","operationId":"delete_document_file_files__kind___resource_id__delete_post","parameters":[{"required":true,"schema":{"type":"string","enum":["supplierorder","suppliershippinginfo","supplierinvoice","saleorder","saleinvoice","taxinvoice","warehouseio"],"title":"Kind"},"name":"kind","in":"path"},{"required":true,"schema":{"type":"integer","title":"Resource Id"},"name":"resource_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileDeleteParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/files/temp-url":{"post":{"summary":"Get Document File Url","description":"Sign an existing permitted attachment path for 1–86400 seconds.","operationId":"get_document_file_url_files_temp_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TempFileUrlParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/ai/chat":{"post":{"summary":"Chat","description":"Personal model chat. Reuse only returned session handles; attachments are bounded UTF-8 text.","operationId":"chat_ai_chat_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"prompt":{"type":"string","maxLength":128000,"minLength":1,"title":"Prompt"},"session_id":{"type":"string","maxLength":4096,"title":"Session Id"},"appid":{"type":"string","maxLength":128,"title":"Appid"},"stream":{"type":"boolean","title":"Stream","default":true}},"type":"object","required":["prompt"],"title":"Chat"}},"multipart/form-data":{"schema":{"properties":{"prompt":{"type":"string","maxLength":128000,"minLength":1,"title":"Prompt"},"session_id":{"type":"string","maxLength":4096,"title":"Session Id"},"appid":{"type":"string","maxLength":128,"title":"Appid"},"stream":{"type":"boolean","title":"Stream","default":true},"files":{"items":{"type":"string","format":"binary"},"type":"array"}},"type":"object","required":["prompt"]}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/ai/complete":{"post":{"summary":"Complete","description":"JSON model completion for Agents, using the same authenticated conversation handles as chat.","operationId":"complete_ai_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteChat"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/query/sql":{"post":{"summary":"Query","operationId":"query_query_sql_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/suppliers/list":{"post":{"summary":"Get Suppliers List","description":"供应商列表查询；无 supplier_read 时名称脱敏为 *","operationId":"get_suppliers_list_supplier_suppliers_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/suppliers/create":{"post":{"summary":"Create Supplier","description":"创建供应商","operationId":"create_supplier_supplier_suppliers_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/suppliers/{supplier_id}":{"get":{"summary":"Get Supplier Detail","description":"获取供应商详情；无 supplier_read 时名称脱敏为 *","operationId":"get_supplier_detail_supplier_suppliers__supplier_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Id"},"name":"supplier_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"delete":{"summary":"Delete Supplier","description":"删除供应商","operationId":"delete_supplier_supplier_suppliers__supplier_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Id"},"name":"supplier_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/suppliers/{supplier_id}/update":{"post":{"summary":"Update Supplier","description":"更新供应商。路径: POST /suppliers/{supplier_id}/update","operationId":"update_supplier_supplier_suppliers__supplier_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Id"},"name":"supplier_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-sku-code-maps/list":{"post":{"summary":"List Supplier Sku Code Maps","operationId":"list_supplier_sku_code_maps_supplier_supplier_sku_code_maps_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierSkuCodeMapListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/supplier/supplier-sku-code-maps/batch-save":{"post":{"summary":"Batch Save Supplier Sku Code Maps","operationId":"batch_save_supplier_sku_code_maps_supplier_supplier_sku_code_maps_batch_save_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierSkuCodeMapBatchSaveParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/supplier/supplier-sku-code-maps/batch-delete":{"post":{"summary":"Batch Delete Supplier Sku Code Maps","operationId":"batch_delete_supplier_sku_code_maps_supplier_supplier_sku_code_maps_batch_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierSkuCodeMapBatchDeleteParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/supplier/supplier-sku-code-maps/{supplier_id}/snapshot":{"get":{"summary":"Get Supplier Sku Code Map Snapshot","operationId":"get_supplier_sku_code_map_snapshot_supplier_supplier_sku_code_maps__supplier_id__snapshot_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Supplier Id"},"name":"supplier_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sku-map-editor":1}},"/supplier/supplier-sku-code-maps/replace":{"post":{"summary":"Replace Supplier Sku Code Maps","operationId":"replace_supplier_sku_code_maps_supplier_supplier_sku_code_maps_replace_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierSkuCodeMapReplaceParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sku-map-editor":1}},"/supplier/supplier-orders/list":{"post":{"summary":"Get Supplier Orders List","description":"按条件分页查询供应链订单（非全量缓存同步）。","operationId":"get_supplier_orders_list_supplier_supplier_orders_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/cache-sync":{"get":{"summary":"Get Supplier Orders Cache Sync","description":"供应链订单缓存同步：统一返回版本区间增量。","operationId":"get_supplier_orders_cache_sync_supplier_supplier_orders_cache_sync_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Local Supplier Order Version"},"name":"local_supplier_order_version","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/create":{"post":{"summary":"Create Supplier Order","description":"创建草稿及商品；同标识重放只读取当前订单，不再创建或绑定商品。","operationId":"create_supplier_order_supplier_supplier_orders_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-purchase-creation":1}},"/supplier/supplier-orders/by-creation-key/{creation_key}":{"get":{"summary":"Recover Purchase Order Creation","description":"只读恢复本账户当前可见采购单；已删除的创建不能复用。","operationId":"recover_purchase_order_creation_supplier_supplier_orders_by_creation_key__creation_key__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid4","title":"Creation Key"},"name":"creation_key","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-creation-result":1,"x-wholety-purchase-creation":1}},"/supplier/supplier-orders/{order_id}":{"get":{"summary":"Get Supplier Order Detail","description":"获取供应链订单详情；无价格读权限时金额脱敏","operationId":"get_supplier_order_detail_supplier_supplier_orders__order_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/{order_id}/update":{"post":{"summary":"Update Supplier Order","description":"更新供应链订单：审批通过和驳回均需审批权限。\n\n普通状态更新遵守审批及物流顺序，不能直接设置已入库(8)或已分析核算(9)。\n审批后锁定供应商、SKU 和价格；首次实际入库后锁定数量与商品清单。\n历史备注和附件仍可补充。","operationId":"update_supplier_order_supplier_supplier_orders__order_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/{order_id}/delete":{"post":{"summary":"Delete Supplier Order","description":"删除供应商订单","operationId":"delete_supplier_order_supplier_supplier_orders__order_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/{order_id}/settlement-preview":{"post":{"summary":"Preview Supplier Order Cost","description":"按采购原始数量预览每柜体积分摊与 SKU 加权成本；本次体积不会修改商品资料。","operationId":"preview_supplier_order_cost_supplier_supplier_orders__order_id__settlement_preview_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderSettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/{order_id}/settle":{"post":{"summary":"Settle Supplier Order","description":"锁定采购与货运，按每柜体积分摊、按 SKU 加权回写成本；核算后费用和清单冻结。","operationId":"settle_supplier_order_supplier_supplier_orders__order_id__settle_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderSettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-invoices/list":{"post":{"summary":"Get Supplier Invoices List","description":"供应链发票列表查询；无成本读权限时金额脱敏","operationId":"get_supplier_invoices_list_supplier_supplier_invoices_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInvoiceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-scope":1,"x-wholety-finance-date-filter":1}},"/supplier/supplier-invoices/create":{"post":{"summary":"Create Supplier Invoice","description":"创建供应链发票","operationId":"create_supplier_invoice_supplier_supplier_invoices_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInvoiceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/supplier/supplier-invoices/{invoice_id}/update":{"post":{"summary":"Update Supplier Invoice","description":"更新供应链发票","operationId":"update_supplier_invoice_supplier_supplier_invoices__invoice_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInvoiceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/supplier/supplier-invoices/{invoice_id}/delete":{"post":{"summary":"Delete Supplier Invoice","description":"删除供应链发票","operationId":"delete_supplier_invoice_supplier_supplier_invoices__invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/shipping-infos/list":{"post":{"summary":"List Supplier Shipping Infos","description":"供应链货运信息列表；无价格读权限时运费等金额脱敏","operationId":"list_supplier_shipping_infos_supplier_shipping_infos_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierShippingInfoListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/shipping-infos/by-order/{order_id}":{"get":{"summary":"Get Shipping Infos By Order","description":"获取某个供应链订单的所有货运信息；无价格读权限时运费等金额脱敏","operationId":"get_shipping_infos_by_order_supplier_shipping_infos_by_order__order_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/shipping-infos/{info_id}":{"get":{"summary":"Get Supplier Shipping Info","description":"获取单个货运信息详情；无价格读权限时运费等金额脱敏","operationId":"get_supplier_shipping_info_supplier_shipping_infos__info_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/shipping-infos/create":{"post":{"summary":"Create Supplier Shipping Info","description":"为供应链订单创建货运信息","operationId":"create_supplier_shipping_info_supplier_shipping_infos_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierShippingInfoCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/shipping-infos/{info_id}/update":{"post":{"summary":"Update Supplier Shipping Info","description":"更新货运信息：省略字段保持原值，显式 null 清空可空字段。\n\n已核算的费用和汇率仍不可变更。商品清单省略或 null 保持原值，[] 清空。","operationId":"update_supplier_shipping_info_supplier_shipping_infos__info_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierShippingInfoUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-purchase-shipping-patch":1}},"/supplier/shipping-infos/{info_id}/assign-products":{"post":{"summary":"Assign Supplier Shipping Products","description":"一次事务分配采购商品到目标货运，并从其他货运移除相同行。\n\nexpected_plan_ids 和 expected_assignments 必须来自当前订单详情中全部货运的\n完整快照；过期清单返回 409，重新读取核对后再提交。仅改变分柜关系，不重放\n收货、不改数量、运费或付款；已成本核算的订单禁止变更。","operationId":"assign_supplier_shipping_products_supplier_shipping_infos__info_id__assign_products_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCargoAssignment"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-purchase-cargo":1}},"/supplier/shipping-infos/{info_id}/delete":{"post":{"summary":"Delete Supplier Shipping Info","description":"删除货运信息","operationId":"delete_supplier_shipping_info_supplier_shipping_infos__info_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/supplier/supplier-orders/import-batch":{"post":{"summary":"Import Supplier Orders Batch","description":"批量导入供应链订单（历史订单导入专用）。\n\n一次调用 = 一整批（最多 50 单）= 一个事务：整批成功或整批回滚。\n会创建订单、商品快照、货运信息、入库单与库存（带 supplier_order_id）和税票，\n并自动分析核算至 status=9。\n导入金额按商品行计算：product_total 为每行 quantity × supplier_price 按分舍入后求和；\ndiscount 为非正的额外订单折扣，采购 total = product_total + discount，不含税与货运费用。\nsupplier_price 使用 CAD，最多六位小数；税额单独记录，只有订单税额时按商品净额（零额时按数量）分摊到分。\n有非零行税额时，订单税额须与行税额合计一致。传入的 product_total / total 仅作来源参考，不覆盖计算值。\nsource_document_total、source_quantity、source_row_total、source_price、source_price_before_discount\n和 source_price_currency 连同 amounts_reviewed 记录于来源日志，不参与应付计算。\npayments 只登记实际收付款；未提供时不生成付款记录。\n每笔 payments 须提供正 CAD 金额和实际日期；单据金额、到期日和旧 pay_time 字段不作为付款依据。\n付款外币金额与汇率独立于订单外币信息，部分付款不表示货款已结清。\n采购计划与实际收货使用独立快照；子账户只能导入可见供应商的订单。\n子账户须同时拥有订单导入、订单写、审批、成本写、供应链财务、出入库和财务看板（税票）权限。\norder_id 是外部来源单号，系统独立生成订单 ID；按主账户、订单类型与来源单号持久映射并去重。\n修改备注后重试仍会跳过；source_mappings 返回来源单号、系统订单 ID 与本次是否创建。\ncreated_ids 和 payment_order_ids 均为系统订单 ID，后续查询或操作须使用系统订单 ID。\nsource_canceled=N 表示正常单；Y 取消、C 冲销均拒绝进入普通库存与财务导入。\nsource_document_status 只保留来源状态，关闭状态不等于取消或已付款。","operationId":"import_supplier_orders_batch_supplier_supplier_orders_import_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderImportBatchParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderImportBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/agent-calculations/purchase-recommendations":{"post":{"summary":"Calculate Purchase Recommendations","description":"只读采购建议：近90天日均销量×推荐天数；不扣库存/在途，不自动下单。","operationId":"calculate_purchase_recommendations_agent_calculations_purchase_recommendations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRecommendationInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/agent-calculations/container-loading":{"post":{"summary":"Calculate Container Loading","description":"只读装柜体积预览：当前订单数量×SKU单件体积；缺体积时不判断能否装下。","operationId":"calculate_container_loading_agent_calculations_container_loading_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContainerLoadingInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/provinces/list":{"post":{"summary":"Get Provinces List For Sale","description":"地区列表，供商户表单选择所在地区","operationId":"get_provinces_list_for_sale_sale_provinces_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvinceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/stores/list":{"post":{"summary":"Get Stores List","description":"商户列表查询；无 store_read 时名称脱敏为 *","operationId":"get_stores_list_sale_stores_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/stores/create":{"post":{"summary":"Create Store","description":"创建商户","operationId":"create_store_sale_stores_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/stores/{store_id}":{"get":{"summary":"Get Store Detail","description":"获取商户详情；无 store_read 时名称脱敏为 *","operationId":"get_store_detail_sale_stores__store_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/stores/{store_id}/update":{"post":{"summary":"Update Store","description":"更新商户","operationId":"update_store_sale_stores__store_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/stores/{store_id}/delete":{"post":{"summary":"Delete Store","description":"删除商户","operationId":"delete_store_sale_stores__store_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/store-sku-code-maps/list":{"post":{"summary":"List Store Sku Code Maps","operationId":"list_store_sku_code_maps_sale_store_sku_code_maps_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreSkuCodeMapListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-sku-code-maps/batch-save":{"post":{"summary":"Batch Save Store Sku Code Maps","operationId":"batch_save_store_sku_code_maps_sale_store_sku_code_maps_batch_save_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreSkuCodeMapBatchSaveParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-sku-code-maps/batch-delete":{"post":{"summary":"Batch Delete Store Sku Code Maps","operationId":"batch_delete_store_sku_code_maps_sale_store_sku_code_maps_batch_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreSkuCodeMapBatchDeleteParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-sku-code-maps/{store_id}/snapshot":{"get":{"summary":"Get Store Sku Code Map Snapshot","operationId":"get_store_sku_code_map_snapshot_sale_store_sku_code_maps__store_id__snapshot_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sku-map-editor":1}},"/sale/store-sku-code-maps/replace":{"post":{"summary":"Replace Store Sku Code Maps","operationId":"replace_store_sku_code_maps_sale_store_sku_code_maps_replace_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreSkuCodeMapReplaceParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sku-map-editor":1}},"/sale/store-addresses/list":{"post":{"summary":"Get Store Addresses List","description":"商户地址列表（含 province）","operationId":"get_store_addresses_list_sale_store_addresses_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAddressListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-addresses/batch":{"post":{"summary":"Get Store Addresses Batch","description":"批量获取多个商户的地址（按 store_id 分组），登录用户可用。\n\n用于销售订单导入等场景：一次请求取回本次涉及商户的全部地址，\n避免逐商户请求（数百商户会产生上百次 HTTP 往返）。\n与 /store-addresses/all 的区别：本接口只返回指定商户，无需超级管理员权限。","operationId":"get_store_addresses_batch_sale_store_addresses_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAddressBatchParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-addresses/all":{"post":{"summary":"Get All Store Addresses","description":"获取所有商家地址（按 store_id 分组），仅超级管理员可用。\n\n用于销售订单导入等需要一次性缓存全部商家地址的场景，避免逐商家请求。","operationId":"get_all_store_addresses_sale_store_addresses_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-addresses/create":{"post":{"summary":"Create Store Address","description":"创建商户地址","operationId":"create_store_address_sale_store_addresses_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAddressCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-addresses/{address_id}/update":{"post":{"summary":"Update Store Address","description":"更新商户地址","operationId":"update_store_address_sale_store_addresses__address_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Address Id"},"name":"address_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreAddressUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/store-addresses/{address_id}":{"delete":{"summary":"Delete Store Address","description":"删除商户地址","operationId":"delete_store_address_sale_store_addresses__address_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Address Id"},"name":"address_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-partner-details":1}},"/sale/sale-orders/list":{"post":{"summary":"Get Sale Orders List","description":"按条件分页查询销售订单（非全量缓存同步）。","operationId":"get_sale_orders_list_sale_sale_orders_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/cache-sync":{"get":{"summary":"Get Sale Orders Cache Sync","description":"销售订单缓存同步：统一返回版本区间增量。","operationId":"get_sale_orders_cache_sync_sale_sale_orders_cache_sync_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Local Sale Order Version"},"name":"local_sale_order_version","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/create":{"post":{"summary":"Create Sale Order","description":"创建销售订单；固定创建标识的重放仅返回当前订单。","operationId":"create_sale_order_sale_sale_orders_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1,"x-wholety-sale-creation":1}},"/sale/sale-orders/by-creation-key/{creation_key}":{"get":{"summary":"Recover Sale Order Creation","description":"只读恢复本账户可见的当前销售单；删除的创建不可复用。","operationId":"recover_sale_order_creation_sale_sale_orders_by_creation_key__creation_key__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid4","title":"Creation Key"},"name":"creation_key","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-creation-result":1,"x-wholety-sale-creation":1}},"/sale/sale-orders/{order_id}":{"get":{"summary":"Get Sale Order Detail","description":"获取销售订单详情；无价格/商户读权限时脱敏","operationId":"get_sale_order_detail_sale_sale_orders__order_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/{order_id}/update":{"post":{"summary":"Update Sale Order","description":"更新销售订单","operationId":"update_sale_order_sale_sale_orders__order_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1,"x-wholety-sale-state":1}},"/sale/sale-orders/{order_id}/save-products":{"post":{"summary":"Save Sale Order Products","description":"一次提交销售商品、金额、库存占用和可选的提交审批；版本冲突不写入。","operationId":"save_sale_order_products_sale_sale_orders__order_id__save_products_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderProductsSave"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-tax-snapshot":1,"x-wholety-sale-products":1}},"/sale/sale-orders/{order_id}/approve":{"post":{"summary":"Approve Sale Order","description":"审批已查看的待审批订单；金额编辑另需 sale_order_price_write。","operationId":"approve_sale_order_sale_sale_orders__order_id__approve_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderApprove"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1,"x-wholety-sale-approval":1}},"/sale/sale-orders/{order_id}/approval-edit":{"post":{"summary":"Approval Edit Sale Order","description":"以已查看的版本原子保存审批商品、税额、配送关联和库存占用。","operationId":"approval_edit_sale_order_sale_sale_orders__order_id__approval_edit_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderApprovalEdit"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1,"x-wholety-sale-approval":1}},"/sale/sale-orders/{order_id}/confirm-tax-rates":{"post":{"summary":"Confirm Sale Tax Rates","description":"核对未知的原税率；需金额写权限、已查看版本及原始依据，不改历史金额。","operationId":"confirm_sale_tax_rates_sale_sale_orders__order_id__confirm_tax_rates_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleTaxRatesConfirm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-tax-snapshot":1}},"/sale/sale-orders/{order_id}/delete":{"post":{"summary":"Delete Sale Order","description":"删除销售订单","operationId":"delete_sale_order_sale_sale_orders__order_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/{order_id}/settlement/preview":{"get":{"summary":"Get Sale Settlement Preview","description":"销售分析核算预览：无售价读权限时金额脱敏","operationId":"get_sale_settlement_preview_sale_sale_orders__order_id__settlement_preview_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/{order_id}/settle":{"post":{"summary":"Settle Sale Order","description":"执行销售分析核算：写入 SaleAnalysis（按 SKU），订单状态改为已分析核算(6，旧称已结算)。仅已出库(4)及之后可分析核算。","operationId":"settle_sale_order_sale_sale_orders__order_id__settle_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-analyses/turnover-by-sku":{"get":{"summary":"Get Turnover By Sku","description":"按 SKU 汇总最近一年内的最新与平均周转率。\n\n返回结构：\n{\n  \"items\": [\n    {\n      \"product_sku_id\": 1,\n      \"stock_turnover\": 6.5,           // 平均周转率（次/年）\n      \"latest_stock_turnover\": 7.0,    // 最新一次分析核算的周转率\n      \"latest_settled_time\": \"...\"     // 最新分析核算时间\n    }\n  ]\n}","operationId":"get_turnover_by_sku_sale_sale_analyses_turnover_by_sku_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/list":{"post":{"summary":"Get Sale Returns List","description":"退货单列表；无售价/商户读权限时字段脱敏","operationId":"get_sale_returns_list_sale_sale_returns_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/create":{"post":{"summary":"Create Sale Return","description":"创建退货单（仅需选择商家；后续在仓库扫描入库时构建商品快照）","operationId":"create_sale_return_sale_sale_returns_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-return-creation":1}},"/sale/sale-returns/by-creation-key/{creation_key}":{"get":{"summary":"Recover Sale Return Creation","description":"Read an account-owned return created with this immutable request key.","operationId":"recover_sale_return_creation_sale_sale_returns_by_creation_key__creation_key__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid4","title":"Creation Key"},"name":"creation_key","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-creation-result":1}},"/sale/sale-returns/{return_id}":{"get":{"summary":"Get Sale Return Detail","description":"退货单详情；无售价/商户读权限时字段脱敏","operationId":"get_sale_return_detail_sale_sale_returns__return_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Return Id"},"name":"return_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/{return_id}/update":{"post":{"summary":"Update Sale Return","description":"更新备注或未收货的退货清单；状态变迁需通过业务确认接口控制。","operationId":"update_sale_return_sale_sale_returns__return_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Return Id"},"name":"return_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/{return_id}/confirm-receive":{"post":{"summary":"Confirm Sale Return Receive","description":"核对实际退货入库事实；已完成的收货确认可以安全重试。","operationId":"confirm_sale_return_receive_sale_sale_returns__return_id__confirm_receive_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Return Id"},"name":"return_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/confirm-price":{"post":{"summary":"Confirm Sale Return Price","description":"销售面板：保存退货商品确认价格/数量/备注；不改变状态。","operationId":"confirm_sale_return_price_sale_sale_returns_confirm_price_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnConfirmPriceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/{return_id}/confirm-price-done":{"post":{"summary":"Confirm Sale Return Price Done","description":"销售面板：确认价格完成。状态 1已入库 -> 2已确认价格。","operationId":"confirm_sale_return_price_done_sale_sale_returns__return_id__confirm_price_done_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Return Id"},"name":"return_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/{return_id}/confirm-paid":{"post":{"summary":"Confirm Sale Return Paid","description":"财务：标记退货单为已打款。状态 2已确认价格 -> 3已打款。","operationId":"confirm_sale_return_paid_sale_sale_returns__return_id__confirm_paid_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Return Id"},"name":"return_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-return-invoices/list":{"post":{"summary":"List Sale Return Invoices","description":"退货付款记录列表；无售价读权限时金额脱敏","operationId":"list_sale_return_invoices_sale_sale_return_invoices_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnInvoiceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-scope":1,"x-wholety-finance-date-filter":1}},"/sale/sale-return-invoices/sum-by-returns":{"post":{"summary":"Read Sale Return Invoice Sums","description":"按退货单汇总全部已登记净退款，不受流水分页限制。\n\n包括正负冲销和未来日期的已登记记录，与退款额度校验一致；不是截至今日的现金流。\n可见单据无流水返回 0；无金额权限返回 *，其他账户或范围外 ID 不返回。\n最多 100 个正整数 ID；只读 API Key 可调用。","operationId":"read_sale_return_invoice_sums_sale_sale_return_invoices_sum_by_returns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnInvoiceSumParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-refund-sums":1}},"/sale/sale-return-invoices/create":{"post":{"summary":"Create Sale Return Invoice","description":"创建退货付款记录","operationId":"create_sale_return_invoice_sale_sale_return_invoices_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnInvoiceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/sale/sale-return-invoices/{invoice_id}/update":{"post":{"summary":"Update Sale Return Invoice","description":"更新退货付款记录","operationId":"update_sale_return_invoice_sale_sale_return_invoices__invoice_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnInvoiceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/sale/sale-return-invoices/{invoice_id}/delete":{"post":{"summary":"Delete Sale Return Invoice","description":"删除退货付款记录","operationId":"delete_sale_return_invoice_sale_sale_return_invoices__invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-returns/match-orders":{"post":{"summary":"Match Sale Orders For Return","description":"根据商家 + SKU，仅使用各销售订单 `product_sku_sn_real_ids` 中的快照（实际出库行），\n与订单行清单/销售 type=2 快照相区分；供仓库退货时关联「实际卖出的那一笔」。\n\n出库时写入的多为出入库快照（如 type=出库），未必带 sn_sale_order_id，故从订单侧 real_ids 反查所属订单 id。","operationId":"match_sale_orders_for_return_sale_sale_returns_match_orders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleReturnMatchOrdersParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/sale-invoices/list":{"post":{"summary":"Get Sale Invoices List","description":"销售发票列表查询；无售价读权限时金额脱敏","operationId":"get_sale_invoices_list_sale_sale_invoices_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleInvoiceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-scope":1,"x-wholety-finance-date-filter":1}},"/sale/sale-invoices/create":{"post":{"summary":"Create Sale Invoice","description":"创建销售发票","operationId":"create_sale_invoice_sale_sale_invoices_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleInvoiceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/sale/sale-invoices/{invoice_id}/update":{"post":{"summary":"Update Sale Invoice","description":"更新销售发票","operationId":"update_sale_invoice_sale_sale_invoices__invoice_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleInvoiceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/sale/sale-invoices/{invoice_id}/delete":{"post":{"summary":"Delete Sale Invoice","description":"删除销售发票","operationId":"delete_sale_invoice_sale_sale_invoices__invoice_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Invoice Id"},"name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/shipping-infos/list":{"post":{"summary":"List Sale Shipping Infos","description":"销售送货信息列表；无商户读权限时联系字段脱敏","operationId":"list_sale_shipping_infos_sale_shipping_infos_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleShippingInfoListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/shipping-infos/by-order/{order_id}":{"get":{"summary":"Get Shipping Infos By Sale Order","description":"获取某个销售订单的所有送货信息；无商户读权限时联系字段脱敏","operationId":"get_shipping_infos_by_sale_order_sale_shipping_infos_by_order__order_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/shipping-infos/{info_id}":{"get":{"summary":"Get Sale Shipping Info","description":"获取单个送货信息详情；无商户读权限时联系字段脱敏","operationId":"get_sale_shipping_info_sale_shipping_infos__info_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/shipping-infos/create":{"post":{"summary":"Create Sale Shipping Info","description":"为销售订单创建送货信息","operationId":"create_sale_shipping_info_sale_shipping_infos_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleShippingInfoCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/shipping-infos/{info_id}/update":{"post":{"summary":"Update Sale Shipping Info","description":"更新送货信息","operationId":"update_sale_shipping_info_sale_shipping_infos__info_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleShippingInfoUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/shipping-infos/{info_id}/delete":{"post":{"summary":"Delete Sale Shipping Info","description":"删除送货信息","operationId":"delete_sale_shipping_info_sale_shipping_infos__info_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Info Id"},"name":"info_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/sale-orders/import-batch":{"post":{"summary":"Import Sale Orders Batch","description":"批量导入销售订单（历史订单导入专用）。\n\n一次调用 = 一整批（最多 50 单）= 一个事务：整批成功或整批回滚。\n会创建订单、商品快照、送货信息和税票；payments 只登记实际收付款。\n导入金额按商品行计算：sale_price 为 CAD 折前单价（最多两位小数），sale_discount_price 为该行正数优惠合计。\ndiscount 为非正的额外订单折扣，按各行净额分摊到分并计入计划与实际出库快照；不能超过商品净额。\n分摊还须保持各商品行及实际库存明细净额非负；商品行无法按分分摊时拒绝导入，\n实际库存拆分无法按分分摊时保留已下单并返回原因，不扣库存或生成出库记录。\nproduct_total 为商品总额按分舍入；订单 discount 为全部行优惠的负值加额外折扣；\ntotal 为商品净额加额外折扣与 tax_total 后按分舍入。只有订单税额时按商品净额（零额时按数量）分摊到分。\n有非零行税额时，订单税额须与行税额合计一致。传入的 product_total / total 仅作来源参考，不覆盖计算值。\nsource_document_total、source_quantity、source_row_total、source_price、source_price_before_discount\n和 source_price_currency 连同 amounts_reviewed 记录于来源日志，不参与应收计算。\n未提供 payments 时不生成收款记录；单据金额、到期日和旧 pay_time 字段不作为收款依据。\n每笔 payments 须提供正 CAD 金额和实际日期；外币金额与汇率独立于订单外币信息。\n扣除冻结量与其他订单预留后，带采购成本的可用库存充足则出库并核算至 status=6；\n不足或核算失败的保留 status=3，响应的 placed_ids / blocked_reasons 列出未出库订单与原因。\n跨仓库出库保留独立实际快照；子账户只能导入可见商户的订单。\n导入收款冲减当前商户欠款，不覆盖已确认的其他收款。\n子账户须同时拥有订单导入、订单写、审批、售价写、销售财务、出入库和财务看板（税票）权限。\norder_id 是外部来源单号，系统独立生成订单 ID；按主账户、订单类型与来源单号持久映射并去重。\n修改备注后重试仍会跳过；source_mappings 返回来源单号、系统订单 ID 与本次是否创建。\ncreated_ids、outbound_ids、placed_ids、blocked_reasons 和 payment_order_ids 中的订单 ID 均为系统订单 ID。\nsource_canceled=N 表示正常单；Y 取消、C 冲销均拒绝进入普通库存与财务导入。\nsource_document_status 只保留来源状态，关闭状态不等于取消或已收款。","operationId":"import_sale_orders_batch_sale_sale_orders_import_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderImportBatchParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderImportBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-delivery":1}},"/sale/selection/quotes/query":{"post":{"summary":"Sale Selection Quotes","operationId":"sale_selection_quotes_sale_selection_quotes_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionQuoteParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionQuoteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/selection/stocks/candidates":{"post":{"summary":"Sale Selection Stock Candidates","operationId":"sale_selection_stock_candidates_sale_selection_stocks_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionStockCandidatesParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionStockCandidatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/sale/selection/stocks/lookup":{"post":{"summary":"Sale Selection Stock Lookup","operationId":"sale_selection_stock_lookup_sale_selection_stocks_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionStockLookupParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleSelectionStockLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-transfers/{transfer_id}/reconcile-departure-status":{"post":{"summary":"Reconcile Transfer Departure Status","description":"Explicitly verify missing departure flags; recorded valid facts stay immutable.","operationId":"reconcile_transfer_departure_status_warehouse_warehouse_transfers__transfer_id__reconcile_departure_status_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Transfer Id"},"name":"transfer_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferDepartureStatusReconcile"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/resolve-code":{"post":{"summary":"Get Warehouse By Code","description":"Resolve a stable warehouse code after an uncertain create or update.","operationId":"get_warehouse_by_code_warehouse_warehouses_resolve_code_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseCodeLookupParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/list":{"post":{"summary":"Get Warehouses List","description":"仓库列表查询","operationId":"get_warehouses_list_warehouse_warehouses_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/create":{"post":{"summary":"Create Warehouse","description":"创建仓库","operationId":"create_warehouse_warehouse_warehouses_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/{warehouse_id}":{"get":{"summary":"Get Warehouse Detail","description":"获取仓库详情","operationId":"get_warehouse_detail_warehouse_warehouses__warehouse_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/{warehouse_id}/update":{"post":{"summary":"Update Warehouse","description":"更新仓库","operationId":"update_warehouse_warehouse_warehouses__warehouse_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouses/{warehouse_id}/delete":{"post":{"summary":"Delete Warehouse","description":"删除仓库","operationId":"delete_warehouse_warehouse_warehouses__warehouse_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-ios/list":{"post":{"summary":"Get Warehouse Ios List","description":"进出库记录列表查询","operationId":"get_warehouse_ios_list_warehouse_warehouse_ios_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseIOListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-ios/create":{"post":{"summary":"Create Warehouse Io","description":"创建进出库记录","operationId":"create_warehouse_io_warehouse_warehouse_ios_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseIOCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-transfer-transit":1,"x-wholety-transfer-receiving-shelves":1,"x-wholety-transfer-status":1}},"/warehouse/warehouse-ios/{io_id}/update":{"post":{"summary":"Update Warehouse Io","description":"更新进出库记录（支持补传图片等）","operationId":"update_warehouse_io_warehouse_warehouse_ios__io_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Io Id"},"name":"io_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseIOUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-ios/{io_id}/delete":{"post":{"summary":"Delete Warehouse Io","description":"删除进出库记录","operationId":"delete_warehouse_io_warehouse_warehouse_ios__io_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Io Id"},"name":"io_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/orders/list":{"post":{"summary":"Get Putaway Orders List","description":"可上架单据列表：供应链订单 / 退货单","operationId":"get_putaway_orders_list_warehouse_warehouse_putaway_orders_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehousePutawayOrderListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/stocks/list":{"post":{"summary":"Get Putaway Stocks List","description":"上架商品列表：按入口返回可调整货架位的商品库存","operationId":"get_putaway_stocks_list_warehouse_warehouse_putaway_stocks_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehousePutawayStockListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-putaway-integrity":1,"x-wholety-partial-stock-move":1}},"/warehouse/warehouse-putaway/create":{"post":{"summary":"Create Putaway","description":"执行上架：仅调整货架位/效期，不改变库存总量；唯一键冲突时自动合并","operationId":"create_putaway_warehouse_warehouse_putaway_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehousePutawayCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-putaway-integrity":1,"x-wholety-partial-stock-move":1}},"/warehouse/warehouse-transfers/list":{"post":{"summary":"Get Warehouse Transfers List","description":"移库记录列表查询","operationId":"get_warehouse_transfers_list_warehouse_warehouse_transfers_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseTransferListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-transfers/create":{"post":{"summary":"Create Warehouse Transfer","description":"创建移库单（待出库）：仅建单、写快照关联，不发生库存变动。出库/入库在进出库页面完成。","operationId":"create_warehouse_transfer_warehouse_warehouse_transfers_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseTransferCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-transfers/{transfer_id}/update":{"post":{"summary":"Update Warehouse Transfer","description":"更新移库单：仅待出库(status=0)时可修改商品明细与备注","operationId":"update_warehouse_transfer_warehouse_warehouse_transfers__transfer_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Transfer Id"},"name":"transfer_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseTransferUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-transfers/{transfer_id}/detail":{"post":{"summary":"Get Warehouse Transfer Detail","description":"移库记录详情（含快照明细，供查看/打印）","operationId":"get_warehouse_transfer_detail_warehouse_warehouse_transfers__transfer_id__detail_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Transfer Id"},"name":"transfer_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-transfer-source":1}},"/warehouse/inventory-check/change-shelf":{"post":{"summary":"Inventory Check Change Shelf","operationId":"inventory_check_change_shelf_warehouse_inventory_check_change_shelf_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryCheckChangeShelfParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-transfer-transit":1}},"/warehouse/inventory-check/split":{"post":{"summary":"Inventory Check Split","operationId":"inventory_check_split_warehouse_inventory_check_split_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryCheckSplitParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory-check/mark-destroy":{"post":{"summary":"Inventory Check Mark Destroy","operationId":"inventory_check_mark_destroy_warehouse_inventory_check_mark_destroy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryCheckMarkDestroyParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory-check/unmark-destroy":{"post":{"summary":"Inventory Check Unmark Destroy","operationId":"inventory_check_unmark_destroy_warehouse_inventory_check_unmark_destroy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryCheckUnmarkDestroyParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory-check/operations/list":{"post":{"summary":"List Inventory Check Operations","description":"盘点操作记录（按时间筛选）。","operationId":"list_inventory_check_operations_warehouse_inventory_check_operations_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryCheckOperationListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/stock-destroys/list":{"post":{"summary":"List Warehouse Stock Destroys","description":"已销毁记录列表（分页）","operationId":"list_warehouse_stock_destroys_warehouse_stock_destroys_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseStockDestroyListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/stock-destroys/execute":{"post":{"summary":"Execute Warehouse Stock Destroy","description":"销毁待销毁库存：扣减数量、写销毁记录与库存流水（type=销毁）；库存为 0 时清除待销毁标记","operationId":"execute_warehouse_stock_destroy_warehouse_stock_destroys_execute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseStockDestroyExecuteParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory/query":{"post":{"summary":"Inventory Query","operationId":"inventory_query_warehouse_inventory_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryQueryParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory/stock-lookup":{"post":{"summary":"Inventory Stock Lookup","operationId":"inventory_stock_lookup_warehouse_inventory_stock_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryLookupParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory/sku-options":{"post":{"summary":"Inventory Sku Options","operationId":"inventory_sku_options_warehouse_inventory_sku_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventorySkuOptionsParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventorySkuOptionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/inventory/shelf-options":{"post":{"summary":"Inventory Shelf Options","operationId":"inventory_shelf_options_warehouse_inventory_shelf_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryShelfOptionsParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryShelfOptionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/stock-operations/candidates":{"post":{"summary":"Stock Operation Candidates","operationId":"stock_operation_candidates_warehouse_stock_operations_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockOperationCandidatesParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockOperationCandidatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/stock-operations/lookup":{"post":{"summary":"Stock Operation Lookup","operationId":"stock_operation_lookup_warehouse_stock_operations_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockOperationLookupParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockOperationLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/query":{"post":{"summary":"Putaway Stock Query","operationId":"putaway_stock_query_warehouse_warehouse_putaway_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayStockQueryParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayStockQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/orders/query":{"post":{"summary":"Putaway Source Query","operationId":"putaway_source_query_warehouse_warehouse_putaway_orders_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawaySourceQueryParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawaySourceQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/stock-lookup":{"post":{"summary":"Putaway Stock Lookup","operationId":"putaway_stock_lookup_warehouse_warehouse_putaway_stock_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayStockLookupParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayStockLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/warehouse/warehouse-putaway/operation-proof":{"post":{"summary":"Putaway Operation Proof","operationId":"putaway_operation_proof_warehouse_warehouse_putaway_operation_proof_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayOperationProofParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutawayOperationProofResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/categories/list":{"post":{"summary":"Get Categories List","description":"分类列表查询，返回树结构数据","operationId":"get_categories_list_product_categories_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/categories/create":{"post":{"summary":"Create Category","description":"创建分类","operationId":"create_category_product_categories_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/categories/reorder":{"post":{"summary":"Reorder Categories","description":"Atomically reorder one sibling group after checking the order the editor saw.","operationId":"reorder_categories_product_categories_reorder_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryReorder"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/categories/{category_id}/update":{"post":{"summary":"Update Category","description":"更新分类","operationId":"update_category_product_categories__category_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/categories/{category_id}/delete":{"post":{"summary":"Delete Category","description":"删除分类","operationId":"delete_category_product_categories__category_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/list":{"post":{"summary":"Get Brands List","description":"品牌列表查询","operationId":"get_brands_list_product_brands_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/create":{"post":{"summary":"Create Brand","description":"创建品牌","operationId":"create_brand_product_brands_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/{brand_id}":{"get":{"summary":"Get Brand Detail","description":"获取品牌详情","operationId":"get_brand_detail_product_brands__brand_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Brand Id"},"name":"brand_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/{brand_id}/update":{"post":{"summary":"Update Brand","description":"更新品牌","operationId":"update_brand_product_brands__brand_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Brand Id"},"name":"brand_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/{brand_id}/delete":{"post":{"summary":"Delete Brand","description":"删除品牌","operationId":"delete_brand_product_brands__brand_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Brand Id"},"name":"brand_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brand-categories/list":{"post":{"summary":"Get Brand Categories List","description":"品牌类别列表查询（默认仅返回显示的类别；store_purchase 用于选购页分组）","operationId":"get_brand_categories_list_product_brand_categories_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandCategoryListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brand-categories/create":{"post":{"summary":"Create Brand Category","description":"创建品牌类别","operationId":"create_brand_category_product_brand_categories_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandCategoryCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brand-categories/{category_id}/update":{"post":{"summary":"Update Brand Category","description":"更新品牌类别","operationId":"update_brand_category_product_brand_categories__category_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandCategoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brand-categories/{category_id}/delete":{"post":{"summary":"Delete Brand Category","description":"删除品牌类别（逻辑删除：hide=1）","operationId":"delete_brand_category_product_brand_categories__category_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brand-categories/{category_id}/set-brands":{"post":{"summary":"Set Brand Category Brands","description":"设置某品牌类别关联的品牌列表（全量覆盖 brand_category_link）","operationId":"set_brand_category_brands_product_brand_categories__category_id__set_brands_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandCategorySetBrands"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/store-categories/list":{"post":{"summary":"Get Store Categories List","description":"商户类别列表查询（默认仅返回显示的类别）","operationId":"get_store_categories_list_product_store_categories_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCategoryListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/store-categories/create":{"post":{"summary":"Create Store Category","description":"创建商户类别","operationId":"create_store_category_product_store_categories_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCategoryCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/store-categories/{category_id}/update":{"post":{"summary":"Update Store Category","description":"更新商户类别","operationId":"update_store_category_product_store_categories__category_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCategoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/store-categories/{category_id}/delete":{"post":{"summary":"Delete Store Category","description":"删除商户类别（逻辑删除：hide=1）","operationId":"delete_store_category_product_store_categories__category_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/store-categories/{category_id}/set-stores":{"post":{"summary":"Set Store Category Stores","description":"设置某商户类别关联的商户列表（全量覆盖 store_category_link）","operationId":"set_store_category_stores_product_store_categories__category_id__set_stores_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCategorySetStores"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/supplier-categories/list":{"post":{"summary":"Get Supplier Categories List","description":"供应商类别列表查询（默认仅返回显示的类别）","operationId":"get_supplier_categories_list_product_supplier_categories_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCategoryListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/supplier-categories/create":{"post":{"summary":"Create Supplier Category","description":"创建供应商类别","operationId":"create_supplier_category_product_supplier_categories_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCategoryCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/supplier-categories/{category_id}/update":{"post":{"summary":"Update Supplier Category","description":"更新供应商类别","operationId":"update_supplier_category_product_supplier_categories__category_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCategoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/supplier-categories/{category_id}/delete":{"post":{"summary":"Delete Supplier Category","description":"删除供应商类别（逻辑删除：hide=1）","operationId":"delete_supplier_category_product_supplier_categories__category_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/supplier-categories/{category_id}/set-suppliers":{"post":{"summary":"Set Supplier Category Suppliers","description":"设置某供应商类别关联的供应商列表（全量覆盖 supplier_category_link）","operationId":"set_supplier_category_suppliers_product_supplier_categories__category_id__set_suppliers_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Category Id"},"name":"category_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierCategorySetSuppliers"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/annual-targets/list":{"post":{"summary":"Get Annual Targets List","description":"按品牌查询年度目标列表","operationId":"get_annual_targets_list_product_annual_targets_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnualTargetListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/annual-targets/create":{"post":{"summary":"Create Annual Target","description":"创建年度目标","operationId":"create_annual_target_product_annual_targets_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnualTargetCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/annual-targets/{target_id}/update":{"post":{"summary":"Update Annual Target","description":"更新年度目标","operationId":"update_annual_target_product_annual_targets__target_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Target Id"},"name":"target_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnualTargetUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/annual-targets/{target_id}/delete":{"post":{"summary":"Delete Annual Target","description":"删除年度目标","operationId":"delete_annual_target_product_annual_targets__target_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Target Id"},"name":"target_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/dashboard/overview":{"post":{"summary":"Get Brands Dashboard Overview","description":"各品牌采销情况总览：按时间区间统计已分析核算订单的实际采购/销售/利润；年度计划来自 Brand 年度目标。","operationId":"get_brands_dashboard_overview_product_brands_dashboard_overview_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Params","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/{brand_id}/dashboard/detail":{"get":{"summary":"Get Brand Dashboard Detail","description":"某品牌采销详情：按时间区间统计已分析核算采购/销售，年化与周转来自 SaleAnalysis（折线序列）。","operationId":"get_brand_dashboard_detail_product_brands__brand_id__dashboard_detail_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Brand Id"},"name":"brand_id","in":"path"},{"required":false,"schema":{"type":"boolean","title":"Exclude Freight","default":false},"name":"exclude_freight","in":"query"},{"required":false,"schema":{"type":"boolean","title":"Exclude Hst","default":false},"name":"exclude_hst","in":"query"},{"required":false,"schema":{"type":"string","title":"Start Time"},"name":"start_time","in":"query"},{"required":false,"schema":{"type":"string","title":"End Time"},"name":"end_time","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/brands/{brand_id}/dashboard/sku/{sku_id}/channels":{"get":{"summary":"Get Brand Dashboard Sku Channel Detail","description":"品牌看板-SKU 渠道详情：口径与 section_skus.channel_breakdown 一致。","operationId":"get_brand_dashboard_sku_channel_detail_product_brands__brand_id__dashboard_sku__sku_id__channels_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Brand Id"},"name":"brand_id","in":"path"},{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"},{"required":false,"schema":{"type":"string","title":"Start Time"},"name":"start_time","in":"query"},{"required":false,"schema":{"type":"string","title":"End Time"},"name":"end_time","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/list":{"post":{"summary":"Get Product Skus List","description":"商品列表（SKU 维度，每个 SKU 为独立商品个体）","operationId":"get_product_skus_list_product_product_skus_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/cache-sync":{"get":{"summary":"Get Product Skus Cache Sync","description":"按前端本地 SKU 版本做增量同步，支持分页。\n\npage / page_size：均为 0 表示不分页（兼容旧版），>0 时启用分页。\npage_token：第 2 页起必须回传第 1 页返回的 page_token，用于保证分页数据一致性。","operationId":"get_product_skus_cache_sync_product_product_skus_cache_sync_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Local Product Sku Version"},"name":"local_product_sku_version","in":"query"},{"required":false,"schema":{"type":"integer","title":"Page","default":0},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","title":"Page Size","default":0},"name":"page_size","in":"query"},{"required":false,"schema":{"type":"string","title":"Page Token"},"name":"page_token","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/products/cache-sync":{"get":{"summary":"Get Products Cache Sync Legacy","operationId":"get_products_cache_sync_legacy_product_products_cache_sync_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Local Product Sku Version"},"name":"local_product_sku_version","in":"query"},{"required":false,"schema":{"type":"integer","title":"Local Product Version"},"name":"local_product_version","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/batch-get":{"post":{"summary":"Batch Get Product Skus","description":"批量获取商品信息（含库存、售价和折扣）","operationId":"batch_get_product_skus_product_product_skus_batch_get_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuBatchGetParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/price-rule-options":{"get":{"summary":"Get Price Rule Sku Options","description":"Small remote SKU picker for price/discount rules beyond the first cache page.","operationId":"get_price_rule_sku_options_product_product_skus_price_rule_options_get","parameters":[{"required":false,"schema":{"type":"string","maxLength":100,"title":"Q","default":""},"name":"q","in":"query"},{"required":false,"schema":{"type":"integer","exclusiveMinimum":0.0,"title":"Selected Id"},"name":"selected_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/resolve-sku-codes":{"post":{"summary":"Get Product Sku Code Matches","description":"Resolve exact SKU codes, including duplicates, before assigning images.","operationId":"get_product_sku_code_matches_product_product_skus_resolve_sku_codes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuCodeResolveParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/by-code":{"get":{"summary":"Get Product Sku By Code","description":"Exact code lookup for reconciling an uncertain product creation.","operationId":"get_product_sku_by_code_product_product_skus_by_code_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":50,"minLength":1,"title":"Code"},"name":"code","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/{sku_id}":{"get":{"summary":"Get Product Sku Detail","description":"获取单个商品详情","operationId":"get_product_sku_detail_product_product_skus__sku_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/create":{"post":{"summary":"Create Product Sku","description":"创建商品（独立 SKU 个体）","operationId":"create_product_sku_product_product_skus_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/{sku_id}/update":{"post":{"summary":"Update Product Sku","description":"更新商品SKU","operationId":"update_product_sku_product_product_skus__sku_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/{sku_id}/delete":{"post":{"summary":"Delete Product Sku","description":"删除商品SKU","operationId":"delete_product_sku_product_product_skus__sku_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/list":{"post":{"summary":"Get Product Stocks List","description":"商品库存列表查询（支持按 supplier_order_id 等筛选）\n返回每个库存记录的实际库存、冻结库存、销售占用库存和可用库存","operationId":"get_product_stocks_list_product_product_stocks_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/{stock_id}/update":{"post":{"summary":"Update Product Stock","description":"更新库存记录：货架位/待销毁标记统一走 inventory_check_service。","operationId":"update_product_stock_product_product_stocks__stock_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Stock Id"},"name":"stock_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/inventory-update":{"post":{"summary":"Inventory Update Product Stock","description":"盘点单式「实盘改数」已下线，请使用 /warehouse/inventory-check/split 等实时盘点接口。","operationId":"inventory_update_product_stock_product_product_stocks_inventory_update_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockInventoryUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/split-for-check":{"post":{"summary":"Split Product Stock For Check","description":"已合并至仓库实时盘点拆分接口。","operationId":"split_product_stock_for_check_product_product_stocks_split_for_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockSplitForCheckParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/import-reset-all":{"post":{"summary":"Reset All Product Stocks For Import","description":"库存全覆盖导入前：将所有现有库存数量归零。","operationId":"reset_all_product_stocks_for_import_product_product_stocks_import_reset_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stocks/import-batch":{"post":{"summary":"Import Product Stocks Batch","description":"历史库存 CSV 批量导入：按 SKU+仓库 将默认维度库存设为指定箱数。","operationId":"import_product_stocks_batch_product_product_stocks_import_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockImportBatchParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-stock-records/list":{"post":{"summary":"Get Product Stock Records List","description":"库存变动记录列表（支持按变动来源筛选：供应链入库、销售出库、退货入库、移库等）","operationId":"get_product_stock_records_list_product_product_stock_records_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockRecordListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-stock-history":1}},"/product/product-stock-records/restocked-products":{"post":{"summary":"Get Restocked Products Last Days","description":"近 N 天某库存批次由 0 变正数的 SKU（截止当前业务时间）。","operationId":"get_restocked_products_last_days_product_product_stock_records_restocked_products_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductStockRestockedProductsParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-stock-history":1}},"/product/product-sale-stocks/list":{"post":{"summary":"Get Product Sale Stocks List","description":"销售订单占用库存列表查询","operationId":"get_product_sale_stocks_list_product_product_sale_stocks_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSaleStockListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-prices/list":{"post":{"summary":"List Product Sku Sale Prices","description":"Search all visible SKU sale-price rules with server-side pagination.","operationId":"list_product_sku_sale_prices_product_product_sku_sale_prices_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSalePriceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-prices/create":{"post":{"summary":"Create Product Sku Sale Price","description":"创建商品售价","operationId":"create_product_sku_sale_price_product_product_sku_sale_prices_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSalePriceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-prices/{price_id}/update":{"post":{"summary":"Update Product Sku Sale Price","description":"更新商品售价","operationId":"update_product_sku_sale_price_product_product_sku_sale_prices__price_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Price Id"},"name":"price_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSalePriceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-prices/{price_id}/delete":{"post":{"summary":"Delete Product Sku Sale Price","description":"删除商品售价","operationId":"delete_product_sku_sale_price_product_product_sku_sale_prices__price_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Price Id"},"name":"price_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-discounts/list":{"post":{"summary":"List Product Sku Sale Discounts","description":"Search all visible SKU discount rules with server-side pagination.","operationId":"list_product_sku_sale_discounts_product_product_sku_sale_discounts_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSaleDiscountListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-discounts/create":{"post":{"summary":"Create Product Sku Sale Discount","description":"创建商品折扣","operationId":"create_product_sku_sale_discount_product_product_sku_sale_discounts_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSaleDiscountCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-discounts/{discount_id}/update":{"post":{"summary":"Update Product Sku Sale Discount","description":"更新商品折扣","operationId":"update_product_sku_sale_discount_product_product_sku_sale_discounts__discount_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Discount Id"},"name":"discount_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSaleDiscountUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-sku-sale-discounts/{discount_id}/delete":{"post":{"summary":"Delete Product Sku Sale Discount","description":"删除商品折扣","operationId":"delete_product_sku_sale_discount_product_product_sku_sale_discounts__discount_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Discount Id"},"name":"discount_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/{sku_id}/sale-history":{"get":{"summary":"Get Product Sku Sale History","description":"查询 SKU 的历史售价：含销售计划行(TYPE_SALE)与实际出库行(TYPE_OUTBOUND)，仅保留已关联销售单的记录；售价按从低到高排序（无售价置后）。","operationId":"get_product_sku_sale_history_product_product_skus__sku_id__sale_history_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/purchase-board/metrics":{"get":{"summary":"Get Purchase Board Metrics","description":"采购看板：在途/销量等 SKU 维度统计（数据库聚合）。","operationId":"get_purchase_board_metrics_product_purchase_board_metrics_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Recent Days","default":30},"name":"recent_days","in":"query"},{"required":false,"schema":{"type":"integer","title":"Sale Months","default":12},"name":"sale_months","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/purchase-board/summary":{"get":{"summary":"Get Purchase Board Summary","description":"Bounded version-2 board quantities; no per-sale rows or prices.","operationId":"get_purchase_board_summary_product_purchase_board_summary_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":30.0,"minimum":30.0,"title":"Recent Days","default":30},"name":"recent_days","in":"query"},{"required":false,"schema":{"type":"integer","maximum":12.0,"minimum":12.0,"title":"Sale Months","default":12},"name":"sale_months","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/purchase-board/sales":{"get":{"summary":"Get Purchase Board Sales","description":"One SKU/month page in the same explicit Toronto time and user scope.","operationId":"get_purchase_board_sales_product_purchase_board_sales_get","parameters":[{"required":true,"schema":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Sku Id"},"name":"sku_id","in":"query"},{"required":true,"schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","title":"Month"},"name":"month","in":"query"},{"required":true,"schema":{"type":"string","maxLength":40,"minLength":20,"title":"As Of"},"name":"as_of","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"name":"page_size","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/metadata/query":{"post":{"summary":"Metadata Query","operationId":"metadata_query_product_product_skus_metadata_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuMetadataQueryParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuMetadataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/query":{"post":{"summary":"Get Catalog Query","operationId":"get_catalog_query_product_product_skus_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogQueryParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/purchase-board/skus/query":{"post":{"summary":"Board Skus Query","operationId":"board_skus_query_product_purchase_board_skus_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardSkuQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardSkuQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/purchase-board/stocks/query":{"post":{"summary":"Board Stocks Query","operationId":"board_stocks_query_product_purchase_board_stocks_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardStocksQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardStocksResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product/product-skus/import-identities/resolve":{"post":{"summary":"Resolve Identities","operationId":"resolve_identities_product_product_skus_import_identities_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportIdentityResolveParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportIdentityResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/integrations/status":{"get":{"summary":"Get Integration Status","description":"Expose configuration readiness to Agents without returning credentials.","operationId":"get_integration_status_system_integrations_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/provinces/list":{"post":{"summary":"Get Provinces List","description":"地区列表（登录用户均可查询，供下拉/缓存同步等使用）","operationId":"get_provinces_list_system_provinces_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvinceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/provinces/create":{"post":{"summary":"Create Province","description":"创建地区","operationId":"create_province_system_provinces_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvinceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/provinces/{province_id}/update":{"post":{"summary":"Update Province","description":"更新地区","operationId":"update_province_system_provinces__province_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Province Id"},"name":"province_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvinceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/provinces/{province_id}/delete":{"post":{"summary":"Delete Province","description":"删除地区（软删除）","operationId":"delete_province_system_provinces__province_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Province Id"},"name":"province_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/roles/list":{"get":{"summary":"Get Roles List","description":"角色列表","operationId":"get_roles_list_system_roles_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/roles/create":{"post":{"summary":"Create Role","description":"创建角色","operationId":"create_role_system_roles_create_post","parameters":[{"required":true,"schema":{"type":"string","title":"Name"},"name":"name","in":"query"}],"requestBody":{"content":{"application/json":{"schema":{"items":{"type":"integer"},"type":"array","title":"Auth Ids"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/roles/{role_id}/update":{"post":{"summary":"Update Role","description":"更新角色","operationId":"update_role_system_roles__role_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Role Id"},"name":"role_id","in":"path"},{"required":false,"schema":{"type":"string","title":"Name"},"name":"name","in":"query"}],"requestBody":{"content":{"application/json":{"schema":{"items":{"type":"integer"},"type":"array","title":"Auth Ids"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/auths/list":{"get":{"summary":"Get Auths List","description":"权限列表","operationId":"get_auths_list_system_auths_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/auths/create":{"post":{"summary":"Create Auth","description":"创建权限","operationId":"create_auth_system_auths_create_post","parameters":[{"required":true,"schema":{"type":"string","title":"Name"},"name":"name","in":"query"},{"required":true,"schema":{"type":"string","title":"Code"},"name":"code","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/auths/{auth_id}/update":{"post":{"summary":"Update Auth","description":"更新权限","operationId":"update_auth_system_auths__auth_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Auth Id"},"name":"auth_id","in":"path"},{"required":false,"schema":{"type":"string","title":"Name"},"name":"name","in":"query"},{"required":false,"schema":{"type":"string","title":"Code"},"name":"code","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/system/pending-approvals":{"get":{"summary":"Get Pending Approvals","description":"待审批订单列表（供应链/销售 status=1），服务端聚合。","operationId":"get_pending_approvals_system_pending_approvals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/dashboard/overview":{"get":{"summary":"Get Dashboard Overview","description":"全览看板数据","operationId":"get_dashboard_overview_dashboard_dashboard_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/dashboard/supplier":{"get":{"summary":"Get Supplier Dashboard","description":"供应链看板数据","operationId":"get_supplier_dashboard_dashboard_dashboard_supplier_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/dashboard/sale":{"get":{"summary":"Get Sale Dashboard","description":"销售看板数据","operationId":"get_sale_dashboard_dashboard_dashboard_sale_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/dashboard/warehouse":{"get":{"summary":"Get Warehouse Dashboard","description":"仓库看板数据","operationId":"get_warehouse_dashboard_dashboard_dashboard_warehouse_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Days","default":30},"name":"days","in":"query"},{"required":false,"schema":{"type":"integer","title":"Stock Threshold","default":10},"name":"stock_threshold","in":"query"},{"required":false,"schema":{"type":"integer","title":"Overstock Threshold","default":1000},"name":"overstock_threshold","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/dashboard/finance":{"get":{"summary":"Get Finance Dashboard","description":"财务现金看板：净收付含冲销与退货退款，日期 pay_time 优先、create_time 回退。finance-reports-v2","operationId":"get_finance_dashboard_dashboard_dashboard_finance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/guide-summary":{"get":{"summary":"Get Guide Summary","description":"业务引导页统计摘要：各模块的核心计数","operationId":"get_guide_summary_dashboard_guide_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/executive/overview":{"get":{"summary":"Get Executive Overview","description":"finance-reports-v2: 净收付按支付日期；已核算销售毛利按订单创建日期及冻结实际成本，排除税/退货/其他费用。","operationId":"get_executive_overview_dashboard_executive_overview_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"},{"required":false,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/executive/analysis":{"get":{"summary":"Get Executive Analysis","description":"Executive Dashboard - Analysis Tab","operationId":"get_executive_analysis_dashboard_executive_analysis_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"},{"required":false,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/executive/health":{"get":{"summary":"Get Executive Health","description":"Executive Dashboard - Health Tab","operationId":"get_executive_health_dashboard_executive_health_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"},{"required":false,"schema":{"type":"integer","title":"Warehouse Id"},"name":"warehouse_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/dashboard/example-story":{"get":{"summary":"Example Story","description":"Replay the homepage question using the example ledger, not canned totals.","operationId":"example_story_dashboard_example_story_get","parameters":[{"required":false,"schema":{"type":"integer","title":"Days","default":90},"name":"days","in":"query"},{"required":false,"schema":{"type":"integer","title":"Quantity","default":48},"name":"quantity","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance_type/finance-types/list":{"post":{"summary":"Get Finance Types List","description":"财务类型列表查询","operationId":"get_finance_types_list_finance_type_finance_types_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceTypeListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance_type/finance-types/{finance_type_id}":{"get":{"summary":"Get Finance Type Detail","description":"获取财务类型详情（含关联的销售发票、供应链发票）","operationId":"get_finance_type_detail_finance_type_finance_types__finance_type_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Finance Type Id"},"name":"finance_type_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance_type/finance-types/create":{"post":{"summary":"Create Finance Type","description":"创建财务类型","operationId":"create_finance_type_finance_type_finance_types_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceTypeCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance_type/finance-types/{finance_type_id}/update":{"post":{"summary":"Update Finance Type","description":"更新财务类型","operationId":"update_finance_type_finance_type_finance_types__finance_type_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Finance Type Id"},"name":"finance_type_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceTypeUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance_type/finance-types/{finance_type_id}/delete":{"post":{"summary":"Delete Finance Type","description":"删除财务类型（软删除）","operationId":"delete_finance_type_finance_type_finance_types__finance_type_id__delete_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Finance Type Id"},"name":"finance_type_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance/stores/summaries":{"post":{"summary":"Get Store Finance Summaries","description":"Current merchant debt and separate sales credit, from complete eligible order ledgers.","operationId":"get_store_finance_summaries_finance_stores_summaries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreFinanceSummariesParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-merchant-finance":1}},"/finance/orders/{order_type}/{order_id}/summary":{"get":{"summary":"Get Order Finance Summary","description":"单据财务汇总：与财务报表使用同一应付 / 应收和实际净收付口径。\n\norder_total 为商品与订单折扣（销售含税）；paid/payable 或 received/receivable\n保留冲销和负余额。cash_in/cash_out 为全部实际流入/流出，cash_net 为带符号净收付。\noutstanding 为正待付/待收，credit 为预付/超收；未来流水不计入。\n子账户遵守业务伙伴范围及金额权限，未授权金额均为 *。","operationId":"get_order_finance_summary_finance_orders__order_type___order_id__summary_get","parameters":[{"required":true,"schema":{"type":"string","enum":["supplier","sale"],"title":"Order Type"},"name":"order_type","in":"path"},{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-order-finance-summary":1,"x-wholety-order-cash-directions":1}},"/finance/dashboard/unsettled":{"get":{"summary":"Get Finance Unsettled Dashboard","description":"财务看板：时间区间内已下单未分析核算的供应链订单与销售订单，\n汇总应付（供应链未付差额）、应收（销售未收差额），并返回订单列表供查看与操作财务。\n默认最近 3 个月。采购应付仅商品金额＋订单折扣，货运/税另计；冲销计入净收付，超付/超收单列。","operationId":"get_finance_unsettled_dashboard_finance_dashboard_unsettled_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance/dashboard/settled":{"get":{"summary":"Get Finance Settled Dashboard","description":"财务看板：时间区间内已分析核算的供应链订单与销售订单，汇总净已付/已收与真实待付/待收余额。成本核算完成不代表款项结清。默认最近 3 个月。","operationId":"get_finance_settled_dashboard_finance_dashboard_settled_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance/dashboard/tax":{"get":{"summary":"Get Finance Tax Dashboard","description":"财务税务看板：应付税（供应链）、应收税（销售单）汇总。\n税不参与分析核算与支付，独立统计供代缴使用。","operationId":"get_finance_tax_dashboard_finance_dashboard_tax_get","parameters":[{"required":false,"schema":{"type":"string","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"End Date"},"name":"end_date","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/finance/tax-invoices/list":{"post":{"summary":"List Tax Invoices","description":"税票列表","operationId":"list_tax_invoices_finance_tax_invoices_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-scope":1,"x-wholety-finance-date-filter":1}},"/finance/tax-invoices/sum-by-supplier-orders":{"get":{"summary":"Sum Tax Invoices By Supplier Orders Get","description":"按供应链订单 ID 汇总已开税票金额（GET，便于某些网关/代理环境）","operationId":"sum_tax_invoices_by_supplier_orders_get_finance_tax_invoices_sum_by_supplier_orders_get","parameters":[{"required":false,"schema":{"items":{},"type":"array","title":"Supplier Order Ids","default":[]},"name":"supplier_order_ids","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Sum Tax Invoices By Supplier Orders","description":"按供应链订单 ID 汇总已开税票金额，返回 { supplier_order_id: sum_tax_total }","operationId":"sum_tax_invoices_by_supplier_orders_finance_tax_invoices_sum_by_supplier_orders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceSumBySupplierOrdersParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-recorded-sums":1}},"/finance/tax-invoices/sum-by-sale-orders":{"get":{"summary":"Sum Tax Invoices By Sale Orders Get","description":"按销售订单 ID 汇总已开税票金额（GET）","operationId":"sum_tax_invoices_by_sale_orders_get_finance_tax_invoices_sum_by_sale_orders_get","parameters":[{"required":false,"schema":{"items":{},"type":"array","title":"Sale Order Ids","default":[]},"name":"sale_order_ids","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Sum Tax Invoices By Sale Orders","description":"按销售订单 ID 汇总已开税票金额，返回 { sale_order_id: sum_tax_total }","operationId":"sum_tax_invoices_by_sale_orders_finance_tax_invoices_sum_by_sale_orders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceSumBySaleOrdersParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-recorded-sums":1}},"/finance/tax-invoices/create":{"post":{"summary":"Create Tax Invoice","description":"创建税票记录","operationId":"create_tax_invoice_finance_tax_invoices_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/finance/tax-invoices/{tax_invoice_id}/update":{"post":{"summary":"Update Tax Invoice","description":"更新税票记录","operationId":"update_tax_invoice_finance_tax_invoices__tax_invoice_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Tax Invoice Id"},"name":"tax_invoice_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxInvoiceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-finance-input-validation":1,"x-wholety-finance-amounts":1}},"/finance/tax-invoices/{tax_invoice_id}":{"delete":{"summary":"Delete Tax Invoice","description":"删除税票记录","operationId":"delete_tax_invoice_finance_tax_invoices__tax_invoice_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Tax Invoice Id"},"name":"tax_invoice_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product_sku_sn/product-sku-sns/build-for-supplier-order":{"post":{"summary":"Build Snapshots For Supplier Order","description":"生成或编辑采购快照，传 supplier_order_id 时同事务同步订单及草稿货运清单。\n\n已有行须传本单 product_sku_sn_id。审批后锁定 SKU 和价格，首次实际入库后锁定数量及清单。\n返回 product_sku_sn_ids；未知、重复及其他订单的快照不会被改绑。","operationId":"build_snapshots_for_supplier_order_product_sku_sn_product_sku_sns_build_for_supplier_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildSupplierRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product_sku_sn/product-sku-sns/build-for-sale-order":{"post":{"summary":"Build Snapshots For Sale Order","description":"已有订单在同一事务保存商品、金额与库存占用；无订单时构建待绑定快照。","operationId":"build_snapshots_for_sale_order_product_sku_sn_product_sku_sns_build_for_sale_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildSaleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-pricing":1,"x-wholety-sale-delivery":1}},"/product_sku_sn/product-sku-sns/build-for-sale-return":{"post":{"summary":"Build Snapshots For Sale Return","description":"构建/同步退货快照（type=3 退货）。\n每个 item 表示一行退货商品；新增→创建，已存在 return_snapshot_id→更新，不在 items 中的旧快照→删除。\n支持携带 sale_order_id（关联到的销售订单）+ source_product_sku_sn_id（来自该销售订单的快照，用于带回保质期/原价）。","operationId":"build_snapshots_for_sale_return_product_sku_sn_product_sku_sns_build_for_sale_return_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildSaleReturnRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product_sku_sn/product-sku-sns/build-for-warehouse-io":{"post":{"summary":"Build Snapshots For Warehouse Io","description":"根据出入库商品项生成快照，返回 product_sku_sn_ids。type: 0=入库 1=出库 2=退库","operationId":"build_snapshots_for_warehouse_io_product_sku_sn_product_sku_sns_build_for_warehouse_io_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildWarehouseIORequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product_sku_sn/product-sku-sns/build-for-warehouse-transfer":{"post":{"summary":"Build Snapshots For Warehouse Transfer","description":"根据移库项生成快照，返回 product_sku_sn_ids。每项需指定来源 product_stock_id、数量及目标货架位","operationId":"build_snapshots_for_warehouse_transfer_product_sku_sn_product_sku_sns_build_for_warehouse_transfer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildWarehouseTransferRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/product_sku_sn/product-sku-sns/list-by-ids":{"post":{"summary":"List Product Sku Sns By Ids","description":"按 product_sku_sn_ids 返回快照列表（保持传入顺序）","operationId":"list_product_sku_sns_by_ids_product_sku_sn_product_sku_sns_list_by_ids_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSkuSnBuildResponse"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-skus/cards/query":{"post":{"summary":"Browse Sku Cards","description":"当前商户的商品卡片分页；不返回完整商品、库存批次或报价列表。","operationId":"browse_sku_cards_store_purchase_browse_skus_cards_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalCardsQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalCardsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-skus/cards/lookup":{"post":{"summary":"Browse Sku Cards Lookup","operationId":"browse_sku_cards_lookup_store_purchase_browse_skus_cards_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalCardsLookup"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalCardsLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/selection/quotes/query":{"post":{"summary":"Portal Selection Quotes","operationId":"portal_selection_quotes_store_purchase_selection_quotes_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalQuoteQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalQuoteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-products/list":{"post":{"summary":"Browse Product List","description":"商家选购商品列表（SKU 维度，每个商品为独立个体）","operationId":"browse_product_list_store_purchase_browse_products_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreBrowseProductListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-products/{sku_id}":{"get":{"summary":"Browse Product Detail","description":"商家查看商品详情（SKU 个体）","operationId":"browse_product_detail_store_purchase_browse_products__sku_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"},{"required":false,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-skus/list":{"post":{"summary":"Browse Sku List","description":"商家浏览商品列表（SKU 维度，含综合库存数量和价格）","operationId":"browse_sku_list_store_purchase_browse_skus_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreBrowseSkuListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/browse-skus/{sku_id}":{"get":{"summary":"Browse Sku Detail","description":"商家查看 SKU 详情","operationId":"browse_sku_detail_store_purchase_browse_skus__sku_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Sku Id"},"name":"sku_id","in":"path"},{"required":false,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-pricing":1}},"/store_purchase/cart/list":{"post":{"summary":"Get Cart List","description":"获取商家购物车列表（当前登录用户）","operationId":"get_cart_list_store_purchase_cart_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-pricing":1}},"/store_purchase/cart/add":{"post":{"summary":"Add To Cart","description":"添加商品到购物车（已存在则累加数量）。\n\n同一 SKU 再次加入：只加数量并刷新目录价 price，不覆盖已有 sn_sale_price / sn_sale_discount_price / sn_sale_remark。\n新建行：按请求体写入上述字段（可为空）。","operationId":"add_to_cart_store_purchase_cart_add_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartAddItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-pricing":1}},"/store_purchase/cart/batch-add":{"post":{"summary":"Batch Add To Cart","description":"批量添加商品到购物车（已存在则累加数量），单条失败不影响其他条目。","operationId":"batch_add_to_cart_store_purchase_cart_batch_add_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartBatchAdd"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/cart/{cart_id}/update":{"post":{"summary":"Update Cart Item","description":"更新数量；售价、优惠和备注省略时保留，显式 null 时清除。","operationId":"update_cart_item_store_purchase_cart__cart_id__update_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Cart Id"},"name":"cart_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartUpdateItem"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/cart/{cart_id}":{"delete":{"summary":"Remove Cart Item","description":"删除购物车中的商品","operationId":"remove_cart_item_store_purchase_cart__cart_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Cart Id"},"name":"cart_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/cart/clear":{"post":{"summary":"Clear Cart","description":"清空商家购物车","operationId":"clear_cart_store_purchase_cart_clear_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/cart/count":{"post":{"summary":"Get Cart Count","description":"获取购物车商品数量","operationId":"get_cart_count_store_purchase_cart_count_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/cart/checkout":{"post":{"summary":"Cart Checkout","description":"购物车结算：生成销售快照并创建销售订单（状态申请），成功后清空购物车。","operationId":"cart_checkout_store_purchase_cart_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreCartCheckoutParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-sale-pricing":1,"x-wholety-sale-delivery":1,"x-wholety-cart-integrity":1}},"/store_purchase/store-sale-orders/list":{"post":{"summary":"Get Store Sale Orders","description":"商家查看销售单列表（只读）：仅当前用户绑定商户的订单","operationId":"get_store_sale_orders_store_purchase_store_sale_orders_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaleOrderListParams"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/store_purchase/store-sale-orders/{order_id}":{"get":{"summary":"Get Store Sale Order Detail","description":"商家查看销售单详情（只读，仅看状态和商品）","operationId":"get_store_sale_order_detail_store_purchase_store_sale_orders__order_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Order Id"},"name":"order_id","in":"path"},{"required":false,"schema":{"type":"integer","title":"Store Id"},"name":"store_id","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/cache/versions":{"get":{"summary":"Get Cache Versions","description":"返回参与浏览器缓存的实体版本号（不含销售/供应链订单）。","operationId":"get_cache_versions_cache_versions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/cache/entities/{entity_key}/cache-sync":{"get":{"summary":"Get Entity Cache Sync","description":"低频表 cache-sync：local_version=0 全量；否则按 changelog 增量。","operationId":"get_entity_cache_sync_cache_entities__entity_key__cache_sync_get","parameters":[{"required":true,"schema":{"type":"string","title":"Entity Key"},"name":"entity_key","in":"path"},{"required":false,"schema":{"type":"integer","title":"Local Version"},"name":"local_version","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/exchange-rate/rates":{"get":{"summary":"Get Exchange Rates","description":"获取汇率。\n若距上次更新已超过 1 小时，则先自动刷新再返回。","operationId":"get_exchange_rates_exchange_rate_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/exchange-rate/rates/refresh":{"post":{"summary":"Refresh Exchange Rates","description":"主动刷新汇率并返回最新数据。","operationId":"refresh_exchange_rates_exchange_rate_rates_refresh_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardResponse"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/account/agent-bootstrap":{"get":{"summary":"Agent Bootstrap Metadata","operationId":"agent_bootstrap_metadata_account_agent_bootstrap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Agent Bootstrap Create","operationId":"agent_bootstrap_create_account_agent_bootstrap_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBootstrapCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/account":{"get":{"summary":"Account Info","operationId":"account_info_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/account/members":{"get":{"summary":"Members","operationId":"members_account_members_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Create Member","operationId":"create_member_account_members_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-member-role-integrity":1}},"/account/members/{user_id}":{"post":{"summary":"Update Member","operationId":"update_member_account_members__user_id__post","parameters":[{"required":true,"schema":{"type":"integer","title":"User Id"},"name":"user_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}],"x-wholety-member-role-integrity":1}},"/account/api-keys":{"get":{"summary":"List Keys","operationId":"list_keys_account_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Create Key","operationId":"create_key_account_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/account/api-keys/{key_id}/revoke":{"post":{"summary":"Revoke Key","operationId":"revoke_key_account_api_keys__key_id__revoke_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Key Id"},"name":"key_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/account/agent-audit":{"get":{"summary":"Agent Audit","operationId":"agent_audit_account_agent_audit_get","parameters":[{"required":false,"schema":{"type":"integer","exclusiveMinimum":0.0,"title":"Before Id"},"name":"before_id","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":100},"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing":{"get":{"summary":"Billing","operationId":"billing_billing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing/checkout":{"post":{"summary":"Checkout","operationId":"checkout_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing/checkout/cancel":{"post":{"summary":"Cancel Checkout","operationId":"cancel_checkout_billing_checkout_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutCancelBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing/portal":{"post":{"summary":"Portal","operationId":"portal_billing_portal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingReturnBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing/invoices":{"get":{"summary":"Invoices","operationId":"invoices_billing_invoices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/billing/webhook":{"post":{"summary":"Webhook","operationId":"webhook_billing_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"summary":"Mcp Get","operationId":"mcp_get_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Mcp","operationId":"mcp_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/guide":{"get":{"summary":"Read Agent migration workflow, live schemas and account capacity","operationId":"get_migration_guide_migration_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/preview":{"post":{"summary":"Preview Agent-normalized migration rows without writing business data","description":"Recognize persisted references and legacy import evidence within this account.\n\nExisting orders require reconciliation; hidden or ambiguous targets block the batch.\nThis read-only preview never adopts source mappings or replays stock and payments.","operationId":"preview_migration_records_migration_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationPreview"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs":{"get":{"summary":"Read migration jobs and last checkpoint counts","operationId":"list_migration_jobs_migration_jobs_get","parameters":[{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]},"post":{"summary":"Create or recover a durable account-owned migration ledger","operationId":"create_migration_job_migration_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationJobCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}":{"get":{"summary":"Read a migration job, version and persisted source progress","operationId":"read_migration_job_migration_jobs__job_id__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}/rows":{"get":{"summary":"Read paginated source inputs, target IDs and last observations","operationId":"list_migration_rows_migration_jobs__job_id__rows_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"name":"page_size","in":"query"},{"required":false,"schema":{"type":"string","enum":["brands","warehouses","suppliers","stores","products","opening_stock","purchase_orders","sales_orders"],"title":"Entity"},"name":"entity","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}/events":{"get":{"summary":"Read immutable paginated migration operation receipts","operationId":"list_migration_events_migration_jobs__job_id__events_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}/reconcile":{"get":{"summary":"Read current target comparisons for a page without saving a checkpoint","operationId":"read_migration_reconciliation_migration_jobs__job_id__reconcile_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"name":"page_size","in":"query"},{"required":false,"schema":{"type":"string","enum":["brands","warehouses","suppliers","stores","products","opening_stock","purchase_orders","sales_orders"],"title":"Entity"},"name":"entity","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}/stage":{"post":{"summary":"Save a bounded source batch and preflight observation; does not write business data","operationId":"stage_migration_records_migration_jobs__job_id__stage_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStage"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}},"/migration/jobs/{job_id}/checkpoint":{"post":{"summary":"Reconcile stored sources against current target facts and save an idempotent checkpoint","operationId":"checkpoint_migration_records_migration_jobs__job_id__checkpoint_post","parameters":[{"required":true,"schema":{"type":"integer","title":"Job Id"},"name":"job_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationCheckpoint"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"OAuth2PasswordBearer":[]}]}}},"components":{"schemas":{"AgentBootstrapCreate":{"properties":{"creation_key":{"type":"string","format":"uuid4","title":"Creation Key"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes","default":["read","write"]}},"type":"object","required":["creation_key"],"title":"AgentBootstrapCreate"},"AnnualTargetCreate":{"properties":{"brand_id":{"type":"integer","title":"Brand Id"},"year":{"type":"integer","maximum":2100.0,"minimum":2000.0,"title":"Year"},"annual_target":{"type":"number","title":"Annual Target","default":0},"q1_target":{"type":"number","title":"Q1 Target","default":0},"q2_target":{"type":"number","title":"Q2 Target","default":0},"q3_target":{"type":"number","title":"Q3 Target","default":0},"q4_target":{"type":"number","title":"Q4 Target","default":0}},"type":"object","required":["brand_id","year"],"title":"AnnualTargetCreate"},"AnnualTargetListParams":{"properties":{"brand_id":{"type":"integer","title":"Brand Id"}},"type":"object","required":["brand_id"],"title":"AnnualTargetListParams"},"AnnualTargetUpdate":{"properties":{"annual_target":{"type":"number","title":"Annual Target"},"q1_target":{"type":"number","title":"Q1 Target"},"q2_target":{"type":"number","title":"Q2 Target"},"q3_target":{"type":"number","title":"Q3 Target"},"q4_target":{"type":"number","title":"Q4 Target"}},"type":"object","title":"AnnualTargetUpdate"},"AuthListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"},"code":{"type":"string","title":"Code"}},"type":"object","title":"AuthListParams"},"AvatarUploadParams":{"properties":{"content_base64":{"type":"string","maxLength":2796204,"minLength":1,"title":"Content Base64"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}}},"type":"object","required":["content_base64"],"title":"AvatarUploadParams"},"BillingReturnBody":{"properties":{"return_target":{"type":"string","enum":["dashboard","website"],"title":"Return Target","default":"dashboard"},"locale":{"type":"string","enum":["en","zh","ja","ko","de","fr","es","pt"],"title":"Locale","default":"en"}},"additionalProperties":false,"type":"object","title":"BillingReturnBody"},"BoardPageSummary":{"properties":{"version":{"type":"integer","enum":[2],"title":"Version"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"timezone":{"type":"string","enum":["America/Toronto"],"title":"Timezone"},"recent_days":{"type":"integer","enum":[30],"title":"Recent Days"},"sale_months":{"type":"integer","enum":[12],"title":"Sale Months"},"in_transit_by_sku":{"additionalProperties":{"type":"number"},"type":"object","title":"In Transit By Sku"},"sale_summary_by_sku":{"additionalProperties":{"$ref":"#/components/schemas/BoardSaleQuantitySummary"},"type":"object","title":"Sale Summary By Sku"}},"additionalProperties":false,"type":"object","required":["version","as_of","timezone","recent_days","sale_months","in_transit_by_sku","sale_summary_by_sku"],"title":"BoardPageSummary"},"BoardSaleQuantitySummary":{"properties":{"recent30":{"type":"number","title":"Recent30"},"recent90":{"type":"number","title":"Recent90"},"months":{"additionalProperties":{"type":"number"},"type":"object","title":"Months"}},"additionalProperties":false,"type":"object","required":["recent30","recent90","months"],"title":"BoardSaleQuantitySummary"},"BoardSkuIdentity":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"integer","title":"Unit Count"},"brand_id":{"type":"integer","title":"Brand Id"},"brand_name":{"type":"string","title":"Brand Name"},"default_supplier_id":{"type":"integer","title":"Default Supplier Id"},"sku_state":{"type":"string","enum":["visible"],"title":"Sku State","default":"visible"}},"additionalProperties":false,"type":"object","required":["id"],"title":"BoardSkuIdentity"},"BoardSkuIds":{"properties":{"kind":{"type":"string","enum":["ids"],"title":"Kind","default":"ids"},"page":{"type":"integer","enum":[1],"title":"Page","default":1},"page_size":{"type":"integer","enum":[100],"title":"Page Size","default":100},"total_pages":{"type":"integer","enum":[1],"title":"Total Pages","default":1},"metadata_version":{"type":"integer","title":"Metadata Version"},"items":{"items":{"$ref":"#/components/schemas/BoardSkuIdentity"},"type":"array","title":"Items"},"resolved_ids":{"items":{"type":"integer"},"type":"array","title":"Resolved Ids"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"}},"additionalProperties":false,"type":"object","required":["metadata_version","items","resolved_ids","unavailable_ids"],"title":"BoardSkuIds"},"BoardSkuPage":{"properties":{"kind":{"type":"string","enum":["page"],"title":"Kind","default":"page"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"sort":{"type":"string","enum":["catalog"],"title":"Sort","default":"catalog"},"metadata_version":{"type":"integer","title":"Metadata Version"},"facts_as_of":{"type":"string","format":"date-time","title":"Facts As Of"},"items":{"items":{"$ref":"#/components/schemas/BoardSkuReadRow"},"type":"array","title":"Items"},"summary":{"$ref":"#/components/schemas/BoardPageSummary"}},"additionalProperties":false,"type":"object","required":["page","page_size","total_pages","metadata_version","facts_as_of","items","summary"],"title":"BoardSkuPage"},"BoardSkuQuery":{"properties":{"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"brand_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Brand Id"},"sort":{"type":"string","enum":["catalog"],"title":"Sort","default":"catalog"},"ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Ids"}},"additionalProperties":false,"type":"object","title":"BoardSkuQuery"},"BoardSkuQueryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"$ref":"#/components/schemas/BoardSkuPage"},{"$ref":"#/components/schemas/BoardSkuIds"}],"title":"Data"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"BoardSkuQueryResponse"},"BoardSkuReadRow":{"properties":{"identity":{"$ref":"#/components/schemas/BoardSkuIdentity"},"physical_stock":{"type":"number","title":"Physical Stock"},"warehouses":{"items":{"$ref":"#/components/schemas/BoardWarehouseQuantity"},"type":"array","title":"Warehouses"},"warehouse_count":{"type":"integer","title":"Warehouse Count"},"warehouse_has_more":{"type":"boolean","title":"Warehouse Has More"},"turnover":{"$ref":"#/components/schemas/BoardTurnoverReference"}},"additionalProperties":false,"type":"object","required":["identity","physical_stock","warehouses","warehouse_count","warehouse_has_more","turnover"],"title":"BoardSkuReadRow"},"BoardStockReadRow":{"properties":{"id":{"type":"integer","title":"Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"warehouse_name":{"type":"string","title":"Warehouse Name"},"stock":{"type":"number","title":"Stock"},"block_stock":{"type":"number","title":"Block Stock"},"sale_stock":{"type":"number","title":"Sale Stock"},"available_stock":{"type":"number","title":"Available Stock"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"shelf_position":{"type":"string","title":"Shelf Position"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"pre_stock":{"type":"boolean","title":"Pre Stock"},"stock_tag":{"type":"integer","title":"Stock Tag"}},"additionalProperties":false,"type":"object","required":["id","product_sku_id","warehouse_id"],"title":"BoardStockReadRow"},"BoardStocksPage":{"properties":{"sku_id":{"type":"integer","title":"Sku Id"},"profile":{"type":"string","enum":["positive_quantities"],"title":"Profile","default":"positive_quantities"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"physical_stock":{"type":"number","title":"Physical Stock"},"facts_as_of":{"type":"string","format":"date-time","title":"Facts As Of"},"items":{"items":{"$ref":"#/components/schemas/BoardStockReadRow"},"type":"array","title":"Items"}},"additionalProperties":false,"type":"object","required":["sku_id","page","page_size","total_pages","physical_stock","facts_as_of","items"],"title":"BoardStocksPage"},"BoardStocksQuery":{"properties":{"sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sku Id"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"profile":{"type":"string","enum":["positive_quantities"],"title":"Profile","default":"positive_quantities"}},"additionalProperties":false,"type":"object","required":["sku_id"],"title":"BoardStocksQuery"},"BoardStocksResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/BoardStocksPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"BoardStocksResponse"},"BoardTurnoverReference":{"properties":{"latest":{"type":"number","title":"Latest"},"source_time":{"type":"string","format":"date-time","title":"Source Time"},"scope":{"type":"string","enum":["visible_sales"],"title":"Scope","default":"visible_sales"},"source":{"type":"string","enum":["latest"],"title":"Source","default":"latest"},"period":{"type":"string","enum":["all_time"],"title":"Period","default":"all_time"}},"additionalProperties":false,"type":"object","title":"BoardTurnoverReference"},"BoardWarehouseQuantity":{"properties":{"warehouse_id":{"type":"integer","title":"Warehouse Id"},"warehouse_name":{"type":"string","title":"Warehouse Name"},"quantity":{"type":"number","title":"Quantity"}},"additionalProperties":false,"type":"object","required":["warehouse_id","quantity"],"title":"BoardWarehouseQuantity"},"Body_delete_brand_image_api_oss_brand_delete_post":{"properties":{"brand_id":{"type":"integer","title":"Brand Id"}},"type":"object","required":["brand_id"],"title":"Body_delete_brand_image_api_oss_brand_delete_post"},"Body_delete_productsku_image_api_oss_productsku_delete_post":{"properties":{"sku_code":{"type":"string","title":"Sku Code"}},"type":"object","required":["sku_code"],"title":"Body_delete_productsku_image_api_oss_productsku_delete_post"},"Body_delete_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__delete_post"},"Body_delete_saleorder_file_api_oss_saleorder__sale_order_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_saleorder_file_api_oss_saleorder__sale_order_id__delete_post"},"Body_delete_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__delete_post"},"Body_delete_supplierorder_file_api_oss_supplierorder__supplier_order_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_supplierorder_file_api_oss_supplierorder__supplier_order_id__delete_post"},"Body_delete_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__delete_post":{"properties":{"file_key":{"type":"string","title":"File Key"},"filename":{"type":"string","title":"Filename"}},"type":"object","required":["file_key","filename"],"title":"Body_delete_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__delete_post"},"Body_delete_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__delete_post"},"Body_delete_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__delete_post":{"properties":{"filename":{"type":"string","title":"Filename"}},"type":"object","required":["filename"],"title":"Body_delete_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__delete_post"},"Body_get_string_hash_user_get_hash_post":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"Body_get_string_hash_user_get_hash_post"},"Body_get_suppliershippinginfo_files_api_oss_suppliershippinginfo__supplier_shipping_info_id__list_post":{"properties":{"file_key":{"type":"string","title":"File Key"}},"type":"object","required":["file_key"],"title":"Body_get_suppliershippinginfo_files_api_oss_suppliershippinginfo__supplier_shipping_info_id__list_post"},"Body_upload_brand_image_api_oss_brand_upload_post":{"properties":{"brand_id":{"type":"integer","title":"Brand Id"},"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["brand_id","file"],"title":"Body_upload_brand_image_api_oss_brand_upload_post"},"Body_upload_current_user_avatar_user_avatar_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_current_user_avatar_user_avatar_post"},"Body_upload_productsku_image_api_oss_productsku_upload_post":{"properties":{"sku_code":{"type":"string","title":"Sku Code"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["sku_code","file"],"title":"Body_upload_productsku_image_api_oss_productsku_upload_post"},"Body_upload_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_saleinvoice_file_api_oss_saleinvoice__sale_invoice_id__upload_post"},"Body_upload_saleorder_file_api_oss_saleorder__sale_order_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_saleorder_file_api_oss_saleorder__sale_order_id__upload_post"},"Body_upload_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_supplierinvoice_file_api_oss_supplierinvoice__supplier_invoice_id__upload_post"},"Body_upload_supplierorder_file_api_oss_supplierorder__supplier_order_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_supplierorder_file_api_oss_supplierorder__supplier_order_id__upload_post"},"Body_upload_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__upload_post":{"properties":{"file_key":{"type":"string","title":"File Key"},"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file_key","file"],"title":"Body_upload_suppliershippinginfo_file_api_oss_suppliershippinginfo__supplier_shipping_info_id__upload_post"},"Body_upload_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_taxinvoice_file_api_oss_taxinvoice__tax_invoice_id__upload_post"},"Body_upload_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_warehouse_io_file_api_oss_warehouseio__warehouse_io_id__upload_post"},"BrandCategoryCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"order_num":{"type":"integer","title":"Order Num","description":"排序，越大越靠前","default":0},"hide":{"type":"integer","title":"Hide","description":"0显示 1隐藏","default":0}},"type":"object","required":["name"],"title":"BrandCategoryCreate"},"BrandCategoryListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"BrandCategoryListParams"},"BrandCategorySetBrands":{"properties":{"brand_ids":{"items":{"type":"integer"},"type":"array","title":"Brand Ids","description":"关联的品牌 id 列表（全量覆盖）"},"expected_brand_ids":{"items":{"type":"integer"},"type":"array","title":"Expected Brand Ids","description":"可选的当前关联快照；与服务端不一致时返回 409，避免覆盖其他成员或 Agent 的修改"}},"type":"object","title":"BrandCategorySetBrands"},"BrandCategoryUpdate":{"properties":{"name":{"type":"string","title":"Name"},"order_num":{"type":"integer","title":"Order Num"},"hide":{"type":"integer","title":"Hide"}},"type":"object","title":"BrandCategoryUpdate"},"BrandCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"order_num":{"type":"integer","title":"Order Num","description":"排序，越大越靠前","default":0},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids","description":"关联的品牌类别 id 列表"}},"type":"object","required":["name"],"title":"BrandCreate"},"BrandListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"BrandListParams"},"BrandUpdate":{"properties":{"name":{"type":"string","title":"Name"},"order_num":{"type":"integer","title":"Order Num"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"}},"type":"object","title":"BrandUpdate"},"CatalogQueryPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CatalogSkuItem"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","page","page_size","total_pages","product_sku_version"],"title":"CatalogQueryPage"},"CatalogQueryParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Ids"},"brand_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Brand Id"},"category_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","title":"Category Ids"},"status":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Status"},"country_code":{"type":"string","maxLength":20,"title":"Country Code"},"custom_category_1":{"type":"string","maxLength":200,"title":"Custom Category 1"},"custom_category_2":{"type":"string","maxLength":200,"title":"Custom Category 2"},"custom_category_3":{"type":"string","maxLength":200,"title":"Custom Category 3"}},"additionalProperties":false,"type":"object","title":"CatalogQueryParams"},"CatalogQueryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/CatalogQueryPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"CatalogQueryResponse"},"CatalogSkuItem":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"brand_id":{"type":"integer","title":"Brand Id"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"},"status":{"type":"integer","title":"Status"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"integer","title":"Unit Count"},"order_num":{"type":"integer","title":"Order Num"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"}},"type":"object","required":["id","code","sku_code","spec_name","category_ids","unit","unit_count","order_num"],"title":"CatalogSkuItem"},"CategoryCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"en_name":{"type":"string","maxLength":100,"title":"En Name"},"parent_id":{"type":"integer","title":"Parent Id"},"status":{"type":"integer","title":"Status","default":0},"order_num":{"type":"integer","title":"Order Num","default":0}},"type":"object","required":["name"],"title":"CategoryCreate"},"CategoryListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"},"parent_id":{"type":"integer","title":"Parent Id"},"status":{"type":"integer","title":"Status"},"level":{"type":"integer","title":"Level"}},"type":"object","title":"CategoryListParams"},"CategoryReorder":{"properties":{"parent_id":{"type":"integer","title":"Parent Id"},"expected_ids":{"items":{"type":"integer"},"type":"array","minItems":1,"title":"Expected Ids"},"ordered_ids":{"items":{"type":"integer"},"type":"array","minItems":1,"title":"Ordered Ids"}},"type":"object","required":["expected_ids","ordered_ids"],"title":"CategoryReorder"},"CategoryUpdate":{"properties":{"name":{"type":"string","title":"Name"},"en_name":{"type":"string","title":"En Name"},"parent_id":{"type":"integer","title":"Parent Id"},"status":{"type":"integer","title":"Status"},"order_num":{"type":"integer","title":"Order Num"}},"type":"object","title":"CategoryUpdate"},"CheckoutBody":{"properties":{"return_target":{"type":"string","enum":["dashboard","website"],"title":"Return Target","default":"dashboard"},"locale":{"type":"string","enum":["en","zh","ja","ko","de","fr","es","pt"],"title":"Locale","default":"en"},"plan":{"type":"string","enum":["wholety","starter","growth"],"title":"Plan"},"cycle":{"type":"string","enum":["monthly","quarterly","yearly"],"title":"Cycle"},"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["plan","cycle","request_id"],"title":"CheckoutBody"},"CheckoutCancelBody":{"properties":{"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["request_id"],"title":"CheckoutCancelBody"},"CompleteChat":{"properties":{"prompt":{"type":"string","maxLength":128000,"minLength":1,"title":"Prompt"},"session_id":{"type":"string","maxLength":4096,"title":"Session Id"},"appid":{"type":"string","maxLength":128,"title":"Appid"},"stream":{"type":"boolean","enum":[false],"title":"Stream","default":false}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"CompleteChat"},"ContainerLoadingInput":{"properties":{"order_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Order Ids"},"container_code":{"type":"string","enum":["20GP","40GP","40HQ","45HQ","CUSTOM"],"title":"Container Code","default":"20GP"},"custom_volume_m3":{"type":"number","title":"Custom Volume M3"},"available_percent":{"type":"number","title":"Available Percent","default":100}},"type":"object","required":["order_ids"],"title":"ContainerLoadingInput"},"FileDeleteParams":{"properties":{"file_key":{"type":"string","title":"File Key"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}},"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"}},"type":"object","required":["filename"],"title":"FileDeleteParams"},"FileParams":{"properties":{"file_key":{"type":"string","title":"File Key"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}}},"type":"object","title":"FileParams"},"FileUploadParams":{"properties":{"file_key":{"type":"string","title":"File Key"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}},"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_base64":{"type":"string","maxLength":13981016,"minLength":1,"title":"Content Base64"}},"type":"object","required":["filename","content_base64"],"title":"FileUploadParams"},"FinanceTypeCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"}},"type":"object","required":["name"],"title":"FinanceTypeCreate"},"FinanceTypeListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"FinanceTypeListParams"},"FinanceTypeUpdate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"}},"type":"object","title":"FinanceTypeUpdate"},"GoogleCredential":{"properties":{"credential":{"type":"string","maxLength":8192,"minLength":20,"title":"Credential"}},"type":"object","required":["credential"],"title":"GoogleCredential"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistoricalImportPayment":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"实际收付款日期；有时区时转换为多伦多业务时间"},"price_exchange":{"type":"string","maxLength":3,"minLength":3,"pattern":"^[A-Z]{3}$","title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMinimum":0.0,"title":"Price Exchange Price"},"price_exchange_rate":{"type":"number","exclusiveMinimum":0.0,"title":"Price Exchange Rate"}},"additionalProperties":false,"type":"object","required":["amount","pay_time"],"title":"HistoricalImportPayment","description":"一笔真实收付款；金额为正 CAD，方向由采购付款 / 销售收款决定。"},"ImageUploadParams":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"content_base64":{"type":"string","maxLength":6990508,"minLength":1,"title":"Content Base64"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}}},"type":"object","required":["filename","content_base64"],"title":"ImageUploadParams"},"ImportIdentityMatch":{"properties":{"token":{"type":"string","title":"Token"},"normalized_key":{"type":"string","title":"Normalized Key"},"status":{"type":"string","enum":["unique","missing","ambiguous"],"title":"Status"},"match_count":{"type":"integer","title":"Match Count"},"identity":{"$ref":"#/components/schemas/SkuMetadataIdentity"}},"type":"object","required":["token","normalized_key","status","match_count"],"title":"ImportIdentityMatch"},"ImportIdentityResolution":{"properties":{"purpose":{"type":"string","enum":["order_import","stock_import"],"title":"Purpose"},"context":{"anyOf":[{"$ref":"#/components/schemas/OrderImportContext"},{"$ref":"#/components/schemas/StockImportContext"}],"title":"Context"},"matches":{"items":{"$ref":"#/components/schemas/ImportIdentityMatch"},"type":"array","title":"Matches"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["purpose","context","matches","product_sku_version"],"title":"ImportIdentityResolution"},"ImportIdentityResolveParams":{"properties":{"purpose":{"type":"string","enum":["order_import","stock_import"],"title":"Purpose"},"import_kind":{"type":"string","enum":["po","so"],"title":"Import Kind"},"tokens":{"items":{"type":"string","maxLength":200,"minLength":1},"type":"array","maxItems":100,"minItems":1,"title":"Tokens"}},"additionalProperties":false,"type":"object","required":["purpose","tokens"],"title":"ImportIdentityResolveParams"},"ImportIdentityResolveResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/ImportIdentityResolution"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"ImportIdentityResolveResponse"},"InventoryCheckChangeShelfParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"new_shelf_position":{"type":"string","title":"New Shelf Position"},"new_expire_time":{"type":"string","format":"date-time","title":"New Expire Time"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","product_stock_id"],"title":"InventoryCheckChangeShelfParams","description":"实时盘点：可改货架位/保质期，不改变数量。"},"InventoryCheckMarkDestroyParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","product_stock_id"],"title":"InventoryCheckMarkDestroyParams","description":"实时盘点：标记待销毁（仅 stock_tag，不改数量）。"},"InventoryCheckOperationListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_sku_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Id"},"action":{"type":"integer","exclusiveMinimum":0.0,"title":"Action"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","required":["warehouse_id"],"title":"InventoryCheckOperationListParams","description":"盘点操作记录列表（按时间筛选）。"},"InventoryCheckSplitParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"from_product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"From Product Stock Id"},"split_qty":{"type":"number","exclusiveMinimum":0.0,"title":"Split Qty"},"target_shelf_position":{"type":"string","title":"Target Shelf Position"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","from_product_stock_id","split_qty","target_shelf_position"],"title":"InventoryCheckSplitParams","description":"实时盘点：从一行拆出若干到目标货架，仓库总实存不变。"},"InventoryCheckUnmarkDestroyParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","product_stock_id"],"title":"InventoryCheckUnmarkDestroyParams","description":"实时盘点：取消待销毁标记（仅 stock_tag，不改数量）。"},"InventoryLookupPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/InventoryReadRow"},"type":"array","title":"Items"},"missing_ids":{"items":{"type":"integer"},"type":"array","title":"Missing Ids"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","missing_ids","product_sku_version"],"title":"InventoryLookupPage"},"InventoryLookupParams":{"properties":{"mode":{"type":"string","enum":["view","check","shelf","destroy"],"title":"Mode"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"stock_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Stock Ids"}},"additionalProperties":false,"type":"object","required":["mode","warehouse_id","stock_ids"],"title":"InventoryLookupParams"},"InventoryLookupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InventoryLookupPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"InventoryLookupResponse"},"InventoryQueryPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/InventoryReadRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"relation":{"type":"string","enum":["main","other_shelves"],"title":"Relation"},"main_total_records":{"type":"integer","title":"Main Total Records"},"other_shelves_total_records":{"type":"integer","title":"Other Shelves Total Records"},"product_sku_version":{"type":"integer","title":"Product Sku Version"},"summary_scope":{"type":"string","enum":["main"],"title":"Summary Scope","default":"main"},"summary":{"$ref":"#/components/schemas/InventorySummary"}},"type":"object","required":["items","page","page_size","total_pages","relation","main_total_records","other_shelves_total_records","product_sku_version","summary"],"title":"InventoryQueryPage"},"InventoryQueryParams":{"properties":{"mode":{"type":"string","enum":["view","check","shelf","destroy"],"title":"Mode"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Product Sku Id"},"shelf_position":{"type":"string","maxLength":100,"title":"Shelf Position"},"relation":{"type":"string","enum":["main","other_shelves"],"title":"Relation","default":"main"}},"additionalProperties":false,"type":"object","required":["mode","warehouse_id"],"title":"InventoryQueryParams"},"InventoryQueryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InventoryQueryPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"InventoryQueryResponse"},"InventoryReadRow":{"properties":{"id":{"type":"integer","title":"Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"shelf_position":{"type":"string","title":"Shelf Position"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"stock":{"type":"number","title":"Stock"},"block_stock":{"type":"number","title":"Block Stock"},"sale_stock":{"type":"number","title":"Sale Stock"},"available_stock":{"type":"number","title":"Available Stock"},"supplier_price":{"anyOf":[{"type":"number"},{"type":"string","enum":["*"]}],"title":"Supplier Price"},"supplier_discount_price":{"anyOf":[{"type":"number"},{"type":"string","enum":["*"]}],"title":"Supplier Discount Price"},"supplier_shipping_cost":{"anyOf":[{"type":"number"},{"type":"string","enum":["*"]}],"title":"Supplier Shipping Cost"},"pre_stock":{"type":"boolean","title":"Pre Stock"},"stock_tag":{"type":"integer","title":"Stock Tag"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"sku":{"$ref":"#/components/schemas/InventorySkuIdentity"},"sku_state":{"type":"string","enum":["visible","hidden","missing"],"title":"Sku State"}},"type":"object","required":["id","product_sku_id","warehouse_id","sale_stock","stock_tag","sku_state"],"title":"InventoryReadRow"},"InventoryShelfOptionsPage":{"properties":{"items":{"items":{"type":"string"},"type":"array","title":"Items"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","has_more"],"title":"InventoryShelfOptionsPage"},"InventoryShelfOptionsParams":{"properties":{"mode":{"type":"string","enum":["check","shelf"],"title":"Mode"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"keyword":{"type":"string","maxLength":100,"title":"Keyword"},"limit":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":30}},"additionalProperties":false,"type":"object","required":["mode","warehouse_id"],"title":"InventoryShelfOptionsParams"},"InventoryShelfOptionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InventoryShelfOptionsPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"InventoryShelfOptionsResponse"},"InventorySkuIdentity":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"number","title":"Unit Count"}},"type":"object","required":["id","code","sku_code","spec_name"],"title":"InventorySkuIdentity"},"InventorySkuOptionsPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/InventorySkuIdentity"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","page","page_size","total_pages"],"title":"InventorySkuOptionsPage"},"InventorySkuOptionsParams":{"properties":{"mode":{"type":"string","enum":["view","check","shelf","destroy"],"title":"Mode"},"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":30},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Ids"}},"additionalProperties":false,"type":"object","required":["mode"],"title":"InventorySkuOptionsParams"},"InventorySkuOptionsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/InventorySkuOptionsPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"InventorySkuOptionsResponse"},"InventorySummary":{"properties":{"stock":{"type":"number","title":"Stock"},"sale":{"type":"number","title":"Sale"},"available":{"type":"number","title":"Available"},"cost":{"anyOf":[{"type":"number"},{"type":"string","enum":["*"]}],"title":"Cost"},"cost_state":{"type":"string","enum":["known","unknown","masked"],"title":"Cost State"}},"type":"object","required":["cost_state"],"title":"InventorySummary"},"KeyCreate":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes","default":["read"]},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["name"],"title":"KeyCreate"},"MemberCreate":{"properties":{"account":{"type":"string","maxLength":50,"title":"Account"},"password":{"type":"string","maxLength":72,"minLength":8,"title":"Password"},"name":{"type":"string","maxLength":50,"title":"Name"},"role_id":{"type":"integer","title":"Role Id"}},"type":"object","required":["account","password"],"title":"MemberCreate"},"MemberUpdate":{"properties":{"name":{"type":"string","maxLength":50,"title":"Name"},"password":{"type":"string","maxLength":72,"minLength":8,"title":"Password"},"role_id":{"type":"integer","title":"Role Id"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","title":"MemberUpdate"},"MigrationCheckpoint":{"properties":{"operation_key":{"type":"string","format":"uuid","title":"Operation Key"},"expected_version":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Expected Version"},"entity":{"type":"string","enum":["brands","warehouses","suppliers","stores","products","opening_stock","purchase_orders","sales_orders"],"title":"Entity"},"source_refs":{"items":{"type":"string","maxLength":200,"minLength":1},"type":"array","maxItems":100,"minItems":1,"title":"Source Refs"}},"additionalProperties":false,"type":"object","required":["operation_key","expected_version","entity","source_refs"],"title":"MigrationCheckpoint"},"MigrationJobCreate":{"properties":{"job_key":{"type":"string","format":"uuid","title":"Job Key"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"source_system":{"type":"string","maxLength":200,"minLength":1,"title":"Source System"},"cutover_date":{"type":"string","format":"date","title":"Cutover Date"},"inventory_strategy":{"type":"string","enum":["opening_balance","history_replay"],"title":"Inventory Strategy"}},"additionalProperties":false,"type":"object","required":["job_key","name"],"title":"MigrationJobCreate"},"MigrationPreview":{"properties":{"entity":{"type":"string","enum":["brands","warehouses","suppliers","stores","products","opening_stock","purchase_orders","sales_orders"],"title":"Entity"},"records":{"items":{"$ref":"#/components/schemas/MigrationRecord"},"type":"array","maxItems":100,"minItems":1,"title":"Records"},"inventory_strategy":{"type":"string","enum":["opening_balance","history_replay"],"title":"Inventory Strategy"}},"additionalProperties":false,"type":"object","required":["entity","records"],"title":"MigrationPreview"},"MigrationRecord":{"properties":{"source_ref":{"type":"string","maxLength":200,"minLength":1,"title":"Source Ref"},"data":{"type":"object","title":"Data"}},"additionalProperties":false,"type":"object","required":["source_ref","data"],"title":"MigrationRecord"},"MigrationStage":{"properties":{"entity":{"type":"string","enum":["brands","warehouses","suppliers","stores","products","opening_stock","purchase_orders","sales_orders"],"title":"Entity"},"records":{"items":{"$ref":"#/components/schemas/MigrationRecord"},"type":"array","maxItems":100,"minItems":1,"title":"Records"},"operation_key":{"type":"string","format":"uuid","title":"Operation Key"},"expected_version":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Expected Version"}},"additionalProperties":false,"type":"object","required":["entity","records","operation_key","expected_version"],"title":"MigrationStage"},"OCRParams":{"properties":{"document_type":{"type":"string","enum":["id_card","passport"],"title":"Document Type"},"content_base64":{"type":"string","maxLength":6990508,"minLength":1,"title":"Content Base64"},"model_config":{"type":"object","title":"Model Config","default":{"extra":"forbid"}}},"type":"object","required":["document_type","content_base64"],"title":"OCRParams"},"OrderImportBatchResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/OrderImportBatchResult"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"OrderImportBatchResponse"},"OrderImportBatchResult":{"properties":{"created":{"type":"integer","title":"Created"},"skipped":{"type":"integer","title":"Skipped"},"created_ids":{"items":{"type":"integer"},"type":"array","title":"Created Ids"},"skipped_keys":{"items":{"type":"string"},"type":"array","title":"Skipped Keys"},"source_mappings":{"items":{"$ref":"#/components/schemas/OrderImportSourceMapping"},"type":"array","title":"Source Mappings"},"outbound_ids":{"items":{"type":"integer"},"type":"array","title":"Outbound Ids"},"placed_ids":{"items":{"type":"integer"},"type":"array","title":"Placed Ids"},"blocked_reasons":{"items":{"type":"object"},"type":"array","title":"Blocked Reasons"},"skipped_no_cost_stocks":{"type":"integer","title":"Skipped No Cost Stocks","default":0},"payment_count":{"type":"integer","title":"Payment Count","default":0},"payment_order_ids":{"items":{"type":"integer"},"type":"array","title":"Payment Order Ids"}},"type":"object","required":["created","skipped"],"title":"OrderImportBatchResult","description":"批量导入结果"},"OrderImportContext":{"properties":{"import_kind":{"type":"string","enum":["po","so"],"title":"Import Kind"}},"additionalProperties":false,"type":"object","required":["import_kind"],"title":"OrderImportContext"},"OrderImportMetadataPage":{"properties":{"purpose":{"type":"string","enum":["order_import"],"title":"Purpose"},"profile":{"type":"string","enum":["identity","scan","logistics","identity_tax"],"title":"Profile"},"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/SkuMetadataIdentity"},{"$ref":"#/components/schemas/SkuMetadataScan"},{"$ref":"#/components/schemas/SkuMetadataLogistics"},{"$ref":"#/components/schemas/SkuMetadataIdentityTax"}]},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"},"resolved_ids":{"items":{"type":"integer"},"type":"array","title":"Resolved Ids"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"},"context":{"$ref":"#/components/schemas/OrderImportContext"}},"type":"object","required":["purpose","profile","items","page","page_size","total_pages","product_sku_version","resolved_ids","unavailable_ids","context"],"title":"OrderImportMetadataPage"},"OrderImportSourceMapping":{"properties":{"source_order_id":{"type":"integer","title":"Source Order Id"},"order_id":{"type":"integer","title":"Order Id"},"created":{"type":"boolean","title":"Created"}},"type":"object","required":["source_order_id","order_id","created"],"title":"OrderImportSourceMapping"},"PartnerMappingContext":{"properties":{"mapping_kind":{"type":"string","enum":["supplier","store"],"title":"Mapping Kind"},"partner_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Partner Id"},"mapping_revision":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Mapping Revision"}},"additionalProperties":false,"type":"object","required":["mapping_kind","partner_id","mapping_revision"],"title":"PartnerMappingContext"},"PartnerMappingMetadataPage":{"properties":{"purpose":{"type":"string","enum":["partner_mapping"],"title":"Purpose"},"profile":{"type":"string","enum":["identity","scan","logistics","identity_tax"],"title":"Profile"},"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/SkuMetadataIdentity"},{"$ref":"#/components/schemas/SkuMetadataScan"},{"$ref":"#/components/schemas/SkuMetadataLogistics"},{"$ref":"#/components/schemas/SkuMetadataIdentityTax"}]},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"},"resolved_ids":{"items":{"type":"integer"},"type":"array","title":"Resolved Ids"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"},"context":{"$ref":"#/components/schemas/PartnerMappingContext"}},"type":"object","required":["purpose","profile","items","page","page_size","total_pages","product_sku_version","resolved_ids","unavailable_ids","context"],"title":"PartnerMappingMetadataPage"},"PortalCardsLookup":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"product_sku_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Product Sku Ids"}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_ids"],"title":"PortalCardsLookup"},"PortalCardsLookupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PortalCardsLookupResult"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PortalCardsLookupResponse"},"PortalCardsLookupResult":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"items":{"items":{"$ref":"#/components/schemas/PortalSkuCard"},"type":"array","title":"Items"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"}},"additionalProperties":false,"type":"object","required":["store_id","items","unavailable_ids"],"title":"PortalCardsLookupResult"},"PortalCardsPage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"sort":{"type":"string","enum":["default","newest","restock"],"title":"Sort"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"timezone":{"type":"string","enum":["America/Toronto"],"title":"Timezone","default":"America/Toronto"},"items":{"items":{"$ref":"#/components/schemas/PortalSkuCard"},"type":"array","title":"Items"}},"type":"object","required":["store_id","page","page_size","total_pages","sort","as_of","items"],"title":"PortalCardsPage"},"PortalCardsQuery":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"brand_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Brand Id"},"brand_collection_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Brand Collection Id"},"brand_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Brand Ids"},"category_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Category Ids"},"stock_only":{"type":"boolean","title":"Stock Only","default":false},"sort":{"type":"string","enum":["default","newest","restock"],"title":"Sort","default":"default"}},"additionalProperties":false,"type":"object","required":["store_id"],"title":"PortalCardsQuery"},"PortalCardsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PortalCardsPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PortalCardsResponse"},"PortalDiscountPage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"default_id":{"type":"integer","title":"Default Id"},"kind":{"type":"string","enum":["discount"],"title":"Kind","default":"discount"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionDiscount"},"type":"array","title":"Items"}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","page","page_size","total_pages","items"],"title":"PortalDiscountPage"},"PortalPricePage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"default_id":{"type":"integer","title":"Default Id"},"kind":{"type":"string","enum":["price"],"title":"Kind","default":"price"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionPrice"},"type":"array","title":"Items"}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","page","page_size","total_pages","items"],"title":"PortalPricePage"},"PortalQuoteQuery":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Product Sku Id"},"kind":{"type":"string","enum":["price","discount"],"title":"Kind"},"page":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","kind"],"title":"PortalQuoteQuery"},"PortalQuoteResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"$ref":"#/components/schemas/PortalPricePage"},{"$ref":"#/components/schemas/PortalDiscountPage"}],"title":"Data"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PortalQuoteResponse"},"PortalSkuCard":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"integer","title":"Unit Count"},"status":{"type":"integer","enum":[1],"title":"Status"},"has_tax":{"type":"integer","title":"Has Tax"},"brand_id":{"type":"integer","title":"Brand Id"},"brand_name":{"type":"string","title":"Brand Name"},"total_stock":{"type":"number","title":"Total Stock"},"sale_price":{"type":"number","title":"Sale Price"},"sale_price_id":{"type":"integer","title":"Sale Price Id"}},"additionalProperties":false,"type":"object","required":["id","status","has_tax","total_stock"],"title":"PortalSkuCard"},"ProductSaleStockListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"product_stock_id":{"type":"integer","title":"Product Stock Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"}},"type":"object","title":"ProductSaleStockListParams","description":"查询销售订单占用库存列表"},"ProductSkuBatchGetParams":{"properties":{"ids":{"items":{"type":"integer"},"type":"array","maxItems":100,"minItems":1,"title":"Ids"}},"type":"object","required":["ids"],"title":"ProductSkuBatchGetParams"},"ProductSkuCodeResolveParams":{"properties":{"codes":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Codes"}},"type":"object","required":["codes"],"title":"ProductSkuCodeResolveParams"},"ProductSkuCreate":{"properties":{"code":{"type":"string","maxLength":50,"title":"Code"},"brand_id":{"type":"integer","title":"Brand Id"},"country_code":{"type":"string","maxLength":20,"title":"Country Code"},"custom_code":{"type":"string","title":"Custom Code"},"custom_category_1":{"type":"string","maxLength":200,"title":"Custom Category 1"},"custom_category_2":{"type":"string","maxLength":200,"title":"Custom Category 2"},"custom_category_3":{"type":"string","maxLength":200,"title":"Custom Category 3"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"},"sku_code":{"type":"string","maxLength":50,"title":"Sku Code"},"upc":{"type":"string","maxLength":50,"title":"Upc"},"spec_name":{"type":"string","maxLength":200,"title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"barcodes":{"type":"string","title":"Barcodes"},"unit":{"type":"string","maxLength":50,"title":"Unit"},"uom":{"type":"string","maxLength":100,"title":"Uom"},"unit_count":{"type":"integer","minimum":1.0,"title":"Unit Count","default":1},"status":{"type":"integer","title":"Status","default":0},"desc":{"type":"string","title":"Desc"},"size_desc":{"type":"string","title":"Size Desc"},"size_value":{"type":"number","title":"Size Value"},"size_length":{"type":"number","title":"Size Length"},"size_width":{"type":"number","title":"Size Width"},"size_height":{"type":"number","title":"Size Height"},"has_tax":{"type":"integer","title":"Has Tax","default":0},"default_supplier_id":{"type":"integer","title":"Default Supplier Id"},"order_num":{"type":"integer","title":"Order Num","description":"排序，越大越靠前，默认0不排序","default":0},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["code"],"title":"ProductSkuCreate"},"ProductSkuListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Page Size","default":10},"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"sku_code":{"type":"string","title":"Sku Code"},"brand_id":{"type":"integer","title":"Brand Id"},"category_id":{"type":"integer","title":"Category Id"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"},"status":{"type":"integer","title":"Status"},"country_code":{"type":"string","title":"Country Code"},"custom_category_1":{"type":"string","title":"Custom Category 1"},"custom_category_2":{"type":"string","title":"Custom Category 2"},"custom_category_3":{"type":"string","title":"Custom Category 3"}},"type":"object","title":"ProductSkuListParams"},"ProductSkuSaleDiscountCreate":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level","default":0},"remark":{"type":"string","title":"Remark"},"discount":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Discount"},"custom":{"type":"number","minimum":0.0,"title":"Custom"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["product_sku_id"],"title":"ProductSkuSaleDiscountCreate"},"ProductSkuSaleDiscountListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level"},"search":{"type":"string","maxLength":100,"title":"Search"}},"type":"object","title":"ProductSkuSaleDiscountListParams"},"ProductSkuSaleDiscountUpdate":{"properties":{"remark":{"type":"string","title":"Remark"},"discount":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Discount"},"custom":{"type":"number","minimum":0.0,"title":"Custom"},"level":{"type":"integer","title":"Level"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","title":"ProductSkuSaleDiscountUpdate"},"ProductSkuSalePriceCreate":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level","default":0},"price":{"type":"number","minimum":0.0,"title":"Price"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["product_sku_id","price"],"title":"ProductSkuSalePriceCreate"},"ProductSkuSalePriceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level"},"search":{"type":"string","maxLength":100,"title":"Search"}},"type":"object","title":"ProductSkuSalePriceListParams"},"ProductSkuSalePriceUpdate":{"properties":{"price":{"type":"number","minimum":0.0,"title":"Price"},"level":{"type":"integer","title":"Level"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","title":"ProductSkuSalePriceUpdate"},"ProductSkuSnBuildResponse":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"}},"type":"object","required":["product_sku_sn_ids"],"title":"ProductSkuSnBuildResponse","description":"构建快照返回：供创建订单/退货/出入库/盘点时传 product_sku_sn_ids"},"ProductSkuSnBuildSaleItem":{"properties":{"product_sku_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"product_sku_sn_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Sn Id"},"sale_price":{"type":"number","minimum":0.0,"title":"Sale Price"},"sale_discount_price":{"type":"number","minimum":0.0,"title":"Sale Discount Price"},"sale_remark":{"type":"string","title":"Sale Remark"}},"type":"object","required":["product_sku_id","quantity"],"title":"ProductSkuSnBuildSaleItem","description":"销售行只接受与现有 DECIMAL 列一致的数量和非负金额。"},"ProductSkuSnBuildSaleRequest":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSaleItem"},"type":"array","title":"Items"},"sale_order_id":{"type":"integer","title":"Sale Order Id"}},"type":"object","required":["store_id"],"title":"ProductSkuSnBuildSaleRequest","description":"构建销售订单快照：新增创建、已有则更新、不在列表中的原快照删除，与销售清单一对一。items 可为空（编辑时清空清单）。税率按 delivery_address_id 对应地址的 province.Total。"},"ProductSkuSnBuildSaleReturnItem":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","minimum":0.0,"title":"Quantity"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"source_product_sku_sn_id":{"type":"integer","title":"Source Product Sku Sn Id"},"expire_time":{"type":"string","title":"Expire Time"},"sn_sale_return_remark":{"type":"string","title":"Sn Sale Return Remark"},"sn_sale_return_shelf":{"type":"string","title":"Sn Sale Return Shelf"},"return_snapshot_id":{"type":"integer","title":"Return Snapshot Id"}},"type":"object","required":["quantity"],"title":"ProductSkuSnBuildSaleReturnItem","description":"退货快照单项（type=3 退货快照）。\n- 新建一行：必填 product_sku_id 与 quantity；可选 sale_order_id（关联到的销售订单）+ source_product_sku_sn_id（来源销售快照，用于回溯保质期/原价）。\n- 更新已有行：传 return_snapshot_id 即可，其他字段可选覆盖。"},"ProductSkuSnBuildSaleReturnRequest":{"properties":{"sale_return_id":{"type":"integer","title":"Sale Return Id"},"store_id":{"type":"integer","title":"Store Id"},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSaleReturnItem"},"type":"array","title":"Items"}},"type":"object","required":["sale_return_id"],"title":"ProductSkuSnBuildSaleReturnRequest","description":"构建退货快照：新增创建、已有则更新、不在列表中的原快照删除，与退货清单一对一。items 可为空（编辑时清空清单）。"},"ProductSkuSnBuildSupplierItem":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"supplier_price":{"type":"number","title":"Supplier Price"},"supplier_price_exchange":{"type":"string","title":"Supplier Price Exchange"},"supplier_price_exchange_price":{"type":"number","title":"Supplier Price Exchange Price"},"supplier_price_exchange_rate":{"type":"number","title":"Supplier Price Exchange Rate"},"supplier_tax_total":{"type":"number","title":"Supplier Tax Total","default":0},"product_sku_sn_id":{"type":"integer","title":"Product Sku Sn Id"}},"type":"object","required":["product_sku_id","quantity"],"title":"ProductSkuSnBuildSupplierItem","description":"采购订单快照单项。带 product_sku_sn_id 表示修改已有快照，否则为新增"},"ProductSkuSnBuildSupplierRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSupplierItem"},"type":"array","title":"Items"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"}},"type":"object","title":"ProductSkuSnBuildSupplierRequest","description":"构建采购订单快照：新增创建、已有则更新、不在列表中的原快照删除，与采购清单一对一。items 可为空（编辑时清空清单）"},"ProductSkuSnBuildWarehouseIOItem":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"expire_time":{"type":"string","title":"Expire Time"},"shelf_position":{"type":"string","title":"Shelf Position"},"product_stock_id":{"type":"integer","title":"Product Stock Id"},"supplier_product_sku_sn_id":{"type":"integer","title":"Supplier Product Sku Sn Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"source_sale_product_sku_sn_id":{"type":"integer","title":"Source Sale Product Sku Sn Id"}},"type":"object","required":["product_sku_id","quantity"],"title":"ProductSkuSnBuildWarehouseIOItem","description":"出入库快照单项"},"ProductSkuSnBuildWarehouseIORequest":{"properties":{"type":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Type","default":0},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildWarehouseIOItem"},"type":"array","minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"ProductSkuSnBuildWarehouseIORequest","description":"构建出入库快照"},"ProductSkuSnBuildWarehouseTransferItem":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"product_stock_id":{"type":"integer","title":"Product Stock Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"shelf_position":{"type":"string","title":"Shelf Position"}},"type":"object","required":["product_sku_id","product_stock_id","quantity"],"title":"ProductSkuSnBuildWarehouseTransferItem","description":"移库快照单项：来源库存 + 移库数量 + 目标货架位"},"ProductSkuSnBuildWarehouseTransferRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildWarehouseTransferItem"},"type":"array","minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"ProductSkuSnBuildWarehouseTransferRequest","description":"构建移库快照"},"ProductSkuUpdate":{"properties":{"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"upc":{"type":"string","title":"Upc"},"brand_id":{"type":"integer","title":"Brand Id"},"country_code":{"type":"string","maxLength":20,"title":"Country Code"},"custom_code":{"type":"string","title":"Custom Code"},"custom_category_1":{"type":"string","maxLength":200,"title":"Custom Category 1"},"custom_category_2":{"type":"string","maxLength":200,"title":"Custom Category 2"},"custom_category_3":{"type":"string","maxLength":200,"title":"Custom Category 3"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"barcodes":{"type":"string","title":"Barcodes"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","maxLength":100,"title":"Uom"},"unit_count":{"type":"integer","minimum":1.0,"title":"Unit Count"},"status":{"type":"integer","title":"Status"},"desc":{"type":"string","title":"Desc"},"size_desc":{"type":"string","title":"Size Desc"},"size_value":{"type":"number","title":"Size Value"},"size_length":{"type":"number","title":"Size Length"},"size_width":{"type":"number","title":"Size Width"},"size_height":{"type":"number","title":"Size Height"},"has_tax":{"type":"integer","title":"Has Tax"},"default_supplier_id":{"type":"integer","title":"Default Supplier Id"},"order_num":{"type":"integer","title":"Order Num"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","title":"ProductSkuUpdate"},"ProductStockImportBatchItem":{"properties":{"product_sku_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Id"},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"stock":{"type":"number","minimum":0.0,"title":"Stock"}},"type":"object","required":["product_sku_id","warehouse_id","stock"],"title":"ProductStockImportBatchItem","description":"历史库存 CSV 导入单行（sku + 仓库 + 目标箱数）。"},"ProductStockImportBatchParams":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProductStockImportBatchItem"},"type":"array","maxItems":100,"minItems":1,"title":"Items"},"closing_date":{"type":"string","title":"Closing Date"},"skip_unchanged":{"type":"boolean","title":"Skip Unchanged","default":true}},"type":"object","required":["items"],"title":"ProductStockImportBatchParams","description":"批量导入库存快照，按默认维度合并后写入目标 stock。"},"ProductStockInventoryUpdate":{"properties":{"product_stock_id":{"type":"integer","title":"Product Stock Id"},"product_sku_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Id"},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"stock":{"type":"number","minimum":0.0,"title":"Stock"},"shelf_position":{"type":"string","title":"Shelf Position"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"stock_tag":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Stock Tag"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["product_sku_id","warehouse_id"],"title":"ProductStockInventoryUpdate","description":"盘点场景：更新或新建库存。若指定 product_stock_id 则更新该条；否则按 (sku, 仓库, 过期日, 无供应链订单) 查找，找到则更新，找不到则新建。新建时若保质期与现有不符则新建一条。"},"ProductStockListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"}},"type":"object","title":"ProductStockListParams"},"ProductStockRecordListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"product_sku_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Id"},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"type":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Type"},"supplier_order_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Supplier Order Id"},"sale_order_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Sale Order Id"},"sale_return_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Sale Return Id"},"warehouse_io_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Io Id"},"warehouse_transfer_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Transfer Id"},"record_source":{"type":"string","title":"Record Source"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Toronto business time; timezone offsets are converted. A date starts at midnight"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"Inclusive Toronto business time; a date includes the entire day"}},"type":"object","title":"ProductStockRecordListParams"},"ProductStockRestockedProductsParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Days","default":30}},"type":"object","title":"ProductStockRestockedProductsParams","description":"近 N 天某库存批次从 0 变为正数的 SKU，按时间 / SKU ID 倒序。"},"ProductStockSplitForCheckParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"move_quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Move Quantity"},"target_shelf_position":{"type":"string","minLength":1,"title":"Target Shelf Position"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","product_stock_id","move_quantity","target_shelf_position"],"title":"ProductStockSplitForCheckParams","description":"盘点场景：拆出数量到目标货架；新行完整拷贝来源行（供应链订单、成本等）。"},"ProductStockUpdate":{"properties":{"shelf_position":{"type":"string","title":"Shelf Position"},"stock":{"type":"integer","title":"Stock"},"stock_tag":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Stock Tag"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","title":"ProductStockUpdate","description":"库存记录更新：仅货架位、标记；数量请走仓库出入库或实时盘点接口。"},"ProvinceCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"code":{"type":"string","maxLength":50,"title":"Code"},"type":{"type":"string","maxLength":50,"title":"Type"},"GST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Gst","default":0},"PST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pst","default":0},"QST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Qst","default":0},"HST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Hst","default":0},"Total":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Total","default":0}},"type":"object","required":["name"],"title":"ProvinceCreate"},"ProvinceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"},"code":{"type":"string","title":"Code"}},"type":"object","title":"ProvinceListParams"},"ProvinceUpdate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"code":{"type":"string","maxLength":50,"title":"Code"},"type":{"type":"string","maxLength":50,"title":"Type"},"GST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Gst"},"PST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Pst"},"QST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Qst"},"HST":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Hst"},"Total":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Total"}},"type":"object","title":"ProvinceUpdate"},"PurchaseRecommendationInput":{"properties":{"product_sku_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Product Sku Ids"},"recommend_days":{"type":"integer","maximum":3650.0,"minimum":1.0,"title":"Recommend Days","default":60}},"type":"object","required":["product_sku_ids"],"title":"PurchaseRecommendationInput"},"PutawayOperationPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PutawayOperationRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","page","page_size","total_pages","product_sku_version"],"title":"PutawayOperationPage"},"PutawayOperationProofParams":{"properties":{"putaway_mode":{"type":"string","enum":["supplier_order","sale_return","available_zone"],"title":"Putaway Mode"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Supplier Order Id"},"sale_return_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Sale Return Id"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Warehouse Id"},"source_product_stock_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Source Product Stock Id"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Product Sku Id"},"operation_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Operation Id"},"after_operation_id":{"type":"integer","maximum":2147483647.0,"minimum":0.0,"title":"After Operation Id"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20}},"additionalProperties":false,"type":"object","required":["putaway_mode","warehouse_id","source_product_stock_id","product_sku_id"],"title":"PutawayOperationProofParams"},"PutawayOperationProofResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PutawayOperationPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PutawayOperationProofResponse"},"PutawayOperationRow":{"properties":{"id":{"type":"integer","title":"Id"},"action":{"type":"integer","enum":[5],"title":"Action"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"source_product_stock_id":{"type":"integer","title":"Source Product Stock Id"},"target_product_stock_id":{"type":"integer","title":"Target Product Stock Id"},"putaway_mode":{"type":"string","enum":["supplier_order","sale_return","available_zone"],"title":"Putaway Mode"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"quantity":{"type":"number","title":"Quantity"},"create_time":{"type":"string","format":"date-time","title":"Create Time"}},"type":"object","required":["id","action","warehouse_id","product_sku_id","source_product_stock_id","target_product_stock_id","putaway_mode"],"title":"PutawayOperationRow"},"PutawaySkuIdentity":{"properties":{"id":{"type":"integer","title":"Id"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"}},"type":"object","required":["id","sku_code"],"title":"PutawaySkuIdentity"},"PutawaySourcePage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PutawaySourceRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["items","page","page_size","total_pages"],"title":"PutawaySourcePage"},"PutawaySourceQueryParams":{"properties":{"putaway_mode":{"type":"string","enum":["supplier_order","sale_return","available_zone"],"title":"Putaway Mode"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"ids":{"items":{"type":"integer","maximum":2147483647.0,"minimum":1.0},"type":"array","maxItems":100,"title":"Ids"}},"additionalProperties":false,"type":"object","required":["putaway_mode"],"title":"PutawaySourceQueryParams"},"PutawaySourceQueryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PutawaySourcePage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PutawaySourceQueryResponse"},"PutawaySourceRow":{"properties":{"id":{"type":"integer","title":"Id"},"status":{"type":"integer","title":"Status"},"shipping_containers":{"items":{"type":"string"},"type":"array","title":"Shipping Containers"},"shipping_container_count":{"type":"integer","title":"Shipping Container Count"}},"type":"object","required":["id","shipping_containers","shipping_container_count"],"title":"PutawaySourceRow"},"PutawayStockLookupParams":{"properties":{"putaway_mode":{"type":"string","enum":["supplier_order","sale_return","available_zone"],"title":"Putaway Mode"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Supplier Order Id"},"sale_return_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Sale Return Id"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Warehouse Id"},"stock_ids":{"items":{"type":"integer","maximum":2147483647.0,"minimum":1.0},"type":"array","maxItems":100,"minItems":1,"title":"Stock Ids"},"operation_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Operation Id"}},"additionalProperties":false,"type":"object","required":["putaway_mode","stock_ids"],"title":"PutawayStockLookupParams"},"PutawayStockLookupPayload":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PutawayStockReadRow"},"type":"array","title":"Items"},"missing_ids":{"items":{"type":"integer"},"type":"array","title":"Missing Ids"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","missing_ids","product_sku_version"],"title":"PutawayStockLookupPayload"},"PutawayStockLookupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PutawayStockLookupPayload"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PutawayStockLookupResponse"},"PutawayStockPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PutawayStockReadRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","page","page_size","total_pages","product_sku_version"],"title":"PutawayStockPage"},"PutawayStockQueryParams":{"properties":{"putaway_mode":{"type":"string","enum":["supplier_order","sale_return","available_zone"],"title":"Putaway Mode"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Supplier Order Id"},"sale_return_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Sale Return Id"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Warehouse Id"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"scan_code":{"type":"string","maxLength":200,"minLength":1,"title":"Scan Code"}},"additionalProperties":false,"type":"object","required":["putaway_mode"],"title":"PutawayStockQueryParams"},"PutawayStockQueryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/PutawayStockPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"PutawayStockQueryResponse"},"PutawayStockReadRow":{"properties":{"source_product_stock_id":{"type":"integer","title":"Source Product Stock Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"quantity":{"type":"number","title":"Quantity"},"reserved_quantity":{"type":"number","title":"Reserved Quantity"},"blocked_quantity":{"type":"number","title":"Blocked Quantity"},"movable_quantity":{"type":"number","title":"Movable Quantity"},"current_shelf_position":{"type":"string","title":"Current Shelf Position"},"current_expire_time":{"type":"string","format":"date-time","title":"Current Expire Time"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"pre_stock":{"type":"boolean","title":"Pre Stock"},"stock_tag":{"type":"integer","title":"Stock Tag"},"sku":{"$ref":"#/components/schemas/PutawaySkuIdentity"},"sku_state":{"type":"string","enum":["visible","hidden","missing"],"title":"Sku State"}},"type":"object","required":["source_product_stock_id","product_sku_id","warehouse_id","quantity","reserved_quantity","blocked_quantity","movable_quantity","pre_stock","stock_tag","sku_state"],"title":"PutawayStockReadRow"},"QueryRequest":{"properties":{"sql":{"type":"string","maxLength":20000,"minLength":1,"title":"Sql"},"params":{"type":"object","title":"Params"},"limit":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Limit","default":200}},"type":"object","required":["sql"],"title":"QueryRequest"},"RoleCreate":{"properties":{"name":{"type":"string","maxLength":50,"title":"Name"},"auth_ids":{"items":{"type":"integer"},"type":"array","title":"Auth Ids"}},"type":"object","required":["name"],"title":"RoleCreate"},"RoleUpdate":{"properties":{"role_id":{"type":"integer","title":"Role Id"},"name":{"type":"string","title":"Name"},"auth_ids":{"items":{"type":"integer"},"type":"array","title":"Auth Ids"}},"type":"object","required":["role_id"],"title":"RoleUpdate"},"SaleImportLine":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"sale_price":{"type":"number","minimum":0.0,"title":"Sale Price"},"sale_discount_price":{"type":"number","minimum":0.0,"title":"Sale Discount Price","description":"整行优惠金额，正数表示优惠","default":0},"sale_tax_total":{"type":"number","minimum":0.0,"title":"Sale Tax Total","default":0},"source_quantity":{"type":"number","minimum":0.0,"title":"Source Quantity"},"source_row_total":{"type":"number","minimum":0.0,"title":"Source Row Total"},"source_price":{"type":"number","minimum":0.0,"title":"Source Price"},"source_price_before_discount":{"type":"number","minimum":0.0,"title":"Source Price Before Discount"},"source_price_currency":{"type":"string","maxLength":20,"title":"Source Price Currency"},"warehouse_code":{"type":"string","title":"Warehouse Code"}},"type":"object","required":["product_sku_id","quantity","sale_price"],"title":"SaleImportLine","description":"批量导入：销售订单商品行"},"SaleImportOrder":{"properties":{"order_id":{"type":"integer","maximum":9007199254740991.0,"minimum":1.0,"title":"Order Id","description":"外部来源单号；系统独立生成订单 ID，响应 source_mappings 返回对应关系"},"source_canceled":{"type":"string","title":"Source Canceled","description":"来源取消标记：N 正常，Y 取消，C 冲销；Y/C 不允许进入普通库存与财务导入"},"source_document_status":{"type":"string","maxLength":20,"title":"Source Document Status"},"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"remark":{"type":"string","title":"Remark"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"product_total":{"type":"number","minimum":0.0,"title":"Product Total","description":"参考金额；商品金额由导入行计算"},"discount":{"type":"number","maximum":0.0,"title":"Discount","description":"行优惠之外的本次订单折扣，负数表示优惠","default":0},"tax_total":{"type":"number","minimum":0.0,"title":"Tax Total"},"total":{"type":"number","minimum":0.0,"title":"Total","description":"参考金额；销售应收由商品金额＋全部折扣＋税额计算"},"source_document_total":{"type":"number","minimum":0.0,"title":"Source Document Total"},"amounts_reviewed":{"type":"boolean","title":"Amounts Reviewed","default":false},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"旧字段；不会据此创建收款，实际收款须填写 payments","deprecated":true},"payments":{"items":{"$ref":"#/components/schemas/HistoricalImportPayment"},"type":"array","maxItems":100,"title":"Payments"},"price_exchange":{"type":"string","title":"Price Exchange"},"document_total_fc":{"type":"number","title":"Document Total Fc"},"price_exchange_rate":{"type":"number","title":"Price Exchange Rate"},"lines":{"items":{"$ref":"#/components/schemas/SaleImportLine"},"type":"array","minItems":1,"title":"Lines"},"shipping":{"type":"object","title":"Shipping"}},"type":"object","required":["order_id","store_id","remark","lines"],"title":"SaleImportOrder","description":"批量导入：单张销售订单（含行、送货、发票所需字段）"},"SaleInvoiceCreate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price","description":"Signed CAD amount, at most 2 decimal places","default":0},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","required":["sale_order_id"],"title":"SaleInvoiceCreate"},"SaleInvoiceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"store_id":{"type":"integer","title":"Store Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"SaleInvoiceListParams"},"SaleInvoiceUpdate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price"},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","title":"SaleInvoiceUpdate"},"SaleOrderApprovalEdit":{"properties":{"revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Revision"},"items":{"items":{"$ref":"#/components/schemas/SaleOrderApproveItem"},"type":"array","maxItems":1000,"title":"Items"},"delete_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Delete Sn Ids"}},"type":"object","required":["revision"],"title":"SaleOrderApprovalEdit","description":"以已查看的商品版本保存审批改动，不改变审批状态。"},"SaleOrderApprove":{"properties":{"revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Revision"},"items":{"items":{"$ref":"#/components/schemas/SaleOrderApproveItem"},"type":"array","maxItems":1000,"title":"Items"},"delete_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Delete Sn Ids"},"status":{"type":"integer","title":"Status","description":"2=审批通过 0=驳回（打回申请）"},"remark":{"type":"string","title":"Remark"},"approver_remark":{"type":"string","title":"Approver Remark"}},"type":"object","required":["revision","status"],"title":"SaleOrderApprove","description":"审批接口入参：仅 status==1（待审批）且拥有 sale_order_status 权限可使用。\n老板在审批页面可直接改商品价格/优惠/数量、删除商品，然后审批通过/驳回。"},"SaleOrderApproveItem":{"properties":{"product_sku_sn_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Sn Id"},"sn_sale_price":{"type":"number","minimum":0.0,"title":"Sn Sale Price"},"sn_sale_discount_price":{"type":"number","minimum":0.0,"title":"Sn Sale Discount Price"},"sn_sale_qty":{"type":"number","exclusiveMinimum":0.0,"title":"Sn Sale Qty"}},"type":"object","required":["product_sku_sn_id"],"title":"SaleOrderApproveItem","description":"审批时老板对某商品的修改：价格/优惠/数量。仅作用于已绑定到该订单的商品快照。"},"SaleOrderCreate":{"properties":{"id":{"type":"integer","minimum":1.0,"title":"Id","description":"指定主键（历史导入时与 SAP Internal Number 一致）"},"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"creation_key":{"type":"string","format":"uuid4","title":"Creation Key","description":"同一次创建使用固定 UUID v4；结果不明先按此标识查询，勿生成新标识重试"},"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Product Sku Sn Ids"},"product_sku_sn_real_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Real Ids"},"status":{"type":"integer","maximum":6.0,"minimum":0.0,"title":"Status","default":0},"is_batch_delivery":{"type":"boolean","title":"Is Batch Delivery","default":false},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"delivery_contact_name":{"type":"string","maxLength":100,"title":"Delivery Contact Name"},"delivery_contact_phone":{"type":"string","maxLength":50,"title":"Delivery Contact Phone"},"remark":{"type":"string","title":"Remark"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"allow_negative_stock":{"type":"boolean","title":"Allow Negative Stock","default":false},"skip_stock_check":{"type":"boolean","title":"Skip Stock Check","default":false}},"type":"object","title":"SaleOrderCreate","description":"管理员创建时需传 store_id；非管理员以当前用户绑定的 store_id 为准，可不传或忽略 body 中的 store_id"},"SaleOrderImportBatchParams":{"properties":{"orders":{"items":{"$ref":"#/components/schemas/SaleImportOrder"},"type":"array","maxItems":50,"minItems":1,"title":"Orders"}},"type":"object","required":["orders"],"title":"SaleOrderImportBatchParams","description":"批量导入销售订单：一次一整批，单事务，整批成功或整批回滚"},"SaleOrderListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"id":{"type":"integer","title":"Id"},"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"product_sku_code":{"type":"string","title":"Product Sku Code"},"status":{"items":{"type":"integer"},"type":"array","title":"Status"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"is_batch_delivery":{"type":"boolean","title":"Is Batch Delivery"},"return_all_matching":{"type":"boolean","title":"Return All Matching","description":"为 True 时忽略分页，返回当前筛选条件下的全部订单（出入库等场景用）","default":false},"brief":{"type":"boolean","title":"Brief","default":false}},"type":"object","title":"SaleOrderListParams"},"SaleOrderProductsSave":{"properties":{"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Revision"},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSaleItem"},"type":"array","maxItems":1000,"title":"Items"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"submit_for_approval":{"type":"boolean","title":"Submit For Approval","default":false}},"type":"object","required":["revision","items"],"title":"SaleOrderProductsSave","description":"原子保存商品、金额和库存占用；revision 从完整订单详情取得。"},"SaleOrderUpdate":{"properties":{"revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Revision"},"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Product Sku Sn Ids"},"product_sku_sn_real_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Real Ids"},"status":{"type":"integer","maximum":6.0,"minimum":0.0,"title":"Status"},"contract_file":{"type":"string","title":"Contract File"},"is_batch_delivery":{"type":"boolean","title":"Is Batch Delivery"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"delivery_contact_name":{"type":"string","maxLength":100,"title":"Delivery Contact Name"},"delivery_contact_phone":{"type":"string","maxLength":50,"title":"Delivery Contact Phone"},"remark":{"type":"string","title":"Remark"},"approver_remark":{"type":"string","title":"Approver Remark"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"}},"type":"object","title":"SaleOrderUpdate"},"SaleReturnConfirmPriceItem":{"properties":{"product_sku_sn_id":{"type":"integer","title":"Product Sku Sn Id"},"sn_sale_return_price":{"type":"number","title":"Sn Sale Return Price"},"sn_sale_return_count":{"type":"number","title":"Sn Sale Return Count"},"sn_sale_return_remark":{"type":"string","title":"Sn Sale Return Remark"}},"type":"object","required":["product_sku_sn_id"],"title":"SaleReturnConfirmPriceItem"},"SaleReturnConfirmPriceRequest":{"properties":{"sale_return_id":{"type":"integer","title":"Sale Return Id"},"items":{"items":{"$ref":"#/components/schemas/SaleReturnConfirmPriceItem"},"type":"array","title":"Items"}},"type":"object","required":["sale_return_id"],"title":"SaleReturnConfirmPriceRequest"},"SaleReturnCreate":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"remark":{"type":"string","title":"Remark"},"creation_key":{"type":"string","format":"uuid4","title":"Creation Key","description":"同一次创建使用固定 UUID v4；结果不明先按此标识查询，勿生成新标识重试"}},"type":"object","required":["store_id"],"title":"SaleReturnCreate","description":"创建退货单：仅需选择商家。后续通过快照构建 / 入库写入商品。"},"SaleReturnInvoiceCreate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price","description":"Signed CAD amount, at most 2 decimal places","default":0},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","required":["sale_return_id"],"title":"SaleReturnInvoiceCreate"},"SaleReturnInvoiceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"store_id":{"type":"integer","title":"Store Id"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"SaleReturnInvoiceListParams"},"SaleReturnInvoiceSumParams":{"properties":{"sale_return_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Sale Return Ids"}},"type":"object","title":"SaleReturnInvoiceSumParams"},"SaleReturnInvoiceUpdate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price"},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","title":"SaleReturnInvoiceUpdate"},"SaleReturnListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"store_id":{"type":"integer","title":"Store Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"status":{"type":"integer","title":"Status"},"statuses":{"items":{"type":"integer"},"type":"array","title":"Statuses"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"SaleReturnListParams"},"SaleReturnMatchOrdersParams":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"}},"type":"object","required":["store_id","product_sku_id"],"title":"SaleReturnMatchOrdersParams"},"SaleReturnUpdate":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"status":{"type":"integer","title":"Status"},"remark":{"type":"string","title":"Remark"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"store_id":{"type":"integer","title":"Store Id"}},"type":"object","title":"SaleReturnUpdate"},"SaleSelectionDiscount":{"properties":{"id":{"type":"integer","title":"Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level"},"discount":{"type":"number","title":"Discount"},"custom":{"type":"number","title":"Custom"},"remark":{"type":"string","title":"Remark"}},"additionalProperties":false,"type":"object","required":["id"],"title":"SaleSelectionDiscount"},"SaleSelectionDiscountPage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"default_id":{"type":"integer","title":"Default Id"},"kind":{"type":"string","enum":["discount"],"title":"Kind","default":"discount"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionDiscount"},"type":"array","title":"Items"}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","page","page_size","total_pages","items"],"title":"SaleSelectionDiscountPage"},"SaleSelectionPrice":{"properties":{"id":{"type":"integer","title":"Id"},"store_id":{"type":"integer","title":"Store Id"},"level":{"type":"integer","title":"Level"},"price":{"type":"number","title":"Price"}},"additionalProperties":false,"type":"object","required":["id","price"],"title":"SaleSelectionPrice"},"SaleSelectionPricePage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"default_id":{"type":"integer","title":"Default Id"},"kind":{"type":"string","enum":["price"],"title":"Kind","default":"price"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionPrice"},"type":"array","title":"Items"}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","page","page_size","total_pages","items"],"title":"SaleSelectionPricePage"},"SaleSelectionQuoteParams":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Product Sku Id"},"kind":{"type":"string","enum":["price","discount"],"title":"Kind"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"page":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id","kind"],"title":"SaleSelectionQuoteParams"},"SaleSelectionQuoteResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"$ref":"#/components/schemas/SaleSelectionPricePage"},{"$ref":"#/components/schemas/SaleSelectionDiscountPage"}],"title":"Data"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"SaleSelectionQuoteResponse"},"SaleSelectionStockCandidatesPage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionStockRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"}},"additionalProperties":false,"type":"object","required":["store_id","items","page","page_size","total_pages"],"title":"SaleSelectionStockCandidatesPage"},"SaleSelectionStockCandidatesParams":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Product Sku Id"},"page":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20}},"additionalProperties":false,"type":"object","required":["store_id","product_sku_id"],"title":"SaleSelectionStockCandidatesParams"},"SaleSelectionStockCandidatesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SaleSelectionStockCandidatesPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"SaleSelectionStockCandidatesResponse"},"SaleSelectionStockLookupPage":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"items":{"items":{"$ref":"#/components/schemas/SaleSelectionStockRow"},"type":"array","title":"Items"},"missing_ids":{"items":{"type":"integer"},"type":"array","title":"Missing Ids"}},"additionalProperties":false,"type":"object","required":["store_id","items","missing_ids"],"title":"SaleSelectionStockLookupPage"},"SaleSelectionStockLookupParams":{"properties":{"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_sku_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Product Sku Id"},"stock_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Stock Ids"}},"additionalProperties":false,"type":"object","required":["store_id","stock_ids"],"title":"SaleSelectionStockLookupParams"},"SaleSelectionStockLookupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/SaleSelectionStockLookupPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"SaleSelectionStockLookupResponse"},"SaleSelectionStockRow":{"properties":{"id":{"type":"integer","title":"Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"shelf_position":{"type":"string","title":"Shelf Position"},"stock":{"type":"number","title":"Stock"},"block_stock":{"type":"number","title":"Block Stock"},"reserved_quantity":{"type":"number","title":"Reserved Quantity"},"own_reserved_quantity":{"type":"number","title":"Own Reserved Quantity"},"available_stock":{"type":"number","title":"Available Stock"},"editable_capacity":{"type":"number","title":"Editable Capacity"},"sku_state":{"type":"string","enum":["visible","hidden","missing"],"title":"Sku State"},"candidate_eligible":{"type":"boolean","title":"Candidate Eligible"}},"additionalProperties":false,"type":"object","required":["id","product_sku_id","warehouse_id","sku_state","candidate_eligible"],"title":"SaleSelectionStockRow"},"SaleShippingInfoCreate":{"properties":{"sale_order_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Sale Order Id"},"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Product Sku Sn Ids"},"delivery_time":{"type":"string","format":"date-time","title":"Delivery Time"},"delivery_no":{"type":"string","maxLength":100,"title":"Delivery No"},"delivery_address":{"type":"string","maxLength":500,"title":"Delivery Address"},"delivery_remark":{"type":"string","title":"Delivery Remark"},"delivery_contact_name":{"type":"string","maxLength":100,"title":"Delivery Contact Name"},"delivery_contact_phone":{"type":"string","maxLength":50,"title":"Delivery Contact Phone"},"delivery_company":{"type":"string","maxLength":100,"title":"Delivery Company"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"}},"type":"object","required":["sale_order_id"],"title":"SaleShippingInfoCreate"},"SaleShippingInfoListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"sale_order_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Sale Order Id"}},"type":"object","title":"SaleShippingInfoListParams"},"SaleShippingInfoUpdate":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Product Sku Sn Ids"},"delivery_time":{"type":"string","format":"date-time","title":"Delivery Time"},"delivery_no":{"type":"string","maxLength":100,"title":"Delivery No"},"delivery_address":{"type":"string","maxLength":500,"title":"Delivery Address"},"delivery_remark":{"type":"string","title":"Delivery Remark"},"delivery_contact_name":{"type":"string","maxLength":100,"title":"Delivery Contact Name"},"delivery_contact_phone":{"type":"string","maxLength":50,"title":"Delivery Contact Phone"},"delivery_company":{"type":"string","maxLength":100,"title":"Delivery Company"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"}},"type":"object","title":"SaleShippingInfoUpdate"},"SaleTaxRateConfirmationItem":{"properties":{"product_sku_sn_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Sku Sn Id"},"tax_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Tax Rate"}},"additionalProperties":false,"type":"object","required":["product_sku_sn_id","tax_rate"],"title":"SaleTaxRateConfirmationItem"},"SaleTaxRatesConfirm":{"properties":{"revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Revision"},"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason"},"items":{"items":{"$ref":"#/components/schemas/SaleTaxRateConfirmationItem"},"type":"array","maxItems":1000,"minItems":1,"title":"Items"}},"additionalProperties":false,"type":"object","required":["revision","reason","items"],"title":"SaleTaxRatesConfirm"},"ShareCodeTempFileUrlParams":{"properties":{"share_code":{"type":"string","title":"Share Code"},"object_path":{"type":"string","title":"Object Path"}},"type":"object","required":["share_code","object_path"],"title":"ShareCodeTempFileUrlParams"},"SkuMetadataIdentity":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"number","title":"Unit Count"},"sku_state":{"type":"string","enum":["visible","hidden"],"title":"Sku State"}},"additionalProperties":false,"type":"object","required":["id","code","sku_code","spec_name","sku_state"],"title":"SkuMetadataIdentity"},"SkuMetadataIdentityTax":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"number","title":"Unit Count"},"sku_state":{"type":"string","enum":["visible","hidden"],"title":"Sku State"},"has_tax":{"type":"integer","title":"Has Tax"}},"additionalProperties":false,"type":"object","required":["id","code","sku_code","spec_name","sku_state"],"title":"SkuMetadataIdentityTax"},"SkuMetadataLogistics":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"number","title":"Unit Count"},"sku_state":{"type":"string","enum":["visible","hidden"],"title":"Sku State"},"size_value":{"type":"number","title":"Size Value"},"size_length":{"type":"number","title":"Size Length"},"size_width":{"type":"number","title":"Size Width"},"size_height":{"type":"number","title":"Size Height"}},"additionalProperties":false,"type":"object","required":["id","code","sku_code","spec_name","sku_state"],"title":"SkuMetadataLogistics"},"SkuMetadataPage":{"properties":{"purpose":{"type":"string","enum":["purchase","stock_record","container","settlement","warehouse_io","sale_return","warehouse_transfer","sales"],"title":"Purpose"},"profile":{"type":"string","enum":["identity","scan","logistics","identity_tax"],"title":"Profile"},"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/SkuMetadataIdentity"},{"$ref":"#/components/schemas/SkuMetadataScan"},{"$ref":"#/components/schemas/SkuMetadataLogistics"},{"$ref":"#/components/schemas/SkuMetadataIdentityTax"}]},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"},"resolved_ids":{"items":{"type":"integer"},"type":"array","title":"Resolved Ids"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"}},"type":"object","required":["purpose","profile","items","page","page_size","total_pages","product_sku_version","resolved_ids","unavailable_ids"],"title":"SkuMetadataPage"},"SkuMetadataQueryParams":{"properties":{"purpose":{"type":"string","enum":["purchase","stock_record","container","settlement","warehouse_io","sale_return","warehouse_transfer","sales","partner_mapping","order_import","stock_import"],"title":"Purpose"},"profile":{"type":"string","enum":["identity","scan","logistics","identity_tax"],"title":"Profile","default":"identity"},"page":{"type":"integer","maximum":2147483647.0,"minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"keyword":{"type":"string","maxLength":200,"title":"Keyword"},"scan_code":{"type":"string","maxLength":200,"minLength":1,"title":"Scan Code"},"ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Ids"},"parent_order_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Parent Order Ids"},"supplier_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Supplier Id"},"store_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Store Id"},"mode":{"type":"string","enum":["sale","warehouse","finance"],"title":"Mode"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"direction":{"type":"string","enum":["in","out"],"title":"Direction"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Supplier Order Id"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"warehouse_transfer_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Transfer Id"},"mapping_kind":{"type":"string","enum":["supplier","store"],"title":"Mapping Kind"},"partner_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Partner Id"},"mapping_revision":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Mapping Revision"},"import_kind":{"type":"string","enum":["po","so"],"title":"Import Kind"}},"additionalProperties":false,"type":"object","required":["purpose"],"title":"SkuMetadataQueryParams"},"SkuMetadataResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"$ref":"#/components/schemas/PartnerMappingMetadataPage"},{"$ref":"#/components/schemas/OrderImportMetadataPage"},{"$ref":"#/components/schemas/StockImportMetadataPage"},{"$ref":"#/components/schemas/SkuMetadataPage"}],"title":"Data"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"SkuMetadataResponse"},"SkuMetadataScan":{"properties":{"id":{"type":"integer","title":"Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"},"spec_name":{"type":"string","title":"Spec Name"},"spec_name_tw":{"type":"string","title":"Spec Name Tw"},"spec_name_en":{"type":"string","title":"Spec Name En"},"unit":{"type":"string","title":"Unit"},"uom":{"type":"string","title":"Uom"},"unit_count":{"type":"number","title":"Unit Count"},"sku_state":{"type":"string","enum":["visible","hidden"],"title":"Sku State"},"barcodes":{"items":{"type":"string"},"type":"array","title":"Barcodes"},"upc":{"type":"string","title":"Upc"}},"additionalProperties":false,"type":"object","required":["id","code","sku_code","spec_name","sku_state","barcodes"],"title":"SkuMetadataScan"},"StandardResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"title":"Data"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success"],"title":"StandardResponse"},"StockImportContext":{"properties":{},"additionalProperties":false,"type":"object","title":"StockImportContext"},"StockImportMetadataPage":{"properties":{"purpose":{"type":"string","enum":["stock_import"],"title":"Purpose"},"profile":{"type":"string","enum":["identity","scan","logistics","identity_tax"],"title":"Profile"},"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/SkuMetadataIdentity"},{"$ref":"#/components/schemas/SkuMetadataScan"},{"$ref":"#/components/schemas/SkuMetadataLogistics"},{"$ref":"#/components/schemas/SkuMetadataIdentityTax"}]},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"},"resolved_ids":{"items":{"type":"integer"},"type":"array","title":"Resolved Ids"},"unavailable_ids":{"items":{"type":"integer"},"type":"array","title":"Unavailable Ids"},"context":{"$ref":"#/components/schemas/StockImportContext"}},"type":"object","required":["purpose","profile","items","page","page_size","total_pages","product_sku_version","resolved_ids","unavailable_ids","context"],"title":"StockImportMetadataPage"},"StockOperationCandidatesPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/StockOperationReadRow"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total_pages":{"type":"integer","title":"Total Pages"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","page","page_size","total_pages","product_sku_version"],"title":"StockOperationCandidatesPage"},"StockOperationCandidatesParams":{"properties":{"purpose":{"type":"string","enum":["warehouse_io","warehouse_transfer"],"title":"Purpose"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"direction":{"type":"string","enum":["in","out"],"title":"Direction"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Supplier Order Id"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"warehouse_transfer_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Transfer Id"},"product_sku_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Product Sku Ids"},"page":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20}},"additionalProperties":false,"type":"object","required":["purpose","warehouse_id","product_sku_ids"],"title":"StockOperationCandidatesParams"},"StockOperationCandidatesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/StockOperationCandidatesPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"StockOperationCandidatesResponse"},"StockOperationLookupPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/StockOperationReadRow"},"type":"array","title":"Items"},"missing_ids":{"items":{"type":"integer"},"type":"array","title":"Missing Ids"},"product_sku_version":{"type":"integer","title":"Product Sku Version"}},"type":"object","required":["items","missing_ids","product_sku_version"],"title":"StockOperationLookupPage"},"StockOperationLookupParams":{"properties":{"purpose":{"type":"string","enum":["warehouse_io","warehouse_transfer"],"title":"Purpose"},"warehouse_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Id"},"direction":{"type":"string","enum":["in","out"],"title":"Direction"},"supplier_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Supplier Order Id"},"sale_order_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Sale Order Id"},"warehouse_transfer_id":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0,"title":"Warehouse Transfer Id"},"stock_ids":{"items":{"type":"integer","maximum":2147483647.0,"exclusiveMinimum":0.0},"type":"array","maxItems":100,"minItems":1,"title":"Stock Ids"}},"additionalProperties":false,"type":"object","required":["purpose","warehouse_id","stock_ids"],"title":"StockOperationLookupParams"},"StockOperationLookupResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/StockOperationLookupPage"},"message":{"type":"string","title":"Message"},"token":{"$ref":"#/components/schemas/Token"},"status_code":{"type":"integer","title":"Status Code","default":200},"toast":{"type":"string","title":"Toast"},"total_records":{"type":"integer","title":"Total Records","default":0}},"type":"object","required":["success","data"],"title":"StockOperationLookupResponse"},"StockOperationReadRow":{"properties":{"id":{"type":"integer","title":"Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"shelf_position":{"type":"string","title":"Shelf Position"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"stock":{"type":"number","title":"Stock"},"block_stock":{"type":"number","title":"Block Stock"},"reserved_quantity":{"type":"number","title":"Reserved Quantity"},"available_stock":{"type":"number","title":"Available Stock"},"own_reserved_quantity":{"type":"number","title":"Own Reserved Quantity"},"io_capacity":{"type":"number","title":"Io Capacity"},"pre_stock":{"type":"boolean","title":"Pre Stock"},"stock_tag":{"type":"integer","title":"Stock Tag"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"sku_state":{"type":"string","enum":["visible","hidden","missing"],"title":"Sku State"}},"type":"object","required":["id","product_sku_id","warehouse_id","stock_tag","sku_state"],"title":"StockOperationReadRow"},"StoreAddressBatchParams":{"properties":{"store_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":1000,"title":"Store Ids"}},"type":"object","title":"StoreAddressBatchParams","description":"批量获取商户地址：一次请求取回指定商户的全部地址"},"StoreAddressCreate":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"province_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Province Id"},"name":{"type":"string","maxLength":200,"title":"Name"},"detail":{"type":"string","maxLength":500,"title":"Detail"},"contact_name":{"type":"string","maxLength":100,"title":"Contact Name"},"contact_phone":{"type":"string","maxLength":50,"title":"Contact Phone"},"country":{"type":"string","maxLength":100,"title":"Country"},"zip_code":{"type":"string","maxLength":100,"title":"Zip Code"},"remark":{"type":"string","title":"Remark"},"status":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Status","default":0}},"type":"object","required":["store_id","name","detail"],"title":"StoreAddressCreate"},"StoreAddressListParams":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"}},"type":"object","required":["store_id"],"title":"StoreAddressListParams"},"StoreAddressUpdate":{"properties":{"province_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Province Id"},"name":{"type":"string","maxLength":200,"title":"Name"},"detail":{"type":"string","maxLength":500,"title":"Detail"},"contact_name":{"type":"string","maxLength":100,"title":"Contact Name"},"contact_phone":{"type":"string","maxLength":50,"title":"Contact Phone"},"country":{"type":"string","maxLength":100,"title":"Country"},"zip_code":{"type":"string","maxLength":100,"title":"Zip Code"},"remark":{"type":"string","title":"Remark"},"status":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Status"}},"type":"object","title":"StoreAddressUpdate"},"StoreBrowseProductListParams":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Page Size","default":50},"keyword":{"type":"string","title":"Keyword"},"brand_id":{"type":"integer","title":"Brand Id"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"}},"type":"object","title":"StoreBrowseProductListParams","description":"商家选购商品列表（按商品维度）；价格见详情/SKU 接口（依赖绑定商户）"},"StoreBrowseSkuListParams":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Page Size","default":50},"keyword":{"type":"string","title":"Keyword"},"brand_id":{"type":"integer","title":"Brand Id"},"category_ids":{"items":{"type":"integer"},"type":"array","title":"Category Ids"}},"type":"object","title":"StoreBrowseSkuListParams"},"StoreCartAddItem":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","minimum":0.01,"title":"Quantity","default":1},"sn_sale_price":{"type":"number","title":"Sn Sale Price"},"sn_sale_discount_price":{"type":"number","title":"Sn Sale Discount Price"},"sn_sale_remark":{"type":"string","title":"Sn Sale Remark"}},"type":"object","required":["product_sku_id"],"title":"StoreCartAddItem"},"StoreCartBatchAdd":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"items":{"items":{"$ref":"#/components/schemas/StoreCartBatchAddItem"},"type":"array","minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"StoreCartBatchAdd"},"StoreCartBatchAddItem":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","minimum":0.01,"title":"Quantity","default":1},"sn_sale_price":{"type":"number","title":"Sn Sale Price"},"sn_sale_discount_price":{"type":"number","title":"Sn Sale Discount Price"},"sn_sale_remark":{"type":"string","title":"Sn Sale Remark"}},"type":"object","required":["product_sku_id"],"title":"StoreCartBatchAddItem"},"StoreCartCheckoutParams":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"delivery_address_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Delivery Address Id"},"delivery_contact_name":{"type":"string","maxLength":100,"title":"Delivery Contact Name"},"delivery_contact_phone":{"type":"string","maxLength":50,"title":"Delivery Contact Phone"},"remark":{"type":"string","title":"Remark"}},"type":"object","title":"StoreCartCheckoutParams","description":"购物车结算为正式销售单，管理员可指定商户，普通用户按绑定商户"},"StoreCartListParams":{"properties":{"store_id":{"type":"integer","title":"Store Id"}},"type":"object","title":"StoreCartListParams","description":"购物车列表/清空/数量：管理员可指定商户，普通用户按绑定商户"},"StoreCartUpdateItem":{"properties":{"store_id":{"type":"integer","title":"Store Id"},"quantity":{"type":"number","minimum":0.01,"title":"Quantity"},"sn_sale_price":{"type":"number","title":"Sn Sale Price"},"sn_sale_discount_price":{"type":"number","title":"Sn Sale Discount Price"},"sn_sale_remark":{"type":"string","title":"Sn Sale Remark"}},"type":"object","required":["quantity"],"title":"StoreCartUpdateItem"},"StoreCategoryCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"order_num":{"type":"integer","title":"Order Num","description":"排序，越大越靠前","default":0},"hide":{"type":"integer","title":"Hide","description":"0显示 1隐藏","default":0}},"type":"object","required":["name"],"title":"StoreCategoryCreate"},"StoreCategoryListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"StoreCategoryListParams"},"StoreCategorySetStores":{"properties":{"store_ids":{"items":{"type":"integer"},"type":"array","title":"Store Ids","description":"关联的商户 id 列表（全量覆盖）"},"expected_store_ids":{"items":{"type":"integer"},"type":"array","title":"Expected Store Ids","description":"可选的当前关联快照；与服务端不一致时返回 409，避免覆盖其他成员或 Agent 的修改"}},"type":"object","title":"StoreCategorySetStores"},"StoreCategoryUpdate":{"properties":{"name":{"type":"string","title":"Name"},"order_num":{"type":"integer","title":"Order Num"},"hide":{"type":"integer","title":"Hide"}},"type":"object","title":"StoreCategoryUpdate"},"StoreCreate":{"properties":{"bp_code":{"type":"string","maxLength":100,"title":"Bp Code"},"name":{"type":"string","maxLength":200,"title":"Name"},"contact_name":{"type":"string","title":"Contact Name"},"contact_phone":{"type":"string","title":"Contact Phone"},"contact_email":{"type":"string","title":"Contact Email"},"contact_address":{"type":"string","title":"Contact Address"},"billing_name":{"type":"string","title":"Billing Name"},"billing_phone":{"type":"string","title":"Billing Phone"},"billing_email":{"type":"string","title":"Billing Email"},"billing_address":{"type":"string","title":"Billing Address"},"billing_city":{"type":"string","title":"Billing City"},"billing_country":{"type":"string","title":"Billing Country"},"billing_state":{"type":"string","title":"Billing State"},"billing_zip":{"type":"string","title":"Billing Zip"},"level":{"type":"integer","title":"Level","default":0},"credit_limit":{"type":"number","title":"Credit Limit","default":0},"payment_days":{"type":"integer","title":"Payment Days","default":0},"po":{"type":"string","title":"Po"},"status":{"type":"integer","title":"Status","default":0},"remark":{"type":"string","title":"Remark"}},"type":"object","required":["bp_code","name"],"title":"StoreCreate"},"StoreFinanceSummariesParams":{"properties":{"store_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","maxItems":100,"title":"Store Ids"}},"type":"object","title":"StoreFinanceSummariesParams"},"StoreListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"bp_code":{"type":"string","title":"Bp Code"},"name":{"type":"string","title":"Name"},"level":{"type":"integer","title":"Level"},"status":{"type":"integer","title":"Status"}},"type":"object","title":"StoreListParams"},"StoreSkuCodeMapBatchDeleteParams":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"codes":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":1000,"minItems":1,"title":"Codes"}},"type":"object","required":["store_id","codes"],"title":"StoreSkuCodeMapBatchDeleteParams"},"StoreSkuCodeMapBatchSaveParams":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"items":{"items":{"$ref":"#/components/schemas/StoreSkuCodeMapItem"},"type":"array","maxItems":1000,"minItems":1,"title":"Items"}},"type":"object","required":["store_id","items"],"title":"StoreSkuCodeMapBatchSaveParams"},"StoreSkuCodeMapItem":{"properties":{"code":{"type":"string","maxLength":100,"minLength":1,"title":"Code"},"sku_code":{"type":"string","maxLength":50,"minLength":1,"title":"Sku Code"}},"type":"object","required":["code","sku_code"],"title":"StoreSkuCodeMapItem"},"StoreSkuCodeMapListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"}},"type":"object","required":["store_id"],"title":"StoreSkuCodeMapListParams"},"StoreSkuCodeMapReplaceParams":{"properties":{"store_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Store Id"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Revision"},"items":{"items":{"$ref":"#/components/schemas/StoreSkuCodeMapItem"},"type":"array","maxItems":10000,"title":"Items"}},"type":"object","required":["store_id","revision","items"],"title":"StoreSkuCodeMapReplaceParams"},"StoreUpdate":{"properties":{"name":{"type":"string","title":"Name"},"contact_name":{"type":"string","title":"Contact Name"},"contact_phone":{"type":"string","title":"Contact Phone"},"contact_email":{"type":"string","title":"Contact Email"},"contact_address":{"type":"string","title":"Contact Address"},"billing_name":{"type":"string","title":"Billing Name"},"billing_phone":{"type":"string","title":"Billing Phone"},"billing_email":{"type":"string","title":"Billing Email"},"billing_address":{"type":"string","title":"Billing Address"},"billing_city":{"type":"string","title":"Billing City"},"billing_country":{"type":"string","title":"Billing Country"},"billing_state":{"type":"string","title":"Billing State"},"billing_zip":{"type":"string","title":"Billing Zip"},"level":{"type":"integer","title":"Level"},"credit_limit":{"type":"number","title":"Credit Limit"},"payment_days":{"type":"integer","title":"Payment Days"},"po":{"type":"string","title":"Po"},"status":{"type":"integer","title":"Status"},"remark":{"type":"string","title":"Remark"}},"type":"object","title":"StoreUpdate"},"SupplierCargoAssignment":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","title":"Product Sku Sn Ids"},"expected_plan_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","title":"Expected Plan Ids"},"expected_assignments":{"items":{"$ref":"#/components/schemas/SupplierCargoAssignmentSnapshot"},"type":"array","title":"Expected Assignments"}},"additionalProperties":false,"type":"object","required":["product_sku_sn_ids","expected_plan_ids","expected_assignments"],"title":"SupplierCargoAssignment"},"SupplierCargoAssignmentSnapshot":{"properties":{"id":{"type":"integer","exclusiveMinimum":0.0,"title":"Id"},"product_sku_sn_ids":{"items":{"type":"integer","exclusiveMinimum":0.0},"type":"array","title":"Product Sku Sn Ids"}},"additionalProperties":false,"type":"object","required":["id","product_sku_sn_ids"],"title":"SupplierCargoAssignmentSnapshot"},"SupplierCategoryCreate":{"properties":{"name":{"type":"string","maxLength":100,"title":"Name"},"order_num":{"type":"integer","title":"Order Num","description":"排序，越大越靠前","default":0},"hide":{"type":"integer","title":"Hide","description":"0显示 1隐藏","default":0}},"type":"object","required":["name"],"title":"SupplierCategoryCreate"},"SupplierCategoryListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"SupplierCategoryListParams"},"SupplierCategorySetSuppliers":{"properties":{"supplier_ids":{"items":{"type":"integer"},"type":"array","title":"Supplier Ids","description":"关联的供应商 id 列表（全量覆盖）"},"expected_supplier_ids":{"items":{"type":"integer"},"type":"array","title":"Expected Supplier Ids","description":"可选的当前关联快照；与服务端不一致时返回 409，避免覆盖其他成员或 Agent 的修改"}},"type":"object","title":"SupplierCategorySetSuppliers"},"SupplierCategoryUpdate":{"properties":{"name":{"type":"string","title":"Name"},"order_num":{"type":"integer","title":"Order Num"},"hide":{"type":"integer","title":"Hide"}},"type":"object","title":"SupplierCategoryUpdate"},"SupplierCreate":{"properties":{"name":{"type":"string","maxLength":200,"title":"Name"},"bp_code":{"type":"string","maxLength":100,"title":"Bp Code"},"country":{"type":"string","title":"Country"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone"},"payment_days":{"type":"integer","title":"Payment Days","default":0},"remark":{"type":"string","title":"Remark"}},"type":"object","required":["name"],"title":"SupplierCreate"},"SupplierImportLine":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"supplier_price":{"type":"number","minimum":0.0,"title":"Supplier Price"},"source_quantity":{"type":"number","minimum":0.0,"title":"Source Quantity"},"source_row_total":{"type":"number","minimum":0.0,"title":"Source Row Total"},"source_price":{"type":"number","minimum":0.0,"title":"Source Price"},"source_price_before_discount":{"type":"number","minimum":0.0,"title":"Source Price Before Discount"},"source_price_currency":{"type":"string","maxLength":20,"title":"Source Price Currency"},"supplier_price_exchange":{"type":"string","title":"Supplier Price Exchange"},"supplier_price_exchange_price":{"type":"number","minimum":0.0,"title":"Supplier Price Exchange Price"},"supplier_price_exchange_rate":{"type":"number","exclusiveMinimum":0.0,"title":"Supplier Price Exchange Rate"},"supplier_tax_total":{"type":"number","minimum":0.0,"title":"Supplier Tax Total","default":0},"warehouse_code":{"type":"string","title":"Warehouse Code"}},"type":"object","required":["product_sku_id","quantity","supplier_price"],"title":"SupplierImportLine","description":"批量导入：供应链订单商品行"},"SupplierImportOrder":{"properties":{"order_id":{"type":"integer","maximum":9007199254740991.0,"minimum":1.0,"title":"Order Id","description":"外部来源单号；系统独立生成订单 ID，响应 source_mappings 返回对应关系"},"source_canceled":{"type":"string","title":"Source Canceled","description":"来源取消标记：N 正常，Y 取消，C 冲销；Y/C 不允许进入普通库存与财务导入"},"source_document_status":{"type":"string","maxLength":20,"title":"Source Document Status"},"supplier_id":{"type":"integer","title":"Supplier Id"},"remark":{"type":"string","title":"Remark"},"order_time":{"type":"string","format":"date-time","title":"Order Time"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"product_total":{"type":"number","minimum":0.0,"title":"Product Total","description":"参考金额；商品金额由导入行计算"},"discount":{"type":"number","maximum":0.0,"title":"Discount","description":"本次导入的订单折扣，负数表示优惠","default":0},"tax_total":{"type":"number","minimum":0.0,"title":"Tax Total"},"total":{"type":"number","minimum":0.0,"title":"Total","description":"参考金额；采购应付由商品金额＋订单折扣计算，不含税和运费"},"source_document_total":{"type":"number","minimum":0.0,"title":"Source Document Total"},"amounts_reviewed":{"type":"boolean","title":"Amounts Reviewed","default":false},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"旧字段；不会据此创建付款，实际付款须填写 payments","deprecated":true},"payments":{"items":{"$ref":"#/components/schemas/HistoricalImportPayment"},"type":"array","maxItems":100,"title":"Payments"},"price_exchange":{"type":"string","title":"Price Exchange"},"document_total_fc":{"type":"number","title":"Document Total Fc"},"price_exchange_rate":{"type":"number","title":"Price Exchange Rate"},"lines":{"items":{"$ref":"#/components/schemas/SupplierImportLine"},"type":"array","minItems":1,"title":"Lines"},"shipping":{"type":"object","title":"Shipping"}},"type":"object","required":["order_id","supplier_id","remark","lines"],"title":"SupplierImportOrder","description":"批量导入：单张供应链订单（含行、货运、发票所需字段）"},"SupplierInvoiceCreate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price","description":"Signed CAD amount, at most 2 decimal places","default":0},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","required":["supplier_order_id"],"title":"SupplierInvoiceCreate"},"SupplierInvoiceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"supplier_id":{"type":"integer","title":"Supplier Id"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"SupplierInvoiceListParams"},"SupplierInvoiceUpdate":{"properties":{"price_exchange":{"type":"string","maxLength":20,"title":"Price Exchange"},"price_exchange_price":{"type":"number","exclusiveMaximum":10000000000.0,"exclusiveMinimum":-10000000000.0,"title":"Price Exchange Price","description":"Recorded foreign amount, at most 4 decimal places; never recalculates CAD automatically"},"price_exchange_rate":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":0.0,"title":"Price Exchange Rate","description":"Positive foreign units per CAD, at most 6 decimal places; null clears this metadata"},"pay_time":{"type":"string","format":"date-time","title":"Pay Time","description":"Timezone offsets are converted to America/Toronto; dates and naive times already use Toronto business time. Stored to whole seconds; subsecond precision is truncated"},"price":{"type":"number","exclusiveMaximum":100000000.0,"exclusiveMinimum":-100000000.0,"title":"Price"},"finance_type_id":{"type":"integer","title":"Finance Type Id"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","title":"SupplierInvoiceUpdate"},"SupplierListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"},"country":{"type":"string","title":"Country"}},"type":"object","title":"SupplierListParams"},"SupplierOrderCreate":{"properties":{"creation_key":{"type":"string","format":"uuid4","title":"Creation Key","description":"同一次创建使用固定 UUID v4；结果不明先按此标识查询，勿生成新标识重试"},"id":{"type":"integer","minimum":1.0,"title":"Id","description":"指定主键（历史导入时与 SAP Numerator 一致）"},"supplier_id":{"type":"integer","title":"Supplier Id"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSupplierItem"},"type":"array","title":"Items","description":"商品与订单在同一事务创建；不能同时传 product_sku_sn_ids"},"status":{"type":"integer","title":"Status","default":0},"product_total":{"type":"number","title":"Product Total"},"discount":{"type":"number","title":"Discount"},"discount_mark":{"type":"string","title":"Discount Mark"},"total":{"type":"number","title":"Total"},"tax_total":{"type":"number","title":"Tax Total"},"remark":{"type":"string","title":"Remark"},"order_time":{"type":"string","format":"date-time","title":"Order Time"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"}},"type":"object","required":["supplier_id"],"title":"SupplierOrderCreate"},"SupplierOrderImportBatchParams":{"properties":{"orders":{"items":{"$ref":"#/components/schemas/SupplierImportOrder"},"type":"array","maxItems":50,"minItems":1,"title":"Orders"}},"type":"object","required":["orders"],"title":"SupplierOrderImportBatchParams","description":"批量导入供应链订单：一次一整批，单事务，整批成功或整批回滚"},"SupplierOrderListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"id":{"type":"integer","title":"Id"},"supplier_id":{"type":"integer","title":"Supplier Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"product_sku_code":{"type":"string","title":"Product Sku Code"},"status":{"items":{"type":"integer"},"type":"array","title":"Status"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"use_biz_time_filter":{"type":"boolean","title":"Use Biz Time Filter","description":"为 True 时 start/end 作用于 coalesce(order_time, create_time)，否则仅 create_time","default":false},"return_all_matching":{"type":"boolean","title":"Return All Matching","description":"为 True 时忽略分页，返回当前筛选条件下的全部订单（出入库等场景用）","default":false},"brief":{"type":"boolean","title":"Brief","default":false}},"type":"object","title":"SupplierOrderListParams"},"SupplierOrderSettleRequest":{"properties":{"volume_m3":{"type":"number","minimum":0.0,"title":"Volume M3","default":0},"sku_volume_updates":{"items":{"$ref":"#/components/schemas/SupplierOrderSettleSkuVolume"},"type":"array","title":"Sku Volume Updates"},"expected_cost_signature":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Expected Cost Signature"},"allocations":{"items":{"type":"object"},"type":"array","title":"Allocations"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","title":"SupplierOrderSettleRequest","description":"供应链分析核算：按货运信息分别分摊货运成本并回写到库存成本字段，订单状态改为已分析核算"},"SupplierOrderSettleSkuVolume":{"properties":{"product_sku_id":{"type":"integer","title":"Product Sku Id"},"size_value":{"type":"number","exclusiveMinimum":0.0,"title":"Size Value"}},"type":"object","required":["product_sku_id","size_value"],"title":"SupplierOrderSettleSkuVolume","description":"分析核算时 SKU 体积覆盖（未设置 size_value 的 SKU 在分析核算页填写）"},"SupplierOrderUpdate":{"properties":{"supplier_id":{"type":"integer","title":"Supplier Id"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"items":{"items":{"$ref":"#/components/schemas/ProductSkuSnBuildSupplierItem"},"type":"array","title":"Items","description":"商品、订单字段与状态在同一事务保存；已有商品须传 product_sku_sn_id，不能同时传 product_sku_sn_ids"},"product_total":{"type":"number","title":"Product Total"},"discount":{"type":"number","title":"Discount"},"discount_mark":{"type":"string","title":"Discount Mark"},"total":{"type":"number","title":"Total"},"tax_total":{"type":"number","title":"Tax Total"},"status":{"type":"integer","title":"Status"},"order_time":{"type":"string","format":"date-time","title":"Order Time"},"create_time":{"type":"string","format":"date-time","title":"Create Time"},"update_time":{"type":"string","format":"date-time","title":"Update Time"},"invoice":{"type":"string","title":"Invoice"},"invoice_file":{"type":"string","title":"Invoice File"},"contract_file":{"type":"string","title":"Contract File"},"remark":{"type":"string","title":"Remark"},"approver_remark":{"type":"string","title":"Approver Remark"}},"type":"object","title":"SupplierOrderUpdate"},"SupplierShippingInfoCreate":{"properties":{"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"ship_time":{"type":"string","format":"date-time","title":"Ship Time"},"port_arrival_time":{"type":"string","format":"date-time","title":"Port Arrival Time"},"customs_clearance_time":{"type":"string","format":"date-time","title":"Customs Clearance Time"},"transit_time":{"type":"string","format":"date-time","title":"Transit Time"},"warehouse_time":{"type":"string","format":"date-time","title":"Warehouse Time"},"container":{"type":"string","title":"Container"},"size":{"type":"string","title":"Size"},"cases":{"type":"integer","title":"Cases"},"customs_status":{"type":"string","title":"Customs Status"},"customs_user":{"type":"string","title":"Customs User"},"pickup_number":{"type":"string","title":"Pickup Number"},"shipping_line_name":{"type":"string","title":"Shipping Line Name"},"pod":{"type":"string","title":"Pod"},"eta_pod":{"type":"string","format":"date-time","title":"Eta Pod"},"v_to_t":{"type":"integer","title":"V To T"},"eta_toronto":{"type":"string","format":"date-time","title":"Eta Toronto"},"delivery_toronto":{"type":"string","format":"date-time","title":"Delivery Toronto"},"send_empty_time":{"type":"string","format":"date-time","title":"Send Empty Time"},"warehouse_number":{"type":"string","title":"Warehouse Number"},"delivery_invoice":{"type":"string","title":"Delivery Invoice"},"delivery_invoice_file":{"type":"string","title":"Delivery Invoice File"},"delivery_cost":{"type":"number","title":"Delivery Cost"},"delivery_cost_exchange":{"type":"string","title":"Delivery Cost Exchange"},"delivery_cost_exchange_price":{"type":"number","title":"Delivery Cost Exchange Price"},"delivery_cost_exchange_rate":{"type":"number","title":"Delivery Cost Exchange Rate"},"delivery_link":{"type":"string","title":"Delivery Link"},"freight_invoice":{"type":"string","title":"Freight Invoice"},"freight_invoice_file":{"type":"string","title":"Freight Invoice File"},"freight_cost":{"type":"number","title":"Freight Cost"},"freight_cost_exchange":{"type":"string","title":"Freight Cost Exchange"},"freight_cost_exchange_price":{"type":"number","title":"Freight Cost Exchange Price"},"freight_cost_exchange_rate":{"type":"number","title":"Freight Cost Exchange Rate"},"freight_link":{"type":"string","title":"Freight Link"},"container_trans_invoice":{"type":"string","title":"Container Trans Invoice"},"container_trans_invoice_file":{"type":"string","title":"Container Trans Invoice File"},"container_trans_cost":{"type":"number","title":"Container Trans Cost"},"container_trans_cost_exchange":{"type":"string","title":"Container Trans Cost Exchange"},"container_trans_cost_exchange_price":{"type":"number","title":"Container Trans Cost Exchange Price"},"container_trans_cost_exchange_rate":{"type":"number","title":"Container Trans Cost Exchange Rate"},"container_trans_ap_invoice":{"type":"string","title":"Container Trans Ap Invoice"},"container_trans_link":{"type":"string","title":"Container Trans Link"},"container_trans_status":{"type":"integer","title":"Container Trans Status"},"bc_house_invoice":{"type":"string","title":"Bc House Invoice"},"bc_house_invoice_file":{"type":"string","title":"Bc House Invoice File"},"bc_house_cost":{"type":"number","title":"Bc House Cost"},"bc_house_cost_exchange":{"type":"string","title":"Bc House Cost Exchange"},"bc_house_cost_exchange_price":{"type":"number","title":"Bc House Cost Exchange Price"},"bc_house_cost_exchange_rate":{"type":"number","title":"Bc House Cost Exchange Rate"},"bc_house_ap_invoice":{"type":"string","title":"Bc House Ap Invoice"},"bc_house_link":{"type":"string","title":"Bc House Link"},"duty_transaction_no":{"type":"string","title":"Duty Transaction No"},"duty_transaction_cost":{"type":"number","title":"Duty Transaction Cost"},"duty_transaction_cost_exchange":{"type":"string","title":"Duty Transaction Cost Exchange"},"duty_transaction_cost_exchange_price":{"type":"number","title":"Duty Transaction Cost Exchange Price"},"duty_transaction_cost_exchange_rate":{"type":"number","title":"Duty Transaction Cost Exchange Rate"},"duty_transaction_ap_invoice":{"type":"string","title":"Duty Transaction Ap Invoice"},"duty_link":{"type":"string","title":"Duty Link"},"velox_invoice":{"type":"string","title":"Velox Invoice"},"velox_invoice_file":{"type":"string","title":"Velox Invoice File"},"velox_cost":{"type":"number","title":"Velox Cost"},"velox_cost_exchange":{"type":"string","title":"Velox Cost Exchange"},"velox_cost_exchange_price":{"type":"number","title":"Velox Cost Exchange Price"},"velox_cost_exchange_rate":{"type":"number","title":"Velox Cost Exchange Rate"},"velox_ap_invoice":{"type":"string","title":"Velox Ap Invoice"},"velox_link":{"type":"string","title":"Velox Link"},"other_cost":{"type":"number","title":"Other Cost"},"other_cost_exchange":{"type":"string","title":"Other Cost Exchange"},"other_cost_exchange_price":{"type":"number","title":"Other Cost Exchange Price"},"other_cost_exchange_rate":{"type":"number","title":"Other Cost Exchange Rate"},"other_invoice":{"type":"string","title":"Other Invoice"}},"type":"object","required":["supplier_order_id"],"title":"SupplierShippingInfoCreate"},"SupplierShippingInfoListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"pod":{"type":"string","title":"Pod"},"customs_status":{"type":"string","title":"Customs Status"},"container_trans_status":{"type":"integer","title":"Container Trans Status"}},"type":"object","title":"SupplierShippingInfoListParams"},"SupplierShippingInfoUpdate":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"ship_time":{"type":"string","format":"date-time","title":"Ship Time"},"port_arrival_time":{"type":"string","format":"date-time","title":"Port Arrival Time"},"customs_clearance_time":{"type":"string","format":"date-time","title":"Customs Clearance Time"},"transit_time":{"type":"string","format":"date-time","title":"Transit Time"},"warehouse_time":{"type":"string","format":"date-time","title":"Warehouse Time"},"container":{"type":"string","title":"Container"},"size":{"type":"string","title":"Size"},"cases":{"type":"integer","title":"Cases"},"customs_status":{"type":"string","title":"Customs Status"},"customs_user":{"type":"string","title":"Customs User"},"pickup_number":{"type":"string","title":"Pickup Number"},"shipping_line_name":{"type":"string","title":"Shipping Line Name"},"pod":{"type":"string","title":"Pod"},"eta_pod":{"type":"string","format":"date-time","title":"Eta Pod"},"v_to_t":{"type":"integer","title":"V To T"},"eta_toronto":{"type":"string","format":"date-time","title":"Eta Toronto"},"delivery_toronto":{"type":"string","format":"date-time","title":"Delivery Toronto"},"send_empty_time":{"type":"string","format":"date-time","title":"Send Empty Time"},"warehouse_number":{"type":"string","title":"Warehouse Number"},"delivery_invoice":{"type":"string","title":"Delivery Invoice"},"delivery_invoice_file":{"type":"string","title":"Delivery Invoice File"},"delivery_cost":{"type":"number","title":"Delivery Cost"},"delivery_cost_exchange":{"type":"string","title":"Delivery Cost Exchange"},"delivery_cost_exchange_price":{"type":"number","title":"Delivery Cost Exchange Price"},"delivery_cost_exchange_rate":{"type":"number","title":"Delivery Cost Exchange Rate"},"delivery_link":{"type":"string","title":"Delivery Link"},"freight_invoice":{"type":"string","title":"Freight Invoice"},"freight_invoice_file":{"type":"string","title":"Freight Invoice File"},"freight_cost":{"type":"number","title":"Freight Cost"},"freight_cost_exchange":{"type":"string","title":"Freight Cost Exchange"},"freight_cost_exchange_price":{"type":"number","title":"Freight Cost Exchange Price"},"freight_cost_exchange_rate":{"type":"number","title":"Freight Cost Exchange Rate"},"freight_link":{"type":"string","title":"Freight Link"},"container_trans_invoice":{"type":"string","title":"Container Trans Invoice"},"container_trans_invoice_file":{"type":"string","title":"Container Trans Invoice File"},"container_trans_cost":{"type":"number","title":"Container Trans Cost"},"container_trans_cost_exchange":{"type":"string","title":"Container Trans Cost Exchange"},"container_trans_cost_exchange_price":{"type":"number","title":"Container Trans Cost Exchange Price"},"container_trans_cost_exchange_rate":{"type":"number","title":"Container Trans Cost Exchange Rate"},"container_trans_ap_invoice":{"type":"string","title":"Container Trans Ap Invoice"},"container_trans_link":{"type":"string","title":"Container Trans Link"},"container_trans_status":{"type":"integer","title":"Container Trans Status"},"bc_house_invoice":{"type":"string","title":"Bc House Invoice"},"bc_house_invoice_file":{"type":"string","title":"Bc House Invoice File"},"bc_house_cost":{"type":"number","title":"Bc House Cost"},"bc_house_cost_exchange":{"type":"string","title":"Bc House Cost Exchange"},"bc_house_cost_exchange_price":{"type":"number","title":"Bc House Cost Exchange Price"},"bc_house_cost_exchange_rate":{"type":"number","title":"Bc House Cost Exchange Rate"},"bc_house_ap_invoice":{"type":"string","title":"Bc House Ap Invoice"},"bc_house_link":{"type":"string","title":"Bc House Link"},"duty_transaction_no":{"type":"string","title":"Duty Transaction No"},"duty_transaction_cost":{"type":"number","title":"Duty Transaction Cost"},"duty_transaction_cost_exchange":{"type":"string","title":"Duty Transaction Cost Exchange"},"duty_transaction_cost_exchange_price":{"type":"number","title":"Duty Transaction Cost Exchange Price"},"duty_transaction_cost_exchange_rate":{"type":"number","title":"Duty Transaction Cost Exchange Rate"},"duty_transaction_ap_invoice":{"type":"string","title":"Duty Transaction Ap Invoice"},"duty_link":{"type":"string","title":"Duty Link"},"velox_invoice":{"type":"string","title":"Velox Invoice"},"velox_invoice_file":{"type":"string","title":"Velox Invoice File"},"velox_cost":{"type":"number","title":"Velox Cost"},"velox_cost_exchange":{"type":"string","title":"Velox Cost Exchange"},"velox_cost_exchange_price":{"type":"number","title":"Velox Cost Exchange Price"},"velox_cost_exchange_rate":{"type":"number","title":"Velox Cost Exchange Rate"},"velox_ap_invoice":{"type":"string","title":"Velox Ap Invoice"},"velox_link":{"type":"string","title":"Velox Link"},"other_cost":{"type":"number","title":"Other Cost"},"other_cost_exchange":{"type":"string","title":"Other Cost Exchange"},"other_cost_exchange_price":{"type":"number","title":"Other Cost Exchange Price"},"other_cost_exchange_rate":{"type":"number","title":"Other Cost Exchange Rate"},"other_invoice":{"type":"string","title":"Other Invoice"}},"type":"object","title":"SupplierShippingInfoUpdate"},"SupplierSkuCodeMapBatchDeleteParams":{"properties":{"supplier_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Supplier Id"},"codes":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":1000,"minItems":1,"title":"Codes"}},"type":"object","required":["supplier_id","codes"],"title":"SupplierSkuCodeMapBatchDeleteParams"},"SupplierSkuCodeMapBatchSaveParams":{"properties":{"supplier_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Supplier Id"},"items":{"items":{"$ref":"#/components/schemas/SupplierSkuCodeMapItem"},"type":"array","maxItems":1000,"minItems":1,"title":"Items"}},"type":"object","required":["supplier_id","items"],"title":"SupplierSkuCodeMapBatchSaveParams"},"SupplierSkuCodeMapItem":{"properties":{"code":{"type":"string","maxLength":100,"minLength":1,"title":"Code"},"sku_code":{"type":"string","maxLength":50,"minLength":1,"title":"Sku Code"}},"type":"object","required":["code","sku_code"],"title":"SupplierSkuCodeMapItem"},"SupplierSkuCodeMapListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"supplier_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Supplier Id"},"code":{"type":"string","title":"Code"},"sku_code":{"type":"string","title":"Sku Code"}},"type":"object","required":["supplier_id"],"title":"SupplierSkuCodeMapListParams"},"SupplierSkuCodeMapReplaceParams":{"properties":{"supplier_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Supplier Id"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Revision"},"items":{"items":{"$ref":"#/components/schemas/SupplierSkuCodeMapItem"},"type":"array","maxItems":10000,"title":"Items"}},"type":"object","required":["supplier_id","revision","items"],"title":"SupplierSkuCodeMapReplaceParams"},"SupplierUpdate":{"properties":{"name":{"type":"string","title":"Name"},"bp_code":{"type":"string","maxLength":100,"title":"Bp Code"},"country":{"type":"string","title":"Country"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone"},"payment_days":{"type":"integer","title":"Payment Days"},"remark":{"type":"string","title":"Remark"}},"type":"object","title":"SupplierUpdate"},"TaxInvoiceCreate":{"properties":{"type":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Type"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"tax_total":{"type":"number","exclusiveMaximum":1000000000000.0,"exclusiveMinimum":-1000000000000.0,"title":"Tax Total","description":"Signed recorded tax, at most 2 decimal places","default":0},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","required":["type"],"title":"TaxInvoiceCreate"},"TaxInvoiceListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"type":{"type":"integer","title":"Type"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"sale_order_id":{"type":"integer","title":"Sale Order Id"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"TaxInvoiceListParams"},"TaxInvoiceSumBySaleOrdersParams":{"properties":{"sale_order_ids":{"items":{"type":"integer"},"type":"array","title":"Sale Order Ids"}},"type":"object","title":"TaxInvoiceSumBySaleOrdersParams","description":"按销售订单汇总已开税票金额"},"TaxInvoiceSumBySupplierOrdersParams":{"properties":{"supplier_order_ids":{"items":{"type":"integer"},"type":"array","title":"Supplier Order Ids"}},"type":"object","title":"TaxInvoiceSumBySupplierOrdersParams","description":"按供应链订单汇总已开税票金额"},"TaxInvoiceUpdate":{"properties":{"tax_total":{"type":"number","exclusiveMaximum":1000000000000.0,"exclusiveMinimum":-1000000000000.0,"title":"Tax Total"},"remark":{"type":"string","title":"Remark"},"invoice_file":{"type":"string","title":"Invoice File"}},"type":"object","title":"TaxInvoiceUpdate"},"TempFileUrlParams":{"properties":{"object_path":{"type":"string","title":"Object Path"},"expire_seconds":{"type":"integer","maximum":86400.0,"minimum":1.0,"title":"Expire Seconds","default":3600}},"type":"object","required":["object_path"],"title":"TempFileUrlParams"},"Token":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"}},"type":"object","required":["access_token","token_type"],"title":"Token"},"TransferDepartureStatusItem":{"properties":{"snapshot_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Snapshot Id"},"pre_stock":{"type":"boolean","title":"Pre Stock"},"stock_tag":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Stock Tag"}},"type":"object","required":["snapshot_id","pre_stock","stock_tag"],"title":"TransferDepartureStatusItem"},"TransferDepartureStatusReconcile":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TransferDepartureStatusItem"},"type":"array","maxItems":100,"minItems":1,"title":"Items"},"reason":{"type":"string","maxLength":500,"minLength":1,"title":"Reason"}},"type":"object","required":["items","reason"],"title":"TransferDepartureStatusReconcile"},"TransferReceivingShelf":{"properties":{"plan_snapshot_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Plan Snapshot Id"},"shelf_position":{"type":"string","maxLength":100,"title":"Shelf Position","description":"Actual receiving shelf; null or a blank string means no shelf. Does not edit the plan or departure."}},"additionalProperties":false,"type":"object","required":["plan_snapshot_id","shelf_position"],"title":"TransferReceivingShelf"},"UserCreate":{"properties":{"account":{"type":"string","maxLength":50,"title":"Account"},"password":{"type":"string","maxLength":50,"title":"Password"},"user_type":{"type":"integer","title":"User Type","default":0},"name":{"type":"string","maxLength":100,"title":"Name"},"avatar":{"type":"string","maxLength":200,"title":"Avatar"},"mobile":{"type":"string","maxLength":50,"title":"Mobile"},"email":{"type":"string","maxLength":100,"title":"Email"}},"type":"object","required":["account","password"],"title":"UserCreate"},"UserCreateAdminParams":{"properties":{"account":{"type":"string","maxLength":50,"title":"Account"},"password":{"type":"string","maxLength":50,"title":"Password"},"role_id":{"type":"integer","title":"Role Id"},"user_type":{"type":"integer","title":"User Type","default":0},"store_id":{"type":"integer","title":"Store Id"},"visible_store_ids":{"items":{"type":"integer"},"type":"array","title":"Visible Store Ids"},"visible_supplier_ids":{"items":{"type":"integer"},"type":"array","title":"Visible Supplier Ids"},"name":{"type":"string","maxLength":50,"title":"Name"},"avatar":{"type":"string","maxLength":256,"title":"Avatar"},"mobile":{"type":"string","maxLength":50,"title":"Mobile"},"email":{"type":"string","maxLength":100,"title":"Email"},"mark":{"type":"string","title":"Mark"}},"type":"object","required":["account","password"],"title":"UserCreateAdminParams","description":"管理员创建用户参数"},"UserLogin":{"properties":{"username":{"type":"string","maxLength":50,"title":"Username"},"password":{"type":"string","maxLength":50,"title":"Password"}},"type":"object","required":["username","password"],"title":"UserLogin"},"UserUpdateAdminParams":{"properties":{"user_id":{"type":"integer","title":"User Id"},"name":{"type":"string","title":"Name"},"mobile":{"type":"string","title":"Mobile"},"email":{"type":"string","title":"Email"},"avatar":{"type":"string","title":"Avatar"},"mark":{"type":"string","title":"Mark"},"role_id":{"type":"integer","title":"Role Id"},"store_id":{"type":"integer","title":"Store Id"},"visible_store_ids":{"items":{"type":"integer"},"type":"array","title":"Visible Store Ids"},"visible_supplier_ids":{"items":{"type":"integer"},"type":"array","title":"Visible Supplier Ids"},"password":{"type":"string","maxLength":50,"title":"Password"}},"type":"object","required":["user_id"],"title":"UserUpdateAdminParams"},"UserUpdateSelfParams":{"properties":{"name":{"type":"string","maxLength":50,"title":"Name"},"mobile":{"type":"string","maxLength":50,"title":"Mobile"},"email":{"type":"string","maxLength":100,"title":"Email"},"avatar":{"type":"string","maxLength":256,"title":"Avatar"}},"type":"object","title":"UserUpdateSelfParams"},"UserUpdateTypeParams":{"properties":{"user_id":{"type":"integer","title":"User Id"},"user_type":{"type":"integer","title":"User Type"}},"type":"object","required":["user_id","user_type"],"title":"UserUpdateTypeParams"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WarehouseCodeLookupParams":{"properties":{"code":{"type":"string","maxLength":100,"minLength":1,"title":"Code"}},"type":"object","required":["code"],"title":"WarehouseCodeLookupParams"},"WarehouseCreate":{"properties":{"name":{"type":"string","maxLength":200,"title":"Name"},"code":{"type":"string","maxLength":100,"title":"Code"},"address":{"type":"string","title":"Address"},"phone":{"type":"string","title":"Phone"},"storage_cost_per_cbm_per_day":{"type":"number","title":"Storage Cost Per Cbm Per Day"}},"type":"object","required":["name"],"title":"WarehouseCreate"},"WarehouseIOCreate":{"properties":{"warehouse_id":{"type":"integer","title":"Warehouse Id"},"type":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Type","default":0},"order_id":{"type":"integer","title":"Order Id"},"warehouse_transfer_id":{"type":"integer","title":"Warehouse Transfer Id"},"supplier_shipping_info_id":{"type":"integer","title":"Supplier Shipping Info Id"},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"product_diff":{"type":"string","title":"Product Diff"},"remark":{"type":"string","title":"Remark"},"images":{"type":"string","title":"Images"},"local_cache_version":{"type":"integer","title":"Local Cache Version"},"import_data_mode":{"type":"boolean","title":"Import Data Mode","default":false},"transfer_receiving_shelves":{"items":{"$ref":"#/components/schemas/TransferReceivingShelf"},"type":"array","maxItems":100,"minItems":1,"title":"Transfer Receiving Shelves","description":"Only for type=0 transfer receipts. Each ID is a plan snapshot in the selected transfer, never an actual departure ID. Unmentioned lines retain their planned shelf; quantity, expiry, costs and flags remain frozen at departure."}},"type":"object","required":["warehouse_id"],"title":"WarehouseIOCreate"},"WarehouseIOListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"type":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Type"},"order_id":{"type":"integer","title":"Order Id"},"warehouse_transfer_id":{"type":"integer","title":"Warehouse Transfer Id"},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"return_all_matching":{"type":"boolean","title":"Return All Matching","description":"Return complete history for a specific order, transfer or return; pagination is otherwise preserved.","default":false},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"WarehouseIOListParams"},"WarehouseIOUpdate":{"properties":{"type":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Type"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"product_diff":{"type":"string","title":"Product Diff"},"remark":{"type":"string","title":"Remark"},"images":{"type":"string","title":"Images"}},"type":"object","title":"WarehouseIOUpdate"},"WarehouseListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"name":{"type":"string","title":"Name"}},"type":"object","title":"WarehouseListParams"},"WarehousePutawayCreate":{"properties":{"putaway_mode":{"type":"string","title":"Putaway Mode","default":"supplier_order"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"sale_return_id":{"type":"integer","title":"Sale Return Id"},"source_product_stock_id":{"type":"integer","title":"Source Product Stock Id"},"warehouse_id":{"type":"integer","title":"Warehouse Id"},"product_sku_id":{"type":"integer","title":"Product Sku Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"expire_time":{"type":"string","format":"date-time","title":"Expire Time"},"shelf_position":{"type":"string","title":"Shelf Position"},"warehouse_io_id":{"type":"integer","title":"Warehouse Io Id"},"remark":{"type":"string","title":"Remark"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["product_sku_id","quantity"],"title":"WarehousePutawayCreate"},"WarehousePutawayOrderListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"keyword":{"type":"string","title":"Keyword"},"putaway_mode":{"type":"string","title":"Putaway Mode","default":"supplier_order"}},"type":"object","title":"WarehousePutawayOrderListParams"},"WarehousePutawayStockListParams":{"properties":{"putaway_mode":{"type":"string","title":"Putaway Mode","default":"supplier_order"},"supplier_order_id":{"type":"integer","title":"Supplier Order Id"},"sale_return_id":{"type":"integer","title":"Sale Return Id"}},"type":"object","title":"WarehousePutawayStockListParams"},"WarehouseStockDestroyExecuteParams":{"properties":{"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"},"product_stock_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Product Stock Id"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"remark":{"type":"string","title":"Remark"},"local_cache_version":{"type":"integer","title":"Local Cache Version"}},"type":"object","required":["warehouse_id","product_stock_id","quantity"],"title":"WarehouseStockDestroyExecuteParams","description":"执行销毁：扣减待销毁库存并写入销毁记录"},"WarehouseStockDestroyListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"warehouse_id":{"type":"integer","exclusiveMinimum":0.0,"title":"Warehouse Id"}},"type":"object","required":["warehouse_id"],"title":"WarehouseStockDestroyListParams","description":"已执行销毁记录列表"},"WarehouseTransferCreate":{"properties":{"from_warehouse_id":{"type":"integer","title":"From Warehouse Id"},"to_warehouse_id":{"type":"integer","title":"To Warehouse Id"},"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"remark":{"type":"string","title":"Remark"}},"type":"object","required":["from_warehouse_id","to_warehouse_id"],"title":"WarehouseTransferCreate"},"WarehouseTransferListParams":{"properties":{"page":{"type":"integer","minimum":1.0,"title":"Page","default":1},"page_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":10},"from_warehouse_id":{"type":"integer","title":"From Warehouse Id"},"to_warehouse_id":{"type":"integer","title":"To Warehouse Id"},"user_id":{"type":"integer","title":"User Id"},"status":{"type":"integer","maximum":2.0,"minimum":0.0,"title":"Status"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"}},"type":"object","title":"WarehouseTransferListParams"},"WarehouseTransferUpdate":{"properties":{"product_sku_sn_ids":{"items":{"type":"integer"},"type":"array","title":"Product Sku Sn Ids"},"remark":{"type":"string","title":"Remark"}},"type":"object","title":"WarehouseTransferUpdate","description":"仅待出库(status=0)时可更新"},"WarehouseUpdate":{"properties":{"name":{"type":"string","title":"Name"},"code":{"type":"string","maxLength":100,"title":"Code"},"address":{"type":"string","title":"Address"},"phone":{"type":"string","title":"Phone"},"storage_cost_per_cbm_per_day":{"type":"number","title":"Storage Cost Per Cbm Per Day"}},"type":"object","title":"WarehouseUpdate"}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}}}}