JSON을 검증된 Peppol 전자 세금계산서(e-invoices)로 즉시 변환하는 API

저는 B2B SaaS 창업자들의 거대한 엔지니어링 골칫거리인 유럽 전자 세금계산서(e-invoicing) 준수 문제를 해결하기 위해 UBL API (https://www.ublapi.com)를 구축했습니다.

만약 여러분이 EU(유럽 연합)에서 비즈니스를 수행하는 소프트웨어를 개발하고 있다면, Peppol 또는 XRechnung XML 형식을 요구하는 법적 명령에 직면할 가능성이 높습니다. 공식 UBL (Universal Business Language) 사양은 믿기지 않을 정도로 방대합니다. 엄격한 유럽 스키마 검증기(schema validators)를 통과하기 위해서만 처음부터 준수 가능한 XML 생성기를 작성하는 데 수 주간의 시행착오가 필요합니다.

저는 이 전체 프로세스를 여러분의 코드베이스에서 추상화하기 위해 이 API를 만들었습니다. 깔끔한 JSON 페이로드(payload)를 POST하면, API는 공식 검증 규칙에 따라 즉시 확인된 유효한 Peppol/XRechnung XML을 반환합니다.

기술 스택 및 과제:

내부적으로 이 서비스는 어떤 Next.js/Node 앱에도 바로 적용할 수 있도록 설계된 서버리스(serverless) 아키텍처입니다.

핵심(Core): Vercel에 배포된 Next.js App Router.

데이터베이스(Database): Prisma로 관리되는 Supabase (PostgreSQL).

에지 보안(Edge Security): 프록시 남용을 방지하기 위한 슬라이딩 윈도우(sliding-window) IP 속도 제한(rate limiting)을 위한 Upstash Redis.

결제/제한(Billing/Limits): 결제를 위한 Paddle.

동시 부하 상황에서 서버리스 커넥션 풀링(connection pooling)과 원자적(atomic) API 할당량 증가를 안정적으로 구현하는 것이 이 인프라를 구축하는 데 가장 어려운 부분이었습니다. 결국 동시성 할당량 우회를 방지하기 위해 엄격한 원자적 데이터베이스 잠금(atomic database locks)과 멱등성(idempotent) 웹훅을 작성해야 했습니다.

신용카드 없이도 XML 생성 및 검증을 테스트할 수 있도록 영구적인 무료 티어(월 50회 API 호출)가 제공됩니다.

API 문서, JSON 스키마 설계에 대한 피드백이나 검증기가 놓치는 예외 케이스(edge cases)를 발견하신다면 언제든 환영합니다!

여기에서 확인하세요: https://www.ublapi.com/