FactureManager

🔧 setModuleCode

Fonction permettant la récupération de tous les modules-code, settings, li-code ... de l'objet

function setModuleCode():array {

        $all_settings = fwp7_param_objet_settings_list('',$this->id_type,'true');
        $tligs_codes = fwp7_param_objet_tlig_list('',$this->id_type,'true');
        $module_codes = fwp7_param_objet_att_list('',$this->id_type,'true');
        $ligs_codes = fwp7_param_objet_lig_list('',$this->id_type,'173','true');

        $result = array();
        foreach ($all_settings as  $item) {
            if (!empty($item['id_objsettings'])) {
                // définition de la clé de concatenation.
                $concat_key = "setting_".$item["code"]."_".$item["key"]."_".$item["subkey"];
                $result[$concat_key] = $item['value'];
            // ... (truncated)

↩️ Returns

(array)

🔧 getModuleCodes

Récupère tous les modules code de l'ObjetType

function getModuleCodes():array{
        return $this->facture_module_codes;
    }

↩️ Returns

(array)

🔧 process_invoice_product_lines

Traitement des lignes de produit pour une facture Cette fonction gère le traitement des lignes de produit dans une facture : - Récupère tous les attributs nécessaires - Traite chaque ligne de la facture - Met à jour les informations produit, prix et autres champs associés

function process_invoice_product_lines($id_type, $id_obje, $global_modified_att, $isCreateLig = false, $isDeleteLig = false, $user_identification_interface = '') {
        // Get all necessary attribute IDs
        $attributes = $this->get_invoice_product_line_attributes($id_type);

        // Get the invoice lines from global modified attributes
        $lignes_de_facture = $global_modified_att[$id_type][$id_obje]["lig"][$attributes['att_tlig_ligne_de_produit']] ?? [];

        // If there are no lines or we're creating/deleting a line, return
        if (empty($lignes_de_facture) || $isCreateLig || $isDeleteLig) {
            return;
        }

        // Process each invoice line
        foreach ($lignes_de_facture as $key_lig_id => $value) {
            $this->update_invoice_product_line(
            $id_type,
                $id_obje,
                // ... (truncated)

⚙️ Parameters

$id_type (string) L'identifiant du type
$id_obje (string) L'identifiant de l'objet
$global_modified_att (array) Le tableau des attributs modifiés globalement
$isCreateLig (bool) Indicateur si une ligne est en cours de création
$isDeleteLig (bool) Indicateur si une ligne est en cours de suppression
$user_identification_interface (string) Interface d'identification utilisateur

↩️ Returns

(void)

🔧 get_invoice_product_line_attributes

Récupère tous les identifiants d'attributs nécessaires pour le traitement des lignes de produit de facture

function get_invoice_product_line_attributes($id_type): array
    {
        return [
            'att_tlig_ligne_de_produit' => fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'),
            'att_tlig_produit' => fwp7_param_template_lig_get_number('', $id_type, fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'), 'produit_facture'),
            'att_id_type_produit' => fwp7_param_objet_setting_get('', $id_type, 'produit', 'id_type'),
            'att_prod_puht_produit' => fwp7_param_template_lig_get_number('', $id_type, fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'), 'prod_puht'),
            'attnomproduit_personnalise' => fwp7_param_template_lig_get_number('', $id_type, fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'), 'lig_produit_id_designation_metier'),
            'attnomproduit_qty_lignedefacture' => fwp7_param_template_lig_get_number('', $id_type, fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'), 'lig_produit_quantite'),
            'att_prod_totalpuht_produit' => fwp7_param_template_lig_get_number('', $id_type, fwp7_param_template_tlg_get_number('', $id_type, 'ligne_de_documents'), 'lig_document_total_ht'),
            'att_unite_produit' => fwp7_param_template_att_get_number('', '', 'unite_produit'),
            // ... (truncated)

⚙️ Parameters

$id_type (string) L'identifiant du type

↩️ Returns

(array) Tableau des identifiants d'attributs

🔧 update_invoice_product_line

Met à jour une ligne de produit de facture

function update_invoice_product_line($id_type, $id_obje, $key_lig_id, $value, $attributes, $user_identification_interface) {
        $line = fwc7_data_objet_lig('', $id_type, $id_obje, $attributes['att_tlig_ligne_de_produit'], $key_lig_id);
        $values_sets = [];

        // If product line is changed or added
        if (isset($value[$attributes['att_tlig_produit']])) {
            $product_id = $value[$attributes['att_tlig_produit']]['new'];
            $product = $product_id !== '' ? fwc7_data_objet_att('', $attributes['att_id_type_produit'], $product_id) : null;

            $modifier = new Facture_ProductLineModifier($id_type, $id_obje, $key_lig_id, $line, $product);
            $produit_franchiseur = $modifier->getProduitParent();
            $produit_franchise = $modifier->getChildProduct_selected();

            $user_info = fwc7_TS_NOOA_user_infos('');
            // ... (truncated)

⚙️ Parameters

$id_type (string) L'identifiant du type
$id_obje (string) L'identifiant de l'objet
$key_lig_id (string) La clé d'identifiant de ligne
$value (array) La valeur de la ligne
$attributes (array) Le tableau des attributs
$user_identification_interface (string) Interface d'identification utilisateur

↩️ Returns

(void)

🔧 upsertStatutDeReglement

function upsertStatutDeReglement(){
        // BROUILLON --> statut par défaut tant que la facture est en broulillon
        // A PAYER → Soldée = false ET Montant Réglé TTC = 0 (couleur Rouge)
        // PARTIELLEMENT PAYÉE → Soldée = false ET Montant Réglé TTC > 0 (couleur Orange)
        // PAYÉE → Soldée = true (couleur Vert)
        // message trop perçu potentielle )-> message().

        // > récupérer le total TTC rémisé de la facture
        $TotalRemiseTTC = round((float)$this->facture[$this->getModuleCodes()['att_remise_totttc']], 2);
        // > récupérer le total TTC de tous les règlements effectués
        $totalReglements = round(array_sum(array_column($this->reglements, 'lig2')), 2);

        // avertissement si trop perçu
        $dataSet =  [];

        if($totalReglements < $TotalRemiseTTC &&  $totalReglements !== 0 ){
            $dataSet["att29"] = "partiellement_paye";
            //fwk7_affiche_alert_message('Le total du règlement saisi complète partiellement le montant de la facture '.$this->facture["att1"].' (total : '.$TotalRemiseTTC. '€ )','warning');
        } else if($totalReglements > $TotalRemiseTTC){
            $dataSet["att29"] = "trop_percu";
            //fwk7_affiche_alert_message('Le total du règlement saisi est supérieur au montant de la facture concernée '.$this->facture["att1"].' (total : '.$TotalRemiseTTC. '€ )','warning');
        }else if($totalReglements == $TotalRemiseTTC){
            // ... (truncated)

⚠️ Throws

Exception:

🔧 handleInterlocuteur

function handleInterlocuteur(){
        $id_user = $this->facture["att25"];
        return $id_user;
    }

↩️ Returns

(mixed)

🔧 getAddressData

Récupère l'adresse d'intervention ou l'adresse de facturation depuis le devis et la formatte

function getAddressData() {
        // att des champs d'intervention
        $addressFields = ($this->addressType == 'FACTURATION') ? ['21', '22', '23', '24', '25'] : ['21', '22', '23', '24', '25']; // att des champs de facturation
        return [
            'adresseLigne1' => $this->facture["att" . $addressFields[0]],
            'adresseLigne2' => $this->facture["att" . $addressFields[1]],
            'cp' => $this->facture["att" . $addressFields[2]],
            'ville' => $this->facture["att" . $addressFields[3]],
            'pays' => $this->facture["att" . $addressFields[4]]
        ];
    }

↩️ Returns

(array)

🔧 getAddressDataIntervention

Récupère l'adresse d'intervention depuis le devis et la formatte

function getAddressDataIntervention() {
        $addressFields = ['92', '39', '40', '41', '42']; // att des champs d'intervention

        return [
            'adresseLigne1' => $this->facture["att" . $addressFields[0]],
        ];
    }

↩️ Returns

(array)

🔧 formatClientHeader

function formatClientHeader($prefix = null) {
        $html = '';
        // nom de la société
        if ($this->client['att8'] == 'professionnel' || $this->client['att8'] == 'collectivite') {
            $html .= self::makeParagraph('<b>' . ($prefix ? $prefix . ' ' : '') . $this->client["att9"].'</b>');
        }
        // nom du client et sa civilité
        $html .= self::makeParagraph('<b>'.($prefix ? $prefix . ' ' : '').
            ($this->civilites[$this->client['att10']] ? $this->civilites[$this->client['att10']] . ' ' : '').
            $this->client["att3"] . ' ' .
            fwk7_txt_toupper($this->client["att1"]).'</b>'
        );

        // ... (truncated)

↩️ Returns

(string)

🔧 generateFormattedAddressIntervention

Méthode pour générer l'adresse d'intervention formatée pour les factures coopérative

function generateFormattedAddressIntervention(): string
    {
        $addressData = $this->getAddressDataIntervention();
        //$devisOBJ = $this->getDevisInfos();

        $html = '<div style="font-size: 9px;margin:0;padding:0;">';
        $html .= '<p style="line-height: 1em; font-weight: bold; font-size: 9px;">Adresse du chantier :</p>';
        $html .= html_entity_decode($this->formatAddress($addressData));
        //MLT-160725-Ajout coordonnées mail et tel sur facture coopérative
        $phone = !empty($this->formatPhone())
            ? $this->formatPhone()
            : (!empty($this->formatMobile())? $this->formatMobile() :'');
        if(!empty($phone)){
            // ... (truncated)

↩️ Returns

(string)

🔧 generateFormattedAddressInterventionFacture

Méthode pour générer l'adresse d'intervention formatée pour les factures

function generateFormattedAddressInterventionFacture(): string
    {
        $addressData = $this->getAddressDataIntervention();
        //$devisOBJ = $this->getDevisInfos();
        if (!empty($addressData)){
            $html = '<div style="font-size: 9px;margin:0;padding:0;">';
            $html .= '<p style="line-height: 1em; font-weight: bold; font-size: 9px;">Lieu d\'intervention :</p>';
            $html .= html_entity_decode($this->formatAddress($addressData));
            $html .= '</div>';
            return $html;
        }else{
            return '';
        // ... (truncated)

↩️ Returns

(string)

🔧 getAllContacts

function getAllContacts(){
        // chercher sur la table client, tous les Contacts destinataire.
        $wc =array();
        $wc[]=" att8 ='".$this->client["id_obje"]."' ";
        $all_contacts = fwc7_data_objet_atts('',MapperFacture::TYPE_CONTACT($this->id_type),"1",$wc);
        return  array_column(array_values($all_contacts), 'att6');

    }

↩️ Returns

(mixed)

🔧 generateInfosFacture

Méthode pour générer les infos de la facture formatté

function generateInfosFacture(): string
    {
        $infoFacture = $this->getFactureInfos();
        $infoDevis = $this->getDevisFacture();
        $attDateFacture = fwp7_param_template_att_get_number('',$this->id_type,'att_date_facture');
        $attDateEcheance = fwp7_param_template_att_get_number('',$this->id_type,'att_date_echeance');


        $html = '<div style="margin-top: 5px">'.
            '<p style="font-size: 2em; font-weight: bold; line-height: 1em; color: '.MapperFacture::COULEUR_TEXT($this->id_type).';">Facture</p>'.
            '<p style="line-height: 1em; font-size: 10px;">N° '.$infoFacture['att1']. '</p>'.
            '<p style="line-height: 1em; font-size: 10px;">Devis en référence : '.$infoDevis['att4']. '</p>'.
            (!empty($infoFacture[$attDateFacture])?'<p style="line-height: 1em; font-size: 10px;">En date du : '.date('d/m/Y', strtotime($infoFacture[$attDateFacture])). '</p>':'').
            // ... (truncated)

↩️ Returns

(string)

🔧 generateInfosAvoir

Méthode pour générer les infos de la facture formatté

function generateInfosAvoir(): string
    {
        $infoFacture = $this->getFactureInfos();
        $attDateFacture = fwp7_param_template_att_get_number('',$this->id_type,'att_date_facture');
        $attDateEcheance = fwp7_param_template_att_get_number('',$this->id_type,'att_date_echeance');

        $html = '<div style="margin-top: 5px">'.
            '<p style="font-size: 2em; font-weight: bold; line-height: 1em; color: '.MapperFacture::COULEUR_TEXT($this->id_type).';">Avoir</p>'.
            '<p style="line-height: 1em; font-size: 10px;">Avoir : '.$infoFacture['att1'].'</p>'.
            '<p style="line-height: 1em; font-size: 10px;">'.$infoFacture['att9']. '</p>'.
            (!empty($infoFacture[$attDateFacture])?'<p style="line-height: 1em; font-size: 10px;">En date du : '.date('d/m/Y', strtotime($infoFacture[$attDateFacture])). '</p>':'').
            (!empty($infoFacture[$attDateEcheance])?'<p style="line-height: 1em; font-size: 10px;">Date d\'échéance : '.date('d/m/Y', strtotime($infoFacture[$attDateEcheance])). '</p>':'').
            // ... (truncated)

↩️ Returns

(string)

🔧 generateTauxTVA

Méthode principale pour avoir les lignes de TVA de la facture

function generateTauxTVA(): string
    {

        $ligneDevis = fwc7_data_objet_ligs('', $this->id_type, $this->id_objet, MapperFacture::IDLIG_PRODUIT($this->id_type), 'all', 1, '');

        $groupedArray = [];

        foreach ($ligneDevis as $item) {
            $tva_value = $item[MapperFacture::TAUX_TVA_PRODUIT($this->id_type)] ?? 'undefined'; // undefined si pas de TVA renseigné

            // s'assurer que $tva_value est bien une valeur numérique de type 5.5 / 10 / 20 / 0

            // supprimer et trim de la valeur au caus ou (string)'%' persisterai

            $groupedArray[$tva_value][] = $item;

        }

        $resultString = "";

        // ... (truncated)

↩️ Returns

(string)

🔧 generateTotalFacture

Générer les infos de la facture en html

function generateTotalFacture(): string
    {
        $infoFacture = $this->getFactureInfos();
        $infoCommande = $this->getThisComandebyFacture();
        $factureListe = $this->getFacturesbyCommande();
        $dejaEuUnAcompte = false;

        // Check s'il y a déjà eu une facture d'acompte
        foreach ($factureListe as $item) {
            if (isset($item['att18']) && $item['att18'] === 'acompte') {
                $dejaEuUnAcompte = true;
                break;
            }
        // ... (truncated)

↩️ Returns

(string) infos en HTML.

🔧 formatPrice

Formate un prix avec 2 décimales après la virgules, force une virgule au lieu du point, met un espace en séparateur de milliers

function formatPrice($price) : string
    {
        return number_format($price, 2, '.', ' ');
    }

↩️ Returns

(string) Nombre formaté avec 2 chiffres après la virgule + un séparateur des milliers avec un espace pour une meilleure lisibilité

🔧 getTamponAcquite

fonction permettant la récupération du chemin vers l'image de tampon facture acquitté

function getTamponAcquite(){
        $imageTampon = '<p ><img src="'.fwp7_param_params_detail('','tampon_acquite').'" alt="image tampon facture acquité"></p>';
        return $imageTampon;
    }

↩️ Returns

(string)