跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Tezga eKasa，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
Tezga eKasa 是面向塞尔维亚企业的在线税控收银机：税务设置和税率标签、已开具收据的状态和税控数据，以及银行交易。开具、作废或退还收据，以及写入客户和商品也已包含，但安装时处于关闭状态。
试试这样问
Tezga eKasa 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Tezga eKasa、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Tezga eKasa
Tezga eKasa 是面向塞尔维亚企业的在线税控收银机：税务设置和税率标签、已开具收据的状态和税控数据，以及银行交易。开具、作废或退还收据，以及写入客户和商品也已包含，但安装时处于关闭状态。
设置
设置大约需要 3 分钟。你需要一个所在套餐包含 API 访问权限的 Tezga 账号，以及一个 API key。
- API 访问包含在 Posao 和 Biznis 套餐（或 Enterprise 级别）中。其他套餐下每次调用都会返回 402。
- 在 Tezga 中打开 Podešavanja > Integracije > API ključevi，为 key 命名（例如 AnythingMCP）并创建。它只显示一次：请复制到
TEZGA_API_KEY。key 以tzg_开头，后跟 48 个十六进制字符。为这个连接器单独使用一个 key，这样就能单独暂停或删除它；在同一页面还可以把它绑定到你的 AnythingMCP 服务器的 IP 地址。 - 安装连接器并运行
tezga_get_account_setup，检查 key 并查看环境。
key 通过 X-Tezga-Api-Key 请求头发送。key 每 90 天轮换一次：Tezga 会在第 76 天发邮件提醒，你需要在旧 key 停用前把新 key 粘贴到连接器中。只读 key 足以使用读取类工具；用它写入会返回 403。
先确认环境：测试 key 和生产 key 看起来一样，因为环境属于账号。tezga_get_account_setup 会返回 okruzenje：produkcija（真实收据，会上报税务机关）、sandbox（官方测试环境）、simulacija（演示，PFR 编号以 MOCK 开头）或 nepovezano（没有安全元件，税控会被拒绝）。在任何写入之前，AI 都会先告诉你当前是哪种环境。
可读取的内容：账号的税务设置（环境、公司是否在增值税体系内并须进行税控，以及税率标签）；按 Tezga ID 查询的单据（收据、形式发票、退款），或按你的订单号（externalId）开具的单据，包括编号、类型、状态（nacrt 草稿、izdat 已开具、storniran 已作废）、含税总额、支付方式、税控数据（PFR 编号和时间、收据计数器、验证 URL；未税控时为 null），以及无需登录即可打开的公开 PDF 链接 javniPdfUrl；还有从银行对账单导入的公司银行交易，最新的在前（smer 为 uplata 表示收款、isplata 表示付款，since 指定起始时间），用于把付款与发票对账。
安装时关闭：tezga_issue_receipt（税控收据或形式发票，或在 tok 为 sef 时向 SEF 发送电子发票；按 externalId 幂等，同一个订单号永远不会生成第二张收据）、tezga_refund_document（作废或退款，以引用原单据的新单据开具）、tezga_upsert_customers 和 tezga_upsert_products（按 PIB、电子邮件或名称，或按商品编码匹配；不会删除任何内容）。税控收据无法撤销，只能退款，所以由管理员有意识地开启。即使开启后，AI 也会先给你看明细行、金额和环境，等你确认。
金额和税：价格为含增值税的 RSD（cenaSaPdv）。税率为 20、10、0 或 oslobodjeno（免税）。不在增值税体系内的公司，无论发送什么税率，每一行都记为免税。
限制：默认每家公司每分钟 240 次读取和 120 次写入；响应带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset，429 会附带 Retry-After。每张收据最多 500 行，每次调用最多 500 个客户或商品；请求体最大 512 KB。
常见错误：401 表示 key 缺失或错误。402 表示套餐不含 API 访问或订阅未激活（error 会说明是哪种）。403 表示用只读 key 写入、使用了收银终端的 key，或请求来自不在 key 列表中的 IP。404 表示该单据在你的公司中不存在。409 表示操作不被允许（未开具、已部分退款），或同一个 externalId 正在处理中。422 会在 fields 中列出字段或规则错误。写入时返回 202，表示单据已存在但税务机关尚未接受；Tezga 会自动重试，所以 AI 不会重复发送。
前提条件: TEZGA_API_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 Tezga eKasa 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
tezga_get_account_setup | Read the account's fiscal setup: the environment (produkcija = real receipts at the Tax Administration, sandbox = official test… |
tezga_get_document | Get a document (receipt, proforma, refund) by its Tezga id: number, type, status (nacrt draft, izdat issued, storniran cancelled), total… |
tezga_find_document | Find the document issued for one of your order numbers (externalId) and return its status, fiscal data (PFR number, verification URL) and… |
tezga_list_bank_transactions | List the company's bank transactions imported from statements (incoming payments and outgoing payments), newest first, for matching… |
tezga_issue_receipt | Issue and fiscalise a receipt (or a proforma) for an order: Tezga signs it at the Tax Administration (V-PFR) and returns the PFR number… |
tezga_refund_document | Cancel (storno) or refund an issued receipt |
tezga_upsert_customers | Create or update 1 to 500 customers in Tezga |
tezga_upsert_products | Create or update 1 to 500 catalogue items |
示例提示
- “我们的 Tezga 账号处于哪个环境？公司在增值税体系内吗？”
- “订单 10452 已经有税控收据了吗？给我 PFR 编号和公开 PDF 链接。”
- “列出周一以来收到的银行收款，方便我和发票对账。”
- “订单 10398 的收据是已开具还是已作废？总额是多少？”
- “我们的账号使用了哪些税率标签？每个分别对应什么税率？”
下一步
这份指南对你有帮助吗?