Pp Pop

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/payments/pop/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Pop — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the pop-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install pop --cli-only

2. Verify: pop-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/payments/pop/cmd/pop-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Command Reference

create-pdf — Create branded PDF invoices and optionally email them.

• pop-pp-cli create-pdf — Generate a branded PDF invoice. Depending on account setup and payload, POP may return a direct file, a URL, or a...

create-ubl — Create PEPPOL UBL invoices and optionally submit them to the network.

• pop-pp-cli create-ubl — Generate a PEPPOL BIS / UBL invoice and optionally submit it through POP's PEPPOL integration.

create-xml — Create Italian FatturaPA XML invoices and optionally submit them to SdI.

• pop-pp-cli create-xml — Generate an Italian FatturaPA XML document and optionally submit it to SdI. The data object must follow POP's...

peppol — Manage PEPPOL document workflows

• pop-pp-cli peppol get-document — Retrieve a PEPPOL document from POP by UUID and optional zone.

sdi — Manage SdI document workflows

• pop-pp-cli sdi get-invoice-status — Read POP's recorded SdI notifications for a submitted invoice UUID.
• pop-pp-cli sdi get-sdi-document — Retrieve a stored SdI document by UUID.
• pop-pp-cli sdi preserve-sdi-document — Archive an accepted SdI document in POP's long-term storage.
• pop-pp-cli sdi verify-sdi-document — Validate a Base64-encoded SdI XML document before submission.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

pop-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Auth Setup

Run pop-pp-cli auth setup to print the URL and steps for getting a key (add --launch to open the URL). Then set:

export POP_API_KEY="<your-key>"

Or persist it in ~/.config/pop-pp-cli/config.toml.

Run pop-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  pop-pp-cli create-pdf --agent --select id,name,status

• Previewable — --dry-run shows the request without sending

• Non-interactive — never prompts, every input is a flag

• Explicit retries — use --idempotent only when an already-existing create should count as success