订货宝打通金蝶、用友、管家婆、速达等ERP接口说明及注意事项

订货宝打通金蝶、用友、管家婆、速达等ERP接口说明及注意事项

商品档案操作说明及注意事项

商品档案的传递是从ERP传递到订货宝，包括商品的新增和更新

商品新增是指订货宝没有的商品，从ERP新增后传递到订货宝上；

商品更新是指对已经传递到订货宝的商品，修改了ERP上该商品的信息，更新订货宝上对应商品信息

订货宝商品档案的以下红框内容可以通过接口程序上传 ：

基础信息部分

对接信息说明：

上述内容能对接的前提是ERP软件中有能对应的数据

商品上传后，默认是上架状态

商品分类对应说明：如果客户要按照ERP分类做对应，则不能在订货宝对上传的分类做任何改动和新增。建议客户不做分类对应，这样更能利用订货宝灵活的分类操作，随时调整分类，便于查找商品。不对应分类的时候，商品默认传递到订货宝的默认分类中

价格说明：客户对应等级价或指定价后，在ERP更新了价格，同步到订货宝的速度会比较慢，尤其是指定价，一般不建议客户通过修改ERP的指定价来更新订货宝指定价，而是直接在订货宝修改指定价

订货宝的大单位价格=小单位价格*换算关系，不能直接指定大单位价格

商品更新的内容默认是：编码、名称、商品型号，如果客户需要从接口更新的内容不止默认内容，需要客户提供具体内容，比如价格、单位等。

多规格档案不支持更新

商品从ERP删除，不会自动删除订货宝上的商品

商品从订货宝删除，不会自动删除ERP上的商品

对接后，商品档案的操作注意事项：

商品档案都在ERP 软件上新增，必须是通过新增的方式而不是在原来已有的商品档案中修改名称或编码作为新商品

商品规格值ERP软件上新增，不能在订货宝新增、修改

新增的商品都有唯一编码，编码只支持数字及英文，不支持中文，并且都有计量单位

商品名称不能超过50个中文字

商品支持6个自定义字段对接，最长不超过40个字

商品规格名称不超过8个字符，并且名称不能重复

商品子规格名称不超过20个字并且名称不能重复

上述对接内容均不能包括如下符号： ’   ‘’   < >   \   +

在订货宝对商品编码、名称、分类等修改不影响订单传递

客户档案操作说明及注意事项

客户档案的传递是从ERP传递到订货宝，包括客户的新增和更新

客户新增是指订货宝没有的客户，从ERP新增后传递到订货宝上，不支持订货宝新增传递到ERP上；

客户更新是指对已经传递到订货宝的客户，修改了ERP上该客户的信息，更新订货宝上对应客户信息

订货宝客户档案的以下红框内容可以通过接口程序上传 ：

基础信息部分

对接信息说明：

上述内容能对接的前提是ERP软件中有能对应的数据

客户上传后，默认是已审核状态

客户在ERP上必须填手机号，默认是在ERP客户档案中明确表明了手机号或移动电话的地方，比如下图有手机，有电话，默认是填在手机中。如果客户没有填写在对应位置，或者客户ERP中根本没有手机或移动电话栏，则需要和客户沟通来确定填写位置

手机号必须是1开头的11位数字，不能有其他任何符号，在ERP的客户档案中不能有重复的手机号

ERP上客户编码不能重复，如果客户自己自订货宝注册情况，这ERP上客户编码不能和订货宝客户编码重复

客户名称不能超过31个中文字

客户类型默认不做对应，客户有需要则根据客户ERP的实际情况做对应

ERP的客户分类默认对应归属地区

客户地址只能上传详细地址栏，不能上传省市区一级的行政地区，及只支持上图地址箭头所指栏

如果没有地址，则在订单审核时会提示填写地址

客户更新的内容默认是：编码、名称，如果客户需要从接口更新的内容不止默认内容，需要客户提供具体内容，比如联系人，地址等。

对接后，客户档案的操作注意事项：

客户档案都在ERP 软件上新增，必须是通过新增的方式而不是在原来已有的客户档案中修改名称或编码作为新客户

如果客户允许在订货宝直接注册客户，则注册后的客户档案必须在ERP中手工添加，添加的时候手机号必填和客户注册账号一致，并且编码不能和订货宝已有客户编码重复

自主注册的客户在于ERP对应之前，在订货宝客户列表前面没有绿点，对应后才会有绿点

如果已经同步到订货宝的客户想修改登录账户号，只能用已经上传的账号登录订货宝，修改号码，接口不支持同步修改账号。客户信息一旦上传订货宝，在ERP中修改手机号是不会同步修改订货宝的号码的

如果客户信息已经同步到订货宝了，但是该客户自己又用新号码在订货宝注册了，并且客户要用新号码不用老号码，则需要重新对应该客户信息。步骤如下

首先将ERP上该客户的手机号改成客户自己注册的号码

点开接口软件，点击系统信息下拉菜单的数据处理按钮，如下图

3）在数据处理页签中，见下图，双击客户档案，在右下栏看到有客户信息后，输入客户在ERP中的编码或名称，点查询，查询出来有对应客户后，点击清空数据传递，接口则会重新上传该客户信息

将订货宝中，原来同步的客户信息停用，删除，如果已有订无法删除，则停用

上述对接内容均不能包括如下符号： ’   ‘’   < >   \   +

在订货宝对客户编码、名称、类型，地区等修改不影响订单传递

客户从ERP删除，不会自动删除订货宝上的客户

客户从订货宝删除，不会自动删除ERP上的客户

库存及仓库信息说明

库存数据的传递是将ERP的实际库存，传递到订货宝的实际库存

有些ERP有类似订货宝的可售库存和实际库存的区别，接口都是传递的实际库存，不会传递ERP上的可售库存。

ERP上任何引发库存变动的操作，都会导致库存的传递，比如线下销售，盘点，采购入库等业务，所以如果有线下操作的话，容易导致可售库存过低，建议客户都在订货宝下单，或者在ERP上单独为订货宝的商品建立仓库，以区分线下业务库存。

库存数据是按照订货宝小单位的在ERP的库存数据，进行传递。

3、默认是传递ERP全部仓库的库存汇总数据到订货宝默认仓库，客户可以根据实际情况指定传递库存的仓库

4、如果客户的业务不要求他们的客户只能从指定仓库订货、发货，则不需要做仓库的对接。比如客户的商品可以从任何仓库发货，不会指定某些客户的订单只从某个仓库发货，这不需要对接仓库，也不需启用多仓库功能

5、库存可以不对接，直接从订货宝做入库或者开启负库存

6、仓库默认不做对接，需要的话单独和客户沟通，如果需要对接仓库，则客户不能在订货宝建仓库，只能通过接口传递，订货宝的默认仓库不会有库存数据

订单传递

订单传递是指将订货宝的订单传递到客户ERP的销售订单中

默认订货宝的订单在审核后，传递到订货宝，如果客户需要在订货宝做出库、发货，可以配置成在做完出库或发货操作，甚至收货后，再传递订单到ERP，该操作客户无法配置，只能告知我们，我们在后台配置

订单一旦传递，不会自动传递第二次，如果客户在订货宝审核后，订单传递到了ERP，客户在订货宝取消审核修改订单，再次审核后，订单不会再次传递

订货宝订单的以下红框内容可以通过接口程序获取 ：

对接信息说明：

ERP的订单所需要的信息往往比订货宝多，并且客户的订单很多都有自定义内容，所以订单的传递必须结合客户的实际情况调试，上图能获取到的内容，如果ERP有相对应的内容，这可以传递，如果没有则不会传递，也可以和客户沟通确定传递内容

赠品部分，如果ERP有赠品标志则会显示赠品，如果没有，这ERP的赠品单价为0

商品的数量、单价都是按订货宝小单位为依据获取的，如果客户需要在ERP改变订单商品的单位，则可能出现小数位数，导致尾差

特批价、优惠券等在订单总额基础上的优惠金额，只能作为备注信息传递给ERP，不能作为订单金额参与ERP订单的计算，即有优惠的订单传递到ERP后，金额是原价，优惠金额只能以备注的方式显示，除非客户ERP也有类似的优惠功能

对接后，订单的操作注意事项：

订单传递到ERP后，如果从ERP删除了，不会自动再传，如果客户需要，可以从订货宝添加一张一样内容的订单，传递到ERP后，再从订货宝删除订单，或者联系我们在接口后台重新传递订单

订单从ERP删除，不会自动删除订货宝上的订单

订单从订货宝删除，不会自动删除ERP上的订单

订单传递到ERP后，可以继续在订货宝取消审核，修改订单，但是修改后的订单不会在传递到ERP中

订单传递容易受客户操作、数据库、网络环境影响，导致传递不完整或出现重复订单（此种情况不常见，但无法排除），或者越来越慢的情况，一旦出现，立即联系我们，根据客户具体情况进行处理和优化