Files
opensourcepos/app/Language/es-ES/Sales.php
objecttothis 9c542efaf6 Feature: Payment reference code (#4587)
* Add `reference_code` to sale payment queries and group by statements

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Refactor `Sales` controller to improve payment handling readability and replace snake_case with camelCase variables

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Add missing translations for `Sales` language file and include new keys like `must_enter_rrn` and `reference_code`

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Refactor `Sales` payment handling to use camelCase and extend `addPayment` with `referenceCode` support

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Refactor `Sales` models, controllers, and libraries to adopt camelCase naming conventions and improve readability

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Add translations and updates for `must_enter_reference_code` and `reference_code` across language files and update `Sales` controller to replace `must_enter_rrn` with the new key

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* feat(sales): add reference code input and payment type helper

- Add `get_reference_code_payment_types()` to locale_helper as single
  source of truth for card-requiring payment types
- Add reference code row to register view, shown/hidden via JS based
  on selected payment type
- Fix payment type dropdown width to 100% for consistent layout
- Add min-width to payment buttons and right-padding to button group

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* feat(config): add payment reference code length configuration

- Add payment_reference_code_min and payment_reference_code_max fields
  to Config controller save logic
- Add translation keys for reference code length limits across all
  language files (min/max label + section header)
- Align array key formatting in Config controller for readability

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* style(lang): normalize string delimiters to single quotes across all language files

Convert double-quoted array keys and values to single quotes in all
app/Language/*/Config.php and app/Language/*/Sales.php variants.
No translation content changed — formatting only.

Also add Localization section to AGENTS.md documenting language file
conventions for new keys and fallback behavior.

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* feat(lang): add payment reference code length translations

Add localized strings for payment_reference_code_length_limits,
payment_reference_code_length_max_label, and
payment_reference_code_length_min_label across all supported locales.

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* test(config,sales): add payment reference code min/max validation tests

- Add baseLocalePayload() helper in ConfigTest for postSaveLocale tests
- Add testSaveLocale_AcceptsValidReferenceCodeMinMax and related boundary tests
- Add Sale_libPaymentTest for payment reference code validation in Sale_lib

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* fix(sales): add type-specific validation for amount_tendered

Gift card payments use amount_tendered as giftcard number (integer);
cash/other payments require decimal_locale format. Apply correct
validation rule per payment type instead of generic required.

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* fix(lang): replace self-closing </br> with <br> in all locales

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* fix(sales): use configurable precision in discount comparison

Replace hardcoded precision 2 with totals_decimals() when comparing
discount against item total via bccomp/bcmul, so discount validation
respects the configured decimal precision setting.

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* fix(lang): correct Azerbaijani translations in Config.php

Replace placeholder/mismatched strings with accurate translations:
- email_mailpath, email_smtp_pass, invoice_email_message
- number_locale_invalid/required, receipt_template
- reward_configuration, right, tax_decimals, theme

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* feat(sales): add reference code support to payment edit flow

- Add reference_code field to new payment row in sale edit form
- Persist reference_code on insert in Sale model
- Validate reference_code_new in Sales controller using configurable min/max length rules

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* feat(lang): add Georgian (ka) language stubs for Config and Sales

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Match the fallback maximum reference_code length to the maximum of the field in the db

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

* Bug fixes

- Add validation of UI settings to prevent overridden values from being passed.
- Correct maximum value in JS for payment_reference_code maximum length to 40.
- Fix bug causing copy_entire_sale() to incorrectly copy the reference code and cash_adjustment

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>

---------

Signed-off-by: Travis Garrison <travis@chiraqbookstore.com>
Co-authored-by: Travis Garrison <travis@chiraqbookstore.com>
2026-07-10 13:49:05 +04:00

239 lines
15 KiB
PHP

<?php
return [
'account_number' => 'Cuenta #',
'add_payment' => 'Agregar Pago',
'amount_due' => 'Monto Adeudado',
'amount_tendered' => 'Cantidad Recibida',
'authorized_signature' => 'Firma Autorizada',
'bank_transfer' => 'Transferencia Bancaria',
'cancel_sale' => 'Cancelar Venta',
'cash' => 'Efectivo',
'cash_1' => '1',
'cash_2' => '5',
'cash_3' => '10',
'cash_4' => '20',
'cash_adjustment' => 'Ajuste de Efectivo',
'cash_deposit' => 'Deposito Efectivo',
'cash_filter' => 'Efectivo',
'change_due' => 'Cambio',
'change_price' => 'Cambiar el precio de venta',
'check' => 'Cheque',
'check_balance' => 'Balance de Cheque',
'check_filter' => 'Cheque',
'close' => 'Cerrar Lista',
'comment' => 'Comentario',
'comments' => 'Comentarios',
'company_name' => 'Nombre de Comañía',
'complete' => 'Completa',
'complete_sale' => 'Completar Venta',
'confirm_cancel_sale' => '¿Seguro quiere cancelar esta venta? Todos los artículos serán eliminados.',
'confirm_delete' => '¿Seguro quiere borrar las ventas seleccionadas?',
'confirm_restore' => 'Esta seguro de querer restaurar la(s) venta(s) seleccionada(s)?',
'credit' => 'Tarjeta de Crédito',
'credit_deposit' => 'Deposito Credito',
'credit_filter' => 'Tarjeta de Crédito',
'current_table' => 'Tabla Actual',
'customer' => 'cliente',
'customer_address' => 'Direccion',
'customer_discount' => 'Descuento',
'customer_email' => 'Email',
'customer_location' => 'Ubicacion',
'customer_mailchimp_status' => 'Estado de Mailchimp',
'customer_optional' => '(Obligatorio para Pagos Vencidos)',
'customer_required' => '(Requerido)',
'customer_total' => 'Total',
'customer_total_spent' => 'Total Gastado',
'customers_available_points' => 'Puntos Disponibles',
'daily_sales' => 'Sus Ventas Diarias',
'date' => 'Fecha',
'date_range' => 'Rango de Fecha',
'date_required' => 'Una fecha correcta debe ser ingresada.',
'date_type' => 'Campo de Fecha es requerido.',
'debit' => 'Tarjeta de Débito',
'debit_filter' => 'Tarjeta de Débito',
'delete' => 'Permitir borrar',
'delete_confirmation' => '¿Seguro quiere borrar esta venta? Esta acción no se puede deshacer.',
'delete_entire_sale' => 'Borrar la venta completa',
'delete_successful' => 'Venta borrada correctamente.',
'delete_unsuccessful' => 'Venta no borrada, fallida.',
'description_abbrv' => 'Descrp.',
'discard' => 'Descartar',
'discard_quote' => 'Descartar',
'discount' => 'Descuento',
'discount_exceeds_item_total' => '',
'discount_included' => '% Descuento',
'discount_percent_exceeds_100' => '',
'discount_short' => '%',
'due' => 'Adeudado',
'due_filter' => 'Adeudado',
'edit' => 'Editar',
'edit_item' => 'Editar Artículo',
'edit_sale' => 'Editar Venta',
'email_receipt' => 'Enviar Ticket',
'employee' => 'Empleado',
'entry' => 'Entrada',
'error_editing_item' => 'Error editando artículo',
'find_or_scan_item' => 'Encontrar/Escanear Artículo',
'find_or_scan_item_or_receipt' => 'Encontrar/Escanear Artículo o Entrada',
'giftcard' => 'Tarjeta de Regalo',
'giftcard_balance' => 'Balance de Tarjeta de Regalo',
'giftcard_filter' => 'Tarjeta de Regalo',
'giftcard_number' => 'Número de Tarjeta de Regalo',
'group_by_category' => 'Grupo por Categoría',
'group_by_type' => 'Grupo por Tipo',
'hsn' => 'HSN',
'id' => 'ID de Venta',
'include_prices' => 'Incluir precios?',
'invoice' => 'Factura de venta',
'invoice_confirm' => 'Esta factura sera enviada a',
'invoice_enable' => 'Número de Factura',
'invoice_filter' => 'Facturas',
'invoice_no_email' => 'Este cliente no tiene un email válido.',
'invoice_number' => 'Factura #',
'invoice_number_duplicate' => 'Por favor ingrese un número de factura único.',
'invoice_sent' => 'Factura enviada a',
'invoice_total' => 'Total Facturado',
'invoice_type_custom_invoice' => 'Factura Personalizada',
'invoice_type_custom_tax_invoice' => 'Factura de Impuesto personalizada',
'invoice_type_invoice' => 'Factura',
'invoice_type_tax_invoice' => 'Factura de Impuestos',
'invoice_unsent' => 'Fallo el envio de la factura a',
'invoice_update' => 'Actualizar',
'item_insufficient_of_stock' => 'Cantidad insuficiente en existencia.',
'item_name' => 'Nombre del Artículo',
'item_number' => 'UPC/EAN/ISBN',
'item_out_of_stock' => 'El artículo está agotado.',
'key_browser' => 'Atajos Útiles',
'key_cancel' => 'Cancelar actual Cotización/Factura/Venta',
'key_customer_search' => 'Búsqueda de Clientes',
'key_finish_quote' => 'Finish Quote/Invoice witdout payment',
'key_finish_sale' => 'Agregar Pago y Completar Factura/Venta',
'key_full' => 'Abrir en Pantalla Completa',
'key_function' => 'Function',
'key_help' => 'Atajos',
'key_help_modal' => 'Abrir Ventana de Atajos',
'key_in' => 'Acercar',
'key_item_search' => 'Buscar Artículo',
'key_out' => 'Alejar',
'key_payment' => 'Agregar Pago',
'key_print' => 'Imprimir Página Actual',
'key_restore' => 'Restaurar Pantalla/Zoom Original',
'key_search' => 'Buscar Tablas de Reportes',
'key_suspend' => 'Suspender Venta Actual',
'key_suspended' => 'Mostrar Ventas Suspendidas',
'key_system' => 'Atajos del Sistema',
'key_tendered' => 'Editar Importe Licitado',
'key_title' => 'Atajas de Teclado para Ventas',
'mc' => 'Tarjeta Master Card',
'mode' => 'Modo',
'must_enter_numeric' => 'Cantidad Recibida debe ser número.',
'must_enter_numeric_giftcard' => 'Número de Tarjeta de Regalo debe ser número.',
'must_enter_reference_code' => 'Se debe ingresar el número de referencia/recuperación.',
'negative_discount_invalid' => '',
'negative_price_invalid' => '',
'negative_quantity_invalid' => '',
'negative_total_invalid' => '',
'new_customer' => 'Cliente Nuevo',
'new_item' => 'Artículo Nuevo',
'no_description' => 'Ninguno',
'no_filter' => 'Todos',
'no_items_in_cart' => 'No hay artículos en el carrito.',
'no_sales_to_display' => 'No hay ventas que mostrar.',
'none_selected' => 'No has seleccionado venta para borrar.',
'nontaxed_ind' => ' Ventas no gravadas ',
'not_authorized' => 'Esta accion no esta autorizada.',
'one_or_multiple' => 'venta(s)',
'payment' => 'Tipo de Pago',
'payment_amount' => 'Cantidad',
'payment_not_cover_total' => 'La Cantidad Recibida no cubre el pago total.',
'payment_type' => 'Tipo',
'payments' => 'Pagos',
'payments_total' => 'Pagado',
'price' => 'Precio',
'print_after_sale' => 'Imprimir recibo después de una venta',
'quantity' => 'Cantidad',
'quantity_less_than_reorder_level' => 'Advertencia. La cantidad deseada es insuficiente.',
'quantity_less_than_zero' => 'Advertencia. La cantidad deseada no tiene stock suficiente. Puedes procesar la venta pero revisa tu inventario.',
'quantity_of_items' => 'Cantidad de {0} articulos',
'quote' => 'Cotizar',
'quote_number' => 'Número de Presupuesto',
'quote_number_duplicate' => 'Cotizacion debe ser unico.',
'quote_sent' => 'Cotizacion enviada a',
'quote_unsent' => 'Cotización no se pudo enviar',
'receipt' => 'Recibo de Venta',
'receipt_no_email' => 'Este cliente no tiene una dirección de correo valido.',
'receipt_number' => 'Venta #',
'receipt_sent' => 'Recibo enviada a',
'receipt_unsent' => 'Fallo el envio del recibo a',
'reference_code' => 'Código de referencia de pago',
'reference_code_invalid_characters' => 'El código de referencia solo debe contener letras y números.',
'reference_code_length_error' => 'La longitud del código de referencia no es válida.',
'refund' => 'Tipo de reembolso',
'register' => 'Registro de Ventas',
'remove_customer' => 'Borrar Cliente',
'remove_discount' => 'Descuentos',
'return' => 'Devolución',
'rewards' => 'Puntos',
'rewards_balance' => 'Balance de puntos',
'rewards_package' => 'Paquete de recompensas',
'rewards_remaining_balance' => 'El remanente de puntos es ',
'sale' => 'Venta',
'sale_by_invoice' => 'Venta por factura',
'sale_for_customer' => 'Cliente:',
'sale_time' => 'Hora',
'sales_tax' => 'Impuesto',
'sales_total' => 'Ventas Totales',
'select_customer' => 'Seleccionar Cliente',
'selected_customer' => 'Cliente seleccionado',
'send_invoice' => 'Enviar Factura',
'send_quote' => 'Enviar Cotización',
'send_receipt' => 'Enviar Recibo',
'send_work_order' => 'Enviar Orden de Trabajo',
'serial' => 'Serie',
'service_charge' => 'Costo de Servicio',
'show_due' => 'Mostrar los Importes Adeudados',
'show_invoice' => 'Factura',
'show_receipt' => 'Recibo',
'start_typing_customer_name' => 'Empieza a escribir el cliente...',
'start_typing_item_name' => 'Empieza a escribir o escanea el código de barras...',
'stock' => 'Inventario',
'stock_location' => 'Localizacion',
'sub_total' => 'SubTotal',
'successfully_deleted' => 'Borrada satisfactoriamente',
'successfully_restored' => 'Restaurado satisfactoriamente',
'successfully_suspended_sale' => 'La venta ha sido suspendida.',
'successfully_updated' => 'La venta ha sido actualizada.',
'suspend_sale' => 'Suspender',
'suspended_doc_id' => 'Documento',
'suspended_sale_id' => 'Id',
'suspended_sales' => 'Suspendidas',
'table' => 'Datos',
'takings' => 'Ventas Diarias',
'tax' => 'Imp',
'tax_id' => 'Identificador del Impuesto',
'tax_invoice' => 'Impuesto de la Factura',
'tax_percent' => '% de Imp',
'taxed_ind' => 'Ventas gravadas',
'total' => 'Total',
'total_tax_exclusive' => 'Sin impuesto',
'transaction_failed' => 'La transacción de venta falló.',
'unable_to_add_item' => 'Error al agregar artículo a la venta',
'unsuccessfully_deleted' => 'Ha fallado la eliminación de la Venta.',
'unsuccessfully_restored' => 'Restaurar Venta fallida.',
'unsuccessfully_suspended_sale' => 'Venta suspendida satisfactoriamente.',
'unsuccessfully_updated' => 'Ha fallado la actualización de la venta.',
'unsuspend' => 'Retomar',
'unsuspend_and_delete' => 'Retomar y Borrar',
'update' => 'Editar',
'upi' => 'PIN UPI',
'visa' => 'Tarjeta Visa',
'wallet' => 'Monedero',
'wholesale' => 'Precio al por mayor',
'work_order' => 'Orden trabajo',
'work_order_number' => 'Numero Orden Trabajo',
'work_order_number_duplicate' => 'El numero de orden de trabajo debe ser unico.',
'work_order_sent' => 'Orden de trabajo enviada a',
'work_order_unsent' => 'Orden de trabajo fallida al enviar a',
];