TaxId Validation
Checks whether a tax id is valid for a country. Use it to catch a mistyped tax id before you create a document or add a partner with it.
It only answers valid or not valid: it doesn't return any data about the company.
| REST | GET https://bo.magnifinance.com/api/v1.1/taxIdValidation |
| SOAP | TaxIdValidation on https://bo.magnifinance.com/MagniAPI/v1.1/Invoicing.asmx |
Try it in Postman
Each request is in a ready-made Postman collection, one for each API:
- REST: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/finance/postman/taxid-validation-rest.json - SOAP: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/finance/postman/taxid-validation-soap.json
Import it, fill in email and token in its Variables tab (see Authentication) and press Send; change the taxId variable to try an invalid one.
Supported countries
Today only Portugal (PT) is supported. Any other country code returns ElementDoesNotExist (6), which means the country isn't supported, not that the tax id is wrong.
Result
| Result | Meaning |
|---|---|
| Success | The tax id is valid. |
InvalidTaxId (4) | The tax id isn't valid for that country. |
ElementDoesNotExist (6) | The country isn't supported. |
ValidationError (2) | taxId or countryCode is missing. |
AuthenticationError (1) | The email or token is wrong. |
Any subscription token works; you don't need a special permission.