用途:处理已批准的贸易单证流程,覆盖 Flexport 采购订单、商业发票与文件三类资源的创建和核对。
主要能力:区分结构化记录与上传文件的治理方式;提交前用只读查询校验网络实体、地点、货运与产品标识;按文档化行为提交采购订单、商业发票或文件;文件内容以 Base64 承载,编码前不得超过文档所述 10 MB 上限;返回不透明 ID 后回读资源进行核对;记录来源、操作者、版本头与脱敏结果。
使用方式:选择与业务结果匹配的资源端点,不把其他资源字段塞进同一端点;确认 OAuth 凭据包含所需端点资源,商业发票创建/更新还需 Flexport 侧开通与授权;持久化操作摘要后一次性提交;文件替换须通过审批的新上传,而非虚构更新调用。REST 调用使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌,audience 为 https://api.flexport.com,或显式接受的宽泛 API 密钥;MCP 调用经 https://mcp.flexport.com/mcp 的已认证连接。凭据与令牌不得记录日志。
适用场景:经批准的贸易单证流转、单证核对与 lineage 记录。
限制:商业发票未开通时须停止并申请权限;422 需修正源载荷而非原样重试;文件过大应在 Base64 编码前拒绝;创建结果不明确时先按已知业务引用回读或核对再重提交。具体端点字段、价格、平台支持范围等资料未提供。