php對接金蝶系統

　　金蝶系統是強大的財務系統，可對公司的財務進行整理，所以有的時候需要去我php系統來對接金蝶系統，為金蝶系統生成各種單據。下面是php對接金蝶的流程。

　　各種方法已經封裝好，直接可以調用就行了。

　　1.如果是用的TP框架，請將下面的方法放在common.php中，方便系統調用。

/*****=======================================對接金蝶需要用到的方法==========================================================******/
/**
 * 利用curl函數來獲取接口數據
 * @param $url
 * @param $post_content
 * @param $cookie_jar
 * @param $isLogin
 * @return bool|string
 */

function invoke_post($url,$post_content,$cookie_jar,$isLogin)
{
    $ch = curl_init($url);

    $this_header = array(
        'Content-Type: application/json',
        'Content-Length: '.strlen($post_content)
    );

    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

    curl_setopt($ch, CURLOPT_HTTPHEADER, $this_header);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_content);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    if($isLogin){
        curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie_jar);
    }
    else{
        curl_setopt($ch, CURLOPT_COOKIEFILE, $cookie_jar);
    }
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);

    $result = curl_exec($ch);
    curl_close($ch);

    return $result;
}

//構造Web API請求格式
function create_postdata($args) {
    $postdata = array(
        'format'=>1,
        'useragent'=>'ApiClient',
        'rid'=>create_guid(),
        'parameters'=>$args,
        'timestamp'=>date('Y-m-d'),
        'v'=>'1.0'
    );

    return json_encode($postdata);
}

//生成guid
function create_guid() {
    $charid = strtoupper(md5(uniqid(mt_rand(), true)));
    $hyphen = chr(45);// "-"
    $uuid = chr(123)// "{"
        .substr($charid, 0, 8).$hyphen
        .substr($charid, 8, 4).$hyphen
        .substr($charid,12, 4).$hyphen
        .substr($charid,16, 4).$hyphen
        .substr($charid,20,12)
        .chr(125);// "}"
    return $uuid;
}

//登陸
function invoke_login($cloudUrl,$post_content,$cookie_jar)
{
    $loginurl = $cloudUrl.'Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc';
    return invoke_post($loginurl,$post_content,$cookie_jar,TRUE);
}

//保存
function invoke_save($cloudUrl,$post_content,$cookie_jar)
{
    $invokeurl = $cloudUrl.'Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc';
    return invoke_post($invokeurl,$post_content,$cookie_jar,FALSE);
}

//審核
function invoke_audit($cloudUrl,$post_content,$cookie_jar)
{
    $invokeurl = $cloudUrl.'Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit.common.kdsvc';
    return invoke_post($invokeurl,$post_content,$cookie_jar,FALSE);
}

//查看
function invoke_view($cloudUrl,$post_content,$cookie_jar)
{
    $invokeurl = $cloudUrl.'Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View.common.kdsvc';
    return invoke_post($invokeurl,$post_content,$cookie_jar,FALSE);
}
/*****************************************對接金蝶的方法結束************************************************************/

2.將一些配置項直接在類里面定義好，避免重復多次的書寫

//類的創建根據自己的需要來自行創建
class OrderController extends BaseController
{
    protected  $cloudUrl    = '自己金蝶的域名或者是IP地址/K3Cloud/';

    protected  $login       = array('套賬id','賬號','密碼',2052);
        
    public function index(){
　　　　/*方法內部*/
}    
}

3.金蝶的所有操作都需要在登錄的狀態下進行操作 ，所以就需要先進行登錄操作。在你需要生成金蝶報表的時候添加如下的代碼：

/*對接金蝶系統，先做登錄，在登錄的會話下進行其他操作*/
            $cookie_jar = tempnam('./tmp','CloudSession');//保存登錄后的session
            $post_content = create_postdata($this->login);
            /*返回登錄信息如果 LoginResultType == 1 說明登錄成功*/
            $result = json_decode(invoke_login($this->cloudUrl,$post_content,$cookie_jar),true);

            /*判斷成功之后在進行其他操作*/
            if($result['LoginResultType'] == 1){
       　　　　 /*在這里面進行金蝶報表的生成操作*/
}        

4.登錄成功之后就可以進行報表的操作了，金蝶報表的操作主要靠json來操作，這個json一定要生成正確。這里給大家講一下怎樣做能盡量避免問題。

　　4.1 首先以開發者的身份登錄到金蝶賬號中，在右面的菜單中找到webAPI菜單

　　　　

 

 

 　　4.2 然后再左側選擇你要生成的報表的名稱，在右面選擇你要調用的接口，就會有相應的說明。

 

 

 　　4.3 然后點擊上面的  在線測試webAPI  按鈕，出現調試框：

 

 

 　　4.4然后選擇自己要調用的接口，來填寫測試數據。

 

 

 　　4.5 填寫完成測試數據之后點擊返回數據就可以

 

 

 4.6 返回的數據最好驗證下，避免有必填項遺漏掉。操作如下：

 

 

 　　　5. 數據格式沒問題之后就可以用代碼來生成金蝶訂單了。具體操作如下：

/*判斷成功之后在進行其他操作*/
if($result['LoginResultType'] == 1){
$data_model = '{
    "Creator": "",
    "NeedUpDateFields": [],
    "NeedReturnFields": [],
    "IsDeleteEntry": "true",
    "SubSystemId": "",
    "IsVerifyBaseDataField": "false",
    "IsEntryBatchFill": "true",
    "ValidateFlag": "true",
    "NumberSearch": "true",
    "InterationFlags": "",
    "IsAutoSubmitAndAudit": "false",
    "Model": {
        "FID": 0,
        "FBillTypeID": {
            "FNUMBER": "DKSKD000001"
        },
        "FDATE": "2020-05-14 00:00:00",
        "FCONTACTUNITTYPE": "BD_Customer",
        "FPAYUNITTYPE": "BD_Customer",
        "FCURRENCYID": {
            "FNumber": "PRE001"
        },
        "FPAYORGID": {
            "FNumber": "100"
        },
        "FSETTLERATE": 1.0,
        "FSETTLEORGID": {
            "FNumber": "100"
        },
        "FSALEORGID": {
            "FNumber": "100"
        },
        "FDOCUMENTSTATUS": "Z",
        "FBUSINESSTYPE": "1",
        "FISINIT": false,
        "FEXCHANGERATE": 1.0,
        "FCancelStatus": "A",
        "FSETTLECUR": {
            "FNUMBER": "PRE001"
        },
        "FISB2C": false,
        "FIsWriteOff": false,
        "FSETTLEMAINBOOKID": {
            "FNUMBER": "PRE001"
        },
        "FISCARRYRATE": false,
        "FRECEIVEBILLENTRY": [
            {
                "FPURPOSEID": {
                    "FNumber": "SFKYT01_SYS"
                },
                "FPOSTDATE": "2020-05-14 00:00:00"
            }
        ]
    }
}';
$kingdee_info = array(
                            '你要操作訂單的表單號，測試的時候那個藍框里的內容',//業務對象標識FormId 報表不同 表單號不同，切記
                            $data_model//具體Json字串
                        );
 $post_content = create_postdata($kingdee_info);

$res = json_decode(invoke_save($this->cloudUrl,$post_content,$cookie_jar),true) ;
//可以打印$res來查看自己的報表生成結果
}

6.到此，金蝶的報表生成就結束了，需要注意的是$data_model 的json中的數據 需要換成自己的數據。注意：金蝶里好多字段都是金蝶的編碼，要做好本地系統和金蝶系統的編碼對應。寫的不好，大家不喜勿噴。或者大家有什么需要補充的可以聯系我QQ:2280037846。

也可以在下面留言。我會在第一時間回復大家