Přeskočit na hlavní obsah

Konfigurace parsování faktur

Tato část dokumentace popisuje konfigurační možnosti modulu pro parsování faktur.

Výchozí hodnoty​

Modul definuje několik výchozích hodnot:

  • defaultStatus: Výchozí stav faktury (obvykle 'Draft')
  • roundingDirectionUp: Směr zaokrouhlení nahoru
  • roundingDirectionDown: Směr zaokrouhlení dolů

Mapování polí​

Modul používá několik předdefinovaných mapování pro převod mezi zdrojovými daty a entitami:

Hlavní pole faktury​

protected function getMainInvoiceFieldsMap(): array {
 return [
 'originalNumber' => ['buyer_information', 'document_number'],
 'extractedDateInvoiced' => ['buyer_information', 'document_date'],
 // ... další pole ...
 ];
}

Pole účtu​

protected function getAccountFieldsMap(): array {
 return [
 'name' => 'company_name',
 'phoneNumber' => 'phone',
 // ... další pole ...
 ];
}

Pole položek faktury​

protected function getStandardItemFieldMap(): array {
 return [
 'name' => 'description',
 'quantity' => 'quantity',
 // ... další pole ...
 ];
}

Přizpůsobení​

Modul lze přizpůsobit pomocí:

  • Rozšíření třídy InvoiceLikeProvider: Pro specifické chování faktur
  • Úprava mapování polí: Pro práci s nestandardními datovými strukturami
  • Přepsání výchozích hodnot: Pro změnu základního chování

Technické informace​

Konfigurační konstanty​

protected string $roundingDirectionUp = 'roundUp';
protected string $roundingDirectionDown = 'roundDown';
protected string $defaultStatus = 'Draft';

Měnová pole​

protected function getCurrencySuffixedFields(): array {
 return [
 'amountCurrency', 'roundingCurrency', 'rateStampCurrency',
 // ... další pole ...
 ];
}

Validace položek​

protected function isValidInvoiceItemDto(InvoiceLikeItemDto $dto): bool {
 return $dto->name !== null && $dto->name !== '';
}