yookassa-sdk-php/lib/Model/Receipt/PaymentSubject.php

<?php

/*
 * The MIT License
 *
 * Copyright (c) 2025 "YooMoney", NBСO LLC
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

namespace YooKassa\Model\Receipt;

use YooKassa\Common\AbstractEnum;

/**
 * Класс, представляющий модель PaymentSubject.
 *
 * Признак предмета расчета (тег в 54 ФЗ — 1212) — это то, за что принимается оплата, например товар, услуга.
 *
 * @category Class
 * @package  YooKassa\Model
 * @author   cms@yoomoney.ru
 * @link     https://yookassa.ru/developers/api
 */
class PaymentSubject extends AbstractEnum
{
    /** Товар */
    public const COMMODITY = 'commodity';

    /** Подакцизный товар */
    public const EXCISE = 'excise';

    /** Работа */
    public const JOB = 'job';

    /** Услуга */
    public const SERVICE = 'service';

    /** Ставка в азартной игре */
    public const GAMBLING_BET = 'gambling_bet';

    /** Выигрыш азартной игры */
    public const GAMBLING_PRIZE = 'gambling_prize';

    /** Лотерейный билет */
    public const LOTTERY = 'lottery';

    /** Выигрыш в лотерею */
    public const LOTTERY_PRIZE = 'lottery_prize';

    /** Результаты интеллектуальной деятельности */
    public const INTELLECTUAL_ACTIVITY = 'intellectual_activity';

    /** Платеж */
    public const PAYMENT = 'payment';

    /** Агентское вознаграждение */
    public const AGENT_COMMISSION = 'agent_commission';

    /** Имущественное право */
    public const PROPERTY_RIGHT = 'property_right';

    /** Внереализационный доход */
    public const NON_OPERATING_GAIN = 'non_operating_gain';

    /** Страховой сбор */
    public const INSURANCE_PREMIUM = 'insurance_premium';

    /** Торговый сбор */
    public const SALES_TAX = 'sales_tax';

    /** Курортный сбор */
    public const RESORT_FEE = 'resort_fee';

    /** Несколько вариантов */
    public const COMPOSITE = 'composite';

    /** Другое */
    public const ANOTHER = 'another';

    /** Выплата */
    public const FINE = 'fine';

    /** Страховые взносы */
    public const TAX = 'tax';

    /** Залог */
    public const LIEN = 'lien';

    /** Расход */
    public const COST = 'cost';

    /** Взносы на обязательное пенсионное страхование ИП */
    public const PENSION_INSURANCE_WITHOUT_PAYOUTS = 'pension_insurance_without_payouts';

    /** Взносы на обязательное пенсионное страхование */
    public const PENSION_INSURANCE_WITH_PAYOUTS = 'pension_insurance_with_payouts';

    /** Взносы на обязательное медицинское страхование ИП */
    public const HEALTH_INSURANCE_WITHOUT_PAYOUTS = 'health_insurance_without_payouts';

    /** Взносы на обязательное медицинское страхование */
    public const HEALTH_INSURANCE_WITH_PAYOUTS = 'health_insurance_with_payouts';

    /** Взносы на обязательное социальное страхование */
    public const HEALTH_INSURANCE = 'health_insurance';

    /** Платеж казино */
    public const CASINO = 'casino';

    /** Выдача денежных средств */
    public const AGENT_WITHDRAWALS = 'agent_withdrawals';

    /** Подакцизный товар, подлежащий маркировке средством идентификации, не имеющим кода маркировки (в чеке — АТНМ). Пример: алкогольная продукция */
    public const NON_MARKED_EXCISE = 'non_marked_excise';

    /** Подакцизный товар, подлежащий маркировке средством идентификации, имеющим код маркировки (в чеке — АТМ). Пример: табак */
    public const MARKED_EXCISE = 'marked_excise';

    /** Товар, подлежащий маркировке средством идентификации, имеющим код маркировки, за исключением подакцизного товара (в чеке — ТМ). Пример: обувь, духи, товары легкой промышленности */
    public const MARKED = 'marked';

    /** Товар, подлежащий маркировке средством идентификации, не имеющим кода маркировки, за исключением подакцизного товара (в чеке — ТНМ). Пример: меховые изделия */
    public const NON_MARKED = 'non_marked';

    protected static array $validValues = [
        self::COMMODITY => true,
        self::EXCISE => true,
        self::JOB => true,
        self::SERVICE => true,
        self::GAMBLING_BET => true,
        self::GAMBLING_PRIZE => true,
        self::LOTTERY => true,
        self::LOTTERY_PRIZE => true,
        self::INTELLECTUAL_ACTIVITY => true,
        self::PAYMENT => true,
        self::AGENT_COMMISSION => true,
        self::PROPERTY_RIGHT => true,
        self::NON_OPERATING_GAIN => true,
        self::INSURANCE_PREMIUM => true,
        self::SALES_TAX => true,
        self::RESORT_FEE => true,
        self::COMPOSITE => true,
        self::ANOTHER => true,

        self::FINE => true,
        self::TAX => true,
        self::LIEN => true,
        self::COST => true,
        self::PENSION_INSURANCE_WITHOUT_PAYOUTS => true,
        self::PENSION_INSURANCE_WITH_PAYOUTS => true,
        self::HEALTH_INSURANCE_WITHOUT_PAYOUTS => true,
        self::HEALTH_INSURANCE_WITH_PAYOUTS => true,
        self::HEALTH_INSURANCE => true,
        self::CASINO => true,
        self::AGENT_WITHDRAWALS => true,
        self::NON_MARKED_EXCISE => true,
        self::MARKED_EXCISE => true,
        self::MARKED => true,
        self::NON_MARKED => true,
    ];
}