identity-mx 0.1.1

Generador de CURP y RFC para ciudadanos mexicanos

Herramienta para generar Clave Única de Registro de Población (CURP) y el Registro Federal de Contribuyentes (RFC), datos que se emplean en diversos trámites en México.

• La CURP es asignada por la Secretaría de Gobernación (SEGOB) y sirve para demostrar que existes legalmente ante el gobierno mexicano. Se estructura con 18 caracteres alfanuméricos (letras y números) que se dividen en 7 bloques de información personal. Su diseño permite que cada clave sea única para cada habitante de México.
• El RFC es asignado por el Servicio de Administración Tributaria (SAT) y sirve para dar seguimiento a tus obligaciones y derechos relacionados al ser contribuyente. El RFC para personas físicas se estructura con 13 caracteres alfanuméricos (letras y números). Utiliza una fórmula muy similar a la de la CURP, pero es más corto e incluye tres dígitos finales únicos generados por el SAT

Aviso importante: los valores generados no deben considerarse oficiales ni sustituir una validación ante las autoridades correspondientes. Esta herramienta sirve únicamente como apoyo para generar la estructura base de la CURP y el RFC, con base en la documentación consultada a finales de 2021.

Instalación

Usando pip

pip install identity_mx

Desde el repositorio

git clone https://github.com/Kinnara-Digital/identity-mx.git
cd identity-mx
pip install .

Uso

Como librería Python

from identity_mx import generar_curp_rfc

datos = {
    "nombre": "Juan",
    "primero": "Pérez",
    "segundo": "López",
    "genero": "H",
    "edo_nac": "DF",
    "dia_nac": "20",
    "mes_nac": "06",
    "anio_nac": "1999"
}

resultado = generar_curp_rfc(datos)
print(resultado)
# {'curp': 'PELJ990620HDFRPN04', 'rfc': 'PELJ9906202A3'}

Por línea de comandos

Una vez instalado, puedes usar el comando identity-mx:

identity-mx Juan Pérez López H DF 20 06 1999

Salida:

{'curp': 'PELJ990620HDFRPN04', 'rfc': 'PELJ9906202A3'}

Casos especiales

Si no tienes segundo apellido:

datos = {
    "nombre": "María",
    "primero": "González",
    "segundo": "",  # Vacío
    "genero": "M",
    "edo_nac": "MC",
    "dia_nac": "20",
    "mes_nac": "06",
    "anio_nac": "1999"
}

resultado = generar_curp_rfc(datos)
print(resultado)
# {'curp': 'GOXM990620MMCNXR07', 'rfc': 'GOMA990620PA8'}

Si no necesitas la CURP (solo RFC), se utiliza el género 'X' correspondiente a 'No Binario' y el estado de nacimiento 'NE' correspondiente a 'Nacido en el Extranjero':

datos = {
    "nombre": "Carlos",
    "primero": "Sánchez",
    "segundo": "Martínez",
    "genero": "X",  # No Binario
    "edo_nac": "NE",  # Nacido en el Extranjero
    "dia_nac": "20",
    "mes_nac": "06",
    "anio_nac": "1999"
}

Datos requeridos

• Nombre(s).
• Primer apellido.
• Segundo apellido (opcional).
• Género: únicamente H (Hombre) / M (Mujer) / X (No Binario).
• Clave del estado de nacimiento.
• Día de nacimiento con exactamente 2 dígitos.
• Mes de nacimiento con exactamente 2 dígitos.
• Año de nacimiento con exactamente 4 dígitos.

Claves de estado aceptadas

AS, BC, BS, CC, CS, CH, CL, CM, DF, DG, GT, GR, HG, JC, MC, MN, MS, NT, NL, OC, PL, QT, QR, SP, SL, SR, TC, TS, TL, VZ, ZS y NE.

Manejo de errores

La función lanza excepciones ValueError cuando los datos no son válidos:

from identity_mx import generar_curp_rfc

try:
    # Mes inválido (mes 13 no existe)
    resultado = generar_curp_rfc({
        "nombre": "Test",
        "primero": "Test",
        "segundo": "",
        "genero": "H",
        "edo_nac": "DG",
        "dia_nac": "15",
        "mes_nac": "13",  # ❌ Inválido
        "anio_nac": "1990"
    })
except ValueError as e:
    print(f"Error: {e}")
    # Error: El campo Mes de nacimiento(mes_nac) debe estar entre 01 y 12.

Guía completa de errores y soluciones

Ejemplo completo de manejo de errores

from identity_mx import generar_curp_rfc

datos_invalidos = {
    "nombre": "Juan123",      # ❌ Contiene números
    "primero": "Pérez",
    "segundo": "López",
    "genero": "Z",            # ❌ Género inválido
    "edo_nac": "XX",          # ❌ Estado inválido
    "dia_nac": "5",           # ❌ Solo 1 dígito (debe ser "05")
    "mes_nac": "13",          # ❌ Mes fuera de rango
    "anio_nac": "1850"        # ❌ Año antes de 1900
}

try:
    resultado = generar_curp_rfc(datos_invalidos)
except ValueError as e:
    print(f"Error de validación: {e}")

La librería validará los campos en orden y reportará el primer error encontrado.