Crea tu primera persona

En Fiscalapi, una persona representa cualquier entidad fiscal: una persona física (un individuo) o una persona moral (una empresa). Sobre cada persona gestionas otros recursos de tu organización: asignas y retiras timbres, administras sus certificados (CSD), creas y revocas API keys, y controlas si puede generar facturas.

Tipos de persona

Una persona puede ser una empresa que emite facturas CFDI (emisor), un cliente que las recibe (receptor), un empleador que contrata empleados o un empleado que trabaja para una empresa. También puede ser una organización con sus propios clientes, una holding con varias empresas filiales o subsidiarias, un usuario que consume la API dentro de una organización, o una persona física.

Persona como emisor en facturas de nómina

Cuando una persona actúa como empleador (patrón) en facturas de nómina, debe tener registrados sus datos de empleador. Si la persona emisora es una persona física, captura también su CURP como parte de sus datos fiscales.

Persona como receptor en facturas de nómina

Cuando una persona actúa como empleado en facturas de nómina, debe tener registrados sus datos de empleado. Como el empleado siempre es una persona física, captura también su CURP como parte de sus datos fiscales.

Creación de personas

En el dashboard, ve a Catalogos > Personas y haz clic en + sobre la tabla de personas. Una vez creada la persona, puedes subir sus certificados, crear API keys y asignar o retirar timbres con los botones + y - de la fila seleccionada.

Completa el formulario con los datos fiscales de la persona. Para facturar en el ambiente de pruebas, usa las personas de prueba o los datos fiscales de tu empresa o de tu cliente.

Datos fiscales obligatorios para facturar

Para facturar, la persona necesita razón social, RFC, email, régimen fiscal, uso del CFDI y código postal. El campo Contraseña Sellos (taxPassword) es opcional, porque Fiscalapi no lo usa para sellar las facturas: al timbrar usa la contraseña de la llave privada que registras al subir los certificados (siguiente sección). Para las personas de prueba, esa contraseña es 12345678a.

Subir certificados

En el dashboard, ve a Catalogos > Personas, selecciona la persona a la que quieres cargar los certificados y haz clic en + sobre su tabla de certificados.

Subir certificado CSD

Completa el formulario con los datos del certificado y elige el tipo correcto: Certificado CSD para el archivo .cer o Clave privada CSD para el archivo .key. En los dos archivos captura la contraseña de la llave privada (12345678a para las personas de prueba).

Subir clave privada CSD

Repite el proceso con el archivo .key y haz clic en Save para guardar los cambios.