cs.declaration-batches.create

创建一个新的报关单

• 请求路由: cs.declaration-batches.create
• 交互模型: Request Response
• 访问限制: 无

请求

RSocket.rr({
  "route" : "cs.declaration-batches.create",
  "data" : {
    "replaceMe" : "要创建的对象"
  }
});

请求参数

名称	类型	必须	说明
declarationId	String	否	批次号（D + 8位日期流水）
customsDeclarationId	String	否	关联报关委托单 ID
type	String	否	报关类型 EXPORT - 出口 IMPORT - 入口
targetWarehouseId	String	否	目标仓库（往来单位id）
contract	Object	否	合同信息
contract.seller	Object	否	卖方
contract.seller.name	String	否	名称(英文)
contract.seller.address	String	否	地址(英文)
contract.seller.tel	String	否	电话
contract.seller.fax	String	否	传真
contract.seller.contactPerson	String	否	联系人
contract.seller.tax	String	否	税号
contract.buyer	Object	否	买方
contract.buyer.name	String	否	名称(英文)
contract.buyer.address	String	否	地址(英文)
contract.buyer.tel	String	否	电话
contract.buyer.fax	String	否	传真
contract.buyer.contactPerson	String	否	联系人
contract.buyer.tax	String	否	税号
contract.contractNo	String	否	合同号
contract.contractDate	String	否	合同日期
contract.signAt	String	否	签约地点
contract.tradeTerm	String	否	贸易条款
contract.timeOfShipment	String	否	装货时间(yyyy-MM-dd)
contract.loadingPortDestination	String	否	装货港到目的地描述
contract.termsOfPayment	String	否	付款条款
contract.shippingMarks	String	否	唛头 所有packingList唛头去重后拼接而成
contract.theBuyer	Object	否	目的地买方
contract.theBuyer.name	String	否	名称(英文)
contract.theBuyer.address	String	否	地址(英文)
contract.theBuyer.tel	String	否	电话
contract.theBuyer.fax	String	否	传真
contract.theBuyer.contactPerson	String	否	联系人
contract.theBuyer.tax	String	否	税号
contract.theSeller	Object	否	目的地卖方
contract.theSeller.name	String	否	名称(英文)
contract.theSeller.address	String	否	地址(英文)
contract.theSeller.tel	String	否	电话
contract.theSeller.fax	String	否	传真
contract.theSeller.contactPerson	String	否	联系人
contract.theSeller.tax	String	否	税号
invoice	Object	否	发票信息
invoice.shipperExporter	String	否	卖方信息(注意换行) 卖方名称英文 卖方英文地址 卖方联系人 卖方税号
invoice.invoiceNo	String	否	发票号
invoice.invoiceDate	String	否	发票日期
invoice.deliveryTerm	String	否	交货条款
invoice.consigneeImporter	String	否	买方信息(注意换行) 买方名称英文 买方英文地址
invoice.notifyParty	String	否	和收货人相同
invoice.portOfDeparture	String	否	出发港
invoice.portOfDestination	String	否	目的港
invoice.packingAndShippingMarks	String	否	包装唛头 所有packingList唛头去重后拼接而成
packingList	Object[]	否	装箱清单列表
packingList.[].containerNo	String	否	集装箱号
packingList.[].sealNo	String	否	封签号
packingList.[].model	String	否	型号(SKU)
packingList.[].productName	String	否	商品名
packingList.[].productNameEn	String	否	商品英文名
packingList.[].carton	Number	否	箱数
packingList.[].unit	String	否	单位
packingList.[].netWeight	Number	否	本行全部货品的总净重（KGS）
packingList.[].unitNetWeight	Number	否	单箱净重（KGS），为报关 Excel 明细公式保留的辅助参数，不是本行总净重。
packingList.[].grossWeight	Number	否	本行全部货品的总毛重（KGS）
packingList.[].unitGrossWeight	Number	否	单箱毛重（KGS），为报关 Excel 明细公式保留的辅助参数，不是本行总毛重。
packingList.[].packageSize	String	否	包装尺寸(mm)
packingList.[].cbm	Number	否	本行全部货品的总体积（CBM，立方米） 未提供行总体积时可由单箱尺寸换算后乘箱数估算；报关 Excel 另按柜执行 68 CBM 封顶和分摊。
packingList.[].importPriceUsd	Number	否	进口单价(美元)
packingList.[].exportPriceUsd	Number	否	出口单价(美元)
packingList.[].spec	String	否	规格(字典值)
packingList.[].boxCapacity	Number	否	每箱数量
packingList.[].shippingMark	String	否	唛头/箱唛标识
packingList.[].tareWeightKGS	Number	否	当前空集装箱的皮重（KGS）
attachments	Object[]	否	批次专属材料附件列表（如报关行整理的草单附件）
attachments.[].title	String	否	附件标题
attachments.[].description	String	否	附件说明
attachments.[].binaryId	String[]	否	附件id
declarationResult	Object	否	对应本批次的报关/放行结果
declarationResult.resultId	String	否	结果唯一 ID（UUID）
declarationResult.resultType	String	否	结果类型：放行/查验/退单 RELEASED - 放行 INSPECTION - 海关查验（截停留检） REJECTED - 退单
declarationResult.batchId	String	否	关联批次 ID。 回写结果时可选；缺省时后端按报关单号匹配批次，无法匹配则自动创建。
declarationResult.entryNo	String	否	报关单号（18位）。 非空时在同一报关委托单内唯一，用于重复回写时定位已有批次。
declarationResult.declarationDate	String	否	报关日期
declarationResult.packageCount	Number	否	件数
declarationResult.grossWeight	Number	否	本条报关结果对应全部货品的总毛重（KGS）
declarationResult.netWeight	Number	否	本条报关结果对应全部货品的总净重（KGS）
declarationResult.cargoValue	Number	否	货值（USD）
declarationResult.actualReleaseTime	String	否	实际放行时间
declarationResult.taxRefundStatus	String	否	退税联状态 NOT_COLLECTED - 未领取(暂未出具) COLLECTED - 已领取(已出具在途) REFUNDED - 已退税(已邮寄归还客户)
declarationResult.attachments	Object[]	否	关联放行条附件列表
declarationResult.attachments.[].title	String	否	附件标题
declarationResult.attachments.[].description	String	否	附件说明
declarationResult.attachments.[].binaryId	String[]	否	附件id
modifiedFields	String[]	否	修改过的字段列表
legalEntityId	String	否	法人主体id
customerId	String	否	客户id
extraProps	Object	否	扩展属性
crBy	String	否	创建者
upBy	String	否	最后修改者
crDate	String	否	创建时间
upDate	String	否	最后修改时间
id	Varies	否	返回报关批次业务主键，供报关结果关联和通用持久化使用。

返回

创建成功后的对象

{ }

返回属性

名称	类型	说明
declarationId	String	批次号（D + 8位日期流水）
customsDeclarationId	String	关联报关委托单 ID
type	String	报关类型 EXPORT - 出口 IMPORT - 入口
targetWarehouseId	String	目标仓库（往来单位id）
targetWarehouse	Object	目标仓库（往来单位）
targetWarehouse.country	String	国家
targetWarehouse.countryEn	String	国家(英文)
targetWarehouse.abbreviation	String	名称缩写
targetWarehouse.address	String	地址（中文）
targetWarehouse.addressEn	String	地址（英文）
targetWarehouse.contactPersons	Object[]	联系人信息列表，支持多个联系人
targetWarehouse.contactPersons.[].username	String	用户标识
targetWarehouse.contactPersons.[].name	String	用户名称
targetWarehouse.contactPersons.[].nameEn	String	英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
targetWarehouse.contactPersons.[].mobile	String	用户手机号
targetWarehouse.contactPersons.[].email	String	用户邮箱
targetWarehouse.contactPersons.[].position	String	职位
targetWarehouse.contactPersons.[].contactRoles	String[]	联系人承担的职责，支持多选；未指定时为空集合 PRIMARY - 主联系人，承担往来单位的主要业务对接职责。 EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。 BILLING - 账单联系人，承担账单接收和账务沟通职责。
targetWarehouse.bankAccounts	Object[]	银行账户列表，支持多个账户
targetWarehouse.bankAccounts.[].accountName	String	开户名称
targetWarehouse.bankAccounts.[].bankName	String	银行名称
targetWarehouse.bankAccounts.[].bankCode	String	联行号
targetWarehouse.bankAccounts.[].bankAccount	String	银行账号
targetWarehouse.bankAccounts.[].currency	String	币制 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 获取币种名称 symbol - 获取币种符号 code - 返回币种代码
targetWarehouse.bankAccounts.[].swiftCode	String	SWIFT CODE
targetWarehouse.bankAccounts.[].address	String	地址
targetWarehouse.bankAccounts.[].isDefault	Boolean	是否默认
targetWarehouse.invoiceInfo	Object	开票信息
targetWarehouse.invoiceInfo.companyName	String	公司名称
targetWarehouse.invoiceInfo.taxIdentificationNumber	String	纳税识别号
targetWarehouse.invoiceInfo.companyAddress	String	公司地址
targetWarehouse.invoiceInfo.phone	String	电话
targetWarehouse.invoiceInfo.bankAccount	String	银行账号
targetWarehouse.invoiceInfo.contact	String	联系人
targetWarehouse.invoiceInfo.email	String	邮箱
targetWarehouse.extraProps	Object	扩展信息
targetWarehouse.relatedCustomers	Object[]	关联客户列表
targetWarehouse.relatedCustomers.[].tags	String[]	该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
targetWarehouse.relatedCustomers.[].extraProps	Object	专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
targetWarehouse.relatedCustomers.[].unitId	String	往来单位唯一ID，主键
targetWarehouse.relatedCustomers.[].name	String	名称（中文）
targetWarehouse.relatedCustomers.[].nameEn	String	名称（英文）
targetWarehouse.unitId	String	往来单位唯一ID，主键
targetWarehouse.name	String	名称（中文）
targetWarehouse.nameEn	String	名称（英文）
contract	Object	合同信息
contract.seller	Object	卖方
contract.seller.name	String	名称(英文)
contract.seller.address	String	地址(英文)
contract.seller.tel	String	电话
contract.seller.fax	String	传真
contract.seller.contactPerson	String	联系人
contract.seller.tax	String	税号
contract.buyer	Object	买方
contract.buyer.name	String	名称(英文)
contract.buyer.address	String	地址(英文)
contract.buyer.tel	String	电话
contract.buyer.fax	String	传真
contract.buyer.contactPerson	String	联系人
contract.buyer.tax	String	税号
contract.contractNo	String	合同号
contract.contractDate	String	合同日期
contract.signAt	String	签约地点
contract.tradeTerm	String	贸易条款
contract.timeOfShipment	String	装货时间(yyyy-MM-dd)
contract.loadingPortDestination	String	装货港到目的地描述
contract.termsOfPayment	String	付款条款
contract.shippingMarks	String	唛头 所有packingList唛头去重后拼接而成
contract.theBuyer	Object	目的地买方
contract.theBuyer.name	String	名称(英文)
contract.theBuyer.address	String	地址(英文)
contract.theBuyer.tel	String	电话
contract.theBuyer.fax	String	传真
contract.theBuyer.contactPerson	String	联系人
contract.theBuyer.tax	String	税号
contract.theSeller	Object	目的地卖方
contract.theSeller.name	String	名称(英文)
contract.theSeller.address	String	地址(英文)
contract.theSeller.tel	String	电话
contract.theSeller.fax	String	传真
contract.theSeller.contactPerson	String	联系人
contract.theSeller.tax	String	税号
invoice	Object	发票信息
invoice.shipperExporter	String	卖方信息(注意换行) 卖方名称英文 卖方英文地址 卖方联系人 卖方税号
invoice.invoiceNo	String	发票号
invoice.invoiceDate	String	发票日期
invoice.deliveryTerm	String	交货条款
invoice.consigneeImporter	String	买方信息(注意换行) 买方名称英文 买方英文地址
invoice.notifyParty	String	和收货人相同
invoice.portOfDeparture	String	出发港
invoice.portOfDestination	String	目的港
invoice.packingAndShippingMarks	String	包装唛头 所有packingList唛头去重后拼接而成
productInfo	Object[]	产品信息列表
productInfo.[].productNo	String	SKU
productInfo.[].productNameEn	String	商品英文名
productInfo.[].productName	String	商品名
productInfo.[].spec	String	规格
productInfo.[].unit	String	单位
productInfo.[].boxCapacity	Number	每箱数量
productInfo.[].unitPrice	Number	单价(USD)
packingList	Object[]	装箱清单列表
packingList.[].containerNo	String	集装箱号
packingList.[].sealNo	String	封签号
packingList.[].model	String	型号(SKU)
packingList.[].productName	String	商品名
packingList.[].productNameEn	String	商品英文名
packingList.[].carton	Number	箱数
packingList.[].unit	String	单位
packingList.[].netWeight	Number	本行全部货品的总净重（KGS）
packingList.[].unitNetWeight	Number	单箱净重（KGS），为报关 Excel 明细公式保留的辅助参数，不是本行总净重。
packingList.[].grossWeight	Number	本行全部货品的总毛重（KGS）
packingList.[].unitGrossWeight	Number	单箱毛重（KGS），为报关 Excel 明细公式保留的辅助参数，不是本行总毛重。
packingList.[].packageSize	String	包装尺寸(mm)
packingList.[].cbm	Number	本行全部货品的总体积（CBM，立方米） 未提供行总体积时可由单箱尺寸换算后乘箱数估算；报关 Excel 另按柜执行 68 CBM 封顶和分摊。
packingList.[].importPriceUsd	Number	进口单价(美元)
packingList.[].exportPriceUsd	Number	出口单价(美元)
packingList.[].spec	String	规格(字典值)
packingList.[].boxCapacity	Number	每箱数量
packingList.[].shippingMark	String	唛头/箱唛标识
packingList.[].tareWeightKGS	Number	当前空集装箱的皮重（KGS）
attachments	Object[]	批次专属材料附件列表（如报关行整理的草单附件）
attachments.[].title	String	附件标题
attachments.[].description	String	附件说明
attachments.[].binaryId	String[]	附件id
declarationResult	Object	对应本批次的报关/放行结果
declarationResult.resultId	String	结果唯一 ID（UUID）
declarationResult.resultType	String	结果类型：放行/查验/退单 RELEASED - 放行 INSPECTION - 海关查验（截停留检） REJECTED - 退单
declarationResult.batchId	String	关联批次 ID。 回写结果时可选；缺省时后端按报关单号匹配批次，无法匹配则自动创建。
declarationResult.entryNo	String	报关单号（18位）。 非空时在同一报关委托单内唯一，用于重复回写时定位已有批次。
declarationResult.declarationDate	String	报关日期
declarationResult.packageCount	Number	件数
declarationResult.grossWeight	Number	本条报关结果对应全部货品的总毛重（KGS）
declarationResult.netWeight	Number	本条报关结果对应全部货品的总净重（KGS）
declarationResult.cargoValue	Number	货值（USD）
declarationResult.actualReleaseTime	String	实际放行时间
declarationResult.taxRefundStatus	String	退税联状态 NOT_COLLECTED - 未领取(暂未出具) COLLECTED - 已领取(已出具在途) REFUNDED - 已退税(已邮寄归还客户)
declarationResult.attachments	Object[]	关联放行条附件列表
declarationResult.attachments.[].title	String	附件标题
declarationResult.attachments.[].description	String	附件说明
declarationResult.attachments.[].binaryId	String[]	附件id
modifiedFields	String[]	修改过的字段列表
legalEntityId	String	法人主体id
customerId	String	客户id
extraProps	Object	扩展属性
crBy	String	创建者
upBy	String	最后修改者
crDate	String	创建时间
upDate	String	最后修改时间
tenantId	String	租户ID
id	Varies	返回报关批次业务主键，供报关结果关联和通用持久化使用。

下载结果模型定义