搭建Flow API，首先需要安裝知行之橋EDI系統(tǒng)，注意，F(xiàn)low API為新增功能，僅在2022版本（8336）及以后支持，如果你發(fā)現(xiàn)正在使用的產(chǎn)品沒有這個功能，可以在我們官網(wǎng)下載最新版本或者聯(lián)系我們，進行版本升級。

支持版本：知行之橋? 2022 – 22.0.8336.0以及更高版本。

1.點擊知行之橋EDI系統(tǒng)主界面右上角的齒輪圖標，進入 用戶 選項卡，點擊添加，新建一個管理員角色的用戶，并勾選API訪問選項。

2.在?添加用戶?頁面中，注意黃色提示框中出現(xiàn)的文字：“因安全原因，現(xiàn)在將是令牌最后一次明文顯示。請在保存更改前妥善保存此令牌。如果令牌丟失，可以隨時再重建新的令牌?！蔽覀冃枰獙⑸矸菡J證令牌Authtoken妥善保管，后期進行API調(diào)用時，將會用到。點擊保存變更。

3.創(chuàng)建名為FLow_API的工作區(qū)

4.在知行軟件官網(wǎng)，點擊?EDI解決方案?，即可下載示例文件。這里我們以EDI&XML格式轉(zhuǎn)換為例，下載示例工程以及示例X12文件。

5.將上述獲得的示例工程導入我們創(chuàng)建好的Flow_API工作區(qū)中。點擊右上角齒輪圖標，點擊導入工作區(qū)。

6.同時選中需要加入Flow API的多個端口。在?工作流?界面點擊第四個按鈕（選擇多個端口）

7.選中工作區(qū)中的兩個端口，點擊鼠標右鍵可以看到 創(chuàng)建工作流API 選項。

8.在彈出的界面中可以看到方法是POST，我們還可以自定義路徑名稱，這里我們將其命名為X12ToXML，點擊?創(chuàng)建工作流API?選項。

9.工作流API創(chuàng)建效果如圖：

10.點擊工作流API右上角的播放圖標，即可進入到API調(diào)用界面。

主體?部分可以上傳輸入文件，輸出文件的處理結(jié)果會顯示在右側(cè)的?響應?部分。

在主體部分，將我們上文在官網(wǎng)下載的X12示例文件粘貼進來，點擊運行。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

ISA*00*??????????*00*??????????*ZZ*WAYNE_TECH???? *ZZ*ACME?????????? *160609*1330*U*00401*000000007*0*T*>~

GS*PO*WAYNE_TECH*ACME*20160609*1330*7*T*004010~

ST*850*0001~

BEG*00*DS*0476696888**20150708~

REF*SB*ZZ11~

REF*6P*ZZ~

REF*8M*0056~

REF*CR*1070335099~

REF*CO*7109790082~

PER*CN*ACME, Inc.*TE*(555) 555-5555~

CSH*SC~

SAC*C*ZZZZ**********06~

TD5*Z*2*123456~

N9*PD*ZCOF~

MSG*Thanks!~

N1*BY*Wayne Tech*92*5601~

N2*Wayne Tech*~

N3*125 WayneHigh Road.~

N1*EN*ACME, Inc.~

N1*ST*Wayne Tech Plant 1*92*0000505462~

N2*Wayne Tech Plant 1*~

N3*100 Wayne Ave.~

N4*Chapel Hill*MX*27514*US**~

PO1**500000*EA*495*TP*BP*337S3744*VP*422242224~

PID*F****500,000 red widgets****EN~

SCH*500000*EA***002*20180708~

PO1**100*EA*395*HP*BP*337S3745*VP*422242226~

PID*F****100 blue widgets****EN~

SCH*100*EA***002*20180708~

PO1**500*EA*210*TP*BP*337S3746*VP*422201210~

PID*F****AH-0310 red widgets****EN~

SCH*500*EA***002*20180708~

PO1**150*EA*350*TP*BP*337S3747*VP*422241452~

PID*F****F-100 blue widgets****EN~

SCH*100*EA***002*20180708~

PO1**500000*EA*495*TP*BP*337S3748*VP*422244512~

PID*F****HU-021 black widgets****EN~

SCH*500000*EA***002*20180708~

PO1**1500*EA*3000*HP*BP*337S3749*VP*422241023~

PID*F****100-20J widgets****EN~

SCH*100*EA***002*20180708~

CTT*6*500100~

SE*39*0001~

GE*1*7~

IEA*1*000000007~

11.點擊運行，即可在右側(cè)看到轉(zhuǎn)換后的XML文件。

以上是在知行之橋EDI系統(tǒng)內(nèi)部的API操作演示，企業(yè)也可以使用Postman等工具訪問上文我們創(chuàng)建的API。

Postman調(diào)用演示

1.通過Postman調(diào)用Flow API，與調(diào)用知行之橋AdminAPI類似，需要在Headers處配置參數(shù)x-arcesb-authtoken，值為分配的用戶令牌，方法設(shè)置為POST，URL與Flow API 設(shè)置頁面中保持一致。

2.在Body處上傳X12示例文件，選擇?raw。

3.點擊Send，如果遇到報錯：”The content-type text\/plain is not allowed executing the API X12ToXML.”可以在Headers處取消Content-Type的勾選。

4.成功發(fā)送之后，則可以看到轉(zhuǎn)換后的XML文件，如下圖所示：

Q&A

如果出現(xiàn)無法調(diào)用的情況，可以點擊知行之橋EDI系統(tǒng)的齒輪圖標，在系統(tǒng)API中，添加受信任的IP地址，如果設(shè)為*，則表示可用于匹配任何IP地址。出于安全性考慮，這里應配置為需要訪問此API的IP地址即可。

按照以上步驟，我們成功搭建了Flow API，并通過Postman工具實現(xiàn)了X12報文到XML之間的轉(zhuǎn)換。如果你希望了解更多EDI相關(guān)信息，歡迎聯(lián)系我們。

更多 EDI 信息，請參閱:?EDI 是什么？