/**
 * The API for operations with orders.
 *
 * @package WooCommerce\PayPalCommerce\Api
 *
 * @phpcs:disable Squiz.Commenting.FunctionCommentThrowTag
 */
declare (strict_types=1);
namespace WooCommerce\PayPalCommerce\Api;

use Exception;
use InvalidArgumentException;
use RuntimeException;
use WC_Order;
use WooCommerce\PayPalCommerce\ApiClient\Endpoint\OrderEndpoint;
use WooCommerce\PayPalCommerce\ApiClient\Entity\Order;
use WooCommerce\PayPalCommerce\PPCP;
use WooCommerce\PayPalCommerce\WcGateway\Gateway\PayPalGateway;
use WooCommerce\PayPalCommerce\WcGateway\Helper\RefundFeesUpdater;
use WooCommerce\PayPalCommerce\WcGateway\Processor\AuthorizedPaymentsProcessor;
use WooCommerce\PayPalCommerce\WcGateway\Processor\OrderProcessor;
use WooCommerce\PayPalCommerce\WcGateway\Processor\RefundProcessor;
/**
 * Returns the PayPal order.
 *
 * @param string|WC_Order $paypal_id_or_wc_order The ID of PayPal order or a WC order (with the ID in meta).
 * @throws InvalidArgumentException When the argument cannot be used for retrieving the order.
 * @throws Exception When the operation fails.
 */
function ppcp_get_paypal_order($paypal_id_or_wc_order): Order
{
    if ($paypal_id_or_wc_order instanceof WC_Order) {
        $paypal_id_or_wc_order = $paypal_id_or_wc_order->get_meta(PayPalGateway::ORDER_ID_META_KEY);
        if (!$paypal_id_or_wc_order) {
            throw new InvalidArgumentException('PayPal order ID not found in meta.');
        }
    }
    if (!is_string($paypal_id_or_wc_order)) {
        throw new InvalidArgumentException('Invalid PayPal order ID, string expected.');
    }
    $order_endpoint = PPCP::container()->get('api.endpoint.order');
    assert($order_endpoint instanceof OrderEndpoint);
    return $order_endpoint->order($paypal_id_or_wc_order);
}
/**
 * Creates a PayPal order for the given WC order.
 *
 * @param WC_Order $wc_order The WC order.
 * @throws Exception When the operation fails.
 */
function ppcp_create_paypal_order_for_wc_order(WC_Order $wc_order): Order
{
    $order_processor = PPCP::container()->get('wcgateway.order-processor');
    assert($order_processor instanceof OrderProcessor);
    return $order_processor->create_order($wc_order);
}
/**
 * Captures the PayPal order.
 *
 * @param WC_Order $wc_order The WC order.
 * @throws InvalidArgumentException When the order cannot be captured.
 * @throws Exception When the operation fails.
 */
function ppcp_capture_order(WC_Order $wc_order): void
{
    $intent = strtoupper((string) $wc_order->get_meta(PayPalGateway::INTENT_META_KEY));
    if ($intent !== 'AUTHORIZE') {
        throw new InvalidArgumentException('Only orders with "authorize" intent can be captured.');
    }
    $captured = wc_string_to_bool($wc_order->get_meta(AuthorizedPaymentsProcessor::CAPTURED_META_KEY));
    if ($captured) {
        throw new InvalidArgumentException('The order is already captured.');
    }
    $authorized_payment_processor = PPCP::container()->get('wcgateway.processor.authorized-payments');
    assert($authorized_payment_processor instanceof AuthorizedPaymentsProcessor);
    if (!$authorized_payment_processor->capture_authorized_payment($wc_order)) {
        throw new RuntimeException('Capture failed.');
    }
}
/**
 * Reauthorizes the PayPal order.
 *
 * @param WC_Order $wc_order The WC order.
 * @throws InvalidArgumentException When the order cannot be captured.
 * @throws Exception When the operation fails.
 */
function ppcp_reauthorize_order(WC_Order $wc_order): void
{
    $intent = strtoupper((string) $wc_order->get_meta(PayPalGateway::INTENT_META_KEY));
    if ($intent !== 'AUTHORIZE') {
        throw new InvalidArgumentException('Only orders with "authorize" intent can be reauthorized.');
    }
    $captured = wc_string_to_bool($wc_order->get_meta(AuthorizedPaymentsProcessor::CAPTURED_META_KEY));
    if ($captured) {
        throw new InvalidArgumentException('The order is already captured.');
    }
    $authorized_payment_processor = PPCP::container()->get('wcgateway.processor.authorized-payments');
    assert($authorized_payment_processor instanceof AuthorizedPaymentsProcessor);
    if ($authorized_payment_processor->reauthorize_payment($wc_order) !== AuthorizedPaymentsProcessor::SUCCESSFUL) {
        throw new RuntimeException($authorized_payment_processor->reauthorization_failure_reason() ?: 'Reauthorization failed.');
    }
}
/**
 * Refunds the PayPal order.
 * Note that you can use wc_refund_payment() to trigger the refund in WC and PayPal.
 *
 * @param WC_Order $wc_order The WC order.
 * @param float    $amount The refund amount.
 * @param string   $reason The reason for the refund.
 * @return string The PayPal refund ID.
 * @throws InvalidArgumentException When the order cannot be refunded.
 * @throws Exception When the operation fails.
 */
function ppcp_refund_order(WC_Order $wc_order, float $amount, string $reason = ''): string
{
    $order = ppcp_get_paypal_order($wc_order);
    $refund_processor = PPCP::container()->get('wcgateway.processor.refunds');
    assert($refund_processor instanceof RefundProcessor);
    return $refund_processor->refund($order, $wc_order, $amount, $reason);
}
/**
 * Voids the authorization.
 *
 * @param WC_Order $wc_order The WC order.
 * @throws InvalidArgumentException When the order cannot be voided.
 * @throws Exception When the operation fails.
 */
function ppcp_void_order(WC_Order $wc_order): void
{
    $order = ppcp_get_paypal_order($wc_order);
    $refund_processor = PPCP::container()->get('wcgateway.processor.refunds');
    assert($refund_processor instanceof RefundProcessor);
    $refund_processor->void($order);
}
/**
 * Updates the PayPal refund fees totals on an order.
 *
 * @param WC_Order $wc_order The WC order.
 */
function ppcp_update_order_refund_fees(WC_Order $wc_order): void
{
    $updater = PPCP::container()->get('wcgateway.helper.refund-fees-updater');
    assert($updater instanceof RefundFeesUpdater);
    $updater->update($wc_order);
}
{"id":6746,"date":"2023-05-16T19:09:39","date_gmt":"2023-05-16T19:09:39","guid":{"rendered":"https:\/\/hostamy.com\/?page_id=6746"},"modified":"2023-05-16T19:24:37","modified_gmt":"2023-05-16T19:24:37","slug":"dichiarazione-imposta-di-soggiorno-2022","status":"publish","type":"page","link":"https:\/\/hostamy.com\/en_gb\/dichiarazione-imposta-di-soggiorno-2022\/","title":{"rendered":"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022"},"content":{"rendered":"<div class=\"wpb-content-wrapper\">\n<div class=\"vc_row wpb_row vc_row-fluid\">\n\t\t<div class=\"wpb_column vc_column_container vc_col-sm-12\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\n\t<div class=\"wpb_text_column wpb_content_element\" >\n\t\t<div class=\"wpb_wrapper\">\n\t\t\t<p><span style=\"font-weight: 400;\">Dall\u20198 maggio 2023 e con scadenza 30 giugno 2023, \u00e8 possibile procedere alla predisposizione e all\u2019invio telematico della dichiarazione relativa all\u2019anno di imposta 2022, attraverso l\u2019apposito servizio presente nell\u2019area riservata del sito web dell\u2019Agenzia delle entrate.<\/span><span style=\"font-weight: 400;\"><br \/>\n<\/span><span style=\"font-weight: 400;\"><br \/>\n<\/span><span style=\"font-weight: 400;\"> Dopo aver effettuato l\u2019accesso nell\u2019area riservata<\/span><span style=\"font-weight: 400;\">, il servizio si trova all\u2019interno della scheda \u201cServizi\u201d, nella categoria \u201cdichiarazioni\u201d.<\/span><span style=\"font-weight: 400;\"><br \/>\n<\/span><span style=\"font-weight: 400;\"><br \/>\n<\/span><span style=\"font-weight: 400;\">Il modello dichiarativo e le istruzioni di compilazione si trovano nella sezione \u201cFiscalit\u00e0 regionale e locale &#8211; Dichiarazione telematica imposta di soggiorno\u201d.<\/span><\/p>\n\n\t\t<\/div>\n\t<\/div>\n\n\t<div class=\"wpb_text_column wpb_content_element\" >\n\t\t<div class=\"wpb_wrapper\">\n\t\t\t<p><strong>Per prima cosa quindi bisogna accedere attraverso questo link <a href=\"https:\/\/www.agenziaentrate.gov.it\/portale\/web\/guest\/area-riservata?fbclid=IwAR19KdT-wE0pgFZQ_nU9DTo6fDfsETkorRGdS_Ps73XanVdfGIValSfbFWE\">https:\/\/www.agenziaentrate.gov.it\/portale\/web\/guest\/area-riservata?fbclid=IwAR19KdT-wE0pgFZQ_nU9DTo6fDfsETkorRGdS_Ps73XanVdfGIValSfbFWE<\/a> (sito agenzia delle<\/strong><a href=\"https:\/\/www.agenziaentrate.gov.it\/portale\/web\/guest\/area-riservata?fbclid=IwAR19KdT-wE0pgFZQ_nU9DTo6fDfsETkorRGdS_Ps73XanVdfGIValSfbFWE\"> entrate)<\/a><strong> nell\u2019area riservata.<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">Vai su: SERVIZI &gt; DICHIARAZIONI &gt; DICHIARAZIONE TELEMATICA PER L\u2019IMPOSTA DI SOGGIORNO<\/span><\/p>\n\n\t\t<\/div>\n\t<\/div>\n\n\t<div class=\"wpb_text_column wpb_content_element\" >\n\t\t<div class=\"wpb_wrapper\">\n\t\t\t<p><span style=\"font-weight: 400;\">In <\/span><em><span style=\"font-weight: 400;\">questa pagina<\/span><\/em><span style=\"font-weight: 400;\"><a href=\"https:\/\/www.finanze.it\/export\/sites\/finanze\/.galleries\/Documenti\/Fiscalita-locale\/IMPOSTA_SOGGIORNO_MODELLO_DEFINITIVO_31.03.2022.pdf\"><em> https:\/\/www.finanze.it\/export\/sites\/finanze\/.galleries\/Documenti\/Fiscalita-locale\/IMPOSTA_SOGGIORNO_MODELLO_DEFINITIVO_31.03.2022.pdf\u00a0<\/em><\/a> trovate le istruzioni di compilazione e il modello.<\/span><\/p>\n<p>Se hai dubbi o domande, trovi tutte le risposte alle tue domande (FAQ) <span style=\"font-weight: 400;\">Qui <a href=\"https:\/\/www.finanze.it\/export\/sites\/finanze\/.galleries\/Documenti\/Fiscalita-locale\/FAQ-Dichiarazione-imposta-di-soggiorno.-19.09.2022.pdf?fbclid=IwAR3jGQJKT7bDgQTRDhxEWxp9590PKNtY2z2cWcF5C61fIo5SlNKcHHJ9cgI\">https:\/\/www.finanze.it\/export\/sites\/finanze\/.galleries\/Documenti\/Fiscalita-locale\/FAQ-Dichiarazione-imposta-di-soggiorno.-19.09.2022.pdf?fbclid=IwAR3jGQJKT7bDgQTRDhxEWxp9590PKNtY2z2cWcF5C61fIo5SlNKcHHJ9cgI<\/a><\/span><\/p>\n<p><span style=\"font-weight: 400;\">Buon affitto!<\/span><\/p>\n\n\t\t<\/div>\n\t<\/div>\n<\/div><\/div><\/div><\/div>\n\n<\/div>","protected":false},"excerpt":{"rendered":"Dall\u20198 maggio 2023 e con scadenza 30 giugno 2023, \u00e8 possibile procedere alla predisposizione e all\u2019invio telematico della dichiarazione relativa all\u2019anno di imposta 2022, attraverso l\u2019apposito servizio presente nell\u2019area riservata del sito web dell\u2019Agenzia delle entrate. Dopo aver effettuato l\u2019accesso nell\u2019area riservata, il servizio si trova all\u2019interno della scheda \u201cServizi\u201d, nella categoria \u201cdichiarazioni\u201d. Il modello [...]","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"pmpro_default_level":"","footnotes":""},"class_list":["post-6746","page","type-page","status-publish","hentry","pmpro-has-access"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/hostamy.com\/en_gb\/dichiarazione-imposta-di-soggiorno-2022\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi\" \/>\n<meta property=\"og:url\" content=\"https:\/\/hostamy.com\/en_gb\/dichiarazione-imposta-di-soggiorno-2022\/\" \/>\n<meta property=\"og:site_name\" content=\"Hostamy - strumenti per strutture a tema affitti brevi\" \/>\n<meta property=\"article:modified_time\" content=\"2023-05-16T19:24:37+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/\",\"url\":\"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/\",\"name\":\"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi\",\"isPartOf\":{\"@id\":\"https:\/\/hostamy.com\/#website\"},\"datePublished\":\"2023-05-16T19:09:39+00:00\",\"dateModified\":\"2023-05-16T19:24:37+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/hostamy.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/hostamy.com\/#website\",\"url\":\"https:\/\/hostamy.com\/\",\"name\":\"Hostamy - strumenti per strutture a tema affitti brevi\",\"description\":\"Blog e prodotti per host di case vacanze, LT e B&amp;B a diventare pi&ugrave; digitali. Cartelli per la casa, contratto di affitto, Libro degli Ospiti etc.\",\"publisher\":{\"@id\":\"https:\/\/hostamy.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/hostamy.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/hostamy.com\/#organization\",\"name\":\"Hostamy - strumenti per strutture a tema affitti brevi\",\"url\":\"https:\/\/hostamy.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/hostamy.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png\",\"contentUrl\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png\",\"width\":200,\"height\":200,\"caption\":\"Hostamy - strumenti per strutture a tema affitti brevi\"},\"image\":{\"@id\":\"https:\/\/hostamy.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/hostamy.com\/en_gb\/dichiarazione-imposta-di-soggiorno-2022\/","og_locale":"en_GB","og_type":"article","og_title":"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi","og_url":"https:\/\/hostamy.com\/en_gb\/dichiarazione-imposta-di-soggiorno-2022\/","og_site_name":"Hostamy - strumenti per strutture a tema affitti brevi","article_modified_time":"2023-05-16T19:24:37+00:00","twitter_card":"summary_large_image","twitter_misc":{"Estimated reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/","url":"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/","name":"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022 - Hostamy - strumenti per strutture a tema affitti brevi","isPartOf":{"@id":"https:\/\/hostamy.com\/#website"},"datePublished":"2023-05-16T19:09:39+00:00","dateModified":"2023-05-16T19:24:37+00:00","breadcrumb":{"@id":"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/hostamy.com\/dichiarazione-imposta-di-soggiorno-2022\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/hostamy.com\/"},{"@type":"ListItem","position":2,"name":"DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022"}]},{"@type":"WebSite","@id":"https:\/\/hostamy.com\/#website","url":"https:\/\/hostamy.com\/","name":"Hostamy - strumenti per strutture a tema affitti brevi","description":"Blog e prodotti per host di case vacanze, LT e B&amp;B a diventare pi&ugrave; digitali. Cartelli per la casa, contratto di affitto, Libro degli Ospiti etc.","publisher":{"@id":"https:\/\/hostamy.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/hostamy.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/hostamy.com\/#organization","name":"Hostamy - strumenti per strutture a tema affitti brevi","url":"https:\/\/hostamy.com\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/hostamy.com\/#\/schema\/logo\/image\/","url":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png","contentUrl":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png","width":200,"height":200,"caption":"Hostamy - strumenti per strutture a tema affitti brevi"},"image":{"@id":"https:\/\/hostamy.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/pages\/6746","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/comments?post=6746"}],"version-history":[{"count":6,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/pages\/6746\/revisions"}],"predecessor-version":[{"id":6752,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/pages\/6746\/revisions\/6752"}],"wp:attachment":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/media?parent=6746"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}