Skip to content

docs: Translated and added extra documentation #1869

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
abdedarghal111 wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs: Translated and added extra documentation #1869

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions Core/Lib/Accounting/AccountingClass.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
use FacturaScripts\Dinamic\Model\Subcuenta;

/**
* Base class for creation of accounting processes
* Clase base para la generación de asientos contables
*
* @author Jose Antonio Cuello Principal <yopli2000@gmail.com>
* @author Carlos García Gómez <carlos@facturascripts.com>
Expand All @@ -37,7 +37,7 @@ abstract class AccountingClass extends AccountingAccounts
protected $document;

/**
* Method to launch the accounting process
* Genera los asientos contables para una factura.
*
* @param ModelClass $model
*/
Expand All @@ -48,7 +48,7 @@ public function generate($model)
}

/**
* Add a standard line to the accounting entry based on the reported sub-account
* Añade una línea básica al asiento contable en base a la subcuenta reportada
*
* @param Asiento $accountEntry
* @param Subcuenta $subaccount
Expand All @@ -63,7 +63,7 @@ protected function addBasicLine($accountEntry, $subaccount, $isDebit, $amount =
}

/**
* Add a group of lines from array of subaccounts/amount.
* Añade un grupo de líneas desde un array de subcuentas/importes.
*
* @param Asiento $accountEntry
* @param array $totals
Expand Down Expand Up @@ -99,8 +99,8 @@ protected function addLinesFromTotals($accountEntry, $totals, $isDebit, $counter
}

/**
* Add a line of taxes to the accounting entry based on the sub-account
* and values reported
* Añade una línea de impuestos al asiento contable en base a la subcuenta
* y valores informados
*
* @param Asiento $accountEntry
* @param Subcuenta $subaccount
Expand All @@ -116,15 +116,15 @@ protected function addSurchargeLine($accountEntry, $subaccount, $counterpart, $i
return true;
}

// add basic data
// añadir datos básicos
$line = $this->getBasicLine($accountEntry, $subaccount, $isDebit, $values['totalrecargo']);

// counterpart?
if (!empty($counterpart)) {
$line->setCounterpart($counterpart);
}

// add tax register data
// añadir datos de registro de impuestos
$line->baseimponible = (float)$values['neto'];
$line->iva = 0;
$line->recargo = (float)$values['recargo'];
Expand All @@ -138,8 +138,8 @@ protected function addSurchargeLine($accountEntry, $subaccount, $counterpart, $i
}

/**
* Add a line of taxes to the accounting entry based on the sub-account
* and values reported
* Añade una línea de impuestos al asiento contable en base a la subcuenta
* y valores informados
*
* @param Asiento $accountEntry
* @param Subcuenta $subaccount
Expand All @@ -151,15 +151,15 @@ protected function addSurchargeLine($accountEntry, $subaccount, $counterpart, $i
*/
protected function addTaxLine($accountEntry, $subaccount, $counterpart, $isDebit, $values): bool
{
// add basic data
// obtener una linea
$line = $this->getBasicLine($accountEntry, $subaccount, $isDebit, $values['totaliva']);

// counterpart?
if (!empty($counterpart)) {
$line->setCounterpart($counterpart);
}

// add tax register data
// añadir datos de registro de impuestos
$line->baseimponible = (float)$values['neto'];
$line->iva = (float)$values['iva'];
$line->recargo = 0;
Expand All @@ -173,7 +173,7 @@ protected function addTaxLine($accountEntry, $subaccount, $counterpart, $isDebit
}

/**
* Obtain a standard line to the accounting entry based on the reported sub-account
* Devuelve una línea estándar para el asiento contable en base a la subcuenta reportada
*
* @param Asiento $accountEntry
* @param Subcuenta $subaccount
Expand Down
80 changes: 61 additions & 19 deletions Core/Lib/Accounting/InvoiceToAccounting.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,8 @@
use FacturaScripts\Dinamic\Model\Subcuenta;

/**
* Class for the generation of accounting entries of a sale/purchase document
* and the settlement of your receipts.
* Clase para la generación de asientos contables de un documento de venta/compra
* y la liquidación de sus recibos.
*
* @author Carlos García Gómez <carlos@facturascripts.com>
* @author Jose Antonio Cuello Principal <yopli2000@gmail.com>
Expand All @@ -58,14 +58,14 @@ class InvoiceToAccounting extends AccountingClass
protected $document;

/**
* Document Subtotals Lines array
* Array de subtotales del documento
*
* @var array
*/
protected $subtotals;

/**
* Method to launch the accounting process
* Genera los asientos contables para una factura.
*
* @param FacturaCliente|FacturaProveedor $model
*/
Expand All @@ -88,8 +88,8 @@ public function generate($model)
}

/**
* Add the customer line to the accounting entry
*
* Añade la línea de cliente al asiento contable
*
* @param Asiento $entry
*
* @return bool
Expand All @@ -115,8 +115,8 @@ protected function addCustomerLine(Asiento $entry): bool
}

/**
* Add the goods purchase line to the accounting entry.
* Make one line for each product/family purchase subaccount.
* Añade la línea de compras de mercancías al asiento contable.
* Hace una línea por cada subcuenta de compras de producto/familia.
*
* @param Asiento $entry
*
Expand All @@ -141,8 +141,8 @@ protected function addGoodsPurchaseLine(Asiento $entry): bool
}

/**
* Add the goods sales line to the accounting entry.
* Make one line for each product/family sale subaccount.
* Añade la línea de venta de mercaderías al asiento contable.
* Crea una línea por cada subcuenta de venta de producto/familia.
*
* @param Asiento $entry
*
Expand All @@ -167,6 +167,8 @@ protected function addGoodsSalesLine(Asiento $entry): bool
}

/**
* Añade las líneas de IRPF de compras.
*
* @param Asiento $entry
*
* @return bool
Expand Down Expand Up @@ -202,6 +204,8 @@ protected function addPurchaseIrpfLines(Asiento $entry): bool
}

/**
* Añade las lineas de suplidos de compras
*
* @param Asiento $entry
*
* @return bool
Expand All @@ -222,7 +226,7 @@ protected function addPurchaseSuppliedLines(Asiento $entry): bool
}

/**
* Add the purchase line to the accounting entry
* Añade las líneas de IVA de compras.
*
* @param Asiento $entry
*
Expand Down Expand Up @@ -281,6 +285,8 @@ protected function addPurchaseTaxLines(Asiento $entry): bool
}

/**
* Añade las líneas de IRPF de ventas.
*
* @param Asiento $entry
*
* @return bool
Expand Down Expand Up @@ -309,7 +315,7 @@ protected function addSalesIrpfLines(Asiento $entry): bool
}

/**
* Add the supplied line to the accounting entry
* Añade la línea de suplidos al asiento contable
*
* @param Asiento $entry
*
Expand All @@ -331,7 +337,7 @@ protected function addSalesSuppliedLines(Asiento $entry): bool
}

/**
* Add the sales line to the accounting entry
* Añade las líneas de IVA de ventas.
*
* @param Asiento $entry
*
Expand Down Expand Up @@ -387,6 +393,8 @@ protected function addSalesTaxLines(Asiento $entry): bool
}

/**
* Añade la línea de proveedor al asiento contable
*
* @param Asiento $entry
*
* @return bool
Expand All @@ -412,9 +420,17 @@ protected function addSupplierLine(Asiento $entry): bool
}

/**
* Perform the initial checks to continue with the accounting process
*
* @return bool
* Realiza las comprobaciones iniciales para asegurar que se puede generar el asiento.
*
* Comprueba que:
* - el documento no tenga ya un asiento asociado
* - el documento tenga un total válido
* - el ejercicio exista y esté abierto
* - el ejercicio tenga un plan contable
* - el documento tenga subtotales
* - el ejercicio esté asignado almenos a una cuenta

* @return bool Devuelve false si no se puede generar el asiento.
*/
protected function initialChecks(): bool
{
Expand Down Expand Up @@ -459,7 +475,17 @@ protected function loadSubtotals(): bool
}

/**
* Generate the accounting entry for a purchase document.
* Genera el asiento contable para un documento de compra.
*
* Crea el asiento y realiza varias comprobaciones:
* - Verifica que se pueda añadir la línea de proveedor.
* - Verifica que se pueda añadir las líneas de iva de compras.
* - Verifica que se pueda añadir las líneas de irpf de compras.
* - Verifica que se pueda añadir la línea suplidos de compras.
* - Verifica que se pueda añadir la linea de mercancías de compras.
* - Verifica que el asiento esté balanceado.
*
* Si alguna de las comprobaciones falla, no se asigna el asiento y se muestra un mensaje de error.
*/
protected function purchaseAccountingEntry(): void
{
Expand Down Expand Up @@ -528,7 +554,19 @@ protected function purchaseAccountingEntry(): void
}

/**
* Generate the accounting entry for a sales document.
* Genera el asiento contable para un documento de venta.
*
* Crea el asiento y realiza varias comprobaciones:
* - Verifica que se pueda añadir la línea de cliente.
* - Verifica que se pueda añadir las líneas de iva de ventas.
* - Verifica que se pueda añadir las líneas de irpf de ventas.
* - Verifica que se pueda añadir la línea suplidos.
* - Verifica que se pueda añadir la linea de mercancías de ventas.
* - Verifica que el asiento esté balanceado.
*
* Si alguna de las comprobaciones falla, no se asigna el asiento y se muestra un mensaje de error.
*
* @return void
*/
protected function salesAccountingEntry(): void
{
Expand Down Expand Up @@ -597,7 +635,11 @@ protected function salesAccountingEntry(): void
}

/**
* Assign the document data to the accounting entry
* Asigna al asiento $entry los datos básicos del documento.
*
* Codejercicio, concepto, documento, fecha, idempresa, importe
*
* Además, asigna los datos analíticos definidos en el modelo Serie
*
* @param Asiento $entry
* @param string $concept
Expand Down
Loading
Loading