Merchant

A Merchant is a business and a User can own and/or manage multiple businesses. Within SumUp every Merchant is identified by its merchant code, typically a string like MK01A8C2. For a detailed list of properties of the Merchant, please have a look at the Merchants API reference.

Company

The company field of the Merchant contains the business’s legal information. This is the data SumUp checks when verifying the merchant before enabling products.

Company Identifiers

A key part of the company data are identification numbers contained in the identifiers array. Each identifier is a CompanyIdentifier object with:

• ref (string): the unique reference for the identifier type
• value (string): the actual identifier value

For every identifier, we use a unique reference as key following the pattern {country_code}.{identifier_type}. The prefix indicates the country (using ISO 3166-1 alpha-2 codes), and the suffix identifies the specific type of identifier.

Australia AU

• Australian Business Number au.abn
  Australian Business Number is the Australian Business Number. Every Australian business must have one. Companies with an ABN may use it instead of the TFN and the ACN. The ABN is an 11-digit number.
• Australian Company Number au.acn
  Australian Company Number is the Australian Company Number. It is used for specific registered companies and is a subset of the ABN. We only use it for the legal type “company”. The ACN is a 9-digit number.

Austria AT

• Umsatzsteuer-Identifikationsnummer at.uid
  Umsatzsteuer-Identifikationsnummer is referece to the Austrian VAT ID, the Umsatzsteuer-Identifikationsnummer.
• Abgabenkontonummer at.abgabenkontonummer
  Abgabenkontonummer is the Austrian tax identification number, Abgabenkontonummer. It is issued to natural and legal persons for he purpose of declaring taxes and interacting with the local revenue offices. The number consists of 9 digits. The first two digits identify the local tax office (uses leading zero). The next six digits are the actual tax ID. The last digit is a check digit.
• Zentrale Vereinsregister-Zahl at.zvr
  Zentrale Vereinsregister-Zahl is the Austrian association registry number, Zentrale Vereinsregister-Zahl. It is a mandatory identifier for all associations. It is a 10-digit number.
• Firmenbuchnummer at.fn
  Firmenbuchnummer is the Austrian company registration number, the “Firmenbuchnummer”. It consists of six digits and a check letter.

Belgium BE

• Belasting over de Toegevoegde Waarde nummer be.btw
  Belasting over de Toegevoegde Waarde nummer is the Belgian VAT number. Since 2020 it’s the same as the Ondernemingsnummer, but with the BE prefix.
• Ondernemingsnummer be.ondernemingsnummer
  Ondernemingsnummer is the Belgian company registration number. Before 2023 all numbers started with 0. Since 2023 numbers may start with 0 or 1.

Brazil BR

• Cadastro Nacional de Pessoa Juridica br.cnpj
  Cadastro Nacional de Pessoa Juridica is the Brazilian company registration number. It is used as company identifier and as VAT ID for a company.

Bulgaria BG

• Identifikacionen nomer po DDS bg.dds
  Identifikacionen nomer po DDS is the Bulgarian VAT number. It is the same for individuals and registered companies.
• BULSTAT Unified Identification Code bg.uic
  BULSTAT Unified Identification Code is the Bulgarian BULSTAT Unified Identification Code. Every individual business or registered company must have one.

Canada CA

• Business Number ca.business_number
  Business Number (BN) is a unique number assigned by the Canada Revenue Agency (CRA) to identify a business.
• GST/HST Number ca.gst_hst_number
  GST/HST Number is a unique number assigned by the Canada Revenue Agency (CRA) to identify a business for Goods and Services Tax (GST) and Harmonized Sales Tax (HST).
• QST Number (Quebec) ca.qst_number
  QST Number is a unique number assigned by Revenu Québec to identify a business for Quebec Sales Tax (QST).

Chile CL

• Rol Único Tributario cl.rut
  Rol Único Tributario is the Chilean tax ID. For individuals the RUT is the same as the RUN (the national ID). Registered companies have to obtain a RUT.

Colombia CO

• Número de Identificación Tributaria co.nit
  Número de Identificación Tributaria is the Colombian tax ID. It applies to individuals and companies.

Croatia HR

• Osobni identifikacijski broj hr.oib
  In Croatia, the OIB (Osobni identifikacijski broj) is a unique, permanent personal identification number assigned to both citizens and legal entities.

Cyprus CY

• Arithmós Engraphḗs phi. pi. a. cy.fpa
  Arithmós Engraphḗs phi. pi. a. is the Cypriot VAT number.
• Company Registration Number cy.crn
  Company Registration Number is the Cypriot company registration number.

Czech Republic CZ

• Daňové identifikační číslo cz.dic
  Daňové identifikační číslo is the Czech VAT ID, the Daňové identifikační číslo.
• Identifikační číslo osoby cz.ico
  Identifikační číslo osoby is the Czech company registration number, the Identifikační číslo osoby.

Denmark DK

• CVR-nummer dk.cvr
  CVR-nummer is the Danish company registration number number, Centrale Virksomhedsregister nummer. It is used both as company identifier and VAT ID.
• CVR-nummer dk.cvr
  CVR-nummer is the Danish company registration number number, Centrale Virksomhedsregister nummer. It is used both as company identifier and VAT ID.

Estonia EE

• Käibemaksukohustuslase number ee.kmkr
  Käibemaksukohustuslase number is the Estonian VAT ID, the Käibemaksukohustuslase.
• Äriregistri Kood ee.reg
  Äriregistri Kood is the Estonian company registration number, the Registrikood.

Finland FI

• Arvonlisäveronumero Mervärdesskattenummer fi.alv
  Arvonlisäveronumero Mervärdesskattenummer is the Finnish VAT number. The VAT number can be derived directly from the Business ID by prefixing the Business ID with FI and removing the dash before the check digit at the end. Businesses must register with the Finnish tax office before they can use their Business ID dependent VAT number..
• Y-tunnus fi.yt
  Y-tunnus is the Finnish Business ID, the Y-tunnus. Sole traders and registered companies must obtain one. The Business ID The Business ID of a legal person, such as a company, remains the same as long as the legal person is operative. If the company type changes in a way defined by law, the Business ID remains the same. If the activities of a general partnership or a limited liability company are continued by a person operating as a sole trader, the Business ID changes. The Y-tunnus consists of seven digits, a dash and a control mark

France FR

• Numéro d’identification à la taxe sur la valeur ajoutée / Numéro de TVA intracommunautaire fr.tva
  Numéro d’identification à la taxe sur la valeur ajoutée / Numéro de TVA intracommunautaire is the French VAT number, the Taxe sur la valeur ajoutée. For registered companies, the TVA is derived from the SIREN by prefixing the SIREN with FR. Any company, exceeding a certain annual revenue are liable for VAT.
• Système d’identification du répertoire des entreprises fr.siren
  Système d’identification du répertoire des entreprises is the french registration number given to French businesses and non-profit associations. The number consists of nine digits, of which the final digit is a check digit calculated via Luhn. Exampels: - 123 123 123
• Système d’identification du répertoire des établissements fr.siret
  Système d’identification du répertoire des établissements is a unique French identifier for a specific business location. SIRET is the Système d’identification du répertoire des établissements. Each SIRET number identifies a specific establishment/location of a business. The first nine digits of the SIRET are the business’ SIREN number. The business location is identified by the next four digits, the NIC or “Numéro interne de classement”. The final 14th digit is a check digit, calculated via Luhn. Sole traders
• Numéro Répertoire national des associations / Numéro RNA fr.rna
  Numéro Répertoire national des associations / Numéro RNA is the French association number, the Numéro d’Association. It starts with the letter W, followed by 9 digits. Associatinos must use a SIRET instead of the RNA, if they have employees, wish to apply for subsidies, or when they are required to pay VAT or corporate tax.

Germany DE

• Umsatzsteuer-Identifikationsnummer de.ust_idnr
  Umsatzsteuer-Identifikationsnummer is the German VAT ID, Umstatzsteuer-Identifikationsnummer.
• Handelsregister A Nummer de.hra
  Handelsregister A Nummer is the German company registration number for individual enterprises (e.K.), commercial (general and limited) partnerships (OHG and KG), corporations of public law running a business and EEIGs.
• Handelsregister B Nummer de.hrb
  Handelsregister B Nummer is the German company registration number for covers the following company types: public limited company (AG), association limited by shares (KGaA), limited liability companies (GmbH), and others.
• Vereinsregenister Nummer de.vr
  Vereinsregenister Nummer is the German registration number for registered associations, eingegratener Verein (e.V.).
• Other registration numbers de.other
  Other registration numbers is used to identify other German company registration numbers.

Greece GR

• Arithmós Forologikou Mētrṓou - ΑΦΜ gr.afm
  Arithmós Forologikou Mētrṓou - ΑΦΜ is the Greece tax ID, the Arithmós Forologikou Mētrṓou (AFM). Sole traders (sole proprietorship) use their personal tax ID to conduct business. Companies register for a tax ID. We always require an AFM in Greece.
• General Commercial Registry number. gr.gemi
  General Commercial Registry number. is the Greek company registration number, the General Commercial Registry (Γ.Ε.ΜI.) number. All Natural or legal persons or associations of such persons have to register in the General Commercial Registry. The exception are sole traders, wo can start conducting their business without going through GEMI.

Hungary HU

• Közösségi adószám hu.anum
  Közösségi adószám is the Hungarian vat number, the Közösségi adószám. The format of the ANUM is HU12345678. The eight digit are the first digits in the Hungarian tax ID, the adószám. The tax ID has the format 12345678-1-23 (see references). The regex we have for the ANUM also accepts the adószám and leaves the country code prefix optional.
• Cégjegyzékszám hu.cegjegyzekszam
  Cégjegyzékszám is the Hungarian company registration number, the Cégjegyzékszám. NOTE: the values we have for this in platform DB are all over the place in terms of legal types. Technically, the cegjegyzekszam contains the company form. Looking at the numbers we have to the sole trader and registered sole trader legal types, the numbers map to limited liability companies and other legal types.
• Adószám hu.adoszam
  Adószám is the Hungarian tax number, the Adószám. It is not to be confused with the tax identification number, adoazonosító jel.

Ireland IE

• Value added tax identification no. ie.vat
  Value added tax identification no. is the Irish VAT number and a unique identifier for Irish companies. It is identical to the TRN prefixed with IE.
• Tax Registration Number ie.trn
  Tax Registration Number is the Irish tax ID, the Tax Registration Number. Companies must register with Revenue to obtain a TRN. For sole traders who register with Revenue their PPSN becomes their business’ TRN. We collect the TRN for non-registered companies as company registration number.
• Value added tax identification no. ie.crn
  Value added tax identification no. is the Irish company registration number, issued by Companies Registaion Office. It’s a six digit code. NOTE: I found it very hard to find any references for this. I asked some AI search which gave the six digit answer and maybe found something in a forum somewhere. Additionally our database is full of six digit numbers, so I deem this to be correct. Users does not have any validations for Irish CRNs.
• Tax identification number for charities ie.chy
  Tax identification number for charities is the tax identification number for charitable organizations. The format starts with the letters CHY, followed by 1 to 5 digits.

Italy IT

• Partita IVA it.p_iva
  Partita IVA is the Italian VAT number. It is used for individual businesses and registered companies. If a natural or legal person has a partita IVA, then it is used as fiscal code.
• REA Number it.rea_number
  REA Number is the Italian REA number, the “Repertorio Economico Amministrativo”. It’s issued upon registration with the Italian chamber of commerce. The REA also serves as fiscal code. It seems that if a company has a VAT number and a REA, the VAT number is used as fiscal code.

Latvia LV

• PVN reģistrācijas numurs lv.pvn
  PVN reģistrācijas numurs is the Latvian VAT number, the Pievienotās vērtības nodokļa numurs. It is the same as the personal or company TIN, but prefixed with “LV” and without the check digit.
• Reģistrācijas numur lv.registracijas_numur
  Reģistrācijas numur is the Latvian company identification code. It is issued by the State Revenue Service or by the Enterprise Register. The number consists of 11 digits. The State Revenue Service issues numbers starting “9000”, while the Enterprise Register numbers start with “4000” or “5000”. There is no documented check digit algorithm. The identification code is also used as tax identification number (TIN).

Lithuania LT

• PVM mokėtojo kodas lt.pvm_kodas
  PVM mokėtojo kodas is the Lithuanian VAT number, the PVM mokėtojo kodas. NOTE: You can almost not find any information about this identifier.
• Įmonės kodas lt.imones_kodas
  Įmonės kodas is the Lithuanian company code, the Įmonės kodas. NOTE: I’ve found nothing on this. An AI search said legal persons have a 9 digit code, natural persons have an 11 digit code. In our database we only seem to have 9 digit codes.

Luxembourg LU

• Numéro d’identification à la taxe sur la valeur ajoutée lu.tva
  Numéro d’identification à la taxe sur la valeur ajoutée is the Luxembourgian VAT number, the Taxe sur la valeur ajoutée. Natural and legal persons typically must register for a VAT number, meaning sole traders and registered companies. “A taxable person liable for VAT is each natural or legal person who carries out, on an independent and regular basis, any operation falling within any economic activity, whatever the purpose or result of the activity and from whatever location it is performed.”
• Matricule lu.matricule
  Matricule is the Luxembourgian unique identification number for both natural and legal persons. It’s referred to as matricule or “numéro d’identification personnelle” and is used as tax ID. In the case of natural persons the matricule can have 11 or 13 digits. Any numbers issued from 2014 have 13 digits. Legal persons are issued matricules with 11 digits. The format for a natural person is YYYY MMDD XXX (XX), where the first 8 digits are the date of birth of the person. The remaining five digits are “random”. The 12th digit is a Luhn10 check digit. The 13th digit is a de Verhoeff check digit. Both are calculated from the first 11 digits. The format for legal persons is AAAA FF XX XXX, where AAAA is the year of formation, FF is the form of the company, and XX XXXare random numbers.
• Numéro d’identification unique lu.rcs
  Numéro d’identification unique is the Luxmebourgian company registration number, stored in the “Registre du commerce et des sociétés”. The number format is B123456, it may be prefixed by variations of RCS. The letter at the beginning of the number indicates the kind of company. B stands for a commercial company. NOTE: I was not able to find any documentation on the exact format and the different letters used to identify the company type.

Malta MT

• Numru tal-VAT mt.vat_no
  Numru tal-VAT is the Maltese VAT number, the Numru tal-VAT. It starts with “MT”, followed by 8 digits.
• Business Registration Number mt.brn
  Business Registration Number is the Maltese business registration number. The Maltese Business Register maintains a register of companies, foundations, and associations NOTE: sent an email to Malta Business Register to get clarification on different business registration number formats. We have many numbers with the formats C12345, P12345, V/O12345. These seem to be companies, partnerships, and associations.

Mexico MX

• Registro Federal de Contribuyentes mx.rfc
  Registro Federal de Contribuyentes is the Mexican tax identification number, the Registro Federal de Contribuyentes. It is issued to natural persons and legal entities and required to perform any economic activity in Mexico, including VAT. The RFC format depends on whether it belongs to a natural person or legal entity. - Natural erson: XXXX YYMMDD ZZZ - Legal entity: XXX YYMMDD ZZZ The XXXX and XXX parts are derived from the person’s or company’s name. The YYMMDD is the date of birth or date of company formation, respectively. ZZZ is a randomly assigned alphanumeric code by the tax administration service. It includes a checksum.

Netherlands NL

• Btw-nummer nl.btw
  Btw-nummer is the Dutch VAT identification number, the btw-identificatienummer. A Dutch VAT number starts with NL, then comes 9 digits, the letter B, and then another 2 digits. Sole traders and registered companies receive VAT IDs. There’s also a VAT tax number (omzetbelastingnummer), which is only used to communicate with the tax authorities.
• Kamer van Koophandel nummer nl.kvk
  Kamer van Koophandel nummer is the Dutch company registration number, the Kamer van Koophandel nummer (KVK nummer). It’s issued for every business registering in the chamber of commerce. Most businesses must register with the KVK, there are only a few exceptions. When the owner of a company changes, the KVK number will also change. The KVK number is an eight-digit number.

Norway NO

• MVA-nummer no.mva
  MVA-nummer is the Norwegian VAT number, the Merverdiavgiftsnummer. It is the same as the Organisasjonsnummer, but with an extra suffix MVA.
• Organisasjonsnummer no.orgnr
  Organisasjonsnummer is the Norwegian organization number, the Organisasjonsnummer. It is assigned to legal entities upon registration. Sole traders who are subject to value added tax must also register. The organization number consists of 9 digits whereof the last digit is a check digit based on a special weighted code, modulus 11.

Poland PL

• Numer identyfikacji podatkowej pl.nip
  Numer identyfikacji podatkowej is the Polish tax identification number for for businesses, the numer identyfikacji podatkowej. It is used for both natural and legal persons. The NIP is also used as VAT ID, in which case it’s prefixed by PL. The hyphens are only used for formatting. The positioning of the hyphens depends on whether the NIP belongs to a natural or legal person. lib.
• Numer Krajowego Rejestru Sądowego pl.krs
  Numer Krajowego Rejestru Sądowego is the Polish registration number for companies, associations, foundations, etc., the numer Krajowego Rejestru Sądowego. It is used for companies only, sole traders register in a different registry. The KRS number has ten digits with leading zeros.
• Numer Rejestr Gospodarki Narodowej pl.regon
  Numer Rejestr Gospodarki Narodowej is the polish business registration number for sole traders, the numer Rejestr Gospodarki Narodowej. All natural and legal persons performing economic activies must register in the system. The number consists of 9 or 14 digits. Regular businesses receive a 9 digit REGON number. Larger businesses with multiple branches receive a 14 digit number. The first two digits identify the county in Poland where the business is registered. The following six digits are uniquely assigned to the business. In a 14 digit REGON number, the next 4 digits identify the local business unit. The final digit is a check digit.

Portugal PT

• Número de Identificação Fiscal pt.nif
  Número de Identificação Fiscal is the Portuguese tax identification number for natural persons, the Número de Identificação Fiscal. The NIF is assigned by the Tax and Customs Authority for all citizens. NIFs can be distinguished from NIPCs by the first digit. NIFs start with 1, 2, or 3. The number has 9 digits, the last digit is a check digit.
• Número de Identificação de Pessoa Coletiva pt.nipc
  Número de Identificação de Pessoa Coletiva is the Portuguese tax identification number for legal persons, the Número de Identificação de Pessoa Coletiva. The NIPC is issued when a company is registered National Register of Legal Entities.. NIPCs can be distinguished from NIFs by the first digit. NIPCs start with the numbers 5 through 9 (see OECD TIN document). The number has 9 digits, the last digit is a check digit.
• Código de acesso à certidão permanente pt.codigo
  Código de acesso à certidão permanente is the access code for the permanent certificate of business registration, the código de acesso à certidão permanente. This code is required to access a company’s records (the permanent certificate) in the commercial register. NOTE: we seem to have collected this number for both the company registration number and as a dedicated field. The company registration numbers for Portugal seem to therefore be all over the place. Users were probably confused because there is no such thing as a company registration number in Portugal, that resembles the access code’s format. The NIPC serves as company identifier for tax purposes. The code consists of 12 digits in groups of four, separated by hyphens.

Romania RO

• Codul de TVA ro.cui
  Codul de TVA is the Romanian unique identification number for businesses, the Codul Unic de Înregistrare. Pretty much all businesses, including sole traders, must register for a CUI. The CUI serves as tax identification number. If the business is registered for VAT, their CUI is also their VAT ID when prefixed with RO. The CUI consists of 2 to 10 digits. The last digit is a check digit (see linked Wikipedia).
• Codul Unic de Înregistrare ro.cui
  Codul Unic de Înregistrare is the Romanian unique identification number for businesses, the Codul Unic de Înregistrare. Pretty much all businesses, including sole traders, must register for a CUI. The CUI serves as tax identification number. If the business is registered for VAT, their CUI is also their VAT ID when prefixed with RO. The CUI consists of 2 to 10 digits. The last digit is a check digit (see linked Wikipedia).
• Codul de identificare fiscală ro.cif
  Codul de identificare fiscală is the generic term for the Romanian tax identification number, the Codul de identificare fiscală. The CIF can take several forms. - For Romanian citizens who have not registered their business in the Trade Register, due to exemptinos, their CNP is their business’ CIF. - For non-romanian citizens, the CIF is issued by the tax administration and takes the same shape as the CNP. - For natural persons who exercise their business under a special law, not requiring them to register, the CIF is issued by the tax authorities. - Businesses that register with the Trade Register receive a CUI to serve as their CIF. In most cases we should not collect a generic CIF and instead require a CUI or CNP.
• Numărul de ordine în registrul comerţului ro.onrc
  Numărul de ordine în registrul comerţului is the Romanian registration number from the trade register, the numărul de ordine în registrul comerţului. When registering a company in the trade register, one receives the ONRC number, which is akin to a company registration number, as well as the unique company code, CUI (see [refROCUI]). The ONRC number is local to the province one registers in. It can change over time, for example when a company moves to a different province. The number consists of three parts. The first part starts with one of the letters J (legal entities), F (authorized natural persons, sole proprietorships and family businesses), or C (cooperative societies). The letter is followed by a number from 1 to 40 (with leading zero), identifying the county in which the business is registered. The second part of the ONRC is the local register’s “order number” of the year of registration. It gets reset every year. The last part is the year of registration.

Slovakia SK

• Identifikačné číslo pre daň z pridanej hodnoty sk.dph
  Identifikačné číslo pre daň z pridanej hodnoty is the Slovak Republic’s VAT ID, the Identifikačné číslo pre daň z pridanej hodnoty. Any business making more than a certain threshold is required to register for VAT, including sole traders. It’s a ten-digit number, prefixed with SK. The number can be validated by calculating its modulo 11. The result has to be 0.
• Identifikačné číslo organizácie sk.ico
  Identifikačné číslo organizácie is the Slovak Republic’s organization identification number, the Identifikačné číslo organizácie. It is issued automatically to natural persons and legal entities running a business as well as public sector organizations etc. The first seven digits are the identification number. The eights digit is a check digit.

Slovenia SI

• Identifikacijska številka za DDV si.ddv
  Identifikacijska številka za DDV is the Slovenian tax identification number, the Davčna številka. It is issued to all natural and legal persons. The DDV serves as VAT number when prefixed with SI. The DDV is an eight-digit number. The first seven digits are random, the eighth digit is a mod11 check digit.
• Matična številka si.maticna
  Matična številka is the Slovenian company registration number, the Matična številka poslovnega registra. The number consists of 7 or 10 digits and includes a check digit. The first 6 digits represent a unique number for each unit or company, followed by a check digit. The last 3 digits represent an additional business unit of the company, starting at 001. When a company consists of more than 1000 units, a letter is used instead of the first digit in the business unit. Unit 000 always represents the main registered address.

Spain ES

• Número de Identificación Fiscal es.nif
  Número de Identificación Fiscal is the Spanish personal identification number. It is used for individual company types. The NIF corresponds to the DNI for Spanish nationals and the NIE for foreign nationals.
• Certificado de Identificación Fiscal es.cif
  Certificado de Identificación Fiscal is the Spanish tax ID for companies and legal entities, the Código de Identificación Fiscal. It is used as unique identifier for companies and as VAT ID.

Sweden SE

• VAT-nummer se.momsnr
  VAT-nummer is the Swedish VAT number, the Momsregistreringsnummer. The format for the Momsregistreringsnummer is SEXXXXXX-XXXX01 It always starts with SE and ends in 01. For legal entities the middle part is the Organisationsnummer (see [refSEOrgNr]). For sole traders, the part contains the Personnummer (see [refSEPers]).
• Organisationsnumret se.orgnr
  Organisationsnumret is the Swedish tax identification number for legal entities, the Organisationsnummer. It is assigned by the authority, which registers the respective organization type (i.e., Companies Registration Office, Tax Agency, Central Bureau of Statistics, etc.). The Organisationsnummer is used as tax identification number. Sole traders use their social security number as tax identification numbers. The Organisationsnummer has 10 digits and should pass luhn’s checksum algorithm.

Switzerland CH

• Mehrwertsteuernummer / Taxe sur la valeur ajoutée / Imposta sul valore aggiunto ch.mwst
  Mehrwertsteuernummer / Taxe sur la valeur ajoutée / Imposta sul valore aggiunto is the Swiss VAT number. It is identical to the UID but uses a MWST suffix when written without a label, i.e. CHE123456789MWST.
• Unternehmens-Identifikationsnummer ch.uid
  Unternehmens-Identifikationsnummer is the Swiss company registration number, the Unternehmens-Identifikationsnummer. It is has the format CHE123456789.

United Kingdom GB

• Value added tax registration number gb.vrn
  Value added tax registration number is the British VAT number, the VAT registration number. Any business with an annual turnover exceeding a VAT threshold must register for a VRN.
• The company registration number for companies registered with Companies House gb.crn
  The company registration number for companies registered with Companies House is the British company registration number. Limited companies, Limited Partnerships, and Limited Liability Partnerships have to register with Companies House and receive the CRN.

United States US

• Social Security Number us.ssn
  Social Security Number is the United States social security number. It is used for taxation of natural persons, like sole traders. From Wikipedia: > The SSN is a nine-digit number, usually written in the format AAA-GG-SSSS. > The number has three parts: the first three digits, called the area number because > they were formerly assigned by geographical region; the middle two digits, the > group number; and the last four digits, the serial number.
• Employer Identification Number us.ein
  Employer Identification Number is the United States employer identification number. It is used for business entities which have to pay withholding taxes on employees. The EIN is a nine-digit number, usually written in form 00-0000000.
• Social Security Number us.itin
  Social Security Number is the United States individual tax identification number. Individuals who cannot get a social security number (see refUSSSN) can apply for an ITIN. From Wikipedia: > It is a nine-digit number beginning with the number “9”, has a range > of numbers from “50” to “65”, “70” to “88”, “90” to “92” and “94” to “99” > for the fourth and fifth digits, and is formatted like a SSN (i.e., 9XX-XX-XXXX).
• Social Security Number us.ssn
  Social Security Number is the United States social security number. It is used for taxation of natural persons, like sole traders. From Wikipedia: > The SSN is a nine-digit number, usually written in the format AAA-GG-SSSS. > The number has three parts: the first three digits, called the area number because > they were formerly assigned by geographical region; the middle two digits, the > group number; and the last four digits, the serial number.
• Employer Identification Number us.ein
  Employer Identification Number is the United States employer identification number. It is used for business entities which have to pay withholding taxes on employees. The EIN is a nine-digit number, usually written in form 00-0000000.
• Social Security Number us.itin
  Social Security Number is the United States individual tax identification number. Individuals who cannot get a social security number (see refUSSSN) can apply for an ITIN. From Wikipedia: > It is a nine-digit number beginning with the number “9”, has a range > of numbers from “50” to “65”, “70” to “88”, “90” to “92” and “94” to “99” > for the fourth and fifth digits, and is formatted like a SSN (i.e., 9XX-XX-XXXX).

Example:

{
  "identifiers": [
    {
      "ref": "de.hrb",
      "value": "HRB 123456 B"
    },
    {
      "ref": "de.ust_idnr",
      "value": "DE123456789"
    }
  ]
}

Legal type

Legal type is the official way the business is set up and recognized by the law. Legal types are of the pattern {country_code}.{identifier_type}. The prefix indicates the country (using ISO3166-1 alpha-2), and the suffix identifies the specific legal type within that country.

Australia AU

• Agent (Agent) au.agt
• Trust (Trust) au.trust
• Co-operative (Co-operative) au.coop
• Sole Trader (Sole Trader) au.st
• Company (Company) au.co
• Partnership (Partnership) au.pship
• Association (Association) au.assoc

Austria AT

• Alle nicht registrierten Einzelunternehmen und freien Berufe ohne andere Gesellschaftsform (Einzelunternehmer/Freiberufler) at.freiberufler
• Eingetragenes Einzelunternehmen (e. U.) (e.U.) at.eu
• Gesellschaft bürgerlichen Rechts (GesbR) (GesbR) at.gesbr
• Offene Gesellschaft (OG) (OG) at.og
• Kommanditgesellschaft (KG) (KG) at.kg
• Gesellschaft mit beschränkter Haftung (GmbH) (GmbH) at.gmbh
• Aktiengesellschaft (AG) (AG) at.ag
• Verein (Verein) at.verein
• Andere Rechtsformen (Andere) at.andere

Belgium BE

• Entreprise individuelle (Entreprise individuelle) be.ei
• Partenariat (Partenariat) be.partenariat
• Société en Nom Collectif (SNC) (Société en Nom Collectif (SNC)) be.vof
• Société en Commandite par Action (SCA) (Société en Commandite par Action (SCA)) be.sca
• Société en Commandite Simple (SCS) (Société en Commandite Simple (SCS)) be.cv
• Société Anonyme (SA) (Société Anonyme (SA)) be.nv
• Société à responsabilité limitée (S.R.L.) (Société à responsabilité limitée (S.R.L.)) be.sprl
• Fondations (Fondations) be.stichting
• Association Sans But Lucratif (ASBL) (Association Sans But Lucratif (ASBL)) be.asbl
• Société Coopérative à Responsabilité Limitée (SC/SCRL) (Société Coopérative à Responsabilité Limitée (SC/SCRL)) be.scscrl
• Société Coopérative à Responsabilité Illimitée (SCRI) (Société Coopérative à Responsabilité Illimitée (SCRI)) be.scri
• Agence Publique (Agence Publique) be.state_agency

Brazil BR

• Pessoa Física (Pessoa Física) br.pessoa_fisica
• LTDA (LTDA) br.ltda
• S/A Capital Aberto (S/A Capital Aberto) br.sa_capital_aberto
• S/A Capital Fechado (S/A Capital Fechado) br.sa_capital_fechado
• Sociedade Simples (Sociedade Simples) br.sociedade_simples
• Cooperativa (Cooperativa) br.cooperativa
• Associação (Associação) br.associacao
• Fundação (Fundação) br.fundacao
• Outros (Outros) br.outros
• Entidade Sindical (Entidade Sindical) br.entidade_sindical
• Empresa de Pequeno Porte (EPP) (Empresa de Pequeno Porte (EPP)) br.empresa_pequeno_porte
• Empresa Individual de Responsabilidade Limitada (Eireli) (Empresa Individual de Responsabilidade Limitada (Eireli)) br.eireli
• Pessoa Jurídica payleven (Pessoa Jurídica payleven) br.pessoa_juridica_payleven
• Micro Empreendedor Individual (MEI) (Micro Empreendedor Individual (MEI)) br.empresario_individual
• Pessoa Jurídica (Pessoa Jurídica) br.pessoa_juridica
• Empresa individual (EI) (Empresa individual (EI)) br.empresa_individual

Bulgaria BG

• Събирателно дружество (СД) bg.general_partnership
• Командитно дружество (КД) bg.limited_partnership
• Командитно дружество с акции (КДА) bg.limited_partnership_with_shares
• Дружество с ограничена oтговорност (ООД) bg.private_limited_company
• Еднолично дружество с ограничена отговорност (ЕООД) bg.private_limited_company_with_a_single_member
• Акционерно дружество (АД) bg.joint-stock_company
• Консорциум (Консорциум) bg.association
• Фондация (Фондация) bg.foundation
• Кооперация (Кооперация) bg.cooperative
• Друго (Друго) bg.other
• Едноличен търговец (Едноличен търговец) bg.sole_trader
• Професионалист на свободна практика (Професионалист на свободна практика) bg.freelancer
• Еднолично акционерно дружество (ЕАД) bg.sole_shareholding_company

Canada CA

• Sole proprietorship (Sole proprietorship) ca.sp
• Private company (Private company) ca.bsns
• Listed public company (Listed public company) ca.lpc
• Governmental organization (Governmental organization) ca.gorg
• Association incorporated (Association incorporated) ca.asinc
• Nonprofit or charitable organisation (Non-profit) ca.npro
• Unincorporated partnership (Unincorporated partnership) ca.unincpar
• Incorporated partnership (Partnership) ca.pship

Chile CL

• Persona Natural (Persona Natural) cl.sole_trader
• Sociedad de Responsabilidad Limitada (Sociedad de Responsabilidad Limitada (SRL)) cl.ltda
• Sociedad Anónima (Sociedad Anónima (SA)) cl.sa
• Sociedad por Acciones (Sociedad por Acciones (SPA)) cl.sca
• Empresas Individuales de Responsabilidad Limitada (Empresa Individual de Responsabilidad Limitada (EIRL)) cl.eirl
• Sociedad en Comandita Simple (Sociedad en Comandita Simple) cl.scs

Colombia CO

• Sociedad por Acciones Simplificadas (S.A.S.) (Sociedad por Acciones Simplificadas (S.A.S.)) co.sas
• Sociedad de Responsabilidad Limitada (Ltda.) (Sociedad de Responsabilidad Limitada (Ltda.)) co.ltda
• Sociedad Colectiva (S.C.) (Sociedad Colectiva (S.C.)) co.sc
• Sociedad Comandita Simple (S. en C.) (Sociedad Comandita Simple (S. en C.)) co.sec
• Persona Natural (Persona Natural) co.pers
• Empresa Unipersonal (E.U.) (Empresa Unipersonal (E.U.)) co.eu
• Sociedad Comandita por Acciones (S.C.A.) (Sociedad Comandita por Acciones (S.C.A.)) co.sca
• Sociedad Anónima (S.A.) (Sociedad Anónima (S.A.)) co.sa

Croatia HR

• udruga (udruga) hr.association_new
• obrt (obrt) hr.sole_trader_new
• javno trgovačko društvo (j.t.d.) hr.general_partnership_new
• komanditno društvo (k.d.) hr.limited_partnership_new
• društvo s ograničenom odgovornošću (d.o.o. / j.d.o.o.) hr.private_limited_company_new
• dioničko društvo (d.d.) hr.public_limited_company_new
• zadruga (zadruga) hr.cooperative_new
• Drugo (Drugo) hr.other_new
• Ortaštvo (Ortaštvo) hr.partnership_of_two_or_more_sole_traders_new

Cyprus CY

• Δημόσια εταιρεία περιορισμένης ευθύνης (Δημόσια εταιρεία περιορισμένης ευθύνης) cy.public_limited_company
• Ατομική επιχείρηση (Ατομική επιχείρηση) cy.sole_trader
• Εταιρεία περιορισμένης ευθύνης δια μετοχών (Εταιρεία περιορισμένης ευθύνης δια μετοχών) cy.private_limited_company
• Άλλο (Άλλο) cy.other
• Εταιρεία περιορισμένης ευθύνης με εγγύηση (Εταιρεία περιορισμένης ευθύνης με εγγύηση) cy.company_limited_by_guarantee
• Ομόρρυθμη εταιρεία (Ομόρρυθμη εταιρεία) cy.general_partnership
• Συνεταιρισμός (Συνεταιρισμός) cy.associations
• Ίδρυμα (Ίδρυμα) cy.foundation
• Ετερόρρυθμη εταιρεία (Ετερόρρυθμη εταιρεία) cy.limited_partnership

Czech Republic CZ

• Živnost (Živnost) cz.sole_trader
• Společnost (Společnost) cz.unregistered_partnership
• Veřejná obchodní společnost (v.o.s.) cz.general_partnership
• Komanditní společnost (k.s.) cz.limited_partnerhip
• Společnost s ručením omezeným (s.r.o., spol. s r.o.) cz.private_limited_company
• Akciová společnost (a.s., akc. spol.) cz.public_limited_company
• Družstvo (Družstvo) cz.cooperative
• Zapsaný spolek (z.s.) cz.association
• Nadační fond (Nadační fond) cz.foundation
• jiný (jiný) cz.other

Denmark DK

• Enkeltmandsvirksomhed (Enkeltmandsvirksomhed) dk.sole_trader
• Interessentskab (I/S) dk.general_partnership
• Kommanditselskab (K/S) dk.limited_partnership
• Partnerselskab or Kommanditaktieselskab (P/S) dk.partnership_limited_by_shares
• Anpartsselskab (ApS) dk.private_limited_company
• Aktieselskab (A/S) dk.public_limited_company
• Andelsselskab med begrænset ansvar (A.M.B.A.) dk.limited_liability_co-operative
• Forening med begrænset ansvar (F.M.B.A.) dk.limited_liability_voluntary_association
• Forening (Forening) dk.association
• Erhvervsdrivende fond (Erhvervsdrivende fond) dk.commercial_foundation
• Ikke-erhvervsdrivende fond (Ikke-erhvervsdrivende fond) dk.non_commercial_foundation
• Anden (Anden) dk.other

Estonia EE

• Füüsilisest Isikust Ettevõtja (FIE) ee.sole_trader
• Täisühing (TÜ) ee.general_partnership
• Usaldusühing (UÜ) ee.limited_partnership
• Osaühing (OÜ) ee.private_limited_company
• Aktsiaselts (AS) ee.public_limited_company
• Ühistu (Ühistu) ee.cooperative
• Muud liiki (Muud liiki) ee.other
• Tulundusühistu (TulÜ) ee.commercial_association

Finland FI

• Avoin yhtiö (Ay) fi.general_partnership
• Kommandiittiyhtiö (Ky) fi.limited_partnership
• Osakeyhtiö (Oy) fi.private_limited_company
• Julkinen osakeyhtiö (Oyj) fi.public_limited_company
• Osuuskunta (Osk) fi.cooperative
• Rekisteröity yhdistys (ry) fi.registered_association
• Säätiö (rs) fi.foundation
• Muut (Muut) fi.other
• Yksityinen elinkeinonharjoittaja (Yksityinen elinkeinonharjoittaja) fi.sole_trader

France FR

• Entrepreneur Individuel is a sole trader legal type. (Entrepreneur Individuel) fr.ei
• EURL (EURL) fr.eurl
• SARL (SARL) fr.sarl
• SA (SA) fr.sa
• SAS (SAS) fr.sas
• SASU (SASU) fr.sasu
• SNC (SNC) fr.snc
• Association (Association) fr.association
• Autres (Autres) fr.autres

Germany DE

• Alle nicht registrierten Einzelunternehmen und freien Berufe ohne andere Gesellschaftsform (Einzelunternehmer/Freiberufler) de.freiberufler
• Eingetragener Kaufmann / Eingetragene Kauffrau (e.K., e.Kfm. oder e.Kfr.) (e.Kfm./e.Kfr.) de.ekfr
• Gesellschaft bürgerlichen Rechts (GbR) (GbR) de.gbr
• Offene Handelsgesellschaft (OHG) (OHG) de.ohg
• Kommanditgesellschaft (KG) (KG) de.kg
• Unternehmergesellschaft (UG (haftungsbeschränkt)) (UG (haftungsbeschränkt)) de.ug
• Gesellschaft mit beschränkter Haftung (GmbH) (GmbH) de.gmbh
• GmbH & Co. KG (GmbH & Co. KG) de.gmbhco
• Aktiengesellschaft (AG) (AG) de.ag
• Eingetragener Verein (e.V.) (e.V.) de.ev
• Andere Rechtsformen (Andere) de.andere
• Stiftung (Stiftung) de.stiftung
• Genossenschaft (eG) (eG) de.genossenschaft
• Körperschaft öffentlichen Rechts (KöR) (KöR) de.koerperschaft

Greece GR

• Atomikí epicheírisi / ατομική επιχείρηση (Atomikí epicheírisi / ατομική επιχείρηση) gr.sole_trader
• Omórithmi Etaireía / Ομόρρυθμη Εταιρεία (OE) gr.general_partnership
• Eterórithmi Etaireía / Ετερόρρυθμη Εταιρία (EE) gr.limited_partnership
• Anónimi Etaireía / Ανώνυμη Εταιρεία (AE) gr.public_limited_company
• Etaireía Periorisménis Euthínis / Εταιρεία Περιορισμένης Ευθύνης (EPE) gr.private_limited_company
• Monoprósopi Etaireía Periorisménis Euthínis / Μονοπρόσωπη (MEPE) gr.ltd_with_a_single_member
• Άλλο (Άλλο) gr.other
• Συνεταιρισμός (Συνεταιρισμός) gr.association
• Ίδρυμα (Ίδρυμα) gr.foundation

Hungary HU

• Egyéni vállalkozó (e.v.) hu.sole_trader
• Egyéni cég (e.c.) hu.registered_sole_trader
• Betéti társaság (bt.) hu.limited_partnership
• Közkereseti társaság (kkt.) hu.general_partnership
• Korlátolt felelősségű társaság (kft.) hu.private_limited_company
• Nyilvánosan működő részvénytársaság (Nyrt.) hu.public_limited_company
• Zártközűen működő részvénytársaság (Zártközűen működő részvénytársaság) hu.privately_held_company
• Társaság (Társaság) hu.cooperative
• Szövetség (Szövetség) hu.association
• Alapítvány (Alapítvány) hu.foundation
• Más (Más) hu.other

Ireland IE

• Sole proprietorship / sole trader (Sole trader) ie.sole_trader
• All clubs or societies (Club or society) ie.society
• All schools, colleges or universities (School, college or university) ie.edu
• All other legal forms (Other) ie.other
• Private limited company (Limited company (Ltd.)) ie.limited
• All partnerships (Partnership (LP, LLP)) ie.partnership

Italy IT

• Società a responsabilità limitata semplificata (Srls) (Società a responsabilità limitata semplificata (Srls)) it.srls
• Società a responsabilità limitata unipersonale (Srl Uni) (Società a responsabilità limitata unipersonale (Srl Uni)) it.srl_uni
• Società Semplice (S.s.) (Società Semplice (S.s.)) it.ss
• Libero Professionista (Libero Professionista) it.libero
• Imprenditore individuale (Imprenditore individuale) it.individuale
• Società in nome collettivo (S.n.c.) (Società in nome collettivo (S.n.c.)) it.snc
• Società in accomandita semplice (S.a.s) (Società in accomandita semplice (S.a.s)) it.sas
• Società Cooperativa (Società Cooperativa) it.societa_cooperative
• Società per Azioni (Spa) (Società per Azioni (Spa)) it.spa
• Società a responsabilità limitata (Srl) (Società a responsabilità limitata (Srl)) it.srl
• Società di capitali (Società di capitali) it.società_di_capitali
• Società di persone (Società di persone) it.società_di_persone
• Società in accomandita per azioni (Società in accomandita per azioni) it.siapa
• Agenzia Statale (Agenzia Statale) it.agenzia_statale
• Associazioni (Associazioni) it.associazioni

Latvia LV

• Individuālais komersants (IK) lv.sole_trader
• Komandītsabiedrība (KS) lv.limited_partnership
• Pilnsabiedrība (PS) lv.general_partnership
• Sabiedrība ar ierobežotu atbildību (SIA) lv.private_limited_company
• Akciju sabiedrība (AS) lv.public_limited_company
• Asociācija (Asociācija) lv.association
• Fonds (Fonds) lv.foundation

Lithuania LT

• Individuali veikla (Individuali veikla) lt.sole_trader
• Individuali įmonė (IĮ) lt.individual_company
• Tikroji ūkinė bendrija (TŪB) lt.general_partnership
• Komanditinė ūkinė bendrija (KŪB) lt.limited_partnership
• Mažoji bendrija (MB) lt.small_partnership
• Uždaroji akcinė bendrovė (UAB) lt.private_limited_company
• Akcinė bendrovė (AB) lt.public_limited_company
• Kooperatinė bendrovė (Kooperatinė bendrovė) lt.cooperative
• Asociacija (Asociacija) lt.association
• Fondas (Fondas) lt.foundation
• Kitas (Kitas) lt.other

Luxembourg LU

• Entrepreneur Individual (Entrepreneur Individual) lu.sole_trader
• Société en commandite simple (SECS) lu.limited_partnership
• Sociéteé civil or sociéteé en nom collectif (SENC) lu.general_partnership
• Société en commandité par actions (SCA) lu.partnership_limited_by_shares
• Société à responsabilitée limitée (SARL) lu.private_limited_company
• Société anonyme (SA) lu.public_limited_company
• Société co-opérative (SC) lu.cooperative
• Association (Association) lu.association
• Autres (Autres) lu.other

Malta MT

• Sole trader (Sole trader) mt.sole_trader
• Limited partnership (Limited partnership) mt.limited_partnership
• General partnership (General partnership) mt.general_partnership
• Private limited company (Private limited company) mt.private_limited_company
• Public limited company (Public limited company) mt.public_limited_company
• Association (Association) mt.associations
• Foundation (Foundation) mt.foundation
• Other (Other) mt.other

Mexico MX

• Persona fisica (Persona fisica) mx.persona_fisica
• Persona moral (Persona moral) mx.persona_moral
• Empresa sin fin de lucro (Empresa sin fin de lucro) mx.empresa_sin_fin_de_lucro

Netherlands NL

• Zzp (Zelfstandige Zonder Personeel) (Zzp (Zelfstandige Zonder Personeel)) nl.zzp
• Eenmanszaak (KvK registratie) (Eenmanszaak (KvK registratie)) nl.kvk
• Maatschap (Maatschap) nl.maatschap
• Vennootschap Onder Firma (VOF) (Vennootschap Onder Firma (VOF)) nl.vof
• Commanditaire Vennootschap (CV) (Commanditaire Vennootschap (CV)) nl.cv
• Naamloze Vennootschap (NV) (Naamloze Vennootschap (NV)) nl.nv
• Besloten Vennootschap (BV) (Besloten Vennootschap (BV)) nl.bv
• Stichting (Stichting) nl.stichting
• Vereniging met volledige rechtsbevoegdheid (Vereniging met volledige rechtsbevoegdheid) nl.vvr
• Vereniging met beperkte rechtsbevoegdheid (Vereniging met beperkte rechtsbevoegdheid) nl.vbr
• Coöperatie en Onderlinge Waarborgmaatschappij (Coöperatie en Onderlinge Waarborgmaatschappij) nl.cow
• Overheidsinstelling (Overheidsinstelling) nl.overheidsinstelling
• Vereniging (Vereniging) nl.vereniging

Norway NO

• Enkeltpersonforetak (ENK) no.sole_trader
• Kommandittselsjap (KS) no.limited_partnership
• Ansvarlig Selskap (ANS/DA) no.general_partnership
• Aksjeselskap (AS) no.private_limited_company
• Allmennaksjeselskap (ASA) no.public_limited_company
• Samvirkeforetak (Samvirkeforetak) no.cooperative
• Stiftelse (Stiftelse) no.foundation
• Forening (Forening) no.association
• Norskregistrert Utenlandsk Foretak (Norskregistrert Utenlandsk Foretak) no.norwegian_registered_foreign_enterprise
• Annen (Annen) no.other

Peru PE

• Persona Natural (Persona Natural) pe.pers
• Empresa Unipersonal (E.U.) (Empresa Unipersonal (E.U.)) pe.eu
• Empresa Individual de Responsabilidad Limitada (E.I.R.L.) (Empresa Individual de Responsabilidad Limitada (E.I.R.L.)) pe.eirl
• Sociedad Anónima (S.A.) (Sociedad Anónima (S.A.)) pe.sa
• Sociedad Anónima Abierta (S.A.A.) (Sociedad Anónima Abierta (S.A.A.)) pe.saa
• Sociedad Anónima Cerrada (S.A.C.) (Sociedad Anónima Cerrada (S.A.C.)) pe.sac
• Sociedad Comercial de Responsabilidad Limitada (S.R.L.) (Sociedad Comercial de Responsabilidad Limitada (S.R.L.)) pe.srl
• Sociedad por Acciones Cerrada Simplificada (S.A.C.S.) (Sociedad por Acciones Cerrada Simplificada (S.A.C.S.)) pe.sacs
• Associación (Associación) pe.associación
• Fundación (Fundación) pe.fundación
• Comité (Comité) pe.comité

Poland PL

• Spółka Cywilna (Spółka Cywilna) pl.cywilna
• Indywidualna działalność gospodarcza (Indywidualna działalność gospodarcza) pl.indywidualna
• Stowarzyszenie/Fundacja (Stowarzyszenie/Fundacja) pl.stowarzyszenie_fundacja
• spółka komandytowo-akcyjna (Spółka komandytowo-akcyjna) pl.komandytowo-akcyjna
• spółka komandytowa (Spółka komandytowa) pl.komandytowa
• spółka jawna (Spółka jawna) pl.jawna
• spółka akcyjna (Spółka akcyjna) pl.akcyjna
• spółka z o.o. (Spółka z o.o.) pl.zoo
• spółka partnerska (Spółka partnerska) pl.partnerska

Portugal PT

• Empresário em nome individual (Empresário em nome individual) pt.eni
• Associação/Organização sem fins lucrativos (Associação/Organização sem fins lucrativos) pt.asfl
• Sociedade Civil (Sociedade Civil) pt.sociedad
• Sociedade por Quotas (Sociedade por Quotas) pt.sociedad_limitada
• Sociedade Anônima (Sociedade Anônima) pt.sociedad_anonima
• Sociedade em Comandita (Sociedade em Comandita) pt.sociedad_comanditaria
• Sociedade em Nome Colectivo (Sociedade em Nome Colectivo) pt.sociedad_colectiva
• Cooperativas (Cooperativas) pt.sociedad_cooperativa
• Espresa Estatal (Espresa Estatal) pt.state_agency
• Pessoas Colectivas de Direito Público (Pessoas Colectivas de Direito Público) pt.pcdp

Romania RO

• Persoana fizica autorizata (PFA) ro.sole_trader
• Asociere fără personalitate juridică (Asociere fără personalitate juridică) ro.unregistered_partnership
• Societatea în nume colectiv (SNC) ro.general_partnership
• Societatea în comandită simplă (SCS) ro.limited_partnership
• Societatea în comandită pe acțiuni, (SCA) ro.partnership_limited_by_shares
• Societatea pe acțiuni (SA) ro.public_limited_company
• Societatea cu răspundere limitată (SRL) ro.private_limited_company
• Societatea cu răspundere limitată cu proprietar unic (SRL cu proprietar unic) ro.private_limited_company_with_sole_owner
• Cooperativă (Cooperativă) ro.cooperative
• Asociație (Asociație) ro.association
• Fundație (Fundație) ro.foundation
• Alt (Alt) ro.other

Slovakia SK

• akciová spoločnosť (a.s.) sk.public_limited_company
• verejná obchodná spoločnosť (v.o.s.) sk.general_partnership
• komanditná spoločnosť (k.s.) sk.limited_partnership
• spoločnosť s ručením obmedzeným (s.r.o.) sk.private_limited_company
• živnostník (živnostník) sk.sole_trader
• Združenie bez právnej subjektivity (Združenie bez právnej subjektivity) sk.unregistered_partnership
• Združenie (Združenie) sk.association
• Nadácia (Nadácia) sk.foundation
• Podnik / Organizačná zložka podniku zahraničnej osob (Podnik / Organizačná zložka podniku zahraničnej osob) sk.enterprise_or_foreign_company
• Iný (Iný) sk.other
• Družstvo (Družstvo) sk.cooperative

Slovenia SI

• Komanditna delniška družba (k.d.d.) si.partnership_limited_by_shares
• Združenje (Združenje) si.foundation
• Samostojni podjetnik (s.p.) si.sole_trader
• Komanditna družba (k.d.) si.limited_partnership
• Družba z neomejeno odgovornostjo (d.n.o.) si.private_unlimited_company
• Družba z omejeno odgovornostjo (d.o.o.) si.private_limited_company
• Delniška družba (d.d.) si.public_limited_company
• Zadruga (Zadruga) si.cooperative
• Druga (Druga) si.other
• Društvo, zveza društev (Društvo, zveza društev) si.association

Spain ES

• Empresario Individual/autónomo (Empresario Individual/autónomo) es.autonomo
• Comunidad de Bienes (Comunidad de Bienes) es.comunidad
• Sociedad Civil (Sociedad Civil) es.sociedad
• Asociaciones sin ánimo de lucro (Asociaciones sin ánimo de lucro) es.asociaciones
• Sociedad Colectiva (Sociedad Colectiva) es.sociedad_colectiva
• Sociedad Limitada (Sociedad Limitada) es.sociedad_limitada
• Sociedad Anónima (Sociedad Anónima) es.sociedad_anonima
• Sociedad Comanditaria (Sociedad Comanditaria) es.sociedad_comanditaria
• Sociedad Cooperativa (Sociedad Cooperativa) es.sociedad_cooperativa
• Agencia Estatal (Agencia Estatal) es.state_agency

Sweden SE

• Enskildnärings - verksamhet (Enskildnärings) se.sole_trader
• Kommanditbolag (Kommanditbolag) se.limited_partnership
• Aktiebolag (Aktiebolag) se.limited
• Handelsbolag (Handelsbolag) se.trading_partnership
• Förening (Förening) se.economic_association

Switzerland CH

• Kollektivgesellschaft (Kollektivgesellschaft) ch.kollektivgesellschaft
• Kollektivgesellschaft (OLD) (Kollektivgesellschaft (OLD)) ch.kollektivgesellschaft
• Einzelfirma (Einzelfirma) ch.einzelfirma
• Kommanditgesellschaft (Kommanditgesellschaft) ch.kommanditgesellschaft
• Gesellschaft mit beschränkter Haftung (Gesellschaft mit beschränkter Haftung) ch.gesellschaft_haftung
• Aktiengesellschaft/ Société anonyme (Aktiengesellschaft/ Société anonyme) ch.aktiengesellschaft_societe
• Verein (Verein) ch.ch_verein
• Einfache Gesellschaft (Einfache Gesellschaft) ch.einfachegesellschaft

United Kingdom GB

• All partnerships (Partnership (LP, LLP)) gb.partnership
• Sole proprietorship / sole trader (Sole trader) gb.sole_trader
• All clubs or societies (Club or society) gb.society
• All schools, colleges or universities (School, college or university) gb.edu
• All other legal forms (Other) gb.other
• Private limited company (Limited company (Ltd.)) gb.limited

United States US

• Limited Partnership (LP) us.partnership
• Limited Liability Partnership (LLP) us.llp
• Limited Liability Limited Partnership (LLLP) us.lllp
• Limited Company (LC) us.lc
• Limited Liability Company (LLC) us.llc
• Professional Limited Liability Company (PLLC) us.pllc
• Single Member Limited Liability Company (SMLLC) us.smllc
• Corporation Incorporated (Corp. Inc.) us.corp_inc
• Professional Corporation (PC) us.pc
• Non-profit Organisation (Non-profit Organisation) us.uba_org
• Sole proprietorship (Sole proprietorship) us.sole_trader

Business Profile

A Merchant’s business profile contains information that a Merchant wants to be publicly visible for their customers, for example on their website.

Addresses

The Merchant object uses a comprehensive address format that can handle addresses from around the world. The address fields used depend on the country conventions. For example, in Great Britain, city is post_town. In the United States, the top-level administrative unit used in addresses is state, whereas in Chile it’s region.

The address structure is based on libaddressinput used by Android and Chromium.

Whether an address is valid depends on whether the locally required fields are present. For example:

• Germany: requires street_address, post_code, and city
• United States: uses state for the top-level administrative unit
• Great Britain: uses post_town instead of city
• Chile: uses region for the top-level administrative unit
• Ireland: uses eircode instead of post_code

Core Address Fields

• country: The two letter country code formatted according to ISO3166-1 alpha-2. Example: ["DE", "GB"]
• street_address: The address lines, with each element representing one line. Example: ["Paul-Linke-Ufer 39-40", "2. Hinterhof"]

Post code

A postal code included in a postal address for the purpose of sorting mail.

The following fields are used for post code, depending on the country:

• post_code (default): used by most countries. Example: "10999"
• zip_code: used in the United States
• eircode: used in the Ireland

Administrative areas

The address supports up to 3 levels of administrative areas, administrative_area_level_1 through administrative_area_level_3.

The following fields are used for administrative divisions, depending on the country:

• province (default): used in some countries for administrative divisions
• state: used in countries like the United States for the top-level administrative unit
• region: used in countries like Chile for administrative divisions
• county: used in countries like Ireland and Romania
• autonomous_community: used in Spain for the first sub-national level

Locality levels

The address supports up to 3 levels of locality levels, locality_level_1 through locality_level_3.

For more specific location information:

• city (default): a city
• post_town: used in Great Britain instead of city
• district: a district within a city or region
• neighborhood: a neighborhood or local area
• suburb: a suburb or outlying area of a city
• village: a village or small settlement
• municipality: a municipality or local government area

Persons

A Person is someone who plays some legally relevant role in the Merchant.

Person Relations

Persons can have various roles within a merchant:

• Legal Representative: the person legally representing the business towards SumUp
• Business Owner: owner of the business (especially for sole traders)
• Business Officer: officer of the business (for corporations)

Person identifiers

Belgium BE

• Numéro de registre national be.nn
  Numéro de registre national is the Belgian National Registration Number. Every Belgian citizen above the age of 12 has one upon first registration for an ID card. The format is YY.MM.DD-XXX.XX where YY.MM.DD is the birthdate and XXX.XX are a sequential ID and checksum.

Brazil BR

• Cadastro de Pessoas Física br.cpf
  Cadastro de Pessoas Física is the Brazilian personal identification number (Cadastro de Pessoas Físicas).

Bulgaria BG

• Единен граждански номер (Edinen grazhdanski nomer) bg.egn
  Единен граждански номер (Edinen grazhdanski nomer) is the Bulgarian Unified Civil Number (Единен граждански номер) which serves as a national identification number

Chile CL

• Rol Único Nacional cl.run
  Rol Único Nacional is the Chilean national ID number. For individuals it is used as tax ID. It is therefore the same as the RUT.
• Número de Documento cl.id_card_serial
  Número de Documento is the Chilean ID card serial number. It identifies the document, not the person. The document number used to be the same as the RUN, but that’s no longer the case.

Colombia CO

• Número Único de Identificación Personal co.nuip
  Número Único de Identificación Personal is the personal identification number on the Colombian cédula. The number is the same across all official documents, such as drivers licenses and civil registry documents. The cedula is between 6-10 digits long depending on when it was issued.

Cyprus CY

• Δελτίο Ταυτότητας cy.identity_card
  Δελτίο Ταυτότητας is the Cypriot national ID number.

Czech Republic CZ

• Občanský průkaz cz.civil_card
  Občanský průkaz is the Czech national ID number

Denmark DK

• Det Centrale Personregister nummer dk.cpr
  Det Centrale Personregister nummer is the Danish personal identification number, the Central Person Register number. It is used for identification purposes.

Estonia EE

• Isikukoodi ee.isikukoodi
  Isikukoodi is the Estonian national ID number.

Finland FI

• Henkilötunnus fi.hetu
  Henkilötunnus is the Finnish personal identification number, the Henkilötunnus.

Hungary HU

• Személyi igazolvány hu.szemelyi
  Személyi igazolvány is the Hungarian National ID the Személyi igazolvány. It is issued to Hungarian citizens and is used for identification purposes. The Personal ID is not used anymore.
• Adóazonosító jel hu.adoazonosito_jel
  Adóazonosító jel is the Hungarian personal tax identification number, the adóazonosító jel. It should not be confused with the adószám, the tax number. The difference between the adóazonosító jel and the adószám is that the latter is specifically issued for business purposes of natural and legal persons. The former is a personal identifier that should not be shared, for example on invoices, for privacy reasons. The two do share the same basic format. NOTE: because of this we should not expect to have adóazonosító jel values in our DB and should not collect them.

Italy IT

• Carta d’identità it.cie
  Carta d’identità is the Italian Carta d’Identità Elettronica, the electronic identity card. It is used as personal identification number.
• Codice fiscale it.itax
  Codice fiscale is the Italian tax identification number for natural and some legal persons. Registered companies use their REA as tax ID. Any entity with a VAT number uses that as tax ID. For natural persons the codice fiscale has 16 alphanumeric characters, for legal persons it has 11. The OECD and Wikipedia describe the format in detail.

Latvia LV

• Personas kods lv.personas_kods
  Personas kods is the Latvian personal identification code (PIC), the Personas kods. Every Latvian citizen has one, and foreigners can get one. The identifier is used for all interaction with the government and serves as personal tax ID. Sole traders may use their PIC for their business. It is an 11 digit number with an optional hyphen after the sixth digit. Before 1. July 2017, the PIC would consist of the date of birth of a person, followed by 5 random digits, withthe blocks separated by a dash.: YYMMDD-XXXXX. PICs issued from 1. July 2017 onward start with the number “3” followed by ten random numbers, also separated by a dash after position six: 3XXXXX-XXXXX. Sources are conflicting regarding the second digit. The EU Commission document on clickworker.com mentions that numbers should start with the digits “32”. The OECD document states numbers start with the number “3”, their example however starts with “38”, while all remaining digits are scrambled to not potentially leak a real number.

Lithuania LT

• Asmens tapatybės kortelė lt.asmens
  Asmens tapatybės kortelė is the Lithuanian personal identification number, the Asmens tapatybės kortelė. It is used for identification purposes.

Luxembourg LU

• Matricule lu.matricule
  Matricule is the Luxembourgian unique identification number for both natural and legal persons. It’s referred to as matricule or “numéro d’identification personnelle” and is used as tax ID. In the case of natural persons the matricule can have 11 or 13 digits. Any numbers issued from 2014 have 13 digits. Legal persons are issued matricules with 11 digits. The format for a natural person is YYYY MMDD XXX (XX), where the first 8 digits are the date of birth of the person. The remaining five digits are “random”. The 12th digit is a Luhn10 check digit. The 13th digit is a de Verhoeff check digit. Both are calculated from the first 11 digits. The format for legal persons is AAAA FF XX XXX, where AAAA is the year of formation, FF is the form of the company, and XX XXXare random numbers.

Malta MT

• Karta tal-Identità mt.karta_tal_identita
  Karta tal-Identità is the Maltese national ID number, the Identity Card Number. It is used for identification purposes.

Mexico MX

• Clave Única de Registro de Población mx.curp
  Clave Única de Registro de Población is the Mexican personal identification number, the Clave Única de Registro de Población. It is used for identification purposes.
• Régimen Fiscal mx.tax_regimen
  The Tax Regime classifies taxpayers according to their economic activity and tax obligations.

Norway NO

• Fødselsnummer no.fodelsnummer
  Fødselsnummer is the Norwegian national ID number, the Fødselsnummer. It is used for identification purposes. All official IDs, including passports, national ID cards, driving licenses and bank cards contain the National Identity Number.

Peru PE

• Cédula Única de Identidad pe.cui
  Cédula Única de Identidad is the Peruvian unique identity number that appears on the Documento Nacional de Identidad (DNI), the national identity document of Peru. The number consists of 8 digits and an optional extra check digit.

Poland PL

• Powszechny Elektroniczny System Ewidencji Ludności pl.pesel
  Powszechny Elektroniczny System Ewidencji Ludności is the Polish national ID number, the Powszechny Elektroniczny System Ewidencji Ludności. The number consists of the date of birth, a serial number, the person’s gender and a check digit.

Portugal PT

• Cartão de Cidadão pt.cc
  Cartão de Cidadão is the Portuguese citizen card number, the Cartão de Cidadão. It is alphanumeric and consists of the numeric Número de Identificação Civil, a two-letter version and a check digit. Format: DDDDDDDD C AAT - DDDDDDDD: Número de Identificação Civil [0-9] - C: Check digit [0-9] - AA: Two-letter version [A-Z, 0-9] - T: Check digit [0-9]

Romania RO

• Codul numeric personal ro.cnp
  Codul numeric personal is the Romanian unique identification number for individuals, the Cod numeric personal. The CNP is issued for residents by the Ministry of Internal Affairs. It also serves as tax identification number for natural persons, in particular for sole traders and similar legal types that do not register with the Trade Registry. The CNP consists of 13 digits, the last of which is a check digit (see wikipedia).

Slovakia SK

• Rodné číslo sk.rc
  Rodné číslo is the Slovak Republic’s birth number, the Rodné číslo. The birth number is the Slovak national identifier. The number can be 9 or 10 digits long. Numbers given out after January 1st 1954 should have 10 digits. The number includes the birth date of the person and their gender

Slovenia SI

• Enotna matična številka občana (Unique Master Citizen Number) si.emso
  Enotna matična številka občana (Unique Master Citizen Number) is the Slovenian personal identification number, the EMŠO. The EMŠO is used for uniquely identify persons including foreign citizens living in Slovenia. It is issued by Centralni Register Prebivalstva CRP (Central Citizen Registry). used for identification purposes. The number consists of 13 digits and includes the person’s date of birth, a political region of birth and a unique number that encodes a person’s gender followed by a check digit.

Spain ES

• Número de Identificación de Extranjero es.nie
  Número de Identificación de Extranjero is the Spanish tax ID for foreign nationals, the Número de Identificación de Extranjero.
• Documento Nacional de Identidad es.dni
  Documento Nacional de Identidad is the Spanish national ID number, the Documento Nacional de Identidad. It is used for Spanish nationals. Foreign nationals, since 2010 are issued an NIE (Número de Identificación de Extranjeros, Foreigner’s Identity Number) instead.

Sweden SE

• Personnummer se.pn
  Personnummer is the Swedish personal identity number number, the personnummer. It is issued at birth, or at registration. The personnummer is used as tax identification number. The personnummer has 10 digits and should pass luhn’s checksum algorithm. The first six or eight digits are the date of birth of a person, i.e. YYMMDD or YYYYMMDD. The In case the specific day is out of birth numbers, another day (close to the correct one) is used. They are followed by a hyphen, and four final digits. The year a person turns 100 the hyphen is replaced with a plus sign. Among the four last digits, the three first are a serial number. For the last digit among these three, an odd number is assigned to males and an even number to females.

United States US

• Social Security Number us.ssn
  Social Security Number is the United States social security number. It is used for taxation of natural persons, like sole traders. From Wikipedia: > The SSN is a nine-digit number, usually written in the format AAA-GG-SSSS. > The number has three parts: the first three digits, called the area number because > they were formerly assigned by geographical region; the middle two digits, the > group number; and the last four digits, the serial number.