公司信息与税率建议

集成在开票前从公司信息读取 vatRegistered / ossRegistered / 国家 / 货币。vat-suggestion 返回适用税率及理由。

接口

GET/company权限: read:company

公司信息：增值税/OSS 登记、国家、默认货币、发票前缀。

响应示例

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

GET/vat-suggestion权限: read:company

clientCountry（必填，ISO-2）、clientVatNumber、isCompany — 适用税率 + 理由 + vatNote。

请求示例

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

响应示例

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