百新谷《PCB+SMT计价系统+ERP系统V4.0 》标准API接口说明文档V2.0
百新谷《PCB+SMT计价系统+ERP系统V4.0 》标准API接口说明文档V2.0
一、同步DFM资料文件接口
1、获取所以条数访问地址:http://******/erpapi/GetOrderList.aspx?Key=O8Ii5rkLPATWKTQDW3kK******QT4ySbw82023
参数:Key(固定密钥)
2、根据id获取一条数据:
http://******/erpapi/GetOrderList.aspx?Key=O8Ii5rkLPATWKTQDW******oBWQT4ySbw82023&id=1
参数:Key(固定密钥)、id(订单id)
二、同步DFM返回的数据接口
访问地址:http://******/erpapi/downDFMdata.aspx
参数格式说明:json字符串格式
<script>
// 1.创建xhr对象
var xhr = new XMLHttpRequest();
// 2.调用open函数,决定请求方式和URL地址
xhr.open('POST', 'http://jx.buysingoo.cn/erpapi/downwip.aspx');
// 3.设置 Content-Tyep 属性(固定写法)
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
// 4.调用send,同时将数据以查询字符串的形式提交给服务器
xhr.send('[{"Qty":0,"OSP":"","OrdDate":"1899-12-30"}]');
// 5.监听 onreadystatechange 事件
xhr.onreadystatechange = function () {
if (xhr.readyState === 4 && xhr.status === 200) {
console.log(xhr.responseText);
}
}
</script>
【线上订单字段表】
ID | 订单ID(唯一) | 自动生成 |
ManagerID | 客户ID | 自动生成 |
OrderNum | 订单编号 | 自动生成 |
po_nums | 客户型号 | 自动匹配文件名 |
OrderType | 订单类型 | 1:样板2:批量 |
AddDate | 下单时间 | 自动生成 |
Status | 订单状态 | |
PayType | 支付方式 | |
RealityPayType | 是否实际到账 | 0:未到账1:已到账 |
IsPay | 客户是否支付 | Bool |
Process | 生产进度 | |
PcbFileID | 文件ID | 自动生成 |
PcbFileName | Pcb文件路径 | |
FinishDateType | 是否加急 | String类型:正常交期、12小时加急、24小时加急、48小时加急、72小时加急、96小时加急 |
FinishDate | 交期时间 | |
CheckDate | 审核时间 | |
CheckContent | 审核备注 | |
Price1 | 订单金额 | |
Price2 | 付款金额 | |
IsReturn | 是否返单 | Bool |
SendDate | 发货时间 | |
EmsCompanyName | 快递公司 | |
EmsOrderNum | 快递单号 | |
IsComplete | 是否已同步 | Bool |
IsDelete | 是否删除 | Bool |
SaleID | 业务员ID | |
HeTongnum | 合同编号 | 自动生成 |
gcnums | 生产编号 | 自动生成 |
chuhuoType | 出货方式 | 单片出货、客户拼版、JX代拼 |
FileName | Pcb文件名 | |
Width | Pcs宽 | mm |
Length | Pcs长 | mm |
setwidth | Set宽 | mm |
setlength | Set长 | mm |
Nums | 连片数量 | set |
Numspcs | 单片数量 | pcs |
PinbanX | X方向拼版数 | |
PinbanY | Y方向拼版数 | |
PinbanNum | 拼版数量 | |
PinbanMode | 拼版方式 | 几拼几,例如:2*3 |
biandir | 工艺边 | 无、宽边、长边、四周 |
bianwidth | 工艺边宽 | mm |
Cailiao | 板子材料 | FR-4 普通TG、FR-4 中TG、FR-4 高TG、HDI 普通TG、HDI 中TG、HDI 高TG、FPC、软硬结合板、高频板、高速板、铝基板、其他自定义 |
PingBan | 合拼款数 | |
Layers | 板子层数 | 2、4、6、8、10、自定义 |
BoardThickness | 板子厚度 | 0.4、0.6、0.8、1.0、1.2、1.6、2.0、自定义 |
SolderColor | 阻焊颜色 | 绿色、红色、黄色、蓝色、白色、黑色、亚绿色、亚黑色、其他自定义 |
FontColor | 字符颜色 | 白色、黄色、黑色、其他自定义 |
PlatingType | 表面处理 | 有铅喷锡、无铅喷锡、osp、沉金、镀金、沉银、沉锡、镍钯金、沉金_OSP |
PlatingType1 | 金厚 | 1、2、3、其他自定义 |
Zhfg | 阻焊覆盖 | 过孔盖油、过孔塞油、过孔开窗、树脂塞孔 |
TestType | 测试方式 | 飞针测试、工程测试架 |
CopperThickness | 外层铜厚 | 1oz、2oz、其他自定义 |
CopperThickness2 | 内层铜厚 | 0.5oz、1oz、2oz、其他自定义 |
Bill | 需要发票
| 不需要、增值税专票累计开票、增值税专票随货发、企业电子普票、个人电子普票 |
ExpressType | 收货省份 | 自动生成 |
Note | 订单下单备注 | 下单时客户输入 |
Lineweight | 最小线宽/线距
| 3/3mil、4/4mil、5/5mil、6/6mil、8/8mil、10/10mil、20/20mil |
Bga | 是否有BGA | 是、否 |
Vias | 最小孔径
| 0.15、0.2、0.25、0.3、0.35 |
Blind | 板材品牌
| 无要求、生益、南亚、联茂、其他自定义 |
Impendance | 是否阻抗 | 是、否 |
fonttag | ||
cxType | 成型方式 | VCUT、邮票孔、桥连 |
requirements | 特殊工艺 | 半孔 沉孔 压接孔 控深钻 金属包边 背钻 控深铣 不流动PP 台阶板 双面胶 茶色胶 序列号 批次号 内倒角 批次号 线性电阻 条形码 无卤素 光模块 混压板 3M胶 点胶 低阻测试 PI补强 钢片补强 FR4补强 镂空板 |
area | 订单面积 | mm² |
drConductivity | 导热系数 | 1、2、3 |
BaoZhuang | 纸盒要求 | 1:带我司logo盒子 2:空白盒子 |
shengchangao | 确认生产稿 | 需要、不需要 |
TestReport | 出货报告 | COC证书 电测报告 最终检查报告 可焊性报告 热应力检测报告 金相切片报告 镀层厚度报告 离子污染报告 |
ReportMaterial | 报告材质 | 电子、纸质 |
siyin1 | 是否加UL标记 | 是、否 |
siyin2 | 是否加周期 | 是、否 |
siyin3 | 是否加生产编号 | 加、不加 |
IPCvalue | 验收标准 | IPC二级、IPC三级 |
PlatingTypefj | 附加表面处理 | 金手指、碳油、蓝胶 |
Isqiepian | 是否切片 | 是、否 |
WhitePaper | 是否隔白纸 | 是、否 |
LayersXu | 指定层序 | L1:’’,L2:’’,L3:’’,L4:’’... |
LaminateDetails | 层压结构 | Json字符串 |
三、同步线上订单到ERP系统接口
需甲方提供接口,线上系统调用写入订单
四、同步生产进度WIP接口
访问地址:http://******/erpapi/downwip.aspx
参数格式说明:json字符串格式,字段名不受限制,根据贵司的名字传入,例如:
[{”TempNo”:”ERP订单编号”,”CustID”:”客户编号”,”ProdDesc”:”当前工艺”,”ProdNo”:”生产编号”,”PCSQty”:”生产数量”,”WebQuotID”:”线上订单ID”}]
<script>
// 1.创建xhr对象
var xhr = new XMLHttpRequest();
// 2.调用open函数,决定请求方式和URL地址
xhr.open('POST', 'http://jx.buysingoo.cn/erpapi/downwip.aspx');
// 3.设置 Content-Tyep 属性(固定写法)
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
// 4.调用send,同时将数据以查询字符串的形式提交给服务器
xhr.send('[{"Qty":0,"OSP":"","OrdDate":"1899-12-30"}]');
// 5.监听 onreadystatechange 事件
xhr.onreadystatechange = function () {
if (xhr.readyState === 4 && xhr.status === 200) {
console.log(xhr.responseText);
}
}
</script>
五、同步EQ接口
访问地址:http://******/erpapi/GetEQList.aspx?key=O8Ii5rkLPATWKTQDW3kKzxiHMJoB******w82023&action=add&orderid=1&ID=1
参数:
action | 值:add (必须) |
ID | ID(新增EQ时非必须、回复EQ是必须) |
OrderID | 订单ID (必须) |
key | O8Ii5rkLPATWKTQ******WQT4ySbw82023 (必须) |
1、add 【添加/回复EQ】
<script>
// 1.创建xhr对象
var xhr = new XMLHttpRequest();
// 2.调用open函数,决定请求方式和URL地址
xhr.open('POST', 'http://******/erpapi/GetEQList.aspx?key=O8Ii5rkLPATWKTQDW3kK******Sbw82023&action=add&ID=1');
// 3.设置 Content-Tyep 属性(固定写法)
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
// 4.调用send,同时将数据以查询字符串的形式提交给服务器
xhr.send("[{ no: 1,issueDescription: 'EQ描述',issueSuggestion: 'EQ建议内容',issueStatus: 'EQ回复状态',issueReply: 'EQ回复结果',issueReplyNotes: 'EQ回复备注',issueCreatTime: '提出时间',issueCreator: '提出人',issueReplyTime: '回复时间',issueReplyPerson: '回复人员'},{PicName:'图片1',Value:'2342'},{PicName:'图片2',Value:'2342'}]");
// 5.监听 onreadystatechange 事件
xhr.onreadystatechange = function () {
if (xhr.readyState === 4 && xhr.status === 200) {
console.log(xhr.responseText);
}
}
</script>
2、get 【获取EQ列表】
http://******/erpapi/GetEQList.aspx?Key=O8Ii5rkLPATWKTQDW3kKzxiH******Sbw82023&action=get&ID=1&orderid=2
参数:Key(固定密钥)
action | 值:get (必须) |
ID | ID(非必须) |
orderid | 订单ID(非必须) |
【EQ字段】
eqItem =[
{no:1,issueDescription:'EQ描述',issuePic:'EQ描述图片[binary stream|null]',issueSuggestion:'EQ建议内容',issueStatus:'EQ回复状态[close|open|cancel|delete]',issueReply:'EQ回复结果[OK|NG]',issueReplyNotes:'EQ回复备注',issueCreatTime:'提出时间',issueCreator:'提出人',issueReplyTime:'回复时间',issueReplyPerson:'回复人员'},
{no:2,issueDescription:'EQ描述',issuePic:'EQ描述图片[binary stream|null]',issueSuggestion:'EQ建议内容',issueStatus:'EQ回复状态[close|open|cancel|delete]',issueReply:'EQ回复结果[OK|NG]',issueReplyNotes:'EQ回复备注',issueCreatTime:'提出时间',issueCreator:'提出人',issueReplyTime:'回复时间',issueReplyPerson:'回复人员'},
……
{no:N,issueDescription:'EQ描述',issuePic:'EQ描述图片[binary stream|null]',issueSuggestion:'EQ建议内容',issueStatus:'EQ回复状态[close|open|cancel|delete]',issueReply:'EQ回复结果[OK|NG]',issueReplyNotes:'EQ回复备注',issueCreatTime:'提出时间',issueCreator:'提出人',issueReplyTime:'回复时间',issueReplyPerson:'回复人员'},
]