New Feature Faker::CIF

[Elolawyn]

I'd like to be able to create valid spanish CIFs like in http://generadordni.es/. I think they are called VAT in other countries.

[PuZZleDucK]

It looks like the possible sequences are ########A and A#######A.
I'm not sure what VAT or CIFs are tho... are they bank account numbers? company identifiers? other?

[lucasqueiroz]

@PuZZleDucK I'm not sure if that's the only thing. I don't speak Spanish but since Portuguese is really close, I could understand what the website said but not what CIF is. I think it has a validation number somehow... I'll try to find more information

[PuZZleDucK]

lol... I was thinking it could be more appropriate as a localization of "Account number" or something similar rather than a whole new thing.

I'm sure the other two IDs are DNI and NIE as referenced in #872

[Elolawyn]

CIF is a sequence used to identify a company in our tax system. It seems NIF is like a CIF 2.0.

Wikipedia: https://es.wikipedia.org/wiki/C%C3%B3digo_de_identificaci%C3%B3n_fiscal

[PuZZleDucK]

Ok, from trying to comprehend auto-translated info it seems the first letter is one of "ABCDEFGHJNPQRSUVW".

Then two digit combinations for region (a set of sequences listed in the reference from @Elolawyn above)

Then a five digit identifier (I'd propose totally random)

The final character is a checksum sorta thing.

• sum the even digits
• double the odd digits and add sum each digit for each number, sum the total
• sum the first two sums and only take the first digit
• subtract this digit from 10 and % 10
  -then conditionally map to a letter (J = 0, A = 1, B = 2, C = 3, D = 4, E = 5, F = 6, G = 7, H = 8, I = 9)

Anyone thinks this sounds right-enough to run with?

[PuZZleDucK]

lol... gafaw... and facepalm :p

I was looking for a good place to put this when I stumbled upon spanish_organisation_number in the ``company.rb``` file... however it seems to have never made it to the docs :(

[PuZZleDucK]

Faker::Company.spanish_organisation_number

[stfcodes]

These "CIF"s are not specific to Spain only, and are more commonly known as VAT numbers (in the EU).

You can find more info here. No validation formula though.

[PuZZleDucK]

It says the number generation is delegated to each nation... so I don't think we could generalize the Spanish formula to other countries... although many might be similar 🤞

VAT also seems to have a country specific prefix which this does not have... so a Spanish CIF would have a prefix when expressed as a VAT... so "1234567X" might be "SP1234567X" when written as a VAT (note, not sure if Spains prefix is SP or not, just a hypothetical value)

[vbrazo]

@PuZZleDucK PRs merged successfully. Thanks for contributing 🥇