积加ERP对接打通金蝶云星空发货单查询接口与其他应付单新增接口
接通系统:积加ERP
深圳市积加跨境网络科技有限公司,是国内跨境电商数字基础设施服务商,为跨境精品卖家提供全闭环的电商解决方案。积加致力于让入门级卖家成长,中大型卖家发展,成就精品全渠道商家。企业简介深圳市积加跨境网络科技有限公司(简称积加)
写入目标:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:积加ERP,然后选择对应的连接器。选择对应的api/v2/purchase/delivery作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
积加ERP接口明细
- 接口:api/v2/purchase/delivery
- 接口名
- 称:发货单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
page | 页码 | string | 1 |
pagesize | 条数 | string | 20 |
sort | 排序 | string | createdTime |
order | 顺序或逆序 | string | descend/ascend |
codeList | 发货单号 | string | DL2109070005 |
diffQuantity | 是否有差异 | string | 1 |
country | 国家 | string | EU |
warehouseIdList | 目的仓库的集合 | string | 5 |
statusList | 状态 | string | processing |
dlBusinessType | 物流商类型 | string | WLS001 |
transport | 运输方式 | string | 2 |
shipmentDateBegin | 实际发货开始时间 | string | 44447 |
shipmentDateEnd | 实际发货结束时间 | string | 44447 |
响应参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
id | id | string | 5 |
code | 发货单号 | string | DL2109070005 |
estimatedCurrencySymbol | 预估费用币种符号 | string | ¥ |
country | 国家 | string | EU |
estimatedAmount | 预估费用 | string | 14565 |
arrivalWarehouseId | 目的仓库id(废弃) | string | |
estimatedAmountTime | 预估费用时间 | string | 2021/9/717:53:12 |
warehouseNames | 目的仓库名集合 | string | [“A:EU_FBA”] |
actualCurrencySymbol | 实际费用币种符合 | string | ¥ |
warehouseType | 仓库类型 | string | fba |
status | 状态 | string | shipped |
actualAmount | 实际费用 | string | 14665 |
relevanceCode | 关联单据 | string | |
actualAmountTime | 实际费用时间 | string | 2021/9/720:12:42 |
relevanceCodeList | 关联单据集合 | array | |
relevanceCodeList.warehouseName | 仓库名 | string | A:EU_FBA |
relevanceCodeList.transport | 运输方式 | string | 2 |
relevanceCodeList.type | 类型 | string | LN |
relevanceCodeList.transportName | 运输方式名 | string | 海运 |
relevanceCodeList.transportPrescription | 时效 | string | |
relevanceCodeList.quantity | 发货数量 | string | 5 |
relevanceCodeList.receiptQuantity | 收货数量 | string | |
relevanceCodeList.diffQuantity | 差异数量 | string | 5 |
relevanceCodeList.receivingAt | 开始收货日期 | string | |
relevanceCodeList.handleDiffQuantity | 已处理差异量 | string | |
relevanceCodeList.trackings | 运输单号 | string | |
relevanceCodeList.etd | 预计离港时间 | string | 44447 |
relevanceCodeList.eta | 预计到港时间 | string | 44447 |
relevanceCodeList.creator | 创建人 | string | admin |
relevanceCodeList.createdTime | 创建时间 | string | 2021/9/717:15:51 |
relevanceCodeList.payer | 物流费用支付方 | string | self |
relevanceCodeList.flagLogisticsFee | 是否录入预估费用 | string | 1 |
relevanceCodeList.flagSecondCostHedge | 是否录入实际物流费用 | string | 1 |
relevanceCodeList.memo | 备注 | string | |
relevanceCodeList.box | 箱数 | string | |
relevanceCodeList.shipmentDate | 实际发货时间 | string | 44447 |
relevanceCodeList.actualArrivalDate | 实际到达时间 | string | |
relevanceCodeList.diffHandlerId | 差异处理人id | string | |
relevanceCodeList.diffHandler | 差异处理人 | string | |
relevanceCodeList.diffHandleTime | 差异处理时间 | string | |
relevanceCodeList.fbaWarehouse | 是否是FBA仓库 | string | |
relevanceCodeList.cnWarehouse | 是否是国内仓库 | string | |
relevanceCodeList.forecastLogisticsCurrency | 预估物流费用币种 | string | CNY |
relevanceCodeList.isShipment | 关联单据Shipment | string | 1 |
relevanceCodeList.flCodeList | 头程单号集合 | string | [“FL2109070001”] |
relevanceCodeList.shipmentIdList | 货件id集合 | array | [“FBA2A7B1581”] |
relevanceCodeList.shipmentIdList.itemVOList | 详情 | string | |
relevanceCodeList.shipmentIdList.spiltTrackings | 分割跟踪号集合 | string | |
relevanceCodeList.shipmentIdList.dlBusinessType | 物流商编号 | string | WLS001 |
relevanceCodeList.shipmentIdList.dlBusinessName | 物流商名称 | string | 积加ERP-物流商001 |
relevanceCodeList.shipmentIdList.etaRedFlag | 离港红标志 | string | 1 |
relevanceCodeList.shipmentIdList.cancelActualFee | 是否允许撤回实际费用 | string | 1 |
relevanceCodeList.shipmentIdList.customsClearance | 清关地 | string | |
relevanceCodeList.shipmentIdList.isDealDiffQty | 是否需要处理收发差异 | string | 1 |
金蝶云星空接口明细
- API:batchSave
- NAME:其他应付单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
---|---|---|---|
FBillTypeID | 单据类型 | QTYFD01_SYS | 单据类型 |
FBillNo | 单据编号 | SJYF{{trackings}} | 单据编号 |
FDATE | 业务日期 | {{actualAmountTime}} | 业务日期 |
FCONTACTUNITTYPE | 往来单位类型 | BD_Department | 往来单位类型 |
FCONTACTUNIT | 往来单位 | 001 | 往来单位 |
FCURRENCYID | 币别 | actualCurrencyCode | 币别 |
FNOTSETTLEAMOUNTFOR | 未借款金额 | 未借款金额 | |
FSETTLEORGID | 结算组织 | 100 | 结算组织 |
FPAYORGID | 付款组织 | 100 | 付款组织 |
FRemarks | 备注 | 备注 | |
FMAINBOOKSTDCURRID | 本位币 | CNY | 本位币 |
FEXCHANGETYPE | 汇率类型 | HLTX01_SYS | 汇率类型 |
FNOTAXAMOUNT | 不含税金额本位币 | 不含税金额本位币 | |
FTAXAMOUNT | 税额本位币 | 税额本位币 | |
FACCNTTIMEJUDGETIME | 到期日计算日期 | {{actualAmountTime}} | 到期日计算日期 |
FCancelStatus | 作废状态 | 作废状态 | |
FBUSINESSTYPE | 业务类型 | T | 业务类型 |
FHisLoanBalanceFor | 历史借款余额原币 | 历史借款余额原币 | |
FPRESETTEXT1 | 预设文本字段1 | 预设文本字段1 | |
FPRESETTEXT2 | 预设文本字段2 | 预设文本字段2 | |
FEntity | 单据明细 | 单据明细 | |
FEntity.FCOSTID | 费用项目编码 | FYXM02_SYS | 费用项目编码 |
FEntity.FCOSTDEPARTMENTID | 费用承担部门 | 001 | 费用承担部门 |
FEntity.FEntryTaxRate | 税率(%) | 税率(%) | |
FEntity.FNOTAXAMOUNTFOR | 不含税金额 | {{actualAmount}} | 不含税金额 |
FEntity.FTAXAMOUNTFOR | 税额 | 税额 | |
FEntity.FTOTALAMOUNTFOR | 修改携带量 | 修改携带量 | |
FEntity.FCOMMENT | 备注 | 备注 | |
FEntity.FSourceBillNo | 源单编号 | 源单编号 | |
FEntity.FCREATEINVOICE | 已生成发票 | 已生成发票 | |
FEntity.FIVAmountFor | 已开票金额 | 已开票金额 | |
FEntity.FormId | 业务对象表单Id | AP_OtherPayable | 必须填写金蝶的表单ID如 |
FEntity.Operation | 执行的操作 | BatchSave | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统打通概况
采集并引入全业务、多终端、多形态的数据,经过处理以及对应平台接口的数据结构适配,形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施,将沉淀的业务数据进入到平台进行体系化的加工,再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。