Files
yookassa-sdk-php/docs/classes/YooKassa-Request-Receipts-CreatePostReceiptRequest.md
T
2021-09-17 15:46:46 +03:00

34 KiB

YooKassa API SDK

Class: \YooKassa\Request\Receipts\CreatePostReceiptRequest

Namespace: \YooKassa\Request\Receipts


Summary:

Класс объекта запроса к API на создание чека


Examples

Пример использования билдера

try {
    $receiptBuilder = \YooKassa\Request\Receipts\CreatePostReceiptRequest::builder();
    $receiptBuilder->setType(\YooKassa\Model\ReceiptType::PAYMENT)
        ->setObjectId('24b94598-000f-5000-9000-1b68e7b15f3f')
        ->setCustomer(array(
            'email' => 'john.doe@merchant.com',
            'phone' => '71111111111',
        ))
        ->setItems(array(
            array(
                'description' => 'Платок Gucci',
                'quantity' => '1.00',
                'amount' => array(
                    'value' => '3000.00',
                    'currency' => 'RUB',
                ),
                'vat_code' => 2,
                'payment_mode' => 'full_payment',
                'payment_subject' => 'commodity',
            ),
        ))
        ->setSettlements(array(
            array(
                'type' => 'prepayment',
                'amount' => array(
                    'value' => 100.00,
                    'currency' => 'RUB',
                ),
            ),
        ))
        ->setSend(true);

    // Создаем объект запроса
    $request = $receiptBuilder->build();

    // Можно изменить данные, если нужно
    $request->setOnBehalfOf('159753');
    $request->addItem(new \YooKassa\Model\ReceiptItem(array(
        'description' => 'Платок Gucci Новый',
        'quantity' => '1.00',
        'amount' => array(
            'value' => '3500.00',
            'currency' => 'RUB',
        ),
        'vat_code' => 2,
        'payment_mode' => 'full_payment',
        'payment_subject' => 'commodity',
    )));

    $idempotenceKey = uniqid('', true);
    $response = $client->createReceipt($request, $idempotenceKey);
} catch (Exception $e) {
    $response = $e;
}

var_dump($response);


Constants

  • No constants found

Methods

Visibility Name Flag Summary
public __construct() AbstractObject constructor.
public __get() Возвращает значение свойства
public __isset() Проверяет наличие свойства
public __set() Устанавливает значение свойства
public __unset() Удаляет свойство
public addItem() Добавляет товар в чек
public addSettlement() Добавляет оплату в перечень совершенных расчетов.
public builder() Возвращает билдер объектов запросов создания платежа
public clearValidationError() Очищает статус валидации текущего запроса
public fromArray() Устанавливает значения свойств текущего объекта из массива
public getCustomer() Возвращает информацию о плательщике
public getItems() Возвращает список позиций в текущем чеке
public getLastValidationError() Возвращает последнюю ошибку валидации
public getObjectId() Возвращает Id объекта чека
public getOnBehalfOf() Возвращает идентификатор магазина, от имени которого нужно отправить чек.
public getSend() Возвращает признак отложенной отправки чека.
public getSettlements() Возвращает массив оплат, обеспечивающих выдачу товара.
public getTaxSystemCode() Возвращает код системы налогообложения
public getType() Возвращает тип чека в онлайн-кассе
public hasCustomer() Проверяет наличие данных о плательщике
public jsonSerialize() Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации
public notEmpty() Проверяет есть ли в чеке хотя бы одна позиция товаров и оплат
public offsetExists() Проверяет наличие свойства
public offsetGet() Возвращает значение свойства
public offsetSet() Устанавливает значение свойства
public offsetUnset() Удаляет свойство
public setCustomer() Устанавливает информацию о плательщике
public setItems() Устанавливает список позиций в чеке
public setObjectId() Устанавливает Id объекта чека
public setOnBehalfOf() Устанавливает идентификатор магазина, от имени которого нужно отправить чек.
public setSend() Устанавливает признак отложенной отправки чека.
public setSettlements() Устанавливает массив оплат, обеспечивающих выдачу товара.
public setTaxSystemCode() Устанавливает код системы налогообложения
public setType() Устанавливает тип чека в онлайн-кассе
public toArray() Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize()
public validate() Валидирует текущий запрос, проверяет все ли нужные свойства установлены
protected getUnknownProperties() Возвращает массив свойств которые не существуют, но были заданы у объекта
protected setValidationError() Устанавливает ошибку валидации

Details


Methods

public __construct() : mixed

public __construct(array $data = array()) : mixed

Summary

AbstractObject constructor.

Details:

Parameters:
Type Name Description
array data

Returns: mixed -

public __get() : mixed

public __get(string $propertyName) : mixed

Summary

Возвращает значение свойства

Details:

Parameters:
Type Name Description
string propertyName Имя свойства

Returns: mixed - Значение свойства

public __isset() : bool

public __isset(string $propertyName) : bool

Summary

Проверяет наличие свойства

Details:

Parameters:
Type Name Description
string propertyName Имя проверяемого свойства

Returns: bool - True если свойство имеется, false если нет

public __set() : mixed

public __set(string $propertyName, mixed $value) : mixed

Summary

Устанавливает значение свойства

Details:

Parameters:
Type Name Description
string propertyName Имя свойства
mixed value Значение свойства

Returns: mixed -

public __unset() : mixed

public __unset(string $propertyName) : mixed

Summary

Удаляет свойство

Details:

Parameters:
Type Name Description
string propertyName Имя удаляемого свойства

Returns: mixed -

public addItem() : \YooKassa\Request\Receipts\CreatePostReceiptRequest

public addItem(\YooKassa\Model\ReceiptItemInterface|array $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequest

Summary

Добавляет товар в чек

Details:

Parameters:
Type Name Description
\YooKassa\Model\ReceiptItemInterface OR array value Объект добавляемой в чек позиции

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequest -

public addSettlement() : mixed

public addSettlement(\YooKassa\Model\SettlementInterface $value) : mixed

Summary

Добавляет оплату в перечень совершенных расчетов.

Details:

Parameters:
Type Name Description
\YooKassa\Model\SettlementInterface value Информация о совершенных расчетах.

Returns: mixed -

public builder() : \YooKassa\Request\Receipts\CreatePostReceiptRequestBuilder

Static public builder() : \YooKassa\Request\Receipts\CreatePostReceiptRequestBuilder

Summary

Возвращает билдер объектов запросов создания платежа

Details:

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestBuilder - Инстанс билдера объектов запрсов

public clearValidationError() : mixed

public clearValidationError() : mixed

Summary

Очищает статус валидации текущего запроса

Details:

Returns: mixed -

public fromArray() : mixed

public fromArray(array|\Traversable $sourceArray) : mixed

Summary

Устанавливает значения свойств текущего объекта из массива

Details:

Parameters:
Type Name Description
array OR \Traversable sourceArray Ассоциативный массив с настройками

Returns: mixed -

public getCustomer() : \YooKassa\Model\ReceiptCustomerInterface

public getCustomer() : \YooKassa\Model\ReceiptCustomerInterface

Summary

Возвращает информацию о плательщике

Details:

Returns: \YooKassa\Model\ReceiptCustomerInterface - информация о плательщике

public getItems() : \YooKassa\Model\ReceiptItemInterface[]

public getItems() : \YooKassa\Model\ReceiptItemInterface[]

Summary

Возвращает список позиций в текущем чеке

Details:

Returns: \YooKassa\Model\ReceiptItemInterface[] - Список товаров в заказе

public getLastValidationError() : string

public getLastValidationError() : string

Summary

Возвращает последнюю ошибку валидации

Details:

Returns: string - Последняя произошедшая ошибка валидации

public getObjectId() : string

public getObjectId() : string

Summary

Возвращает Id объекта чека

Details:

Returns: string - Id объекта чека

public getOnBehalfOf() : string

public getOnBehalfOf() : string

Summary

Возвращает идентификатор магазина, от имени которого нужно отправить чек.

Description

Выдается ЮKassa, отображается в разделе Продавцы личного кабинета (столбец shopId). Необходимо передавать, если вы используете решение ЮKassa для платформ.

Details:

Returns: string -

public getSend() : bool

public getSend() : bool

Summary

Возвращает признак отложенной отправки чека.

Details:

Returns: bool - Признак отложенной отправки чека.

public getSettlements() : \YooKassa\Model\SettlementInterface[]

public getSettlements() : \YooKassa\Model\SettlementInterface[]

Summary

Возвращает массив оплат, обеспечивающих выдачу товара.

Details:

Returns: \YooKassa\Model\SettlementInterface[] - Массив оплат, обеспечивающих выдачу товара.

public getTaxSystemCode() : int

public getTaxSystemCode() : int

Summary

Возвращает код системы налогообложения

Details:

Returns: int - Код системы налогообложения. Число 1-6.

public getType() : string

public getType() : string

Summary

Возвращает тип чека в онлайн-кассе

Details:

Returns: string - Тип чека в онлайн-кассе: приход "payment" или возврат "refund".

public hasCustomer() : bool

public hasCustomer() : bool

Summary

Проверяет наличие данных о плательщике

Details:

Returns: bool -

public jsonSerialize() : array

public jsonSerialize() : array

Summary

Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации

Details:

Returns: array - Ассоциативный массив со свойствами текущего объекта

public notEmpty() : bool

public notEmpty() : bool

Summary

Проверяет есть ли в чеке хотя бы одна позиция товаров и оплат

Details:

Returns: bool - True если чек не пуст, false если в чеке нет ни одной позиции

public offsetExists() : bool

public offsetExists(string $offset) : bool

Summary

Проверяет наличие свойства

Details:

Parameters:
Type Name Description
string offset Имя проверяемого свойства

Returns: bool - True если свойство имеется, false если нет

public offsetGet() : mixed

public offsetGet(string $offset) : mixed

Summary

Возвращает значение свойства

Details:

Parameters:
Type Name Description
string offset Имя свойства

Returns: mixed - Значение свойства

public offsetSet() : mixed

public offsetSet(string $offset, mixed $value) : mixed

Summary

Устанавливает значение свойства

Details:

Parameters:
Type Name Description
string offset Имя свойства
mixed value Значение свойства

Returns: mixed -

public offsetUnset() : mixed

public offsetUnset(string $offset) : mixed

Summary

Удаляет свойство

Details:

Parameters:
Type Name Description
string offset Имя удаляемого свойства

Returns: mixed -

public setCustomer() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setCustomer(\YooKassa\Model\ReceiptCustomerInterface $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает информацию о плательщике

Details:

Parameters:
Type Name Description
\YooKassa\Model\ReceiptCustomerInterface value

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public setItems() : \YooKassa\Request\Receipts\CreatePostReceiptRequest

public setItems(\YooKassa\Model\ReceiptItemInterface[]|array $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequest

Summary

Устанавливает список позиций в чеке

Description

Если до этого в чеке уже были установлены значения, они удаляются и полностью заменяются переданным списком позиций. Все передаваемые значения в массиве позиций должны быть объектами класса, реализующего интерфейс ReceiptItemInterface, в противном случае будет выброшено исключение InvalidPropertyValueTypeException.

Details:

Parameters:
Type Name Description
\YooKassa\Model\ReceiptItemInterface[] OR array value Список товаров в заказе
Throws:
Type Description
\YooKassa\Common\Exceptions\EmptyPropertyValueException Выбрасывается если передали пустой массив значений
\YooKassa\Common\Exceptions\InvalidPropertyValueTypeException Выбрасывается если в качестве значения был передан не массив и не итератор, либо если одно из переданных значений не реализует интерфейс ReceiptItemInterface

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequest -

public setObjectId() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setObjectId(string $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает Id объекта чека

Details:

Parameters:
Type Name Description
string value Id объекта чека

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public setOnBehalfOf() : mixed

public setOnBehalfOf(string $value) : mixed

Summary

Устанавливает идентификатор магазина, от имени которого нужно отправить чек.

Description

Выдается ЮKassa, отображается в разделе Продавцы личного кабинета (столбец shopId). Необходимо передавать, если вы используете решение ЮKassa для платформ.

Details:

Parameters:
Type Name Description
string value

Returns: mixed -

public setSend() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setSend(bool $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает признак отложенной отправки чека.

Details:

Parameters:
Type Name Description
bool value Признак отложенной отправки чека.

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public setSettlements() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setSettlements(\YooKassa\Model\SettlementInterface[] $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает массив оплат, обеспечивающих выдачу товара.

Details:

Parameters:
Type Name Description
\YooKassa\Model\SettlementInterface[] value Массив оплат, обеспечивающих выдачу товара.

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public setTaxSystemCode() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setTaxSystemCode(int $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает код системы налогообложения

Details:

Parameters:
Type Name Description
int value Код системы налогообложения. Число 1-6
Throws:
Type Description
\YooKassa\Common\Exceptions\InvalidPropertyValueTypeException Выбрасывается если переданный аргумент - не число
\YooKassa\Common\Exceptions\InvalidPropertyValueException Выбрасывается если переданный аргумент меньше одного или больше шести

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public setType() : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

public setType(string $value) : \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface

Summary

Устанавливает тип чека в онлайн-кассе

Details:

Parameters:
Type Name Description
string value Тип чека в онлайн-кассе: приход "payment" или возврат "refund".

Returns: \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface -

public toArray() : array

public toArray() : array

Summary

Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize()

Details:

Returns: array - Ассоциативный массив со свойствами текущего объекта

public validate() : bool

public validate() : bool

Summary

Валидирует текущий запрос, проверяет все ли нужные свойства установлены

Details:

Returns: bool - True если запрос валиден, false если нет

protected getUnknownProperties() : array

protected getUnknownProperties() : array

Summary

Возвращает массив свойств которые не существуют, но были заданы у объекта

Details:

Returns: array - Ассоциативный массив с не существующими у текущего объекта свойствами

protected setValidationError() : mixed

protected setValidationError(string $value) : mixed

Summary

Устанавливает ошибку валидации

Details:

Parameters:
Type Name Description
string value Ошибка, произошедшая при валидации объекта

Returns: mixed -


Top Namespaces


Reports


This document was automatically generated from source code comments on 2021-09-17 using phpDocumentor

© 2021 YooMoney