fanyin-php/extend/Yzh/InvoiceClient.php

<?php

namespace Yzh;

use Yzh\Exception\ConfigException;
use Yzh\Exception\ExceptionCode;
use Yzh\Model\Invoice\GetInvoiceStatRequest;
use Yzh\Model\Invoice\GetInvoiceStatResponse;
use Yzh\Model\Invoice\GetInvoiceAmountRequest;
use Yzh\Model\Invoice\GetInvoiceAmountResponse;
use Yzh\Model\Invoice\ApplyInvoiceRequest;
use Yzh\Model\Invoice\ApplyInvoiceResponse;
use Yzh\Model\Invoice\GetInvoiceStatusRequest;
use Yzh\Model\Invoice\GetInvoiceStatusResponse;
use Yzh\Model\Invoice\GetInvoiceInformationRequest;
use Yzh\Model\Invoice\GetInvoiceInformationResponse;
use Yzh\Model\Invoice\GetInvoiceFileRequest;
use Yzh\Model\Invoice\GetInvoiceFileResponse;
use Yzh\Model\Invoice\SendReminderEmailRequest;
use Yzh\Model\Invoice\SendReminderEmailResponse;

/**
 * 发票开具
 * Class InvoiceClient
 */
class InvoiceClient extends BaseClient
{
    protected static $service_name = 'invoice';

    /**
     * 查询平台企业已开具和待开具发票金额
     * @param GetInvoiceStatRequest $request
     * @param null $option
     * @return GetInvoiceStatResponse
     */
    public function getInvoiceStat($request, $option = null)
    {
        if (!$request instanceof GetInvoiceStatRequest) {
            throw new ConfigException("Invoice->getInvoiceStat request 必须是 Yzh\\Model\\Invoice\\GetInvoiceStatRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('GET', '/api/payment/v1/invoice-stat', $request, "Yzh\\Model\\Invoice\\GetInvoiceStatResponse", $option);
    }

    /**
     * 查询可开具发票额度和发票开具信息
     * @param GetInvoiceAmountRequest $request
     * @param null $option
     * @return GetInvoiceAmountResponse
     */
    public function getInvoiceAmount($request, $option = null)
    {
        if (!$request instanceof GetInvoiceAmountRequest) {
            throw new ConfigException("Invoice->getInvoiceAmount request 必须是 Yzh\\Model\\Invoice\\GetInvoiceAmountRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/invoice-amount', $request, "Yzh\\Model\\Invoice\\GetInvoiceAmountResponse", $option);
    }

    /**
     * 发票开具申请
     * @param ApplyInvoiceRequest $request
     * @param null $option
     * @return ApplyInvoiceResponse
     */
    public function applyInvoice($request, $option = null)
    {
        if (!$request instanceof ApplyInvoiceRequest) {
            throw new ConfigException("Invoice->applyInvoice request 必须是 Yzh\\Model\\Invoice\\ApplyInvoiceRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/apply', $request, "Yzh\\Model\\Invoice\\ApplyInvoiceResponse", $option);
    }

    /**
     * 查询发票开具申请状态
     * @param GetInvoiceStatusRequest $request
     * @param null $option
     * @return GetInvoiceStatusResponse
     */
    public function getInvoiceStatus($request, $option = null)
    {
        if (!$request instanceof GetInvoiceStatusRequest) {
            throw new ConfigException("Invoice->getInvoiceStatus request 必须是 Yzh\\Model\\Invoice\\GetInvoiceStatusRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/invoice/invoice-status', $request, "Yzh\\Model\\Invoice\\GetInvoiceStatusResponse", $option);
    }

    /**
     * 查询发票信息
     * @param GetInvoiceInformationRequest $request
     * @param null $option
     * @return GetInvoiceInformationResponse
     */
    public function getInvoiceInformation($request, $option = null)
    {
        if (!$request instanceof GetInvoiceInformationRequest) {
            throw new ConfigException("Invoice->getInvoiceInformation request 必须是 Yzh\\Model\\Invoice\\GetInvoiceInformationRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/invoice-face-information', $request, "Yzh\\Model\\Invoice\\GetInvoiceInformationResponse", $option);
    }

    /**
     * 下载 PDF 版发票
     * @param GetInvoiceFileRequest $request
     * @param null $option
     * @return GetInvoiceFileResponse
     */
    public function getInvoiceFile($request, $option = null)
    {
        if (!$request instanceof GetInvoiceFileRequest) {
            throw new ConfigException("Invoice->getInvoiceFile request 必须是 Yzh\\Model\\Invoice\\GetInvoiceFileRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/invoice/invoice-pdf', $request, "Yzh\\Model\\Invoice\\GetInvoiceFileResponse", $option);
    }

    /**
     * 发送发票开具成功通知邮件
     * @param SendReminderEmailRequest $request
     * @param null $option
     * @return SendReminderEmailResponse
     */
    public function sendReminderEmail($request, $option = null)
    {
        if (!$request instanceof SendReminderEmailRequest) {
            throw new ConfigException("Invoice->sendReminderEmail request 必须是 Yzh\\Model\\Invoice\\SendReminderEmailRequest 实例", ExceptionCode::CONFIG_ERROR_WRONG_PARAM);
        }
        return $this->send('POST', '/api/invoice/v2/invoice/reminder/email', $request, "Yzh\\Model\\Invoice\\SendReminderEmailResponse", $option);
    }
}