popbill

Calls Popbill APIs for Korean tax invoices, cash receipts, messaging, and business lookups.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill popbill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: popbill
Source: https://github.com/NomaDamas/k-skill/tree/main/popbill
Command: npx skills add https://github.com/NomaDamas/k-skill --skill popbill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires popbill, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Korean businesses need to issue electronic tax invoices, statements, cash receipts, and send SMS/KakaoTalk/fax messages through Popbill, but wiring up the SDK, managing secrets, and separating test from production environments is error-prone. This Skill wraps the entire Popbill SDK in a guarded CLI so an AI agent can call any service method safely.

Core Features & Use Cases

  • Full Popbill SDK coverage: Exposes taxinvoice, statement, cashbill, message, kakao, fax, closedown, bizinfo, easyfin-bank, account-check, and HomeTax collection services through one generic call command.
  • Safety-gated mutations: Issuing, sending, canceling, or deleting requires an explicit --yes-i-understand flag, and production mutations additionally require --no-test --allow-production.
  • Secret management: Resolves LinkID, SecretKey, and corp number from environment variables, agent vaults, or a permission-checked ~/.config/k-skill/secrets.env file without ever printing secret values.
  • Use Case: A freelancer asks the agent to register and issue a test electronic tax invoice; the agent builds the payload from the provided template, gets user approval, and runs the call against the Popbill test environment.

Quick Start

Ask the agent to run the popbill config-check command to verify your Popbill secrets, then request a closedown lookup or a test tax invoice issuance with your approval.

Frequently Asked Questions about popbill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I issue an electronic tax invoice with the Popbill API?

Build a taxinvoice payload from the object-template output, save it as JSON, then call the taxinvoice registIssue method with --args-json pointing to that file. Issuance is a mutation, so you must pass --yes-i-understand after explicit user approval.

What Popbill services does this CLI support?

It exposes twelve Popbill SDK services: taxinvoice, statement, cashbill, message, kakao, fax, closedown, bizinfo, easyfin-bank, account-check, ht-taxinvoice, and ht-cashbill. Every SDK method on these services is reachable through the generic call subcommand.

How do I switch from the Popbill test environment to production?

The CLI defaults to the test environment. Pass --no-test to target production, and for any mutation in production you must also pass --allow-production plus --yes-i-understand with current-turn user approval.

Why does the Popbill CLI fail with a secrets file permission error?

The loader rejects ~/.config/k-skill/secrets.env unless its permissions are exactly 0600. Run chmod 600 on the file, and confirm the required variables such as KSKILL_POPBILL_LINK_ID and KSKILL_POPBILL_SECRET_KEY are set.

Can the agent send SMS or KakaoTalk messages without my approval?

No. Send, issue, cancel, delete, and similar methods are classified as dangerous and blocked unless --yes-i-understand is passed after your explicit approval. Even in the test environment, messages may reach real recipients or incur charges.