Prepojenie SuperFaktúry a WooCommerce

Filtre a akcie

Správanie pluginu môžete upraviť vo vlastnom kóde filtrami a akciami WordPressu. Kód patrí do vlastného pluginu alebo do functions.php child témy.

Podľa verzie 1.59.2: 48 filtrov a 3 akcie.

sf_admin_document_errors

Filterod verzie 1.56.0

Upravuje zoznam dokladov, ktoré sa nepodarilo vytvoriť a ktoré sa ukazujú v upozornení v administrácii.

ParameterTypPopis
$errorsarrayNevyriešené chyby od najnovšej, každá s id, order_id, document_type, request_type, response_status, response_message a time. Prázdne pole upozornenie skryje.
add_filter( 'sf_admin_document_errors', function ( $errors ) {
	return $errors;
} );

V kóde: includes/class-wc-sf-notices.php

sf_after_invoice_create

Akciaod verzie 1.51.0

Spustí sa po úspešnom vytvorení alebo úprave dokladu cez API SuperFaktúry.

ParameterTypPopis
$responseobjectCelá odpoveď API SuperFaktúry (obsahuje ->data->Invoice, ->data->Client, ->data->PaymentLink a ďalšie).
$orderWC_OrderObjednávka WooCommerce, už uložená s aktualizovanými metaúdajmi.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_action( 'sf_after_invoice_create', function ( $response, $order, $type ) {
	// Váš kód.
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_attr_separator

Filterod verzie 1.20.5

Upravuje oddeľovač medzi atribútmi produktu v popise položky na doklade.

ParameterTypPopis
$separatorstringOddeľovač. Predvolene ', '.
add_filter( 'sf_attr_separator', function ( $separator ) {
	return $separator;
} );

V kóde: includes/class-wc-superfaktura.php

sf_before_invoice_create

Akciaod verzie 1.51.0

Spustí sa, keď sú všetky údaje dokladu pripravené v objekte API, tesne pred volaním API.

ParameterTypPopis
$apiWC_SF_ApiKlient API so všetkými pripravenými údajmi (Client, Invoice, InvoiceItem, InvoiceExtra a ďalšie).
$orderWC_OrderObjednávka WooCommerce.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_action( 'sf_before_invoice_create', function ( $api, $order, $type ) {
	// Váš kód.
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_bulk_lock_ttl

Filterod verzie 1.54.0

Upravuje, ako dlho môže zámok kroku hromadnej akcie zostať neobnovený, kým ho môže prevziať iná požiadavka.

ParameterTypPopis
$ttlintPočet sekúnd.
add_filter( 'sf_bulk_lock_ttl', function ( $ttl ) {
	return $ttl;
} );

V kóde: includes/class-wc-sf-bulk.php

sf_bulk_quota_reserve

Filterod verzie 1.54.0

Upravuje, koľko denných požiadaviek na API nechajú hromadné akcie nevyužitých pre bežné vystavovanie dokladov v e-shope.

Dávka sa pozastaví, keď by zostávajúci denný limit klesol pod túto rezervu.

ParameterTypPopis
$reserveintPočet požiadaviek. Predvolene 100.
add_filter( 'sf_bulk_quota_reserve', function ( $reserve ) {
	return $reserve;
} );

V kóde: includes/class-wc-sf-bulk.php

sf_can_regenerate

Filterod verzie 1.11.9

Určuje, či sa dajú doklady objednávky pregenerovať.

Predvolene sa nedajú, keď je objednávka vybavená, alebo keď sa spracováva a platí sa inak ako dobierkou. Keď filter vráti false, existujúci doklad sa nenahradí a odkaz na pregenerovanie sa skryje.

ParameterTypPopis
$can_regenerateboolČi sa dajú doklady pregenerovať.
$orderWC_OrderObjednávka.
add_filter( 'sf_can_regenerate', function ( $can_regenerate, $order ) {
	return $can_regenerate;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_clean_invoice_items_allowed

Filterod verzie 1.54.0

Posledná možnosť odmietnuť nahradenie položiek dokladu, keď už je známy ich počet.

ParameterTypPopis
$allowedboolČi sa majú položky zmazať a pregenerovanie pokračovať.
$invoice_idintID dokladu.
$delete_item_idsarrayID položiek na doklade.
add_filter( 'sf_clean_invoice_items_allowed', function ( $allowed, $invoice_id, $delete_item_ids ) {
	return $allowed;
}, 10, 3 );

V kóde: includes/class-wc-superfaktura.php

sf_client_country_data

Filterod verzie 1.9.65

Upravuje vlastné firemné údaje e-shopu, ktoré sa menia podľa krajiny zákazníka.

Platí len vtedy, keď nastavenia pluginu pre krajiny menia IČ DPH alebo DIČ pre krajinu zákazníka.

ParameterTypPopis
$client_country_dataarrayFiremné údaje, ktoré sa majú zmeniť, napríklad ic_dph, dic a tax_payer.
$orderWC_OrderObjednávka.
add_filter( 'sf_client_country_data', function ( $client_country_data, $order ) {
	return $client_country_data;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_client_data

Filterod verzie 1.6.21

Upravuje údaje zákazníka posielané do SuperFaktúry, napríklad meno, IČO, DIČ, IČ DPH a adresy.

ParameterTypPopis
$client_dataarrayÚdaje odberateľa pre API SuperFaktúry.
$orderWC_OrderObjednávka.
add_filter( 'sf_client_data', function ( $client_data, $order ) {
	return $client_data;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_discount_data

Filterod verzie 1.8.21

Upravuje položku zľavy na doklade.

Keď filter vráti null alebo false, zľava sa na doklad nedostane.

ParameterTypPopis
$discount_dataarray|null|falseÚdaje položky pre API SuperFaktúry.
$orderWC_OrderObjednávka.
add_filter( 'sf_discount_data', function ( $discount_data, $order ) {
	return $discount_data;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_fee_data

Filterod verzie 1.50.1

Upravuje položku poplatku objednávky na doklade.

ParameterTypPopis
$item_dataarrayÚdaje položky pre API SuperFaktúry.
$orderWC_OrderObjednávka.
$feeWC_Order_Item_FeePoložka poplatku.
add_filter( 'sf_fee_data', function ( $item_data, $order, $fee ) {
	return $item_data;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_gateway_mapping

Filterod verzie 1.9.12

Upravuje spôsoby platby zo SuperFaktúry, ku ktorým sa priraďujú platobné metódy e-shopu.

ParameterTypPopis
$gateway_mappingarraySpôsoby platby načítané zo SuperFaktúry ako kľúč => názov, s '0' pre nepoužité.
add_filter( 'sf_gateway_mapping', function ( $gateway_mapping ) {
	return $gateway_mapping;
} );

V kóde: includes/class-wc-sf-settings.php

sf_generate_invoice

Filterod verzie 1.10.11

Umožňuje vynútiť alebo vynechať vytvorenie dokladu.

Príklad:
function custom_generate_invoice( $generate_invoice, $order, $type, $payment_method ) {
    if ( 'regular' === $type && 'ready_to_pickup' === $order->get_status() ) {
        return true;
    }
    return $generate_invoice;
}
add_filter( 'sf_generate_invoice', 'custom_generate_invoice', 10, 4 );
ParameterTypPopis
$generate_invoiceboolČi sa má doklad vytvoriť teraz, podľa nastavení stavov objednávky.
$orderWC_OrderObjednávka.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
$payment_methodstringID platobnej metódy objednávky.
add_filter( 'sf_generate_invoice', function ( $generate_invoice, $order, $type, $payment_method ) {
	return $generate_invoice;
}, 10, 4 );

V kóde: includes/class-wc-superfaktura.php

sf_giftcard_data

Filterod verzie 1.45.4

Upravuje položku darčekovej karty použitej v objednávke (WooCommerce Gift Cards).

ParameterTypPopis
$item_dataarrayÚdaje položky pre API SuperFaktúry.
$orderWC_OrderObjednávka.
$gc_itemWC_Order_Item_ProductPoložka objednávky, v ktorej bola darčeková karta kúpená.
add_filter( 'sf_giftcard_data', function ( $item_data, $order, $gc_item ) {
	return $item_data;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_invoice_attachment_filename

Filterod verzie 1.55.1

Upravuje názov súboru PDF faktúry priloženej k e-mailom WooCommerce.

ParameterTypPopis
$filenamestringNázov súboru, predvolene ten, ktorý SuperFaktúra používa pri stiahnutí.
$orderWC_OrderObjednávka.
$invoice_dataarrayÚdaje faktúry (type, pdf, invoice_id).
add_filter( 'sf_invoice_attachment_filename', function ( $filename, $order, $invoice_data ) {
	return $filename;
}, 10, 3 );

V kóde: includes/class-wc-sf-email.php

sf_invoice_data

Filterod verzie 1.6.21

Upravuje údaje dokladu posielané do SuperFaktúry, napríklad menu, spôsob platby a dodania, číslo objednávky, číselník a bankový účet.

ParameterTypPopis
$set_invoice_dataarrayÚdaje dokladu pre API SuperFaktúry.
$orderWC_OrderObjednávka.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_filter( 'sf_invoice_data', function ( $set_invoice_data, $order, $type ) {
	return $set_invoice_data;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_invoice_extras

Filterod verzie 1.51.0

Upravuje doplnkové údaje dokladu posielané do SuperFaktúry, napríklad príznak OSS, výdajné miesto a hmotnosť.

ParameterTypPopis
$extrasarrayDoplnkové údaje pre API SuperFaktúry (InvoiceExtra).
$orderWC_OrderObjednávka.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_filter( 'sf_invoice_extras', function ( $extras, $order, $type ) {
	return $extras;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_invoice_language

Filterod verzie 1.20.6

Upravuje jazyk dokladu.

ParameterTypPopis
$languagestringKód jazyka v SuperFaktúre, napríklad 'slo', 'cze' alebo 'eng'.
$order_idintID objednávky.
$woocommerce_sf_invoice_languagestringNastavenie jazyka faktúry v plugine.
add_filter( 'sf_invoice_language', function ( $language, $order_id, $woocommerce_sf_invoice_language ) {
	return $language;
}, 10, 3 );

V kóde: includes/class-wc-superfaktura.php

sf_invoice_language_country_map

Filterod verzie 1.56.0

Upravuje priradenie krajín zákazníkov k jazykom faktúry pre nastavenie jazyka „Krajina zákazníka“.

ParameterTypPopis
$country_maparrayKód krajiny => kód jazyka v SuperFaktúre (slo, cze, eng, deu, nld, hrv, hun, pol, rom, rus, slv, spa, ita, ukr).
add_filter( 'sf_invoice_language_country_map', function ( $country_map ) {
	return $country_map;
} );

V kóde: includes/class-wc-superfaktura.php

sf_invoice_oss

Filterod verzie 1.55.3

Určuje, či sa doklad označí ako predaj v režime OSS (One Stop Shop).

ParameterTypPopis
$is_ossboolČi sa má poslať príznak OSS.
$orderWC_OrderObjednávka.
$tax_countrystringKrajina, podľa ktorej bola objednávka zdanená.
add_filter( 'sf_invoice_oss', function ( $is_oss, $order, $tax_country ) {
	return $is_oss;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

sf_item_data

Filterod verzie 1.8.21

Upravuje údaje položky dokladu v SuperFaktúre.

Keď filter vráti null alebo false, položka sa na doklad nedostane.

ParameterTypPopis
$item_dataarray|null|falseÚdaje položky.
$orderWC_OrderObjednávka.
$productWC_Product|falseProdukt.
$itemWC_Order_Item_ProductAktuálna položka objednávky.
add_filter( 'sf_item_data', function ( $item_data, $order, $product, $item ) {
	return $item_data;
}, 10, 4 );

V kóde: includes/class-wc-sf-invoice.php

sf_log_explanation

Filterod verzie 1.57.0

Upravuje vysvetlenie, ktoré sa zobrazí pri zázname v API logu a v upozornení na neúspešný doklad.

ParameterTypPopis
$explanationstringVysvetlenie, môže obsahovať odkaz. Prázdne, keď nie je čo doplniť.
$rowarrayRiadok logu s request_type, response_status a response_message.
add_filter( 'sf_log_explanation', function ( $explanation, $row ) {
	return $explanation;
}, 10, 2 );

V kóde: includes/class-wc-superfaktura.php

sf_metabox_after_invoice_generate_button

Akciaod verzie 1.9.59

Spustí sa na konci boxu SuperFaktúra v detaile objednávky, za tlačidlami a odkazmi dokladov.

ParameterTypPopis
$orderWC_OrderObjednávka.
$invoicestringOdkaz na PDF faktúry, prázdny, keď objednávka faktúru nemá.
add_action( 'sf_metabox_after_invoice_generate_button', function ( $order, $invoice ) {
	// Váš kód.
}, 10, 2 );

V kóde: includes/class-wc-sf-admin.php

sf_order_api_credentials

Filterod verzie 1.10.4

Upravuje prístupové údaje k API SuperFaktúry pre doklady objednávky.

Jeden e-shop tak môže fakturovať do viacerých účtov alebo firiem v SuperFaktúre. Každý chýbajúci kľúč sa vezme z nastavení pluginu.

ParameterTypPopis
$credentialsarrayPrístupové údaje k API, predvolene prázdne. Kľúče: woocommerce_sf_email, woocommerce_sf_apikey, woocommerce_sf_company_id, woocommerce_sf_lang ('sk', 'cz' alebo 'at') a woocommerce_sf_sandbox ('yes' alebo 'no').
$orderWC_OrderObjednávka.
add_filter( 'sf_order_api_credentials', function ( $credentials, $order ) {
	return $credentials;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_refund_data

Filter

Upravuje položku dobropisu vytvorenú z vrátenia peňazí.

Volá sa pre každú vrátenú položku objednávky a ešte raz pre vrátenú sumu, ktorá nepatrí k žiadnej položke. Keď filter vráti null alebo false, položka sa na dobropis nedostane.

ParameterTypPopis
$refund_dataarray|null|falseÚdaje položky dobropisu pre API SuperFaktúry.
$orderWC_OrderObjednávka.
add_filter( 'sf_refund_data', function ( $refund_data, $order ) {
	return $refund_data;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_remote_messages_enabled

Filterod verzie 1.58.0

Určuje, či sa raz denne sťahujú oznamy zo servera autora pluginu. Keď je to vypnuté, zobrazí sa len oznam o eFaktúre, ktorý je priamo v plugine.

ParameterTypPopis
$enabledboolČi sa majú oznamy sťahovať, predvolene podľa nastavenia „Oznamy“.
add_filter( 'sf_remote_messages_enabled', function ( $enabled ) {
	return $enabled;
} );

V kóde: includes/class-wc-sf-notices.php

sf_setup_wizard_gateway_recommendation

Filterod verzie 1.59.0

Upravuje odporúčanie sprievodcu nastavením pre platobnú metódu.

ParameterTypPopis
$recommendationarraydoc (both|proforma|invoice|manual), stav pre zálohovú faktúru a faktúru ("0" pre žiadny), paid, pay_types (uprednostnené spôsoby platby v SuperFaktúre), why.
$gatewayWC_Payment_GatewayPlatobná metóda.
add_filter( 'sf_setup_wizard_gateway_recommendation', function ( $recommendation, $gateway ) {
	return $recommendation;
}, 10, 2 );

V kóde: includes/class-wc-sf-setup-wizard.php

sf_setup_wizard_shipping_recommendation

Filterod verzie 1.59.0

Upravuje odporúčanie sprievodcu nastavením pre spôsob dopravy.

ParameterTypPopis
$typestringKľúč spôsobu dodania v SuperFaktúre, "0", keď nie je známy.
$method_idstringID spôsobu dopravy.
$titlestringNázov spôsobu dopravy.
add_filter( 'sf_setup_wizard_shipping_recommendation', function ( $type, $method_id, $title ) {
	return $type;
}, 10, 3 );

V kóde: includes/class-wc-sf-setup-wizard.php

sf_shipping_data

Filterod verzie 1.9.72

Upravuje položku poštovného na doklade.

Keď filter vráti null alebo false, poštovné sa na doklad nedostane.

ParameterTypPopis
$item_dataarray|null|falseÚdaje položky pre API SuperFaktúry.
$orderWC_OrderObjednávka.
add_filter( 'sf_shipping_data', function ( $item_data, $order ) {
	return $item_data;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_shipping_mapping

Filter

Upravuje spôsoby dodania zo SuperFaktúry, ku ktorým sa priraďujú spôsoby dopravy e-shopu.

ParameterTypPopis
$shipping_mappingarraySpôsoby dodania načítané zo SuperFaktúry ako kľúč => názov, s '0' pre nepoužité.
add_filter( 'sf_shipping_mapping', function ( $shipping_mapping ) {
	return $shipping_mapping;
} );

V kóde: includes/class-wc-sf-settings.php

sf_show_efaktura_banner

Filterod verzie 1.56.0

Určuje, či sa oznam zobrazí.

ParameterTypPopis
$showboolČi sa má zobraziť.
$variantstring'notice' (Nástenka, Pluginy a obrazovky WooCommerce) alebo 'hero' (na karte nastavení pluginu).
$idstringID oznamu, 'efaktura' pre oznam o eFaktúre.
add_filter( 'sf_show_efaktura_banner', function ( $show, $variant, $id ) {
	return $show;
}, 10, 3 );

V kóde: includes/class-wc-sf-notices.php

sf_skip_email_attachment

Filterod verzie 1.9.64

Určuje, či sa PDF dokladu nepriloží k e-mailu objednávky.

ParameterTypPopis
$skip_attachmentboolČi sa má príloha vynechať. Predvolene false.
$orderWC_OrderObjednávka.
add_filter( 'sf_skip_email_attachment', function ( $skip_attachment, $order ) {
	return $skip_attachment;
}, 10, 2 );

V kóde: includes/class-wc-sf-email.php

sf_skip_invoice

Filterod verzie 1.9.63

Určuje, či sa má vynechať vytvorenie alebo úprava dokladu objednávky.

Keď filter vráti true, pre objednávku sa nevytvorí žiadny doklad.

ParameterTypPopis
$skip_invoiceboolČi sa má doklad vynechať. Predvolene false.
$orderWC_OrderObjednávka.
add_filter( 'sf_skip_invoice', function ( $skip_invoice, $order ) {
	return $skip_invoice;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

sf_voucher_credit_data

Filterod verzie 1.53.5

Upravuje položku kreditu použitého z viacúčelového poukazu (WooCommerce PDF Product Vouchers).

Keď filter vráti null alebo false, položka sa na doklad nedostane.

ParameterTypPopis
$item_dataarray|null|falseÚdaje položky pre API SuperFaktúry.
$orderWC_OrderObjednávka.
$coupon_itemWC_Order_Item_CouponPoložka kupónu poukazu.
add_filter( 'sf_voucher_credit_data', function ( $item_data, $order, $coupon_item ) {
	return $item_data;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

superfaktura_accounting_settings

Filter

Upravuje polia nastavení v sekcii Účtovníctvo v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_accounting_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_api_log_settings

Filter

Upravuje polia nastavení v sekcii API log v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_api_log_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_authorization_settings

Filter

Upravuje polia nastavení v sekcii Autorizácia v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_authorization_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_help_settings

Filterod verzie 1.9.56

Upravuje polia nastavení v sekcii Pomoc v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_help_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_integration_settings

Filter

Upravuje polia nastavení v sekcii Integrácia v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_integration_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_invoice_creation_settings

Filter

Upravuje polia nastavení v sekcii Vytvorenie faktúry v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_invoice_creation_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_invoice_id

Filter

Upravuje číslo dokladu vytvorené podľa šablóny čísla v nastaveniach pluginu.

Používa sa, keď doklady čísluje plugin namiesto SuperFaktúry.

ParameterTypPopis
$invoice_idstringČíslo dokladu.
$template_tagsarrayHodnoty značiek šablóny, napríklad [YEAR], [MONTH], [COUNT] a [ORDER_NUMBER].
$keystringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_filter( 'superfaktura_invoice_id', function ( $invoice_id, $template_tags, $key ) {
	return $invoice_id;
}, 10, 3 );

V kóde: includes/class-wc-superfaktura.php

superfaktura_invoice_settings

Filter

Upravuje polia nastavení v sekcii Faktúra v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_invoice_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_payment_settings

Filter

Upravuje polia nastavení v sekcii Platby v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_payment_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

superfaktura_shipping_settings

Filter

Upravuje polia nastavení v sekcii Doprava v nastaveniach pluginu.

ParameterTypPopis
$settingsarrayPolia nastavení vo formáte WooCommerce settings API.
add_filter( 'superfaktura_shipping_settings', function ( $settings ) {
	return $settings;
} );

V kóde: includes/class-wc-sf-settings.php

wc_sf_invoice_id

Filterod verzie 1.5.7

Upravuje číslo nového dokladu.

Použije sa, keď filter wc_sf_sequence_id nenastaví číselník. Keď filter vráti číslo, doklad dostane toto číslo.

ParameterTypPopis
$invoice_idstring|falseČíslo dokladu. Predvolene false.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
$orderWC_OrderObjednávka.
add_filter( 'wc_sf_invoice_id', function ( $invoice_id, $type, $order ) {
	return $invoice_id;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

wc_sf_sequence_id

Filterod verzie 1.5.12

Upravuje číselník SuperFaktúry, podľa ktorého sa očísluje nový doklad.

Keď filter vráti ID číselníka, doklad sa očísluje podľa neho namiesto nastavení pluginu.

ParameterTypPopis
$sequence_idint|falseID číselníka. Predvolene false.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
$orderWC_OrderObjednávka.
add_filter( 'wc_sf_sequence_id', function ( $sequence_id, $type, $order ) {
	return $sequence_id;
}, 10, 3 );

V kóde: includes/class-wc-sf-invoice.php

woocommerce_sf_invoice_extra_items

Filterod verzie 1.6.48

Upravuje položky navyše, ktoré sa pridajú na koniec dokladu.

ParameterTypPopis
$extra_itemsarrayPoložky navyše, každá ako pole údajov položky pre API SuperFaktúry. Predvolene prázdne.
$orderWC_OrderObjednávka.
$itemsarrayPoložky, ktoré už sú na doklade.
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
add_filter( 'woocommerce_sf_invoice_extra_items', function ( $extra_items, $order, $items, $type ) {
	return $extra_items;
}, 10, 4 );

V kóde: includes/class-wc-sf-invoice.php

woocommerce_sf_invoice_type

Filterod verzie 1.6.14

Upravuje typ dokladu posielaný do SuperFaktúry.

ParameterTypPopis
$typestringTyp dokladu: 'proforma' (zálohová faktúra), 'regular' (faktúra) alebo 'cancel' (dobropis).
$actionstring'create' pre nový doklad, 'edit' pri pregenerovaní existujúceho dokladu.
add_filter( 'woocommerce_sf_invoice_type', function ( $type, $action ) {
	return $type;
}, 10, 2 );

V kóde: includes/class-wc-sf-invoice.php

woocommerce_sf_order_is_paid

Filterod verzie 1.6.36

Určuje, či sa objednávka považuje za zaplatenú, takže jej faktúra vznikne ako uhradená.

ParameterTypPopis
$is_paidboolČi je objednávka zaplatená.
$orderWC_OrderObjednávka.
add_filter( 'woocommerce_sf_order_is_paid', function ( $is_paid, $order ) {
	return $is_paid;
}, 10, 2 );

V kóde: includes/class-wc-superfaktura.php