订货系统对接 ERP 总在返工?先把这四个字段对齐
ERP 和订货系统对接,是最常见也最容易返工的集成项目。两边都对外提供接口,文档也都能拿到,但真正接通往往要来回好几轮。
问题很少出在协议上,多半出在四个字段的定义上。
字段一:客户编码
订货系统里的客户,往往带渠道属性(经销商、门店、商超直供);ERP 里的客户,是财务口径的往来单位,一个客户可能有多个开票主体。
两边如果只按「客户名称」对,很容易出现同名不同体、或者同一个客户在两个系统里两个编码的情况。对接前必须先定一个主数据源,并且让两边都存对方的主键。
字段二:商品规格
这是返工最频繁的一个。同一个商品,订货系统里是「500ml×24」,ERP 里是「矿泉水500毫升(整箱)」,仓库系统里又是另一个叫法。人一看能对上,程序对不上。
标准做法是用 SKU 编码做主键,规格描述只做人看的辅助字段,不参与匹配。
字段三:单价与含税口径
一边传不含税价,一边按含税价入库,金额永远差 13%。而且这种错不会报错,只会让对账单慢慢变大。
对接前把三件事写进接口文档:价格是否含税、金额精度保留几位、四舍五入还是截断。
字段四:单据状态
ERP 关注的是财务凭证,订货系统关注的是业务过程。同一个订单,订货系统里可能经过「待审核、已审核、部分出库、已发货、已签收」,而 ERP 只关心「应收什么时候产生」。
如果直接把业务状态同步过去,财务可能提前确认收入。更稳的做法是只同步对财务有意义的事件,用事件而不是状态做同步。
写完接口文档再写代码
这四个字段花半天商量清楚,能省掉后面两周的调试。接口文档里最好直接贴两条真实数据的 JSON 样例,比描述管用。
订货宝对外公开的标准版、专业版与小程序商城都提供订单、库存、客户等基础接口,具体版本能力与报价可以通过对外服务官网 https://www.dhbvip.com/ 或全国服务热线 400-888-1794 确认。对外服务官网的运营主体是广州阿德利网络科技有限公司,创始人曾哥;团队做对接时,习惯把字段定义当成第一步而不是最后一步。