Upravení dat platby

Pokud potřebujete upravit data odesílaná do Fakturoidu při označení dokumentu jako uhrazeného, můžete k tomu využít připravený filtr.

Filtr pro úpravu dat

apply_filters( 'wpify_woo_fakturoid_payment_data', $data, $order, $wc_order );

Parametry filtru

Parametr	Typ	Popis
$data	array	Data platby k odeslání
$order	OrderModel	Model objednávky s Fakturoid daty
$wc_order	WC_Order	WooCommerce objednávka

Struktura odesílaných dat

$data = array(
    'paid_on' // Datum zaplacení (výchozí: $wc_order->get_date_paid())
);

Další pole podporovaná Fakturoid API

Pomocí filtru můžete přidat další pole podporovaná API:

$data += array(
    'amount'                     // Zaplacená částka v měně dokumentu (výchozí: zbývající částka)
    'native_amount'              // Zaplacená částka v měně účtu
    'mark_document_as_paid'      // Označit dokument jako uhrazený (bool, výchozí: true)
    'proforma_followup_document' // Následný dokument pro proformu: final_invoice_paid, final_invoice, tax_document, none
    'send_thank_you_email'       // Odeslat děkovný email (bool, výchozí: dle nastavení Fakturoidu)
    'variable_symbol'            // Variabilní symbol platby (výchozí: VS z faktury)
    'bank_account_id'            // ID bankovního účtu, na který platba přišla
);

Příklady použití

Úprava data zaplacení

Ve výchozím stavu se používá datum uhrazení objednávky ($wc_order->get_date_paid()). Tento filtr použijte, pokud chcete například použít datum dokončení objednávky.

/**
 * Modify payment date
 *
 * @param array      $data     Payment data
 * @param OrderModel $order    Order model
 * @param WC_Order   $wc_order WC order
 *
 * @return array
 */
function modify_payment_date( $data, $order, $wc_order ): array {
    // Použít datum dokončení objednávky místo data uhrazení
    $data['paid_on'] = $wc_order->get_date_completed();
    return $data;
}
add_filter( 'wpify_woo_fakturoid_payment_data', 'modify_payment_date', 10, 3 );

Odeslání děkovného emailu

Ve výchozím stavu se toto pole nenastavuje a použije se nastavení z účtu Fakturoid. Pokud chcete vždy odesílat děkovný email po zaplacení bez ohledu na nastavení ve Fakturoidu, použijte tento filtr.

/**
 * Send thank you email after payment
 *
 * @param array      $data     Payment data
 * @param OrderModel $order    Order model
 * @param WC_Order   $wc_order WC order
 *
 * @return array
 */
function send_thank_you_email_on_payment( $data, $order, $wc_order ): array {
    // Odeslat děkovný email z Fakturoidu po zaplacení
    $data['send_thank_you_email'] = true;
    return $data;
}
add_filter( 'wpify_woo_fakturoid_payment_data', 'send_thank_you_email_on_payment', 10, 3 );

Kde umístit kód

Vlastní funkci můžete vložit buď do tzv. child šablony nebo pomocí pluginu Code Snippets.