The address is usually part of a document.
In our extraction process, we rely on our own internal address management proxy to improve our extraction rates. To give you additional matching measures, we provide an address_id, which is our internal reference to that address.
The address changed!
In some cases, we might update the address if a company moves to a new location, in this case you will get the updated address while it still has the original address_id. By providing the same address_id, you are able to update your address as well, if that is convenient for you.
Validating address data
In some cases, we validate the address against country specific company registries. In those cases, you might also get a company_id and/or a vat_id as part of your address record.
Currently supported countries: Switzerland
A different address has been returned
If we find a vat id or company id on the document and it belongs to a company register we support, then the returned address will always be the main address of the company as stated in the register.
Company vs private address
We don’t explicitly indicate if it is a company or a private address, but we do only fill in either value company_name or contact_person_name accordingly. Based on that, if no company_name is given, we expect it to be a private address.
All fields (including address_id) are optional, none of these is required and will only be provided if available. Addresses are in general readonly and will not be specified any further.
|address_id||Integer||Internal Parashift Address ID|
|company_name||String||Name of the company|
|contact_person_name||String||Name of the contact person|
|street||String||Name of the street|
|post_office_box||String||Post office box|
|city_name||String||Name of the city|
|country_code||String||2 letter ISO Code of the country|