Facturas

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta invoice proporciona 8 acciones que cubren el ciclo completo de facturación — desde crear borradores de facturas hasta enviarlas, dar seguimiento al pago y manejar cancelaciones. Cada operación de facturación disponible en la aplicación web de GitScrum es accesible a través de conversación en lenguaje natural con tu asistente de IA.

Las facturas en GitScrum siguen un ciclo de vida de estado estricto. Cada factura progresa a través de estados definidos, y el MCP Server aplica estas transiciones automáticamente. Tu asistente de IA puede crear facturas con partidas detalladas, enviarlas a clientes, registrar pagos y generar analíticas de facturación — todo sin salir de tu IDE o cliente de IA.

Resumen de acciones

Ciclo de vida del estado

Cada factura sigue una progresión de estado definida. El MCP Server aplica transiciones válidas — no puedes marcar un borrador como pagado sin enviarlo primero, y las facturas canceladas no pueden reabrirse.

  ┌───────────┐    send     ┌──────────┐   mark_paid   ┌────────┐
  │ Borrador  │ ──────────► │ Enviada  │ ─────────────► │ Pagada │
  └───────────┘             └──────────┘                └────────┘
      │                         │
      │       cancel            │        (auto)
      │◄────────────────────    │──────────────────►  ┌──────────┐
      │                         │    past due_date    │ Vencida  │
      ▼                         ▼                     └──────────┘
  ┌───────────┐           ┌───────────┐                    │
  │ Cancelada │           │ Cancelada │                    │ cancel
  └───────────┘           └───────────┘                    ▼
                                                     ┌───────────┐
                                                     │ Cancelada │
                                                     └───────────┘

• Borrador (Draft) — Estado inicial. Editable. Puede enviarse o cancelarse.
• Enviada (Sent) — Entregada al cliente. Transiciona a pagada, vencida o cancelada.
• Pagada (Paid) — Pago registrado. Estado terminal.
• Vencida (Overdue) — Se establece automáticamente cuando una factura enviada pasa su fecha de vencimiento.
• Cancelada (Cancelled) — Terminada. Estado terminal.

Listar facturas

La acción list devuelve las facturas dentro de un workspace. Filtra por estado o cliente para reducir los resultados.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

You:  "Muestra todas las facturas"
AI:   Llama a invoice action=list → devuelve lista de facturas con estado y montos

You:  "Lista las facturas sin pagar"
AI:   Llama a invoice action=list con status="sent"

You:  "Muestra las facturas vencidas"
AI:   Llama a invoice action=list con status="overdue"

You:  "Lista todas las facturas de Acme Corp"
AI:   Encuentra UUID del cliente → llama a invoice action=list con client_uuid

Obtener detalles de factura

La acción get devuelve la factura completa — título, cliente, partidas, montos, impuestos, fechas, estado e historial de pagos.

Parámetros requeridos

You:  "Muéstrame los detalles de la factura del proyecto web de Acme Corp"
AI:   Encuentra la factura → llama a invoice action=get → devuelve factura completa con partidas

You:  "¿Cuál es el total de nuestra última factura?"
AI:   Lista facturas recientes → llama a invoice action=get → extrae el monto total

Crear facturas

La acción create construye un nuevo borrador de factura. Puedes incluir partidas, tasas de impuestos, asociación de cliente y moneda en una sola llamada. La factura comienza en estado Borrador, permitiendo revisión y ediciones antes de enviarla.

Parámetros requeridos

Parámetros opcionales

Estructura de partidas

Cada elemento en el array items sigue esta estructura:

Ejemplos de prompts

You:  "Crea una factura para Acme Corp: Rediseño de Sitio Web, $5,000, vence el 15 de marzo"
AI:   Encuentra UUID del cliente → llama a invoice action=create con title="Website Redesign",
      client_uuid, items=[{description: "Website Redesign", quantity: 1, unit_price: 5000}],
      due_date="2026-03-15"

You:  "Factura a TechStart por 40 horas de desarrollo a $150/hora más 10% de impuesto"
AI:   Llama a invoice action=create con título, client_uuid,
      items=[{description: "Development Services", quantity: 40, unit_price: 150}],
      tax_rate=10

You:  "Crea una factura con tres partidas:
       - Diseño UX: 20 horas a $120
       - Desarrollo Frontend: 60 horas a $150
       - Pruebas QA: 15 horas a $100"
AI:   Llama a invoice action=create con array de items conteniendo las tres entradas

Actualizar facturas

La acción update modifica un borrador de factura. Solo las facturas en estado Borrador pueden actualizarse — una vez enviadas, la factura queda bloqueada.

Parámetros requeridos

Todos los parámetros opcionales de create están disponibles en update.

You:  "Agrega un 10% de impuesto a la factura de Acme Corp"
AI:   Llama a invoice action=update con tax_rate=10

You:  "Cambia la fecha de vencimiento al 1 de abril"
AI:   Llama a invoice action=update con due_date="2026-04-01"

You:  "Actualiza las notas de la factura: 'Términos de pago Net 30'"
AI:   Llama a invoice action=update con notes="Net 30 payment terms"

Enviar facturas

La acción send transiciona una factura de Borrador a Enviada. Esto entrega la factura al cliente y la bloquea de futuras ediciones. El cambio de estado se registra con una marca de tiempo.

Parámetros requeridos

You:  "Envía la factura de Acme Corp"
AI:   Llama a invoice action=send → la factura transiciona de Borrador a Enviada

You:  "Envía todas las facturas en borrador"
AI:   Lista los borradores de facturas → llama a invoice action=send para cada una

Registrar pago

La acción mark_paid registra el pago en una factura enviada o vencida. Opcionalmente puedes especificar la fecha de pago y el método para registros contables.

Parámetros requeridos

Parámetros opcionales

You:  "Marca la factura de Acme Corp como pagada"
AI:   Llama a invoice action=mark_paid → la factura transiciona a Pagada

You:  "Registra el pago de la factura, recibido ayer por transferencia bancaria"
AI:   Llama a invoice action=mark_paid con payment_date="2026-02-05",
      payment_method="Bank transfer"

You:  "Marca todas las facturas vencidas de TechStart como pagadas"
AI:   Lista las facturas vencidas del cliente → llama a mark_paid para cada una

Cancelar facturas

La acción cancel termina una factura. Esto funciona en facturas en estado Borrador, Enviada o Vencida. Opcionalmente puedes proporcionar una razón para la cancelación.

Parámetros requeridos

Parámetros opcionales

You:  "Cancela el borrador de factura de Global Media"
AI:   Llama a invoice action=cancel → la factura transiciona a Cancelada

You:  "Cancela la factura con razón: 'El alcance del proyecto cambió, nueva factura por enviar'"
AI:   Llama a invoice action=cancel con reason

Estadísticas de facturación

La acción stats devuelve métricas de facturación a nivel de workspace — monto total facturado, pagado vs pendiente, totales vencidos, tiempo promedio de pago y tendencias de ingresos. Estos números alimentan el dashboard de facturación en la aplicación web de GitScrum.

Parámetros requeridos

You:  "Muestra las estadísticas de facturación"
AI:   Llama a invoice action=stats → devuelve total facturado, pagado, pendiente, vencido

You:  "¿Cuántos ingresos tenemos pendientes?"
AI:   Llama a invoice action=stats → extrae el total de facturas pendientes

You:  "¿Cuál es nuestro tiempo promedio de pago?"
AI:   Llama a invoice action=stats → devuelve los días promedio hasta el pago

Flujo de facturación

Para agencias que gestionan múltiples compromisos con clientes, este flujo cubre el ciclo completo de facturación:

1. Crear la factura

Construye una factura detallada con partidas vinculada a un cliente.

You:  "Crea una factura para Acme Corp: Entrega Fase 1 — 80 horas frontend a $150,
       20 horas diseño a $120, 10% impuesto, vence el 30 de marzo"
AI:   Una sola llamada create con todas las partidas, impuesto y fecha de vencimiento

2. Revisar y ajustar

Revisa el borrador antes de enviarlo.

You:  "Muéstrame la factura de Acme Corp"
AI:   Llama a invoice action=get → muestra la factura completa para revisión

You:  "Agrega una nota: 'Pago por transferencia bancaria a cuenta terminada en 4521'"
AI:   Llama a invoice action=update con notes

3. Enviar al cliente

Entrega la factura.

You:  "Envía la factura de Acme Corp"
AI:   Llama a invoice action=send → la factura se entrega y bloquea

4. Dar seguimiento al pago

Monitorea el pago y regístralo cuando se reciba.

You:  "¿Hay facturas vencidas?"
AI:   Llama a invoice action=list con status="overdue" → muestra las vencidas

You:  "Acme Corp pagó su factura por transferencia bancaria"
AI:   Llama a invoice action=mark_paid con payment_method="Wire transfer"

5. Revisar la salud de facturación

Monitorea el rendimiento general de facturación.

You:  "Muéstrame el resumen de facturación"
AI:   Llama a invoice action=stats → resume ingresos, pendientes y tendencias de pago

Próximos pasos

• Clientes: Gestiona registros de clientes vinculados a tus facturas.
• Propuestas: Crea propuestas que se conviertan en proyectos facturables.
• Dashboards ClientFlow: Accede a analíticas de facturación y reportes entre workspaces.
• Proyectos: Gestiona la entrega de proyectos junto con la facturación.