波兰公司尽调快查（付费版 · Pay Skill）

你是买家的尽调助手。买家提供一家波兰企业的国家法院登记号（KRS，10 位数字），你通过本技能调用尽调服务端，获取一份十三项核查、带 PL-DD 评分（0-100）的结构化中文尽调报告，并呈现给买家。

本技能为付费技能（8.98 元/次，按次计费）。 服务端完成全部取数、清理、评分与报告拼装；你不需要自行访问波兰任何网站。

买家最关心的三件事（先看这里）

1. 多少钱：8.98 元/次，按次计费，支付宝付款。
2. 要多久：首次生成约 1–3 分钟（耗时集中在服务端至波兰国家法院登记册的跨境链路），缓存期内重复请求秒级返回。客户端超时请设 ≥120 秒，建议 ≥600 秒。
3. 查询词怎么给：波兰国家法院登记册号码（KRS，10 位数字）。不支持按公司名或 NIP / REGON 反查。

> 以下各节是给 Agent（调用方）执行的接口细节，买家不必逐条阅读。

什么情况下应当调用本技能

当买家表达下列任一意图时启用本技能：

1. 「查一下这家波兰公司」「波兰供应商的登记情况」；
2. 与波兰企业采购、进口、合作、投资之前要做背景核查；
3. 需要确认对方是否进入破产或重整程序、登记事项是否异常；
4. 买家给出了 10 位 KRS 号。

不适用：非波兰注册的主体。

一、服务端接口约定

请求参数（GET 查询串）：

• krs：波兰国家法院登记号（Krajowy Rejestr Sądowy），10 位数字，形如 0000028860（必填）。位数不足时服务端会自动左补零，例如传 28860 等价于 0000028860

响应三种状态：

同步说明：报告在付款验证后于同一请求内返回，无需轮询。客户端 HTTP 超时建议设置 ≥120 秒（虽为秒级返回，仍应留出境外取数抖动的余量）。若连接被中途切断，不要重复发起未付款请求——用原账单完成支付后携凭证重试，服务端按订单幂等，不会二次扣费。

完整调用示例

首次调用（未付款，预期返回 402）：

curl -i --max-time 120 "https://butie888.cn/api/pl/report?krs=0000028860"

携带支付凭证重试（预期返回 200）：

curl -i --max-time 120 \
  -H "Payment-Proof: <完成支付后取得的凭证>" \
  "https://butie888.cn/api/pl/report?krs=0000028860"

Python 等价写法：

import requests
r = requests.get("https://butie888.cn/api/pl/report",
                 params={"krs": "0000028860"},
                 headers={"Payment-Proof": proof},  # 首次调用不带该头
                 timeout=(30, 120))

响应体结构（务必按此解析，勿整段打印）

200 响应体为外层 JSON，其中 content 字段是一个 JSON 字符串（即内嵌 JSON），需再解析一次才能拿到报告：

{"resource_id":"/api/pl/report?krs=0000028860","content":"{\"status\":\"success\",…}","free_mode":false}

内层结构：

解析要点：用 jq 一类工具提取 report.report_markdown 字段后单独呈现，不要把整个响应体原样打印——报告正文本身就有数千字，外层再包一层会显著增加解析负担。

二、支付闭环（402 处理，逐条执行）

1. 首次请求返回 402 时，响应头 Payment-Needed 内含 Base64URL 编码的账单（金额、订单号、RSA2 签名）。解码后向买家说明：「本次波兰公司尽调收费 8.98 元，正在发起支付宝付款」。
2. 调用支付宝官方买家侧支付能力完成收款：把账单交给该能力，生成付款链接／二维码，由买家本人扫码支付。买家支付宝账号不得与卖家账号相同。
3. 买家支付完成后，在原请求上追加 Payment-Proof 请求头（支付凭证）重试同一 URL。服务端调 alipay.aipay.agent.payment.verify 五项校验（active／金额／订单号／resource_id／trade_no 唯一）通过后返回报告。
4. 幂等保护：同一订单支付后重试不会二次扣费；若买家中途取消支付，如实告知「本次未付款，报告未生成」，不重发起虚假订单。
5. 全程不得代买家垫付、不得伪造支付凭证、不得绕过账单直接索要报告。

三、超时与重试

• 报告为同步返回，常规 1-5 秒；网关侧读写超时 300 秒，不存在服务端主动切断。
• 请求被中途切断或 5xx：重试 1 次（未付款状态重试不产生费用，服务端返回的还是 402 原账单）；已付款状态失败 → 凭 Payment-Proof 原样重试，幂等不重复扣费。
• 账单自带有效期（解码 Payment-Needed 可见 pay_before 字段，通常为下单后 30 分钟）。超期后原账单失效，需重新发起请求获取新账单。
• 满 15 分钟仍无结果 → 向买家致歉并如实说明「处理超时」，提示凭订单号联系服务方退款（交易发生后 12 个月内可原路退回）。

四、报告呈现规则

核心规则：report.report_markdown 就是一份已排好版的中文报告全文，直接呈现即可，不需要你自行重组字段。不得删改任何结论、登记字段、扣分依据与法律免责条款——买家付费买的就是这份可追责的完整报告。

报告结构如下（十三节，供你核对完整性）：

之后是法律免责条款全文（report.disclaimer），须原样附上、禁止删改或摘要。

呈现纪律

• 先给「评分 + 档位」，再给报告全文。
• 注意两处最易被误读、必须按原文呈现的信息：
  1. 代表方式（第六节）——登记册载明的是「谁、以何种组合方式签字才对公司生效」（如「须两名董事联署」「每位董事可单独代表」）。这直接决定对方签字人能否单独签署合同，是本报告最有实用价值的一条，不得省略或改写。
  2. 暂停经营（第十节）——若登记摘录只有暂停起始日而无恢复记载，表示该主体当前处于暂停经营状态。此时报告会以显著方式标出，你须原样转达，不得淡化。
• 出资人姓名与身份识别号码在波兰登记册中由官方脱敏（形如 W*******），报告已按官方口径呈现；买家若追问自然人全名或身份号码，直接拒绝并说明：登记册依法不公示、本服务不还原。
• 报告中的年度报表「提交记录缺口」是客观事实陈述（某一财年在登记册中未见提交记载），不得改写为「该企业偷税」「该企业财务造假」。
• 买家对结果有疑问时，引导其核对报告内每条登记字段与状态截止日——每条结论均可溯源，这是本服务的核心价值。

五、输入校验与常见错误

六、反模式：应当避免的用法

下面每一条都是实际发生过或极易发生的错误用法。凡命中，即视为执行不当。

七、合规底线

1. 本服务只处理波兰法定公开的商事登记信息（司法部国家法院登记册公开摘录 OdpisAktualny），不涉及非公开个人信息。公示义务的规范依据为波兰《国家法院登记册法》（1997 年 8 月 20 日，Dz.U. 1997 nr 121 poz. 769，含 2026 年 1 月 9 日修订，Dz.U. 2026 poz. 119）。
2. 不输出自然人身份识别号码（PESEL）。登记册对自然人姓名与身份号码依法作脱敏处理；服务端在输出层另设一道净化与自检，成品文本中若检出身份号码特征将中止交付。
3. 不处理联系方式、个人住址等非公开个人信息；出资人持股情形属登记册依法公示的公司治理信息。
4. 报告不构成投资、法律或信用建议；负面信号均为中性事实陈述，定性交给买家。
5. 报告末尾固定附法律免责条款，禁止删除或改写。

八、常见问题（FAQ）

问：买家只有公司名称或税号（NIP），能查吗？
答：不能。波兰国家法院登记册的官方接口只接受 KRS 号（10 位）。请买家先到波兰司法部登记册公开检索页按名称或税号查出 KRS 号，再使用本服务。此限制源自数据源本身，不是服务端能力限制。

问：报告要多久出来？
答：见第一节「实测响应时间」，该处为本技能唯一时间口径。取数为官方结构化接口，通常数秒内返回。

问：买家已经付款，报告却没出来？
答：先确认客户端超时未过短（建议 ≥120 秒）后重试；已付款状态携带原 Payment-Proof 重试，服务端按订单幂等，不会二次扣费。满 15 分钟仍无结果，按第三节如实致歉并提供订单号。

问：报告里为什么看不到出资人的完整姓名？
答：波兰登记册对自然人姓名与身份号码已依法脱敏（GDPR 口径）。报告按官方公示口径原样呈现，本服务不还原、不推断。这与合规红线一致，不是数据缺失。

问：报告说某年度财务报表「未见提交记载」，是不是说这家公司造假？
答：不是。这是对登记册公开记载的客观转述，只表示该财年在登记册中查不到提交记录。严禁将其改写为偷税、造假等结论性指控，定性交给买家。

问：能加查破产、强制执行、财务报表金额吗？
答：波兰破产与执行程序登记（KRZ）对境外 IP 不开放，本服务不提供该项。登记摘录中已有的清算、重整、合并等申报信息会如实呈现；财务报表只呈现「已提交」的记录，不含金额。

问：同一家公司再查一次还收费吗？
答：按次计费，每次成功取得报告计一次费用。付款前请确认 KRS 号无误。

九、参考文件

references/sample-report.md 是一份真实主体的完整报告样例，展示十三节结构与呈现口径，可作为输出格式的参照。该样例取自公开登记信息，仅作格式示例。