金蝶云星空集成
一、初始化设置
1.账号授权
建议使用administrator账号授权，不同账号、账套id之间的数据进行隔离，切换账号或账套后不保留原基础资料和配对关系。
（1）第三方系统登录授权
金蝶公有云新租户（V8.1版本，且2022年11月29日后开通），必须选择第三方系统登录授权的方式。
其他版本，优先推荐使用第三方系统登录方式授权。
获取授权信息指引文档：请咨询实施顾问。
（2）账号密码授权
账号授权字段的获取路径：请咨询实施顾问。
-
访问地址 ： 站点地址；
-
数据中心ID ： 帐套Id；
-
登录账号 ： 用户名（建议使用Administrator授权）；
-
登录密码 ： 对应的金蝶账号登录密码。
2.参数配置
（1）基础资料维护
①首次初始化同步：账号授权后，默认自动同步金蝶所有【已审核状态】的物料、客户、供应商、银行账号、仓库和组织资料。
②后续同步：后续按基础资料【审核时间】增量更新。
点击【同步】，支持手动同步金蝶基础资料；【基础资料同步设置】，可设置需要同步基础资料的组织，并支持开启自动同步、自动配对。
③可能需手动在金蝶新增的基础资料（FBA移除、盘库、调仓相关，如果不会用到就不用新增）：
详情请咨询实施顾问协助
新增并审核成功后，需点击基础资料【同步】，否则系统无法检测到是否有新建成功（不会显示在列表，做了自动隐藏操作）。
（2）单据状态设置
指推送单据至金蝶的状态，可根据业务需求配置为暂存、保存、已审核。
若无特殊业务需求，建议设置为【保存】或【已审核】，金蝶【暂存】接口易出错。
配置为【已审核】时，由于金蝶某些配置限制，可能不允许从接口自动审核，此时则需要手动完成审核。
（3）单据内容设置
-
全局
①支持配置固定批号推送
②支持配置FBA部分单据的推送规则，默认规则为按订单推送
可根据业务需要，将其配置为按单、按天、按月。
如需切换，操作指引请咨询售后顾问。（如无业务需求，请勿随意切换规则，避免数据混乱）
按单：即按亚马逊源流水推送，不做数据合并处理，基本上是一条流水推送为一张单据
按天：根据特定的条件，对天维度的数据进行合并后推送为一张单据。—— 当日数据最早于次日推送。任务运行中存在数据对比的补推逻辑，请勿随意修改金蝶单据数据，影响数据准确性
按月：根据特定的条件，对月维度的数据进行合并后推送为一张单据。—— 当月数据最早于次月3日推送，选择该月任意一天将创建该月整月的数据。任务运行中存在数据对比的补推逻辑，请勿随意修改金蝶单据数据，影响数据准确性
-
销售
可配置销售出库单的[单价]取值来源：
-
采购
-
库存
-
财务
根据业务需求选择应收模式：
①对接店铺月利润报表（默认选项）
店铺每月利润报表，按月推送一张费用应收单；
初始化时，会自动新增费用项目到金蝶，并自动审核（如果切换模式的话，可以将利润报表模式下推送的费用编码可以选择删除，也可以不删，对推单没影响）。
②对接结算中心结算明细
- 销售出库的结算数据推送标准应收单，支持标准应收与销售出库勾稽；
- 非销售出库的结算数据推送费用应收单。
若从利润报表模式切换到结算明细模式，由于两个模式费用项目编码不一样，所以切换模式后，需点击同步基础资料，接口自动推送新版的费用项目编码和名称至金蝶，并自动审核。
无特殊业务需求，请勿随意切换，避免新增不必要的费用编码和应收数据至金蝶。
3.同步模式
考虑FBA数据变动，对于当月FBA签收、串票、负数签收、未发货业务，最早可于次月6号推送。FBA盘库、移除、调仓业务为延迟5天进行推送。
（1）手动同步
根据选择对应单据和单据时间创建任务，手动推送单据。
不同单据的单据时间对应说明：
详情请咨询实施顾问。
（2）自动同步
自动同步规则设置：可以根据业务需要，设置自动同步的频率和同步区间。
详情请咨询实施顾问。
（3）数据导出
在任务列表支持批量导出任务详情
二、单据对接流程
1.销售
（1）销售订单→销售出库单
根据站点发货时间，按店铺+订单+按天维度推送发货流水。
（2）退货订单→销售退货单
根据站点退货时间进行推送。
2.采购
支持两种模式，一种是在领星走采购，推送到金蝶，一种是在金蝶走采购，拉回领星。
设置路径：参数配置 → 同步设置 → 单据内容 → 采购推送配置
（1）金蝶采购
①采购计划【待采购】→ 采购申请单
采购计划推送非必须，直接在金蝶走采购订单和采购入库单也支持同步回领星。
支持配置按组合商品推送或按单品推送采购申请单：
按子件推送时，供应商字段携带优先级：子件的默认供应商（产品管理-产品详情-供应商报价）＞采购计划组合商品所选供应商＞空。
②（金蝶）采购订单（金蝶）【已审核】→ （LX）采购单【待到货】
同步逻辑：基于采购方配对的基础资料的组织，其他基础资料映射无误时，将同步该组织的所有采购单。
采购仓库：[默认仓库]，后续入库单仓库不一致时，自动走采购变更单，但仅支持首次入库时变更一次，存在到货记录后不可变更，后续仓库不一致时无法同步入库单。
采购方：（a）多组织模式下，采购方为金蝶采购订单的【采购组织】在领星采购方配对中映射的【采购方】；
（b）单组织模式下，采购方为领星系统维护的 【默认采购方】，路径（设置-业务配置-采购-采购方）。
从金蝶同步回领星的采购单，默认不支持在领星手动到货、手动入库（可在配置中打开），不支持手动变更。
③（金蝶）采购入库单【已审核】→ （LX）入库单【已完成】
同步逻辑：源单（采购订单）已成功同步至领星系统时，将自动反写采购订单号，实现与采购单关联。
金蝶采购订单下推入库单，则入库单同步回领星时，只受 仓库 的配对关系影响，不涉及采购组织、收料组织、需求组织的配对关系。
仅支持同步存在上游采购订单的采购入库单，且同步采购入库单前，需先将采购订单同步回领星。
④（金蝶）采购单变更→（LX）[已处理]采购变更单
推送逻辑：按金蝶采购单的变更日期创建推送任务，抓取已审核状态的金蝶采购订单，以最新的采购单版本内容进行变更，拉取到领星生成已处理的采购变更单。
金蝶采购订单每次变更成功后，单据的变更时间和版本号都会更新，会覆盖掉旧的记录，不是每一个变更的版本都会同步回领星生成一张变更单。因此，生成领星变更单的内容取决于变更任务的同步当前时点与上一时点之间的变更内容。
举例说明：
采购单CGDD0001， 第1次变更-版本号V001，未同步领星
第2次变更-版本号V002，拉取V002到领星时，领星变更单的变更内容=V001+V002的累加结果。
采购单CGDD0002， 第1次变更-版本号V001，未同步领星
第2次变更-版本号V002，未同步领星
第3次变更-版本号V003，拉取V003到领星时，领星变更单的变更内容=V001+V002+V003的累加结果。
第4次变更-版本号V004，未同步领星
第5次变更-版本号V005，拉取V005到领星时，领星变更单的变更内容=V004+V005的累加结果。
变更版本号是自增的，未变更时为V000，变更一次V001，变更二次V002，因此，建议客户请使用金蝶自动生成的版本号，不要擅自修改。
（2）领星采购
①采购单→采购订单
推送逻辑：按单据日期（采购单下单日期）[待到货]和[已完成]状态的采购单 推送到 金蝶的采购订单。
②采购入库→采购入库单
推送逻辑：按单据日期（入库单入库日期） 采购入库类型的采购入库单 推送到 金蝶的采购入库单（手工创建的无上游采购单的采购入库单也支持推送）。
推送时，可以在参数配置中设置是否需要与上游采购订单进行关联。
③采购变更单→ 金蝶采购订单新变更单[已审核且生效]
推送逻辑：根据领星采购变更单变更日期创建任务，同一采购单的已处理状态的采购变更单，按变更日期顺序先后推送到金蝶生成采购订单新变更单已审核状态且自动生效。
推送变更单将自动审核且生效，由于金蝶采购单关联已生效的采购订单变更单后则不允许再作废、反审核或删除采购订单，因此，如不符合业务需求，请谨慎使用变更单对接。
1）如果要使用采购变更对接，需在金蝶将变更参数调整为，启用订单新变更单对接。
2）推送到金蝶的采购订单新变更单将自动从接口审核并生效，不支持配置为其他单据状态（如果有从接口审核失败、生效失败的情况，需手动在金蝶完成后方可推送后续变更单）。
对于同一采购单下的多个变更单按照变更顺序推送。如果前一张自动生效失败/推送失败，则后续变更单都不支持推送。需要手动在金蝶生效后，再推送后续变更单。
3）需推送采购单后，方可推送采购变更单
4）金蝶采购订单不支持供应商与采购组织变更。如果变更单字段中会涉及到供应商和采购组织时将自动过滤该字段。如果客户需要做供应商和采购组织变更，必须在采购单没有任何关联单据前，自行在金蝶反审核采购单后修改，或者删除重推。
5）金蝶采购订单关联了变更单后，变更单生效后不可回退，不可删除，金蝶也不允许再作废采购单（如果不能接受，请谨慎使用变更单对接）
3.库存
-
FBA业务
分仓模式：数据取值于【财务-存货核算-成本流水】（来源为库存分类账）。
共享仓模式：2月1号之前的数据取自亚马逊签收、盘库、库存动作详情等各报表；2月1号之后的数据取自【财务-存货核算-成本流水】（来源为库存分类账）。
为了统一数据源，推荐新对接客户都使用分仓模式。如需在金蝶做共享仓管理，也可通过领星多FBA仓库配对金蝶一仓库来实现。
（1）FBA发货单→分布式调出单
推送“已发货”状态的发货单，新增金蝶分布式调出库单；
建议在货件签收前，及时生成“已发货”状态的发货单，避免先发货已签收后，再后补【已发货】发货单。
（2）FBA正常签收
成本管理-成本流水—FBA补货入库、FBA途损补回。（不推送发货途损）。
数据核对：指定单据日期范围内，金蝶的分布调入单（FBA签收的）与成本中心（FBA补货入库、FBA途损补回）类型的流水核对。
（3）FBA无源单签收
数据来源：成本管理-成本流水—FBA补货入库（无发货单）。
（4）FBA负数签收
成本管理-成本流水—FBA补货出库。
数据核对：指定单据日期范围内，金蝶的直接调拨单或其他出库单（单据备注=FBA负数签收）与成本中心（FBA补货出库）类型的流水核对。
（5）FBA串票（超收）
成本管理-成本流水—FBA超签入库。
数据核对：指定单据日期范围内，金蝶的直接调拨单或其他入库单（单据备注=FBA串票）与成本中心（FBA超签入库）类型的流水核对。
（6）FBA盘库
成本管理-成本流水—FBA盘点入库、FBA盘点出库。
数据核对：指定单据日期范围内，金蝶的其他入库单或其他出库单（备注=FBA盘库）分别与成本中心（FBA盘点入库或FBA盘点出库）类型的流水核对。
（7）FBA移除
成本管理-成本流水—FBA移除。
数据核对：指定单据日期范围内，金蝶的直接调拨单（备注=FBA移除）与成本中心（FBA移除）类型的流水核对。
（8）FBA调仓
-
调仓出库→直接调拨单
-
有源调仓入库→直接调拨单
-
无源调仓入库→其他入库单
创建调仓在途仓：运行调仓任务时，接口自动新增已审核状态的调仓在途仓。
特殊情况，由于金蝶权限问题接口可能自动创建失败或者审核仓库失败，请按照对应规则在金蝶手动添加仓库或手动审核仓库。
手动创建规则：请咨询实施顾问。
需要手动录入FBA调仓在途仓的期初库存，否则可能会出现推送有源单的调仓入库时，由于FBA调仓在途仓无库存可调出，导致直接调拨单由于负库存而无法审核。
①FBA调仓出库-直接调拨单
推送逻辑：按天+按相同唯一键的 调仓出库 流水 推送为直接调拨单（调出仓 FBA调仓在途仓并审核 ）
数据核对：指定单据日期范围内，金蝶的直接调拨单（备注=FBA调仓出库）与成本中心（FBA调仓出库）类型的流水核对，数量一致，行数一致。
②FBA有源单调仓入库-直接调拨单
推送逻辑：按天+按相同唯一键的 调仓出库 流水 推送为直接调拨单（调出仓 FBA调仓在途仓并审核 ）
数据核对：指定单据日期范围内，金蝶的直接调拨单（备注=FBA调仓入库）与成本中心（FBA调仓入库，成本来源=源单成本）类型的流水核对，数量一致，行数一致。
③FBA无源单调仓入库-其他入库单
推送逻辑：按天+按相同唯一键的 无源单调仓 流水 推送为其他入库单（调出仓 FBA调仓在途仓并审核 ）
数据核对：指定单据日期范围内，金蝶的其他入库单（备注=FBA无源单调仓）与成本中心（FBA调仓入库，成本来源≠源单成本）类型的流水核对，数量一致，行数一致。
（9）FBA负库存调整
推送逻辑：成本管理-其他-FBA负库存数量调整，按仓库+按天汇总推送一张 其他入库单，每张单据最多一千行，超过后会拆分单据。
数据核对：指定单据日期范围内，金蝶的其他入库单（备注=FBA负库存调整）与成本管理（FBA负库存调整）类型的流水核对。
①由于是按天+仓库汇总推送，每张单据最多推送1000条数据。超过则拆成多张推送。
②由于是按天+仓库汇总推送，无法记录每张单据内容，无法知道单据内容是否发生变化。因此，若该仓库已存在负库存调整的单据，但有最新的数据需要重新推送时，需要先删除金蝶的旧单据。
③考虑到数据变动因素，次月6号才允许推送上月的负库存调整
(10)FBA对账差异
推送逻辑：成本管理-期初库存-FBA对账差异入库调整、FBA对账差异出库调整，按仓库+按天汇总推送一张 其他入库单/其他出库单。
数据核对：指定单据日期范围内，金蝶的其他入库单/其他出库单（备注=FBA对账差异）与成本管理（FBA对账差异入库调整、FBA对账差异出库调整）类型的流水核对。
①成本管理的对账差异业务的单据时间为次月第一天，而推送金蝶的单据日期为每月最后一天，创建推送任务时也请选择每月的最后一天。
②由于是按天+仓库汇总推送，每张单据最多推送1000条数据。超过则拆成多张推送。
③由于是按天+仓库汇总推送，无法记录每张单据内容，无法知道单据内容是否发生变化。因此，若该仓库已存在对账差异的单据，但有最新的数据需要重新推送时，需要先删除金蝶的旧单据。
④考虑到数据变动因素，次月6号才允许推送上月的对账差异。
-
本地业务
（1）海外仓备货→分布式调拨单
如需领星推送海外仓收货记录，则请勿自行手动在金蝶云星空建 分布式调入单关联推送过去的分布式调出单，会导致后续推送数据失败。
推送逻辑：
海外仓备货单【待收货】【已完成】→ 分布式调出单
海外仓备货单【待收货】【已完成】状态的收货记录 → 分布式调入单
海外仓备货单撤销的已推送过的收货部分 → 直接调拨单
海外仓备货单撤销未推送过的部分 →分布式调出单（退货）
（2）调拨单【已完成】→直接调拨单
（3）加工单（拆分）【已完成】→组装拆卸单（拆卸）
（4）加工单（加工）【已完成】→组装拆卸单（组装）
4.财务
支持两种应收模式，可根据业务需要进行切换。路径：云星空集成-参数配置-单据内容-财务
（1）收款单
数据取值：财务-亚马逊结算中心-结算汇总-已转账状态
（2）应收单
详情请咨询实施顾问
①财务报表→应收单
推送内容：平台收入、平台支出和税费，推送维度为利润报表的二级子项。
②结算明细→应收单
推送到金蝶应收单的完整项目编码，文档请联系实施顾问获取。
- 标准应收单：
结算明细可归属于销售出库类型的结算流水，每一笔明细金额都按映射规则映射为summary项目，记录在标准应收单的备注。
①结算与发货相匹配的结算流水（结算类型=已发货xx月已结算）：推送金蝶时支持勾稽上游金蝶销售出库单。
②结算与发货未匹配的结算流水（结算类型=未发货已结算）：推送金蝶时无法勾稽上游金蝶销售出库单。
建议次月推送并核对完上月的销售出库单后，再手动推送应收单，能够最大程度保持推送数据稳定，减少后期核对和推送工作量。
- 费用应收单
数据取值：结算明细除已归属于销售出库类型外的结算流水，每一笔明细金额都按映射规则映射为summary项目，记录为费用应收单的费用项目。
- 应收和收款核销
自动核销：支持同一账期内的应收和收款按支持相同结算编号核销。
三、常见问题
（1）账号授权类
Q1：取消授权账号后，重新授权，基础资料配对和相关配置会保留吗？
A1：如果授权账号+授权的数据中心id不变，则之前的基础资料配对关系仍会正常保留。否则，数据将重新拉取。
Q2：从账号登录方式切换到第三方登录授权方式，之前的基础资料会保留吗？
A2：只要授权账号+授权的数据中心ID不变，就算切换了授权登录方式，之前的配对关系也会保留。
Q3：一定要使用金蝶administrator账号授权吗？
A3：推荐使用金蝶administrator账号授权，避免其他账号权限受限。
（2）基础资料维护类
Q1：为什么在同步设置中勾选了【物料自动配对】，但实际上没有配对成功？
A1：可能是初始化同步回来的物料，目前初始化授权时同步回来的物料，没有触发自动配对，如果需要配对，可以在金蝶反审核物料，再审核，再点击同步回领星，触发自动配对。
Q2：SKU、本地仓库可以领星一对多金蝶配对吗？
A2：不支持。推送时找不到一对一推送关系。
Q3：金蝶一个物料可能分配到多个组织下，而多个组织都需要往金蝶推送单据，但SKU仅支持一对一配对怎么办？
A3：SKU配对任意一个组织的物料即可，获取配对关系时不会增加组织判断。
Q4：为什么在基础资料界面，搜索SKU搜不到？搜不到怎么配对？
A4：基础资料-商品界面仅支持搜索到已配对的SKU，如果需要配对，请点击商品操作行【配对】按钮，在SKU弹窗列表配对。
（3）单据推送类
Q1：为什么已经按要求在金蝶创建了在途仓、虚拟仓、客户等基础资料，推送单据时还是报错不存在或者推送后值为空？
A1：先确认在金蝶是否为已审核状态，确认后到领星点击基础资料【同步】，再重试任务即可。
Q2：为什么推送暂存状态的单据，任务显示成功但在金蝶却找不到单据？
A2：金蝶暂存接口可能不稳定。暂存后若金蝶无数据，也可以在参数配置-单据状态切换到[保存]后再推送，查看失败原因，针对原因进行调整。但如无特殊情况，建议不要推送暂存状态的单据。
Q3：为什么我设置了推送审核状态，但是提示我审核不一定成功，或者在金蝶处于审核中的状态？
A3：领星调用审核接口，审核是否成功，金蝶不会返回结果。受账号权限限制、任务数据量过大、金蝶处理超时等情况时，可能出现审核无法成功的情况，请联系金蝶人员协助解决或手工审核单据。
Q4：推送单据时提示不存在某币种，但已经在金蝶维护过了，怎么办？
A4：确认金蝶维护的币种名称是否和任务提示中的币种名称一致。若不一致，则改为一致后审核币种，并在领星点击基础资料【同步】，再重新推送任务。
Q5：推送采购入库单到金蝶，为什么没有关联上游采购订单？
A5：在参数配置-单据内容-采购中，将是否关联上游采购订单勾选为【是】。
Q6：创建推送任务时，单据时间应该怎么选？为什么金蝶采购入库单明明已审核，却同步不回来？
A6：采购入库单是按【审核时间】同步。不同任务单据的时间不一样，请根据【同步模式-单据时间对应说明】进行任务创建。
Q7：为什么任务一直处于待同步？
A7：任务池待执行任务过多，任务正在排队中。如果长时间未更新，请联系实施顾问。
Q8：推送单据时，报错xx字段需要必填怎么处理？
A8：非标准方案中所推字段，需要在金蝶取消该字段的必填。
Q9：推送单据时，报错单据体“明细信息”第1行字段“物料编码”是必填项，但物料已经维护了怎么办？
A9：1.仓库映射的组织和物料所在的组织不一致。2.检查下对应推送模型中的物料编码在金蝶是否勾选了 允许销售、允许采购、允许库存。
Q10：推送单据报错：更新库存出现异常情况,更新库存不成功!
A10：金蝶处理单据出错，重试任务几次即可。若持续还是无法解决，请联系金蝶实施协助处理。
Q11：为什么从金蝶同步回来的采购订单，在领星的仓库是默认仓库，或和采购计划选择的仓库/金蝶采购订单上的仓库不一致？
A11：由于金蝶采购订单没有仓库作为标准字段，而领星的【仓库】字段必填，因此 同步回领星时会自动赋值一个仓库默认值。当同步金蝶采购入库单时，如果实际入库仓和采购订单的仓库不一致，会对采购订单进行自动变更，将采购订单的仓库变更为和入库单的仓库一致，以入库单同步回领星后的仓库为准即可。
Q12：推送单据报错：上游xxx单据不存在/未审核，导致推送单据失败，怎么处理？
A11：先推送上游单据，或先去金蝶审核单据，再推送下游单据任务。
（4）数据核对类
Q1：为什么推送到金蝶数据和系统的数据不一致？怎么处理？
A1：亚马逊数据变动引起，可以选择次月在开始对账前手动推送数据，或将自动规则的同步区间调整为前7天-前7天或者前6天-前7天，这样可以更好的保持数据稳定。出现这种情况请删除单据，重新推送。
Q2：为什么次月推送数据，还是发现数据不一致，为什么？怎么处理？
A2：可能系统在次月对上月的数据进行了重采，导致了数据变动，一般是近5天的数据不稳定，但也有可能出现偶发重采的情况，超过这个时间范围时数据仍在变动。
Q3：为什么金蝶的FBA数据和系统一致，但和库存分类账对不上？
A3：仅支持将金蝶数据和系统数据核对，不支持直接和库存分类账核对。金蝶数据来源于成本流水，只能确认和成本流水的一致性，无法保证和库存分类账的一致性。如有此类疑问，请咨询成本管理模块。
未能解决你的问题？请联系在线客服