NC 数据对接
作用：当机明把 NC 程序写到磁盘后，自动通知贵司系统「有哪些 NC、在哪里、谁做的」，方便 MES / ERP / 车间系统登记、流转或拉取程序，无需人工再拷文件、再报工。
- 做什么：后处理输出 NC，或串联合并写出 NC 之后，机明向贵司配置的网址发送一次 HTTP POST（JSON）。默认只告知文件名与本机路径；需要时也可把 NC 文件内容一并传过去。
- 不做什么：不是把程序直接传到机床（机床上传仍用串联里的目录 / FTP / 串口等）；也不是程序单 JSON 对接（那是另一套接口）。
- 谁受益：已有或自建接收服务的工厂，希望「出 NC 即同步」到生产管理系统。
适用条件：机明为标准版及以上，并配置
系统配置模板\NC提交.txt。与程序单数据对接相互独立。
下一步阅读
| 页面 | 用途 |
|---|---|
| NC 接收端演示与联调 | 演示程序、配置示例、PowerShell 自测 |
| NC 接收端源码 | 完整 Program.cs 在线浏览与源码包下载 |
| JmNcReceiver-src.zip | 接收端完整源码压缩包 |
| sample-nc-submit.json | 路径模式样例 JSON |
开通与配置
按下面配置后，机明在写出 NC 时会自动向贵司地址推送通知（见上文「作用」）。配置文件放在机明启动目录：
系统配置模板\NC提交.txt示例：
# 机明 NC 对外提交
Enable=true
URL=http://127.0.0.1:1235/
TimeoutSeconds=60
IncludeContent=false
Gzip=false| 配置项 | 必填 | 说明 |
|---|---|---|
Enable | 建议 | false / 0 关闭（静默）。缺省或其他值视为开启。 |
URL | 是 | 贵司接收地址。为空则不提交。 |
TimeoutSeconds | 否 | 超时秒数，缺省 60。 |
IncludeContent | 否 | true 时附带 Base64 文件内容；缺省 false（只传路径）。 |
Gzip | 否 | 仅 IncludeContent=true 时有意义；先 gzip 再 Base64。 |
修改后一般需重启机明。触发时机：后处理写出 NC（
source=Post）或串联合并写出 NC（source=Merge）。
通信协议
| 项 | 约定 |
|---|---|
| Method | POST |
| Header | Content-Type: application/json; charset=utf-8 |
| Body | UTF-8 JSON；根节点为数组（本批一个或多个 NC） |
| 成功 | HTTP 2xx |
| 失败 | 非 2xx |
当前版本不强制鉴权 Header。
JSON 结构
| 字段 | 说明 |
|---|---|
fileName | 文件名 |
filePath | 本机绝对路径 |
equipmentBrand | 后处理名；串联时可能为空 |
uploadUser | 员工名等 |
source | Post 或 Merge |
projectName | 项目名 |
fileStream | 可选 Base64 内容 |
fileStream-encoding | 如 gzip+base64 |
样例：samples/sample-nc-submit.json。
联调步骤
- 按 NC 接收端演示与联调 启动演示程序（默认
http://127.0.0.1:1235/）。 - 配置机明
NC提交.txt。 - 后处理输出 NC，或串联写出 NC。
- 在演示程序
Received\查看落盘；机明应提示提交完成。
常见问题
没有任何请求？
检查标准版及以上、配置文件、Enable/URL、是否写出 NC。
对接方读不到路径？
路径模式要求共享盘或同机代理；否则设 IncludeContent=true。
与机床「上传 NC」的关系？
无关。机床上传是目录/FTP/串口/FOCAS；本接口面向业务系统。