6. Publicar

El plugin está completo. Queda revisarlo, probarlo en un servidor real y publicarlo para que otros lo instalen.

Revisión final

La estructura terminada:

• Directoriofidelizacion/

  • index.ts migraciones, hooks, endpoints, widget y AI tool
  • manifest.json módulo, sub-tab, ruta, widget y tema
  • Directorioui/

    • Page.tsx página del historial de movimientos
    • TopClientes.tsx widget del dashboard
  • package.json
  • README.md descripción para el marketplace

Checklist del package.json:

• @openfactu/plugin-sdk como devDependency (solo aporta tipos).
• drizzle-orm, ai y zod como dependencies (las versiones que traiga el template).
• name y version coherentes con el manifest.json.

Probar en un servidor real

1. Sube el plugin al servidor de producción (o staging):

   openfactu plugin push \
     --server https://erp.miempresa.com \
     --client-id ofk_... \
     --client-secret ofs_...

2. Activa el plugin en la empresa que corresponda (menú Plugins → toggle).

3. Repite los checkpoints de las partes 3–5: asentar factura → puntos, canje inválido → error, módulo visible, widget en el dashboard, tool de IA respondiendo.

Publicar en el marketplace

La publicación funciona por GitHub, sin registro previo:

1. Sube tu repo a GitHub (público).

2. Añade el topic openfactu-plugin al repositorio (Settings → Topics). Es lo único obligatorio: el marketplace lo detecta automáticamente.

3. Añade topics descriptivos (ventas, fidelizacion, crm…) — el marketplace los muestra como tags.

4. Cuida el README.md: es la descripción que verán los usuarios en la ficha del plugin.

Detalles (checklist completo, versionado, verificación) en Marketplace.

Instalación por otros usuarios

Cualquier servidor Keirost podrá instalarlo:

# Vía CLI
openfactu plugin install fidelizacion

# O manualmente
git clone https://github.com/tu-usuario/fidelizacion.git plugins/fidelizacion
docker compose restart server

Siguientes pasos

Referencia del PluginContextLos 8 campos del contexto, en detalle.

Catálogo de hooksLos 39 eventos disponibles: documentos, contabilidad, pagos, RRHH, logística.

FactuAPITransacciones atómicas, documentos, maestros y contabilidad desde tu plugin.

Desarrollo remotoAPI keys, push, watch y hot reload en detalle.