Proyectos y facturación

En Finova for Developers, un proyecto es la unidad de organización y de facturación de tu actividad como developer. Un proyecto lo es de un usuario (tú) y agrupa una o varias empresas: cada empresa que activa el modo developer se une a exactamente un proyecto, y todo el consumo de esas empresas se factura junto, en una sola factura por proyecto.

Piénsalo como una agencia: si administras varias empresas (clientes), las juntas bajo un mismo proyecto y recibes una factura mensual por todas, con el desglose de cuánto consumió cada empresa. Si solo tienes una empresa, tu proyecto simplemente tiene una empresa adentro.

El modelo en una frase

Un proyecto (tuyo) agrupa varias empresas. El uso se atribuye al proyecto y se desglosa por empresa; al cerrar el mes se emite una factura/CFDI por proyecto que cubre todas sus empresas, con el detalle de cuánto aportó cada una.

Cómo se relacionan las cosas

• Proyecto — la entidad de más alto nivel y la unidad de facturación. Tiene un dueño (el usuario que lo creó) y puede tener miembros con acceso. Agrupa una o más empresas.
• Empresa — cada empresa que activa developers se une a exactamente un proyecto. Toda empresa con developers activo pertenece a un proyecto.
• API key — pertenece a una empresa (a su cuenta de developers), no al proyecto. La empresa es la que tiene credenciales y dominios permitidos.
• Uso — cada llamada a la API se atribuye al proyecto de la empresa con cuya key se hizo, y se contabiliza por empresa dentro del proyecto.
• Factura — una por proyecto y por mes (NET 30), que cubre todas las empresas del proyecto. Lleva el desglose de costo por empresa.

Miembros y acceso

Un proyecto tiene un dueño y puede tener miembros (los agregas por correo). El dueño y los miembros pueden ver todas las empresas, API keys, consumo y facturas del proyecto desde el dashboard.

Este acceso es solo de developers: ser miembro de un proyecto te deja administrar las integraciones y la facturación de las empresas del proyecto, pero no te da acceso al resto de la aplicación de esas empresas. La membresía del proyecto es independiente de la membresía de empresa (CompanyMembership).

Facturación: el proyecto tiene sus propios datos fiscales

Como la factura es una sola por proyecto, también el CFDI es uno solo — y por lo tanto un solo RFC. Los datos fiscales (RFC, razón social, régimen, uso de CFDI, CP, correo) pertenecen al proyecto: los capturas una vez en el dashboard (Facturación → Datos fiscales) y con esos se timbra la factura mensual del proyecto. No hay que elegir "qué empresa factura": el proyecto es la entidad de facturación.

El método de pago y el estado de suspensión por falta de pago viven en el proyecto, no en cada empresa. Si una factura del proyecto se vence (+31 días), se suspende el proyecto completo; en cuanto se paga, se restablece el acceso de inmediato. (Nunca revocamos tus API keys por una suspensión: un pago las reactiva al instante.)

Crear y gestionar proyectos

Los proyectos se administran desde el dashboard (developers.fi-nova.com → pestaña Proyectos) o desde Finova en Configuración → Finova for Developers. Ahí puedes:

• Crear proyectos (ej. "Agencia Acme", "Cliente X", "Uso interno").
• Renombrar proyectos.
• Agregar y quitar miembros.
• Elegir la empresa de facturación (el RFC con el que se timbra).
• Archivar proyectos.

Los proyectos no se crean ni modifican desde la API pública (/api/v1/*) — son un concepto de organización y facturación de tu cuenta, no un recurso de datos de tu workspace. Tu integración no necesita cambiar nada por esto.

Activar developers siempre cae en un proyecto

Cuando activas developers en una empresa, esa empresa debe pertenecer a un proyecto. Al activar puedes elegir un proyecto existente (de los que ya tienes acceso) o crear uno nuevo en ese momento; si no eliges, la empresa se une a tu proyecto más antiguo o se crea uno automáticamente a tu nombre.

Reglas de archivado

• No puedes archivar un proyecto que tenga empresas con developers activo (desactívalas primero).
• No puedes archivar un proyecto con API keys vivas (revócalas antes, en sus respectivas empresas).
• No puedes archivar tu último proyecto activo.
• Archivar es reversible y no borra el historial: el consumo y las facturas pasadas conservan su atribución.

Cómo se ve en el uso y la factura

En el dashboard, las vistas de uso y de API keys se pueden filtrar por empresa dentro del proyecto, para ver cuánto consume y cuánto cuesta cada una. La factura mensual del proyecto incluye un campo breakdown_by_company con, por cada empresa, sus requests, errors y cost_cents — el subtotal que esa empresa aporta al total del proyecto.

El total de la factura y el cargo son por proyecto: un solo monto y un solo cobro al mes que cubren todas las empresas. El desglose por empresa solo te da visibilidad de a dónde se fue tu gasto.

Migración (cuentas existentes)

Si ya tenías cuentas de developers y API keys antes de este cambio, no tienes que hacer nada: agrupamos tus empresas por su dueño en un proyecto por usuario, movimos ahí tu uso histórico y tu método de pago, y conservamos tus API keys (ahora ligadas a su empresa). Puedes reorganizar cuando quieras creando proyectos nuevos y moviendo empresas o miembros.