projekt kivitendo

use warnings;

use SL::XMLInvoice;

sub find_vendor_by_taxnumber {

  my $taxnumber = shift @_;

  # 1.1 check if we a have a vendor with this tax number (vendor.taxnumber)

  my $vendor = SL::DB::Manager::Vendor->find_by(

    taxnumber => $taxnumber,

    or    => [

      obsolete => undef,

      obsolete => 0,

    ]);

  if (!$vendor) {

    # 1.2 If no vendor with the exact VAT ID number is found, the

    # number might be stored slightly different in the database

    # (e.g. with spaces breaking up groups of numbers). Iterate over

    # all existing vendors with VAT ID numbers, normalize their

    # representation and compare those.

    my $vendors = SL::DB::Manager::Vendor->get_all(

      where => [

        '!taxnumber' => undef,

        '!taxnumber' => '',

        or       => [

          obsolete => undef,

          obsolete => 0,

        ],

      ]);

    foreach my $other_vendor (@{ $vendors }) {

      next unless $other_vendor->taxnumber eq $taxnumber;

      $vendor = $other_vendor;

      last;

    }

}

sub find_vendor_by_ustid {

  my $ustid = shift @_;

  return $vendor;

}

sub find_vendor {

  my ($ustid, $taxnumber) = @_;

  my $vendor;

  if ( $ustid ) {

    $vendor = find_vendor_by_ustid($ustid);

  }

  if (ref $vendor eq 'SL::DB::Vendor') { return $vendor; }

  if ( $taxnumber ) {

    $vendor = find_vendor_by_taxnumber($taxnumber);

  }

  if (ref $vendor eq 'SL::DB::Vendor') { return $vendor; }

  return undef;

}

sub action_import_zugferd {

  my ($self, %params) = @_;

  my %res;          # result data structure returned by SL::ZUGFeRD->extract_from_{pdf,xml}()

  my $parser;       # SL::XMLInvoice object created by SL::ZUGFeRD->extract_from_{pdf,xml}()

  my $dom;          # DOM object for parsed XML data

  my $template_ap;  # SL::DB::RecordTemplate object

  my $vendor;       # SL::DB::Vendor object

  my $ibanmessage;  # Message to display if vendor's database and invoice IBANs don't match up

  die t8("missing file for action import") unless $::form->{file};

  die t8("can only parse a pdf or xml file")      unless $::form->{file} =~ m/^%PDF|<\?xml/;

  if ( $::form->{file} =~ m/^%PDF/ ) {

    %res = %{SL::ZUGFeRD->extract_from_pdf($::form->{file})}

  } else {

    %res = %{SL::ZUGFeRD->extract_from_xml($::form->{file})};

  if ($res{'result'} != SL::ZUGFeRD::RES_OK()) {

    # An error occurred; log message from parser:

    $::lxdebug->message(LXDebug::DEBUG1(), "Could not extract ZUGFeRD data, error message: " . $res{'message'});

    die(t8("Could not extract Factur-X/ZUGFeRD data, data and error message:") . " $res{'message'}");

  $parser = $res{'invoice_xml'};

  # Shouldn't be neccessary with SL::XMLInvoice doing the heavy lifting, but

  # let's grab it, just in case.

  $dom  = $parser->{dom};

  my %metadata = %{$parser->metadata};

  my @items = @{$parser->items};

  my $iban = $metadata{'iban'};

  my $invnumber = $metadata{'invnumber'};

  if ( ! ($metadata{'ustid'} or $metadata{'taxnumber'}) ) {

    die t8("Cannot process this invoice: neither VAT ID nor tax ID present.");

    }

  $vendor = find_vendor($metadata{'ustid'}, $metadata{'taxnumber'});

  die t8("Please add a valid VAT ID or tax number for this vendor: #1", $metadata{'vendor_name'}) unless $vendor;

  # Create a record template for this imported invoice

  $template_ap = SL::DB::RecordTemplate->new(

      vendor_id=>$vendor->id,

  );

  # Check IBAN specified on bill matches the one we've got in

  # the database for this vendor.

  # Use invoice creation date as due date if there's no due date

  $metadata{'duedate'} = $metadata{'transdate'} unless defined $metadata{'duedate'};

  # parse dates to kivi if set/valid

  foreach my $key ( qw(transdate duedate) ) {

    next unless defined $metadata{$key};

    $metadata{$key} =~ s/^\s+|\s+$//g;

    if ($metadata{$key} =~ /^([0-9]{4})-?([0-9]{2})-?([0-9]{2})$/) {

    $metadata{$key} = DateTime->new(year  => $1,

                                    month => $2,

                                    day   => $3)->to_kivitendo;

    }

  }

  # Try to fill in AP account to book against

  my $ap_chart_id = $::instance_conf->get_ap_chart_id;

  unless ( defined $ap_chart_id ) {

    # If no default account is configured, just use the first AP account found.

    my $ap_chart = SL::DB::Manager::Chart->get_all(

      where   => [ link => 'AP' ],

      sort_by => [ 'accno' ],

    );

    $ap_chart_id = ${$ap_chart}[0]->id;

  }

  my $currency = SL::DB::Manager::Currency->find_by(

    name => $metadata{'currency'},

    );

  $template_ap->assign_attributes(

    template_name       => "Faktur-X/ZUGFeRD/XRechnung Import $vendor->name, $invnumber",

    template_type       => 'ap_transaction',

    direct_debit        => $metadata{'direct_debit'},

    notes               => "Faktur-X/ZUGFeRD/XRechnung Import. Type: $metadata{'type'}\nIBAN: " . $ibanmessage,

    taxincluded         => 0,

    currency_id         => $currency->id,

    ar_ap_chart_id      => $ap_chart_id,

    );

  $template_ap->save;

  my $default_ap_amount_chart = SL::DB::Manager::Chart->find_by(charttype => 'A');

  foreach my $i ( @items )

    {

    my %item = %{$i};

    my $net_total = $item{'subtotal'};

    my $desc = $item{'description'};

    my $tax_rate = $item{'tax_rate'} / 100; # XML data is usually in percent

    my $taxes = SL::DB::Manager::Tax->get_all(

      where   => [ chart_categories => { like => '%' . $default_ap_amount_chart->category . '%' },

                   rate => $tax_rate,

                 ],

    );

    # If we really can't find any tax definition (a simple rounding error may

    # be sufficient for that to happen), grab the first tax fitting the default

    # category, just like the AP form would do it for manual entry.

    if ( scalar @{$taxes} == 0 ) {

      $taxes = SL::D::ManagerTax->get_all(

        where   => [ chart_categories => { like => '%' . $default_ap_amount_chart->category . '%' } ],

      );

    }

    my $tax = ${$taxes}[0];

    my $item_obj = SL::DB::RecordTemplateItem

      ->new(amount1 => $net_total,

            record_template_id => $template_ap->id,

            chart_id      => $default_ap_amount_chart->id,

            tax_id      => $tax->id,

        );

    $item_obj->save;

    }

    'form_defaults.invnumber'            => $invnumber,

    'form_defaults.duedate'              => $metadata{'duedate'},

    'form_defaults.transdate'            => $metadata{'transdate'},

SL::Controller::ZUGFeRD - Controller for importing ZUGFeRD PDF files or XML invoices to kivitendo

=item C<action_import_zugferd $file>

Expects a single PDF with ZUGFeRD, Factur-X or XRechnung

metadata. Alternatively, it can also process said data as a

standalone XML file.

Checks if the param <C$pdf> is set and a valid PDF or XML

file. Calls helper functions to validate and extract the

ZUGFeRD/Factur-X/XRechnung data. The invoice needs to have a

valid VAT ID (EU) or tax number (Germany) and a vendor with

the same VAT ID or tax number enrolled in Kivitendo.

It parses some basic ZUGFeRD data (invnumber, total net amount,

transdate, duedate, vendor VAT ID, IBAN, etc.) and also

extracts the invoice's items.

If the invoice has a IBAN also, it will be be compared to the

IBAN saved for the vendor (if any). If they  don't match a

warning will be writte in ap.notes. Furthermore the ZUGFeRD

type code will be written to ap.notes. No callback

implemented.

=head1 CAVEAT

This is just a very basic Parser for ZUGFeRD/Factur-X/XRechnung invoices.

We assume that the invoice's creator is a company with a valid

European VAT ID or German tax number and enrolled in

Kivitendo. Currently, implementation is a bit hacky because

invoice import uses AP record templates as a vessel for

generating the AP record form with the imported data filled

in.

=head1 TODO

This implementation could be improved as follows:

=over 4

=item Direct creation of the filled in AP record form

Creating an AP record template in the database is not

very elegant, since it will spam the database with record

templates that become redundant once the invoice has been

booked. It would be preferable to fill in the form directly.

=item Automatic upload of invoice

Right now, one has to use the "Book and upload" button to

upload the raw invoice document to WebDAV or DMS and attach it

to the invoice. This should be a simple matter of setting a

check box when uploading.

=item Handling of vendor invoices

There is no reason this functionality could not be used to

import vendor invoices as well. Since these tend to be very

lengthy, the ability to import them would be very beneficial.

=item Automatic handling of payment purpose

=back

=head1 AUTHORS

=over 4

=item Jan Büren E<lt>jan@kivitendo-premium.deE<gt>,

=item Johannes Graßler E<lt>info@computer-grassler.deE<gt>,

=back

use SL::XMLInvoice;

use constant RES_ERR_FILE_OPEN                   => -1;

use constant RES_ERR_NO_ATTACHMENT               => -2;

  my %res_fail;

  $res_fail{'result'}  = RES_ERR_NO_ATTACHMENT();

  $res_fail{'message'} = "PDF does not have a Names dictionary.";

  my $names_dict = $doc->getValue($doc->getRootDict->{Names}) or return \%res_fail;

  $res_fail{'message'} = "PDF does not have a EmbeddedFiles tree.";

  my $files_tree = $names_dict->{EmbeddedFiles}               or return \%res_fail;

  my $parser;  # SL::XMLInvoice object used as return value

  my @res;     # Temporary storage for error messages encountered during

               # attempts to process attachments.

        $parser = $parser = SL::XMLInvoice->new($content);

        # Caveat: this will only ever catch the first attachment looking like

        #         an XML invoice.

        if ( $parser->{status} == SL::XMLInvoice::RES_OK ){

          return $parser;

        } else {

          push @res, t8("Could not parse PDF embedded attachment #1: #2",

                       $k,

                       $parser->{result});

        }

  # There's going to be at least one attachment that failed to parse as XML by

  # this point - if there were no attachments at all, we would have bailed out

  # a lot earlier.

  %res_fail = ( result  => RES_ERR_FILE_OPEN(),

                message => join("; ", @res),

  );

  return \%res_fail;

  my @warnings;

    return \{

      push @warnings, $::locale->text('The file \'#1\' does not contain the required XMP meta data.', $file_name);

  } else {

    my $dom = eval { XML::LibXML->load_xml(string => $xmp) };

    push @warnings, $::locale->text('Parsing the XMP metadata failed.'), if !$dom;

    my $xpc = XML::LibXML::XPathContext->new($dom);

    $xpc->registerNs('rdf', 'http://www.w3.org/1999/02/22-rdf-syntax-ns#');

    my $zugferd_version;

    my $test = $xpc->findnodes('/x:xmpmeta/rdf:RDF/rdf:Description');

    foreach my $node ($xpc->findnodes('/x:xmpmeta/rdf:RDF/rdf:Description')) {

      my $ns = first { ref($_) eq 'XML::LibXML::Namespace' } $node->attributes;

      next unless $ns;

      if ($ns->getData =~ m{urn:zugferd:pdfa:CrossIndustryDocument:invoice:2p0}) {

        $zugferd_version = 'zugferd:2p0';

        last;

      }

      if ($ns->getData =~ m{urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0}) {

        $zugferd_version = 'factur-x:1p0';

        last;

      }

      if ($ns->getData =~ m{zugferd|factur-x}i) {

        $zugferd_version = 'unsupported';

        last;

      }

    if (!$zugferd_version) {

        push @warnings, $::locale->text('The XMP metadata does not declare the Factur-X/ZUGFeRD data.'),

    if ($zugferd_version eq 'unsupported') {

        push @warnings, $::locale->text('The Factur-X/ZUGFeRD version used is not supported.'),

    }

  my %res;

  %res = (

    result       => $invoice_xml->{result},

    message      => $invoice_xml->{message},

    warnings     => \@warnings,

  );

  return \%res;

}

sub extract_from_xml {

  my ($self, $data) = @_;

  my %res;

  my $invoice_xml = SL::XMLInvoice->new($data);

  %res = (

    result       => $invoice_xml->{result},

    message      => $invoice_xml->{message},

    metadata_xmp => undef,

    invoice_xml  => $invoice_xml,

    warnings     => (),

  );

  return \%res;

    my $xml  = '<?xml version="1.0" encoding="UTF-8"?> ...';

    my $info = SL::ZUGFeRD->extract_from_xml($xml);

    # Access invoice XML data:

    my $inv = ${$info}{'invoice_xml};

    my %metadata = %{$inv->metadata};

    my @items = @{$inv->items};

    my $dom = $inv->dom;

=head2 extract_from_pdf E<lt>file_nameE<gt>

Opens an existing PDF file in the file system and tries to extract

Factur-X/XRechnung/ZUGFeRD invoice data from it. First it'll parse the XMP

declaration isn't found or the declared version isn't 2p0, an warning is

recorded in the returned data structure's C<warnings> key.

Regardless of metadata presence, it will continue to iterate over all files

embedded in the PDF and attempt to parse them with SL::XMLInvoice. If it

succeeds, the first SL::XMLInvoice object that indicates successful parsing is

returned.

=item C<RES_OK> (0): parsing was OK.

=item C<RES_ERR_…> (all values E<!=> 0): parsing failed. Values > 0 indicate a failure

in C<SL::XMLInvoice>, Values < 0 indicate a failure in C<SL::ZUGFeRD>.

=back

Other than that, the hash ref contains the following keys:

=over 4

=item C<message> - An error message detailing the problem upon nonzero C<result>, undef otherwise.

=item C<metadata_xmp> - The XMP metadata extracted from the Factur-X/ZUGFeRD invoice (if present)

=item C<invoice_xml> - An SL::XMLInvoice object holding the data extracted from the parsed XML invoice.

=item C<warnings> - Warnings encountered upon extracting/parsing XML files (if any)

=back

=head2 extract_from_xml E<lt>stringE<gt>

Takes a string containing an XML document with Factur-X/XRechnung/ZUGFeRD

invoice data and attempts to parse it using C<SL::XMLInvoice>.

If parsing is successful, an SL::XMLInvoice object containing the document's

parsed data is returned.

This method always returns a hash ref containing the key C<result>, a number that

can be one of the following constants:

=over 4

=item C<RES_OK> (0): parsing was OK.

=item C<RES_ERR_…> (all values E<!=> 0): parsing failed. Values > 0 indicate a failure

in C<SL::XMLInvoice>, Values < 0 indicate a failure in C<SL::ZUGFeRD>.

Other than that, the hash ref contains the following keys:

=over 4

=item C<message> - An error message detailing the problem upon nonzero C<result>, undef otherwise.

=item C<metadata_xmp> - Always undef and only present to let downstream code expecting its presence fail gracefully.

=item C<invoice_xml> - An SL::XMLInvoice object holding the data extracted from the parsed XML invoice.

=item C<warnings> - Warnings encountered upon extracting/parsing XML data (if any)

=head1 AUTHORS

=over 4

=item Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>

=item Johannes Graßler E<lt>info@computer-grassler.deE<gt>

=back

    [% L.input_tag('file', '', type => 'file', accept => '.pdf,.xml') %]