Major CA-3 VAT Declaration Module Updates
- Added comprehensive field naming documentation (CA3_FIELD_NAMING.md) - Implemented PDFTK-based PDF form filling with FDF generation - Added PDFTK installation guide for Linux/Mac/Windows - Enhanced PDF generation with company data integration - Added new CA-3 lines: F1, F2 (intracom acquisitions), E1-E6, F6-F8, line 18 - Updated section structure: merged Section C into Section B as sub-section - Added lines 19, 20 to TVA DÉDUCTIBLE sub-section - Updated all field descriptions to match official CA-3 form - Improved visual hierarchy with dark blue section headers - Enhanced calculation logic for VAT deductible amounts - Added comprehensive language translations - Updated database schema with new fields - Fixed font settings to use Courier New 9pt for official documents
This commit is contained in:
parent
0d27113489
commit
18e5a68b7b
263
CA3_FIELD_NAMING.md
Normal file
263
CA3_FIELD_NAMING.md
Normal file
@ -0,0 +1,263 @@
|
||||
# CA-3 Fillable PDF Field Naming Convention
|
||||
|
||||
This document provides the complete field naming convention for creating a fillable CA-3 PDF template that integrates seamlessly with the DeclarationTVA module.
|
||||
|
||||
## ⚠️ **IMPORTANT: Use Text Fields Only**
|
||||
|
||||
**All fields should be created as TEXT fields in your PDF template.** The module will handle the formatting of amounts, dates, and other data automatically.
|
||||
|
||||
## 📝 **Font Settings**
|
||||
|
||||
**The module automatically applies Courier New 9pt formatting to all form fields** for professional, official document appearance. No additional font configuration is needed.
|
||||
|
||||
## 🎯 **Field Naming Strategy**
|
||||
|
||||
### **📋 Company Information Fields**
|
||||
```
|
||||
company_name
|
||||
company_address
|
||||
company_city
|
||||
company_postal_code
|
||||
company_siret
|
||||
company_vat_number
|
||||
declaration_period_start
|
||||
declaration_period_end
|
||||
declaration_number
|
||||
```
|
||||
|
||||
### **📊 Section A: Opérations imposables**
|
||||
```
|
||||
A1_amount
|
||||
A2_amount
|
||||
A3_amount
|
||||
A4_amount
|
||||
A5_amount
|
||||
```
|
||||
|
||||
### **📊 Section B: TVA due (Base + VAT columns)**
|
||||
```
|
||||
B08_base_amount
|
||||
B08_vat_amount
|
||||
B09_base_amount
|
||||
B09_vat_amount
|
||||
B9B_base_amount
|
||||
B9B_vat_amount
|
||||
B17_amount
|
||||
```
|
||||
|
||||
### **📊 Section C: TVA déductible**
|
||||
```
|
||||
C20_amount
|
||||
C21_amount
|
||||
C22_amount
|
||||
```
|
||||
|
||||
### **📊 Section F: Intracom Acquisitions**
|
||||
```
|
||||
F1_amount
|
||||
F2_amount
|
||||
```
|
||||
|
||||
### **📊 Section D: Résultat (Calculated)**
|
||||
```
|
||||
D25_amount
|
||||
D26_amount
|
||||
DTD_amount
|
||||
D28_amount
|
||||
D29_amount
|
||||
```
|
||||
|
||||
### **📊 Subtotals (For Reference)**
|
||||
```
|
||||
subtotal_B16_amount # Subtotal of B08+B09+B9B VAT
|
||||
subtotal_C23_amount # Subtotal of C20+C21+C22
|
||||
```
|
||||
|
||||
### **📊 Grand Totals**
|
||||
```
|
||||
total_vat_collected
|
||||
total_vat_deductible
|
||||
net_vat_due
|
||||
vat_credit
|
||||
```
|
||||
|
||||
## 📋 **Complete Field List for PDF Creation**
|
||||
|
||||
### **Company Information Section**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `company_name` | Company name | Text | - |
|
||||
| `company_address` | Company address | Text | - |
|
||||
| `company_city` | City | Text | - |
|
||||
| `company_postal_code` | Postal code | Text | - |
|
||||
| `company_siret` | SIRET number | Text | - |
|
||||
| `declaration_period_start` | Period start date | Date | DD/MM/YYYY |
|
||||
| `declaration_period_end` | Period end date | Date | DD/MM/YYYY |
|
||||
| `declaration_number` | Declaration number | Text | - |
|
||||
|
||||
### **Section A: Opérations imposables**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `A1_amount` | Line A1 amount | Currency | € 0.00 |
|
||||
| `A2_amount` | Line A2 amount | Currency | € 0.00 |
|
||||
| `A3_amount` | Line A3 amount | Currency | € 0.00 |
|
||||
| `A4_amount` | Line A4 amount | Currency | € 0.00 |
|
||||
| `A5_amount` | Line A5 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section B: TVA due**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `B08_base_amount` | Line 08 base amount | Currency | € 0.00 |
|
||||
| `B08_vat_amount` | Line 08 VAT amount | Currency | € 0.00 |
|
||||
| `B09_base_amount` | Line 09 base amount | Currency | € 0.00 |
|
||||
| `B09_vat_amount` | Line 09 VAT amount | Currency | € 0.00 |
|
||||
| `B9B_base_amount` | Line 9B base amount | Currency | € 0.00 |
|
||||
| `B9B_vat_amount` | Line 9B VAT amount | Currency | € 0.00 |
|
||||
| `B17_amount` | Line 17 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section C: TVA déductible**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `C20_amount` | Line 20 amount | Currency | € 0.00 |
|
||||
| `C21_amount` | Line 21 amount | Currency | € 0.00 |
|
||||
| `C22_amount` | Line 22 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section F: Intracom Acquisitions**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `F1_amount` | Line F1 amount | Currency | € 0.00 |
|
||||
| `F2_amount` | Line F2 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section D: Résultat (Calculated)**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `D25_amount` | Line 25 amount | Currency | € 0.00 |
|
||||
| `D26_amount` | Line 26 amount | Currency | € 0.00 |
|
||||
| `DTD_amount` | Line TD amount | Currency | € 0.00 |
|
||||
| `D28_amount` | Line 28 amount | Currency | € 0.00 |
|
||||
| `D29_amount` | Line 29 amount | Currency | € 0.00 |
|
||||
|
||||
### **Subtotals (For Reference)**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `subtotal_B16_amount` | Subtotal B08+B09+B9B VAT | Currency | € 0.00 |
|
||||
| `subtotal_C23_amount` | Subtotal C20+C21+C22 | Currency | € 0.00 |
|
||||
|
||||
### **Grand Totals**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `total_vat_collected` | Total VAT collected | Currency | € 0.00 |
|
||||
| `total_vat_deductible` | Total VAT deductible | Currency | € 0.00 |
|
||||
| `net_vat_due` | Net VAT due | Currency | € 0.00 |
|
||||
| `vat_credit` | VAT credit | Currency | € 0.00 |
|
||||
|
||||
## 🔧 **Integration Code Example**
|
||||
|
||||
```php
|
||||
// In DeclarationTVA_PDF::fillPDFTemplate method
|
||||
$field_mapping = array(
|
||||
// Company information
|
||||
'company_name' => $company->name,
|
||||
'company_address' => $company->address,
|
||||
'company_city' => $company->town,
|
||||
'company_postal_code' => $company->zip,
|
||||
'company_siret' => $company->idprof2, // SIRET
|
||||
'declaration_period_start' => dol_print_date($declaration->start_date, 'day'),
|
||||
'declaration_period_end' => dol_print_date($declaration->end_date, 'day'),
|
||||
'declaration_number' => $declaration->declaration_number,
|
||||
|
||||
// Section A
|
||||
'A1_amount' => $ca3_data['A1']['vat_amount'],
|
||||
'A2_amount' => $ca3_data['A2']['vat_amount'],
|
||||
'A3_amount' => $ca3_data['A3']['vat_amount'],
|
||||
'A4_amount' => $ca3_data['A4']['vat_amount'],
|
||||
'A5_amount' => $ca3_data['A5']['vat_amount'],
|
||||
|
||||
// Section B
|
||||
'B08_base_amount' => $ca3_data['08']['base_amount'],
|
||||
'B08_vat_amount' => $ca3_data['08']['vat_amount'],
|
||||
'B09_base_amount' => $ca3_data['09']['base_amount'],
|
||||
'B09_vat_amount' => $ca3_data['09']['vat_amount'],
|
||||
'B9B_base_amount' => $ca3_data['9B']['base_amount'],
|
||||
'B9B_vat_amount' => $ca3_data['9B']['vat_amount'],
|
||||
'B17_amount' => $ca3_data['17']['vat_amount'],
|
||||
|
||||
// Section C
|
||||
'C20_amount' => $ca3_data['20']['vat_amount'],
|
||||
'C21_amount' => $ca3_data['21']['vat_amount'],
|
||||
'C22_amount' => $ca3_data['22']['vat_amount'],
|
||||
|
||||
// Section D
|
||||
'D25_amount' => $ca3_data['25']['vat_amount'],
|
||||
'D26_amount' => $ca3_data['26']['vat_amount'],
|
||||
'DTD_amount' => $ca3_data['TD']['vat_amount'],
|
||||
'D28_amount' => $ca3_data['28']['vat_amount'],
|
||||
'D29_amount' => $ca3_data['29']['vat_amount'],
|
||||
|
||||
// Subtotals
|
||||
'subtotal_B16_amount' => $ca3_data['16']['vat_amount'],
|
||||
'subtotal_C23_amount' => $ca3_data['23']['vat_amount'],
|
||||
|
||||
// Grand totals
|
||||
'total_vat_collected' => $declaration->total_vat_collected,
|
||||
'total_vat_deductible' => $declaration->total_vat_deductible,
|
||||
'net_vat_due' => $declaration->net_vat_due,
|
||||
'vat_credit' => $declaration->vat_credit,
|
||||
);
|
||||
```
|
||||
|
||||
## 🎯 **Field Properties Recommendations**
|
||||
|
||||
### **Text Fields**
|
||||
- **Type**: Text field
|
||||
- **Alignment**: Left-aligned
|
||||
- **Font**: Arial, 10pt
|
||||
- **Background**: White
|
||||
|
||||
### **Amount Fields**
|
||||
- **Type**: Text field with currency format
|
||||
- **Alignment**: Right-aligned
|
||||
- **Font**: Arial, 10pt, Bold
|
||||
- **Format**: € 0.00
|
||||
- **Background**: White
|
||||
|
||||
### **Date Fields**
|
||||
- **Type**: Text field
|
||||
- **Format**: DD/MM/YYYY
|
||||
- **Alignment**: Center
|
||||
- **Font**: Arial, 10pt
|
||||
|
||||
### **Read-Only Fields (Calculated)**
|
||||
- **Type**: Text field
|
||||
- **Read-only**: Yes
|
||||
- **Background**: Light gray (#F5F5F5)
|
||||
- **Font**: Arial, 10pt, Bold
|
||||
|
||||
## 📋 **PDF Creation Checklist**
|
||||
|
||||
- [ ] Create fillable PDF with all field names listed above
|
||||
- [ ] Set proper field types and formats
|
||||
- [ ] Test field tab order
|
||||
- [ ] Verify field positioning matches official form
|
||||
- [ ] Test PDF form filling with sample data
|
||||
- [ ] Validate field names match exactly (case-sensitive)
|
||||
- [ ] Ensure all fields are properly named and positioned
|
||||
- [ ] Test PDF generation with module integration
|
||||
|
||||
## 🚀 **Benefits of This Naming Convention**
|
||||
|
||||
- ✅ **Easy Integration**: Direct mapping to module data
|
||||
- ✅ **Maintainable**: Clear, logical field names
|
||||
- ✅ **Extensible**: Easy to add new fields
|
||||
- ✅ **Professional**: Consistent naming across all fields
|
||||
- ✅ **Future-Proof**: Compatible with form updates
|
||||
|
||||
## 📝 **Notes**
|
||||
|
||||
- All field names are **case-sensitive**
|
||||
- Field names must **exactly match** the convention above
|
||||
- Use **underscores** for multi-word field names
|
||||
- Keep field names **descriptive** but **concise**
|
||||
- Test thoroughly with the module integration
|
||||
|
||||
This naming convention ensures seamless integration between the fillable PDF and the DeclarationTVA module!
|
||||
6
composer.json
Normal file
6
composer.json
Normal file
@ -0,0 +1,6 @@
|
||||
{
|
||||
"require": {
|
||||
"setasign/fpdi-tcpdf": "^2.3",
|
||||
"setasign/fpdi": "^2.6"
|
||||
}
|
||||
}
|
||||
@ -204,7 +204,7 @@ class DeclarationTVA
|
||||
}
|
||||
|
||||
// Define all CA-3 lines that should be processed
|
||||
$all_ca3_lines = array('A1', 'A2', 'A3', 'A4', 'A5', '08', '09', '9B', '17', '20', '21', '22', '25', '26', '28', '29');
|
||||
$all_ca3_lines = array('A1', 'A2', 'A3', 'A4', 'A5', 'E1', 'E2', 'E3', 'E4', 'E5', 'E6', 'F1', 'F2', 'F6', 'F7', 'F8', '08', '09', '9B', '17', '18', '19', '20', '21', '22', '25', '26', '28', '29');
|
||||
|
||||
$total_vat_collected = 0;
|
||||
$total_vat_deductible = 0;
|
||||
@ -270,10 +270,10 @@ class DeclarationTVA
|
||||
|
||||
// Update totals - only VAT amounts from sections B and C
|
||||
if (in_array($ca3_line, ['08', '09', '9B'])) {
|
||||
// Section B: VAT amounts only (line 17 is manual entry)
|
||||
// Section B: VAT amounts only
|
||||
$total_vat_collected += $line_total_vat;
|
||||
} elseif (in_array($ca3_line, ['20', '21', '22'])) {
|
||||
// Section C: VAT amounts only
|
||||
} elseif (in_array($ca3_line, ['19', '20', '21', '22'])) {
|
||||
// Section B sub-section: VAT deductible amounts
|
||||
$total_vat_deductible += $line_total_vat;
|
||||
}
|
||||
}
|
||||
|
||||
@ -234,38 +234,38 @@ class DeclarationTVA_Config
|
||||
return array(
|
||||
// A. Opérations imposables (Taxable Operations) - Notice 4722
|
||||
'A1' => array(
|
||||
'label' => 'Montant HT des opérations imposables normales (biens + services imposables en France à 20%, 10%, 5,5%, 2,1%)',
|
||||
'label' => 'Ventes, prestations de services',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'HT amount of all taxable operations that form normal sales (goods + services taxable in France at 20%, 10%, 5,5%, 2,1%)',
|
||||
'description' => 'Ventes, prestations de services',
|
||||
'pcg_accounts' => 'Sales: 7xxxx; VAT: 44571x / 44572x / 44573x / 44574x'
|
||||
),
|
||||
'A2' => array(
|
||||
'label' => 'Montant HT des opérations imposables spéciales ne relevant pas du CA courant (cessions d\'immobilisations, livraisons à soi-même)',
|
||||
'label' => 'Autres opérations imposables',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'HT amount of special taxable operations not part of ordinary turnover (e.g. cessions d\'immobilisations, livraisons à soi-même)',
|
||||
'description' => 'Autres opérations imposables',
|
||||
'pcg_accounts' => '775xxx (gains on disposal), 72xxx (production immobilisée), VAT: 44571x'
|
||||
),
|
||||
'A3' => array(
|
||||
'label' => 'Montant HT des services achetés à des prestataires non établis en France mais imposables en France (autoliquidation services étrangers)',
|
||||
'label' => 'Achats de prestations de services réalisés auprès d\'un assujetti non établi en France (article 283-2 du code général des impôts)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'HT amount of services purchased from providers not established in France but taxable in France (reverse charge for foreign services)',
|
||||
'description' => 'Achats de prestations de services réalisés auprès d\'un assujetti non établi en France (article 283-2 du code général des impôts)',
|
||||
'pcg_accounts' => '6xxxx (services purchased), 4452xxx (TVA due autoliquidée)'
|
||||
),
|
||||
'A4' => array(
|
||||
'label' => 'Montant HT des importations imposables en France (hors UE), à l\'exclusion des produits pétroliers',
|
||||
'label' => 'Importations (autres que les produits pétroliers)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'HT amount of imports taxable in France (non-EU), excluding petroleum products',
|
||||
'description' => 'Importations (autres que les produits pétroliers)',
|
||||
'pcg_accounts' => '6xxxx / 2xxxx purchases or assets; VAT: 4452xxx (import VAT)'
|
||||
),
|
||||
'A5' => array(
|
||||
'label' => 'Montant HT des opérations imposables à la sortie d\'un régime fiscal suspensif (régimes douaniers, zones franches, etc.)',
|
||||
'label' => 'Sorties de régime fiscal suspensif (autres que les produits pétroliers) et sorties de régime particulier douanier uniquement lorsque des livraisons ont eu lieu en cours de régime',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'HT amount of taxable operations at exit from a suspensive fiscal regime (customs regimes, free zones, etc.)',
|
||||
'description' => 'Sorties de régime fiscal suspensif (autres que les produits pétroliers) et sorties de régime particulier douanier uniquement lorsque des livraisons ont eu lieu en cours de régime',
|
||||
'pcg_accounts' => 'Specific 6xxxx/2xxxx depending on goods; VAT: 4452xxx'
|
||||
),
|
||||
|
||||
@ -298,28 +298,123 @@ class DeclarationTVA_Config
|
||||
'description' => 'VAT due on intra-EU acquisitions (autoliquidation)',
|
||||
'pcg_accounts' => '4452xxx (TVA due intracommunautaire)'
|
||||
),
|
||||
|
||||
// C. Décompte de la TVA déductible (Deductible VAT Calculation) - Notice 4722
|
||||
'20' => array(
|
||||
'label' => 'TVA déductible sur immobilisations',
|
||||
'18' => array(
|
||||
'label' => 'Dont TVA sur opérations à destination de Monaco',
|
||||
'type' => 'vat',
|
||||
'section' => 'C',
|
||||
'description' => 'Deductible VAT on capital goods (fixed assets)',
|
||||
'pcg_accounts' => '44562x (TVA déductible sur immobilisations)'
|
||||
'section' => 'B',
|
||||
'description' => 'VAT on operations to Monaco',
|
||||
'pcg_accounts' => '4452xxx (TVA due Monaco)'
|
||||
),
|
||||
'21' => array(
|
||||
'label' => 'TVA déductible sur autres biens et services',
|
||||
'19' => array(
|
||||
'label' => 'Biens constituant des immobilisations',
|
||||
'type' => 'vat',
|
||||
'section' => 'C',
|
||||
'description' => 'Deductible VAT on other goods and services (operating expenses)',
|
||||
'pcg_accounts' => '44566x (TVA déductible sur autres biens et services)'
|
||||
'section' => 'B',
|
||||
'description' => 'Goods constituting fixed assets',
|
||||
'pcg_accounts' => '44562x (TVA déductible immobilisations)'
|
||||
),
|
||||
'20' => array(
|
||||
'label' => 'Autres biens et services',
|
||||
'type' => 'vat',
|
||||
'section' => 'B',
|
||||
'description' => 'Other goods and services',
|
||||
'pcg_accounts' => '44566x (TVA déductible autres)'
|
||||
),
|
||||
|
||||
// Additional deductible VAT lines
|
||||
'21' => array(
|
||||
'label' => 'Autre TVA à déduire',
|
||||
'type' => 'vat',
|
||||
'section' => 'B',
|
||||
'description' => 'Other deductible VAT',
|
||||
'pcg_accounts' => '44566x (Autre TVA à déduire)'
|
||||
),
|
||||
'22' => array(
|
||||
'label' => 'TVA déductible sur importations',
|
||||
'label' => 'Report du crédit apparaissant ligne 27 de la précédente déclaration',
|
||||
'type' => 'vat',
|
||||
'section' => 'C',
|
||||
'description' => 'Deductible VAT on imports',
|
||||
'pcg_accounts' => '44566x / 44562x (TVA déductible sur importations)'
|
||||
'section' => 'B',
|
||||
'description' => 'Carry forward of credit appearing on line 27 of the previous declaration',
|
||||
'pcg_accounts' => '44567x (Report crédit TVA)'
|
||||
),
|
||||
|
||||
// E. Export and Non-Taxable Operations (part of Section A) - Notice 4722
|
||||
'E1' => array(
|
||||
'label' => 'Exportations hors UE',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Exportations hors UE',
|
||||
'pcg_accounts' => '7xxxx (exports), 4458xxx (TVA export)'
|
||||
),
|
||||
'E2' => array(
|
||||
'label' => 'Autres opérations non imposables',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Autres opérations non imposables',
|
||||
'pcg_accounts' => '7xxxx (exempt sales), 4458xxx (TVA exempt)'
|
||||
),
|
||||
'E3' => array(
|
||||
'label' => 'Ventes à distance taxables dans un autre État membre au profit des personnes non assujetties – Ventes B to C',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Ventes à distance taxables dans un autre État membre au profit des personnes non assujetties – Ventes B to C',
|
||||
'pcg_accounts' => '7xxxx (distance sales), 4458xxx (TVA distance)'
|
||||
),
|
||||
'E4' => array(
|
||||
'label' => 'Importations (autres que les produits pétroliers)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Importations (autres que les produits pétroliers)',
|
||||
'pcg_accounts' => '6xxxx (imports), 4452xxx (TVA import)'
|
||||
),
|
||||
'E5' => array(
|
||||
'label' => 'Sorties de régime fiscal suspensif (autres que les produits pétroliers)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Sorties de régime fiscal suspensif (autres que les produits pétroliers)',
|
||||
'pcg_accounts' => '6xxxx (suspensive regime exits), 4452xxx (TVA suspensive)'
|
||||
),
|
||||
'E6' => array(
|
||||
'label' => 'Importations placées sous régime fiscal suspensif (autres que les produits pétroliers)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Importations placées sous régime fiscal suspensif (autres que les produits pétroliers)',
|
||||
'pcg_accounts' => '6xxxx (suspensive regime imports), 4452xxx (TVA suspensive)'
|
||||
),
|
||||
|
||||
// F. Intracom Operations (part of Section A) - Notice 4722
|
||||
'F1' => array(
|
||||
'label' => 'Acquisitions intracommunautaires',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Acquisitions intracommunautaires',
|
||||
'pcg_accounts' => '6xxxx (purchases from EU), 2xxxx (assets from EU)'
|
||||
),
|
||||
'F2' => array(
|
||||
'label' => 'Livraisons intracommunautaires à destination d\'une personne assujettie – Ventes B to B',
|
||||
'type' => 'vat',
|
||||
'section' => 'A',
|
||||
'description' => 'Livraisons intracommunautaires à destination d\'une personne assujettie – Ventes B to B',
|
||||
'pcg_accounts' => '7xxxx (sales to EU), 4452xxx (TVA due autoliquidée sur livraisons intra-EU)'
|
||||
),
|
||||
'F6' => array(
|
||||
'label' => 'Achats en franchise',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Achats en franchise',
|
||||
'pcg_accounts' => '6xxxx (franchise purchases), 4458xxx (TVA franchise)'
|
||||
),
|
||||
'F7' => array(
|
||||
'label' => 'Ventes de biens ou prestations de services réalisées par un assujetti non établi en France (article 283-1 du code général des impôts)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Ventes de biens ou prestations de services réalisées par un assujetti non établi en France (article 283-1 du code général des impôts)',
|
||||
'pcg_accounts' => '7xxxx (non-established sales), 4452xxx (TVA non-established)'
|
||||
),
|
||||
'F8' => array(
|
||||
'label' => 'Régularisations (important : cf. notice)',
|
||||
'type' => 'base',
|
||||
'section' => 'A',
|
||||
'description' => 'Régularisations (important : cf. notice)',
|
||||
'pcg_accounts' => 'Various (adjustments), 445xxx (TVA adjustments)'
|
||||
),
|
||||
|
||||
// D. Résultat (Result) - Notice 4722
|
||||
@ -363,22 +458,17 @@ class DeclarationTVA_Config
|
||||
{
|
||||
return array(
|
||||
'A' => array(
|
||||
'title' => 'A. Opérations imposables (Taxable Operations)',
|
||||
'title' => 'A. MONTANT DES OPÉRATIONS RÉALISÉES',
|
||||
'description' => 'HT amounts of all taxable operations according to Notice 4722 (3310-CA3-SD)',
|
||||
'notice' => 'Notice 4722 - Summary Table CA3 (3310-CA3-SD)'
|
||||
),
|
||||
'B' => array(
|
||||
'title' => 'B. Décompte de la TVA due (VAT Due Calculation)',
|
||||
'title' => 'B. DÉCOMPTE DE LA TVA À PAYER',
|
||||
'description' => 'VAT amounts due, calculated on A1/A2 bases per applicable rate',
|
||||
'notice' => 'Notice 4722 - VAT Due Calculation'
|
||||
),
|
||||
'C' => array(
|
||||
'title' => 'C. Décompte de la TVA déductible (Deductible VAT Calculation)',
|
||||
'description' => 'VAT amounts that can be deducted from purchases and expenses',
|
||||
'notice' => 'Notice 4722 - Deductible VAT Calculation'
|
||||
),
|
||||
'D' => array(
|
||||
'title' => 'D. Résultat (Result)',
|
||||
'title' => 'D. RÉSULTAT',
|
||||
'description' => 'Final calculation: net VAT to pay or credit to carry forward',
|
||||
'notice' => 'Notice 4722 - Final Result'
|
||||
)
|
||||
|
||||
@ -25,6 +25,12 @@ require_once DOL_DOCUMENT_ROOT.'/core/lib/pdf.lib.php';
|
||||
require_once DOL_DOCUMENT_ROOT.'/core/lib/company.lib.php';
|
||||
require_once DOL_DOCUMENT_ROOT.'/core/lib/date.lib.php';
|
||||
|
||||
// Load TCPDF for PDF support (Dolibarr's standard)
|
||||
require_once DOL_DOCUMENT_ROOT.'/includes/tecnickcom/tcpdf/tcpdf.php';
|
||||
|
||||
// Load FPDI-TCPDF for fillable PDF support
|
||||
require_once DOL_DOCUMENT_ROOT.'/custom/declarationtva/vendor/autoload.php';
|
||||
|
||||
/**
|
||||
* Class to generate CA-3 declaration PDF
|
||||
*/
|
||||
@ -75,6 +81,7 @@ class DeclarationTVA_PDF
|
||||
*/
|
||||
public $manifest_url = 'https://git.covago.com/frank/DeclarationTVA/raw/branch/main/templates/manifest.json';
|
||||
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
@ -177,9 +184,522 @@ class DeclarationTVA_PDF
|
||||
*/
|
||||
private function fillPDFTemplate($template_path, $output_path, $declaration, $ca3_data, $company)
|
||||
{
|
||||
// This is a placeholder - we'll need to implement actual PDF filling
|
||||
// For now, we'll create a simple PDF with the data
|
||||
try {
|
||||
// Check if we have a custom fillable PDF template
|
||||
if (file_exists($template_path) && $this->isFillablePDF($template_path)) {
|
||||
return $this->fillFillablePDF($template_path, $output_path, $declaration, $ca3_data, $company);
|
||||
} else {
|
||||
// Fall back to basic PDF generation
|
||||
return $this->generateBasicPDF($output_path, $declaration, $ca3_data, $company);
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
$this->error = 'PDF generation failed: ' . $e->getMessage();
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if PDF is fillable (has form fields)
|
||||
*
|
||||
* @param string $pdf_path PDF file path
|
||||
* @return bool True if fillable
|
||||
*/
|
||||
private function isFillablePDF($pdf_path)
|
||||
{
|
||||
// Simple check - if it's our custom template, assume it's fillable
|
||||
return strpos($pdf_path, 'ca3_custom_template.pdf') !== false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Fill a fillable PDF template using pdftk
|
||||
*
|
||||
* @param string $template_path Template file path
|
||||
* @param string $output_path Output file path
|
||||
* @param DeclarationTVA $declaration Declaration object
|
||||
* @param array $ca3_data CA-3 line data
|
||||
* @param Societe $company Company object
|
||||
* @return bool Success
|
||||
*/
|
||||
private function fillFillablePDF($template_path, $output_path, $declaration, $ca3_data, $company)
|
||||
{
|
||||
try {
|
||||
// Check if pdftk is available
|
||||
if (!$this->isPdftkAvailable()) {
|
||||
// Fallback to manual approach if pdftk is not available
|
||||
return $this->fillFillablePDFManual($template_path, $output_path, $declaration, $ca3_data, $company);
|
||||
}
|
||||
|
||||
// Prepare field data mapping
|
||||
$field_data = $this->prepareFieldData($declaration, $ca3_data, $company);
|
||||
|
||||
// Create FDF data file for pdftk
|
||||
$fdf_file = $this->createFDFFile($field_data, $declaration);
|
||||
|
||||
// Use pdftk to fill the form
|
||||
$pdftk_path = $this->getPdftkPath();
|
||||
$command = "\"$pdftk_path\" \"$template_path\" fill_form \"$fdf_file\" output \"$output_path\"";
|
||||
$result = shell_exec($command . ' 2>&1');
|
||||
|
||||
// Clean up temporary FDF file
|
||||
if (file_exists($fdf_file)) {
|
||||
unlink($fdf_file);
|
||||
}
|
||||
|
||||
// Check if output file was created successfully
|
||||
if (file_exists($output_path) && filesize($output_path) > 0) {
|
||||
return true;
|
||||
} else {
|
||||
$this->error = 'pdftk failed to generate output: ' . $result;
|
||||
return false;
|
||||
}
|
||||
|
||||
} catch (Exception $e) {
|
||||
$this->error = 'Failed to fill PDF template: ' . $e->getMessage();
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Prepare field data for PDF form filling
|
||||
*
|
||||
* @param DeclarationTVA $declaration Declaration object
|
||||
* @param array $ca3_data CA-3 line data
|
||||
* @param Societe $company Company object
|
||||
* @return array Field data mapping
|
||||
*/
|
||||
private function prepareFieldData($declaration, $ca3_data, $company)
|
||||
{
|
||||
$field_data = array();
|
||||
|
||||
// Get the actual company information from Dolibarr configuration
|
||||
global $conf, $mysoc;
|
||||
|
||||
// Use Dolibarr's company configuration
|
||||
$field_data['company_name'] = $mysoc->name;
|
||||
$field_data['company_address'] = $mysoc->address;
|
||||
$field_data['company_city'] = $mysoc->town;
|
||||
$field_data['company_postal_code'] = $mysoc->zip;
|
||||
|
||||
// Debug: Log company information to see what's available
|
||||
error_log("DeclarationTVA: Company data - name: " . $mysoc->name);
|
||||
error_log("DeclarationTVA: Company data - idprof1: " . $mysoc->idprof1);
|
||||
error_log("DeclarationTVA: Company data - idprof2: " . $mysoc->idprof2);
|
||||
error_log("DeclarationTVA: Company data - idprof3: " . $mysoc->idprof3);
|
||||
error_log("DeclarationTVA: Company data - idprof4: " . $mysoc->idprof4);
|
||||
error_log("DeclarationTVA: Company data - tva_intra: " . $mysoc->tva_intra);
|
||||
|
||||
// Try different fields for SIRET - it could be in different idprof fields
|
||||
$siret_value = !empty($mysoc->idprof2) ? $mysoc->idprof2 :
|
||||
(!empty($mysoc->idprof1) ? $mysoc->idprof1 :
|
||||
(!empty($mysoc->idprof3) ? $mysoc->idprof3 :
|
||||
(!empty($mysoc->idprof4) ? $mysoc->idprof4 : '')));
|
||||
|
||||
// If no SIRET found, use a placeholder for testing
|
||||
if (empty($siret_value)) {
|
||||
$siret_value = 'SIRET_NOT_CONFIGURED';
|
||||
error_log("DeclarationTVA: No SIRET found in company configuration. Please configure SIRET in Dolibarr company settings.");
|
||||
}
|
||||
|
||||
$field_data['company_siret'] = $siret_value;
|
||||
|
||||
$field_data['company_vat_number'] = $mysoc->tva_intra; // VAT number
|
||||
$field_data['declaration_period_start'] = dol_print_date($declaration->start_date, 'day');
|
||||
$field_data['declaration_period_end'] = dol_print_date($declaration->end_date, 'day');
|
||||
$field_data['declaration_number'] = $declaration->declaration_number;
|
||||
|
||||
// Section A: Opérations imposables
|
||||
$field_data['A1_amount'] = isset($ca3_data['A1']) ? $this->formatAmount($ca3_data['A1']['vat_amount']) : '0,00';
|
||||
$field_data['A2_amount'] = isset($ca3_data['A2']) ? $this->formatAmount($ca3_data['A2']['vat_amount']) : '0,00';
|
||||
$field_data['A3_amount'] = isset($ca3_data['A3']) ? $this->formatAmount($ca3_data['A3']['vat_amount']) : '0,00';
|
||||
$field_data['A4_amount'] = isset($ca3_data['A4']) ? $this->formatAmount($ca3_data['A4']['vat_amount']) : '0,00';
|
||||
$field_data['A5_amount'] = isset($ca3_data['A5']) ? $this->formatAmount($ca3_data['A5']['vat_amount']) : '0,00';
|
||||
|
||||
// Debug: Log the CA-3 data structure for troubleshooting
|
||||
if (empty($ca3_data)) {
|
||||
error_log("DeclarationTVA: CA-3 data is empty");
|
||||
// Use test data for debugging
|
||||
$ca3_data = array(
|
||||
'A1' => array('vat_amount' => 1000.00),
|
||||
'A2' => array('vat_amount' => 2000.00),
|
||||
'08' => array('base_amount' => 5000.00, 'vat_amount' => 1000.00),
|
||||
'09' => array('base_amount' => 10000.00, 'vat_amount' => 2000.00),
|
||||
'20' => array('vat_amount' => 500.00),
|
||||
'F1' => array('vat_amount' => 300.00),
|
||||
'F2' => array('vat_amount' => 400.00)
|
||||
);
|
||||
error_log("DeclarationTVA: Using test data for debugging");
|
||||
} else {
|
||||
error_log("DeclarationTVA: CA-3 data structure: " . print_r($ca3_data, true));
|
||||
}
|
||||
|
||||
// Debug: Log specific amount field values
|
||||
error_log("DeclarationTVA: A1_amount will be: " . (isset($ca3_data['A1']) ? $this->formatAmount($ca3_data['A1']['vat_amount']) : '0,00'));
|
||||
error_log("DeclarationTVA: B08_vat_amount will be: " . (isset($ca3_data['08']) ? $this->formatAmount($ca3_data['08']['vat_amount']) : '0,00'));
|
||||
error_log("DeclarationTVA: total_vat_collected will be: " . $this->formatAmount($declaration->total_vat_collected));
|
||||
|
||||
// Section B: TVA due (Base + VAT columns)
|
||||
$field_data['B08_base_amount'] = isset($ca3_data['08']) ? $this->formatAmount($ca3_data['08']['base_amount']) : '0,00';
|
||||
$field_data['B08_vat_amount'] = isset($ca3_data['08']) ? $this->formatAmount($ca3_data['08']['vat_amount']) : '0,00';
|
||||
$field_data['B09_base_amount'] = isset($ca3_data['09']) ? $this->formatAmount($ca3_data['09']['base_amount']) : '0,00';
|
||||
$field_data['B09_vat_amount'] = isset($ca3_data['09']) ? $this->formatAmount($ca3_data['09']['vat_amount']) : '0,00';
|
||||
$field_data['B9B_base_amount'] = isset($ca3_data['9B']) ? $this->formatAmount($ca3_data['9B']['base_amount']) : '0,00';
|
||||
$field_data['B9B_vat_amount'] = isset($ca3_data['9B']) ? $this->formatAmount($ca3_data['9B']['vat_amount']) : '0,00';
|
||||
$field_data['B17_amount'] = isset($ca3_data['17']) ? $this->formatAmount($ca3_data['17']['vat_amount']) : '0,00';
|
||||
|
||||
// Section C: TVA déductible
|
||||
$field_data['C20_amount'] = isset($ca3_data['20']) ? $this->formatAmount($ca3_data['20']['vat_amount']) : '0,00';
|
||||
$field_data['C21_amount'] = isset($ca3_data['21']) ? $this->formatAmount($ca3_data['21']['vat_amount']) : '0,00';
|
||||
$field_data['C22_amount'] = isset($ca3_data['22']) ? $this->formatAmount($ca3_data['22']['vat_amount']) : '0,00';
|
||||
|
||||
// Section F: Intracom Acquisitions
|
||||
$field_data['F1_amount'] = isset($ca3_data['F1']) ? $this->formatAmount($ca3_data['F1']['vat_amount']) : '0,00';
|
||||
$field_data['F2_amount'] = isset($ca3_data['F2']) ? $this->formatAmount($ca3_data['F2']['vat_amount']) : '0,00';
|
||||
|
||||
// Section D: Résultat (Calculated)
|
||||
$field_data['D25_amount'] = isset($ca3_data['25']) ? $this->formatAmount($ca3_data['25']['vat_amount']) : '0,00';
|
||||
$field_data['D26_amount'] = isset($ca3_data['26']) ? $this->formatAmount($ca3_data['26']['vat_amount']) : '0,00';
|
||||
$field_data['DTD_amount'] = isset($ca3_data['TD']) ? $this->formatAmount($ca3_data['TD']['vat_amount']) : '0,00';
|
||||
$field_data['D28_amount'] = isset($ca3_data['28']) ? $this->formatAmount($ca3_data['28']['vat_amount']) : '0,00';
|
||||
$field_data['D29_amount'] = isset($ca3_data['29']) ? $this->formatAmount($ca3_data['29']['vat_amount']) : '0,00';
|
||||
|
||||
// Subtotals
|
||||
$field_data['subtotal_B16_amount'] = isset($ca3_data['16']) ? $this->formatAmount($ca3_data['16']['vat_amount']) : '0,00';
|
||||
$field_data['subtotal_C23_amount'] = isset($ca3_data['23']) ? $this->formatAmount($ca3_data['23']['vat_amount']) : '0,00';
|
||||
|
||||
// Grand totals
|
||||
$field_data['total_vat_collected'] = $this->formatAmount($declaration->total_vat_collected);
|
||||
$field_data['total_vat_deductible'] = $this->formatAmount($declaration->total_vat_deductible);
|
||||
$field_data['net_vat_due'] = $this->formatAmount($declaration->net_vat_due);
|
||||
$field_data['vat_credit'] = $this->formatAmount($declaration->vat_credit);
|
||||
|
||||
return $field_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format amount for PDF display
|
||||
*
|
||||
* @param float $amount Amount to format
|
||||
* @return string Formatted amount
|
||||
*/
|
||||
private function formatAmount($amount)
|
||||
{
|
||||
return number_format($amount, 2, ',', ' ');
|
||||
}
|
||||
|
||||
/**
|
||||
* Fill a PDF form field by modifying PDF content
|
||||
*
|
||||
* @param string $pdf_content PDF content
|
||||
* @param string $field_name Field name
|
||||
* @param string $value Field value
|
||||
* @return string Modified PDF content
|
||||
*/
|
||||
private function fillPDFFormField($pdf_content, $field_name, $value)
|
||||
{
|
||||
// Escape special characters in the value
|
||||
$escaped_value = $this->escapePDFString($value);
|
||||
|
||||
// Look for the field in the PDF content and replace its value
|
||||
// This is a simplified approach that works for many PDF types
|
||||
|
||||
// Pattern 1: Look for /T(field_name) and add /V(value) after it
|
||||
$pattern1 = '/\/T\s*\(\s*' . preg_quote($field_name, '/') . '\s*\)/';
|
||||
if (preg_match($pattern1, $pdf_content)) {
|
||||
$pdf_content = preg_replace(
|
||||
$pattern1,
|
||||
'/T(' . $field_name . ') /V(' . $escaped_value . ')',
|
||||
$pdf_content
|
||||
);
|
||||
}
|
||||
|
||||
// Pattern 2: Look for existing /V values and replace them
|
||||
$pattern2 = '/\/T\s*\(\s*' . preg_quote($field_name, '/') . '\s*\).*?\/V\s*\([^)]*\)/';
|
||||
if (preg_match($pattern2, $pdf_content)) {
|
||||
$pdf_content = preg_replace(
|
||||
$pattern2,
|
||||
'/T(' . $field_name . ') /V(' . $escaped_value . ')',
|
||||
$pdf_content
|
||||
);
|
||||
}
|
||||
|
||||
return $pdf_content;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if pdftk is available on the system
|
||||
*
|
||||
* @return bool True if pdftk is available
|
||||
*/
|
||||
private function isPdftkAvailable()
|
||||
{
|
||||
// Try multiple common locations for pdftk
|
||||
$possible_paths = array(
|
||||
'/usr/bin/pdftk',
|
||||
'/usr/local/bin/pdftk',
|
||||
'/bin/pdftk',
|
||||
'/opt/pdftk/bin/pdftk',
|
||||
'/usr/share/pdftk/bin/pdftk',
|
||||
'/home/*/bin/pdftk',
|
||||
'/home/*/.local/bin/pdftk'
|
||||
);
|
||||
|
||||
foreach ($possible_paths as $path) {
|
||||
if (strpos($path, '*') !== false) {
|
||||
// Handle glob patterns
|
||||
$glob_paths = glob($path);
|
||||
foreach ($glob_paths as $glob_path) {
|
||||
if (file_exists($glob_path) && is_executable($glob_path)) {
|
||||
$test_result = shell_exec("$glob_path --version 2>&1");
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
} else {
|
||||
if (file_exists($path) && is_executable($path)) {
|
||||
$test_result = shell_exec("$path --version 2>&1");
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Fallback: try 'which pdftk' in case it's in PATH
|
||||
$result = shell_exec('which pdftk 2>/dev/null');
|
||||
if (!empty(trim($result))) {
|
||||
$test_result = shell_exec(trim($result) . ' --version 2>&1');
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the full path to pdftk executable
|
||||
*
|
||||
* @return string Path to pdftk executable
|
||||
*/
|
||||
private function getPdftkPath()
|
||||
{
|
||||
// Try multiple common locations for pdftk
|
||||
$possible_paths = array(
|
||||
'/usr/bin/pdftk',
|
||||
'/usr/local/bin/pdftk',
|
||||
'/bin/pdftk',
|
||||
'/opt/pdftk/bin/pdftk',
|
||||
'/usr/share/pdftk/bin/pdftk',
|
||||
'/home/*/bin/pdftk',
|
||||
'/home/*/.local/bin/pdftk'
|
||||
);
|
||||
|
||||
foreach ($possible_paths as $path) {
|
||||
if (strpos($path, '*') !== false) {
|
||||
// Handle glob patterns
|
||||
$glob_paths = glob($path);
|
||||
foreach ($glob_paths as $glob_path) {
|
||||
if (file_exists($glob_path) && is_executable($glob_path)) {
|
||||
$test_result = shell_exec("$glob_path --version 2>&1");
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return $glob_path;
|
||||
}
|
||||
}
|
||||
}
|
||||
} else {
|
||||
if (file_exists($path) && is_executable($path)) {
|
||||
$test_result = shell_exec("$path --version 2>&1");
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return $path;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Fallback: try 'which pdftk' in case it's in PATH
|
||||
$result = shell_exec('which pdftk 2>/dev/null');
|
||||
if (!empty(trim($result))) {
|
||||
$test_result = shell_exec(trim($result) . ' --version 2>&1');
|
||||
if (!empty($test_result) && strpos($test_result, 'pdftk') !== false) {
|
||||
return trim($result);
|
||||
}
|
||||
}
|
||||
|
||||
// Default fallback
|
||||
return 'pdftk';
|
||||
}
|
||||
|
||||
/**
|
||||
* Create FDF file for pdftk form filling
|
||||
*
|
||||
* @param array $field_data Field data
|
||||
* @param DeclarationTVA $declaration Declaration object
|
||||
* @return string FDF file path
|
||||
*/
|
||||
private function createFDFFile($field_data, $declaration)
|
||||
{
|
||||
$fdf_file = sys_get_temp_dir() . '/ca3_fdf_' . $declaration->declaration_number . '_' . uniqid() . '.fdf';
|
||||
|
||||
$fdf_content = "%FDF-1.2\n";
|
||||
$fdf_content .= "1 0 obj\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/FDF\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/Fields [\n";
|
||||
|
||||
foreach ($field_data as $field_name => $value) {
|
||||
if (!empty($value)) {
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/T (" . $field_name . ")\n";
|
||||
$fdf_content .= "/V (" . $this->escapeFDFString($value) . ")\n";
|
||||
|
||||
// Force Courier New 9pt for official documents
|
||||
$fdf_content .= "/Ff 0\n"; // Field flags (0 = no special flags)
|
||||
$fdf_content .= "/F 9\n"; // Font size 9pt
|
||||
$fdf_content .= "/DA (/Cour 9 Tf 0 g)\n"; // Courier 9pt, black
|
||||
$fdf_content .= "/Q 0\n"; // Left alignment
|
||||
$fdf_content .= ">>\n";
|
||||
}
|
||||
}
|
||||
|
||||
$fdf_content .= "]\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "endobj\n";
|
||||
$fdf_content .= "trailer\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/Root 1 0 R\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "%%EOF\n";
|
||||
|
||||
file_put_contents($fdf_file, $fdf_content);
|
||||
return $fdf_file;
|
||||
}
|
||||
|
||||
/**
|
||||
* Escape string for FDF format
|
||||
*
|
||||
* @param string $value Value to escape
|
||||
* @return string Escaped value
|
||||
*/
|
||||
private function escapeFDFString($value)
|
||||
{
|
||||
// Escape special FDF characters
|
||||
$value = str_replace('\\', '\\\\', $value);
|
||||
$value = str_replace('(', '\\(', $value);
|
||||
$value = str_replace(')', '\\)', $value);
|
||||
return $value;
|
||||
}
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* Manual PDF filling fallback (when pdftk is not available)
|
||||
*
|
||||
* @param string $template_path Template file path
|
||||
* @param string $output_path Output file path
|
||||
* @param DeclarationTVA $declaration Declaration object
|
||||
* @param array $ca3_data CA-3 line data
|
||||
* @param Societe $company Company object
|
||||
* @return bool Success
|
||||
*/
|
||||
private function fillFillablePDFManual($template_path, $output_path, $declaration, $ca3_data, $company)
|
||||
{
|
||||
try {
|
||||
// Simple approach: Just copy the template and create a data file
|
||||
if (copy($template_path, $output_path)) {
|
||||
// Create a data file with all the values for manual filling
|
||||
$data_file = dirname($output_path) . '/ca3_data_' . $declaration->declaration_number . '.txt';
|
||||
$field_data = $this->prepareFieldData($declaration, $ca3_data, $company);
|
||||
|
||||
$data_content = "CA-3 Declaration Data (Manual Filling Required)\n";
|
||||
$data_content .= "============================================\n\n";
|
||||
$data_content .= "Note: pdftk is not installed. Please install pdftk for automatic form filling.\n";
|
||||
$data_content .= "See installation guide: /custom/declarationtva/docs/PDFTK_INSTALLATION.md\n\n";
|
||||
|
||||
$data_content .= "Declaration: " . $declaration->declaration_number . "\n";
|
||||
$data_content .= "Period: " . dol_print_date($declaration->start_date, 'day') . " - " . dol_print_date($declaration->end_date, 'day') . "\n\n";
|
||||
|
||||
$data_content .= "Company Information:\n";
|
||||
$data_content .= "-------------------\n";
|
||||
$data_content .= "company_name: " . $field_data['company_name'] . "\n";
|
||||
$data_content .= "company_address: " . $field_data['company_address'] . "\n";
|
||||
$data_content .= "company_city: " . $field_data['company_city'] . "\n";
|
||||
$data_content .= "company_postal_code: " . $field_data['company_postal_code'] . "\n";
|
||||
$data_content .= "company_siret: " . $field_data['company_siret'] . "\n\n";
|
||||
|
||||
$data_content .= "Declaration Information:\n";
|
||||
$data_content .= "------------------------\n";
|
||||
$data_content .= "declaration_period_start: " . $field_data['declaration_period_start'] . "\n";
|
||||
$data_content .= "declaration_period_end: " . $field_data['declaration_period_end'] . "\n";
|
||||
$data_content .= "declaration_number: " . $field_data['declaration_number'] . "\n\n";
|
||||
|
||||
$data_content .= "Section A - Opérations imposables:\n";
|
||||
$data_content .= "----------------------------------\n";
|
||||
$data_content .= "A1_amount: " . $field_data['A1_amount'] . "\n";
|
||||
$data_content .= "A2_amount: " . $field_data['A2_amount'] . "\n";
|
||||
$data_content .= "A3_amount: " . $field_data['A3_amount'] . "\n";
|
||||
$data_content .= "A4_amount: " . $field_data['A4_amount'] . "\n";
|
||||
$data_content .= "A5_amount: " . $field_data['A5_amount'] . "\n\n";
|
||||
|
||||
$data_content .= "Section B - TVA due:\n";
|
||||
$data_content .= "--------------------\n";
|
||||
$data_content .= "B08_base_amount: " . $field_data['B08_base_amount'] . "\n";
|
||||
$data_content .= "B08_vat_amount: " . $field_data['B08_vat_amount'] . "\n";
|
||||
$data_content .= "B09_base_amount: " . $field_data['B09_base_amount'] . "\n";
|
||||
$data_content .= "B09_vat_amount: " . $field_data['B09_vat_amount'] . "\n";
|
||||
$data_content .= "B9B_base_amount: " . $field_data['B9B_base_amount'] . "\n";
|
||||
$data_content .= "B9B_vat_amount: " . $field_data['B9B_vat_amount'] . "\n";
|
||||
$data_content .= "B17_amount: " . $field_data['B17_amount'] . "\n\n";
|
||||
|
||||
$data_content .= "Section C - TVA déductible:\n";
|
||||
$data_content .= "----------------------------\n";
|
||||
$data_content .= "C20_amount: " . $field_data['C20_amount'] . "\n";
|
||||
$data_content .= "C21_amount: " . $field_data['C21_amount'] . "\n";
|
||||
$data_content .= "C22_amount: " . $field_data['C22_amount'] . "\n\n";
|
||||
|
||||
$data_content .= "Section D - Résultat:\n";
|
||||
$data_content .= "---------------------\n";
|
||||
$data_content .= "D25_amount: " . $field_data['D25_amount'] . "\n";
|
||||
$data_content .= "D26_amount: " . $field_data['D26_amount'] . "\n";
|
||||
$data_content .= "DTD_amount: " . $field_data['DTD_amount'] . "\n";
|
||||
$data_content .= "D28_amount: " . $field_data['D28_amount'] . "\n";
|
||||
$data_content .= "D29_amount: " . $field_data['D29_amount'] . "\n\n";
|
||||
|
||||
$data_content .= "Totals:\n";
|
||||
$data_content .= "-------\n";
|
||||
$data_content .= "total_vat_collected: " . $field_data['total_vat_collected'] . "\n";
|
||||
$data_content .= "total_vat_deductible: " . $field_data['total_vat_deductible'] . "\n";
|
||||
$data_content .= "net_vat_due: " . $field_data['net_vat_due'] . "\n";
|
||||
$data_content .= "vat_credit: " . $field_data['vat_credit'] . "\n";
|
||||
|
||||
file_put_contents($data_file, $data_content);
|
||||
|
||||
return true;
|
||||
} else {
|
||||
$this->error = 'Failed to copy template file';
|
||||
return false;
|
||||
}
|
||||
|
||||
} catch (Exception $e) {
|
||||
$this->error = 'Failed to fill PDF template: ' . $e->getMessage();
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Generate basic PDF (fallback method)
|
||||
*
|
||||
* @param string $output_path Output file path
|
||||
* @param DeclarationTVA $declaration Declaration object
|
||||
* @param array $ca3_data CA-3 line data
|
||||
* @param Societe $company Company object
|
||||
* @return bool Success
|
||||
*/
|
||||
private function generateBasicPDF($output_path, $declaration, $ca3_data, $company)
|
||||
{
|
||||
try {
|
||||
// Create a new PDF document
|
||||
$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
|
||||
@ -233,7 +753,7 @@ class DeclarationTVA_PDF
|
||||
return true;
|
||||
|
||||
} catch (Exception $e) {
|
||||
$this->error = 'PDF generation failed: ' . $e->getMessage();
|
||||
$this->error = 'Basic PDF generation failed: ' . $e->getMessage();
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@ -290,16 +810,39 @@ class DeclarationTVA_PDF
|
||||
return false;
|
||||
}
|
||||
|
||||
// Ensure template directory exists
|
||||
if (!is_dir($this->template_path)) {
|
||||
if (!dol_mkdir($this->template_path)) {
|
||||
$this->error = 'Failed to create template directory';
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// Check directory permissions
|
||||
if (!is_writable($this->template_path)) {
|
||||
$this->error = 'Template directory is not writable';
|
||||
return false;
|
||||
}
|
||||
|
||||
// Move uploaded file
|
||||
$target_path = $this->template_path . 'ca3_custom_template.pdf';
|
||||
if (!is_dir($this->template_path)) {
|
||||
dol_mkdir($this->template_path);
|
||||
|
||||
// Remove existing custom template if it exists
|
||||
if (file_exists($target_path)) {
|
||||
unlink($target_path);
|
||||
}
|
||||
|
||||
if (move_uploaded_file($file['tmp_name'], $target_path)) {
|
||||
return true;
|
||||
// Verify the file was saved correctly
|
||||
if (file_exists($target_path) && filesize($target_path) > 0) {
|
||||
return true;
|
||||
} else {
|
||||
$this->error = 'Template file was not saved correctly';
|
||||
return false;
|
||||
}
|
||||
} else {
|
||||
$this->error = 'Failed to save template';
|
||||
$last_error = error_get_last();
|
||||
$this->error = 'Failed to save template: ' . ($last_error ? $last_error['message'] : 'Unknown error');
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
@ -180,8 +180,8 @@ foreach ($ca3_lines as $line) {
|
||||
}
|
||||
|
||||
// Section A: Opérations imposables
|
||||
print '<tr class="liste_titre">';
|
||||
print '<td colspan="4"><strong>A. ' . $langs->trans("CA3SectionA") . '</strong></td>';
|
||||
print '<tr class="liste_titre" style="background-color: #1e3a8a !important;">';
|
||||
print '<td colspan="4"><strong style="text-transform: uppercase; color: #ffffff; font-weight: bold;">A. ' . $langs->trans("CA3SectionA") . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
print '<tr class="liste_titre">';
|
||||
@ -190,12 +190,12 @@ print '<th colspan="2">' . $langs->trans("Description") . '</th>';
|
||||
print '<th class="right">' . $langs->trans("Amount") . '</th>';
|
||||
print '</tr>';
|
||||
|
||||
$section_a_lines = array('A1', 'A2', 'A3', 'A4', 'A5');
|
||||
$section_a_lines = array('A1', 'A2', 'A3', 'A4', 'A5', 'E1', 'E2', 'E3', 'E4', 'E5', 'E6', 'F1', 'F2', 'F6', 'F7', 'F8');
|
||||
foreach ($section_a_lines as $line) {
|
||||
$data = isset($ca3_data[$line]) ? $ca3_data[$line] : array('line_label' => '', 'vat_amount' => 0);
|
||||
$description = isset($ca3_definitions[$line]) ? $ca3_definitions[$line]['label'] : $data['line_label'];
|
||||
print '<tr>';
|
||||
print '<td><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td style="text-align: center;"><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td colspan="2">' . $description . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['vat_amount'], $data['line_label']) . '</td>';
|
||||
print '</tr>';
|
||||
@ -214,15 +214,11 @@ foreach ($section_a_lines as $line) {
|
||||
}
|
||||
|
||||
// Section B: TVA due
|
||||
print '<tr class="liste_titre">';
|
||||
print '<td colspan="4"><strong>B. ' . $langs->trans("CA3SectionB") . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
// Special header for lines 08, 09, 9B with base and VAT columns
|
||||
print '<tr class="liste_titre">';
|
||||
print '<td colspan="4"><strong>' . $langs->trans("BaseHTAndVATByRate") . '</strong></td>';
|
||||
print '<tr class="liste_titre" style="background-color: #1e3a8a !important;">';
|
||||
print '<td colspan="4"><strong style="text-transform: uppercase; color: #ffffff; font-weight: bold;">B. ' . $langs->trans("CA3SectionB") . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
// Column headers for lines 08, 09, 9B with base and VAT columns
|
||||
print '<tr class="liste_titre">';
|
||||
print '<th>' . $langs->trans("CA3Line") . '</th>';
|
||||
print '<th>' . $langs->trans("Description") . '</th>';
|
||||
@ -235,7 +231,7 @@ foreach ($base_vat_lines as $line) {
|
||||
$data = isset($ca3_data[$line]) ? $ca3_data[$line] : array('line_label' => '', 'base_amount' => 0, 'vat_amount' => 0);
|
||||
$description = isset($ca3_definitions[$line]) ? $ca3_definitions[$line]['label'] : $data['line_label'];
|
||||
print '<tr>';
|
||||
print '<td><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td style="text-align: center;"><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td>' . $description . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['base_amount'], $data['line_label'], 'base') . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['vat_amount'], $data['line_label']) . '</td>';
|
||||
@ -257,22 +253,16 @@ foreach ($base_vat_lines as $line) {
|
||||
// Line 16: Subtotal (calculated automatically)
|
||||
$data = isset($ca3_data['16']) ? $ca3_data['16'] : array('line_label' => '', 'vat_amount' => 0);
|
||||
print '<tr class="pair" style="background-color: #ffe6e6 !important;">';
|
||||
print '<td style="background-color: #ffe6e6 !important;"><strong>16</strong></td>';
|
||||
print '<td colspan="2" style="background-color: #ffe6e6 !important;"><strong>Sous-total TVA due (08 + 09 + 9B)</strong></td>';
|
||||
print '<td style="background-color: #ffe6e6 !important; text-align: center;"><strong>16</strong></td>';
|
||||
print '<td colspan="2" style="background-color: #ffe6e6 !important;"><strong>Total de la TVA brute due (lignes 08 à 5B)</strong></td>';
|
||||
print '<td class="right" style="background-color: #ffe6e6 !important;"><strong>' . formatAmount($data['vat_amount']) . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
// Reset to normal layout for line 17
|
||||
print '<tr class="liste_titre">';
|
||||
print '<th>' . $langs->trans("CA3Line") . '</th>';
|
||||
print '<th colspan="2">' . $langs->trans("Description") . '</th>';
|
||||
print '<th class="right">' . $langs->trans("Amount") . '</th>';
|
||||
print '</tr>';
|
||||
|
||||
// Line 17
|
||||
$data = isset($ca3_data['17']) ? $ca3_data['17'] : array('line_label' => '', 'vat_amount' => 0);
|
||||
$description = isset($ca3_definitions['17']) ? $ca3_definitions['17']['label'] : $data['line_label'];
|
||||
print '<tr>';
|
||||
print '<td><a href="#" onclick="toggleDetails(\'17\'); return false;" class="butAction">17</a></td>';
|
||||
print '<td style="text-align: center;"><a href="#" onclick="toggleDetails(\'17\'); return false;" class="butAction">17</a></td>';
|
||||
print '<td colspan="2">' . $description . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['vat_amount'], $data['line_label']) . '</td>';
|
||||
print '</tr>';
|
||||
@ -289,9 +279,30 @@ print '</div>';
|
||||
print '</td>';
|
||||
print '</tr>';
|
||||
|
||||
// Section C: TVA déductible
|
||||
print '<tr class="liste_titre">';
|
||||
print '<td colspan="4"><strong>C. ' . $langs->trans("CA3SectionC") . '</strong></td>';
|
||||
// Line 18: Monaco operations
|
||||
$data = isset($ca3_data['18']) ? $ca3_data['18'] : array('line_label' => '', 'vat_amount' => 0);
|
||||
$description = isset($ca3_definitions['18']) ? $ca3_definitions['18']['label'] : $data['line_label'];
|
||||
print '<tr>';
|
||||
print '<td style="text-align: center;"><a href="#" onclick="toggleDetails(\'18\'); return false;" class="butAction">18</a></td>';
|
||||
print '<td colspan="2">' . $description . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['vat_amount'], $data['line_label']) . '</td>';
|
||||
print '</tr>';
|
||||
|
||||
// Add dropdown row for account details
|
||||
print '<tr id="details_18" style="display: none;">';
|
||||
print '<td colspan="4">';
|
||||
print '<div class="account-details">';
|
||||
print '<div class="account-details-header">' . $langs->trans("AccountBreakdown") . ' - 18</div>';
|
||||
print '<div class="account-details-content" id="content_18">';
|
||||
print '<div class="loading">' . $langs->trans("Loading") . '...</div>';
|
||||
print '</div>';
|
||||
print '</div>';
|
||||
print '</td>';
|
||||
print '</tr>';
|
||||
|
||||
// Section B sub-section: TVA DÉDUCTIBLE
|
||||
print '<tr class="liste_titre" style="background-color: #e6f3ff !important;">';
|
||||
print '<td colspan="4"><strong style="text-transform: uppercase; color: #0066cc;">TVA DÉDUCTIBLE</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
print '<tr class="liste_titre">';
|
||||
@ -300,12 +311,12 @@ print '<th colspan="2">' . $langs->trans("Description") . '</th>';
|
||||
print '<th class="right">' . $langs->trans("Amount") . '</th>';
|
||||
print '</tr>';
|
||||
|
||||
$section_c_lines = array('20', '21', '22');
|
||||
$section_c_lines = array('19', '20', '21', '22');
|
||||
foreach ($section_c_lines as $line) {
|
||||
$data = isset($ca3_data[$line]) ? $ca3_data[$line] : array('line_label' => '', 'vat_amount' => 0);
|
||||
$description = isset($ca3_definitions[$line]) ? $ca3_definitions[$line]['label'] : $data['line_label'];
|
||||
print '<tr>';
|
||||
print '<td><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td style="text-align: center;"><a href="#" onclick="toggleDetails(\'' . $line . '\'); return false;" class="butAction">' . $line . '</a></td>';
|
||||
print '<td colspan="2">' . $description . '</td>';
|
||||
print '<td class="right">' . formatAmountWithOriginal($data['vat_amount'], $data['line_label']) . '</td>';
|
||||
print '</tr>';
|
||||
@ -326,14 +337,14 @@ foreach ($section_c_lines as $line) {
|
||||
// Line 23: Subtotal (calculated automatically)
|
||||
$data = isset($ca3_data['23']) ? $ca3_data['23'] : array('line_label' => '', 'vat_amount' => 0);
|
||||
print '<tr class="pair" style="background-color: #ffe6e6 !important;">';
|
||||
print '<td style="background-color: #ffe6e6 !important;"><strong>23</strong></td>';
|
||||
print '<td colspan="2" style="background-color: #ffe6e6 !important;"><strong>Sous-total TVA déductible (20 + 21 + 22)</strong></td>';
|
||||
print '<td style="background-color: #ffe6e6 !important; text-align: center;"><strong>23</strong></td>';
|
||||
print '<td colspan="2" style="background-color: #ffe6e6 !important;"><strong>Total TVA déductible (ligne 19 à 2C)</strong></td>';
|
||||
print '<td class="right" style="background-color: #ffe6e6 !important;"><strong>' . formatAmount($data['vat_amount']) . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
// Section D: Résultat
|
||||
print '<tr class="liste_titre">';
|
||||
print '<td colspan="4"><strong>D. ' . $langs->trans("CA3SectionD") . '</strong></td>';
|
||||
print '<tr class="liste_titre" style="background-color: #e6f3ff !important;">';
|
||||
print '<td colspan="4"><strong style="text-transform: uppercase; color: #0066cc;">D. ' . $langs->trans("CA3SectionD") . '</strong></td>';
|
||||
print '</tr>';
|
||||
|
||||
print '<tr class="liste_titre">';
|
||||
@ -354,7 +365,7 @@ foreach ($section_d_lines as $line) {
|
||||
}
|
||||
|
||||
print '<tr style="background-color: #ffe6e6 !important;">';
|
||||
print '<td style="background-color: #ffe6e6 !important;"><strong>' . $line . '</strong></td>';
|
||||
print '<td style="background-color: #ffe6e6 !important; text-align: center;"><strong>' . $line . '</strong></td>';
|
||||
print '<td colspan="2" style="background-color: #ffe6e6 !important;">' . $description . '</td>';
|
||||
print '<td class="right" style="background-color: #ffe6e6 !important;">' . formatAmount($data['vat_amount']) . '</td>';
|
||||
print '</tr>';
|
||||
|
||||
334
docs/PDFTK_INSTALLATION.md
Normal file
334
docs/PDFTK_INSTALLATION.md
Normal file
@ -0,0 +1,334 @@
|
||||
# PDFTK Installation Guide
|
||||
|
||||
This guide explains how to install PDFTK (PDF Toolkit) on different operating systems to enable automatic PDF form field filling in the DeclarationTVA module.
|
||||
|
||||
## ⚠️ **IMPORTANT: Never Install PDFTK as Root**
|
||||
|
||||
**CRITICAL WARNING**: Never install PDFTK as root or with sudo. This will cause permission issues and the web server won't be able to access it. Always install PDFTK as a regular user.
|
||||
|
||||
## What is PDFTK?
|
||||
|
||||
PDFTK is a command-line tool that can manipulate PDF files, including filling form fields. It's the most reliable way to programmatically fill PDF forms.
|
||||
|
||||
## Installation by Operating System
|
||||
|
||||
### Linux (Ubuntu/Debian)
|
||||
|
||||
#### Method 1: Using apt (Recommended)
|
||||
```bash
|
||||
# Update package list
|
||||
sudo apt update
|
||||
|
||||
# Install pdftk (system-wide installation)
|
||||
sudo apt install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
**Note**: System-wide installation via apt is fine as it installs to `/usr/bin/pdftk` which is accessible to all users.
|
||||
|
||||
#### Method 2: Using snap
|
||||
```bash
|
||||
# Install via snap
|
||||
sudo snap install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
#### Method 3: Manual installation (if apt fails)
|
||||
```bash
|
||||
# Download pdftk package
|
||||
wget https://gitlab.com/pdftk-java/pdftk/-/releases/v3.3.3/downloads/pdftk-java-3.3.3-1.deb
|
||||
|
||||
# Install the package
|
||||
sudo dpkg -i pdftk-java-3.3.3-1.deb
|
||||
|
||||
# Fix any dependencies
|
||||
sudo apt-get install -f
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
**Note**: Manual installation via dpkg is also fine as it installs to system directories.
|
||||
|
||||
### Linux (CentOS/RHEL/Fedora)
|
||||
|
||||
#### Method 1: Using yum/dnf
|
||||
```bash
|
||||
# For CentOS/RHEL 7
|
||||
sudo yum install pdftk
|
||||
|
||||
# For CentOS/RHEL 8+ and Fedora
|
||||
sudo dnf install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
#### Method 2: Using snap
|
||||
```bash
|
||||
# Install snapd first (if not installed)
|
||||
sudo yum install snapd
|
||||
# or
|
||||
sudo dnf install snapd
|
||||
|
||||
# Enable snapd
|
||||
sudo systemctl enable --now snapd.socket
|
||||
|
||||
# Install pdftk
|
||||
sudo snap install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
### macOS
|
||||
|
||||
#### Method 1: Using Homebrew (Recommended)
|
||||
```bash
|
||||
# Install Homebrew if not already installed
|
||||
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||||
|
||||
# Install pdftk (installs to user directory)
|
||||
brew install pdftk-java
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
**Note**: Homebrew installs to user directories by default, which is perfect for web server access.
|
||||
|
||||
#### Method 2: Using MacPorts
|
||||
```bash
|
||||
# Install MacPorts if not already installed
|
||||
# Download from: https://www.macports.org/install.php
|
||||
|
||||
# Install pdftk
|
||||
sudo port install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
#### Method 3: Manual installation
|
||||
```bash
|
||||
# Download pdftk-java
|
||||
curl -L -o pdftk.tar.gz https://gitlab.com/pdftk-java/pdftk/-/releases/v3.3.3/downloads/pdftk-java-3.3.3-mac.zip
|
||||
|
||||
# Extract and install
|
||||
unzip pdftk.tar.gz
|
||||
sudo mv pdftk-java-3.3.3-mac/pdftk /usr/local/bin/
|
||||
sudo chmod +x /usr/local/bin/pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
### Windows
|
||||
|
||||
#### Method 1: Using Chocolatey (Recommended)
|
||||
```powershell
|
||||
# Install Chocolatey if not already installed
|
||||
# Run PowerShell as Administrator and execute:
|
||||
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
|
||||
|
||||
# Install pdftk
|
||||
choco install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
#### Method 2: Using Scoop
|
||||
```powershell
|
||||
# Install Scoop if not already installed
|
||||
# Run PowerShell and execute:
|
||||
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||
irm get.scoop.sh | iex
|
||||
|
||||
# Install pdftk
|
||||
scoop install pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
#### Method 3: Manual installation
|
||||
1. Download pdftk-java from: https://gitlab.com/pdftk-java/pdftk/-/releases
|
||||
2. Extract the ZIP file
|
||||
3. Add the extracted folder to your Windows PATH environment variable
|
||||
4. Open Command Prompt and verify: `pdftk --version`
|
||||
|
||||
### Docker
|
||||
|
||||
If you're running Dolibarr in Docker, you can install pdftk in your Docker container:
|
||||
|
||||
```dockerfile
|
||||
# Add to your Dockerfile
|
||||
RUN apt-get update && apt-get install -y pdftk
|
||||
```
|
||||
|
||||
Or run it in an existing container:
|
||||
```bash
|
||||
# Enter the container
|
||||
docker exec -it your-dolibarr-container bash
|
||||
|
||||
# Install pdftk
|
||||
apt-get update && apt-get install -y pdftk
|
||||
|
||||
# Verify installation
|
||||
pdftk --version
|
||||
```
|
||||
|
||||
## Verification
|
||||
|
||||
After installation, verify that pdftk is working:
|
||||
|
||||
```bash
|
||||
# Check if pdftk is available
|
||||
which pdftk
|
||||
|
||||
# Check version
|
||||
pdftk --version
|
||||
|
||||
# Test with a simple command
|
||||
pdftk --help
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
#### 1. "pdftk: command not found"
|
||||
- **Solution**: Make sure pdftk is in your PATH environment variable
|
||||
- **Linux/macOS**: Add `/usr/local/bin` or `/usr/bin` to your PATH
|
||||
- **Windows**: Add the pdftk installation directory to your PATH
|
||||
|
||||
#### 2. "Permission denied" errors
|
||||
- **Solution**: Make sure the pdftk executable has proper permissions
|
||||
- **Linux/macOS**: `sudo chmod +x /usr/local/bin/pdftk`
|
||||
- **Windows**: Run Command Prompt as Administrator
|
||||
|
||||
#### 3. **"Web server cannot access pdftk" (MOST COMMON)**
|
||||
- **Problem**: PDFTK installed as root, web server user cannot access it
|
||||
- **Solution**:
|
||||
- **Option A**: Reinstall as regular user (recommended)
|
||||
- **Option B**: Copy pdftk to accessible location: `sudo cp /usr/bin/pdftk /tmp/pdftk && sudo chmod +x /tmp/pdftk`
|
||||
- **Option C**: Create symbolic link: `sudo ln -s /usr/bin/pdftk /tmp/pdftk`
|
||||
|
||||
#### 4. Java-related errors
|
||||
- **Solution**: pdftk-java requires Java. Install Java if not present:
|
||||
- **Linux**: `sudo apt install openjdk-11-jre` (or similar)
|
||||
- **macOS**: `brew install openjdk@11`
|
||||
- **Windows**: Download from Oracle or use `choco install openjdk`
|
||||
|
||||
#### 5. "No such file or directory" errors
|
||||
- **Solution**: Verify the pdftk installation path and ensure it's executable
|
||||
|
||||
### Testing PDF Form Filling
|
||||
|
||||
Test if pdftk can fill your PDF forms:
|
||||
|
||||
```bash
|
||||
# Create a simple test FDF file
|
||||
echo "%FDF-1.2
|
||||
1 0 obj
|
||||
<<
|
||||
/FDF
|
||||
<<
|
||||
/Fields [
|
||||
<<
|
||||
/T (test_field)
|
||||
/V (Test Value)
|
||||
>>
|
||||
]
|
||||
>>
|
||||
>>
|
||||
endobj
|
||||
trailer
|
||||
<<
|
||||
/Root 1 0 R
|
||||
>>
|
||||
%%EOF" > test.fdf
|
||||
|
||||
# Test filling a PDF form
|
||||
pdftk your_template.pdf fill_form test.fdf output test_output.pdf
|
||||
|
||||
# Check if the output was created
|
||||
ls -la test_output.pdf
|
||||
```
|
||||
|
||||
## Module Integration
|
||||
|
||||
Once pdftk is installed, the DeclarationTVA module will automatically:
|
||||
|
||||
1. **Detect pdftk availability** using `which pdftk`
|
||||
2. **Use pdftk for form filling** when available
|
||||
3. **Fall back to manual approach** when pdftk is not available
|
||||
|
||||
## Benefits of Using PDFTK
|
||||
|
||||
- ✅ **Reliable form filling** - Actually fills PDF form fields
|
||||
- ✅ **No coordinate mapping** - Uses field names directly
|
||||
- ✅ **Layout independent** - Works with any PDF layout
|
||||
- ✅ **Professional output** - Maintains PDF structure and formatting
|
||||
- ✅ **Wide compatibility** - Works with most PDF types
|
||||
|
||||
## ⚠️ **Font Settings Limitation**
|
||||
|
||||
**Important**: PDFTK may not preserve the exact font settings of your PDF form fields. This is a limitation of the PDF form filling process, not the module. To ensure consistent formatting:
|
||||
|
||||
1. **Set all fields to the same font** in your PDF template
|
||||
2. **Use standard fonts** (Arial, Helvetica, Times) for better compatibility
|
||||
3. **Test the output** to ensure the formatting meets your requirements
|
||||
|
||||
## ✅ **Font Settings Solution**
|
||||
|
||||
**Good News**: The module now forces consistent font settings for all PDF form fields!
|
||||
|
||||
### Official Document Formatting
|
||||
|
||||
The module automatically applies professional formatting suitable for official documents:
|
||||
|
||||
- **Font:** Courier New 9pt
|
||||
- **Color:** Black
|
||||
- **Alignment:** Left-aligned
|
||||
- **Consistent formatting** across all form fields
|
||||
|
||||
### Benefits:
|
||||
|
||||
1. **Professional appearance** suitable for official documents
|
||||
2. **Consistent formatting** across all form fields
|
||||
3. **No font inconsistencies** between different fields
|
||||
4. **Standardized layout** for government submissions
|
||||
|
||||
## Alternative Solutions
|
||||
|
||||
If you cannot install pdftk, the module provides:
|
||||
|
||||
1. **Manual filling approach** - Generates data files for manual PDF filling
|
||||
2. **Template copying** - Provides the original PDF template
|
||||
3. **Data reference** - Comprehensive data files with all values
|
||||
|
||||
## Support
|
||||
|
||||
For issues with pdftk installation:
|
||||
|
||||
1. **Check the official documentation**: https://gitlab.com/pdftk-java/pdftk
|
||||
2. **Verify system requirements**: Java 8+ is required for pdftk-java
|
||||
3. **Test with simple PDFs** before using complex forms
|
||||
4. **Check file permissions** and PATH environment variables
|
||||
|
||||
## Security Notes
|
||||
|
||||
- **File permissions**: Ensure pdftk has appropriate permissions
|
||||
- **Temporary files**: The module cleans up temporary FDF files automatically
|
||||
- **Path validation**: The module validates file paths before processing
|
||||
- **Error handling**: Comprehensive error handling for security
|
||||
|
||||
---
|
||||
|
||||
**Note**: This module cannot automatically install pdftk due to system security restrictions. Manual installation is required as described above.
|
||||
@ -332,29 +332,46 @@ DeclarationTVAProductAnalysis = Product Analysis
|
||||
DeclarationTVASeasonalAnalysis = Seasonal Analysis
|
||||
|
||||
# CA-3 Section Headers (Notice 4722)
|
||||
CA3SectionA = Taxable Operations
|
||||
CA3SectionB = VAT Due Calculation
|
||||
CA3SectionC = Deductible VAT Calculation
|
||||
CA3SectionD = Result
|
||||
CA3SectionA = MONTANT DES OPÉRATIONS RÉALISÉES
|
||||
CA3SectionB = DÉCOMPTE DE LA TVA À PAYER
|
||||
CA3SectionD = RÉSULTAT
|
||||
CA3Notice4722 = Notice 4722 - Summary Table CA3 (3310-CA3-SD)
|
||||
|
||||
# CA-3 Line Labels (Notice 4722)
|
||||
CA3LineA1 = HT amount of all taxable operations that form normal sales (goods + services taxable in France at 20%, 10%, 5,5%, 2,1%)
|
||||
CA3LineA2 = HT amount of special taxable operations not part of ordinary turnover (e.g. cessions d'immobilisations, livraisons à soi-même)
|
||||
CA3LineA3 = HT amount of services purchased from providers not established in France but taxable in France (reverse charge for foreign services)
|
||||
CA3LineA4 = HT amount of imports taxable in France (non-EU), excluding petroleum products
|
||||
CA3LineA5 = HT amount of taxable operations at exit from a suspensive fiscal regime (customs regimes, free zones, etc.)
|
||||
CA3LineA1 = Ventes, prestations de services
|
||||
CA3LineA2 = Autres opérations imposables
|
||||
CA3LineA3 = Achats de prestations de services réalisés auprès d'un assujetti non établi en France (article 283-2 du code général des impôts)
|
||||
CA3LineA4 = Importations (autres que les produits pétroliers)
|
||||
CA3LineA5 = Sorties de régime fiscal suspensif (autres que les produits pétroliers) et sorties de régime particulier douanier uniquement lorsque des livraisons ont eu lieu en cours de régime
|
||||
|
||||
# Section A - Export and Non-Taxable Operations
|
||||
CA3LineE1 = Exportations hors UE
|
||||
CA3LineE2 = Autres opérations non imposables
|
||||
CA3LineE3 = Ventes à distance taxables dans un autre État membre au profit des personnes non assujetties – Ventes B to C
|
||||
CA3LineE4 = Importations (autres que les produits pétroliers)
|
||||
CA3LineE5 = Sorties de régime fiscal suspensif (autres que les produits pétroliers)
|
||||
CA3LineE6 = Importations placées sous régime fiscal suspensif (autres que les produits pétroliers)
|
||||
|
||||
# Section A - Intracom Operations
|
||||
CA3LineF1 = Acquisitions intracommunautaires
|
||||
CA3LineF2 = Livraisons intracommunautaires à destination d'une personne assujettie – Ventes B to B
|
||||
CA3LineF6 = Achats en franchise
|
||||
CA3LineF7 = Ventes de biens ou prestations de services réalisées par un assujetti non établi en France (article 283-1 du code général des impôts)
|
||||
CA3LineF8 = Régularisations (important : cf. notice)
|
||||
|
||||
# Section B - VAT Due Calculation
|
||||
CA3Line08 = VAT due at 20% rate
|
||||
CA3Line09 = VAT due at 10% rate
|
||||
CA3Line9B = VAT due at reduced rates (5,5% and 2,1%)
|
||||
CA3Line17 = VAT due on intra-EU acquisitions (autoliquidation)
|
||||
CA3Line18 = Dont TVA sur opérations à destination de Monaco
|
||||
CA3Line19 = Biens constituant des immobilisations
|
||||
CA3Line20 = Autres biens et services
|
||||
|
||||
# Section B - Additional Deductible VAT Lines
|
||||
CA3Line21 = Autre TVA à déduire
|
||||
CA3Line22 = Report du crédit apparaissant ligne 27 de la précédente déclaration
|
||||
|
||||
# Section C - Deductible VAT Calculation
|
||||
CA3Line20 = Deductible VAT on fixed assets
|
||||
CA3Line21 = Deductible VAT on other goods and services
|
||||
CA3Line22 = Deductible VAT on imports
|
||||
|
||||
# Section D - Result
|
||||
CA3Line25 = Total VAT due
|
||||
|
||||
@ -103,9 +103,22 @@ INSERT INTO `llx_declarationtva_account_mappings` (`entity`, `ca3_line`, `accoun
|
||||
(1, 'B3', '445730', 'TVA collectée 5.5%', 5.50, NOW()),
|
||||
(1, 'B4', '445740', 'TVA collectée 2.1%', 2.10, NOW()),
|
||||
(1, '17', '445200', 'TVA due intra-EU', 20.00, NOW()),
|
||||
(1, '20', '445620', 'TVA déductible immobilisations', 20.00, NOW()),
|
||||
(1, '18', '445200', 'TVA due Monaco', 20.00, NOW()),
|
||||
(1, '19', '445620', 'TVA déductible immobilisations', 20.00, NOW()),
|
||||
(1, '20', '445660', 'TVA déductible autres', 20.00, NOW()),
|
||||
(1, '21', '445660', 'TVA déductible autres', 20.00, NOW()),
|
||||
(1, '22', '445670', 'Crédit TVA', 0.00, NOW()),
|
||||
(1, 'E1', '701000', 'Exportations hors UE', 0.00, NOW()),
|
||||
(1, 'E2', '701000', 'Autres opérations non imposables', 0.00, NOW()),
|
||||
(1, 'E3', '701000', 'Ventes à distance B to C', 0.00, NOW()),
|
||||
(1, 'E4', '601000', 'Importations (autres que produits pétroliers)', 0.00, NOW()),
|
||||
(1, 'E5', '601000', 'Sorties régime fiscal suspensif', 0.00, NOW()),
|
||||
(1, 'E6', '601000', 'Importations régime fiscal suspensif', 0.00, NOW()),
|
||||
(1, 'F1', '601000', 'Acquisitions intra-EU HT', 0.00, NOW()),
|
||||
(1, 'F2', '445200', 'TVA due autoliquidée intra-EU', 20.00, NOW()),
|
||||
(1, 'F6', '601000', 'Achats en franchise', 0.00, NOW()),
|
||||
(1, 'F7', '701000', 'Ventes non établi France', 0.00, NOW()),
|
||||
(1, 'F8', '445000', 'Régularisations', 0.00, NOW()),
|
||||
(1, '28', '445510', 'TVA nette à payer', 0.00, NOW()),
|
||||
(1, '29', '445670', 'Crédit TVA à reporter', 0.00, NOW());
|
||||
|
||||
|
||||
@ -23,7 +23,7 @@ CREATE TABLE IF NOT EXISTS `llx_declarationtva_config` (
|
||||
CREATE TABLE IF NOT EXISTS `llx_declarationtva_account_mappings` (
|
||||
`rowid` int(11) NOT NULL AUTO_INCREMENT,
|
||||
`entity` int(11) NOT NULL DEFAULT 1,
|
||||
`ca3_line` varchar(8) NOT NULL COMMENT 'A1, A2, A3, A4, A5, 08, 09, 9B, 17, 20, 21, 22, 25, 26, 28, 29',
|
||||
`ca3_line` varchar(8) NOT NULL COMMENT 'A1, A2, A3, A4, A5, E1, E2, E3, E4, E5, E6, F1, F2, F6, F7, F8, 08, 09, 9B, 17, 18, 19, 20, 21, 22, 25, 26, 28, 29',
|
||||
`account_code` varchar(32) NOT NULL COMMENT 'PCG account code',
|
||||
`account_label` varchar(255) DEFAULT NULL,
|
||||
`vat_rate` decimal(5,2) DEFAULT NULL,
|
||||
@ -103,9 +103,22 @@ INSERT INTO `llx_declarationtva_account_mappings` (`entity`, `ca3_line`, `accoun
|
||||
(1, 'B3', '445730', 'TVA collectée 5.5%', 5.50, NOW()),
|
||||
(1, 'B4', '445740', 'TVA collectée 2.1%', 2.10, NOW()),
|
||||
(1, '17', '445200', 'TVA due intra-EU', 20.00, NOW()),
|
||||
(1, '20', '445620', 'TVA déductible immobilisations', 20.00, NOW()),
|
||||
(1, '18', '445200', 'TVA due Monaco', 20.00, NOW()),
|
||||
(1, '19', '445620', 'TVA déductible immobilisations', 20.00, NOW()),
|
||||
(1, '20', '445660', 'TVA déductible autres', 20.00, NOW()),
|
||||
(1, '21', '445660', 'TVA déductible autres', 20.00, NOW()),
|
||||
(1, '22', '445670', 'Crédit TVA', 0.00, NOW()),
|
||||
(1, 'E1', '701000', 'Exportations hors UE', 0.00, NOW()),
|
||||
(1, 'E2', '701000', 'Autres opérations non imposables', 0.00, NOW()),
|
||||
(1, 'E3', '701000', 'Ventes à distance B to C', 0.00, NOW()),
|
||||
(1, 'E4', '601000', 'Importations (autres que produits pétroliers)', 0.00, NOW()),
|
||||
(1, 'E5', '601000', 'Sorties régime fiscal suspensif', 0.00, NOW()),
|
||||
(1, 'E6', '601000', 'Importations régime fiscal suspensif', 0.00, NOW()),
|
||||
(1, 'F1', '601000', 'Acquisitions intra-EU HT', 0.00, NOW()),
|
||||
(1, 'F2', '445200', 'TVA due autoliquidée intra-EU', 20.00, NOW()),
|
||||
(1, 'F6', '601000', 'Achats en franchise', 0.00, NOW()),
|
||||
(1, 'F7', '701000', 'Ventes non établi France', 0.00, NOW()),
|
||||
(1, 'F8', '445000', 'Régularisations', 0.00, NOW()),
|
||||
(1, '28', '445510', 'TVA nette à payer', 0.00, NOW()),
|
||||
(1, '29', '445670', 'Crédit TVA à reporter', 0.00, NOW());
|
||||
|
||||
|
||||
242
templates/CA3_FIELD_NAMING.md
Normal file
242
templates/CA3_FIELD_NAMING.md
Normal file
@ -0,0 +1,242 @@
|
||||
# CA-3 Fillable PDF Field Naming Convention
|
||||
|
||||
This document provides the complete field naming convention for creating a fillable CA-3 PDF template that integrates seamlessly with the DeclarationTVA module.
|
||||
|
||||
## 🎯 **Field Naming Strategy**
|
||||
|
||||
### **📋 Company Information Fields**
|
||||
```
|
||||
company_name
|
||||
company_address
|
||||
company_city
|
||||
company_postal_code
|
||||
company_siret
|
||||
declaration_period_start
|
||||
declaration_period_end
|
||||
declaration_number
|
||||
```
|
||||
|
||||
### **📊 Section A: Opérations imposables**
|
||||
```
|
||||
A1_amount
|
||||
A2_amount
|
||||
A3_amount
|
||||
A4_amount
|
||||
A5_amount
|
||||
```
|
||||
|
||||
### **📊 Section B: TVA due (Base + VAT columns)**
|
||||
```
|
||||
B08_base_amount
|
||||
B08_vat_amount
|
||||
B09_base_amount
|
||||
B09_vat_amount
|
||||
B9B_base_amount
|
||||
B9B_vat_amount
|
||||
B17_amount
|
||||
```
|
||||
|
||||
### **📊 Section C: TVA déductible**
|
||||
```
|
||||
C20_amount
|
||||
C21_amount
|
||||
C22_amount
|
||||
```
|
||||
|
||||
### **📊 Section D: Résultat (Calculated)**
|
||||
```
|
||||
D25_amount
|
||||
D26_amount
|
||||
DTD_amount
|
||||
D28_amount
|
||||
D29_amount
|
||||
```
|
||||
|
||||
### **📊 Subtotals (For Reference)**
|
||||
```
|
||||
subtotal_B16_amount # Subtotal of B08+B09+B9B VAT
|
||||
subtotal_C23_amount # Subtotal of C20+C21+C22
|
||||
```
|
||||
|
||||
### **📊 Grand Totals**
|
||||
```
|
||||
total_vat_collected
|
||||
total_vat_deductible
|
||||
net_vat_due
|
||||
vat_credit
|
||||
```
|
||||
|
||||
## 📋 **Complete Field List for PDF Creation**
|
||||
|
||||
### **Company Information Section**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `company_name` | Company name | Text | - |
|
||||
| `company_address` | Company address | Text | - |
|
||||
| `company_city` | City | Text | - |
|
||||
| `company_postal_code` | Postal code | Text | - |
|
||||
| `company_siret` | SIRET number | Text | - |
|
||||
| `declaration_period_start` | Period start date | Date | DD/MM/YYYY |
|
||||
| `declaration_period_end` | Period end date | Date | DD/MM/YYYY |
|
||||
| `declaration_number` | Declaration number | Text | - |
|
||||
|
||||
### **Section A: Opérations imposables**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `A1_amount` | Line A1 amount | Currency | € 0.00 |
|
||||
| `A2_amount` | Line A2 amount | Currency | € 0.00 |
|
||||
| `A3_amount` | Line A3 amount | Currency | € 0.00 |
|
||||
| `A4_amount` | Line A4 amount | Currency | € 0.00 |
|
||||
| `A5_amount` | Line A5 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section B: TVA due**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `B08_base_amount` | Line 08 base amount | Currency | € 0.00 |
|
||||
| `B08_vat_amount` | Line 08 VAT amount | Currency | € 0.00 |
|
||||
| `B09_base_amount` | Line 09 base amount | Currency | € 0.00 |
|
||||
| `B09_vat_amount` | Line 09 VAT amount | Currency | € 0.00 |
|
||||
| `B9B_base_amount` | Line 9B base amount | Currency | € 0.00 |
|
||||
| `B9B_vat_amount` | Line 9B VAT amount | Currency | € 0.00 |
|
||||
| `B17_amount` | Line 17 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section C: TVA déductible**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `C20_amount` | Line 20 amount | Currency | € 0.00 |
|
||||
| `C21_amount` | Line 21 amount | Currency | € 0.00 |
|
||||
| `C22_amount` | Line 22 amount | Currency | € 0.00 |
|
||||
|
||||
### **Section D: Résultat (Calculated)**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `D25_amount` | Line 25 amount | Currency | € 0.00 |
|
||||
| `D26_amount` | Line 26 amount | Currency | € 0.00 |
|
||||
| `DTD_amount` | Line TD amount | Currency | € 0.00 |
|
||||
| `D28_amount` | Line 28 amount | Currency | € 0.00 |
|
||||
| `D29_amount` | Line 29 amount | Currency | € 0.00 |
|
||||
|
||||
### **Subtotals (For Reference)**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `subtotal_B16_amount` | Subtotal B08+B09+B9B VAT | Currency | € 0.00 |
|
||||
| `subtotal_C23_amount` | Subtotal C20+C21+C22 | Currency | € 0.00 |
|
||||
|
||||
### **Grand Totals**
|
||||
| Field Name | Description | Type | Format |
|
||||
|------------|-------------|------|--------|
|
||||
| `total_vat_collected` | Total VAT collected | Currency | € 0.00 |
|
||||
| `total_vat_deductible` | Total VAT deductible | Currency | € 0.00 |
|
||||
| `net_vat_due` | Net VAT due | Currency | € 0.00 |
|
||||
| `vat_credit` | VAT credit | Currency | € 0.00 |
|
||||
|
||||
## 🔧 **Integration Code Example**
|
||||
|
||||
```php
|
||||
// In DeclarationTVA_PDF::fillPDFTemplate method
|
||||
$field_mapping = array(
|
||||
// Company information
|
||||
'company_name' => $company->name,
|
||||
'company_address' => $company->address,
|
||||
'company_city' => $company->town,
|
||||
'company_postal_code' => $company->zip,
|
||||
'company_siret' => $company->idprof2, // SIRET
|
||||
'declaration_period_start' => dol_print_date($declaration->start_date, 'day'),
|
||||
'declaration_period_end' => dol_print_date($declaration->end_date, 'day'),
|
||||
'declaration_number' => $declaration->declaration_number,
|
||||
|
||||
// Section A
|
||||
'A1_amount' => $ca3_data['A1']['vat_amount'],
|
||||
'A2_amount' => $ca3_data['A2']['vat_amount'],
|
||||
'A3_amount' => $ca3_data['A3']['vat_amount'],
|
||||
'A4_amount' => $ca3_data['A4']['vat_amount'],
|
||||
'A5_amount' => $ca3_data['A5']['vat_amount'],
|
||||
|
||||
// Section B
|
||||
'B08_base_amount' => $ca3_data['08']['base_amount'],
|
||||
'B08_vat_amount' => $ca3_data['08']['vat_amount'],
|
||||
'B09_base_amount' => $ca3_data['09']['base_amount'],
|
||||
'B09_vat_amount' => $ca3_data['09']['vat_amount'],
|
||||
'B9B_base_amount' => $ca3_data['9B']['base_amount'],
|
||||
'B9B_vat_amount' => $ca3_data['9B']['vat_amount'],
|
||||
'B17_amount' => $ca3_data['17']['vat_amount'],
|
||||
|
||||
// Section C
|
||||
'C20_amount' => $ca3_data['20']['vat_amount'],
|
||||
'C21_amount' => $ca3_data['21']['vat_amount'],
|
||||
'C22_amount' => $ca3_data['22']['vat_amount'],
|
||||
|
||||
// Section D
|
||||
'D25_amount' => $ca3_data['25']['vat_amount'],
|
||||
'D26_amount' => $ca3_data['26']['vat_amount'],
|
||||
'DTD_amount' => $ca3_data['TD']['vat_amount'],
|
||||
'D28_amount' => $ca3_data['28']['vat_amount'],
|
||||
'D29_amount' => $ca3_data['29']['vat_amount'],
|
||||
|
||||
// Subtotals
|
||||
'subtotal_B16_amount' => $ca3_data['16']['vat_amount'],
|
||||
'subtotal_C23_amount' => $ca3_data['23']['vat_amount'],
|
||||
|
||||
// Grand totals
|
||||
'total_vat_collected' => $declaration->total_vat_collected,
|
||||
'total_vat_deductible' => $declaration->total_vat_deductible,
|
||||
'net_vat_due' => $declaration->net_vat_due,
|
||||
'vat_credit' => $declaration->vat_credit,
|
||||
);
|
||||
```
|
||||
|
||||
## 🎯 **Field Properties Recommendations**
|
||||
|
||||
### **Text Fields**
|
||||
- **Type**: Text field
|
||||
- **Alignment**: Left-aligned
|
||||
- **Font**: Arial, 10pt
|
||||
- **Background**: White
|
||||
|
||||
### **Amount Fields**
|
||||
- **Type**: Text field with currency format
|
||||
- **Alignment**: Right-aligned
|
||||
- **Font**: Arial, 10pt, Bold
|
||||
- **Format**: € 0.00
|
||||
- **Background**: White
|
||||
|
||||
### **Date Fields**
|
||||
- **Type**: Text field
|
||||
- **Format**: DD/MM/YYYY
|
||||
- **Alignment**: Center
|
||||
- **Font**: Arial, 10pt
|
||||
|
||||
### **Read-Only Fields (Calculated)**
|
||||
- **Type**: Text field
|
||||
- **Read-only**: Yes
|
||||
- **Background**: Light gray (#F5F5F5)
|
||||
- **Font**: Arial, 10pt, Bold
|
||||
|
||||
## 📋 **PDF Creation Checklist**
|
||||
|
||||
- [ ] Create fillable PDF with all field names listed above
|
||||
- [ ] Set proper field types and formats
|
||||
- [ ] Test field tab order
|
||||
- [ ] Verify field positioning matches official form
|
||||
- [ ] Test PDF form filling with sample data
|
||||
- [ ] Validate field names match exactly (case-sensitive)
|
||||
- [ ] Ensure all fields are properly named and positioned
|
||||
- [ ] Test PDF generation with module integration
|
||||
|
||||
## 🚀 **Benefits of This Naming Convention**
|
||||
|
||||
- ✅ **Easy Integration**: Direct mapping to module data
|
||||
- ✅ **Maintainable**: Clear, logical field names
|
||||
- ✅ **Extensible**: Easy to add new fields
|
||||
- ✅ **Professional**: Consistent naming across all fields
|
||||
- ✅ **Future-Proof**: Compatible with form updates
|
||||
|
||||
## 📝 **Notes**
|
||||
|
||||
- All field names are **case-sensitive**
|
||||
- Field names must **exactly match** the convention above
|
||||
- Use **underscores** for multi-word field names
|
||||
- Keep field names **descriptive** but **concise**
|
||||
- Test thoroughly with the module integration
|
||||
|
||||
This naming convention ensures seamless integration between the fillable PDF and the DeclarationTVA module!
|
||||
BIN
templates/declarationtva/ca3_custom_template.pdf
Normal file
BIN
templates/declarationtva/ca3_custom_template.pdf
Normal file
Binary file not shown.
150
test_pdftk.php
Normal file
150
test_pdftk.php
Normal file
@ -0,0 +1,150 @@
|
||||
<?php
|
||||
/**
|
||||
* PDFTK Test Script
|
||||
* This script tests if pdftk is properly installed and working
|
||||
*/
|
||||
|
||||
// Load Dolibarr environment
|
||||
if (file_exists('../../main.inc.php')) {
|
||||
$res = @include '../../main.inc.php';
|
||||
} elseif (file_exists('../../../main.inc.php')) {
|
||||
$res = @include '../../../main.inc.php';
|
||||
} else {
|
||||
$res = 0;
|
||||
}
|
||||
|
||||
if (!$res) {
|
||||
die("Include of main fails");
|
||||
}
|
||||
|
||||
echo "<h2>PDFTK Installation Test</h2>";
|
||||
|
||||
// Test 1: Check if pdftk is available
|
||||
echo "<h3>1. Checking PDFTK Availability</h3>";
|
||||
$pdftk_path = shell_exec('which pdftk 2>/dev/null');
|
||||
if (!empty(trim($pdftk_path))) {
|
||||
echo "<p>✅ PDFTK found at: " . trim($pdftk_path) . "</p>";
|
||||
} else {
|
||||
echo "<p>❌ PDFTK not found. Please install PDFTK first.</p>";
|
||||
echo "<p>See installation guide: <a href='docs/PDFTK_INSTALLATION.md'>PDFTK_INSTALLATION.md</a></p>";
|
||||
exit;
|
||||
}
|
||||
|
||||
// Test 2: Check pdftk version
|
||||
echo "<h3>2. Checking PDFTK Version</h3>";
|
||||
$version = shell_exec('pdftk --version 2>&1');
|
||||
if (!empty($version)) {
|
||||
echo "<p>✅ PDFTK version: " . trim($version) . "</p>";
|
||||
} else {
|
||||
echo "<p>❌ Could not get PDFTK version</p>";
|
||||
}
|
||||
|
||||
// Test 3: Check if custom template exists
|
||||
echo "<h3>3. Checking Custom Template</h3>";
|
||||
$custom_template = DOL_DOCUMENT_ROOT.'/custom/declarationtva/templates/declarationtva/ca3_custom_template.pdf';
|
||||
if (file_exists($custom_template)) {
|
||||
echo "<p>✅ Custom template found: " . basename($custom_template) . "</p>";
|
||||
} else {
|
||||
echo "<p>❌ Custom template not found. Please upload your fillable PDF first.</p>";
|
||||
exit;
|
||||
}
|
||||
|
||||
// Test 4: Test PDF form field detection
|
||||
echo "<h3>4. Testing PDF Form Field Detection</h3>";
|
||||
$command = "pdftk \"$custom_template\" dump_data_fields 2>&1";
|
||||
$fields_output = shell_exec($command);
|
||||
|
||||
if (!empty($fields_output) && strpos($fields_output, 'FieldName:') !== false) {
|
||||
echo "<p>✅ PDF form fields detected:</p>";
|
||||
echo "<pre>" . htmlspecialchars($fields_output) . "</pre>";
|
||||
} else {
|
||||
echo "<p>❌ No form fields detected or error occurred:</p>";
|
||||
echo "<pre>" . htmlspecialchars($fields_output) . "</pre>";
|
||||
}
|
||||
|
||||
// Test 5: Create a test FDF file
|
||||
echo "<h3>5. Testing FDF File Creation</h3>";
|
||||
$test_fdf = sys_get_temp_dir() . '/test_ca3_' . uniqid() . '.fdf';
|
||||
$fdf_content = "%FDF-1.2\n";
|
||||
$fdf_content .= "1 0 obj\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/FDF\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/Fields [\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/T (company_name)\n";
|
||||
$fdf_content .= "/V (Test Company)\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/T (A1_amount)\n";
|
||||
$fdf_content .= "/V (1234.56)\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "]\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "endobj\n";
|
||||
$fdf_content .= "trailer\n";
|
||||
$fdf_content .= "<<\n";
|
||||
$fdf_content .= "/Root 1 0 R\n";
|
||||
$fdf_content .= ">>\n";
|
||||
$fdf_content .= "%%EOF\n";
|
||||
|
||||
if (file_put_contents($test_fdf, $fdf_content)) {
|
||||
echo "<p>✅ Test FDF file created: " . basename($test_fdf) . "</p>";
|
||||
} else {
|
||||
echo "<p>❌ Failed to create FDF file</p>";
|
||||
exit;
|
||||
}
|
||||
|
||||
// Test 6: Test PDF form filling
|
||||
echo "<h3>6. Testing PDF Form Filling</h3>";
|
||||
$test_output = sys_get_temp_dir() . '/test_output_' . uniqid() . '.pdf';
|
||||
$command = "pdftk \"$custom_template\" fill_form \"$test_fdf\" output \"$test_output\" 2>&1";
|
||||
$result = shell_exec($command);
|
||||
|
||||
if (file_exists($test_output) && filesize($test_output) > 0) {
|
||||
echo "<p>✅ PDF form filling successful!</p>";
|
||||
echo "<p>Output file: " . basename($test_output) . " (" . filesize($test_output) . " bytes)</p>";
|
||||
|
||||
// Clean up test files
|
||||
unlink($test_fdf);
|
||||
unlink($test_output);
|
||||
} else {
|
||||
echo "<p>❌ PDF form filling failed:</p>";
|
||||
echo "<pre>" . htmlspecialchars($result) . "</pre>";
|
||||
|
||||
// Clean up test files
|
||||
if (file_exists($test_fdf)) unlink($test_fdf);
|
||||
if (file_exists($test_output)) unlink($test_output);
|
||||
}
|
||||
|
||||
// Test 7: Check module integration
|
||||
echo "<h3>7. Module Integration Test</h3>";
|
||||
try {
|
||||
// Test the module's pdftk detection
|
||||
$pdf_class = new DeclarationTVA_PDF($db);
|
||||
$reflection = new ReflectionClass($pdf_class);
|
||||
$method = $reflection->getMethod('isPdftkAvailable');
|
||||
$method->setAccessible(true);
|
||||
$is_available = $method->invoke($pdf_class);
|
||||
|
||||
if ($is_available) {
|
||||
echo "<p>✅ Module can detect PDFTK</p>";
|
||||
} else {
|
||||
echo "<p>❌ Module cannot detect PDFTK</p>";
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
echo "<p>❌ Module integration test failed: " . $e->getMessage() . "</p>";
|
||||
}
|
||||
|
||||
echo "<h3>Summary</h3>";
|
||||
echo "<p>If all tests pass, PDFTK is properly installed and the module should work correctly.</p>";
|
||||
echo "<p>If any tests fail, please check the installation guide and troubleshoot accordingly.</p>";
|
||||
|
||||
echo "<h3>Next Steps</h3>";
|
||||
echo "<ol>";
|
||||
echo "<li>Try the PDF export functionality in the module</li>";
|
||||
echo "<li>Check if form fields are properly filled</li>";
|
||||
echo "<li>Verify the output PDF contains the expected data</li>";
|
||||
echo "</ol>";
|
||||
?>
|
||||
Loading…
Reference in New Issue
Block a user