Calculate the Mexican RFC as specified by the SAT (Servicio de Administración Tributaria) for Personas Físicas

About The Project

This project calculates a "Persona Física"'s RFC based on SAT's specifications including homonymy and verification digit.

Built With

• Vite
• Vitest

(back to top)

Installation

Yarn:

yarn add calculate-rfc

NPM:

npm install calculate-rfc

(back to top)

Usage

Import:

import { calculateMexicanRFC } from 'calculate-rfc'

Require:

const { calculateMexicanRFC } = require('calculate-rfc')

Usage:

const rfc = calculateMexicanRFC({
  name: 'Guillermo',
  patronymic: 'Del Toro', // name derived from a name of a father or ancestor
  matronymic: 'Gómez', // name derived from a name of a mother or ancestor
  year: '64',
  month: '10',
  day: '09',
})

console.log(rfc) // TOGG641009MGA

Note: Names in Mexico usually have two last names ordered as name(s) patronymic matronymic, however, names with a single last name are also valid. In order to get an accurate result, the full name should match the one registered with SAT.

(back to top)

Acknowledgments

There is no guarantee that the calculated RFC will match the real RFC as only the SAT can assign an RFC to ensure homonymy and verification code uniqueness, therefore, be sure to validate the output with your users.

The RFC specifications can be downloaded from "Plataforma Nacional de Transparencia" with the folio: 0610100135506

This README's structure is based off Best-README-Template

(back to top)

Roadmap

• Add tests for all SAT rules
• Validate input

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Thanks!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
   1. Install dev dependencies with yarn
   2. Run test server with yarn test.
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)