1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/* |
4
|
|
|
* Copyright (c) 2024 - 2025 Daniel Popiniuc. |
5
|
|
|
* All rights reserved. This program and the accompanying materials |
6
|
|
|
* are made available under the terms of the Eclipse Public License v1.0 |
7
|
|
|
* which accompanies this distribution, and is available at |
8
|
|
|
* http://www.eclipse.org/legal/epl-v10.html |
9
|
|
|
* |
10
|
|
|
* Contributors: |
11
|
|
|
* Daniel Popiniuc |
12
|
|
|
*/ |
13
|
|
|
|
14
|
|
|
namespace danielgp\efactura; |
15
|
|
|
|
16
|
|
|
trait TraitVersions |
17
|
|
|
{ |
18
|
|
|
use TraitBasic; |
19
|
|
|
|
20
|
16 |
|
private function establishCurrentVersion(array $arrayKnownVersions): array |
21
|
|
|
{ |
22
|
16 |
|
$arrayVersionToReturn = []; |
23
|
16 |
|
foreach ($arrayKnownVersions as $value) { |
24
|
16 |
|
$dtValidityStart = new \DateTime($value['Validity']['Start']); |
25
|
16 |
|
$dtValidityEnd = new \DateTime($value['Validity']['End']); |
26
|
16 |
|
$dtValidityNow = new \DateTime(); |
27
|
16 |
|
if (($dtValidityNow >= $dtValidityStart) && ($dtValidityNow <= $dtValidityEnd)) { |
28
|
16 |
|
$arrayVersionToReturn = [ |
29
|
16 |
|
'UBL' => $value['UBL'], |
30
|
16 |
|
'CIUS-RO' => $value['CIUS-RO'], |
31
|
16 |
|
]; |
32
|
|
|
} |
33
|
|
|
} |
34
|
16 |
|
return $arrayVersionToReturn; |
35
|
|
|
} |
36
|
|
|
|
37
|
16 |
|
private function getDefaultsIntoDataSet(array $arrayDocumentData, bool $bolSchemaLocation): array |
38
|
|
|
{ |
39
|
16 |
|
$arrayVersions = $this->establishCurrentVersion($this->arraySettings['Versions']); |
40
|
16 |
|
$arrayOutput = []; |
41
|
16 |
|
if (!array_key_exists('DocumentNameSpaces', $arrayDocumentData)) { |
42
|
3 |
|
$arrayOutput = [ |
43
|
3 |
|
'Root' => [ |
44
|
3 |
|
'DocumentNameSpaces' => $this->arraySettings['Defaults']['DocumentNameSpaces'], |
45
|
3 |
|
], |
46
|
3 |
|
'UBL' => $arrayVersions['UBL'], |
47
|
3 |
|
'CIUS-RO' => $arrayVersions['CIUS-RO'], |
48
|
3 |
|
]; |
49
|
|
|
} |
50
|
16 |
|
if ($bolSchemaLocation && !array_key_exists('SchemaLocation', $arrayDocumentData)) { |
51
|
1 |
|
$arrayOutput['Root']['SchemaLocation'] = vsprintf($this->arraySettings['Defaults']['SchemaLocation'], [ |
52
|
1 |
|
$arrayDocumentData['DocumentTagName'], |
53
|
1 |
|
$arrayVersions['UBL'], |
54
|
1 |
|
$arrayDocumentData['DocumentTagName'], |
55
|
1 |
|
$arrayVersions['UBL'], |
56
|
1 |
|
]); |
57
|
|
|
} |
58
|
16 |
|
return $arrayOutput; |
59
|
|
|
} |
60
|
|
|
|
61
|
16 |
|
private function getSettingsFromFileIntoMemory(bool $bolComments): void |
62
|
|
|
{ |
63
|
16 |
|
$this->loadSettingsFromFile(); |
64
|
16 |
|
$this->getHierarchyTagOrder(); |
65
|
16 |
|
$this->arraySettings['Comments'] = [ |
66
|
16 |
|
'CAC' => [], |
67
|
16 |
|
'CBC' => [], |
68
|
16 |
|
]; |
69
|
16 |
|
if ($bolComments) { |
70
|
2 |
|
$this->getCommentsFromFileIntoSetting(); |
71
|
|
|
} |
72
|
|
|
} |
73
|
|
|
|
74
|
2 |
|
private function getCommentsFromFileIntoSetting(): void |
75
|
|
|
{ |
76
|
2 |
|
$strGlue = ' | '; |
77
|
2 |
|
$arrayFlattComments = []; |
78
|
2 |
|
$arrayComments = $this->getCommentsFromFileAsArray(); |
79
|
2 |
|
foreach ($arrayComments as $key => $value) { |
80
|
2 |
|
$strComment = implode($strGlue, [ |
81
|
2 |
|
$key, |
82
|
2 |
|
$value['OperationalTerm']['ro_RO'], |
83
|
2 |
|
$value['RequirementID'], |
84
|
2 |
|
]) |
85
|
2 |
|
. (array_key_exists('SemanticDataType', $value) ? $strGlue . $value['SemanticDataType'] : ''); |
86
|
2 |
|
if (is_array($value['HierarchycalTagName'])) { |
87
|
2 |
|
foreach ($value['HierarchycalTagName'] as $value2) { |
88
|
2 |
|
$arrayFlattComments[$value2] = $strComment; |
89
|
|
|
} |
90
|
|
|
} else { |
91
|
2 |
|
$arrayFlattComments[$value['HierarchycalTagName']] = $strComment; |
92
|
|
|
} |
93
|
|
|
} |
94
|
2 |
|
$this->arraySettings['Comments'] = $arrayFlattComments; |
95
|
|
|
} |
96
|
|
|
|
97
|
16 |
|
private function loadSettingsAndManageDefaults(array $arrayData, array $arrayFeatures): array |
98
|
|
|
{ |
99
|
|
|
// if no DocumentNameSpaces seen take Default ones from local configuration |
100
|
16 |
|
$this->getSettingsFromFileIntoMemory($arrayFeatures['Comments']); |
101
|
16 |
|
$arrayDefaults = $this->getDefaultsIntoDataSet($arrayData, $arrayFeatures['SchemaLocation']); |
102
|
16 |
|
if ($arrayDefaults !== []) { |
103
|
3 |
|
$arrayData = array_merge($arrayData, $arrayDefaults['Root']); |
104
|
3 |
|
if (!array_key_exists('CustomizationID', $arrayData['Header']['CommonBasicComponents-2'])) { |
105
|
3 |
|
$arrayData['Header']['CommonBasicComponents-2']['CustomizationID'] = 'urn:cen.eu:en16931:2017' |
106
|
3 |
|
. '#compliant#urn:efactura.mfinante.ro:CIUS-RO:' . $arrayDefaults['CIUS-RO']; |
107
|
3 |
|
$arrayData['Header']['CommonBasicComponents-2']['UBLVersionID'] = $arrayDefaults['UBL']; |
108
|
|
|
} |
109
|
|
|
} |
110
|
16 |
|
return $arrayData; |
111
|
|
|
} |
112
|
|
|
|
113
|
16 |
|
private function setCategorizedVerifications(array $arrayDataIn) |
114
|
|
|
{ |
115
|
16 |
|
$strCategoryToReturn = ''; |
116
|
16 |
|
$key = implode('_', [$arrayDataIn['commentParentKey'], $arrayDataIn['tag']]); |
117
|
16 |
|
$arrayVarious = $this->arrayProcessing['WritingCategorization']; |
118
|
16 |
|
if (array_key_exists($key, $arrayVarious['Key'])) { |
119
|
6 |
|
$strCategoryToReturn = $arrayVarious['Key'][$key]; |
120
|
16 |
|
} elseif (array_key_exists($arrayDataIn['tag'], $arrayVarious['Tag'])) { |
121
|
16 |
|
$strCategoryToReturn = $arrayVarious['Tag'][$arrayDataIn['tag']]; |
122
|
16 |
|
} elseif (in_array($arrayDataIn['commentParentKey'], $arrayVarious['CommentParrentKey'])) { |
123
|
12 |
|
$strCategoryToReturn = 'SingleElementWithAttribute'; |
124
|
16 |
|
} elseif ($arrayDataIn['matches'] !== []) { |
125
|
16 |
|
$strCategoryToReturn = 'SingleElementWithAttribute'; |
126
|
16 |
|
} elseif (is_array($arrayDataIn['data'])) { |
127
|
16 |
|
$strCategoryToReturn = 'ElementsOrdered'; |
128
|
|
|
} else { |
129
|
16 |
|
$strCategoryToReturn = 'SingleElementWithAttribute'; |
130
|
|
|
} |
131
|
16 |
|
return $strCategoryToReturn; |
132
|
|
|
} |
133
|
|
|
|
134
|
16 |
|
private function setManageComment(string $strCommentParentKey, array $arrayIn): string |
135
|
|
|
{ |
136
|
16 |
|
if (str_starts_with($strCommentParentKey, 'AllowanceCharge')) { |
137
|
3 |
|
$arrayCommentPieces = explode('_', $strCommentParentKey); |
138
|
|
|
// carefully manage a child to decide on comment tag |
139
|
3 |
|
$strChargeIndicator = $arrayIn['ChargeIndicator']; |
140
|
3 |
|
if (in_array($strChargeIndicator, ['0', '1'])) { |
141
|
1 |
|
$strChargeIndicator = [ |
142
|
1 |
|
'0' => 'false', |
143
|
1 |
|
'1' => 'true', |
144
|
1 |
|
][$arrayIn['ChargeIndicator']]; |
145
|
|
|
} |
146
|
3 |
|
array_splice($arrayCommentPieces, 0, 1, 'AllowanceCharge~ChargeIndicator' |
147
|
3 |
|
. ucfirst($strChargeIndicator)); |
148
|
3 |
|
$strCommentParentKey = implode('_', $arrayCommentPieces); |
149
|
|
|
} |
150
|
16 |
|
return $strCommentParentKey; |
151
|
|
|
} |
152
|
|
|
|
153
|
16 |
|
protected function setNumericValue(string $strTag, array $arrayDataIn): string | float |
154
|
|
|
{ |
155
|
16 |
|
$sReturn = $arrayDataIn['value']; |
156
|
16 |
|
$arrayRawTags = ['CreditedQuantity', 'EndpointID', 'InvoicedQuantity', 'ItemClassificationCode', 'PriceAmount']; |
157
|
16 |
|
if (is_numeric($arrayDataIn['value']) && !in_array($strTag, $arrayRawTags)) { |
158
|
16 |
|
$fmt = new \NumberFormatter('en_US', \NumberFormatter::DECIMAL); |
159
|
16 |
|
$fmt->setAttribute(\NumberFormatter::GROUPING_USED, 0); |
160
|
16 |
|
$fmt->setAttribute(\NumberFormatter::MIN_FRACTION_DIGITS, 0); |
161
|
|
|
// if contains currencyID consider 2 decimals as minimum |
162
|
16 |
|
if (in_array('currencyID', array_keys($arrayDataIn))) { |
163
|
16 |
|
$fmt->setAttribute(\NumberFormatter::MIN_FRACTION_DIGITS, 2); |
164
|
|
|
} |
165
|
16 |
|
$fmt->setAttribute(\NumberFormatter::MAX_FRACTION_DIGITS, 2); |
166
|
16 |
|
$sReturn = $fmt->format($arrayDataIn['value']); |
167
|
|
|
} |
168
|
16 |
|
return $sReturn; |
169
|
|
|
} |
170
|
|
|
} |
171
|
|
|
|