DBERP文档中心

# 商城绑定

需要系统设置中开启 商城服务，才可以看到该功能。

可以跟DBShop商城系统 或者 其他商城系统 对接，来同步订单信息、订单状态、订单商品。

# DBERP添加商城

商城类别： 分为 DBShop商城系统 和 其他系统 这里选择适合您的选项。如果是其他系统，需要编写对应的连接插件，可以根据官方提供的API自行编写。

商城名称： 无限制，填写您的商城名称。

appId： 可手动输入或者自动生成，与商城系统对接使用。

appSecret： 可手动输入或者自动生成，与商城系统对接使用。

商城地址： 您的商城地址。

商城绑定： 可以对订单商品进行绑定，根据选择商品编号还是条形码，可以与DBERP里的商品相对应。

商品发货仓库： 在商城订单发货时，商品从哪个仓库发货。

状态： 启用或者禁用商城绑定。

# DBShop商城系统设置

DBShop商城系统对接DBERP需要安装对接插件 https://docs.loongdom.com.cn/plugin/shop/dberp.html

# DBERP进销存连接商品后

当商城有订单提交或者订单变更时，信息会同步到DBERP系统中

这里的 匹配商品 根据 商品绑定 的配置匹配DBERP的商品信息。

# 其他商城整合API

参数 是否必填 说明
appId 是 连接配置中的 appId
action 是 方法名称，目前有六个方法
otherAddOrder、otherCancelOrder、otherDeleteOrder、otherPaymentOrder、
otherDeliverOrder、otherFinishOrder
dataStr 是 传递的订单信息，json格式
sign 是 签名，md5(dataStr .appSecret )

提交类型：POST

提交地址：您的DBERP进销存URL/api

下面是例子

$url      = "https://demo.dberp.com.cn/api";
$appId    = 'appId的值';
$appSecret= 'appSecret的值';
$dataArray= ['order'=>[], 'orderGoods'=>[], 'orderAddress'=>[]];
$dataStr  = json_encode($dataArray);
$postData = ['appId'=>$appId, 'action'=>'otherAddOrder', 'dataStr'=>$dataStr, 'sign'=>md5($dataStr.$appSecret)];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_exec($ch);

# 提交订单

方法名：otherAddOrder

$dataArray的值

$dataArray = [
    'order' => [
        'order_sn'     => '',	//订单编号，必填
        'buy_name'     => '',	//订单提交人，必填
        'payment_code' => '',	//支付方式编码，非必填
        'payment_name' => '',	//支付方式名称，非必填
        'payment_cost' => 0,	//支付手续费，必填，最小为0，可以是两位小数
        'express_code' => '',	//配送方式编码，非必填
        'express_name' => '',	//配送方式名称，非必填
        'express_cost' => 0,	//配送费用，必填，最小为0，可以是两位小数
        'other_cost'   => 0,    //其他费用，必填，最小为0，可以是两位小数
        'other_info'   => '',	//其他费用说明，非必填
        'discount_amount' => 0,//折扣优惠费用，必填，最小为0，可以是两位小数
        'discount_info'   => '',//折扣优惠费说明，非必填
        'goods_amount'    => 100.24,//商品总金额，必填
        'order_amount'    => 100.24,//订单总金额，必填
        'order_message'   => '',    //订单留言，非必填
        'add_time'        => time() //订单提交时间，时间戳【10位】，必填
    ],
    'orderGoods' => [
        0 => [
            'goods_name'  => '',//商品名称，必填
            'goods_spec'  => '',//商品规格，非必填
            'goods_sn'    => '',//商品编号或者条形码，必填
            'goods_price' => 50,//商品价格，必填
            'goods_type'  => 1, //商品类型，必填，1 实物商品
            'buy_num'     => 1, //购买商品数量，必填
            'goods_amount'=> 50 //商品金额，必填
        ],
        1 => [
            'goods_name'  => '',
            'goods_spec'  => '',
            'goods_sn'    => '',
            'goods_price' => '',
            'goods_type'  => 1,
            'buy_num'     => 1,
            'goods_amount'=> 50.24
        ] 
    ],
    'orderAddress' => [
        'delivery_name'	=> '',//收货人名称，必填
        'region_info'	=> '',//地区信息，非必填
        'region_address'=> '',//详细信息，必填
        'zip_code'		=> '',//邮政编码，非必填
        'delivery_phone'=> '',//收货人电话号码，必填
        'delivery_info'	=> ''//配送说明，非必填
    ]
];

# 取消订单

action方法名：otherCancelOrder

$dataArray的值

$dataArray = [
    'oper_time' => time(),//时间戳【10位】，必填
    'order_sn'  => ''     //订单编号，必填
];

# 删除订单

action方法名：otherDeleteOrder

$dataArray的值

$dataArray = [
    'oper_time' => time(),//时间戳【10位】，必填
    'order_sn'  => ''     //订单编号，必填
];

# 订单付款

action方法名：otherPaymentOrder

$dataArray的值

$dataArray = [
    'oper_time'   => time(),//时间戳【10位】，必填
    'order_sn'    => '',    //订单编号，必填
    'payment_code'=> '',    //支付方式编码，必填
    'payment_name'=> ''     //支付方式名称，必填
];

# 订单发货

action方法名：otherDeliverOrder

$dataArray的值

$dataArray = [
    'oper_time'       => time(),//时间戳【10位】，必填
    'order_sn'        => '',    //订单编号，必填
    'delivery_number' => '',    //快单号，必填
    'express_name'    => ''     //配送方式名称，必填
];

# 订单完成

action方法名：otherFinishOrder

$dataArray的值

$dataArray = [
    'oper_time' => time(),//时间戳【10位】，必填
    'order_sn'  => ''     //订单编号，必填
];

← 服务绑定 →