create

Create an invoice in the FreshBooks system.

my $invoice = $fb->invoice->create({...});

get

    my $invoice = $fb->invoice->get({ invoice_id => $invoice_id });

delete

    my $invoice = $fb->invoice->get({ invoice_id => $invoice_id });
    $invoice->delete;

update

    # update after edits
    $invoice->organization('Perl Foundation');
    $invoice->update;
    # or immediately
    $invoice->update( { organization => 'Perl Foundation', } );

links

Returns a Net::FreshBooks::API::Links object, which returns FreshBooks URLs.

    print "send this url to client: " . $invoice->links->client_view;

list

Returns a Net::FreshBooks::API::Iterator object.

    # list unpaid invoices
    my $invoices = $fb->invoice->list({ status => 'unpaid' });
    while ( my $invoice = $invoices->next ) {
        print $invoice->invoice_id, "\n";
    }

lines

Returns an ARRAYREF of Net::FreshBooks::API::InvoiceLine objects

    foreach my $line ( @{ $invoice->lines } ) {
        print $line->amount, "\n";
    }

add_line

Create a new Net::FreshBooks::API::InvoiceLine object and add it to the end of the list of lines

    my $bool = $invoice->add_line(
        {   name         => "Yard Work",          # (Optional)
            description  => "Mowed the lawn.",    # (Optional)
            unit_cost    => 10,                   # Default is 0
            quantity     => 4,                    # Default is 0
            tax1_name    => "GST",                # (Optional)
            tax2_name    => "PST",                # (Optional)
            tax1_percent => 8,                    # (Optional)
            tax2_percent => 6,                    # (Optional)
        }
    );

send_by_email

Send the invoice by email.

  my $result = $invoice->send_by_email();

send_by_snail_mail

Send the invoice by snail mail.

  my $result = $invoice->send_by_snail_mail();