dolibarr 21.0.0-beta
salary.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2011-2022 Alexandre Spangaro <aspangaro@open-dsi.fr>
3 * Copyright (C) 2014 Juanjo Menent <jmenent@2byte.es>
4 * Copyright (C) 2021 Gauthier VERDOL <gauthier.verdol@atm-consulting.fr>
5 * Copyright (C) 2024 Frédéric France <frederic.france@free.fr>
6 * Copyright (C) 2024 MDW <mdeweerd@users.noreply.github.com>
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 3 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <https://www.gnu.org/licenses/>.
20 */
21
28// Put here all includes required by your class file
29require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';
30
31
35class Salary extends CommonObject
36{
40 public $element = 'salary';
41
45 public $table_element = 'salary';
46
50 public $picto = 'salary';
51
55 protected $childtables = array('payment_salary' => array('name' => 'SalaryPayment', 'fk_element' => 'fk_salary'));
56
57 // /**
58 // * @var array List of child tables. To know object to delete on cascade.
59 // * If name matches '@ClassNAme:FilePathClass;ParentFkFieldName' it will
60 // * call method deleteByParentField(parentId, ParentFkFieldName) to fetch and delete child object
61 // */
62 //protected $childtablesoncascade = array('mymodule_myobjectdet');
63
64
68 public $fk_user;
69
73 public $datep;
77 public $datev;
78
82 public $salary;
86 public $amount;
87
91 public $fk_project;
92
96 public $type_payment; // TODO Rename into type_payment_id
100 public $type_payment_code;
101
105 public $label;
106
110 public $datesp;
114 public $dateep;
115
119 public $fk_bank;
120
126 public $fk_account;
127
131 public $accountid;
132
136 public $fk_user_author;
137
141 public $fk_user_modif;
142
146 public $user;
147
152 public $paye;
153
154 const STATUS_UNPAID = 0;
155 const STATUS_PAID = 1;
156
160 public $resteapayer;
161
162 public $fields = array(
163 'rowid' => array('type' => 'integer', 'label' => 'TechnicalID', 'enabled' => 1, 'visible' => 0, 'notnull' => 1, 'index' => 1, 'position' => 1, 'comment' => 'Id'),
164 'ref' => array('type' => 'varchar(128)', 'label' => 'Ref', 'enabled' => 1, 'position' => 10, 'visible' => 1, 'index' => 1, 'comment' => "Reference of object"),
165 'label' => array('type' => 'varchar(255)', 'label' => 'Label', 'enabled' => 1, 'position' => 12, 'notnull' => 0, 'visible' => 1),
166 'datec' => array('type' => 'datetime', 'label' => 'DateCreation', 'enabled' => 1, 'visible' => 0, 'position' => 30),
167 'datep' => array('type' => 'date', 'label' => 'Date', 'enabled' => 1, 'visible' => 0, 'position' => 40, 'comment' => 'Date'),
168 'datev' => array('type' => 'date', 'label' => 'Date', 'enabled' => 1, 'visible' => 0, 'position' => 50, 'comment' => 'Date'),
169 'fk_user' => array('type' => 'integer:User:user/class/user.class.php', 'label' => 'Employee', 'enabled' => 1, 'position' => 15, 'notnull' => 1, 'visible' => 1, 'picto' => 'user'),
170 'tms' => array('type' => 'timestamp', 'label' => 'DateModification', 'enabled' => 1, 'visible' => 0, 'notnull' => 1, 'position' => 20),
171 'salary' => array('type' => 'double(24,8)', 'label' => 'salary', 'enabled' => 1, 'visible' => 0, 'position' => 70),
172 'amount' => array('type' => 'double(24,8)', 'label' => 'Amount', 'enabled' => 1, 'visible' => 1, 'notnull' => 1, 'position' => 80),
173 'fk_projet' => array('type' => 'integer:Project:projet/class/project.class.php:1:(fk_statut:=:1)', 'label' => 'Project', 'enabled' => "isModEnabled('project')", 'visible' => 0, 'position' => 90),
174 'fk_typepayment' => array('type' => 'typepayment', 'label' => 'DefaultPaymentMode', 'enabled' => 1, 'visible' => 1, 'position' => 100, 'comment' => 'Payment type'),
175 'num_payment' => array('type' => 'string', 'label' => 'Reference', 'enabled' => 1, 'visible' => 0, 'position' => 110, 'comment' => 'Reference'),
176 'datesp' => array('type' => 'date', 'label' => 'DateStart', 'enabled' => 1, 'visible' => 1, 'position' => 130, 'comment' => 'Date'),
177 'dateep' => array('type' => 'date', 'label' => 'DateEnd', 'enabled' => 1, 'visible' => 1, 'position' => 140, 'comment' => 'Date'),
178 'entity' => array('type' => 'integer', 'label' => 'Entity', 'default' => '1', 'enabled' => 1, 'visible' => 0, 'position' => 150, 'index' => 1),
179 'note' => array('type' => 'text', 'label' => 'Note', 'enabled' => 1, 'position' => 160, 'visible' => 0,),
180 'fk_bank' => array('type' => 'integer', 'label' => 'BankId', 'enabled' => 1, 'visible' => 0, 'position' => 170),
181 'paye' => array('type' => 'smallint(6)', 'label' => 'Status', 'enabled' => 1, 'visible' => 1, 'notnull' => 1, 'position' => 180),
182 'fk_user_author' => array('type' => 'integer:User:user/class/user.class.php', 'label' => 'UserAuthor', 'enabled' => 1, 'visible' => 0, 'position' => 190),
183 'fk_user_modif' => array('type' => 'integer:User:user/class/user.class.php', 'label' => 'UserModif', 'enabled' => 1, 'position' => 200, 'visible' => 0,),
184 'ref_ext' => array('type' => 'varchar(128)', 'label' => 'Ref ext', 'enabled' => 1, 'visible' => 0, 'position' => 210),
185 'note_public' => array('type' => 'text', 'label' => 'NotePublic', 'enabled' => 1, 'visible' => 0, 'position' => 220),
186 );
187
188
194 public function __construct($db)
195 {
196 $this->db = $db;
197 $this->element = 'salary';
198 $this->table_element = 'salary';
199 }
200
208 public function update($user = null, $notrigger = 0)
209 {
210 $error = 0;
211
212 // Clean parameters
213 $this->amount = trim($this->amount);
214 $this->label = trim($this->label);
215 $this->note = trim($this->note);
216 $this->note_private = trim($this->note_private);
217 $this->note_public = trim($this->note_public);
218
219 // Check parameters
220 if (empty($this->fk_user) || $this->fk_user < 0) {
221 $this->error = 'ErrorBadParameter';
222 return -1;
223 }
224
225 $this->db->begin();
226
227 // Update request
228 $sql = "UPDATE ".MAIN_DB_PREFIX."salary SET";
229 $sql .= " tms='".$this->db->idate(dol_now())."',";
230 $sql .= " fk_user=".((int) $this->fk_user).",";
231 /*$sql .= " datep='".$this->db->idate($this->datep)."',";
232 $sql .= " datev='".$this->db->idate($this->datev)."',";*/
233 $sql .= " amount=".price2num($this->amount).",";
234 $sql .= " fk_projet=".((int) $this->fk_project).",";
235 $sql .= " fk_typepayment=".((int) $this->type_payment).",";
236 $sql .= " label='".$this->db->escape($this->label)."',";
237 $sql .= " datesp='".$this->db->idate($this->datesp)."',";
238 $sql .= " dateep='".$this->db->idate($this->dateep)."',";
239 $sql .= " note='".$this->db->escape($this->note)."',";
240 $sql .= " fk_bank=".($this->fk_bank > 0 ? (int) $this->fk_bank : "null").",";
241 $sql .= " fk_user_author=".((int) $this->fk_user_author).",";
242 $sql .= " fk_user_modif=".($this->fk_user_modif > 0 ? (int) $this->fk_user_modif : (int) $user->id);
243 $sql .= " WHERE rowid=".((int) $this->id);
244
245 dol_syslog(get_class($this)."::update", LOG_DEBUG);
246 $resql = $this->db->query($sql);
247 if (!$resql) {
248 $this->error = "Error ".$this->db->lasterror();
249 return -1;
250 }
251
252 // Update extrafield
253 if (!$error) {
254 $result = $this->insertExtraFields();
255 if ($result < 0) {
256 $error++;
257 }
258 }
259
260 if (!$notrigger) {
261 // Call trigger
262 $result = $this->call_trigger('SALARY_MODIFY', $user);
263 if ($result < 0) {
264 $error++;
265 }
266 // End call triggers
267 }
268
269 if (!$error) {
270 $this->db->commit();
271 return 1;
272 } else {
273 $this->db->rollback();
274 return -1;
275 }
276 }
277
278
286 public function fetch($id, $user = null)
287 {
288 $sql = "SELECT";
289 $sql .= " s.rowid,";
290 $sql .= " s.tms,";
291 $sql .= " s.fk_user,";
292 $sql .= " s.datep,";
293 $sql .= " s.datev,";
294 $sql .= " s.amount,";
295 $sql .= " s.fk_projet as fk_project,";
296 $sql .= " s.fk_typepayment,";
297 $sql .= " s.label,";
298 $sql .= " s.datesp,";
299 $sql .= " s.dateep,";
300 $sql .= " s.note as note_private,";
301 $sql .= " s.note_public,";
302 $sql .= " s.paye,";
303 $sql .= " s.fk_bank,";
304 $sql .= " s.fk_user_author,";
305 $sql .= " s.fk_user_modif,";
306 $sql .= " s.fk_account,";
307 $sql .= " cp.code as type_payment_code";
308 $sql .= " FROM ".MAIN_DB_PREFIX."salary as s";
309 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."bank as b ON s.fk_bank = b.rowid";
310 $sql .= " LEFT JOIN ".MAIN_DB_PREFIX."c_paiement as cp ON s.fk_typepayment = cp.id";
311 $sql .= " WHERE s.rowid = ".((int) $id);
312
313 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
314
315 $resql = $this->db->query($sql);
316 if ($resql) {
317 if ($this->db->num_rows($resql)) {
318 $obj = $this->db->fetch_object($resql);
319
320 $this->id = $obj->rowid;
321 $this->ref = $obj->rowid;
322 $this->tms = $this->db->jdate($obj->tms);
323 $this->fk_user = $obj->fk_user;
324 $this->datep = $this->db->jdate($obj->datep);
325 $this->datev = $this->db->jdate($obj->datev);
326 $this->amount = $obj->amount;
327 $this->fk_project = $obj->fk_project;
328 $this->type_payment = $obj->fk_typepayment;
329 $this->type_payment_code = $obj->type_payment_code;
330 $this->label = $obj->label;
331 $this->datesp = $this->db->jdate($obj->datesp);
332 $this->dateep = $this->db->jdate($obj->dateep);
333 $this->note = $obj->note_private;
334 $this->note_private = $obj->note_private;
335 $this->note_public = $obj->note_public;
336 $this->paye = $obj->paye;
337 $this->status = $obj->paye;
338 $this->fk_bank = $obj->fk_bank;
339 $this->fk_user_author = $obj->fk_user_author;
340 $this->fk_user_modif = $obj->fk_user_modif;
341 $this->fk_account = $obj->fk_account;
342 $this->accountid = $obj->fk_account;
343
344 // Retrieve all extrafield
345 // fetch optionals attributes and labels
346 $this->fetch_optionals();
347 }
348 $this->db->free($resql);
349
350 return 1;
351 } else {
352 $this->error = "Error ".$this->db->lasterror();
353 return -1;
354 }
355 }
356
357
365 public function delete($user, $notrigger = 0)
366 {
367 return $this->deleteCommon($user, $notrigger);
368 }
369
370
378 public function initAsSpecimen()
379 {
380 $this->id = 0;
381
382 $this->tms = dol_now();
383 $this->fk_user = 0;
384 $this->datep = '';
385 $this->datev = '';
386 $this->amount = '';
387 $this->label = '';
388 $this->datesp = '';
389 $this->dateep = '';
390 $this->note = '';
391 $this->fk_bank = 0;
392 $this->fk_user_author = 0;
393 $this->fk_user_modif = 0;
394
395 return 1;
396 }
397
404 public function create($user)
405 {
406 global $conf, $langs;
407
408 $error = 0;
409 $now = dol_now();
410
411 // Clean parameters
412 $this->amount = price2num(trim($this->amount));
413 $this->label = trim($this->label);
414 $this->note = trim($this->note);
415 $this->fk_bank = (int) $this->fk_bank;
416 $this->fk_user_author = (int) $this->fk_user_author;
417 $this->fk_user_modif = (int) $this->fk_user_modif;
418 $this->accountid = (int) $this->accountid;
419 $this->paye = (int) $this->paye;
420
421 // Check parameters
422 if (!$this->label) {
423 $this->error = $langs->trans("ErrorFieldRequired", $langs->transnoentities("Label"));
424 return -3;
425 }
426 if ($this->fk_user < 0 || $this->fk_user == '') {
427 $this->error = $langs->trans("ErrorFieldRequired", $langs->transnoentities("Employee"));
428 return -4;
429 }
430 if ($this->amount == '') {
431 $this->error = $langs->trans("ErrorFieldRequired", $langs->transnoentities("Amount"));
432 return -5;
433 }
434
435 $this->db->begin();
436
437 // Insert into llx_salary
438 $sql = "INSERT INTO ".MAIN_DB_PREFIX."salary (fk_user";
439 //$sql .= ", datep";
440 //$sql .= ", datev";
441 $sql .= ", amount";
442 $sql .= ", fk_projet";
443 $sql .= ", salary";
444 $sql .= ", fk_typepayment";
445 $sql .= ", fk_account";
446 if ($this->note) {
447 $sql .= ", note";
448 }
449 $sql .= ", label";
450 $sql .= ", datesp";
451 $sql .= ", dateep";
452 $sql .= ", fk_user_author";
453 $sql .= ", datec";
454 $sql .= ", fk_bank";
455 $sql .= ", entity";
456 $sql .= ") ";
457 $sql .= " VALUES (";
458 $sql .= "'".$this->db->escape($this->fk_user)."'";
459 //$sql .= ", '".$this->db->idate($this->datep)."'";
460 //$sql .= ", '".$this->db->idate($this->datev)."'";
461 $sql .= ", ".((float) $this->amount);
462 $sql .= ", ".($this->fk_project > 0 ? ((int) $this->fk_project) : 0);
463 $sql .= ", ".($this->salary > 0 ? ((float) $this->salary) : "null");
464 $sql .= ", ".($this->type_payment > 0 ? ((int) $this->type_payment) : 0);
465 $sql .= ", ".($this->accountid > 0 ? ((int) $this->accountid) : "null");
466 if ($this->note) {
467 $sql .= ", '".$this->db->escape($this->note)."'";
468 }
469 $sql .= ", '".$this->db->escape($this->label)."'";
470 $sql .= ", '".$this->db->idate($this->datesp)."'";
471 $sql .= ", '".$this->db->idate($this->dateep)."'";
472 $sql .= ", '".$this->db->escape($user->id)."'";
473 $sql .= ", '".$this->db->idate($now)."'";
474 $sql .= ", NULL";
475 $sql .= ", ".((int) $conf->entity);
476 $sql .= ")";
477
478 dol_syslog(get_class($this)."::create", LOG_DEBUG);
479 $result = $this->db->query($sql);
480 if ($result) {
481 $this->id = $this->db->last_insert_id(MAIN_DB_PREFIX."salary");
482
483 if ($this->id > 0) {
484 // Update extrafield
485 if (!$error) {
486 $result = $this->insertExtraFields();
487 if ($result < 0) {
488 $error++;
489 }
490 }
491
492 // Call trigger
493 $result = $this->call_trigger('SALARY_CREATE', $user);
494 if ($result < 0) {
495 $error++;
496 }
497 // End call triggers
498 } else {
499 $error++;
500 }
501
502 if (!$error) {
503 $this->db->commit();
504 return $this->id;
505 } else {
506 $this->db->rollback();
507 return -2;
508 }
509 } else {
510 $this->error = $this->db->error();
511 $this->db->rollback();
512 return -1;
513 }
514 }
515
516 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
523 public function update_fk_bank($id_bank)
524 {
525 // phpcs:enable
526 $sql = 'UPDATE '.MAIN_DB_PREFIX.'salary SET fk_bank = '.((int) $id_bank);
527 $sql .= " WHERE rowid = ".((int) $this->id);
528 $result = $this->db->query($sql);
529 if ($result) {
530 return 1;
531 } else {
532 dol_print_error($this->db);
533 return -1;
534 }
535 }
536
543 public function getTooltipContentArray($params)
544 {
545 global $langs;
546
547 $langs->loadLangs(['salaries']);
548
549 // Complete datas
550 if (!empty($params['fromajaxtooltip']) && !isset($this->alreadypaid)) {
551 // Load the alreadypaid field
552 $this->alreadypaid = $this->getSommePaiement(0);
553 }
554
555 $datas = [];
556
557 $datas['picto'] = '<u>'.$langs->trans("Salary").'</u>';
558 if (isset($this->status) && isset($this->alreadypaid)) {
559 $datas['picto'] .= ' '.$this->getLibStatut(5, $this->alreadypaid);
560 }
561 $datas['ref'] = '<br><b>'.$langs->trans('Ref').':</b> '.$this->ref;
562
563 return $datas;
564 }
565
576 public function getNomUrl($withpicto = 0, $option = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = -1)
577 {
578 global $conf, $langs, $hookmanager;
579
580 if (!empty($conf->dol_no_mouse_hover)) {
581 $notooltip = 1;
582 } // Force disable tooltips
583
584 $result = '';
585 $params = [
586 'id' => $this->id,
587 'objecttype' => $this->element,
588 'option' => $option,
589 ];
590 $classfortooltip = 'classfortooltip';
591 $dataparams = '';
592 if (getDolGlobalInt('MAIN_ENABLE_AJAX_TOOLTIP')) {
593 $classfortooltip = 'classforajaxtooltip';
594 $dataparams = ' data-params="'.dol_escape_htmltag(json_encode($params)).'"';
595 $label = '';
596 } else {
597 $label = implode($this->getTooltipContentArray($params));
598 }
599
600 $url = DOL_URL_ROOT.'/salaries/card.php?id='.$this->id;
601
602 if ($option != 'nolink') {
603 // Add param to save lastsearch_values or not
604 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
605 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
606 $add_save_lastsearch_values = 1;
607 }
608 if ($add_save_lastsearch_values) {
609 $url .= '&save_lastsearch_values=1';
610 }
611 }
612
613 $linkclose = '';
614 if (empty($notooltip)) {
615 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
616 $label = $langs->trans("ShowMyObject");
617 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
618 }
619 $linkclose .= ($label ? ' title="'.dol_escape_htmltag($label, 1).'"' : ' title="tocomplete"');
620 $linkclose .= $dataparams.' class="'.$classfortooltip.($morecss ? ' '.$morecss : '').'"';
621 } else {
622 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
623 }
624
625 $linkstart = '<a href="'.$url.'"';
626 $linkstart .= $linkclose.'>';
627 $linkend = '</a>';
628
629 $result .= $linkstart;
630 if ($withpicto) {
631 $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : 'class="'.(($withpicto != 2) ? 'paddingright ' : '').'"'), 0, 0, $notooltip ? 0 : 1);
632 }
633 if ($withpicto != 2) {
634 $result .= $this->ref;
635 }
636 $result .= $linkend;
637 //if ($withpicto != 2) $result.=(($addlabel && $this->label) ? $sep . dol_trunc($this->label, ($addlabel > 1 ? $addlabel : 0)) : '');
638
639 global $action, $hookmanager;
640 $hookmanager->initHooks(array('salarypayment'));
641 $parameters = array('id' => $this->id, 'getnomurl' => &$result);
642 $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
643 if ($reshook > 0) {
644 $result = $hookmanager->resPrint;
645 } else {
646 $result .= $hookmanager->resPrint;
647 }
648
649 return $result;
650 }
651
658 public function getSommePaiement($multicurrency = 0)
659 {
660 $table = 'payment_salary';
661 $field = 'fk_salary';
662
663 $sql = "SELECT sum(amount) as amount";
664 //sum(multicurrency_amount) as multicurrency_amount // Not yet supported
665 $sql .= " FROM ".MAIN_DB_PREFIX.$table;
666 $sql .= " WHERE ".$field." = ".((int) $this->id);
667
668 dol_syslog(get_class($this)."::getSommePaiement for salary id=".((int) $this->id), LOG_DEBUG);
669
670 $resql = $this->db->query($sql);
671
672 if ($resql) {
673 $obj = $this->db->fetch_object($resql);
674
675 $this->db->free($resql);
676
677 if ($obj) {
678 if ($multicurrency < 0) {
679 //$this->sumpayed = $obj->amount;
680 //$this->sumpayed_multicurrency = $obj->multicurrency_amount;
681 //return array('alreadypaid'=>(float) $obj->amount, 'alreadypaid_multicurrency'=>(float) $obj->multicurrency_amount);
682 return array(); // Not yet supported
683 } elseif ($multicurrency) {
684 //$this->sumpayed_multicurrency = $obj->multicurrency_amount;
685 //return (float) $obj->multicurrency_amount;
686 return -1; // Not yet supported
687 } else {
688 //$this->sumpayed = $obj->amount;
689 return (float) $obj->amount;
690 }
691 } else {
692 return 0;
693 }
694 } else {
695 $this->error = $this->db->lasterror();
696 return -1;
697 }
698 }
699
706 public function info($id)
707 {
708 $sql = 'SELECT ps.rowid, ps.datec, ps.tms as datem, ps.fk_user_author, ps.fk_user_modif';
709 $sql .= ' FROM '.MAIN_DB_PREFIX.'salary as ps';
710 $sql .= ' WHERE ps.rowid = '.((int) $id);
711
712 dol_syslog(get_class($this).'::info', LOG_DEBUG);
713 $result = $this->db->query($sql);
714
715 if ($result) {
716 if ($this->db->num_rows($result)) {
717 $obj = $this->db->fetch_object($result);
718
719 $this->id = $obj->rowid;
720
721 $this->user_creation_id = $obj->fk_user_author;
722 $this->user_modification_id = $obj->fk_user_modif;
723 $this->date_creation = $this->db->jdate($obj->datec);
724 $this->date_modification = empty($obj->datem) ? '' : $this->db->jdate($obj->datem);
725 }
726 $this->db->free($result);
727 } else {
728 dol_print_error($this->db);
729 }
730 }
731
732 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
741 public function set_paid($user)
742 {
743 // phpcs:enable
744 dol_syslog(get_class($this)."::set_paid is deprecated, use setPaid instead", LOG_NOTICE);
745 return $this->setPaid($user);
746 }
747
754 public function setPaid($user)
755 {
756 $sql = "UPDATE ".MAIN_DB_PREFIX."salary SET";
757 $sql .= " paye = 1";
758 $sql .= " WHERE rowid = ".((int) $this->id);
759
760 $return = $this->db->query($sql);
761
762 if ($return) {
763 $this->paye = 1;
764 return 1;
765 } else {
766 return -1;
767 }
768 }
769
770 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
777 public function set_unpaid($user)
778 {
779 // phpcs:enable
780 $sql = "UPDATE ".MAIN_DB_PREFIX."salary SET";
781 $sql .= " paye = 0";
782 $sql .= " WHERE rowid = ".((int) $this->id);
783
784 $return = $this->db->query($sql);
785
786 if ($return) {
787 $this->paye = 0;
788 return 1;
789 } else {
790 return -1;
791 }
792 }
793
794
802 public function getLibStatut($mode = 0, $alreadypaid = -1)
803 {
804 return $this->LibStatut($this->paye, $mode, $alreadypaid);
805 }
806
807 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
816 public function LibStatut($status, $mode = 0, $alreadypaid = -1)
817 {
818 // phpcs:enable
819 global $langs;
820
821 // Load translation files required by the page
822 $langs->loadLangs(array("customers", "bills"));
823
824 // We reinit status array to force to redefine them because label may change according to properties values.
825 $this->labelStatus = array();
826 $this->labelStatusShort = array();
827
828 if (empty($this->labelStatus) || empty($this->labelStatusShort)) {
829 global $langs;
830 //$langs->load("mymodule");
831 $this->labelStatus[self::STATUS_UNPAID] = $langs->transnoentitiesnoconv('BillStatusNotPaid');
832 $this->labelStatus[self::STATUS_PAID] = $langs->transnoentitiesnoconv('BillStatusPaid');
833 if ($status == self::STATUS_UNPAID && $alreadypaid != 0) {
834 $this->labelStatus[self::STATUS_UNPAID] = $langs->transnoentitiesnoconv("BillStatusStarted");
835 }
836 $this->labelStatusShort[self::STATUS_UNPAID] = $langs->transnoentitiesnoconv('BillStatusNotPaid');
837 $this->labelStatusShort[self::STATUS_PAID] = $langs->transnoentitiesnoconv('BillStatusPaid');
838 if ($status == self::STATUS_UNPAID && $alreadypaid != 0) {
839 $this->labelStatusShort[self::STATUS_UNPAID] = $langs->transnoentitiesnoconv("BillStatusStarted");
840 }
841 }
842
843 $statusType = 'status1';
844 if ($status == 0 && $alreadypaid != 0) {
845 $statusType = 'status3';
846 }
847 if ($status == 1) {
848 $statusType = 'status6';
849 }
850
851 return dolGetStatus($this->labelStatus[$status], $this->labelStatusShort[$status], '', $statusType, $mode);
852 }
853
861 public function getKanbanView($option = '', $arraydata = null)
862 {
863 global $langs;
864
865 $selected = (empty($arraydata['selected']) ? 0 : $arraydata['selected']);
866
867 $return = '<div class="box-flex-item box-flex-grow-zero">';
868 $return .= '<div class="info-box info-box-sm">';
869 $return .= '<span class="info-box-icon bg-infobox-action">';
870 $return .= img_picto('', $this->picto);
871 $return .= '</span>';
872 $return .= '<div class="info-box-content">';
873 $return .= '<span class="info-box-ref inline-block tdoverflowmax150 valignmiddle">'.(method_exists($this, 'getNomUrl') ? $this->getNomUrl(1) : $this->ref).'</span>';
874 if ($selected >= 0) {
875 $return .= '<input id="cb'.$this->id.'" class="flat checkforselect fright" type="checkbox" name="toselect[]" value="'.$this->id.'"'.($selected ? ' checked="checked"' : '').'>';
876 }
877 if (!empty($arraydata['user']) && is_object($arraydata['user'])) {
878 $user = $arraydata['user'];
879 '@phan-var-force User $user';
880 $return .= '<br><span class="info-box-label">'.$user->getNomUrl(empty($arraydata['user']->photo) ? 1 : -1, '', 0, 0, 16, 0, '', 'maxwidth100').'</span>';
881 }
882 if (property_exists($this, 'amount')) {
883 $return .= '<br><span class="info-box-label amount">'.price($this->amount).'</span>';
884 if (property_exists($this, 'type_payment') && !empty($this->type_payment)) {
885 $return .= ' <span class="info-box-label opacitymedium small">';
886 if ($langs->trans("PaymentTypeShort".$this->type_payment) != "PaymentTypeShort".$this->type_payment) {
887 $return .= $langs->trans("PaymentTypeShort".$this->type_payment);
888 } elseif ($langs->trans("PaymentType".$this->type_payment) != "PaymentType".$this->type_payment) {
889 $return .= $langs->trans("PaymentType".$this->type_payment);
890 }
891 $return .= '</span>';
892 }
893 }
894 if (method_exists($this, 'LibStatut')) {
895 $return .= '<br><div class="info-box-status">'.$this->getLibStatut(3, isset($this->alreadypaid) ? $this->alreadypaid : $this->totalpaid).'</div>';
896 }
897 $return .= '</div>';
898 $return .= '</div>';
899 $return .= '</div>';
900 return $return;
901 }
902
903 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
915 public function demande_prelevement($fuser, $amount = 0, $type = 'direct-debit', $sourcetype = 'salaire', $checkduplicateamongall = 0)
916 {
917 // phpcs:enable
918 global $conf, $mysoc;
919
920 $error = 0;
921
922 dol_syslog(get_class($this)."::demande_prelevement", LOG_DEBUG);
923 if ($this->paye == 0) {
924 require_once DOL_DOCUMENT_ROOT.'/societe/class/companybankaccount.class.php';
925 $bac = new CompanyBankAccount($this->db);
926 // @phan-suppress-next-line PhanPluginSuspiciousParamPosition
927 $bac->fetch(0, '', $mysoc->id);
928
929 $sql = "SELECT count(rowid) as nb";
930 $sql .= " FROM ".$this->db->prefix()."prelevement_demande";
931 if ($type == 'salaire') {
932 $sql .= " WHERE fk_salary = ".((int) $this->id);
933 } else {
934 $sql .= " WHERE fk_facture = ".((int) $this->id);
935 }
936 $sql .= " AND type = 'ban'"; // To exclude record done for some online payments
937 if (empty($checkduplicateamongall)) {
938 $sql .= " AND traite = 0";
939 }
940
941 dol_syslog(get_class($this)."::demande_prelevement", LOG_DEBUG);
942
943 $resql = $this->db->query($sql);
944 if ($resql) {
945 $obj = $this->db->fetch_object($resql);
946 if ($obj && $obj->nb == 0) { // If no request found yet
947 $now = dol_now();
948
949 $totalpaid = $this->getSommePaiement();
950 // $totalcreditnotes = $this->getSumCreditNotesUsed();
951 // $totaldeposits = $this->getSumDepositsUsed();
952 //print "totalpaid=".$totalpaid." totalcreditnotes=".$totalcreditnotes." totaldeposts=".$totaldeposits;
953
954 // We can also use bcadd to avoid pb with floating points
955 // For example print 239.2 - 229.3 - 9.9; does not return 0.
956 //$resteapayer=bcadd($this->total_ttc,$totalpaid,$conf->global->MAIN_MAX_DECIMALS_TOT);
957 //$resteapayer=bcadd($resteapayer,$totalavoir,$conf->global->MAIN_MAX_DECIMALS_TOT);
958 // if (empty($amount)) {
959 // $amount = price2num($this->total_ttc - $totalpaid - $totalcreditnotes - $totaldeposits, 'MT');
960 // }
961
962 if (is_numeric($amount) && $amount != 0) {
963 $sql = 'INSERT INTO '.$this->db->prefix().'prelevement_demande(';
964 if ($type == 'salaire') {
965 $sql .= 'fk_salary, ';
966 } else {
967 $sql .= 'fk_facture, ';
968 }
969 $sql .= ' amount, date_demande, fk_user_demande, code_banque, code_guichet, number, cle_rib, sourcetype, type, entity)';
970 $sql .= " VALUES (".((int) $this->id);
971 $sql .= ", ".((float) price2num($amount));
972 $sql .= ", '".$this->db->idate($now)."'";
973 $sql .= ", ".((int) $fuser->id);
974 $sql .= ", '".$this->db->escape($bac->code_banque)."'";
975 $sql .= ", '".$this->db->escape($bac->code_guichet)."'";
976 $sql .= ", '".$this->db->escape($bac->number)."'";
977 $sql .= ", '".$this->db->escape($bac->cle_rib)."'";
978 $sql .= ", '".$this->db->escape($sourcetype)."'";
979 $sql .= ", 'ban'";
980 $sql .= ", ".((int) $conf->entity);
981 $sql .= ")";
982
983 dol_syslog(get_class($this)."::demande_prelevement", LOG_DEBUG);
984 $resql = $this->db->query($sql);
985 if (!$resql) {
986 $this->error = $this->db->lasterror();
987 dol_syslog(get_class($this).'::demandeprelevement Erreur');
988 $error++;
989 }
990 } else {
991 $this->error = 'WithdrawRequestErrorNilAmount';
992 dol_syslog(get_class($this).'::demandeprelevement WithdrawRequestErrorNilAmount');
993 $error++;
994 }
995
996 if (!$error) {
997 // Force payment mode of invoice to withdraw
998 $payment_mode_id = dol_getIdFromCode($this->db, ($type == 'bank-transfer' ? 'VIR' : 'PRE'), 'c_paiement', 'code', 'id', 1);
999 if ($payment_mode_id > 0) {
1000 $result = $this->setPaymentMethods($payment_mode_id);
1001 }
1002 }
1003
1004 if ($error) {
1005 return -1;
1006 }
1007 return 1;
1008 } else {
1009 $this->error = "A request already exists";
1010 dol_syslog(get_class($this).'::demandeprelevement Can t create a request to generate a direct debit, a request already exists.');
1011 return 0;
1012 }
1013 } else {
1014 $this->error = $this->db->error();
1015 dol_syslog(get_class($this).'::demandeprelevement Error -2');
1016 return -2;
1017 }
1018 } else {
1019 $this->error = "Status of invoice does not allow this";
1020 dol_syslog(get_class($this)."::demandeprelevement ".$this->error." $this->status, $this->paye, $this->mode_reglement_id");
1021 return -3;
1022 }
1023 }
1024
1025 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
1033 public function demande_prelevement_delete($fuser, $did)
1034 {
1035 // phpcs:enable
1036 $sql = 'DELETE FROM '.$this->db->prefix().'prelevement_demande';
1037 $sql .= ' WHERE rowid = '.((int) $did);
1038 $sql .= ' AND traite = 0';
1039 if ($this->db->query($sql)) {
1040 return 0;
1041 } else {
1042 $this->error = $this->db->lasterror();
1043 dol_syslog(get_class($this).'::demande_prelevement_delete Error '.$this->error);
1044 return -1;
1045 }
1046 }
1047}
$object ref
Definition info.php:89
Parent class of all other business classes (invoices, contracts, proposals, orders,...
fetch_optionals($rowid=null, $optionsArray=null)
Function to get extra fields of an object into $this->array_options This method is in most cases call...
insertExtraFields($trigger='', $userused=null)
Add/Update all extra fields values for the current object.
setPaymentMethods($id)
Change the payments methods.
deleteCommon(User $user, $notrigger=0, $forcechilddeletion=0)
Delete object in database.
call_trigger($triggerName, $user)
Call trigger based on this instance.
Class to manage bank accounts description of third parties.
Class to manage salary payments.
fetch($id, $user=null)
Load object in memory from database.
initAsSpecimen()
Initialise an instance with random values.
update($user=null, $notrigger=0)
Update database.
getTooltipContentArray($params)
getTooltipContentArray
getKanbanView($option='', $arraydata=null)
Return clickable link of object (with eventually picto)
update_fk_bank($id_bank)
Update link between payment salary and line generate into llx_bank.
LibStatut($status, $mode=0, $alreadypaid=-1)
Return label of a given status.
set_paid($user)
Tag social contribution as paid completely.
demande_prelevement_delete($fuser, $did)
Remove a direct debit request or a credit transfer request.
getNomUrl($withpicto=0, $option='', $notooltip=0, $morecss='', $save_lastsearch_value=-1)
Send name clickable (with possibly the picto)
set_unpaid($user)
Remove tag paid on social contribution.
create($user)
Create in database.
getSommePaiement($multicurrency=0)
Return amount of payments already done.
getLibStatut($mode=0, $alreadypaid=-1)
Return label of current status.
info($id)
Information on record.
__construct($db)
Constructor.
setPaid($user)
Tag social contribution as paid completely.
demande_prelevement($fuser, $amount=0, $type='direct-debit', $sourcetype='salaire', $checkduplicateamongall=0)
Create a withdrawal request for a direct debit order or a credit transfer order.
print $langs trans("Ref").' m titre as m m statut as status
Or an array listing all the potential status of the object: array: int of the status => translated la...
Definition index.php:171
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
price2num($amount, $rounding='', $option=0)
Function that return a number with universal decimal format (decimal separator is '.
dol_now($mode='auto')
Return date for now.
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
dol_getIdFromCode($db, $key, $tablename, $fieldkey='code', $fieldid='id', $entityfilter=0, $filters='')
Return an id or code from a code or id.
dolGetStatus($statusLabel='', $statusLabelShort='', $html='', $statusType='status0', $displayMode=0, $url='', $params=array())
Output the badge of a status.
dol_print_error($db=null, $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
getDolGlobalString($key, $default='')
Return a Dolibarr global constant string value.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
global $conf
The following vars must be defined: $type2label $form $conf, $lang, The following vars may also be de...
Definition member.php:79