projekt kivitendo

  # stock, get "what's there" for a part with various conditions:

  my $qty = get_stock(part => $part);                              # how much is on stock?

  my $qty = get_stock(part => $part, date => $date);               # how much was on stock at a specific time?

  # onhand, get "what's available" for a part with various conditions:

  my $qty = get_onhand(part => $part);                              # how much is available?

  );

  # allocate:

    part         => $part,          # part_id works too

    qty          => $qty,           # must be positive

    chargenumber => $chargenumber,  # optional, may be arrayref. if provided these charges will be used first

  );

  # shortcut to allocate all that is needed for producing an assembly, will use chargenumbers as appropriate

    part         => $assembly,      # part_id works too

    qty          => $qty,           # must be positive

  );

  my $allocation = SL::Helper::Inventory::Allocation->new(

    part_id           => $part->id,

    qty               => 15,

    chargenumber => $chargenumber,  # optional

    bestbefore   => $datetime,      # optional

    comment      => $comment,       # optional

  );

=head1 DESCRIPTION

New functions for the warehouse and inventory api.

the current stock for an item, it's extremely complicated to use it to produce

assemblies while ensuring that no stock ends up negative, and it's very hard to

use it to get an overview over the actual contents of the inventory.

there.

=item * Onhand is what is available, which means things that are stocked,

=back

target of the production, and requires allocations to complete the request. The

allocations can be supplied manually, or can be generated automatically.

C<produce_assembly> will check whether enough allocations are given to create

allocations are not sufficient or if the auto-allocation fails an exception

is returned. If you need to produce something that is not in the inventory, you

can bypass those checks by creating the allocations yourself (see

    the internal ordering of the hints is fixed and more complex preferentials

    are not supported.

  * bestbefore handling is untested

=head1 TODO

  * define and describe error classes

  * define wrapper classes for stock/onhand batch mode return values

  * handle extra arguments in produce: shippingdate, project

  * document no_ check

  * tests

=head1 AUTHOR

=cut