开放平台
    开放平台
    • 宁伙伴系统简介
    • 接入指引
    • 接入指南
    • 众包API接口调用流程
    • 撮合API接口调用流程
    • 更新日志
    • 众包API更新日志
    • 附录A:地区编码
    • 附录B:响应结果码字典
    • 众包线下模式API接口调用流程
    • 智慧分账
      • 私域收款
        • 支付结果通知
        • 退款结果通知
        • 聚合统一下单各支付方式唤起方法
        • 聚合支付接口
          • SPI-001-聚合支付统一下单
          • SPI-002-关闭订单
          • SPI-003-查询订单
        • 退款接口
          • SPI-005-申请退款
          • SPI-004-查询退款订单
    • 财务管理
      • FIN-001 企业钱包
        POST
      • FIN-002 招商银行-提现账户新增
        POST
      • FIN-003 招商银行-提现账户修改
        POST
      • FIN-004 招商提现
        POST
      • FIN-005 招商银行-提现记录查询
        POST
      • FIN-006 交易充值单查询
        POST
      • FIN-007 招商钱包-提现账户列表查询
        POST
      • FIN-008-结算金额算税接口
        POST
      • FIN-009-到账金额算税接口
        POST
    • 账户管理
      • ACC-001-企业创建申请
        POST
      • ACC-002-企业信息查询
        POST
      • ACC-003-已创建企业分页查询
        POST
      • ACC-004-获取企业实名认证地址
        POST
      • ACC-005-企业申请入驻海南税源地
        POST
      • ACC-006-个人实名-短信通知
        POST
      • ACC-007-个人实名-H5地址
        POST
      • ACC-008-个人实名结果查询
        POST
      • ACC-009-本人授权-短信通知
        POST
      • ACC-010-本人授权-H5地址
        POST
    • 撮合灵工
      • 产品管理
        • PRD-001-开票科目信息查询
        • PRD-201-服务主体列表查询
        • PRD-202-撮合企业服务主体列表查询
        • PRD-203-撮合企业服务主体开票科目查询
      • 任务管理
        • DUT-201-任务模版授权列表查询
        • DUT-203-任务创建申请
        • DUT-204-任务列表查询
        • DUT-205-任务创建结果查询
        • DUT-206-任务详情查看
        • DUT-207-上传任务交付物
        • DUT-208-任务交付物详情
      • 订单管理
        • ORD-201-创建撮合订单
        • ORD-202-撮合代发订单分页查询
      • 发票管理
        • INV-001-查看企业完税开票余额
        • INV-002-月开票额限制修改申请
        • INV-003-完税开票申请提交审批
        • INV-004-完税开票申请审批结果查询
        • INV-005-完税开票申请详情查看
        • INV-006-完税开票申请订单列表查看
        • INV-007-完税凭证批量下载
        • INV-008-发票下载
        • INV-009-获取支付个税URL
    • 众包灵工
      • 服务主体管理
        • PRD-101 服务主体列表查询
        • PRD-102 企业服务主体列表查询
        • PRD-103 企业服务主体开票科目查询
      • 任务管理
        • DUT-101 任务模版授权列表查询
        • DUT-102 任务模版详情查看【暂不提供】
        • DUT-103 任务创建申请
        • DUT-104 任务列表查询
        • DUT-105 任务详情查看
        • DUT-106 上传任务交付物
        • DUT-107 任务交付物详情
      • 订单管理
        • ORD-101 验证派发数据
        • ORD-102 提交派发数据
        • ORD-103 支付派发订单
        • ORD-104 查询代发订单列表
        • ORD-105 查询代发订单详细信息
        • ORD-106 查询订单发放人员列表
        • ORD-107 查询订单支付信息【暂不提供】
        • ORD-108 取消支付【暂不提供】
        • ORD-109 批量上传代发订单
      • 发票管理
        • INV-101 可开票的订单列表
        • INV-102 申请开票
        • INV-103 发票分页查询
        • INV-104 发票详情
        • INV-010 查询完税开票订单申请列表
        • INV-007-完税凭证批量下载
        • INV-009-获取支付个税URL
      • 海南完税开票
      • 合同管理
        • CON-101 已签署合同列表
    • 数据模型
      • Schemas
        • OpenApiStatusConfigReqVO
        • OpenContractFinishVO
        • EmptyResult
        • OpenTaxSourceConfigParam
        • OpenFileUploadVO
        • OpenApiConfigQueryReqVO
        • OpenCompanyStatusVO
        • OpenCompanyIdParam
        • RefundRequest
        • RefundInquireRequest
        • CommonResultOpenFileUploadResult
        • CommonResultPageResultOpenApiConfigRespVO
        • CommonResultHnTaxSourceConfigDTO
        • CommonResultRefundResponse
        • CommonResultRefundInquireResponse
        • OpenFileUploadResult
        • OpenApiConfigRespVO
        • HnTaxSourceConfigDTO
        • RefundResponse
        • RefundInquireResponse
        • PageResultOpenApiConfigRespVO
        • CommonResultVoid
        • FindByIdsQueryPayload
        • CompanyUpdateBase
        • CommonResult
        • CompanyUpdateBusiness
        • CommonResultPageResultOpenCompanyPageResult
        • CompanyUpdateContacts
        • PrePayRequest
        • OpenCompanyProductPageVO
        • OpenCompanyPageResult
        • CompanyUpdateLegal
        • CommonResultPrePayResponse
        • CommonResultPageResultOpenCompanyProductResult
        • PageResultOpenCompanyPageResult
        • CompanyUpdateLicense
        • PrePayResponse
        • OpenCompanyProductResult
        • CompanyUpdateSettled
        • OpenHnOrderPageParam
        • InquireRequest
        • PageResultOpenCompanyProductResult
        • FileBaseVO
        • SortingField
        • CommonResultInquireResponse
        • OpenCompanyProductEditVO
        • OpenCompanyEditVO
        • CommonResultPageResultHnOrderPageDTO
        • InquireResponse
        • OpenCompanyNoVO
        • HnOrderPageDTO
        • CloseOrderRequest
        • OpenCompanyProductIdVO
        • CommonResultOpenCompanyDetail
        • PageResultHnOrderPageDTO
        • CloseOrderResponse
        • OpenCompanyIdVO
        • CompanyBase
        • OpenHnOrderAddParam
        • CommonResultCloseOrderResponse
        • CommonResultListOpenAgentProductResult
        • CompanyBusiness
        • OrderContact
        • OpenAgentProductResult
        • CompanyContacts
        • OrderDetail
        • ProductRatePageVO
        • CompanyGroup
        • OpenIdRequest
        • OpenCompanyProductAuthVO
        • CompanyLegal
        • CommonResultListOpenInvoiceSubVO
        • OpenCompanyProductAddVO
        • CompanyLicense
        • OpenInvoiceSubVO
        • CommonResultOpenCompanyProductIdResult
        • CompanyPay
        • OpenCompanyDetailRequest
        • OpenCompanyPageQueryVO
        • OpenCompanyProductIdResult
        • CompanySettled
        • OpenDutyTempPageVO
        • CommonResultListOpenCompanyProductVO
        • OpenCompanyDetail
        • CommonResultPageResultOpenDutyTempPageResult
        • OpenCompanyProductVO
        • CompanyAddBase
        • OpenDutyTempPageResult
        • CommonResultListOpenAgentProductVO
        • CompanyAddBusiness
        • PageResultOpenDutyTempPageResult
        • OpenAgentProductVO
        • CompanyAddContacts
        • OpenCompanyDutyTempPageVO
        • CompanyAddLegal
        • CommonResultPageResultOpenCompanyDutyTempPageResult
        • CreateMatchOrderDTO
        • CompanyAddLicense
        • OpenCompanyDutyTempPageResult
        • MatchOrderDetailDTO
        • CompanyAddSettled
        • PageResultOpenCompanyDutyTempPageResult
        • PaymentReceiptDTO
        • OpenCompanyAddVO
        • OpenCompanyDutyTempIdVO
        • SettlementAgreementDTO
        • CommonResultOpenCompanyNoResult
        • OpenCompanyDutyTempAuthVO
        • CommonResultListOpenDutyTempVO
        • OpenCompanyNoResult
        • OpenCompanyDutyTempAddVO
        • OpenDutyTempVO
        • OpenAgentUserQueryVO
        • CommonResultOpenCompanyDutyTempIdVO
        • OpenDutyListRequest
        • CommonResultListOpenAgentUserRespVO
        • OpenCompanyDutyPageVO
        • CommonResultListOpenDutyListVO
        • OpenAgentUserRespVO
        • CommonResultPageResultOpenCompanyDutyPageResult
        • OpenDutyListVO
        • OpenCompanyDutyPageResult
        • DutyIdVO
        • PageResultOpenCompanyDutyPageResult
        • CommonResultOpenDutyDetailVO
        • OpenCompanyDutyIdVO
        • OpenDutyDetailVO
        • CommonResultOpenCompanyDutyDetail
        • OpenCrowdDutyDeliverUploadRequest
        • OpenCompanyDutyDetail
        • OpenFileUploadRequest
        • OpenCompanyDutyAddVO
        • OpenCrowdDutyBaseRequest
        • CommonResultOpenCompanyDutyIdVO
        • CommonResultOpenCrowdDutyDeliverDetailResponse
        • FileBase
        • OpenCrowdDutyDeliverDetailResponse
        • OpenAgentNoVO
        • OpenCrowdDutyAddDTO
        • CommonResultListOpenBusinessRespVO
        • CommonResultDutyIdVO
        • OpenBusinessRespVO
        • ApprovalResultVO
        • CommonResultApprovalResultVO
        • SignContractCustomerDTO
        • SignContractDTO
        • CommonResultListCustomerBaseValidVO
        • CustomerBaseValidVO
        • SignInfoQueryDTO
        • CommonResultListSignContractInfoDTO
        • ContractInfo
        • SignContractInfoDTO
        • HnInvoiceApplyIdDTO
        • OpenAgentIdVO
        • CommonResultListOpenHnTaxDownloadDTO
        • OpenAgentPageQueryVO
        • OpenHnTaxDownloadDTO
        • CommonResultPageResultOpenAgentPageResult
        • OpenInvoiceSubQueryParam
        • OpenAgentPageResult
        • CommonResultListHnInvoiceSubDTO
        • PageResultOpenAgentPageResult
        • HnInvoiceSubDTO
        • CommonResultOpenHnInvoiceDownloadDTO
        • OpenHnInvoiceDownloadDTO
        • CommonResultListOpenHnInvoiceDetailDTO
        • OpenHnInvoiceDetailDTO
        • OpenInvoiceApplyParam
        • CommonResultOpenCompanyIdResult
        • ApprovalTaskNoDTO
        • OpenCompanyIdResult
        • CommonResultApprovalTaskNoDTO
        • OpenHnInvoicePayParam
        • CommonResultOpenHnInvoicePayDTO
        • OpenHnInvoicePayDTO
        • CommonResultOpenHnInvoiceApplyDTO
        • OpenHnInvoiceApplyDTO
        • CommonResultHnInvoiceApplyApprovalResultDTO
        • HnInvoiceApplyApprovalResultDTO
        • ZsWithdrawReqDTO
        • CommonResultZsWithdrawRespDTO
        • ZsWithdrawRespDTO
        • ZsWithdrawRecordPageReqDTO
        • CommonResultPageResultZsWithdrawRecordRespVO
        • PageResultZsWithdrawRecordRespVO
        • ZsWithdrawRecordRespVO
        • ZsWithdrawAcctUpdateReqDTO
        • CommonResultObject
        • AcctBaseDTO
        • CommonResultListZsWithdrawAcctPageRespDTO
        • ZsWithdrawAcctPageRespDTO
        • ZsWithdrawAcctInsertReqDTO
        • CommonResultZsWithdrawAcctRespDTO
        • ZsWithdrawAcctRespDTO
        • CommonResultListPursesRespDTO
        • PursesRespDTO
        • FundPageReqDTO
        • CommonResultPageResultFundPageRespDTO
        • FundPageRespDTO
        • PageResultFundPageRespDTO
        • OpenHnDutyAddDTO
        • OpenCompanyBindParam
        • CommonResultHnCompanyBindDTO
        • HnCompanyBindDTO
        • OpenBindPageParam
        • CommonResultPageResultHnBindPageDTO
        • HnBindPageDTO
        • PageResultHnBindPageDTO
        • OpenOrderCheckInfoReqDTO
        • OpenOrderCheckReqDTO
        • CommonResultOpenOrderSubmitRespDTO
        • OpenOrderDetailSubmitRespDTO
        • OpenOrderNotSubmitRespDTO
        • OpenOrderSubmitRespDTO
        • OrderPayReqDTO
        • OrderPageReqDTO
        • CommonResultPageResultOrderRespDTO
        • OrderRespDTO
        • PageResultOrderRespDTO
        • OpenOrderBaseReqDTO
        • CommonResultOrderRespDTO
        • CommonResultOrderPayInfoRespDTO
        • FlexWorkAccountInfo
        • OrderPayInfoRespDTO
        • OrderDetailReqDTO
        • CommonResultPageResultOrderDetailRespDTO
        • OrderDetailRespDTO
        • PageResultOrderDetailRespDTO
        • CommonResultOpenOrderCheckRespDTO
        • OpenOrderCheckRespDTO
        • OpenOrderCheckSubmitRespDTO
        • OpenInvoicePageRequest
        • CommonResultPageResultOpenInvoicePageResponse
        • OpenInvoicePageResponse
        • PageResultOpenInvoicePageResponse
        • OpenInvoiceBaseRequest
        • CommonResultOpenInvoiceDetailResponse
        • OpenInvoiceDetailResponse
        • SimpleOrderInfo
        • OpenInvoiceAvailableOrderRequest
        • CommonResultPageResultOpenInvoiceAvailableOrderResponse
        • OpenInvoiceAvailableOrderResponse
        • PageResultOpenInvoiceAvailableOrderResponse
        • OpenInvoiceApplyRequest
        • CommonResultOpenInvoiceApplyResponse
        • OpenInvoiceApplyResponse
        • OpenCrowdContractFinishDTO
        • CommonResultListOpenContractFinishVO
        • OpenCompanyPageRequest
        • CommonResultPageResultOpenCompanyPageResponse
        • OpenCompanyPageResponse
        • PageResultOpenCompanyPageResponse
        • OpenCompanyBaseRequest
        • CommonResultOpenCompanyAuthUrlResponse
        • OpenCompanyAuthUrlResponse
        • CommonResultOpenCompanyDetailResponse
        • CompanyAuth
        • OpenCompanyDetailResponse
        • OpenCompanyAddRequest
        • CommonResultOpenCompanyAddResponse
        • OpenCompanyAddResponse
      • schemas
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
      • schemas
      • schemas
        • 新建数据模型
      • schemas
        • 新建数据模型
        • 新建数据模型
      • schemas
        • 新建数据模型
      • schemas
        • 新建数据模型
      • 合同管理VO
      • lg5响应数据模型
        • result
      • schemas
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
        • 新建数据模型
      • 合同管理DTO
        • OpenCrowdContractFinishDTO
      • 修改后的
        • Schemas
          • CommonResultVoid
          • PrePayRequest
          • CloseOrderRequest
          • CommonResultPrePayResponse
          • PrePayResponse

    接入指引

    1 引言#

    1.1 参数说明#

    字段描述
    appId接口请求appId,平台提供的唯一编号
    appSecret与appId配套使用,生成签名
    public_key公钥
    private_key私钥

    1.2 环境说明#

    测试环境接口请求地址:https://getway.upfreework.com/openapi

    1.3 接口请求公共参数#

    所有请求的header报文中都需要有的参数
    字段类型描述
    appIdStringappId
    appSignString由appId、appSecret、sign、timeStamp字段按照一定的规则拼接后签名生成
    timeStampString时间戳,时间精确到毫秒。timestamp 与服务器的时间(北京时间)之间的误差不能超过10分钟。
    signString当报文体为空时header不要加此字段或者不设值,不为空时必填,对报文体做MD5摘要后hex(十六进制编码)输出

    2 接口开发#

    2.1 协议规则#

    要求说明
    传输方式为保证交易安全性,接口全部采用 HTTPS 传输
    提交方式全部采用POST方式提交
    数据格式提交和返回数据都为JSON格式
    字符编码统一采用 utf-8 字符编码

    2.2 签名机制#

    2.2.1 签名方式#

    只支持RSA方式签名,签名算法:MD5WithRSA

    2.2.2 签名规则#

    1.
    存在请求体时,获取请求完整JSON报文,使用MD5计算出报文摘要值(全小写),再hex输出成字符串sign;
    2.
    将appId、appSecret、sign、timeStamp参数中非空参数值的参数按照参数名ASCII码从小到大排序(字典序)使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串,将该字符串按照指定的签名算法使用交易发送方的签名私钥进行签名,将签名值使用Base64 转码得到签名串appSign。
    特别注意以下重要规则:
    ◆ 参数名ASCII码从小到大排序(字典序);
    ◆ 如果参数的值为空不参与签名
    3.
    将签名值和其他必要字段设置在http header中,注意不要将appSecret加入header中:
    HeaderKey描述
    appIdappId
    appSignBase64(RSA(MD5(按照规则拼接成的字符串)))
    timeStamp时间戳
    sign(HEX(MD5(完整JSON报文))

    2.3 代码示例#

    Java#

    C##

    Python#

    修改于 2025-09-12 08:01:25
    上一页
    宁伙伴系统简介
    下一页
    接入指南
    Built with