POP CLI

POP API for European electronic invoicing workflows.

This Printing Press blueprint intentionally exposes only the documented 8-operation surface used by the POP MCP README at getpopapi/pop-mcp@07a4a19ad5e657fa94d16fe617b8288e5046c489:

• create-xml
• create-ubl
• create-pdf
• sdi-via-pop/document-notifications
• peppol/document-get
• sdi-via-pop/document-get
• sdi-via-pop/document-verify
• sdi-via-pop/document-preserve

The data payloads are intentionally modeled as free-form JSON objects so the CLI can pass through the full POP invoice structure without freezing a brittle nested schema in this catalog spec.

Upstream POP MCP changes should be reviewed periodically and intentionally synced into this print when the documented public surface evolves.

Learn more at Pop.

Created by @mircobabini (Mirco Babini).

Quick Start

1. Install

See Install above.

2. Set Up Credentials

Get your API key from your API provider's developer portal. The key typically looks like a long alphanumeric string.

export POP_API_KEY="<paste-your-key>"

You can also persist this in your config file at ~/.config/pop-pp-cli/config.toml.

3. Verify Setup

pop-pp-cli doctor

This checks your configuration and credentials.

4. Try Your First Command

pop-pp-cli create-pdf

Usage

Run pop-pp-cli --help for the full command reference and flag list.

Commands

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 JSON response.

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 invoice structure.

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.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
pop-pp-cli create-pdf

# JSON for scripting and agents
pop-pp-cli create-pdf --json

# Filter to specific fields
pop-pp-cli create-pdf --json --select id,name,status

# Dry run — show the request without sending
pop-pp-cli create-pdf --dry-run

# Agent mode — JSON + compact + no prompts in one flag
pop-pp-cli create-pdf --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Explicit retries - add --idempotent to create retries when a no-op success is acceptable
• Confirmable - --yes for explicit confirmation of destructive actions
• Piped input - write commands can accept structured input when their help lists --stdin
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

pop-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/pop-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Environment variables:

Name	Kind	Required	Description
POP_API_KEY	per_call	No	Set to your API credential.

Troubleshooting

Authentication errors (exit code 4)

• Run pop-pp-cli doctor to check credentials
• Verify the environment variable is set: echo $POP_API_KEY Not found errors (exit code 3)
• Check the resource ID is correct
• Run the list command to see available items

---

Generated by CLI Printing Press