---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/AccountManagement_Invoice.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Invoice.md
  - href: ru/live/AccountManagement_Invoice.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Invoice
Формирует счета на оплату в формате HTML.
При вызове операции указывают общие счета и суммы к оплате. Операция возвращает URL счета на оплату. Получить счет может пользователь, от лица которого вызван метод (пользователю необходимо авторизоваться на Яндексе).

## Рекомендации и ограничения

Рекомендуется формировать счета на оплату как можно меньшим количеством вызовов операции `AccountManagement.Invoice` в сутки. Данная рекомендация нацелена на повышение производительности API Яндекс Директа. С точки зрения производительности, лучше сформировать несколько счетов на оплату за одну операцию, чем использовать несколько операций для формирования каждого счета отдельно.

## Входные данные

Ниже показана структура входных данных в формате JSON.

<!-- source: ru/_includes/live/AccountManagement_Deposit/id-AccountManagement_Deposit/finance-token-attention.md -->
{% note alert %}

В запрос необходимо включать параметры `finance_token` и `operation_num`. 

{% endnote %}
<!-- endsource: ru/_includes/live/AccountManagement_Deposit/id-AccountManagement_Deposit/finance-token-attention.md -->


```javascript
{
   "method": "AccountManagement",
   "finance_token": (string),
   "operation_num": (int),
   "param": {
      /* AccountManagementRequest */
      "Action": (string),
      "Payments": [
         {  /* Payment */
            "AccountID": (int),
            "Amount": (float),
            "Currency": (string)
         }
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
|
**Требуется**
||

||
**Объект AccountManagementRequest**
||
||
`Action`
|
Выполняемая операция: Invoice.
|
Да
||
||
`Payments`
|
Массив объектов `Payment` (не более 50). Каждый объект содержит идентификатор общего счета и сумму оплаты.
|
Да
||

||
**Объект Payment**
||
||
`AccountID`
|
Идентификатор общего счета, который требуется пополнить.
|
Да
||
||
`Amount`
|
Сумма выставляемого счета в валюте, указанной в параметре `Currency`. Значение в реальной валюте следует указывать с учетом НДС клиента.

Перед выставлением счета указанная сумма округляется по математическим правилам с точностью до второго знака после запятой (для всех валют, в том числе тенге).

Минимальное допустимое значение можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/get.html) API версии 5, указав в запросе имя справочника `Currencies`.
|
Да
||
||
`Currency`
|
Валюта, в которой указана сумма.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой общего счета, в противном случае возвращается ошибка с кодом [245](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#BadCurrency).
|
Да
||
|#

## Результирующие данные

Ниже показана структура результирующих данных в формате JSON.


{% note alert %}

Ошибка при формировании одного из счетов на оплату не влечет отмену всей операции и не влияет на успешность формирования остальных счетов.

{% endnote %}


```javascript
{
   "data": {
      /* AccountManagementResponse */
      "ActionsResult": [
         {  /* AccountActionResult */
            "URL": (string),
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ]
         }
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
||

||
**Объект AccountManagementResponse**
||
||
`ActionsResult`
|
Массив объектов `AccountActionResult`. Каждый объект соответствует элементу входного массива `Payments` и содержит:

- в случае успешного выставления счета на оплату — URL счета на оплату;
- в случае ошибки — массив `Errors`.

Элементы массива следуют в том же порядке, что и объекты входного массива `Payments`.
||

||
**Объект AccountActionResult**
||
||
`URL`
|
URL счета на оплату.
||
||
`Errors`
|
Массив объектов `Error` — ошибок, возникших при пополнении счета.
||

||
**Объект Error**
||
||
`FaultCode`
|
Код ошибки.
||
||
`FaultString`
|
Текст сообщения об ошибке.
||
||
`FaultDetail`
|
Подробное описание причины ошибки.
||
|#

## Примеры входных данных

# Python

```python
{
   'Action': 'Invoice',
   'Payments': [
      {
         'AccountID': 3193244,
         'Amount': 5000.0,
         'Currency': 'RUB'
      }
   ]
}
```

# PHP

```php
array(
   'Action' => 'Invoice',
   'Payments' => array(
      array(
         'AccountID' => 3193244,
         'Amount' => 5000.0,
         'Currency' ='RUB'
      )
   )
)
```

# Perl

```perl
{
   'Action' => 'Invoice',
   'Payments' => [
      {
         'AccountID' => 3193244,
         'Amount' => 5000.0,
         'Currency' ='RUB'
      }
   ]
}
```