1 package C4::Acquisition;
3 # Copyright 2000-2002 Katipo Communications
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it under the
8 # terms of the GNU General Public License as published by the Free Software
9 # Foundation; either version 2 of the License, or (at your option) any later
12 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
13 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
14 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License along
17 # with Koha; if not, write to the Free Software Foundation, Inc.,
18 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 use C4::Dates qw(format_date format_date_in_iso);
31 use C4::SQLHelper qw(InsertInTable);
32 use C4::Bookseller qw(GetBookSellerFromId);
33 use C4::Templates qw(gettemplate);
38 use vars qw($VERSION @ISA @EXPORT);
41 # set the version for version checking
42 $VERSION = 3.07.00.049;
46 &GetBasket &NewBasket &CloseBasket &DelBasket &ModBasket
47 &GetBasketAsCSV &GetBasketGroupAsCSV
48 &GetBasketsByBookseller &GetBasketsByBasketgroup
49 &GetBasketsInfosByBookseller
53 &ModBasketgroup &NewBasketgroup &DelBasketgroup &GetBasketgroup &CloseBasketgroup
54 &GetBasketgroups &ReOpenBasketgroup
56 &NewOrder &DelOrder &ModOrder &GetPendingOrders &GetOrder &GetOrders &GetOrdersByBiblionumber
57 &GetLateOrders &GetOrderFromItemnumber
58 &SearchOrder &GetHistory &GetRecentAcqui
59 &ModReceiveOrder &CancelReceipt
61 &GetLastOrderNotReceivedFromSubscriptionid &GetLastOrderReceivedFromSubscriptionid
62 &NewOrderItem &ModOrderItem &ModItemOrder
64 &GetParcels &GetParcel
65 &GetContracts &GetContract
76 &GetItemnumbersFromOrder
86 sub GetOrderFromItemnumber {
87 my ($itemnumber) = @_;
88 my $dbh = C4::Context->dbh;
91 SELECT * from aqorders LEFT JOIN aqorders_items
92 ON ( aqorders.ordernumber = aqorders_items.ordernumber )
93 WHERE itemnumber = ? |;
95 my $sth = $dbh->prepare($query);
99 $sth->execute($itemnumber);
101 my $order = $sth->fetchrow_hashref;
106 # Returns the itemnumber(s) associated with the ordernumber given in parameter
107 sub GetItemnumbersFromOrder {
108 my ($ordernumber) = @_;
109 my $dbh = C4::Context->dbh;
110 my $query = "SELECT itemnumber FROM aqorders_items WHERE ordernumber=?";
111 my $sth = $dbh->prepare($query);
112 $sth->execute($ordernumber);
115 while (my $order = $sth->fetchrow_hashref) {
116 push @tab, $order->{'itemnumber'};
130 C4::Acquisition - Koha functions for dealing with orders and acquisitions
138 The functions in this module deal with acquisitions, managing book
139 orders, basket and parcels.
143 =head2 FUNCTIONS ABOUT BASKETS
147 $aqbasket = &GetBasket($basketnumber);
149 get all basket informations in aqbasket for a given basket
151 B<returns:> informations for a given basket returned as a hashref.
157 my $dbh = C4::Context->dbh;
160 concat( b.firstname,' ',b.surname) AS authorisedbyname,
161 b.branchcode AS branch
163 LEFT JOIN borrowers b ON aqbasket.authorisedby=b.borrowernumber
166 my $sth=$dbh->prepare($query);
167 $sth->execute($basketno);
168 my $basket = $sth->fetchrow_hashref;
172 #------------------------------------------------------------#
176 $basket = &NewBasket( $booksellerid, $authorizedby, $basketname,
177 $basketnote, $basketbooksellernote, $basketcontractnumber, $deliveryplace, $billingplace );
179 Create a new basket in aqbasket table
183 =item C<$booksellerid> is a foreign key in the aqbasket table
185 =item C<$authorizedby> is the username of who created the basket
189 The other parameters are optional, see ModBasketHeader for more info on them.
194 my ( $booksellerid, $authorisedby, $basketname, $basketnote,
195 $basketbooksellernote, $basketcontractnumber, $deliveryplace,
196 $billingplace ) = @_;
197 my $dbh = C4::Context->dbh;
199 'INSERT INTO aqbasket (creationdate,booksellerid,authorisedby) '
200 . 'VALUES (now(),?,?)';
201 $dbh->do( $query, {}, $booksellerid, $authorisedby );
203 my $basket = $dbh->{mysql_insertid};
204 $basketname ||= q{}; # default to empty strings
206 $basketbooksellernote ||= q{};
207 ModBasketHeader( $basket, $basketname, $basketnote, $basketbooksellernote,
208 $basketcontractnumber, $booksellerid, $deliveryplace, $billingplace );
212 #------------------------------------------------------------#
216 &CloseBasket($basketno);
218 close a basket (becomes unmodifiable,except for recieves)
224 my $dbh = C4::Context->dbh;
230 my $sth = $dbh->prepare($query);
231 $sth->execute($basketno);
234 #------------------------------------------------------------#
236 =head3 GetBasketAsCSV
238 &GetBasketAsCSV($basketno);
240 Export a basket as CSV
242 $cgi parameter is needed for column name translation
247 my ($basketno, $cgi) = @_;
248 my $basket = GetBasket($basketno);
249 my @orders = GetOrders($basketno);
250 my $contract = GetContract($basket->{'contractnumber'});
252 my $template = C4::Templates::gettemplate("acqui/csv/basket.tmpl", "intranet", $cgi);
255 foreach my $order (@orders) {
256 my $bd = GetBiblioData( $order->{'biblionumber'} );
258 contractname => $contract->{'contractname'},
259 ordernumber => $order->{'ordernumber'},
260 entrydate => $order->{'entrydate'},
261 isbn => $order->{'isbn'},
262 author => $bd->{'author'},
263 title => $bd->{'title'},
264 publicationyear => $bd->{'publicationyear'},
265 publishercode => $bd->{'publishercode'},
266 collectiontitle => $bd->{'collectiontitle'},
267 notes => $order->{'notes'},
268 quantity => $order->{'quantity'},
269 rrp => $order->{'rrp'},
270 deliveryplace => C4::Branch::GetBranchName( $basket->{'deliveryplace'} ),
271 billingplace => C4::Branch::GetBranchName( $basket->{'billingplace'} ),
274 contractname author title publishercode collectiontitle notes
275 deliveryplace billingplace
277 # Double the quotes to not be interpreted as a field end
278 $row->{$_} =~ s/"/""/g if $row->{$_};
284 if(defined $a->{publishercode} and defined $b->{publishercode}) {
285 $a->{publishercode} cmp $b->{publishercode};
289 $template->param(rows => \@rows);
291 return $template->output;
295 =head3 GetBasketGroupAsCSV
299 &GetBasketGroupAsCSV($basketgroupid);
301 Export a basket group as CSV
303 $cgi parameter is needed for column name translation
309 sub GetBasketGroupAsCSV {
310 my ($basketgroupid, $cgi) = @_;
311 my $baskets = GetBasketsByBasketgroup($basketgroupid);
313 my $template = C4::Templates::gettemplate('acqui/csv/basketgroup.tmpl', 'intranet', $cgi);
316 for my $basket (@$baskets) {
317 my @orders = GetOrders( $$basket{basketno} );
318 my $contract = GetContract( $$basket{contractnumber} );
319 my $bookseller = GetBookSellerFromId( $$basket{booksellerid} );
320 my $basketgroup = GetBasketgroup( $$basket{basketgroupid} );
322 foreach my $order (@orders) {
323 my $bd = GetBiblioData( $order->{'biblionumber'} );
325 clientnumber => $bookseller->{accountnumber},
326 basketname => $basket->{basketname},
327 ordernumber => $order->{ordernumber},
328 author => $bd->{author},
329 title => $bd->{title},
330 publishercode => $bd->{publishercode},
331 publicationyear => $bd->{publicationyear},
332 collectiontitle => $bd->{collectiontitle},
333 isbn => $order->{isbn},
334 quantity => $order->{quantity},
335 rrp => $order->{rrp},
336 discount => $bookseller->{discount},
337 ecost => $order->{ecost},
338 notes => $order->{notes},
339 entrydate => $order->{entrydate},
340 booksellername => $bookseller->{name},
341 bookselleraddress => $bookseller->{address1},
342 booksellerpostal => $bookseller->{postal},
343 contractnumber => $contract->{contractnumber},
344 contractname => $contract->{contractname},
345 basketgroupdeliveryplace => C4::Branch::GetBranchName( $basketgroup->{deliveryplace} ),
346 basketgroupbillingplace => C4::Branch::GetBranchName( $basketgroup->{billingplace} ),
347 basketdeliveryplace => C4::Branch::GetBranchName( $basket->{deliveryplace} ),
348 basketbillingplace => C4::Branch::GetBranchName( $basket->{billingplace} ),
351 basketname author title publishercode collectiontitle notes
352 booksellername bookselleraddress booksellerpostal contractname
353 basketgroupdeliveryplace basketgroupbillingplace
354 basketdeliveryplace basketbillingplace
356 # Double the quotes to not be interpreted as a field end
357 $row->{$_} =~ s/"/""/g if $row->{$_};
362 $template->param(rows => \@rows);
364 return $template->output;
368 =head3 CloseBasketgroup
370 &CloseBasketgroup($basketgroupno);
376 sub CloseBasketgroup {
377 my ($basketgroupno) = @_;
378 my $dbh = C4::Context->dbh;
379 my $sth = $dbh->prepare("
380 UPDATE aqbasketgroups
384 $sth->execute($basketgroupno);
387 #------------------------------------------------------------#
389 =head3 ReOpenBaskergroup($basketgroupno)
391 &ReOpenBaskergroup($basketgroupno);
397 sub ReOpenBasketgroup {
398 my ($basketgroupno) = @_;
399 my $dbh = C4::Context->dbh;
400 my $sth = $dbh->prepare("
401 UPDATE aqbasketgroups
405 $sth->execute($basketgroupno);
408 #------------------------------------------------------------#
413 &DelBasket($basketno);
415 Deletes the basket that has basketno field $basketno in the aqbasket table.
419 =item C<$basketno> is the primary key of the basket in the aqbasket table.
426 my ( $basketno ) = @_;
427 my $query = "DELETE FROM aqbasket WHERE basketno=?";
428 my $dbh = C4::Context->dbh;
429 my $sth = $dbh->prepare($query);
430 $sth->execute($basketno);
434 #------------------------------------------------------------#
438 &ModBasket($basketinfo);
440 Modifies a basket, using a hashref $basketinfo for the relevant information, only $basketinfo->{'basketno'} is required.
444 =item C<$basketno> is the primary key of the basket in the aqbasket table.
451 my $basketinfo = shift;
452 my $query = "UPDATE aqbasket SET ";
454 foreach my $key (keys %$basketinfo){
455 if ($key ne 'basketno'){
456 $query .= "$key=?, ";
457 push(@params, $basketinfo->{$key} || undef );
460 # get rid of the "," at the end of $query
461 if (substr($query, length($query)-2) eq ', '){
466 $query .= "WHERE basketno=?";
467 push(@params, $basketinfo->{'basketno'});
468 my $dbh = C4::Context->dbh;
469 my $sth = $dbh->prepare($query);
470 $sth->execute(@params);
474 #------------------------------------------------------------#
476 =head3 ModBasketHeader
478 &ModBasketHeader($basketno, $basketname, $note, $booksellernote, $contractnumber, $booksellerid);
480 Modifies a basket's header.
484 =item C<$basketno> is the "basketno" field in the "aqbasket" table;
486 =item C<$basketname> is the "basketname" field in the "aqbasket" table;
488 =item C<$note> is the "note" field in the "aqbasket" table;
490 =item C<$booksellernote> is the "booksellernote" field in the "aqbasket" table;
492 =item C<$contractnumber> is the "contractnumber" (foreign) key in the "aqbasket" table.
494 =item C<$booksellerid> is the id (foreign) key in the "aqbooksellers" table for the vendor.
496 =item C<$deliveryplace> is the "deliveryplace" field in the aqbasket table.
498 =item C<$billingplace> is the "billingplace" field in the aqbasket table.
504 sub ModBasketHeader {
505 my ($basketno, $basketname, $note, $booksellernote, $contractnumber, $booksellerid, $deliveryplace, $billingplace) = @_;
508 SET basketname=?, note=?, booksellernote=?, booksellerid=?, deliveryplace=?, billingplace=?
512 my $dbh = C4::Context->dbh;
513 my $sth = $dbh->prepare($query);
514 $sth->execute($basketname, $note, $booksellernote, $booksellerid, $deliveryplace, $billingplace, $basketno);
516 if ( $contractnumber ) {
517 my $query2 ="UPDATE aqbasket SET contractnumber=? WHERE basketno=?";
518 my $sth2 = $dbh->prepare($query2);
519 $sth2->execute($contractnumber,$basketno);
525 #------------------------------------------------------------#
527 =head3 GetBasketsByBookseller
529 @results = &GetBasketsByBookseller($booksellerid, $extra);
531 Returns a list of hashes of all the baskets that belong to bookseller 'booksellerid'.
535 =item C<$booksellerid> is the 'id' field of the bookseller in the aqbooksellers table
537 =item C<$extra> is the extra sql parameters, can be
539 $extra->{groupby}: group baskets by column
540 ex. $extra->{groupby} = aqbasket.basketgroupid
541 $extra->{orderby}: order baskets by column
542 $extra->{limit}: limit number of results (can be helpful for pagination)
548 sub GetBasketsByBookseller {
549 my ($booksellerid, $extra) = @_;
550 my $query = "SELECT * FROM aqbasket WHERE booksellerid=?";
552 if ($extra->{groupby}) {
553 $query .= " GROUP by $extra->{groupby}";
555 if ($extra->{orderby}){
556 $query .= " ORDER by $extra->{orderby}";
558 if ($extra->{limit}){
559 $query .= " LIMIT $extra->{limit}";
562 my $dbh = C4::Context->dbh;
563 my $sth = $dbh->prepare($query);
564 $sth->execute($booksellerid);
565 my $results = $sth->fetchall_arrayref({});
570 =head3 GetBasketsInfosByBookseller
572 my $baskets = GetBasketsInfosByBookseller($supplierid, $allbaskets);
574 The optional second parameter allbaskets is a boolean allowing you to
575 select all baskets from the supplier; by default only active baskets (open or
576 closed but still something to receive) are returned.
578 Returns in a arrayref of hashref all about booksellers baskets, plus:
579 total_biblios: Number of distinct biblios in basket
580 total_items: Number of items in basket
581 expected_items: Number of non-received items in basket
585 sub GetBasketsInfosByBookseller {
586 my ($supplierid, $allbaskets) = @_;
588 return unless $supplierid;
590 my $dbh = C4::Context->dbh;
593 SUM(aqorders.quantity) AS total_items,
594 COUNT(DISTINCT aqorders.biblionumber) AS total_biblios,
596 IF(aqorders.datereceived IS NULL
597 AND aqorders.datecancellationprinted IS NULL
602 LEFT JOIN aqorders ON aqorders.basketno = aqbasket.basketno
603 WHERE booksellerid = ?};
605 $query.=" AND (closedate IS NULL OR (aqorders.quantity > aqorders.quantityreceived AND datecancellationprinted IS NULL))";
607 $query.=" GROUP BY aqbasket.basketno";
609 my $sth = $dbh->prepare($query);
610 $sth->execute($supplierid);
611 return $sth->fetchall_arrayref({});
615 #------------------------------------------------------------#
617 =head3 GetBasketsByBasketgroup
619 $baskets = &GetBasketsByBasketgroup($basketgroupid);
621 Returns a reference to all baskets that belong to basketgroup $basketgroupid.
625 sub GetBasketsByBasketgroup {
626 my $basketgroupid = shift;
628 SELECT *, aqbasket.booksellerid as booksellerid
630 LEFT JOIN aqcontract USING(contractnumber) WHERE basketgroupid=?
632 my $dbh = C4::Context->dbh;
633 my $sth = $dbh->prepare($query);
634 $sth->execute($basketgroupid);
635 my $results = $sth->fetchall_arrayref({});
640 #------------------------------------------------------------#
642 =head3 NewBasketgroup
644 $basketgroupid = NewBasketgroup(\%hashref);
646 Adds a basketgroup to the aqbasketgroups table, and add the initial baskets to it.
648 $hashref->{'booksellerid'} is the 'id' field of the bookseller in the aqbooksellers table,
650 $hashref->{'name'} is the 'name' field of the basketgroup in the aqbasketgroups table,
652 $hashref->{'basketlist'} is a list reference of the 'id's of the baskets that belong to this group,
654 $hashref->{'billingplace'} is the 'billingplace' field of the basketgroup in the aqbasketgroups table,
656 $hashref->{'deliveryplace'} is the 'deliveryplace' field of the basketgroup in the aqbasketgroups table,
658 $hashref->{'freedeliveryplace'} is the 'freedeliveryplace' field of the basketgroup in the aqbasketgroups table,
660 $hashref->{'deliverycomment'} is the 'deliverycomment' field of the basketgroup in the aqbasketgroups table,
662 $hashref->{'closed'} is the 'closed' field of the aqbasketgroups table, it is false if 0, true otherwise.
667 my $basketgroupinfo = shift;
668 die "booksellerid is required to create a basketgroup" unless $basketgroupinfo->{'booksellerid'};
669 my $query = "INSERT INTO aqbasketgroups (";
671 foreach my $field (qw(name billingplace deliveryplace freedeliveryplace deliverycomment closed)) {
672 if ( defined $basketgroupinfo->{$field} ) {
673 $query .= "$field, ";
674 push(@params, $basketgroupinfo->{$field});
677 $query .= "booksellerid) VALUES (";
682 push(@params, $basketgroupinfo->{'booksellerid'});
683 my $dbh = C4::Context->dbh;
684 my $sth = $dbh->prepare($query);
685 $sth->execute(@params);
686 my $basketgroupid = $dbh->{'mysql_insertid'};
687 if( $basketgroupinfo->{'basketlist'} ) {
688 foreach my $basketno (@{$basketgroupinfo->{'basketlist'}}) {
689 my $query2 = "UPDATE aqbasket SET basketgroupid=? WHERE basketno=?";
690 my $sth2 = $dbh->prepare($query2);
691 $sth2->execute($basketgroupid, $basketno);
694 return $basketgroupid;
697 #------------------------------------------------------------#
699 =head3 ModBasketgroup
701 ModBasketgroup(\%hashref);
703 Modifies a basketgroup in the aqbasketgroups table, and add the baskets to it.
705 $hashref->{'id'} is the 'id' field of the basketgroup in the aqbasketgroup table, this parameter is mandatory,
707 $hashref->{'name'} is the 'name' field of the basketgroup in the aqbasketgroups table,
709 $hashref->{'basketlist'} is a list reference of the 'id's of the baskets that belong to this group,
711 $hashref->{'billingplace'} is the 'billingplace' field of the basketgroup in the aqbasketgroups table,
713 $hashref->{'deliveryplace'} is the 'deliveryplace' field of the basketgroup in the aqbasketgroups table,
715 $hashref->{'freedeliveryplace'} is the 'freedeliveryplace' field of the basketgroup in the aqbasketgroups table,
717 $hashref->{'deliverycomment'} is the 'deliverycomment' field of the basketgroup in the aqbasketgroups table,
719 $hashref->{'closed'} is the 'closed' field of the aqbasketgroups table, it is false if 0, true otherwise.
724 my $basketgroupinfo = shift;
725 die "basketgroup id is required to edit a basketgroup" unless $basketgroupinfo->{'id'};
726 my $dbh = C4::Context->dbh;
727 my $query = "UPDATE aqbasketgroups SET ";
729 foreach my $field (qw(name billingplace deliveryplace freedeliveryplace deliverycomment closed)) {
730 if ( defined $basketgroupinfo->{$field} ) {
731 $query .= "$field=?, ";
732 push(@params, $basketgroupinfo->{$field});
737 $query .= " WHERE id=?";
738 push(@params, $basketgroupinfo->{'id'});
739 my $sth = $dbh->prepare($query);
740 $sth->execute(@params);
742 $sth = $dbh->prepare('UPDATE aqbasket SET basketgroupid = NULL WHERE basketgroupid = ?');
743 $sth->execute($basketgroupinfo->{'id'});
745 if($basketgroupinfo->{'basketlist'} && @{$basketgroupinfo->{'basketlist'}}){
746 $sth = $dbh->prepare("UPDATE aqbasket SET basketgroupid=? WHERE basketno=?");
747 foreach my $basketno (@{$basketgroupinfo->{'basketlist'}}) {
748 $sth->execute($basketgroupinfo->{'id'}, $basketno);
755 #------------------------------------------------------------#
757 =head3 DelBasketgroup
759 DelBasketgroup($basketgroupid);
761 Deletes a basketgroup in the aqbasketgroups table, and removes the reference to it from the baskets,
765 =item C<$basketgroupid> is the 'id' field of the basket in the aqbasketgroup table
772 my $basketgroupid = shift;
773 die "basketgroup id is required to edit a basketgroup" unless $basketgroupid;
774 my $query = "DELETE FROM aqbasketgroups WHERE id=?";
775 my $dbh = C4::Context->dbh;
776 my $sth = $dbh->prepare($query);
777 $sth->execute($basketgroupid);
781 #------------------------------------------------------------#
784 =head2 FUNCTIONS ABOUT ORDERS
786 =head3 GetBasketgroup
788 $basketgroup = &GetBasketgroup($basketgroupid);
790 Returns a reference to the hash containing all infermation about the basketgroup.
795 my $basketgroupid = shift;
796 die "basketgroup id is required to edit a basketgroup" unless $basketgroupid;
797 my $query = "SELECT * FROM aqbasketgroups WHERE id=?";
798 my $dbh = C4::Context->dbh;
799 my $sth = $dbh->prepare($query);
800 $sth->execute($basketgroupid);
801 my $result = $sth->fetchrow_hashref;
806 #------------------------------------------------------------#
808 =head3 GetBasketgroups
810 $basketgroups = &GetBasketgroups($booksellerid);
812 Returns a reference to the array of all the basketgroups of bookseller $booksellerid.
816 sub GetBasketgroups {
817 my $booksellerid = shift;
818 die 'bookseller id is required to edit a basketgroup' unless $booksellerid;
819 my $query = 'SELECT * FROM aqbasketgroups WHERE booksellerid=? ORDER BY id DESC';
820 my $dbh = C4::Context->dbh;
821 my $sth = $dbh->prepare($query);
822 $sth->execute($booksellerid);
823 return $sth->fetchall_arrayref({});
826 #------------------------------------------------------------#
828 =head2 FUNCTIONS ABOUT ORDERS
832 #------------------------------------------------------------#
834 =head3 GetPendingOrders
836 $orders = &GetPendingOrders($supplierid,$grouped,$owner,$basketno,$ordernumber,$search,$ean);
838 Finds pending orders from the bookseller with the given ID. Ignores
839 completed and cancelled orders.
841 C<$booksellerid> contains the bookseller identifier
842 C<$owner> contains 0 or 1. 0 means any owner. 1 means only the list of orders entered by the user itself.
843 C<$grouped> is a boolean that, if set to 1 will group all order lines of the same basket
844 in a single result line
845 C<$orders> is a reference-to-array; each element is a reference-to-hash.
847 Used also by the filter in parcel.pl
854 These give the value of the corresponding field in the aqorders table
855 of the Koha database.
857 Results are ordered from most to least recent.
861 sub GetPendingOrders {
862 my ($supplierid,$grouped,$owner,$basketno,$ordernumber,$search,$ean) = @_;
863 my $dbh = C4::Context->dbh;
865 SELECT ".($grouped?"count(*),":"")."aqbasket.basketno,
866 surname,firstname,biblio.*,biblioitems.isbn,
867 aqbasket.closedate, aqbasket.creationdate, aqbasket.basketname,
870 LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
871 LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
872 LEFT JOIN biblio ON biblio.biblionumber=aqorders.biblionumber
873 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
874 WHERE (quantity > quantityreceived OR quantityreceived is NULL)
875 AND datecancellationprinted IS NULL";
877 my $userenv = C4::Context->userenv;
878 if ( C4::Context->preference("IndependentBranches") ) {
879 if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
880 $strsth .= " AND (borrowers.branchcode = ?
881 or borrowers.branchcode = '')";
882 push @query_params, $userenv->{branch};
886 $strsth .= " AND aqbasket.booksellerid = ?";
887 push @query_params, $supplierid;
890 $strsth .= " AND (aqorders.ordernumber=?)";
891 push @query_params, $ordernumber;
894 $strsth .= " AND (biblio.title like ? OR biblio.author LIKE ? OR biblioitems.isbn like ?)";
895 push @query_params, ("%$search%","%$search%","%$search%");
898 $strsth .= " AND biblioitems.ean = ?";
899 push @query_params, $ean;
902 $strsth .= " AND aqbasket.basketno=? ";
903 push @query_params, $basketno;
906 $strsth .= " AND aqbasket.authorisedby=? ";
907 push @query_params, $userenv->{'number'};
909 $strsth .= " group by aqbasket.basketno" if $grouped;
910 $strsth .= " order by aqbasket.basketno";
911 my $sth = $dbh->prepare($strsth);
912 $sth->execute( @query_params );
913 my $results = $sth->fetchall_arrayref({});
918 #------------------------------------------------------------#
922 @orders = &GetOrders($basketnumber, $orderby);
924 Looks up the pending (non-cancelled) orders with the given basket
925 number. If C<$booksellerID> is non-empty, only orders from that seller
929 C<&basket> returns a two-element array. C<@orders> is an array of
930 references-to-hash, whose keys are the fields from the aqorders,
931 biblio, and biblioitems tables in the Koha database.
936 my ( $basketno, $orderby ) = @_;
937 my $dbh = C4::Context->dbh;
939 SELECT biblio.*,biblioitems.*,
944 LEFT JOIN aqbudgets ON aqbudgets.budget_id = aqorders.budget_id
945 LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber
946 LEFT JOIN biblioitems ON biblioitems.biblionumber =biblio.biblionumber
948 AND (datecancellationprinted IS NULL OR datecancellationprinted='0000-00-00')
951 $orderby = "biblioitems.publishercode,biblio.title" unless $orderby;
952 $query .= " ORDER BY $orderby";
953 my $sth = $dbh->prepare($query);
954 $sth->execute($basketno);
955 my $results = $sth->fetchall_arrayref({});
960 #------------------------------------------------------------#
961 =head3 GetOrdersByBiblionumber
963 @orders = &GetOrdersByBiblionumber($biblionumber);
965 Looks up the orders with linked to a specific $biblionumber, including
966 cancelled orders and received orders.
969 C<@orders> is an array of references-to-hash, whose keys are the
970 fields from the aqorders, biblio, and biblioitems tables in the Koha database.
974 sub GetOrdersByBiblionumber {
975 my $biblionumber = shift;
976 return unless $biblionumber;
977 my $dbh = C4::Context->dbh;
979 SELECT biblio.*,biblioitems.*,
983 LEFT JOIN aqbudgets ON aqbudgets.budget_id = aqorders.budget_id
984 LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber
985 LEFT JOIN biblioitems ON biblioitems.biblionumber =biblio.biblionumber
986 WHERE aqorders.biblionumber=?
988 my $sth = $dbh->prepare($query);
989 $sth->execute($biblionumber);
990 my $results = $sth->fetchall_arrayref({});
995 #------------------------------------------------------------#
999 $order = &GetOrder($ordernumber);
1001 Looks up an order by order number.
1003 Returns a reference-to-hash describing the order. The keys of
1004 C<$order> are fields from the biblio, biblioitems, aqorders tables of the Koha database.
1009 my ($ordernumber) = @_;
1010 my $dbh = C4::Context->dbh;
1012 SELECT biblioitems.*, biblio.*, aqorders.*
1014 LEFT JOIN biblio on biblio.biblionumber=aqorders.biblionumber
1015 LEFT JOIN biblioitems on biblioitems.biblionumber=aqorders.biblionumber
1016 WHERE aqorders.ordernumber=?
1019 my $sth= $dbh->prepare($query);
1020 $sth->execute($ordernumber);
1021 my $data = $sth->fetchrow_hashref;
1026 =head3 GetLastOrderNotReceivedFromSubscriptionid
1028 $order = &GetLastOrderNotReceivedFromSubscriptionid($subscriptionid);
1030 Returns a reference-to-hash describing the last order not received for a subscription.
1034 sub GetLastOrderNotReceivedFromSubscriptionid {
1035 my ( $subscriptionid ) = @_;
1036 my $dbh = C4::Context->dbh;
1038 SELECT * FROM aqorders
1039 LEFT JOIN subscription
1040 ON ( aqorders.subscriptionid = subscription.subscriptionid )
1041 WHERE aqorders.subscriptionid = ?
1042 AND aqorders.datereceived IS NULL
1045 my $sth = $dbh->prepare( $query );
1046 $sth->execute( $subscriptionid );
1047 my $order = $sth->fetchrow_hashref;
1051 =head3 GetLastOrderReceivedFromSubscriptionid
1053 $order = &GetLastOrderReceivedFromSubscriptionid($subscriptionid);
1055 Returns a reference-to-hash describing the last order received for a subscription.
1059 sub GetLastOrderReceivedFromSubscriptionid {
1060 my ( $subscriptionid ) = @_;
1061 my $dbh = C4::Context->dbh;
1063 SELECT * FROM aqorders
1064 LEFT JOIN subscription
1065 ON ( aqorders.subscriptionid = subscription.subscriptionid )
1066 WHERE aqorders.subscriptionid = ?
1067 AND aqorders.datereceived =
1069 SELECT MAX( aqorders.datereceived )
1071 LEFT JOIN subscription
1072 ON ( aqorders.subscriptionid = subscription.subscriptionid )
1073 WHERE aqorders.subscriptionid = ?
1074 AND aqorders.datereceived IS NOT NULL
1076 ORDER BY ordernumber DESC
1079 my $sth = $dbh->prepare( $query );
1080 $sth->execute( $subscriptionid, $subscriptionid );
1081 my $order = $sth->fetchrow_hashref;
1087 #------------------------------------------------------------#
1091 &NewOrder(\%hashref);
1093 Adds a new order to the database. Any argument that isn't described
1094 below is the new value of the field with the same name in the aqorders
1095 table of the Koha database.
1099 =item $hashref->{'basketno'} is the basketno foreign key in aqorders, it is mandatory
1101 =item $hashref->{'ordernumber'} is a "minimum order number."
1103 =item $hashref->{'budgetdate'} is effectively ignored.
1104 If it's undef (anything false) or the string 'now', the current day is used.
1105 Else, the upcoming July 1st is used.
1107 =item $hashref->{'subscription'} may be either "yes", or anything else for "no".
1109 =item $hashref->{'uncertainprice'} may be 0 for "the price is known" or 1 for "the price is uncertain"
1111 =item defaults entrydate to Now
1113 The following keys are used: "biblionumber", "title", "basketno", "quantity", "notes", "rrp", "ecost", "gstrate", "unitprice", "subscription", "sort1", "sort2", "booksellerinvoicenumber", "listprice", "budgetdate", "purchaseordernumber", "branchcode", "booksellerinvoicenumber", "budget_id".
1120 my $orderinfo = shift;
1121 #### ------------------------------
1122 my $dbh = C4::Context->dbh;
1126 # if these parameters are missing, we can't continue
1127 for my $key (qw/basketno quantity biblionumber budget_id/) {
1128 croak "Mandatory parameter $key missing" unless $orderinfo->{$key};
1131 if ( defined $orderinfo->{subscription} && $orderinfo->{'subscription'} eq 'yes' ) {
1132 $orderinfo->{'subscription'} = 1;
1134 $orderinfo->{'subscription'} = 0;
1136 $orderinfo->{'entrydate'} ||= C4::Dates->new()->output("iso");
1137 if (!$orderinfo->{quantityreceived}) {
1138 $orderinfo->{quantityreceived} = 0;
1141 my $ordernumber=InsertInTable("aqorders",$orderinfo);
1142 if (not $orderinfo->{parent_ordernumber}) {
1143 my $sth = $dbh->prepare("
1145 SET parent_ordernumber = ordernumber
1146 WHERE ordernumber = ?
1148 $sth->execute($ordernumber);
1150 return ( $orderinfo->{'basketno'}, $ordernumber );
1155 #------------------------------------------------------------#
1164 my ($itemnumber, $ordernumber) = @_;
1165 my $dbh = C4::Context->dbh;
1167 INSERT INTO aqorders_items
1168 (itemnumber, ordernumber)
1171 my $sth = $dbh->prepare($query);
1172 $sth->execute( $itemnumber, $ordernumber);
1175 #------------------------------------------------------------#
1179 &ModOrder(\%hashref);
1181 Modifies an existing order. Updates the order with order number
1182 $hashref->{'ordernumber'} and biblionumber $hashref->{'biblionumber'}. All
1183 other keys of the hash update the fields with the same name in the aqorders
1184 table of the Koha database.
1189 my $orderinfo = shift;
1191 die "Ordernumber is required" if $orderinfo->{'ordernumber'} eq '' ;
1192 die "Biblionumber is required" if $orderinfo->{'biblionumber'} eq '';
1194 my $dbh = C4::Context->dbh;
1197 # update uncertainprice to an integer, just in case (under FF, checked boxes have the value "ON" by default)
1198 $orderinfo->{uncertainprice}=1 if $orderinfo->{uncertainprice};
1200 # delete($orderinfo->{'branchcode'});
1201 # the hash contains a lot of entries not in aqorders, so get the columns ...
1202 my $sth = $dbh->prepare("SELECT * FROM aqorders LIMIT 1;");
1204 my $colnames = $sth->{NAME};
1205 #FIXME Be careful. If aqorders would have columns with diacritics,
1206 #you should need to decode what you get back from NAME.
1207 #See report 10110 and guided_reports.pl
1208 my $query = "UPDATE aqorders SET ";
1210 foreach my $orderinfokey (grep(!/ordernumber/, keys %$orderinfo)){
1211 # ... and skip hash entries that are not in the aqorders table
1212 # FIXME : probably not the best way to do it (would be better to have a correct hash)
1213 next unless grep(/^$orderinfokey$/, @$colnames);
1214 $query .= "$orderinfokey=?, ";
1215 push(@params, $orderinfo->{$orderinfokey});
1218 $query .= "timestamp=NOW() WHERE ordernumber=?";
1219 # push(@params, $specorderinfo{'ordernumber'});
1220 push(@params, $orderinfo->{'ordernumber'} );
1221 $sth = $dbh->prepare($query);
1222 $sth->execute(@params);
1226 #------------------------------------------------------------#
1230 &ModOrderItem(\%hashref);
1232 Modifies the itemnumber in the aqorders_items table. The input hash needs three entities:
1236 =item - itemnumber: the old itemnumber
1237 =item - ordernumber: the order this item is attached to
1238 =item - newitemnumber: the new itemnumber we want to attach the line to
1245 my $orderiteminfo = shift;
1246 if (! $orderiteminfo->{'ordernumber'} || ! $orderiteminfo->{'itemnumber'} || ! $orderiteminfo->{'newitemnumber'}){
1247 die "Ordernumber, itemnumber and newitemnumber is required";
1250 my $dbh = C4::Context->dbh;
1252 my $query = "UPDATE aqorders_items set itemnumber=? where itemnumber=? and ordernumber=?";
1253 my @params = ($orderiteminfo->{'newitemnumber'}, $orderiteminfo->{'itemnumber'}, $orderiteminfo->{'ordernumber'});
1254 my $sth = $dbh->prepare($query);
1255 $sth->execute(@params);
1261 ModItemOrder($itemnumber, $ordernumber);
1263 Modifies the ordernumber of an item in aqorders_items.
1268 my ($itemnumber, $ordernumber) = @_;
1270 return unless ($itemnumber and $ordernumber);
1272 my $dbh = C4::Context->dbh;
1274 UPDATE aqorders_items
1276 WHERE itemnumber = ?
1278 my $sth = $dbh->prepare($query);
1279 return $sth->execute($ordernumber, $itemnumber);
1282 #------------------------------------------------------------#
1284 =head3 GetCancelledOrders
1286 my @orders = GetCancelledOrders($basketno, $orderby);
1288 Returns cancelled orders for a basket
1292 sub GetCancelledOrders {
1293 my ( $basketno, $orderby ) = @_;
1295 return () unless $basketno;
1297 my $dbh = C4::Context->dbh;
1299 SELECT biblio.*, biblioitems.*, aqorders.*, aqbudgets.*
1301 LEFT JOIN aqbudgets ON aqbudgets.budget_id = aqorders.budget_id
1302 LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber
1303 LEFT JOIN biblioitems ON biblioitems.biblionumber = biblio.biblionumber
1305 AND (datecancellationprinted IS NOT NULL
1306 AND datecancellationprinted <> '0000-00-00')
1309 $orderby = "aqorders.datecancellationprinted desc, aqorders.timestamp desc"
1311 $query .= " ORDER BY $orderby";
1312 my $sth = $dbh->prepare($query);
1313 $sth->execute($basketno);
1314 my $results = $sth->fetchall_arrayref( {} );
1320 #------------------------------------------------------------#
1322 =head3 ModReceiveOrder
1324 &ModReceiveOrder($biblionumber, $ordernumber, $quantityreceived, $user,
1325 $cost, $ecost, $invoiceid, rrp, budget_id, datereceived, \@received_itemnumbers);
1327 Updates an order, to reflect the fact that it was received, at least
1328 in part. All arguments not mentioned below update the fields with the
1329 same name in the aqorders table of the Koha database.
1331 If a partial order is received, splits the order into two.
1333 Updates the order with bibilionumber C<$biblionumber> and ordernumber
1339 sub ModReceiveOrder {
1341 $biblionumber, $ordernumber, $quantrec, $user, $cost, $ecost,
1342 $invoiceid, $rrp, $budget_id, $datereceived, $received_items
1346 my $dbh = C4::Context->dbh;
1347 $datereceived = C4::Dates->output('iso') unless $datereceived;
1348 my $suggestionid = GetSuggestionFromBiblionumber( $biblionumber );
1349 if ($suggestionid) {
1350 ModSuggestion( {suggestionid=>$suggestionid,
1351 STATUS=>'AVAILABLE',
1352 biblionumber=> $biblionumber}
1356 my $sth=$dbh->prepare("
1357 SELECT * FROM aqorders
1358 WHERE biblionumber=? AND aqorders.ordernumber=?");
1360 $sth->execute($biblionumber,$ordernumber);
1361 my $order = $sth->fetchrow_hashref();
1364 my $new_ordernumber = $ordernumber;
1365 if ( $order->{quantity} > $quantrec ) {
1366 # Split order line in two parts: the first is the original order line
1367 # without received items (the quantity is decreased),
1368 # the second part is a new order line with quantity=quantityrec
1369 # (entirely received)
1370 $sth=$dbh->prepare("
1373 WHERE ordernumber = ?
1376 $sth->execute($order->{quantity} - $quantrec, $ordernumber);
1380 delete $order->{'ordernumber'};
1381 $order->{'quantity'} = $quantrec;
1382 $order->{'quantityreceived'} = $quantrec;
1383 $order->{'datereceived'} = $datereceived;
1384 $order->{'invoiceid'} = $invoiceid;
1385 $order->{'unitprice'} = $cost;
1386 $order->{'rrp'} = $rrp;
1387 $order->{ecost} = $ecost;
1388 $order->{'orderstatus'} = 3; # totally received
1389 $new_ordernumber = NewOrder($order);
1391 if ($received_items) {
1392 foreach my $itemnumber (@$received_items) {
1393 ModItemOrder($itemnumber, $new_ordernumber);
1397 $sth=$dbh->prepare("update aqorders
1398 set quantityreceived=?,datereceived=?,invoiceid=?,
1399 unitprice=?,rrp=?,ecost=?
1400 where biblionumber=? and ordernumber=?");
1401 $sth->execute($quantrec,$datereceived,$invoiceid,$cost,$rrp,$ecost,$biblionumber,$ordernumber);
1404 return ($datereceived, $new_ordernumber);
1407 =head3 CancelReceipt
1409 my $parent_ordernumber = CancelReceipt($ordernumber);
1411 Cancel an order line receipt and update the parent order line, as if no
1413 If items are created at receipt (AcqCreateItem = receiving) then delete
1419 my $ordernumber = shift;
1421 return unless $ordernumber;
1423 my $dbh = C4::Context->dbh;
1425 SELECT datereceived, parent_ordernumber, quantity
1427 WHERE ordernumber = ?
1429 my $sth = $dbh->prepare($query);
1430 $sth->execute($ordernumber);
1431 my $order = $sth->fetchrow_hashref;
1433 warn "CancelReceipt: order $ordernumber does not exist";
1436 unless($order->{'datereceived'}) {
1437 warn "CancelReceipt: order $ordernumber is not received";
1441 my $parent_ordernumber = $order->{'parent_ordernumber'};
1443 if($parent_ordernumber == $ordernumber || not $parent_ordernumber) {
1444 # The order line has no parent, just mark it as not received
1447 SET quantityreceived = ?,
1450 WHERE ordernumber = ?
1452 $sth = $dbh->prepare($query);
1453 $sth->execute(0, undef, undef, $ordernumber);
1455 # The order line has a parent, increase parent quantity and delete
1458 SELECT quantity, datereceived
1460 WHERE ordernumber = ?
1462 $sth = $dbh->prepare($query);
1463 $sth->execute($parent_ordernumber);
1464 my $parent_order = $sth->fetchrow_hashref;
1465 unless($parent_order) {
1466 warn "Parent order $parent_ordernumber does not exist.";
1469 if($parent_order->{'datereceived'}) {
1470 warn "CancelReceipt: parent order is received.".
1471 " Can't cancel receipt.";
1477 WHERE ordernumber = ?
1479 $sth = $dbh->prepare($query);
1480 my $rv = $sth->execute(
1481 $order->{'quantity'} + $parent_order->{'quantity'},
1485 warn "Cannot update parent order line, so do not cancel".
1489 if(C4::Context->preference('AcqCreateItem') eq 'receiving') {
1490 # Remove items that were created at receipt
1492 DELETE FROM items, aqorders_items
1493 USING items, aqorders_items
1494 WHERE items.itemnumber = ? AND aqorders_items.itemnumber = ?
1496 $sth = $dbh->prepare($query);
1497 my @itemnumbers = GetItemnumbersFromOrder($ordernumber);
1498 foreach my $itemnumber (@itemnumbers) {
1499 $sth->execute($itemnumber, $itemnumber);
1503 my @itemnumbers = GetItemnumbersFromOrder($ordernumber);
1504 foreach my $itemnumber (@itemnumbers) {
1505 ModItemOrder($itemnumber, $parent_ordernumber);
1510 DELETE FROM aqorders
1511 WHERE ordernumber = ?
1513 $sth = $dbh->prepare($query);
1514 $sth->execute($ordernumber);
1518 return $parent_ordernumber;
1521 #------------------------------------------------------------#
1525 @results = &SearchOrder($search, $biblionumber, $complete);
1527 Searches for orders.
1529 C<$search> may take one of several forms: if it is an ISBN,
1530 C<&ordersearch> returns orders with that ISBN. If C<$search> is an
1531 order number, C<&ordersearch> returns orders with that order number
1532 and biblionumber C<$biblionumber>. Otherwise, C<$search> is considered
1533 to be a space-separated list of search terms; in this case, all of the
1534 terms must appear in the title (matching the beginning of title
1537 If C<$complete> is C<yes>, the results will include only completed
1538 orders. In any case, C<&ordersearch> ignores cancelled orders.
1540 C<&ordersearch> returns an array.
1541 C<@results> is an array of references-to-hash with the following keys:
1547 =item C<seriestitle>
1558 #### -------- SearchOrder-------------------------------
1559 my ( $ordernumber, $search, $ean, $supplierid, $basket ) = @_;
1561 my $dbh = C4::Context->dbh;
1566 LEFT JOIN biblio ON aqorders.biblionumber=biblio.biblionumber
1567 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
1568 LEFT JOIN aqbasket ON aqorders.basketno = aqbasket.basketno
1569 WHERE (datecancellationprinted is NULL)";
1572 $query .= " AND (aqorders.ordernumber=?)";
1573 push @args, $ordernumber;
1576 $query .= " AND (biblio.title like ? OR biblio.author LIKE ? OR biblioitems.isbn like ?)";
1577 push @args, ("%$search%","%$search%","%$search%");
1580 $query .= " AND biblioitems.ean = ?";
1584 $query .= "AND aqbasket.booksellerid = ?";
1585 push @args, $supplierid;
1588 $query .= "AND aqorders.basketno = ?";
1589 push @args, $basket;
1592 my $sth = $dbh->prepare($query);
1593 $sth->execute(@args);
1594 my $results = $sth->fetchall_arrayref({});
1599 #------------------------------------------------------------#
1603 &DelOrder($biblionumber, $ordernumber);
1605 Cancel the order with the given order and biblio numbers. It does not
1606 delete any entries in the aqorders table, it merely marks them as
1612 my ( $bibnum, $ordernumber ) = @_;
1613 my $dbh = C4::Context->dbh;
1616 SET datecancellationprinted=now()
1617 WHERE biblionumber=? AND ordernumber=?
1619 my $sth = $dbh->prepare($query);
1620 $sth->execute( $bibnum, $ordernumber );
1622 my @itemnumbers = GetItemnumbersFromOrder( $ordernumber );
1623 foreach my $itemnumber (@itemnumbers){
1624 C4::Items::DelItem( $dbh, $bibnum, $itemnumber );
1629 =head2 FUNCTIONS ABOUT PARCELS
1633 #------------------------------------------------------------#
1637 @results = &GetParcel($booksellerid, $code, $date);
1639 Looks up all of the received items from the supplier with the given
1640 bookseller ID at the given date, for the given code (bookseller Invoice number). Ignores cancelled and completed orders.
1642 C<@results> is an array of references-to-hash. The keys of each element are fields from
1643 the aqorders, biblio, and biblioitems tables of the Koha database.
1645 C<@results> is sorted alphabetically by book title.
1650 #gets all orders from a certain supplier, orders them alphabetically
1651 my ( $supplierid, $code, $datereceived ) = @_;
1652 my $dbh = C4::Context->dbh;
1655 if $code; # add % if we search on a given code (otherwise, let him empty)
1657 SELECT authorisedby,
1662 aqorders.biblionumber,
1663 aqorders.ordernumber,
1664 aqorders.parent_ordernumber,
1666 aqorders.quantityreceived,
1674 LEFT JOIN aqbasket ON aqbasket.basketno=aqorders.basketno
1675 LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber
1676 LEFT JOIN biblio ON aqorders.biblionumber=biblio.biblionumber
1677 LEFT JOIN aqinvoices ON aqorders.invoiceid = aqinvoices.invoiceid
1679 aqbasket.booksellerid = ?
1680 AND aqinvoices.invoicenumber LIKE ?
1681 AND aqorders.datereceived = ? ";
1683 my @query_params = ( $supplierid, $code, $datereceived );
1684 if ( C4::Context->preference("IndependentBranches") ) {
1685 my $userenv = C4::Context->userenv;
1686 if ( ($userenv) && ( $userenv->{flags} != 1 ) ) {
1687 $strsth .= " and (borrowers.branchcode = ?
1688 or borrowers.branchcode = '')";
1689 push @query_params, $userenv->{branch};
1692 $strsth .= " ORDER BY aqbasket.basketno";
1693 # ## parcelinformation : $strsth
1694 my $sth = $dbh->prepare($strsth);
1695 $sth->execute( @query_params );
1696 while ( my $data = $sth->fetchrow_hashref ) {
1697 push( @results, $data );
1699 # ## countparcelbiblio: scalar(@results)
1705 #------------------------------------------------------------#
1709 $results = &GetParcels($bookseller, $order, $code, $datefrom, $dateto);
1711 get a lists of parcels.
1718 is the bookseller this function has to get parcels.
1721 To know on what criteria the results list has to be ordered.
1724 is the booksellerinvoicenumber.
1726 =item $datefrom & $dateto
1727 to know on what date this function has to filter its search.
1732 a pointer on a hash list containing parcel informations as such :
1738 =item Last operation
1740 =item Number of biblio
1742 =item Number of items
1749 my ($bookseller,$order, $code, $datefrom, $dateto) = @_;
1750 my $dbh = C4::Context->dbh;
1751 my @query_params = ();
1753 SELECT aqinvoices.invoicenumber,
1754 datereceived,purchaseordernumber,
1755 count(DISTINCT biblionumber) AS biblio,
1756 sum(quantity) AS itemsexpected,
1757 sum(quantityreceived) AS itemsreceived
1758 FROM aqorders LEFT JOIN aqbasket ON aqbasket.basketno = aqorders.basketno
1759 LEFT JOIN aqinvoices ON aqorders.invoiceid = aqinvoices.invoiceid
1760 WHERE aqbasket.booksellerid = ? and datereceived IS NOT NULL
1762 push @query_params, $bookseller;
1764 if ( defined $code ) {
1765 $strsth .= ' and aqinvoices.invoicenumber like ? ';
1766 # add a % to the end of the code to allow stemming.
1767 push @query_params, "$code%";
1770 if ( defined $datefrom ) {
1771 $strsth .= ' and datereceived >= ? ';
1772 push @query_params, $datefrom;
1775 if ( defined $dateto ) {
1776 $strsth .= 'and datereceived <= ? ';
1777 push @query_params, $dateto;
1780 $strsth .= "group by aqinvoices.invoicenumber,datereceived ";
1782 # can't use a placeholder to place this column name.
1783 # but, we could probably be checking to make sure it is a column that will be fetched.
1784 $strsth .= "order by $order " if ($order);
1786 my $sth = $dbh->prepare($strsth);
1788 $sth->execute( @query_params );
1789 my $results = $sth->fetchall_arrayref({});
1794 #------------------------------------------------------------#
1796 =head3 GetLateOrders
1798 @results = &GetLateOrders;
1800 Searches for bookseller with late orders.
1803 the table of supplier with late issues. This table is full of hashref.
1809 my $supplierid = shift;
1811 my $estimateddeliverydatefrom = shift;
1812 my $estimateddeliverydateto = shift;
1814 my $dbh = C4::Context->dbh;
1816 #BEWARE, order of parenthesis and LEFT JOIN is important for speed
1817 my $dbdriver = C4::Context->config("db_scheme") || "mysql";
1819 my @query_params = ();
1821 SELECT aqbasket.basketno,
1822 aqorders.ordernumber,
1823 DATE(aqbasket.closedate) AS orderdate,
1824 aqorders.rrp AS unitpricesupplier,
1825 aqorders.ecost AS unitpricelib,
1826 aqorders.claims_count AS claims_count,
1827 aqorders.claimed_date AS claimed_date,
1828 aqbudgets.budget_name AS budget,
1829 borrowers.branchcode AS branch,
1830 aqbooksellers.name AS supplier,
1831 aqbooksellers.id AS supplierid,
1832 biblio.author, biblio.title,
1833 biblioitems.publishercode AS publisher,
1834 biblioitems.publicationyear,
1835 ADDDATE(aqbasket.closedate, INTERVAL aqbooksellers.deliverytime DAY) AS estimateddeliverydate,
1839 aqorders LEFT JOIN biblio ON biblio.biblionumber = aqorders.biblionumber
1840 LEFT JOIN biblioitems ON biblioitems.biblionumber = biblio.biblionumber
1841 LEFT JOIN aqbudgets ON aqorders.budget_id = aqbudgets.budget_id,
1842 aqbasket LEFT JOIN borrowers ON aqbasket.authorisedby = borrowers.borrowernumber
1843 LEFT JOIN aqbooksellers ON aqbasket.booksellerid = aqbooksellers.id
1844 WHERE aqorders.basketno = aqbasket.basketno
1845 AND ( datereceived = ''
1846 OR datereceived IS NULL
1847 OR aqorders.quantityreceived < aqorders.quantity
1849 AND aqbasket.closedate IS NOT NULL
1850 AND (aqorders.datecancellationprinted IS NULL OR aqorders.datecancellationprinted='0000-00-00')
1853 if ($dbdriver eq "mysql") {
1855 aqorders.quantity - COALESCE(aqorders.quantityreceived,0) AS quantity,
1856 (aqorders.quantity - COALESCE(aqorders.quantityreceived,0)) * aqorders.rrp AS subtotal,
1857 DATEDIFF(CAST(now() AS date),closedate) AS latesince
1859 if ( defined $delay ) {
1860 $from .= " AND (closedate <= DATE_SUB(CAST(now() AS date),INTERVAL ? DAY)) " ;
1861 push @query_params, $delay;
1864 HAVING quantity <> 0
1865 AND unitpricesupplier <> 0
1866 AND unitpricelib <> 0
1869 # FIXME: account for IFNULL as above
1871 aqorders.quantity AS quantity,
1872 aqorders.quantity * aqorders.rrp AS subtotal,
1873 (CAST(now() AS date) - closedate) AS latesince
1875 if ( defined $delay ) {
1876 $from .= " AND (closedate <= (CAST(now() AS date) -(INTERVAL ? DAY)) ";
1877 push @query_params, $delay;
1880 if (defined $supplierid) {
1881 $from .= ' AND aqbasket.booksellerid = ? ';
1882 push @query_params, $supplierid;
1884 if (defined $branch) {
1885 $from .= ' AND borrowers.branchcode LIKE ? ';
1886 push @query_params, $branch;
1889 if ( defined $estimateddeliverydatefrom or defined $estimateddeliverydateto ) {
1890 $from .= ' AND aqbooksellers.deliverytime IS NOT NULL ';
1892 if ( defined $estimateddeliverydatefrom ) {
1893 $from .= ' AND ADDDATE(aqbasket.closedate, INTERVAL aqbooksellers.deliverytime DAY) >= ?';
1894 push @query_params, $estimateddeliverydatefrom;
1896 if ( defined $estimateddeliverydateto ) {
1897 $from .= ' AND ADDDATE(aqbasket.closedate, INTERVAL aqbooksellers.deliverytime DAY) <= ?';
1898 push @query_params, $estimateddeliverydateto;
1900 if ( defined $estimateddeliverydatefrom and not defined $estimateddeliverydateto ) {
1901 $from .= ' AND ADDDATE(aqbasket.closedate, INTERVAL aqbooksellers.deliverytime DAY) <= CAST(now() AS date)';
1903 if (C4::Context->preference("IndependentBranches")
1904 && C4::Context->userenv
1905 && C4::Context->userenv->{flags} != 1 ) {
1906 $from .= ' AND borrowers.branchcode LIKE ? ';
1907 push @query_params, C4::Context->userenv->{branch};
1909 my $query = "$select $from $having\nORDER BY latesince, basketno, borrowers.branchcode, supplier";
1910 $debug and print STDERR "GetLateOrders query: $query\nGetLateOrders args: " . join(" ",@query_params);
1911 my $sth = $dbh->prepare($query);
1912 $sth->execute(@query_params);
1914 while (my $data = $sth->fetchrow_hashref) {
1915 $data->{orderdate} = format_date($data->{orderdate});
1916 $data->{claimed_date} = format_date($data->{claimed_date});
1917 push @results, $data;
1922 #------------------------------------------------------------#
1926 (\@order_loop, $total_qty, $total_price, $total_qtyreceived) = GetHistory( %params );
1928 Retreives some acquisition history information
1936 basket - search both basket name and number
1937 booksellerinvoicenumber
1940 $order_loop is a list of hashrefs that each look like this:
1942 'author' => 'Twain, Mark',
1944 'biblionumber' => '215',
1946 'creationdate' => 'MM/DD/YYYY',
1947 'datereceived' => undef,
1950 'invoicenumber' => undef,
1952 'ordernumber' => '1',
1954 'quantityreceived' => undef,
1955 'title' => 'The Adventures of Huckleberry Finn'
1957 $total_qty is the sum of all of the quantities in $order_loop
1958 $total_price is the cost of each in $order_loop times the quantity
1959 $total_qtyreceived is the sum of all of the quantityreceived entries in $order_loop
1964 # don't run the query if there are no parameters (list would be too long for sure !)
1965 croak "No search params" unless @_;
1967 my $title = $params{title};
1968 my $author = $params{author};
1969 my $isbn = $params{isbn};
1970 my $ean = $params{ean};
1971 my $name = $params{name};
1972 my $from_placed_on = $params{from_placed_on};
1973 my $to_placed_on = $params{to_placed_on};
1974 my $basket = $params{basket};
1975 my $booksellerinvoicenumber = $params{booksellerinvoicenumber};
1976 my $basketgroupname = $params{basketgroupname};
1979 my $total_qtyreceived = 0;
1980 my $total_price = 0;
1982 my $dbh = C4::Context->dbh;
1990 aqbasket.basketname,
1991 aqbasket.basketgroupid,
1992 aqbasketgroups.name as groupname,
1994 aqbasket.creationdate,
1995 aqorders.datereceived,
1997 aqorders.quantityreceived,
1999 aqorders.ordernumber,
2001 aqinvoices.invoicenumber,
2002 aqbooksellers.id as id,
2003 aqorders.biblionumber
2005 LEFT JOIN aqbasket ON aqorders.basketno=aqbasket.basketno
2006 LEFT JOIN aqbasketgroups ON aqbasket.basketgroupid=aqbasketgroups.id
2007 LEFT JOIN aqbooksellers ON aqbasket.booksellerid=aqbooksellers.id
2008 LEFT JOIN biblioitems ON biblioitems.biblionumber=aqorders.biblionumber
2009 LEFT JOIN biblio ON biblio.biblionumber=aqorders.biblionumber
2010 LEFT JOIN aqinvoices ON aqorders.invoiceid = aqinvoices.invoiceid";
2012 $query .= " LEFT JOIN borrowers ON aqbasket.authorisedby=borrowers.borrowernumber"
2013 if ( C4::Context->preference("IndependentBranches") );
2015 $query .= " WHERE (datecancellationprinted is NULL or datecancellationprinted='0000-00-00') ";
2017 my @query_params = ();
2020 $query .= " AND biblio.title LIKE ? ";
2021 $title =~ s/\s+/%/g;
2022 push @query_params, "%$title%";
2026 $query .= " AND biblio.author LIKE ? ";
2027 push @query_params, "%$author%";
2031 $query .= " AND biblioitems.isbn LIKE ? ";
2032 push @query_params, "%$isbn%";
2034 if ( defined $ean and $ean ) {
2035 $query .= " AND biblioitems.ean = ? ";
2036 push @query_params, "$ean";
2039 $query .= " AND aqbooksellers.name LIKE ? ";
2040 push @query_params, "%$name%";
2043 if ( $from_placed_on ) {
2044 $query .= " AND creationdate >= ? ";
2045 push @query_params, $from_placed_on;
2048 if ( $to_placed_on ) {
2049 $query .= " AND creationdate <= ? ";
2050 push @query_params, $to_placed_on;
2054 if ($basket =~ m/^\d+$/) {
2055 $query .= " AND aqorders.basketno = ? ";
2056 push @query_params, $basket;
2058 $query .= " AND aqbasket.basketname LIKE ? ";
2059 push @query_params, "%$basket%";
2063 if ($booksellerinvoicenumber) {
2064 $query .= " AND aqinvoices.invoicenumber LIKE ? ";
2065 push @query_params, "%$booksellerinvoicenumber%";
2068 if ($basketgroupname) {
2069 $query .= " AND aqbasketgroups.name LIKE ? ";
2070 push @query_params, "%$basketgroupname%";
2073 if ( C4::Context->preference("IndependentBranches") ) {
2074 my $userenv = C4::Context->userenv;
2075 if ( $userenv && ($userenv->{flags} || 0) != 1 ) {
2076 $query .= " AND (borrowers.branchcode = ? OR borrowers.branchcode ='' ) ";
2077 push @query_params, $userenv->{branch};
2080 $query .= " ORDER BY id";
2081 my $sth = $dbh->prepare($query);
2082 $sth->execute( @query_params );
2084 while ( my $line = $sth->fetchrow_hashref ) {
2085 $line->{count} = $cnt++;
2086 $line->{toggle} = 1 if $cnt % 2;
2087 push @order_loop, $line;
2088 $total_qty += $line->{'quantity'};
2089 $total_qtyreceived += $line->{'quantityreceived'};
2090 $total_price += $line->{'quantity'} * $line->{'ecost'};
2092 return \@order_loop, $total_qty, $total_price, $total_qtyreceived;
2095 =head2 GetRecentAcqui
2097 $results = GetRecentAcqui($days);
2099 C<$results> is a ref to a table which containts hashref
2103 sub GetRecentAcqui {
2105 my $dbh = C4::Context->dbh;
2109 ORDER BY timestamp DESC
2112 my $sth = $dbh->prepare($query);
2114 my $results = $sth->fetchall_arrayref({});
2120 $contractlist = &GetContracts($booksellerid, $activeonly);
2122 Looks up the contracts that belong to a bookseller
2124 Returns a list of contracts
2128 =item C<$booksellerid> is the "id" field in the "aqbooksellers" table.
2130 =item C<$activeonly> if exists get only contracts that are still active.
2137 my ( $booksellerid, $activeonly ) = @_;
2138 my $dbh = C4::Context->dbh;
2140 if (! $activeonly) {
2144 WHERE booksellerid=?
2149 WHERE booksellerid=?
2150 AND contractenddate >= CURDATE( )";
2152 my $sth = $dbh->prepare($query);
2153 $sth->execute( $booksellerid );
2155 while (my $data = $sth->fetchrow_hashref ) {
2156 push(@results, $data);
2162 #------------------------------------------------------------#
2166 $contract = &GetContract($contractID);
2168 Looks up the contract that has PRIMKEY (contractnumber) value $contractID
2175 my ( $contractno ) = @_;
2176 my $dbh = C4::Context->dbh;
2180 WHERE contractnumber=?
2183 my $sth = $dbh->prepare($query);
2184 $sth->execute( $contractno );
2185 my $result = $sth->fetchrow_hashref;
2193 &AddClaim($ordernumber);
2195 Add a claim for an order
2201 my ($ordernumber) = @_;
2202 my $dbh = C4::Context->dbh;
2205 claims_count = claims_count + 1,
2206 claimed_date = CURDATE()
2207 WHERE ordernumber = ?
2209 my $sth = $dbh->prepare($query);
2210 $sth->execute($ordernumber);
2215 my @invoices = GetInvoices(
2216 invoicenumber => $invoicenumber,
2217 suppliername => $suppliername,
2218 shipmentdatefrom => $shipmentdatefrom, # ISO format
2219 shipmentdateto => $shipmentdateto, # ISO format
2220 billingdatefrom => $billingdatefrom, # ISO format
2221 billingdateto => $billingdateto, # ISO format
2222 isbneanissn => $isbn_or_ean_or_issn,
2225 publisher => $publisher,
2226 publicationyear => $publicationyear,
2227 branchcode => $branchcode,
2228 order_by => $order_by
2231 Return a list of invoices that match all given criteria.
2233 $order_by is "column_name (asc|desc)", where column_name is any of
2234 'invoicenumber', 'booksellerid', 'shipmentdate', 'billingdate', 'closedate',
2235 'shipmentcost', 'shipmentcost_budgetid'.
2237 asc is the default if omitted
2244 my @columns = qw(invoicenumber booksellerid shipmentdate billingdate
2245 closedate shipmentcost shipmentcost_budgetid);
2247 my $dbh = C4::Context->dbh;
2249 SELECT aqinvoices.*, aqbooksellers.name AS suppliername,
2252 aqorders.datereceived IS NOT NULL,
2253 aqorders.biblionumber,
2256 ) AS receivedbiblios,
2257 SUM(aqorders.quantityreceived) AS receiveditems
2259 LEFT JOIN aqbooksellers ON aqbooksellers.id = aqinvoices.booksellerid
2260 LEFT JOIN aqorders ON aqorders.invoiceid = aqinvoices.invoiceid
2261 LEFT JOIN biblio ON aqorders.biblionumber = biblio.biblionumber
2262 LEFT JOIN biblioitems ON biblio.biblionumber = biblioitems.biblionumber
2263 LEFT JOIN subscription ON biblio.biblionumber = subscription.biblionumber
2268 if($args{supplierid}) {
2269 push @bind_strs, " aqinvoices.booksellerid = ? ";
2270 push @bind_args, $args{supplierid};
2272 if($args{invoicenumber}) {
2273 push @bind_strs, " aqinvoices.invoicenumber LIKE ? ";
2274 push @bind_args, "%$args{invoicenumber}%";
2276 if($args{suppliername}) {
2277 push @bind_strs, " aqbooksellers.name LIKE ? ";
2278 push @bind_args, "%$args{suppliername}%";
2280 if($args{shipmentdatefrom}) {
2281 push @bind_strs, " aqinvoices.shipementdate >= ? ";
2282 push @bind_args, $args{shipmentdatefrom};
2284 if($args{shipmentdateto}) {
2285 push @bind_strs, " aqinvoices.shipementdate <= ? ";
2286 push @bind_args, $args{shipmentdateto};
2288 if($args{billingdatefrom}) {
2289 push @bind_strs, " aqinvoices.billingdate >= ? ";
2290 push @bind_args, $args{billingdatefrom};
2292 if($args{billingdateto}) {
2293 push @bind_strs, " aqinvoices.billingdate <= ? ";
2294 push @bind_args, $args{billingdateto};
2296 if($args{isbneanissn}) {
2297 push @bind_strs, " (biblioitems.isbn LIKE ? OR biblioitems.ean LIKE ? OR biblioitems.issn LIKE ? ) ";
2298 push @bind_args, $args{isbneanissn}, $args{isbneanissn}, $args{isbneanissn};
2301 push @bind_strs, " biblio.title LIKE ? ";
2302 push @bind_args, $args{title};
2305 push @bind_strs, " biblio.author LIKE ? ";
2306 push @bind_args, $args{author};
2308 if($args{publisher}) {
2309 push @bind_strs, " biblioitems.publishercode LIKE ? ";
2310 push @bind_args, $args{publisher};
2312 if($args{publicationyear}) {
2313 push @bind_strs, " biblioitems.publicationyear = ? ";
2314 push @bind_args, $args{publicationyear};
2316 if($args{branchcode}) {
2317 push @bind_strs, " aqorders.branchcode = ? ";
2318 push @bind_args, $args{branchcode};
2321 $query .= " WHERE " . join(" AND ", @bind_strs) if @bind_strs;
2322 $query .= " GROUP BY aqinvoices.invoiceid ";
2324 if($args{order_by}) {
2325 my ($column, $direction) = split / /, $args{order_by};
2326 if(grep /^$column$/, @columns) {
2327 $direction ||= 'ASC';
2328 $query .= " ORDER BY $column $direction";
2332 my $sth = $dbh->prepare($query);
2333 $sth->execute(@bind_args);
2335 my $results = $sth->fetchall_arrayref({});
2341 my $invoice = GetInvoice($invoiceid);
2343 Get informations about invoice with given $invoiceid
2345 Return a hash filled with aqinvoices.* fields
2350 my ($invoiceid) = @_;
2353 return unless $invoiceid;
2355 my $dbh = C4::Context->dbh;
2361 my $sth = $dbh->prepare($query);
2362 $sth->execute($invoiceid);
2364 $invoice = $sth->fetchrow_hashref;
2368 =head3 GetInvoiceDetails
2370 my $invoice = GetInvoiceDetails($invoiceid)
2372 Return informations about an invoice + the list of related order lines
2374 Orders informations are in $invoice->{orders} (array ref)
2378 sub GetInvoiceDetails {
2379 my ($invoiceid) = @_;
2381 if ( !defined $invoiceid ) {
2382 carp 'GetInvoiceDetails called without an invoiceid';
2386 my $dbh = C4::Context->dbh;
2388 SELECT aqinvoices.*, aqbooksellers.name AS suppliername
2390 LEFT JOIN aqbooksellers ON aqinvoices.booksellerid = aqbooksellers.id
2393 my $sth = $dbh->prepare($query);
2394 $sth->execute($invoiceid);
2396 my $invoice = $sth->fetchrow_hashref;
2399 SELECT aqorders.*, biblio.*
2401 LEFT JOIN biblio ON aqorders.biblionumber = biblio.biblionumber
2404 $sth = $dbh->prepare($query);
2405 $sth->execute($invoiceid);
2406 $invoice->{orders} = $sth->fetchall_arrayref({});
2407 $invoice->{orders} ||= []; # force an empty arrayref if fetchall_arrayref fails
2414 my $invoiceid = AddInvoice(
2415 invoicenumber => $invoicenumber,
2416 booksellerid => $booksellerid,
2417 shipmentdate => $shipmentdate,
2418 billingdate => $billingdate,
2419 closedate => $closedate,
2420 shipmentcost => $shipmentcost,
2421 shipmentcost_budgetid => $shipmentcost_budgetid
2424 Create a new invoice and return its id or undef if it fails.
2431 return unless(%invoice and $invoice{invoicenumber});
2433 my @columns = qw(invoicenumber booksellerid shipmentdate billingdate
2434 closedate shipmentcost shipmentcost_budgetid);
2438 foreach my $key (keys %invoice) {
2439 if(0 < grep(/^$key$/, @columns)) {
2440 push @set_strs, "$key = ?";
2441 push @set_args, ($invoice{$key} || undef);
2447 my $dbh = C4::Context->dbh;
2448 my $query = "INSERT INTO aqinvoices SET ";
2449 $query .= join (",", @set_strs);
2450 my $sth = $dbh->prepare($query);
2451 $rv = $sth->execute(@set_args);
2453 $rv = $dbh->last_insert_id(undef, undef, 'aqinvoices', undef);
2462 invoiceid => $invoiceid, # Mandatory
2463 invoicenumber => $invoicenumber,
2464 booksellerid => $booksellerid,
2465 shipmentdate => $shipmentdate,
2466 billingdate => $billingdate,
2467 closedate => $closedate,
2468 shipmentcost => $shipmentcost,
2469 shipmentcost_budgetid => $shipmentcost_budgetid
2472 Modify an invoice, invoiceid is mandatory.
2474 Return undef if it fails.
2481 return unless(%invoice and $invoice{invoiceid});
2483 my @columns = qw(invoicenumber booksellerid shipmentdate billingdate
2484 closedate shipmentcost shipmentcost_budgetid);
2488 foreach my $key (keys %invoice) {
2489 if(0 < grep(/^$key$/, @columns)) {
2490 push @set_strs, "$key = ?";
2491 push @set_args, ($invoice{$key} || undef);
2495 my $dbh = C4::Context->dbh;
2496 my $query = "UPDATE aqinvoices SET ";
2497 $query .= join(",", @set_strs);
2498 $query .= " WHERE invoiceid = ?";
2500 my $sth = $dbh->prepare($query);
2501 $sth->execute(@set_args, $invoice{invoiceid});
2506 CloseInvoice($invoiceid);
2510 Equivalent to ModInvoice(invoiceid => $invoiceid, closedate => undef);
2515 my ($invoiceid) = @_;
2517 return unless $invoiceid;
2519 my $dbh = C4::Context->dbh;
2522 SET closedate = CAST(NOW() AS DATE)
2525 my $sth = $dbh->prepare($query);
2526 $sth->execute($invoiceid);
2529 =head3 ReopenInvoice
2531 ReopenInvoice($invoiceid);
2535 Equivalent to ModInvoice(invoiceid => $invoiceid, closedate => C4::Dates->new()->output('iso'))
2540 my ($invoiceid) = @_;
2542 return unless $invoiceid;
2544 my $dbh = C4::Context->dbh;
2547 SET closedate = NULL
2550 my $sth = $dbh->prepare($query);
2551 $sth->execute($invoiceid);
2556 DelInvoice($invoiceid);
2558 Delete an invoice if there are no items attached to it.
2563 my ($invoiceid) = @_;
2565 return unless $invoiceid;
2567 my $dbh = C4::Context->dbh;
2573 my $sth = $dbh->prepare($query);
2574 $sth->execute($invoiceid);
2575 my $res = $sth->fetchrow_arrayref;
2576 if ( $res && $res->[0] == 0 ) {
2578 DELETE FROM aqinvoices
2581 my $sth = $dbh->prepare($query);
2582 return ( $sth->execute($invoiceid) > 0 );
2592 Koha Development Team <http://koha-community.org/>