spcredito - Motor Financiero Autónomo

🧮 Simulador Financiero & Comparador Multimodelo

Parámetros de Simulación Cálculo en Vivo

Línea de Crédito / Modalidad:

Monto Operación ($):

Anticipo ($):

Cuotas:

TNA (%):

Gastos (%):

🎯 Simulador por Capacidad de Pago

Calcula el monto máximo prestable según cuota mensual:

Modelos de Financiación (Selecciona para ver cronograma)

N°	Vencimiento	Capital	Interés	Gastos/Imp	Cuota Total	Saldo Deudor

📝 Otorgar Crédito / Financiación de Factura

Nueva Operación de Financiación Genera Códigos de Pago únicos por cuota

Cliente Titular:

Tipo de Operación:

Canal de Origen:

Empresa / Comercio de Origen:

N° Comprobante / Factura Externa:

Línea de Crédito:

Sistema de Amortización:

Importe Total ($):

Anticipo en Efectivo ($):

Cantidad de Cuotas:

TNA (% Anual):

Primer Vencimiento:

Observaciones / Detalle de Productos:

⚡ Cobro Rápido de Cuotas por Código Específico

Terminal de Cobro Universal (Válido desde Cualquier Empresa o spcredito) Cobro por Código

Cualquier empresa aliada, sucursal o punto de cobro puede ingresar el Código de Pago de la cuota (impreso en la factura, pagaré o cupón) para consultar el saldo exacto con mora e imputar el cobro de inmediato.

💰 Cuotas Pendientes & Gestión de Caja

Listado General de Cuotas a Cobrar

Código de Pago	Operación	Titular / Procedencia	Cuota	Vencimiento	Importe	Mora Punitoria	Total a Cobrar	Estado	Acción

📂 Cartera de Operaciones Emitidas

Historial de Créditos y Financiaciones

Cód. Operación	Fecha Emisión	Cliente	Procedencia	Tipo / Comprobante	Capital Financiado	Plan	Total Devolución	Estado	Acciones

👥 Clientes, Procedencia de Empresa & Cupos

Clientes Registrados (0)

🔍

CUIT / DNI	Titular / Razón Social	Score	Límite Total	Deuda Activa	Disponible	Estado	Acción

Alta de Cliente (Directo o Derivado)

Nombre y Apellido / Razón Social:

CUIT / DNI (Sin guiones, solo números):

Tipo de Procedencia:

Empresa de Origen:

ID Externo en Sistema de Origen (Opcional):

Límite de Crédito ($):

Scoring / Calificación:

Estado Inicial:

⚙️ Líneas de Crédito & Tasas

Líneas de Financiación (4 Base)

Código	Nombre	Origen	Sistema	TNA	Cuotas	Gasto Adm	Estado	Acción

Configurar Nueva Línea

Nombre de la Línea:

Tipo de Crédito:

Sistema de Amortización:

TNA (%):

Gasto Adm (%):

Cuotas Permitidas (separadas por coma):

🔄 Refinanciación, Quitas & Consolidación de Deudas Límite Revolving & Rescate de Créditos

1. Diagnóstico de Cupo Revolving y Deuda Consolidada

Buscar Cliente por CUIT / DNI (Solo números) o Nombre:

O Seleccionar Cliente de la Cartera:

Límite Total Asignado

$ 0,00

Scoring: --

Deuda Viva (Capital Usado)

$ 0,00

0 créditos activos

Disponible Revolving

$ 0,00

Se libera cuota a cuota

Mora & Punitorios

$ 0,00

0 cuotas vencidas

2. Créditos Activos a Consolidar

✔	Legajo / Código	Origen	Capital Pend.	Mora Estim.	Rescate
Seleccione un cliente para ver sus créditos vigentes

3. Liquidación, Quitas & Top-Up

Quita / Bonificación en Mora (%):

%

0% = Cobra toda la mora | 100% = Condonación total de punitorios

Efectivo Adicional (Top-Up $):

Monto extra sujeto al límite disponible restante

Capital Puro Rescatado: $ 0,00

Mora Acumulada Original: $ 0,00

(-) Quita / Bonificación Concedida: - $ 0,00

(+) Punitorios Netos a Financiar: $ 0,00

(+) Efectivo Adicional Top-Up: $ 0,00

Nuevo Capital a Consolidar: $ 0,00

4. Parámetros del Nuevo Plan de Refinanciación

Línea / Sistema de Amortización:

Plazo (Cuotas):

TNA (%):

1er Vencimiento:

Observaciones / Motivo de Reestructuración:

5. Propuesta Consolidada & Emisión Listo para Simular

1ra Cuota Nueva

$ 0,00

Total a Devolver

$ 0,00

CFT / TEA

-- / --

Cuota #	Vencimiento	Capital	Interés + IVA	Total Cuota
Presione 'Simular Nuevo Plan' para proyectar el cronograma

🔌 Centro de Integración, Scripts & Conciliación ERP Uso Administrativo & Auditoría

1. Pasar / Sincronizar Clientes del ERP JSON Batch

Pega la lista de clientes a importar o actualizar con sus límites y procedencia de empresa:

2. Pasar / Conciliar Lote de Cobros del Día Conciliación

Pega los cobros recaudados en el ERP u otras empresas para imputar y cancelar cuotas:

3. Pasar / Emitir Lote de Facturas Financiadas Créditos ERP

Emite operaciones desde pedidos/facturas y obtiene los códigos de pago para imprimir:

4. Exportación & Conciliación Contable Reportes CSV

Descarga los saldos deudores actualizados y el historial de cobros para conciliar con la contabilidad de tu sistema de gestión:

📊 Cartera Activa con Saldos Deudores

Operaciones, clientes, cuotas pendientes, mora y saldo restante.

📥 CSV JSON

💰 Historial de Cobranzas Reconciliadas

Registro detallado con empresa cobradora, recibos y fechas.

📥 CSV JSON

Cliente PHP Autónomo: scripts/spcredito_client.php Listo para SP Gestión

Incluye esta clase en cualquier archivo de tu sistema de gestión (PHP nativo, sin Composer ni librerías externas) para operar créditos en tiempo real:

Ejemplo de Integración en el Proceso de Facturación (PHP)

<?php
require_once 'spcredito/scripts/spcredito_client.php';

$sp = new SpCreditoClient('http://localhost/spcredito/api');

// 1. Al emitir una Factura con financiación en tu ERP:
$resultado = $sp->emitirCreditoFactura([
    'cliente_nombre' => $factura['cliente_nombre'],
    'client_doc'     => $factura['cliente_cuit'],
    'factura'        => $factura['nro_comprobante'], // Ej: FA-0001-00049281
    'empresa'        => 'SP Gestion Central',
    'monto'          => $factura['total'],           // $150.000
    'anticipo'       => $factura['entrega_inicial'], // $0
    'cuotas'         => 6,
    'sistema'        => 'DIRECT',                    // o FRENCH, GERMAN, AMERICAN
    'tna'            => 60
]);

if ($resultado['success'] && !empty($resultado['results'][0]['payment_codes'])) {
    $cuotasGeneradas = $resultado['results'][0]['payment_codes'];
    
    // Imprimir o guardar los códigos de pago en tu comprobante:
    foreach ($cuotasGeneradas as $c) {
        echo "Cuota #" . $c['cuota_nro'] . " - Vence: " . $c['vencimiento'] . 
             " - Código: " . $c['codigo_pago'] . " - Importe: $" . $c['importe'] . "\n";
    }
}
?>

Cobro en Caja del ERP y Conciliación Nocturna (PHP)

<?php
require_once 'spcredito/scripts/spcredito_client.php';
$sp = new SpCreditoClient('http://localhost/spcredito/api');

// A. Cobro individual por código en el módulo de Caja:
$consulta = $sp->consultarCuota('PAY-4613-01');
if ($consulta['found']) {
    $totalACobrar = $consulta['total_payable']; // Incluye punitorios si está vencida
    $pago = $sp->registrarCobro('PAY-4613-01', $totalACobrar, 'REC-00124', 'Caja Sucursal 1');
}

// B. Conciliación masiva de cobros al cierre del día:
$loteCobros = [
    ['codigo_pago' => 'PAY-4613-01', 'monto' => 57562.50, 'recibo' => 'REC-01', 'empresa' => 'SP Gestion'],
    ['codigo_pago' => 'PAY-4613-02', 'monto' => 57562.50, 'recibo' => 'REC-02', 'empresa' => 'SP Gestion']
];
$conciliacion = $sp->conciliarCobros($loteCobros);
echo "Conciliados: " . $conciliacion['reconciled'] . " de " . $conciliacion['total_received'];
?>

Puente de Base de Datos PHP 8 + PDO con Parámetros Nombrados: scripts/spcredito_pdo_bridge.php PHP 8 Nativo PDO

Integra directamente tu base de datos relacional (MySQL, MariaDB, PostgreSQL o SQLite) con spcredito usando consultas preparadas y parámetros nombrados (:param_name) sin dependencias externas:

1. Inicialización del Puente PDO en PHP 8

<?php
declare(strict_types=1);

require_once 'spcredito/scripts/spcredito_pdo_bridge.php';

// Conexión PDO a la base de datos de SP Gestión o ERP
$pdo = new PDO(
    'mysql:host=localhost;dbname=spgestion;charset=utf8mb4',
    'root',
    '',
    [
        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES   => false,
    ]
);

// Instanciar el puente con la URL del motor spcredito y la empresa
$bridge = new SpCreditoPdoBridge(
    pdo: $pdo,
    spApiUrl: 'http://localhost/spcredito/api',
    empresaNombre: 'SP Gestion Central'
);
?>

2. Pasar Clientes del ERP con Parámetros Nombrados

<?php
// Ejecuta consulta con parámetros nombrados:
// SELECT ... WHERE estado = :estado_activo AND empresa_origen = :empresa_nombre
$resultadoClientes = $bridge->sincronizarClientesDesdeErp(limiteDefault: 500000);

echo "Sincronizados: " . ($resultadoClientes['synchronized'] ?? 0) . " clientes.\n";
?>

3. Emitir Financiación de Factura & Grabar Códigos de Pago en el ERP

<?php
// 1. Lee la factura ID con: WHERE f.id = :factura_id AND f.estado = :estado_factura
// 2. Emite el crédito en spcredito
// 3. Actualiza el ERP con: UPDATE facturas SET sp_operacion_codigo = :op_codigo, sp_cuotas_json = :cuotas_json WHERE id = :factura_id
$facturaId = 1045; // ID interno de la factura en el ERP
$resCredito = $bridge->emitirFinanciacionFacturaErp(
    facturaId: $facturaId,
    cuotas: 6,
    sistema: 'DIRECT',
    tna: 60.0
);

if ($resCredito['success']) {
    echo "Crédito emitido: Operación " . $resCredito['results'][0]['operation_code'] . "\n";
    foreach ($resCredito['results'][0]['payment_codes'] as $c) {
        echo "Cuota #" . $c['cuota_nro'] . ": Código " . $c['codigo_pago'] . " por $" . $c['importe'] . "\n";
    }
}
?>

4. Conciliar Cobros de Caja del ERP hacia spcredito

<?php
// Lee cobros de caja pendientes con:
// WHERE fecha_cobro BETWEEN :fecha_desde AND :fecha_hasta AND tipo_operacion = :tipo_op AND estado_conciliado = :estado_no_conciliado
// Concilia en spcredito y actualiza caja_cobros con: SET estado_conciliado = :estado_conciliado, fecha_conciliacion = :fecha_ahora WHERE codigo_pago = :codigo_pago
$resConciliacion = $bridge->conciliarCobrosCajaErp(
    fechaDesde: date('Y-m-d'),
    fechaHasta: date('Y-m-d')
);

echo "Cobros conciliados: " . ($resConciliacion['reconciled'] ?? 0) . " por $" . ($resConciliacion['total_amount_reconciled'] ?? 0) . "\n";
?>

Automatización por Línea de Comandos (CLI) en PHP 8: scripts/sync_cli.php CLI & Cron PHP 8

Scripts autónomos ejecutables directamente desde la consola o programador de tareas (cron / Windows Task Scheduler) en PHP 8:

Comandos Disponibles:

# Exportar cartera activa con saldos a CSV: php scripts/sync_cli.php --action=export-cartera --format=csv # Exportar cobranzas del período a CSV: php scripts/sync_cli.php --action=export-cobranzas --format=csv # Sincronizar clientes desde archivo JSON: php scripts/sync_cli.php --action=sync-clientes --file=c:\datos\clientes_erp.json # Conciliar cobros del día desde archivo JSON: php scripts/sync_cli.php --action=sync-cobros --file=c:\datos\cobros_cierre.json

Automatización en Tareas Programadas / Crontab:

# Crontab Linux / Servidor (cierre nocturno a las 23:55): 55 23 * * * /usr/bin/php /var/www/spcredito/scripts/sync_cli.php --action=export-cobranzas --format=csv # Programador de Tareas Windows (CMD / PowerShell): php.exe c:\Ampps\www\spcredito\scripts\sync_cli.php --action=export-cartera --format=csv

Especificación Completa de Endpoints REST

Método	Endpoint	Acción / Parámetros	Descripción
POST	`/api/integracion.php`	`action=sync_clientes, clients:[...]`	Importa / actualiza clientes, límites y procedencias en lote.
POST	`/api/integracion.php`	`action=sync_cobros, payments:[...]`	Concilia lote de cobros, imputa mora y cancela cuotas.
POST	`/api/integracion.php`	`action=sync_pedidos, orders:[...]`	Emite créditos en lote y devuelve códigos `PAY-XXXX-XX`.
GET	`/api/integracion.php?action=export_cartera&format=csv`	`action=export_cartera`	Descarga la cartera con saldos deudores en CSV o JSON.
GET	`/api/cobrar.php?codigo_pago=PAY-XXXX-XX`	`codigo_pago`	Consulta cuota, saldo con mora y estado desde cualquier empresa.
POST	`/api/cobrar.php`	`codigo_pago, amount, receipt_number, collecting_company`	Registra cobro individual en caja.

Widget Embebible JavaScript para Puntos de Venta y Facturadores Web

<script src="http://localhost/spcredito/widget/spcredito-widget.js"></script>  <div id="mi-simulador-credito"></div>  <script> SpCreditoWidget.renderInline('mi-simulador-credito', { amount: 150000, originCompany: 'SP Gestion', terms: [3, 6, 12], system: 'DIRECT', onSelect: function(plan) { console.log('Plan seleccionado por el vendedor:', plan); } }); </script>

👉 Abrir Demo del Widget en Ventana Nueva

Comandos Disponibles:

Automatización en Tareas Programadas / Crontab:

Cronograma de Cuotas

Registrar Cobro de Cuota