invoice-adapters

Integrate Taiwan e-invoice services across ECPay, EZPay, BankPro, and Amego via a unified adapter interface.

6|3|Updated Apr 8, 2022
One-click install
npx skills add https://github.com/Rytass/Utils --skill invoice-adapters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invoice-adapters
Source: https://github.com/Rytass/Utils/tree/main/.claude/skills/invoice-adapters
Command: npx skills add https://github.com/Rytass/Utils --skill invoice-adapters

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrate Taiwan e-invoice services through a unified adapter interface.

Core Features & Use Cases

  • Unified Adapter Interfaces: wraps ECPay, EZPay, BankPro, Amego invoice APIs under a single gateway interface.
  • Cross-provider Operations: supports issuing, voiding, allowances, and querying invoices; ideal for SaaS platforms serving merchants using different providers.
  • Use Case: A fintech platform onboarding merchants with different Taiwan e-invoice requirements can implement a single code path and swap adapters as needed.

Quick Start

Install the four adapters from @rytass/invoice-adapter-ecpay, @rytass/invoice-adapter-ezpay, @rytass/invoice-adapter-bank-pro, and @rytass/invoice-adapter-amego. Create gateway instances for each provider and perform a basic workflow: issue a test invoice, query its status, and void if required.

Frequently Asked Questions about invoice-adapters

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

FAQPage Schema
How do I integrate multiple Taiwan e-invoice providers in a single TypeScript application?

Integrate multiple Taiwan e-invoice providers by installing the @rytass/invoice-adapter-* packages for ECPay, EZPay, BankPro, and Amego. This unified adapter interface abstracts provider APIs, allowing a single code path to issue, void, and query invoices across different gateways.

What is a unified adapter interface for processing Taiwan e-invoices?

A unified adapter interface for Taiwan e-invoices is a standardized gateway wrapping ECPay, EZPay, BankPro, and Amego APIs. It enables cross-provider workflows for issuing, voiding, allowances, and querying invoices using consistent data models.

Can I use a single code path to issue and void invoices for merchants using different gateway providers?

Yes, you can use a single code path to issue and void invoices for merchants using different providers. The gateway interface supports cross-provider operations, allowing SaaS platforms to swap adapters as needed without altering the core implementation.

How do I issue and query a test invoice using the @rytass/invoice-adapter packages?

Issue and query a test invoice by creating gateway instances for your chosen providers using the @rytass/invoice-adapter-* packages. Perform a basic workflow by calling the issue method, querying its status, and executing a void if required.

Does the invoice-adapter gateway support invoice allowances and voiding operations across ECPay and EZPay?

Yes, the invoice-adapter gateway supports invoice allowances and voiding operations across ECPay and EZPay. It standardizes these operations along with issuing and querying, ensuring consistent data models for related operations across all supported providers.