Add new properties to Supplier and Company resources

Two new properties, vatNumber and countryOfOrigin, are available on company and supplier resources—both in request bodies (POST/PUT) and in response bodies (GET)—alongside all existing properties.

Key Highlights:

New JSON properties

vatNumber (string): the entity’s registered VAT identification number.

countryOfOrigin (string): the ISO 3166-1 alpha-2 code of the entity’s country of origin.

Availability
These new properties are available on company and supplier resources—in both request and response bodies—alongside existing properties.

Validation behavior

If countryOfOrigin is unset, existing Swedish validation rules for corporateIdentityNumber apply.

If countryOfOrigin is set to another ISO code, that country’s validation rules apply—allowing non-Swedish corporate identity and VAT numbers.

Backwards-compatible
Both fields are optional and default to an empty string ("") when unse

Why It Matters

Global onboarding: You can now add international companies without workarounds—simply specify countryOfOrigin to to switch validation rules.

Compliance: Captures VAT IDs for reporting and cross-border invoicing.

Note: Detailed documentation is available at the endpoint level.

Affected Operations:

POST {api}/{version}/companies

GET {api}/{version}/companies/{companyID}

GET {api}/{version}/companies

PUT {api}/{version}/companies/{companyID}

POST {api}/{version}/companies/{companyID}/suppliers

POST {api}/{version}/companies/{companyID}/suppliers/multiple

GET {api}/{version}/companies/{companyID}/suppliers/{supplierID}

GET {api}/{version}/companies/{companyID}/suppliers

PUT {api}/{version}/companies/{companyID}/suppliers/{supplierID}