NAME

Regru::API::Bill - REG.API v2 invoice management

VERSION

version 0.046

DESCRIPTION

REG.API invoices management section.

ATTRIBUTES

namespace

Always returns the name of category: bill. For internal uses only.

REG.API METHODS

nop

For testing purposes. Scope: everyone. Typical usage:

    $resp = $client->bill->nop(
        bill_id => 12345,
    );

    # or
    $resp = $client->bill->nop(
        bills => [ 12345, 12346 ],
    );

Returns payment status for requested invoice or error code (in some cases).

More info at Invoice management: nop.

get_not_payed

Obtains a list of unpaid invoices. Scope: clients. Typical usage:

    $resp = $client->bill->get_not_payed(
        limit => 10, offset => 40,
    );

Returns a list of unpaind invoices if any.

More info at Invoice management: get_not_payed.

get_for_period

Obtains a list of invoices for the defined period. Scope: partners. Typical usage:

    $resp = $client->bill->get_for_period(
        limit      => 5,
        start_date => '1917-10-26',
        end_date   => '1917-10-07',
    );

Returns a list of invoices at given period if any.

More info at Invoice management: get_for_period

change_pay_type

This one allows to change payment method for selected invoice(s). Scope: clients. Typical usage:

    $resp = $client->bill->change_pay_type(
        bills    => [ 12345, 12346 ],
        pay_type => 'prepay',
        currency => 'USD',
    );

Returns a list of invoices with payment information and status.

More info at Invoice management: change_pay_type

delete

Allows to delete unpaid invoices. Scope: clients. Typical usage:

    $resp = $client->bill->delete(
        bills => [ 12345, 12346, 12347 ],
    );

Returns a list of invoices which requested to delete and its status.

More info at Invoice management: delete

CAVEATS

Bear in mind that might be errors during API requests. You should always check API call status. See Common error codes.

SEE ALSO

Regru::API

Regru::API::Role::Client

REG.API Invoice management

REG.API Common error codes

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/regru/regru-api-perl/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHORS

• Polina Shubina <shubina@reg.ru>

• Anton Gerasimov <a.gerasimov@reg.ru>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by REG.RU LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Regru::API

perl -MCPAN -e shell
install Regru::API