用途:openipa-pp-cli 驱动 IndicePA(意大利公共行政索引)数据,供处理意大利公共机构(PA)的智能体与流程使用,可查询机构注册信息、PEC、电子发票接收代码(SDI)、NSO 订单节点与数字化住所。
主要能力:
- cf:按税号一次性检查机构是否启用 SFE、NSO 及数字化住所,输出合规清单。
- fatturazione cf:返回该税号可用的 cod_uni_ou,用于电子发票 XML 抬头。
- fatturazione batch:从 stdin 读取税号,并行调用后以 NDJSON 返回。
- enti tree:输出机构及其 AOO、UO 的树形结构。
- domicilio verifica:判断 PEC 是活跃、历史还是未知。
- cerca:按邮箱/PEC 反查所属机构、AOO 或 UO。
- 其他命令:aoo、enti、nso、pec、uo、servizi、sede、rtd 等,覆盖机构搜索、组织结构、服务目录与数字化负责人查询。
安装与用法:需先安装 CLI。 npx -y @mvanhorn/printing-press-library install openipa --cli-only 验证:openipa-pp-cli --version 备用安装(需 Go 1.26.6+): go install github.com/mvanhorn/printing-press-library/library/developer-tools/openipa/cmd/openipa-pp-cli@latest
需在 indicepa.gov.it 注册免费 AUTH_ID,保存为环境变量 IPA_auth_id 或 ~/.config/openipa/config.toml。用 openipa-pp-cli doctor 验证配置。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。
限制:部分命令(servizi、sede、rtd)走 IPA 门户而非官方 API,无需 AUTH_ID。--nome 在 sede 仅接受单个关键词。aoo cerca 需 7 位 cod_uni_aoo。--select 可裁剪字段以减小上下文。反馈默认仅本地存储。