Marcar factura como pagada

Cambia el estado de una factura de "Facturada" a "Pagada" y registra los métodos de pago utilizados.

Autenticación requerida: Este endpoint requiere autenticación Bearer Token. Usar el campo tokenCurrent obtenido del servicio de login (/login) en el header: Authorization: Bearer {tokenCurrent}

Requisitos:

• La factura debe estar en estado "Facturada"
• Requiere caja registradora activa
• El usuario debe tener permisos para crear facturas

Proceso:

• Actualiza el estado de la factura a "Pagada"
• Registra métodos de pago con timestamp
• Actualiza estado de órdenes asociadas
• Envía a integraciones contables (Siigo, Loggro)
• Registra propinas y costos de entrega

Ejemplos de Uso

1. Pago en efectivo

{
  "_id": "507f1f77bcf86cd799439020",
  "paymentMethodValue": [
    {
      "paymentMethod": "507f1f77bcf86cd799439018",
      "value": 45000
    }
  ],
  "tip": 5000
}

2. Pago mixto (efectivo + tarjeta)

{
  "_id": "507f1f77bcf86cd799439021",
  "paymentMethodValue": [
    {
      "paymentMethod": "507f1f77bcf86cd799439018",
      "value": 20000
    },
    {
      "paymentMethod": "507f1f77bcf86cd799439019",
      "value": 25000
    }
  ]
}

3. Actualizar información del cliente

{
  "_id": "507f1f77bcf86cd799439022",
  "paymentMethodValue": [
    {
      "paymentMethod": "507f1f77bcf86cd799439018",
      "value": 30000
    }
  ],
  "client": {
    "name": "Juan Pérez Actualizado",
    "phone": "+57 300 123 4567",
    "email": "[email protected]"
  }
}