---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.ru/dev/direct/doc/dg-v4/en/live/CreateInvoice.md
  - https://yandex.ru/dev/direct/doc/dg-v4/ru/live/CreateInvoice.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/dg-v4/ru/llms.txt

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


{% note alert %}

Прямые рекламодатели могут формировать счет на оплату, только если кампания одобрена модератором (см. параметр кампании StatusModerate).

{% endnote %}


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

<!-- source: ru/_includes/reference/CreateInvoice/id-CreateInvoice/campaign-types-pay.md -->
{% note alert %}

Все кампании, указанные в одном вызове метода, должны быть одного типа. [Подробнее о типах кампаний...](https://yandex.ru/dev/direct/doc/dg/objects/campaign.md)

{% endnote %}
<!-- endsource: ru/_includes/reference/CreateInvoice/id-CreateInvoice/campaign-types-pay.md -->


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

Ниже перечислены ограничения на вызов метода:

- один пользователь может вызвать метод 1000 раз в сутки;
- для одной кампании возможно не более 30 финансовых операций в сутки, включая формирование счетов на оплату ([CreateInvoice (Live)](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/CreateInvoice.md)), перевод средств ([TransferMoney (Live)](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/TransferMoney.md)), оплату с отсрочкой ([PayCampaigns (Live)](https://yandex.ru/dev/direct/doc/dg-v4/ru/live/PayCampaigns.md));

Превышение указанных лимитов вызывает ошибку с кодом [56](https://yandex.ru/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode56).

## Валютные ограничения


{% note alert %}

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

{% endnote %}


Все кампании, указанные в одном вызове метода, должны быть в одной валюте.

Суммы к оплате (параметр Sum) можно указывать в валюте кампаний (задав соответствующее значение параметра Currency). Все суммы должны быть указаны в одной валюте.

## Новое в версии Live 4

Входной параметр Currency стал обязательным.

Добавлен входной параметр Currency.


## Входные данные {#input}

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


{% note alert %}

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

{% endnote %}


```javascript
{
   "method": "CreateInvoice",
   "finance_token": (string),
   "operation_num": (int),
   "param": {
      /* CreateInvoiceInfo */
      "Payments": [
         {  /* PayCampElement */
            "CampaignID": (int),
            "Sum": (float),
            "Currency": (string)
         }
         ...
      ]
   }
}
```

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


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

||
**Объект CreateInvoiceInfo**
||
||
`Payments`
|
Массив объектов `PayCampElement`. Каждый объект указывает кампанию и сумму, отражаемую в счете на оплату.
|
Да
||

||
**Объект PayCampElement**
||
||
`CampaignID`
|
Идентификатор кампании.
|
Да
||
||
`Sum`
|
Сумма оплаты в валюте, указанной в параметре `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.ru/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#BadCurrency).
|
Да
||
|#


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

При успешном выполнении метод возвращает URL счета на оплату, как показано ниже. В противном случае возвращается сообщение об ошибке.

```javascript
{
   "data": "https://passport.yandex.ru/passport?mode=subscribe&from=balance&retpath=http%3A%2F%2Fbalance.yandex.ru%2Fpaypreview.xml%3Frequest_id%3D14062489%26ref_service_id%3D7%26ui_type%3Dstd"
}
```


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

## Python

```python
{
   'Payments': [
      {'CampaignID': 3193279, 'Sum': 50000.0, 'Currency': 'RUB'},
      {'CampaignID': 3193244, 'Sum': 1200.0, 'Currency': 'RUB'}
   ]
}
```

## PHP

```php
array(
   'Payments' => array(
      array('CampaignID' => 3193279, 'Sum' => 50000.0, 'Currency' => 'RUB'),
      array('CampaignID' => 3193244, 'Sum' => 1200.0, 'Currency' ='RUB')
   )
)
```

## Perl

```perl
{
   'Payments' => [
      {'CampaignID' => 3193279, 'Sum' => 50000.0, 'Currency' => 'RUB'},
      {'CampaignID' => 3193279, 'Sum' => 1200.0, 'Currency' ='RUB'}
   ]
}
```