Integrare Index Incarcare e-Factura in factura PDF Tipărire

Pentru a personaliza facturile PDF generate de WHMCS cu upload_id-ul e-Factura, urmați pașii de mai jos:

1. Localizarea fișierului invoicepdf.tpl

Înainte de a face modificări asigurați-vă că folosiți o temă child: https://developers.whmcs.com/themes/child-themes/

Accesați directorul șablonului folosit în WHMCS (ex. /templates/my-theme/) și căutați fișierul invoicepdf.tpl. Dacă fișierul nu există, copiați-l din tema implicită WHMCS:

cp templates/twenty-one/invoicepdf.tpl templates/my-theme/

2. Adăugarea Capsule și Obținerea ID-ului de Încărcare

Deschideți fișierul invoicepdf.tpl cu un editor de text (de ex. File Manager sau Notepad) și adăugați la început următorul cod pentru a permite accesul la baza de date și pentru a prelua ID-ul de încărcare:

<?php
use WHMCS\Database\Capsule;
// FireWeb - Retrieve e-Factura upload_id using WHMCS Capsule
$eFacturaUploadId = Capsule::table('mod_fw_efactura_einvoices')->where('invoice_id', $invoiceid)->where('status', 1)->value('upload_id');

Dacă clasa Capsule este deja prezentă în fișier de la o altă modificare nu o mai includeți.
https://developers.whmcs.com/advanced/db-interaction/

3. Afișarea în PDF

Adăugați următorul cod în zona în care va fi afișată informația în PDF (de ex: linia 72 imediat după $pdf->Cell(0, 6, Lang::trans('invoicesdatedue') . ': ' . $duedate, 0, 1, 'L', '1');):

if($eFacturaUploadId) {
    $pdf->Cell(0, 6, Lang::trans('indexefactura') . ': ' . $eFacturaUploadId, 0, 1, 'L', '1');
}

3. Traducerea frazei indexefactura

Adăugați fraza în lang/overrides/romainan.php și pentru restul limbilor folosite respectând specificațiile WHMCS: https://developers.whmcs.com/languages/overrides/

$_LANG['indexefactura'] = 'Index e-Factura';

După finalizarea integrării, dacă factura a fost încărcată cu success în SPV, factura PDF va include o linie suplimentară asemănătoare cu aceasta:

Index e-Factura: 123456789

Dacă întâmpinați dificultăți sau aveți întrebări, vă rugăm să contactați echipa de suport.