{"openapi":"3.0.3","info":{"title":"EU Cross-Border VAT Rate & Reverse-Charge Calculator API","version":"1.0.0","description":"Determines EU VAT treatment across all 27 Member States (domestic, intra-EU B2B Article 196 Reverse Charge, B2C OSS destination rules, and extra-EU exports), validates buyer VAT checksums, and outputs multilingual invoice exemption clauses."},"servers":[{"url":"https://api.tinplate.dev","description":"Production Edge Gateway"}],"components":{"schemas":{"EuVatCalculatorResponseData":{"type":"object","properties":{"regime":{"type":"string","enum":["domestic_taxable","eu_b2b_reverse_charge","eu_b2c_oss_destination","export_outside_eu","non_eu_transaction"],"example":"eu_b2b_reverse_charge"},"seller_country":{"type":"string","example":"HU"},"buyer_country":{"type":"string","example":"DE"},"tax_jurisdiction":{"type":"string","example":"DE"},"buyer_is_business":{"type":"boolean","example":true},"buyer_vat_format_valid":{"type":"boolean","nullable":true,"example":true},"applied_vat_rate":{"type":"number","example":0},"standard_rate_in_jurisdiction":{"type":"number","example":19},"peppol_tax_category":{"type":"string","enum":["S","Z","AE","G","O"],"example":"AE","description":"UNCL5305 / Peppol BIS 3.0 Tax Category code (S=Standard, AE=Reverse Charge, G=Export, Z=Zero)."},"net_amount":{"type":"number","example":200},"vat_amount":{"type":"number","example":0},"gross_amount":{"type":"number","example":200},"directive_reference":{"type":"string","example":"Council Directive 2006/112/EC Articles 44 & 196 (Intra-EU B2B Reverse Charge)"},"invoice_legal_notice":{"type":"object","properties":{"en":{"type":"string","example":"Reverse charge — VAT to be accounted for by the recipient pursuant to Article 196 of Council Directive 2006/112/EC."},"de":{"type":"string","example":"Steuerschuldnerschaft des Leistungsempfängers (Reverse-Charge-Verfahren gem. § 13b UStG / Art. 196 MwStSystRL)."},"fr":{"type":"string","example":"Autoliquidation de la TVA par le preneur (Article 196 de la directive 2006/112/CE)."},"hu":{"type":"string","example":"Fordított adózás — az áfát a szolgáltatás igénybevevője fizeti meg (2006/112/EK irányelv 196. cikk)."}},"required":["en","de","fr","hu"]}},"required":["regime","seller_country","buyer_country","tax_jurisdiction","buyer_is_business","buyer_vat_format_valid","applied_vat_rate","standard_rate_in_jurisdiction","peppol_tax_category","net_amount","vat_amount","gross_amount","directive_reference","invoice_legal_notice"]},"EuVatCalculatorRequest":{"type":"object","properties":{"seller_country":{"type":"string","minLength":2,"maxLength":2,"example":"HU","description":"2-letter ISO country code of the seller (e.g. 'HU', 'DE')."},"buyer_country":{"type":"string","minLength":2,"maxLength":2,"example":"DE","description":"2-letter ISO country code of the buyer (e.g. 'DE', 'US', 'GB')."},"buyer_vat_number":{"type":"string","maxLength":32,"example":"DE123456789","description":"Optional buyer EU VAT number (validated offline via country checksum rules)."},"amount":{"type":"number","minimum":0,"exclusiveMinimum":true,"maximum":1000000000,"example":200,"description":"Transaction amount to calculate VAT for."},"amount_type":{"type":"string","enum":["net","gross"],"default":"net","example":"net","description":"Whether 'amount' is net (exclusive of VAT) or gross (inclusive of VAT)."},"supply_type":{"type":"string","enum":["digital_saas","b2b_services","physical_goods","reduced_rate"],"default":"digital_saas","example":"digital_saas","description":"Category of goods or services supplied."}},"required":["seller_country","buyer_country","amount"]},"ResponseMeta":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"ms":{"type":"integer","minimum":0},"version":{"type":"string","example":"1.0.0"}}},"ErrorEnvelope":{"type":"object","required":["ok","error","meta"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_input"},"message":{"type":"string","example":"Request body failed validation"}}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}},"parameters":{}},"paths":{"/v1/eu-vat-calculator":{"post":{"tags":["40_EU_VAT_CALCULATOR"],"summary":"Determine EU cross-border VAT rates, Article 196 B2B Reverse Charge, B2C OSS destination rates, and mandatory multilingual invoice exemption notices","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EuVatCalculatorRequest"}}}},"responses":{"200":{"description":"Calculated EU VAT regime, applied tax rate, Peppol tax category, and legal invoice text","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/EuVatCalculatorResponseData"},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["ok","data","meta"]}}}},"400":{"description":"Invalid input or malformed JSON request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing or invalid authentication credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"Request payload exceeds subscribed plan byte cap","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}