Transaction Type

Transaction Type

Determine transaction type and reverse charge applicability based on issuer and customer information.
Uses VIES (VAT Information Exchange System) validation internally for EU tax numbers.

Endpoints

IntroductionPOST/transaction-type/check

Check transaction type

POST/transaction-type/check

Check transaction type and reverse charge applicability based on issuer and customer information.

Country Resolution:
- Country names are automatically resolved to ISO country codes (handles variations like "Slovenija" → "SI")
- If both country and country_code are provided, country_code takes precedence

Transaction Types:
- domestic: Same country for issuer and customer
- intra_eu_b2b: Cross-border EU sale to business with valid tax number
- intra_eu_b2c: Cross-border EU sale to consumer (no tax number)
- 3w_b2b: Non-EU sale to business (with tax number)
- 3w_b2c: Non-EU sale to consumer (no tax number, or is_end_consumer=true)

Reverse Charge:
Applies when:
- Issuer is an EU tax subject
- Customer is in a different EU country with valid tax number, OR customer is outside EU

End Consumer Override:
When customer.is_end_consumer is true, forces B2C classification for non-EU transactions even if the customer has a tax number. For intra-EU transactions, VIES validation takes precedence.

Non-Tax Subjects:
When issuer.is_tax_subject is false, all transactions are treated as B2C (no VIES validation, no reverse charge).

Request

Body parameters

issuerobjectrequiredShow child attributes

Issuer (seller) information

customerobjectrequiredShow child attributes

Customer (buyer) information

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/transaction-type/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "issuer": {
      "country": "Slovenia",
      "is_tax_subject": true
    },
    "customer": {
      "country": "Germany",
      "tax_number": "DE123456789"
    }
  }'

Example:

IntraEuB2BDomesticThirdWorldB2CThirdWorldB2B

Response

Returns

transaction_typestring

reverse_charge_appliesboolean

issuer_country_codestring

customer_country_codestring

vies_validboolean

warningstring

is_tax_subjectboolean

json

Copy

{
  "transaction_type": "intra_eu_b2b",
  "reverse_charge_applies": true,
  "issuer_country_code": "SI",
  "customer_country_code": "DE",
  "vies_valid": true,
  "warning": null,
  "is_tax_subject": true
}

Example:

IntraEuB2BDomesticThirdWorldB2CThirdWorldB2B

---