纸单手动创建

• 接口：common/deliveries/manual
• Method：POST
• 数据格式：JSON
• 接口说明：纸单手动创建接口
• 接口描述：
  • 电子单据与纸单批次号的关联关系
    • 一对一关联（单据号作为批次号）默认取单据号为批次号，删除标识为Y时传值无效
    • 一对一关联（一张单据关联一个批次号）设置纸单不可维护时传值无效
    • 一对多关联（一张单据关联多个批次号）设置纸单不可维护时传值无效
  • 设置提交单据后自动投递时，纸单状态取值为已投递delivered，否则为待投递pending

请求参数

请求示例

// 创建纸单
{
    "bizId": "a63f3e76-71d0-4d8c-a265-74f6df5cb3cc",
    "timestamp": 1648792000657,
    "data": {
        "code": "DLV0000000001",
        "document_num": "EXP0000000001"
    }
}

// 创建纸单（一对一关联，单据号作为批次号）
{
    "bizId": "d09a92d6-8fed-4069-b9d6-77a49f2615a0",
    "timestamp": 1660999515075,
    "data": {
        "document_num": "EXP0000000001"
    }
}

// 外部单据号作为唯一值
{
    "bizId": "38fb8956-3233-4db5-b365-382d877dd708",
    "timestamp": 1670827171658,
    "data": {
        "code": "DLV0000000001",
        "external_id": "8000252981"
    }
}

// 删除纸单
{
    "bizId": "24e66cb0-c1f2-4424-aeba-64ec3600f3b5",
    "timestamp": 1670827299513,
    "data": {
        "code": "DLV0000000001",
        "document_num": "EXP0000000001",
        "delete_flag": "Y"
    }
}

返回参数

返回示例

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "8ecc58c8-5bd5-432e-b833-fa8241674b13"
}

{
    "resCode": 400000,
    "resMsg": "参数校验错误",
    "bizId": "25e45e66-4da1-4da3-b246-deaee817c830",
    "data": {
        "validatorErrors": [
            "单据号和外部单据号必填其一"
            /
            "单据不存在"
            /
            "单据类型未启用可关联纸单，请检查配置"
            /
            "单据号作为批次号时纸单不可删除"
            /
            "纸单不可维护，请检查配置"
            /
            "批次号不能为空"
            /
            "删除标识为Y但批次号不存在"
            /
            "单据已关联批次号，请检查配置"
            /
            "一个批次号关联一张单据，无法再次关联"
            /
            "批次号已关联其他单据，无法使用"
        ]
    }
}