README.md

SUB-SDK-002
vatfix-sdk-python
Python SDK

STATUS: PENDING
REGISTRY: https://vatfix.eu
SNAPSHOT: https://vatfix.eu/REGISTRY_SNAPSHOT.json

Registered SDK. Identity governed by VATFIX registry.

---

Purpose

Python SDK for VATFix API transport. Emits HTTP requests to VATFix API gateway. Returns API responses.

---

What it Accepts

• API key (string)
• Customer email (string)
• VAT number queries: {"countryCode": str, "vatNumber": str}
• HTTP API requests

---

What it Rejects

• Invalid API keys
• Missing required parameters
• Invalid VAT numbers
• Non-string types for countryCode or vatNumber

---

What it Returns

• API response passthrough (dict/JSON)
• Error objects on failure
• HTTP status codes: 200, 400, 401, 403, 429, 500

---

What it Does NOT do

• Does not execute validation logic
• Does not process payments
• Does not modify VATFIX rules
• Does not cache responses
• Does not provide customer support
• Does not guarantee API availability
• Does not parse validation results
• Does not contain business rules
• Does not contain decision logic
• Does not validate VAT numbers locally

---

Termination Conditions

• API success: Response dict returned
• API failure: Error object returned
• Invalid input: Error object returned
• Network failure: Error object returned

---

Transport Only

This SDK is transport-only. See TRANSPORT_ONLY.md for constraints.

---

Last Updated: 2026-01-27