intelligence_finance_v1-20260817171812/intelligence_finance_v1/valid.md

// File: intelligence_finance_v1/go.mod module intelligence_finance_v1

go 1.21

// File: intelligence_finance_v1/crypto.go package intelligence_finance_v1

import ( "crypto/hmac" "crypto/rand" "crypto/sha256" "encoding/base64" "fmt" "math/big" "sort" "strings" "time" )

// GenerateTimestamp 生成秒级时间戳字符串 func GenerateTimestamp() string { return fmt.Sprintf("%d", time.Now().Unix()) }

// GenerateNonce 生成指定长度的加密安全随机字符串 func GenerateNonce(length int) (string, error) { const charset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" b := make([]byte, length) for i := range b { num, err := rand.Int(rand.Reader, big.NewInt(int64(len(charset)))) if err != nil { return "", err } b[i] = charset[num.Int64()] } return string(b), nil }

// HmacSHA256Base64 使用HmacSHA256算法对数据进行签名，返回Base64编码结果 func HmacSHA256Base64(secret, data string) string { mac := hmac.New(sha256.New, []byte(secret)) mac.Write([]byte(data)) return base64.StdEncoding.EncodeToString(mac.Sum(nil)) }

// BuildSignString 按字典序排序拼接参数（排除空值和签名字段） func BuildSignString(params map[string]string) string { keys := make([]string, 0, len(params)) for k, v := range params { if v != "" && k != "sign" && k != "signature" && k != "x-bfl-signature" { keys = append(keys, k) } } sort.Strings(keys)

var parts []string
for _, k := range keys {
	parts = append(parts, fmt.Sprintf("%s=%s", k, params[k]))
}
return strings.Join(parts, "&")

}

// BuildSignStringOrdered 按固定顺序拼接参数 func BuildSignStringOrdered(params map[string]string, orderedKeys []string) string { var parts []string for _, k := range orderedKeys { if v, ok := params[k]; ok && v != "" { parts = append(parts, fmt.Sprintf("%s=%s", k, v)) } } return strings.Join(parts, "&") }

// File: intelligence_finance_v1/types.go package intelligence_finance_v1

import "encoding/json"

// ============================================================ // 通用请求/响应结构 // ============================================================

// CommonResponse 通用API响应结构 type CommonResponse struct { Code int json:"code" Msg string json:"msg,omitempty" Data json.RawMessage json:"data,omitempty" }

// NotificationRequest 回调通知请求结构 type NotificationRequest struct { BizType string json:"bizType" BizID string json:"bizId" Data string json:"data,omitempty" }

// ============================================================ // 接口1：订单开票请求/响应 // ============================================================

// CreateInvoiceRequest 提交订单开票申请请求 type CreateInvoiceRequest struct { CompanyCode string json:"companyCode,omitempty" OrderID string json:"orderId" InvoiceType int json:"invoiceType" Products []InvoiceProduct json:"products" Remark string json:"remark,omitempty" Purchaser string json:"purchaser" TaxNum string json:"taxnum,omitempty" PurchaserAddr string json:"purchaserAddress,omitempty" PurchaserTel string json:"purchaserTel,omitempty" BankName string json:"bankName,omitempty" BankAccount string json:"bankAccount,omitempty" Phone string json:"phone,omitempty" Email string json:"email,omitempty" ApplyPerson string json:"applyPerson,omitempty" Payee string json:"payee,omitempty" Reviewer string json:"reviewer,omitempty" InvoiceRemark string json:"invoiceRemark,omitempty" NaturalPerson string json:"naturalPerson,omitempty" AdditionInfo string json:"additionInfo,omitempty" }

// InvoiceProduct 货物/服务明细 type InvoiceProduct struct { ProductName string json:"productName" RevenueCode string json:"revenueCode" AmountIncludeTax float64 json:"amountIncludeTax" Specs string json:"specs,omitempty" Unit string json:"unit,omitempty" Quantity float64 json:"quantity" Discount float64 json:"discount,omitempty" TaxSign int json:"taxSign,omitempty" TaxRate float64 json:"taxRate,omitempty" }

// CreateInvoiceResponse 提交订单开票申请响应 type CreateInvoiceResponse struct { Status int json:"status" ErrorMsg string json:"errorMsg,omitempty" DataList []InvoiceData json:"dataList" }

// InvoiceData 发票数据 type InvoiceData struct { DeviceCode string json:"deviceCode" Drawer string json:"drawer" Email string json:"email" InvoiceType string json:"invoiceType" IssueType string json:"issueType" ListFlag string json:"listFlag" Mobile string json:"mobile" OriginalInvCode string json:"originalInvCode,omitempty" OriginalInvNo string json:"originalInvNo,omitempty" AdditionInfo string json:"additionInfo,omitempty" Payee string json:"payee" PurchaserAddress string json:"purchaserAddress" PurchaserBankAccount string json:"purchaserBankAccount" PurchaserBankName string json:"purchaserBankName" PurchaserName string json:"purchaserName" PurchaserTaxNo string json:"purchaserTaxNo" PurchaserTel string json:"purchaserTel" NaturalPerson string json:"naturalPerson,omitempty" Remark string json:"remark" Reviewer string json:"reviewer" SellerAddress string json:"sellerAddress,omitempty" SellerBankAccount string json:"sellerBankAccount" SellerBankName string json:"sellerBankName" SellerName string json:"sellerName" CheckCode string json:"checkCode" CipherText string json:"cipherText" DrewDate string json:"drewDate,omitempty" InvoiceCode string json:"invoiceCode" InvoiceNo string json:"invoiceNo" InvoiceStatus string json:"invoiceStatus" LayoutFileURL string json:"layoutFileUrl,omitempty" PdfURL string json:"pdfUrl,omitempty" OfdURL string json:"ofdUrl,omitempty" XmlURL string json:"xmlUrl,omitempty" TotalExcludeTax string json:"totalExcludeTax" TotalIncludeTax string json:"totalIncludeTax" TotalTaxAmount string json:"totalTaxAmount" LevyingType string json:"levyingType" Details []InvoiceDetail json:"details" }

// InvoiceDetail 商品明细 type InvoiceDetail struct { Amount string json:"amount,omitempty" Quantity string json:"quantity,omitempty" DeductionAmount string json:"deductionAmount,omitempty" TaxAmount string json:"taxAmount,omitempty" ItemTitle string json:"itemTitle" TaxCode string json:"taxCode" ItemType string json:"itemType" ItemName string json:"itemName" Specs string json:"specs,omitempty" TaxFreePolicy string json:"taxFreePolicy" PreferentialPolicy string json:"preferentialPolicy" TaxRate string json:"taxRate" TaxSign string json:"taxSign" Unit string json:"unit,omitempty" UnitPrice string json:"unitPrice,omitempty" }

// ============================================================ // 接口2：开票状态查询请求/响应 // ============================================================

// QueryInvoiceStatusRequest 查询订单开票状态请求 type QueryInvoiceStatusRequest struct { OrderID string json:"orderId" }

// QueryInvoiceStatusResponse 查询订单开票状态响应 type QueryInvoiceStatusResponse struct { Status int json:"status" Message string json:"message" Data []InvoiceData json:"data" }

// ============================================================ // 接口3：创建付款单据请求/响应 // ============================================================

// CreatePaymentRequest 创建付款单据请求 type CreatePaymentRequest struct { Code string json:"code" YidaAppType string json:"yidaAppType,omitempty" EmpAccountUserID string json:"empAccountUserId,omitempty" Department *Department json:"department,omitempty" Usage string json:"usage,omitempty" PaymentUserID string json:"paymentUserId,omitempty" Customer *Customer json:"customer,omitempty" PrincipalID string json:"principalId,omitempty" Remark string json:"remark,omitempty" Supplier *Supplier json:"supplier,omitempty" Title string json:"title,omitempty" Project *Project json:"project,omitempty" PaymentUserIDListStr string json:"paymentUserIdListStr,omitempty" NeedPayment bool json:"needPayment,omitempty" PaymentDetailListJsonStr string json:"paymentDetailListJsonStr,omitempty" PaymentDetailList []PaymentDetail json:"paymentDetailList,omitempty" Company *Company json:"company,omitempty" Amount string json:"amount,omitempty" RecipientAccountInfo *RecipientAccount json:"recipientAccountInfo,omitempty" EnterpriseAccount *EnterpriseAccount json:"enterpriseAccount,omitempty" Category []Category json:"category,omitempty" UserID string json:"userId" OccurDate int64 json:"occurDate,omitempty" Product *Product json:"product,omitempty" YidaFormUUID string json:"yidaFormUuid,omitempty" CanEditPaymentInfo bool json:"canEditPaymentInfo,omitempty" PaymentUserIDList []string json:"paymentUserIdList,omitempty" YidaProcInsID string json:"yidaProcInsId,omitempty" SyncPaymentOrder bool json:"syncPaymentOrder,omitempty" }

// Department 部门信息 type Department struct { Code string json:"code,omitempty" Name string json:"name" }

// Customer 客户信息 type Customer struct { Code string json:"code,omitempty" Name string json:"name" }

// Supplier 供应商信息 type Supplier struct { Code string json:"code,omitempty" Name string json:"name" }

// Project 项目信息 type Project struct { Code string json:"code,omitempty" Name string json:"name" }

// Category 收支类别信息 type Category struct { Code string json:"code,omitempty" Name string json:"name" }

// Product 商品信息 type Product struct { Code string json:"code,omitempty" Name string json:"name" }

// Company 企业主体信息 type Company struct { Code string json:"code,omitempty" Name string json:"name" }

// EnterpriseAccount 企业账号信息 type EnterpriseAccount struct { EnterpriseAccountCode string json:"enterpriseAccountCode,omitempty" AccountCategory string json:"accountCategory" AccountType string json:"accountType,omitempty" CardNo string json:"cardNo,omitempty" AccountName string json:"accountName,omitempty" OfficialNumber string json:"officialNumber,omitempty" OfficialName string json:"officialName,omitempty" Name string json:"name,omitempty" Code string json:"code,omitempty" City string json:"city,omitempty" Province string json:"province,omitempty" }

// RecipientAccount 收款账户信息 type RecipientAccount struct { AccountCategory string json:"accountCategory" AccountType string json:"accountType,omitempty" CardNo string json:"cardNo,omitempty" AccountName string json:"accountName,omitempty" }

// PaymentDetail 付款明细 type PaymentDetail struct { Amount string json:"amount,omitempty" InvoiceInfo *InvoiceInfo json:"invoiceInfo,omitempty" ProductCode string json:"productCode,omitempty" ProjectCode string json:"projectCode,omitempty" Remark string json:"remark,omitempty" PrincipalID string json:"principalId,omitempty" Tax string json:"tax,omitempty" }

// InvoiceInfo 付款明细发票信息 type InvoiceInfo struct { InvoiceNo string json:"invoiceNo,omitempty" InvoiceCode string json:"invoiceCode,omitempty" }

// CreatePaymentResponse 创建付款单据响应 type CreatePaymentResponse struct { Code string json:"code" }

// ============================================================ // 接口4：支付完成通知（平台回调） // ============================================================

// PaymentNotification 支付完成通知数据结构 type PaymentNotification struct { Code string json:"code" InstanceID string json:"instanceId" CorpID string json:"corpId" PaymentStatus string json:"paymentStatus" PaymentTime string json:"paymentTime" UserID string json:"userId" FailReason string json:"failReason,omitempty" PayerAccountInfo *PayerAccountInfo json:"payerAccountInfo,omitempty" PayeeAccountInfo *PayeeAccountInfo json:"payeeAccountInfo,omitempty" RelatedRowNumberList []string json:"relatedRowNumberList,omitempty" Source string json:"source,omitempty" Template string json:"template,omitempty" Amount string json:"amount,omitempty" }

// PayerAccountInfo 付款账户信息 type PayerAccountInfo struct { BankOpenDTO *BankOpenDTO json:"bankOpenDTO,omitempty" EnterpriseAccountCode string json:"enterpriseAccountCode,omitempty" AccountType string json:"accountType,omitempty" }

// PayeeAccountInfo 收款账户信息 type PayeeAccountInfo struct { BankOpenDTO *BankOpenDTO json:"bankOpenDTO,omitempty" }

// BankOpenDTO 银行信息 type BankOpenDTO struct { BankCode string json:"bankCode,omitempty" BankName string json:"bankName,omitempty" BankBranchCode string json:"bankBranchCode,omitempty" BankBranchName string json:"bankBranchName,omitempty" AccountName string json:"accountName,omitempty" BankCardNo string json:"bankCardNo,omitempty" Type string json:"type,omitempty" }

// ============================================================ // 接口5：支付状态查询请求/响应 // ============================================================

// QueryPaymentStatusRequest 查询支付状态请求 type QueryPaymentStatusRequest struct { Code string json:"code" UserID string json:"userId" }

// QueryPaymentStatusResponse 查询支付状态响应（与PaymentNotification结构一致） type QueryPaymentStatusResponse struct { PaymentNotification }

// ============================================================ // 接口6：创建供应商请求/响应 // ============================================================

// CreateSupplierRequest 创建供应商请求 type CreateSupplierRequest struct { InvokeID string json:"invokeId,omitempty" UserID string json:"userId" Data string json:"data,omitempty" BizType string json:"bizType" }

// CreateSupplierBizData 创建供应商业务数据 type CreateSupplierBizData struct { CorpID string json:"corpId" Creator string json:"creator" SupplierInfo *SupplierInfo json:"supplierInfo,omitempty" }

// SupplierInfo 供应商数据 type SupplierInfo struct { Name string json:"name" CorpID string json:"corpId" UserDefineCode string json:"userDefineCode,omitempty" Description string json:"description,omitempty" ContactAddress string json:"contactAddress,omitempty" ContactCompanyTelephone string json:"contactCompanyTelephone,omitempty" ContactEmail string json:"contactEmail,omitempty" ContactName string json:"contactName,omitempty" ContactTelephone string json:"contactTelephone,omitempty" Creator string json:"creator" InvoiceAccount string json:"invoiceAccount,omitempty" InvoiceAddress string json:"invoiceAddress,omitempty" InvoiceBankName string json:"invoiceBankName,omitempty" InvoiceName string json:"invoiceName,omitempty" InvoiceTaxNo string json:"invoiceTaxNo,omitempty" PurchaserTel string json:"purchaserTel,omitempty" BankName string json:"bankName,omitempty" InvoiceTelephone string json:"invoiceTelephone,omitempty" AccountName string json:"accountName,omitempty" AccountType string json:"accountType,omitempty" }

// CreateSupplierResponse 创建供应商响应 type CreateSupplierResponse struct { InvokeID string json:"invokeId,omitempty" BizType string json:"bizType" Data json.RawMessage json:"data,omitempty" }

// CreateSupplierResponseData 创建供应商响应数据 type CreateSupplierResponseData struct { Result string json:"result,omitempty" Success bool json:"success" }

// SupplierInfoResponse 供应商信息（响应） type SupplierInfoResponse struct { SupplierID string json:"supplierId" SupplierName string json:"supplierName" Name string json:"name" CorpID string json:"corpId" UserDefineCode string json:"userDefineCode,omitempty" Description string json:"description,omitempty" ContactAddress string json:"contactAddress,omitempty" ContactCompanyTelephone string json:"contactCompanyTelephone,omitempty" ContactEmail string json:"contactEmail,omitempty" ContactName string json:"contactName,omitempty" ContactTelephone string json:"contactTelephone,omitempty" Creator string json:"creator" InvoiceAccount string json:"invoiceAccount,omitempty" InvoiceAddress string json:"invoiceAddress,omitempty" InvoiceBankName string json:"invoiceBankName,omitempty" }

// ============================================================ // 接口7：根据名称查询供应商请求/响应 // ============================================================

// QuerySupplierByNameRequest 根据名称查询供应商请求 type QuerySupplierByNameRequest struct { InvokeID string json:"invokeId,omitempty" UserID string json:"userId" Data string json:"data,omitempty" BizType string json:"bizType" }

// QuerySupplierByNameBizData 根据名称查询供应商业务数据 type QuerySupplierByNameBizData struct { CorpID string json:"corpId" Name string json:"name" }

// QuerySupplierByNameResponse 根据名称查询供应商响应 type QuerySupplierByNameResponse struct { InvokeID string json:"invokeId,omitempty" BizType string json:"bizType" Data json.RawMessage json:"data,omitempty" Result string json:"result,omitempty" Success bool json:"success" }

// QuerySupplierByNameResult 供应商查询结果重要字段 type QuerySupplierByNameResult struct { SupplierName string json:"supplierName" UserDefineCode string json:"userDefineCode,omitempty" InvoiceName string json:"invoiceName,omitempty" SupplierID string json:"supplierId" CorpID string json:"corpId" ContactTelephone string json:"contactTelephone,omitempty" ContactEmail string json:"contactEmail,omitempty" ContactName string json:"contactName,omitempty" InvoiceBankName string json:"invoiceBankName,omitempty" InvoiceAccount string json:"invoiceAccount,omitempty" Description string json:"description,omitempty" InvoiceAddress string json:"invoiceAddress,omitempty" InvoiceTaxNo string json:"invoiceTaxNo,omitempty" ContactCompanyTelephone string json:"contactCompanyTelephone,omitempty" CreateTime int64 json:"createTime,omitempty" InvoiceTelephone string json:"invoiceTelephone,omitempty" ContactAddress string json:"contactAddress,omitempty" }

// ============================================================ // 接口8：更新供应商请求/响应 // ============================================================

// UpdateSupplierRequest 更新供应商请求 type UpdateSupplierRequest struct { InvokeID string json:"invokeId,omitempty" UserID string json:"userId" Data string json:"data,omitempty" BizType string json:"bizType" }

// UpdateSupplierBizData 更新供应商业务数据 type UpdateSupplierBizData struct { SupplierID string json:"supplierId" Name string json:"name" CorpID string json:"corpId" UserDefineCode string json:"userDefineCode,omitempty" Description string json:"description,omitempty" ContactAddress string json:"contactAddress,omitempty" ContactCompanyTelephone string json:"contactCompanyTelephone,omitempty" ContactEmail string json:"contactEmail,omitempty" ContactName string json:"contactName,omitempty" ContactTelephone string json:"contactTelephone,omitempty" UserID string json:"userId" InvoiceAccount string json:"invoiceAccount,omitempty" InvoiceAddress string json:"invoiceAddress,omitempty" InvoiceBankName string json:"invoiceBankName,omitempty" InvoiceName string json:"invoiceName,omitempty" InvoiceTaxNo string json:"invoiceTaxNo,omitempty" PurchaserTel string json:"purchaserTel,omitempty" BankName string json:"bankName,omitempty" InvoiceTelephone string json:"invoiceTelephone,omitempty" AccountName string json:"accountName,omitempty" AccountType string json:"accountType,omitempty" BankBranchCode string json:"bankBranchCode,omitempty" BankCode string json:"bankCode,omitempty" BankCity string json:"bankCity,omitempty" BankProvince string json:"bankProvince,omitempty" }

// UpdateSupplierResponse 更新供应商响应 type UpdateSupplierResponse struct { InvokeID string json:"invokeId,omitempty" BizType string json:"bizType" Data json.RawMessage json:"data,omitempty" }

// UpdateSupplierResponseData 更新供应商响应数据 type UpdateSupplierResponseData struct { Result string json:"result,omitempty" Success bool json:"success" }

// ============================================================ // 接口9：根据用户自定义编码查询供应商请求/响应 // ============================================================

// QuerySupplierByUserDefineCodeRequest 根据用户自定义编码查询供应商请求 type QuerySupplierByUserDefineCodeRequest struct { InvokeID string json:"invokeId,omitempty" UserID string json:"userId" Data string json:"data,omitempty" BizType string json:"bizType" }

// QuerySupplierByUserDefineCodeBizData 根据自定义编码查询供应商业务数据 type QuerySupplierByUserDefineCodeBizData struct { CorpID string json:"corpId" UserDefineCode string json:"userDefineCode" }

// QuerySupplierByUserDefineCodeResponse 根据自定义编码查询供应商响应 type QuerySupplierByUserDefineCodeResponse struct { InvokeID string json:"invokeId,omitempty" BizType string json:"bizType" Data json.RawMessage json:"data,omitempty" }

// QuerySupplierByUserDefineCodeResponseData 响应数据 type QuerySupplierByUserDefineCodeResponseData struct { Success bool json:"success" }

// QuerySupplierByUserDefineCodeResult 供应商查询结果重要字段 type QuerySupplierByUserDefineCodeResult struct { UserDefineCode string json:"userDefineCode" SupplierName string json:"supplierName" ModifiedTime int64 json:"modifiedTime,omitempty" Creator string json:"creator,omitempty" SupplierID string json:"supplierId" Code string json:"code,omitempty" CorpID string json:"corpId" CreateTime int64 json:"createTime,omitempty" Name string json:"name" ID int64 json:"id,omitempty" Status string json:"status,omitempty" }

// File: intelligence_finance_v1/errors.go package intelligence_finance_v1

import "fmt"

// SDKError SDK通用错误类型 type SDKError struct { Code int json:"code" Message string json:"message" Err error json:"-" }

// Error 实现error接口 func (e *SDKError) Error() string { if e.Err != nil { return fmt.Sprintf("code=%d, message=%s, err=%v", e.Code, e.Message, e.Err) } return fmt.Sprintf("code=%d, message=%s", e.Code, e.Message) }

// Unwrap 返回包装的错误 func (e *SDKError) Unwrap() error { return e.Err }

// NewSDKError 创建SDK错误 func NewSDKError(code int, message string, err error) *SDKError { return &SDKError{ Code: code, Message: message, Err: err, } }

// 预定义错误码 const ( ErrCodeSuccess = 0 ErrCodeUnknown = -1 ErrCodeInvalidParam = 1001 ErrCodeSignatureFailed = 1002 ErrCodeNetworkError = 1003 ErrCodeRequestTimeout = 1004 ErrCodeServerError = 2001 ErrCodeUnauthorized = 2002 ErrCodeNotFound = 2003 ErrCodeRateLimit = 2004 )

// 预定义错误 var ( ErrUnknown = NewSDKError(ErrCodeUnknown, "未知错误", nil) ErrInvalidParam = NewSDKError(ErrCodeInvalidParam, "参数无效", nil) ErrSignatureFailed = NewSDKError(ErrCodeSignatureFailed, "签名失败", nil) ErrNetworkError = NewSDKError(ErrCodeNetworkError, "网络错误", nil) ErrRequestTimeout = NewSDKError(ErrCodeRequestTimeout, "请求超时", nil) ErrServerError = NewSDKError(ErrCodeServerError, "服务端错误", nil) ErrUnauthorized = NewSDKError(ErrCodeUnauthorized, "未授权", nil) ErrNotFound = NewSDKError(ErrCodeNotFound, "未找到", nil) ErrRateLimit = NewSDKError(ErrCodeRateLimit, "请求频率限制", nil) )

// File: intelligence_finance_v1/client.go package intelligence_finance_v1

import ( "bytes" "context" "encoding/json" "fmt" "io" "net/http" "time" )

// Client 业财连接SDK客户端 type Client struct { baseURL string tenantID string clientID string clientSecret string httpClient *http.Client debug bool }

// ClientOption 客户端配置选项 type ClientOption func(*Client)

// WithHTTPClient 设置自定义HTTP客户端 func WithHTTPClient(httpClient *http.Client) ClientOption { return func(c *Client) { c.httpClient = httpClient } }

// WithDebug 开启调试模式 func WithDebug(debug bool) ClientOption { return func(c *Client) { c.debug = debug } }

// WithTimeout 设置请求超时时间 func WithTimeout(timeout time.Duration) ClientOption { return func(c *Client) { c.httpClient.Timeout = timeout } }

// NewClient 创建新的SDK客户端 // - baseURL: API基础地址 // - tenantID: 平台分配的租户唯一标识 // - clientID: 平台分配的应用标识 // - clientSecret: 平台分配的客户端密钥 // - opts: 可选配置项 func NewClient(baseURL, tenantID, clientID, clientSecret string, opts ...ClientOption) *Client { c := &Client{ baseURL: baseURL, tenantID: tenantID, clientID: clientID, clientSecret: clientSecret, httpClient: &http.Client{ Timeout: 30 * time.Second, }, } for _, opt := range opts { opt(c) } return c }

// doRequest 发送HTTP请求，自动添加签名和认证头 func (c *Client) doRequest(ctx context.Context, path string, request interface{}, response interface{}) error { bodyBytes, err := json.Marshal(request) if err != nil { return NewSDKError(ErrCodeInvalidParam, "请求序列化失败", err) }

if c.debug {
	fmt.Printf("[DEBUG] Request URL: %s%s\n", c.baseURL, path)
	fmt.Printf("[DEBUG] Request Body: %s\n", string(bodyBytes))
}

// 生成时间戳和随机数
timestamp := GenerateTimestamp()
nonce, err := GenerateNonce(16)
if err != nil {
	return NewSDKError(ErrCodeSignatureFailed, "生成随机数失败", err)
}

// 签名数据：timestamp + nonce
signData := timestamp + nonce
signature := HmacSHA256Base64(c.clientSecret, signData)

req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+path, bytes.NewReader(bodyBytes))
if err != nil {
	return NewSDKError(ErrCodeNetworkError, "创建请求失败", err)
}

req.Header.Set("Content-Type", "application/json")
req.Header.Set("tenant-id", c.tenantID)
req.Header.Set("client-id", c.clientID)
req.Header.Set("x-bfl-signature-timestamp", timestamp)
req.Header.Set("x-bfl-signature-nonce", nonce)
req.Header.Set("x-bfl-signature", signature)

if c.debug {
	fmt.Printf("[DEBUG] Headers: tenant-id=%s, client-id=%s, x-bfl-signature=%s\n", c.tenantID, c.clientID, signature)
}

resp, err := c.httpClient.Do(req)
if err != nil {
	return NewSDKError(ErrCodeNetworkError, "请求发送失败", err)
}
defer resp.Body.Close()

respBody, err := io.ReadAll(resp.Body)
if err != nil {
	return NewSDKError(ErrCodeNetworkError, "读取响应失败", err)
}

if c.debug {
	fmt.Printf("[DEBUG] Response Status: %s\n", resp.Status)
	fmt.Printf("[DEBUG] Response Body: %s\n", string(respBody))
}

// 解析通用响应
var commonResp CommonResponse
if err := json.Unmarshal(respBody, &commonResp); err != nil {
	return NewSDKError(ErrCodeUnknown, "响应解析失败", err)
}

if commonResp.Code != 0 {
	return NewSDKError(commonResp.Code, commonResp.Msg, nil)
}

// 如果response不为nil，将commonResp.Data反序列化到response
if response != nil {
	if err := json.Unmarshal(commonResp.Data, response); err != nil {
		return NewSDKError(ErrCodeUnknown, "响应数据解析失败", err)
	}
}

return nil

}

// ============================================================ // 接口1：订单开票 // ============================================================

// CreateInvoice 提交订单开票申请 // 文档：接口1 - 提交订单开票申请 func (c *Client) CreateInvoice(ctx context.Context, req *CreateInvoiceRequest) (*CreateInvoiceResponse, error) { path := "/api/v1/invoice/create" var resp CreateInvoiceResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口2：开票状态查询 // ============================================================

// QueryInvoiceStatus 查询订单开票状态 // 文档：接口2 - 查询订单开票状态 func (c *Client) QueryInvoiceStatus(ctx context.Context, req *QueryInvoiceStatusRequest) (*QueryInvoiceStatusResponse, error) { path := "/api/v1/invoice/query" var resp QueryInvoiceStatusResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口3：创建付款单据 // ============================================================

// CreatePayment 创建付款单据 // 文档：接口3 - 创建付款单据 func (c *Client) CreatePayment(ctx context.Context, req *CreatePaymentRequest) (*CreatePaymentResponse, error) { path := "/api/v1/payment/create" var resp CreatePaymentResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口4：支付完成通知（平台回调客户） // 此接口由客户提供，平台调用。客户需实现HTTP Handler处理回调。 // ============================================================

// HandlePaymentNotification 处理支付完成通知 // 文档：接口4 - 支付完成通知回调处理 // 该函数用于解析平台发起的支付完成通知请求，返回SUCCESS或FAILED // 注意：平台回调时，请求体为 NotificationRequest 结构，其中 Data 字段为 PaymentNotification 的JSON字符串 func HandlePaymentNotification(body []byte) (string, error) { // 先解析外层通知结构 var notificationReq NotificationRequest if err := json.Unmarshal(body, &notificationReq); err != nil { return "FAILED", NewSDKError(ErrCodeInvalidParam, "解析通知请求失败", err) }

// 根据bizType处理不同业务
switch notificationReq.BizType {
case "payment_notification":
	// 解析内部支付通知数据
	var paymentNotification PaymentNotification
	if err := json.Unmarshal([]byte(notificationReq.Data), &paymentNotification); err != nil {
		return "FAILED", NewSDKError(ErrCodeInvalidParam, "解析支付通知数据失败", err)
	}
	// 业务处理由调用方自行实现，此处仅返回成功
	// 调用方应在此函数基础上扩展业务逻辑
	_ = paymentNotification
default:
	// 未知业务类型，记录日志后返回失败
	return "FAILED", NewSDKError(ErrCodeInvalidParam, "未知业务类型: "+notificationReq.BizType, nil)
}

return "SUCCESS", nil

}

// ============================================================ // 接口5：支付状态查询 // ============================================================

// QueryPaymentStatus 查询支付状态 // 文档：接口5 - 查询支付状态 func (c *Client) QueryPaymentStatus(ctx context.Context, req *QueryPaymentStatusRequest) (*QueryPaymentStatusResponse, error) { path := "/api/v1/payment/query" var resp QueryPaymentStatusResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口6：创建供应商 // ============================================================

// CreateSupplier 创建供应商 // 文档：接口6 - 创建供应商 func (c *Client) CreateSupplier(ctx context.Context, req *CreateSupplierRequest) (*CreateSupplierResponse, error) { path := "/api/v1/supplier/create" var resp CreateSupplierResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口7：根据名称查询供应商 // ============================================================

// QuerySupplierByName 根据供应商名称查询供应商 // 文档：接口7 - 根据名称查询供应商 func (c *Client) QuerySupplierByName(ctx context.Context, req *QuerySupplierByNameRequest) (*QuerySupplierByNameResponse, error) { path := "/api/v1/supplier/queryByName" var resp QuerySupplierByNameResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口8：更新供应商 // ============================================================

// UpdateSupplier 更新供应商信息 // 文档：接口8 - 更新供应商 func (c *Client) UpdateSupplier(ctx context.Context, req *UpdateSupplierRequest) (*UpdateSupplierResponse, error) { path := "/api/v1/supplier/update" var resp UpdateSupplierResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// ============================================================ // 接口9：根据用户自定义编码查询供应商 // ============================================================

// QuerySupplierByUserDefineCode 根据用户自定义编码查询供应商 // 文档：接口9 - 根据用户自定义编码查询供应商 func (c *Client) QuerySupplierByUserDefineCode(ctx context.Context, req *QuerySupplierByUserDefineCodeRequest) (*QuerySupplierByUserDefineCodeResponse, error) { path := "/api/v1/supplier/queryByCode" var resp QuerySupplierByUserDefineCodeResponse if err := c.doRequest(ctx, path, req, &resp); err != nil { return nil, err } return &resp, nil }

// File: intelligence_finance_v1/example_test.go package intelligence_finance_v1

import ( "context" "encoding/json" "fmt" "log" "time" )

// ExampleNewClient 展示了如何创建SDK客户端 func ExampleNewClient() { // 创建客户端 client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", WithTimeout(30*time.Second), WithDebug(true), ) _ = client fmt.Println("Client created successfully") }

// ExampleClient_CreateInvoice 展示了如何提交订单开票申请 func ExampleClient_CreateInvoice() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

req := &CreateInvoiceRequest{
	OrderID:     "ORDER20240101001",
	InvoiceType: 9, // 数电普票
	Purchaser:   "测试购买方有限公司",
	TaxNum:      "91110108MA12345678",
	Phone:       "13800138000",
	Email:       "test@example.com",
	Products: []InvoiceProduct{
		{
			ProductName:      "办公用品",
			RevenueCode:      "1090515010000000000",
			AmountIncludeTax: 1130.00,
			Quantity:         10,
			Unit:             "个",
			TaxRate:          0.13,
			TaxSign:          1,
			Discount:         0,
		},
	},
	ApplyPerson: "张三",
	Payee:       "李四",
	Reviewer:    "王五",
}

resp, err := client.CreateInvoice(context.Background(), req)
if err != nil {
	log.Fatalf("创建开票申请失败: %v", err)
}

fmt.Printf("开票状态: %d, 错误信息: %s\n", resp.Status, resp.ErrorMsg)
for i, inv := range resp.DataList {
	fmt.Printf("发票%d: 代码=%s, 号码=%s, 金额(含税)=%s\n", i+1, inv.InvoiceCode, inv.InvoiceNo, inv.TotalIncludeTax)
}

}

// ExampleClient_QueryInvoiceStatus 展示了如何查询开票状态 func ExampleClient_QueryInvoiceStatus() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

req := &QueryInvoiceStatusRequest{
	OrderID: "ORDER20240101001",
}

resp, err := client.QueryInvoiceStatus(context.Background(), req)
if err != nil {
	log.Fatalf("查询开票状态失败: %v", err)
}

fmt.Printf("开票状态: %d, 描述: %s\n", resp.Status, resp.Message)

}

// ExampleClient_CreatePayment 展示了如何创建付款单据 func ExampleClient_CreatePayment() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

req := &CreatePaymentRequest{
	Code:   "PAY20240101001",
	UserID: "user123",
	Title:  "采购付款-2024年1月",
	Amount: "50000.00",
	Supplier: &Supplier{
		Name: "供应商A",
	},
	Department: &Department{
		Name: "财务部",
	},
	Company: &Company{
		Name: "XX科技有限公司",
	},
	PaymentDetailList: []PaymentDetail{
		{
			Amount: "50000.00",
			Remark: "1月采购货款",
		},
	},
}

resp, err := client.CreatePayment(context.Background(), req)
if err != nil {
	log.Fatalf("创建付款单据失败: %v", err)
}

fmt.Printf("付款单据编码: %s\n", resp.Code)

}

// ExampleHandlePaymentNotification 展示了如何处理支付完成通知 func ExampleHandlePaymentNotification() { // 模拟平台回调的请求体（符合NotificationRequest格式） notificationBody := { "bizType": "payment_notification", "bizId": "instance_001", "data": "{\"code\":\"PAY20240101001\",\"instanceId\":\"instance_001\",\"corpId\":\"dingXXXXXX\",\"paymentStatus\":\"SUCCESS\",\"paymentTime\":\"2024-01-15 10:30:00\",\"userId\":\"user123\",\"amount\":\"50000.00\",\"source\":\"openapi\"}" }

result, err := HandlePaymentNotification([]byte(notificationBody))
if err != nil {
	log.Printf("处理通知失败: %v", err)
}

fmt.Printf("通知处理结果: %s\n", result)

// 实际业务中，可以在此处解析通知数据并执行后续操作
// 解析外层
var notificationReq NotificationRequest
json.Unmarshal([]byte(notificationBody), &notificationReq)
var paymentNotification PaymentNotification
json.Unmarshal([]byte(notificationReq.Data), &paymentNotification)
fmt.Printf("收到支付通知: 单据编码=%s, 支付状态=%s\n", paymentNotification.Code, paymentNotification.PaymentStatus)

}

// ExampleClient_QueryPaymentStatus 展示了如何查询支付状态 func ExampleClient_QueryPaymentStatus() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

req := &QueryPaymentStatusRequest{
	Code:   "PAY20240101001",
	UserID: "user123",
}

resp, err := client.QueryPaymentStatus(context.Background(), req)
if err != nil {
	log.Fatalf("查询支付状态失败: %v", err)
}

fmt.Printf("支付状态: %s, 支付时间: %s\n", resp.PaymentStatus, resp.PaymentTime)

}

// ExampleClient_CreateSupplier 展示了如何创建供应商 func ExampleClient_CreateSupplier() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

bizData := CreateSupplierBizData{
	CorpID:  "dingXXXXXX",
	Creator: "user123",
	SupplierInfo: &SupplierInfo{
		Name:            "测试供应商有限公司",
		CorpID:          "dingXXXXXX",
		Creator:         "user123",
		UserDefineCode:  "SUP-001",
		ContactName:     "张三",
		ContactTelephone: "13800138000",
		ContactEmail:    "contact@supplier.com",
		ContactAddress:  "北京市朝阳区XX路XX号",
	},
}

bizDataBytes, _ := json.Marshal(bizData)

req := &CreateSupplierRequest{
	InvokeID: "invoke_001",
	UserID:   "user123",
	Data:     string(bizDataBytes),
	BizType:  "create_supplier",
}

resp, err := client.CreateSupplier(context.Background(), req)
if err != nil {
	log.Fatalf("创建供应商失败: %v", err)
}

fmt.Printf("创建供应商响应: invokeId=%s, bizType=%s\n", resp.InvokeID, resp.BizType)
// 如果需要解析响应数据，可以进一步处理 resp.Data
var responseData CreateSupplierResponseData
if err := json.Unmarshal(resp.Data, &responseData); err == nil {
	fmt.Printf("响应数据: success=%v, result=%s\n", responseData.Success, responseData.Result)
}

}

// ExampleClient_QuerySupplierByName 展示了如何根据名称查询供应商 func ExampleClient_QuerySupplierByName() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

bizData := []QuerySupplierByNameBizData{
	{
		CorpID: "dingXXXXXX",
		Name:   "测试供应商有限公司",
	},
}

bizDataBytes, _ := json.Marshal(bizData)

req := &QuerySupplierByNameRequest{
	InvokeID: "invoke_002",
	UserID:   "user123",
	Data:     string(bizDataBytes),
	BizType:  "query_supplier_by_name",
}

resp, err := client.QuerySupplierByName(context.Background(), req)
if err != nil {
	log.Fatalf("查询供应商失败: %v", err)
}

fmt.Printf("查询结果: success=%v, result=%s\n", resp.Success, resp.Result)
// 解析响应数据
var results []QuerySupplierByNameResult
if err := json.Unmarshal(resp.Data, &results); err == nil {
	for _, r := range results {
		fmt.Printf("供应商: %s, ID: %s\n", r.SupplierName, r.SupplierID)
	}
}

}

// ExampleClient_UpdateSupplier 展示了如何更新供应商 func ExampleClient_UpdateSupplier() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

bizData := UpdateSupplierBizData{
	SupplierID:     "SUP_XXXXX",
	Name:           "更新后的供应商名称",
	CorpID:         "dingXXXXXX",
	UserID:         "user123",
	ContactName:    "李四",
	ContactTelephone: "13900139000",
	ContactEmail:   "new@supplier.com",
	Description:    "长期合作供应商",
}

bizDataBytes, _ := json.Marshal(bizData)

req := &UpdateSupplierRequest{
	InvokeID: "invoke_003",
	UserID:   "user123",
	Data:     string(bizDataBytes),
	BizType:  "update_supplier",
}

resp, err := client.UpdateSupplier(context.Background(), req)
if err != nil {
	log.Fatalf("更新供应商失败: %v", err)
}

fmt.Printf("更新供应商响应: invokeId=%s, bizType=%s\n", resp.InvokeID, resp.BizType)

}

// ExampleClient_QuerySupplierByUserDefineCode 展示了如何根据自定义编码查询供应商 func ExampleClient_QuerySupplierByUserDefineCode() { client := NewClient( "https://api.example.com", "your-tenant-id", "dd-ai-table", "your-client-secret", )

bizData := QuerySupplierByUserDefineCodeBizData{
	CorpID:         "dingXXXXXX",
	UserDefineCode: "SUP-001",
}

bizDataBytes, _ := json.Marshal(bizData)

req := &QuerySupplierByUserDefineCodeRequest{
	InvokeID: "invoke_004",
	UserID:   "user123",
	Data:     string(bizDataBytes),
	BizType:  "query_supplier_by_userDefineCode",
}

resp, err := client.QuerySupplierByUserDefineCode(context.Background(), req)
if err != nil {
	log.Fatalf("查询供应商失败: %v", err)
}

fmt.Printf("查询供应商响应: invokeId=%s, bizType=%s\n", resp.InvokeID, resp.BizType)
// 解析响应数据
var responseData QuerySupplierByUserDefineCodeResponseData
if err := json.Unmarshal(resp.Data, &responseData); err == nil {
	fmt.Printf("响应数据: success=%v\n", responseData.Success)
}

}