Company Profile & VAT Suggestion

Integrations read vatRegistered / ossRegistered / country / currency from the company profile before issuing. The vat-suggestion endpoint returns the applicable rate and reasoning for a given client — the answer to 'what would happen' before issuing.

Endpoints

GET/companyScope: read:company

Company profile: VAT/OSS registration, country, default currency, invoice prefix.

Example response

{
  "name": "Deepflow OÜ",
  "country": "EE",
  "vatRegistered": true,
  "ossRegistered": true,
  "defaultCurrency": "EUR",
  "invoicePrefix": "CRP"
}

GET/vat-suggestionScope: read:company

clientCountry (required, ISO-2), clientVatNumber, isCompany — applicable rate + reasoning + vatNote.

Example request

curl -H "Authorization: Bearer $API_KEY" \
  "https://corpenza.com/api/external/accounting/vat-suggestion?clientCountry=DE&clientVatNumber=DE123456789"

Example response

{
  "rate": 0,
  "reason": "Intra-EU B2B — Reverse Charge (VAT shifts to buyer)",
  "vatNote": "Reverse Charge - ..."
}