Get invoice

The Get invoice method returns invoice details for the current reseller or any of its downstream resellers.

An API token of a manager is required for authorization. To get an API token via the Operator Control Panel, see Viewing and updating Manager's information.

The manager's API token specified in an API request determines:

The role and access level of the manager, which determine the availability of a method.
The current reseller and downstream resellers accessible within a method.

GET {base_url}/api/v3/resellers/{reseller_id}/invoices/{invoice_id}

Arguments

Name

Parameter Type

Data type

Required/Optional

Description

X-Api-Token header string Required API token of a manager that performs the operation (see Viewing and updating Manager's information)

Content-Type header string Required Media type of the request. Specify the following: application/vnd.api+json

Accept

header

string

Required

Supported media types of the answer. Specify the following: application/vnd.api+json

base_url path string Required ActivePlatform URL

reseller_id

path

integer

Required

ID of the current reseller or of any its downstream resellers (see Viewing and updating Reseller general information)

invoice_id path integer Required Invoice ID

include

query

string

Optional

Returns additional information about objects related to the invoice. The parameter can be a comma-separated list if information about several objects is required. The following objects and possible values are supported:

Object	Parameter value
Subscriptions	`subscriptions`
Payments	`payments`
Charges	`charges`
Corrections	`corrections`
Taxes	`taxes`

Response model

Name

Data type

Description

data object Response data

id

string

Invoice ID

type string Data type

attributes object Invoice information

created_at

string

Date and time of the invoice creation

updated_at

string

Date and time of the invoice update

document_id

string

Invoice number

status

string

Invoice status

total

string

Invoice total

account_id

integer

ID of the account for which the invoice was issued

from_date

string

Start date of the period covered by the invoice (YYYY-MM-DD)

to_date

string

End date of the period covered by the invoice (YYYY-MM-DD)

payment_model

string

Invoice payment model:

prepay
postpay

approved

bool

Indicates whether it is an approved postpaid invoice with external management (see Invoices with external management):

true — a postpaid invoice with external management, and a third-party ERP system approved it.
false — in all other cases:
- A postpaid invoice with external management, and a third-party ERP system did not approved it yet.
- A postpaid invoice managed by the platform.
- A prepaid invoice.

relationships

object

Related objects

subscriptions object List of subscriptions included in the invoice

data

array

Related object information:

Name		Data type	Description
id		string	ID of the object
type		string	Data type

payments

object

List of payments included in the invoice

data

array

Related object information:

Name		Data type	Description
id		string	ID of the object
type		string	Data type

charges

object

List of charges included in the invoice

data

array

Related object information:

Name		Data type	Description
id		string	ID of the object
type		string	Data type

corrections

object

List of corrections included in the invoice

data

array

Related object information:

Name		Data type	Description
id		string	ID of the object
type		string	Data type

taxes object List of taxes for charges included in the invoice

data

array

Related object information:

Name		Data type	Description
id		string	ID of the object
type		string	Data type

included

array

Additional information about objects listed in the request:

Name	Data type	Description
id	integer	ID of the object
type	string	Data type
attributes	array	Attributes of the object (see details below)

For a payment, see Get payment.
For a charge, see Get end-customer charge.
For a subscription:

Name			Data type	Description
id			string	ID of the subscription
type			string	Data type
attributes			object	Subscription details
	created_at		string	Date and time of the subscription creation
	updated_at		string	Date and time when the subscription was updated
	auto_renewal		bool	The automatic subscription renewal option: true — The automatic subscription renewal is enabled. false — The automatic subscription renewal is off.
	billing_from		string	The start date of generating charges for the subscription (YYYY-MM-DD)
	expiration_date		string	The expiration date of the subscription (YYYY-MM-DD)
	name		string	Name of the subscription
	auto_renew_point_days		integer	Auto-renew point (in days)
	start_date		string	The date of activation of the subscription (YYYY-MM-DD)
	status		string	Status of the subscription (for the list of subscription statuses, see Viewing the list of Resellers Subscriptions)
	payment_model		string	Subscription payment model: prepay postpay
	payment_model_parameters		object	Payment model parameters
		credit_limit	number	The value of the subscription debt, above which the postpaid subscription will be stopped. For postpaid subscriptions only (`payment_model = postpay`)
		current_debt	number	The subscription debt that is calculated as the total amount of all blocked charges for the subscription for the current billing period. For postpaid subscriptions only (`payment_model = postpay`)

For a correction:

Name		Data type	Description
id		string	ID of the correction
type		string	Data type
attributes		object	Сorrection details
	created_at	string	Date and time of the correction creation
	updated_at	string	Date and time when the correction was updated
	account_id	integer	Account ID
	status	string	Correction status
	total	string	Correction total amount
	comment	string	Additional information about the correction
	period_from	string	Beginning of the period for which the correction was created
	period_to	string	End of the period for which the correction was created
	approved_at	string	Date and time of the correction approval
	subscription_id	integer	ID of the subscription for which the correction was applied

For every tax used to calculate a charge:

Название		Тип данных	Описание
id		string	The tax ID
type		string	Data type
attributes		object	Tax details
	created_at	string	Date and time of the tax creation
	updated_at	string	Date and time when the tax was updated
	charge_id	integer	The ID of the related charge
	origin_id	integer	The tax ID in the taxation module
	name	string	The tax name
	code	string	The tax code
	rate	number	The tax rate percentage
	amount	string	The tax amount calculated for `net_amount` of the charge

Request example

GET /api/v3/resellers/1/invoices/3973?include=subscriptions,payments,charges,corrections,taxes
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example

{
    "data": {
        "id": "3973",
        "type": "invoices",
        "attributes": {
            "created_at": "2021-03-02T01:12:58.186820+0300",
            "updated_at": "2021-03-02T01:12:58.380559+0300",
            "document_id": "003661",
            "status": "closed",
            "total": "220.0",
            "account_id": 906,
            "from_date": "2021-02-01",
            "to_date": "2021-03-01",
            "payment_model": "prepay",
            "approved": "false"
        },
        "relationships": {
            "subscriptions": {
                "data": [
                    {
                        "id": "3007572",
                        "type": "subscriptions"
                    },
                    {
                        "id": "3007576",
                        "type": "subscriptions"
                    }
                ]
            },
            "payments": {
                "data": []
            },
            "charges": {
                "data": [
                    {
                        "id": "85176",
                        "type": "charges"
                    },
                    {
                        "id": "85229",
                        "type": "charges"
                    }
                ]
            },
            "corrections": {
                "data": []
            },
            "taxes": {
                "data": []
            }
        }
    },
    "included": [
        {
            "id": "3007572",
            "type": "subscriptions",
            "attributes": {
                ...
            }
        },
        {
            "id": "3007576",
            "type": "subscriptions",
            "attributes": {
                ...
            }
        },
        {
            "id": "85176",
            "type": "charges",
            "attributes": {
                ...
            },
            "relationships": {
                ...
            }
        },
        {
            "id": "85229",
            "type": "charges",
            "attributes": {
                ...
            },
            "relationships": {
                ...
            }
        }
    ]
}