分销商标准接口开发文档 v2.4

{
    "otaId": 18654,
    "method": "trade.detail",
    "sign": "202cb962ac59075b964b07152d234b70",
    "timestamp": 1507986131,
    "body": "e1wib3RhT3JkZXJJZFwiOlwiMjAxNzAzMDEwMDAwMDFcIn0="
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {
        "otaOrderId": "20170301000001",
        "orderId": "201703010000012",
        "status": 1
    },
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

package com.yourpackage;

import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;

public class SignUtil {

    public static void main(String[] args) {
        String otaId = "1983";
        String secret = "xxxSecretxxx";
        String timestamp = System.currentTimeMillis() / 1000L + "";
        String body = "{\n" +
                "    \"orderId\": \"201703010000012\",\n" +
                "}";

        String sign = getSign(otaId, secret, timestamp, getBase64String(body));
        System.out.println(sign);
        //7344b388578a87837d3899f797a295bb
    }

    public static String getSign(String otaId, String secret, String timestamp, String body) {
        String combinedString = otaId + secret + timestamp + body;
        String sign = md5(combinedString);
        return sign;
    }

    /**
     * Md5加密
     *
     * @param str 待加密的数据
     * @return Md5加密后的结果
     */
    private static String md5(String str) {
        if (str == null) return "";

        MessageDigest messageDigest;
        try {
            messageDigest = MessageDigest.getInstance("MD5");
            messageDigest.reset();
            messageDigest.update(str.getBytes("UTF-8"));
        } catch (Exception e) {
            return "";
        }
        byte[] byteArray = messageDigest.digest();
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < byteArray.length; i++) {
            if (Integer.toHexString(0xFF & byteArray[i]).length() == 1)
                sb.append("0").append(Integer.toHexString(0xFF & byteArray[i]));
            else
                sb.append(Integer.toHexString(0xFF & byteArray[i]));
        }
        return sb.toString();
    }

    private static final char[] CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"
            .toCharArray();

    public static String getBase64String(String input) {
        String base64String;
        try {
            base64String = new String(encodeToChar(input.getBytes("UTF-8"), false));
        } catch (UnsupportedEncodingException ignore) {
            base64String = "";
        }
        return base64String;
    }

    private static char[] encodeToChar(byte[] arr, boolean lineSeparator) {
        int len = arr != null ? arr.length : 0;
        if (len == 0) {
            return new char[0];
        }

        int evenlen = len / 3 * 3;
        int cnt = (len - 1) / 3 + 1 << 2;
        int destLen = cnt + (lineSeparator ? (cnt - 1) / 76 << 1 : 0);
        char[] dest = new char[destLen];

        int s = 0;
        int d = 0;
        for (int cc = 0; s < evenlen; ) {
            int i = (arr[(s++)] & 0xFF) << 16 | (arr[(s++)] & 0xFF) << 8 | arr[(s++)] & 0xFF;

            dest[(d++)] = CHARS[(i >>> 18 & 0x3F)];
            dest[(d++)] = CHARS[(i >>> 12 & 0x3F)];
            dest[(d++)] = CHARS[(i >>> 6 & 0x3F)];
            dest[(d++)] = CHARS[(i & 0x3F)];

            if (!lineSeparator) continue;
            cc++;
            if ((cc == 19) && (d < destLen - 2)) {
                dest[(d++)] = '\r';
                dest[(d++)] = '\n';
                cc = 0;
            }
        }

        int left = len - evenlen;
        if (left > 0) {
            int i = (arr[evenlen] & 0xFF) << 10 | (left == 2 ? (arr[(len - 1)] & 0xFF) << 2 : 0);

            dest[(destLen - 4)] = CHARS[(i >> 12)];
            dest[(destLen - 3)] = CHARS[(i >>> 6 & 0x3F)];
            dest[(destLen - 2)] = (left == 2 ? CHARS[(i & 0x3F)] : '=');
            dest[(destLen - 1)] = '=';
        }
        return dest;
    }
}

{
    "otaId": 1711,
    "method": "trade.create",
    "sign": "7b064dad507c266a161ffc73c53dcdc5",
    "timestamp": 1520590361,
    "body": "ewoJImN1cnJlbmN5IjogIkNOWSIsCgkib3RhT3JkZXJJZCI6ICJvcGVuYXBpLXRlc3QtMSIsCgkidXNlckluZm8iOiB7CgkJIm5hbWUiOiAic3VwZXJkYWRhIgoJfSwKCSJjb250YWN0SW5mbyI6IHsKCQkiY25OYW1lIjogIui+vui+viIsCgkJImVuTmFtZSI6ICJkYWRhIiwKCQkibW9iaWxlIjogIjE1OTExMDI4MjEyIiwKCQkiZW1haWwiOiAiMzc3NzMzMTJAcXEuY29tIiwKCQkicXEiOiAiMzc3NzMzMTIiLAoJCSJ3ZWNoYXRObyI6ICJ3eDM3NzczMzEyIgoJfSwKCSJyZW1hcmsiOiAi5b+r54K55Y+R6LSn5ZGXIiwKCSJzdWJPcmRlcnMiOiBbCgkJewoJCQkib3RhU3ViT3JkZXJJZCI6ICJvcGVuYXBpLXRlc3QtMS0xIiwKCQkJInByb2R1Y3ROYW1lIjogIuWkp+W6t+WuneS4gOaXpea4uCIsCgkJCSJudW0iOiAzLAoJCQkic2t1SWQiOiAiU3lwbmo1ZWQxIiwKCQkJInByaWNlIjogMTIwMDAsCgkJCSJ0cmlwU3RhcnREYXRlIjogIjIwMTgtMDMtMjYiLAoJCQkidG90YWxGZWUiOiAzNjAwMCwKCQkJInRyYXZlbGxlcnMiOiBbCgkJCQl7CgkJCQkJImVuTmFtZSI6ICJ6aGFuZ3NhbiIsCgkJCQkJImNuTmFtZSI6ICLlvKDkuIkiLAoJCQkJCSJnZW5kZXIiOiAxLAoJCQkJCSJtb2JpbGVDb2RlIjogIjg2IiwKCQkJCQkibW9iaWxlIjogIjE1OTExMDI4ODc3IiwKCQkJCQkiZW1haWwiOiAiMTIzMTIzMTIyM0BxcS5jb20iLAoJCQkJCSJjcmVkZW50aWFsTm8iOiAiYXNkZmFzZDIzNDI0MjMiLAoJCQkJCSJjcmVkZW50aWFsVHlwZSI6IDEKCQkJCX0sCgkJCQl7CgkJCQkJImVuTmFtZSI6ICJsaXNpIiwKCQkJCQkiY25OYW1lIjogIuadjuWbmyIsCgkJCQkJImdlbmRlciI6IDEsCgkJCQkJIm1vYmlsZUNvZGUiOiAiODYiLAoJCQkJCSJtb2JpbGUiOiAiMTg2OTk4ODc3NjYiLAoJCQkJCSJlbWFpbCI6ICI0MjM0MjM0MkBxcS5jb20iLAoJCQkJCSJjcmVkZW50aWFsTm8iOiAiMjM0YXNkZmEiLAoJCQkJCSJjcmVkZW50aWFsVHlwZSI6IDEKCQkJCX0sCgkJCQl7CgkJCQkJImVuTmFtZSI6ICJ3YW5nd3UiLAoJCQkJCSJjbk5hbWUiOiAi546L5q2mIiwKCQkJCQkiZ2VuZGVyIjogMiwKCQkJCQkibW9iaWxlQ29kZSI6ICI4NiIsCgkJCQkJIm1vYmlsZSI6ICIxMzg4ODk5Nzc2NiIsCgkJCQkJImVtYWlsIjogIjIzNHNkZmRzQHFxLmNvbSIsCgkJCQkJImNyZWRlbnRpYWxObyI6ICJhc2RmYWFkZiIsCgkJCQkJImNyZWRlbnRpYWxUeXBlIjogMQoJCQkJfSwKCQkJXQkJCQoJCX0KCV0KfQ=="
}

{
    "code": "SUCCESS",
    "data": {
        "orderId": "195069960801321",
        "otaOrderId": "openapi-test-2",
        "status": 1,
        "orderItems": [
            {
                "otaSubOrderId": "openapi-test-22",
                "voucherCodes": [
                    "yx9wzpwr",
                    "yx9wyz1r"
                ],
                "voucherStreams": [
                    "eyJvcmRlckl0ZW1zIjpbeyJvcmRlkiOjEsByaFVUzAxTzAwZDIwIn0="
                ]
            }
        ]
    },
    "msg": "成功",
    "requestId": "80abbe9ceebd4115894bec220906f7ad",
    "success": true
}

{
    "code": "SKU_NOT_EXIST_ERROR",
    "msg": "sku 编码错误",
    "requestId": "a0b60b0e3a734da79ce7662e58fbc593",
    "success": false
}

{
    "otaId": 1711,
    "method": "trade.detail",
    "sign": "7b064dad507c266a161ffc73c53dcdc5",
    "timestamp": 1520590361,
    "body": "ewoJIm90YU9yZGVySWQiOiAib3BlbmFwaS10ZXN0LTEiCn0="
}

{
    "code": "SUCCESS",
    "data": {
        "contactInfo": {
            "cnName": "达达",
            "email": "37773312@qq.com",
            "enName": "dada",
            "foreignAreaCode": "",
            "foreignMobile": "",
            "gender": 0,
            "mobile": "15911028212",
            "mobileCode": "",
            "postAddress": "",
            "qq": "",
            "wechatNo": "wx37773312",
            "zipCode": ""
        },
        "createTime": "2018-03-12 11:41:57",
        "currency": "CNY",
        "orderId": "195069960801321",
        "otaId": 1711,
        "otaOrderId": "openapi-test-2",
        "remark": "快点发货呗",
        "status": 1,
        "subOrders": [
            {
                "num": 3,
                "otaSubOrderId": "openapi-test-1-2",
                "price": 12000,
                "refunds": [],
                "skuId": "Sypnj5ed1",
                "specRound": "",
                "status": 1,
                "totalFee": 36000,
                "travellers": [
                    {
                        "cnName": "张三",
                        "credentialNo": "asdfasd2342423",
                        "credentialType": 1,
                        "email": "1231231223@qq.com",
                        "enName": "zhangsan",
                        "foreignMobile": "",
                        "foreignMobileCode": "",
                        "gender": 1,
                        "height": 0,
                        "mobile": "15911028877",
                        "mobileCode": "86",
                        "nationCode": "",
                        "qq": "",
                        "wechatNo": "",
                        "weight": 0
                    },
                    {
                        "cnName": "李四",
                        "credentialNo": "234asdfa",
                        "credentialType": 1,
                        "email": "42342342@qq.com",
                        "enName": "lisi",
                        "foreignMobile": "",
                        "foreignMobileCode": "",
                        "gender": 1,
                        "height": 0,
                        "mobile": "18699887766",
                        "mobileCode": "86",
                        "nationCode": "",
                        "qq": "",
                        "wechatNo": "",
                        "weight": 0
                    },
                    {
                        "cnName": "王武",
                        "credentialNo": "asdfaadf",
                        "credentialType": 1,
                        "email": "234sdfds@qq.com",
                        "enName": "wangwu",
                        "foreignMobile": "",
                        "foreignMobileCode": "",
                        "gender": 2,
                        "height": 0,
                        "mobile": "13888997766",
                        "mobileCode": "86",
                        "nationCode": "",
                        "qq": "",
                        "wechatNo": "",
                        "weight": 0
                    }
                ],
                "tripEndDate": "2018-03-26",
                "tripStartDate": "2018-03-26",
                "vouchers": [
                    "6pgg1rpv",
                    "zkyq5gd1",
                    "npzx51kv"
                ]
            }
        ]
    },
    "msg": "成功",
    "requestId": "e6be5968caca4b99bfdd18cd10816b46",
    "success": true
}

{
    "code": "ORDER_NOT_EXISTS",
    "msg": "订单号不存在",
    "requestId": "df890c70f6fb4b4eaab0659e99634c90",
    "success": false
}

{
    "otaId": 1711,
    "method": "trade.memo.add",
    "sign": "7b064dad507c266a161ffc73c53dcdc5",
    "timestamp": 1520590361,
    "body": "ewoJIm90YU9yZGVySWQiOiAib3BlbmFwaS10ZXN0LTIiLAoJInNlbGxlck1lbW8iOiAi5bC95b+r5Y+R6LSnIgp9"
}

{
    "code": "SUCCESS",
    "msg": "成功",
    "requestId": "fb4b7bdb68554678a2354426b4abee10",
    "success": true
}

{
    "code": "API_PARAM_ERROR",
    "msg": "备注内容不能为空",
    "requestId": "6fa4c7ff34fb4e20973bfd3dc0916936",
    "success": false
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {
        "otaModifyId": "1122",
        "modifyId": 121223,
        "modifyStatus": 1
    },
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

{
    "otaId": 1711,
    "method": "trade.refund.apply",
    "sign": "7b064dad507c266a161ffc73c53dcdc5",
    "timestamp": 1520590361,
    "body": "ewoJIm9yZGVySWQiOiAiMTk0ODMxMDM5MTc3NzY5IiwKCSJvdGFPcmRlcklkIjogIm9wZW5hcGktdGVzdC0xIiwKCSJvdGFTdWJPcmRlcklkIjogIm9wZW5hcGktdGVzdC0xLTEiLAoJIm90YVJlZnVuZElkIjogIm9wZW5hcGktdGVzdC1yZWZ1bmQtMSIsCgkicmVmdW5kQW1vdW50IjogIjEwMDAiCn0="
}

{
    "code": "SUCCESS",
    "data": {
        "otaOrderId": "openapi-test-1",
        "otaRefundId": "openapi-test-refund-1",
        "otaSubOrderId": "openapi-test-1-1",
        "refundStatus": 0
    },
    "msg": "成功",
    "requestId": "f7b5bfec8e9044fcb6506d3b57ad2e94",
    "success": true
}

{
    "code": "REFUND_FORBIDDEN_ERROR",
    "msg": "分销退款单号：openapi-test-refund-1，当前订单状态：预订中，不可以申请退款。",
    "requestId": "643f998979794b5fb36460cce16e0cd4",
    "success": false
}

{
    "otaId": 1711,
    "method": "trade.refund.query",
    "sign": "7b064dad507c266a161ffc73c53dcdc5",
    "timestamp": 1520590361,
    "body": "ewoJIm90YVJlZnVuZElkIjogIm9wZW5hcGktdGVzdC1yZWZ1bmQtMSIKfQ=="
}

{
    "code": "SUCCESS",
    "data": {
        "otaRefundId": "openapi-test-refund-1",
        "refundAmount": 1000,
        "refundId": 121,
        "refundNum": 0,
        "refundStatus": 0,
        "refuseReason": ""
    },
    "msg": "成功",
    "requestId": "e767e6f45cb5488db364f2bc191cd4f4",
    "success": true
}

{
    "code": "REFUND_ORDER_NOT_EXISTS",
    "msg": "退款单不存在",
    "requestId": "ca287a64b29548d6b3f187984d652bba",
    "success": false
}

{
  "otaOrderId": "187028174920793",
  "orderId": "360086990446621",
  "syncStatus": 1,
  "subOrders": [
    {
      "otaSubOrderId": "187028174920793-1",
      "voucherCodes": [
        "yx9wzpwr",
        "yx9wyz1r"
      ],
      "voucherStreams": [
        "eyJvcmRlckl0ZW1zIjpbeyJvcmRlkiOjEsByaFVUzAxTzAwZDIwIn0="
      ]
    },
    {
      "otaSubOrderId": "187028174920793-2",
      "voucherCodes": [
        "yx9wzpwa",
        "yx9wyz1a"
      ],
      "voucherStreams": [
        "eyJvcmRlckl0ZW1zIjpbeyJvcmRlkiOjEsByaFVUzAxTzAwZDIwIn0="
      ]
    }
  ]
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {},
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {},
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {},
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {},
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

{
    "code": "SUCCESS",
    "msg": "请求成功",
    "data": {
        "otaOrderId": "20170301000001",
        "orderId": "201703010000012",
        "userInfo": {},
        "contactInfo": {},
        "remark": "买家留言",
        "subOrders": [],
        "createTime": "2017-10-09 13:59:22"
    },
    "requestId": "d0d438e1b7a311e7a4c064006a34ea1e"
}

1.您传入的货币必须和供应商与您的结算币种相同，否则会造成下单失败。
2.下单时传入的sku单价及总价，需要和供应商给您的报价一致，如果供应商变更价格，您也需要及时同步更新，否则会造成下单失败。
3.子订单总价=子订单商品单价*数量
4.为了避免重复下单，分销商的订单号不能重复。如果只有一个子订单，则可以和主订单号一样。
5.请确认下单时该商品的预定配置信息，例如：需要出行人的邮箱、电话、接送酒店等。如果信息缺失，则会返回信息缺失提示。

1.需传入正确的分销商订单号，否则无法完成退款请求。
2.当前可退数量=预定数量-已退款数量。当所有数量全部取消后，则认为该订单整体取消了。api支持部分退款。
3.当订单状态已经是最终状态或初始状态，则不允许发起退款。
4.已经消费/核销的订单，不允许退款。
5.传入的退款金额需大于0元。