Invoice Pilot

Invoice Pilot udvider WooCommerce med landebevidst fakturering til EU’s 27 medlemslande. Det opfanger de rigtige fakturafelter ved checkout (italienske SDI-/PEC-koder, fransk SIRET, tysk Leitweg-ID, polsk NIP, rumænsk CUI osv.) og udsteder uforanderlige PDF- og XML-fakturaer, kreditnotaer, proformaer og tilbud direkte fra ordren. PDF’en renderes med mPDF; XML-konvolutten vælges automatisk ud fra køberens land og dækker elleve nationale profiler, heriblandt FatturaPA (IT), XRechnung (DE), KSeF FA(2) (PL), Factur-X (FR), CIUS_RO (RO), Facturae (ES) og UBL 2.1 / PEPPOL BIS 3.0 som generisk fallback.

Ud over selve dokumentmotoren leverer Invoice Pilot førsteklasses integrationer med seks regnskabsudbydere — SmartBill (Rumænien), Fatture in Cloud (Italien), Xero, QuickBooks Online, Fortnox (Sverige) og Sage — en VAT-validator, der slår op i den europæiske VIES-tjeneste med en fallback til format-tjek pr. land, et dashboard med KPI-kort og trendgrafer samt et valgfrit multi-provider AI-lag (Anthropic Claude, OpenAI, Google Gemini, DeepSeek, Grok xAI) til smart-fill ved checkout, pre-flight compliance-tjek, oversættelse af linjer og natursprog-dokumentsøgning. Pluginet understøtter også WordPress Multisite med tabeller pr. site og en oversigtsside for hele netværket.

Højdepunkter

• WooCommerce-drevet dokumentlivscyklus for fakturaer, kreditnotaer, proformaer og tilbud, med reserverede nummerserier, et rent flow for udsted / regenerér / genudsted / annullér / kreditnota og styling pr. dokumenttype (disclaimer-banner på ikke-fiskale dokumenter, “Gyldig til”-mærkater på tilbud, “Refunderet total” på kreditnotaer, betalingsblok skjult på tilbud og kreditnota).
• Landespecifikke fakturafelter for EU-27, registreret både mod den klassiske shortcode-checkout og WooCommerce 8.6+ blok-checkout (via Additional Checkout Fields API).
• PDF-rendering via mPDF med en af tre medfølgende skabeloner (Minimal, Classic, Modern) og vælgere til accentfarve, tekstfarve, skrifttype og sælgerlogo.
• Elleve XML-writere, valgt automatisk ud fra køberlandet: FatturaPA (IT), Factur-X / CII (FR), XRechnung 3.0 (DE), KSeF FA(2) (PL), CIUS_RO 1.0.0 (RO), Facturae 3.2.2 (ES), SAF-T PT (PT), OIOUBL (DK), Finvoice 3.0 (FI), ebInterface 6.1 (AT), myDATA InvoicesDoc (GR / EL) — med UBL 2.1 / PEPPOL BIS 3.0 som universel fallback.
• VAT-valideringskæde, der kombinerer den europæiske VIES-SOAP-tjeneste med offline regex-validering pr. land, en DB-baseret cache og en timeligt cron, der revaliderer forældede poster.
• Seks regnskabsintegrationer — SmartBill, Fatture in Cloud, Xero, QuickBooks Online, Fortnox og Sage — hver med krypterede credentials, push-/status-/annullér-operationer og en retry-kø. Fanen Integrationer bruger en sticky provider-vælger, så det panel, du var i gang med at konfigurere, forbliver åbent på tværs af gem.
• Valgfrit AI-lag med fem providere (Anthropic, OpenAI, Google Gemini, DeepSeek, Grok xAI), der dækker smart-fill, compliance-tjek, linjeoversættelse og natursprogssøgning; pluginet virker fuldt uden en API-nøgle.
• Dashboard med periodevælger, fem KPI-kort og to trendgrafer; en separat integrations-log registrerer hvert push og hver fejl.
• WordPress Multisite-understøttelse — hvert under-site har sine egne tabeller, indstillinger og nummerings-tællere, og en netværks-admin-side aggregerer statistik.

Krav

Blok-checkout-integrationen er registreret mod WooCommerce’ Additional Checkout Fields API (introduceret i WooCommerce 8.6). På ældre WooCommerce-versioner tilføjer det klassiske filter woocommerce_billing_fields stadig VAT-, tax-code- og landespecifikke felter til shortcode-checkout, så pluginet degraderer pænt.

Installation

1. Hent den seneste Invoice Pilot-ZIP fra GitHub-siden Releases .
2. Åbn i WordPress Plugins → Tilføj nyt → Upload plugin.
3. Vælg ZIP-filen, og klik på Installer nu.
4. Klik på Aktiver plugin.
5. Åbn Invoice Pilot → Indstillinger for at konfigurere sælger, nummerserier og valgfri integrationer.

Aktivering opretter pluginets databasetabeller, installerer standardindstillingerne og seeder fem nummerserier (én pr. dokumenttype): INV (faktura, standard), REC (kvittering), CN (kreditnota), PRO (proforma) og Q (tilbud), alle med mønsteret YYYY-NNNN og årlig nulstilling. Fire cron-jobs planlægges også: daglig log-oprydning, retry hvert kvarter for fejlede integrations-pushes, timeligt VIES-revalidering og daglig refresh af Fatture in Cloud-token.

På WordPress Multisite kører samme per-site-bootstrap automatisk, når et nyt under-site oprettes (wp_initialize_site).

Konfiguration

Alle Invoice Pilot-skærme ligger under topmenuen Invoice Pilot i WordPress’ admin-sidebar:

• Dashboard — KPI-kort og trendgrafer.
• Dokumenter — moderne data-grid med hvert udstedt dokument (faktura, kreditnota, proforma, tilbud, kvittering), en samlet værktøjslinje (AI-søgning + typefilter), farvede status-pills (betalt / annulleret / konverteret / kladde / udstedt), paginering med 20 rækker og PDF- / XML- / Slet-handlinger inline.
• Indstillinger — konfigurationsside med otte faner (dokumenteret nedenfor).
• Log — integrations-log-poster med opbevaring og en manuel oprydningshandling.

Indstillingssiden er opdelt i følgende faner i den rækkefølge, de optræder:

1. Generelt
2. Serier
3. Dokumenttyper
4. Skabeloner
5. VAT-validering
6. Integrationer
7. AI
8. Avanceret

Generelt

Generelt-fanen er delt i tre kort: Licens, Sælgerdetaljer og Dokument-standarder.

Licens

Sælgerdetaljer rummer identiteten, der trykkes på hvert udstedt dokument; Dokument-standarder rummer et lille antal WooCommerce-niveau-defaults.

Serier

Serier-fanen er en CRUD-tabel over nummerserier, som ligger i pluginets egen series-tabel. Hver række styrer, hvordan dokumenter af en given type nummereres.

Kolonner: Slug, Mønster, Tæller, Reset, Standard, Aktiv, Handlinger (Rediger / Slet).

Tilføj-/Rediger-formularen viser:

At omdøbe en slug opdaterer serie-rækken på plads (det interne id og referencer bevares) og migrerer indstillingen default_series automatisk, hvis den pegede på den gamle slug. At slette en serie fjerner ikke eksisterende dokumenter; de beholder deres numre.

Dokumenttyper

Fanen Dokumenttyper slår valgfri dokumenttyper til og fra og viser de FatturaPA-specifikke bollo- og ritenuta-indstillinger.

Dokumenttyper-kort

FatturaPA — italiensk B2B-kort

Skabeloner

Vælg én af tre medfølgende PDF-skabeloner, og tilpas dens farver og typografi.

Yderligere felter:

Fanen indlejrer også en live PDF-preview (renderet mod REST-endpointet /wp-json/invoice-pilot/v1/preview-template), så du kan sammenligne skabeloner side om side, før du gemmer. Et skift af radio udveksler iframen straks; valget gemmes først, når du klikker på Gem skabelon.

En Dokumenttype-vælger sidder over iframen, så du kan se, hvordan hver af de fire dokumenttyper renderes — invoice, credit_note, proforma, quote — med samme skabelon, eksempel-sælger og eksempel-køber. Forskellene pr. type er:

Tilbud omdøber desuden de fremtrædende “Issued”-/“Due date”-celler til Valid until og hero-totalen til Estimated total; kreditnotaer omdøber den til Refund total. Forskellene kommer fra en label-overstyringskort pr. type og en doc_type_context()-helper, der fødes ind i template-engine, så de tre medfølgende designs (Minimal / Classic / Modern) bevarer en konsistent visuel identitet på tværs af dokumenttyper uden at duplikere skabelonfiler.

Footeren skriver altid køberens land på sin fulde engelske form (f.eks. Germany, ikke DE) — ISO-koden fra ordren bliver oversat via PHP’s Locale::getDisplayRegion() før rendering, hvilket holder den renderede faktura læsbar for både menneskelige købere og skatterevisorer. Selve sælgerens VAT trykkes ifølge VAT-nummerformat på PDF under Generelt → Dokument-standarder — standardværdien er den VIES-stil-præfikserede form (VAT IT04032690614), med en Bare-mulighed for jurisdiktioner, der foretrækker nummeret uden præfiks.

Dispatcheren, der vælger den rigtige XML-konvolut pr. køberland, er filteret invoice_pilot_xml_writer_for_country, så host-kode kan overstyre pr. ISO (se Hooks og filtre).

VAT-validering

VAT-identifiers indtastet ved checkout (og på enhver adresseskærm, der viser feltet) køres gennem en kæde af validatorer. Hver validator slås til af en uafhængig kontakt og kører i rækkefølge, indtil én returnerer et positivt svar; både positive og negative svar caches i den konfigurerede TTL.

En read-only Cache-state-række rapporterer antal cachede poster, og hvor mange der er udløbet og afventer udsmidning.

Test VAT-validering — et lille tester-kort under indstillingerne kører hver provider direkte mod et enkelt VAT-nummer, springer kædens rækkefølge og cachen over, så du kan se, om VIES faktisk bekræftede nummeret, eller om det kun var offline-formattjekket, der gjorde det.

Seed EU-27 standard-momssatser — kortet i bunden udfylder WooCommerce → Indstillinger → Skat → Standardsatser med den aktuelle standard-momssats for hvert EU-27-medlemsland (AT 20% BE 21% BG 20% HR 25% CY 19% CZ 21% DK 25% EE 22% FI 25.5% FR 20% DE 19% GR 24% HU 27% IE 23% IT 22% LV 21% LT 21% LU 17% MT 18% NL 21% PL 23% PT 23% RO 21% SK 23% SI 22% ES 21% SE 25%). Som standard indsættes kun manglende lande; sæt flueben i Overskriv eksisterende satser for at tvinge hver række til den kanoniske værdi (nyttigt efter EU justerer en national sats). Kortet lister også hvert (ISO, sats)-par, så du ser præcist, hvad der skrives, før du trykker på knappen.

Integrationer

Fanen Integrationer renderer ét panel pr. registreret integrations-provider bag en enkelt Provider-vælger øverst — vælg den provider, du vil konfigurere, og kun dens kort er synligt, de øvrige bliver i DOM’en, blot skjult. Vælgeren er sticky på tværs af formular-gem: når du gemmer en providers formular (eller lander på fanen med ?integration=<id> i URL’en), beholder næste render den provider valgt, så du ikke kastes tilbage til den, der står først i registreringsrækkefølgen.

Som standard leverer Invoice Pilot seks providere; tredjeparts-kode kan registrere flere via filteret invoice_pilot_integration_providers.

Hvert provider-panel afsluttes med et Connection Status-kort med en Test Connection-knap. Knappen sender et let kald mod de gemte credentials og udskriver upstream-svaret — gem formularen først, hvis du lige har indsat nye tokens.

SmartBill

Rumænsk faktureringsudbyder. Credentials krypteres at rest via pluginets symmetriske krypto-lag.

Når slået til, kalder Invoice Pilot POST /SBORO/api/v2/invoice ved udstedelse, derefter pull_status til afstemning og void, når en faktura annulleres.

Fatture in Cloud

Italiensk faktureringsudbyder. OAuth-tokens opbevares krypteret. Det daglige cron invoice_pilot_refresh_fic_token opdaterer access-tokenet automatisk, når integrationen er slået til.

I henhold til Fatture in Clouds produktpolitik sender Invoice Pilot ikke FatturaPA til SDI for dig. SDI-indsendelse er overladt til et separat manuelt trin inde fra din FIC-konto.

Xero

Global regnskabsplatform. OAuth 2.0-tokens krypteres at rest. Indstillingsfanen er opdelt i Connection (status + knapperne Connect / Disconnect) øverst og Settings (app-credentials + push-adfærd) nedenunder.

Tilslutning

Invoice Pilot kommer med et indbygget OAuth-flow — du behøver ikke længere udføre dansen i Postman og indsætte fire strenge i formularen. End-to-end-opsætningen er:

1. Opret en Web-app på developer.xero.com  med den redirect-URI, der vises i Connection-panelet — kopiér den ordret, Xero matcher den tegn-for-tegn. Apps oprettet efter 2. marts 2026 kan kun anmode om det granulære scope-sæt; Invoice Pilot vælger det rigtige automatisk.
2. Generér en Client secret på Xero-app-siden (Xero viser den kun én gang), indsæt derefter Client ID og Client secret i Settings-formularen og gem.
3. Klik på Connect to Xero. Du sendes gennem den almindelige samtykkeskærm, og hvis din konto autoriserer mere end én organisation, omdirigeres du til en in-card-vælger, hvor du kan vælge målet tenant. Tokens udveksles + gemmes automatisk.
4. Disconnect rydder access- og refresh-tokens samt tenant-id’et, men beholder app-credentials, så det er nemt at genoprette forbindelsen.

Pushes bruger POST /Invoices med standardheaderen Idempotency-Key, der udledes af det lokale faktura-id + nummer, så et netværks-retry falder sammen til samme Xero InvoiceID i stedet for at oprette en dublet. Refresh-tokenet roteres automatisk ved 401; hvis det nogensinde udløber (Xero invaliderer refresh-tokens efter 60 dages inaktivitet), så klik blot Connect igen.

Felter

QuickBooks Online

Intuit QuickBooks Online — US / CA / UK / globalt. OAuth 2.0-tokens krypteres at rest. Settings-fanen er opdelt med Connection (status + Connect/Disconnect-knapper) øverst og Settings (app-credentials + push-adfærd) nedenunder.

Forbindelse

Invoice Pilot leveres med et indbygget OAuth-flow — du skal ikke længere danse rundt i Postman og indsætte fem strenge i formularen. End-to-end-opsætningen er:

1. Opret en app på developer.intuit.com  med QuickBooks Online and Payments som platform og scope com.intuit.quickbooks.accounting. Åbn fanen Keys & OAuth og skift mellem Development og Production afhængigt af hvilket miljø du sigter mod — hvert miljø har sit eget par af client_id + secret.
2. Tilføj den redirect-URI, der vises i Connection-panelet, til listen Redirect URIs og klik Save — Intuit accepterer http://localhost for Development-apps.
3. Indsæt Client ID og Client secret i Settings-formularen, vælg det matchende Environment (Sandbox / Production) og gem.
4. Klik på Connect to QuickBooks. Intuits samtykkeskærm lader dig vælge den virksomhed, som integrationen skal skrive imod; det valgte realmId returneres i callback-URL’en og gemmes automatisk — der er ingen separat tenant-vælger.
5. Disconnect rydder access- og refresh-tokens samt realm-id’et, men beholder app-credentials, så det er nemt at genoprette forbindelsen.

Hvert push bruger POST /v3/company/{realmId}/invoice med query-parameteren requestid sat til en stabil per-faktura-værdi — QBO kollapser POST-retries til det oprindelige svar, så et netværks-retry vil aldrig oprette en dublet. Pushes medfører også minorversion=75, så QBO returnerer aktuelle entity-former (uden den nedgraderer API’et stille til sin 2017-kontrakt). Refresh-tokens varer 100 dage fra udstedelse og roteres ved hver brug; pluginnet håndterer rotationen transparent ved 401.

Felter

Fortnox

Svensk regnskabsplatform. OAuth 2.0-credentials krypteres at rest.

Sage

OAuth 2.0-regnskabsplatform (Sage Accounting / Business Cloud).

AI

AI-fanen er delt i to kort: Provider Configuration og Features. Pluginet virker fuldt uden en API-nøgle; denne fane tilføjer valgfri AI-funktioner.

Provider Configuration

Modeller pr. provider:

Features

Avanceret

Opbevaring og afinstallation

Vedligeholdelseshandlinger

• Kør log-oprydning nu — fyrer handlingen invoice_pilot_cleanup_logs med det samme i stedet for at vente på det daglige cron.
• Ryd valideringscache — sletter hver række fra VAT-valideringscachens tabel.

En lille Versions-række nederst trykker den aktuelle plugin-version og databaseskema-version.

Brug

Auto-udstedelse af faktura fra en WooCommerce-ordre

Standardflowet kræver ingen manuel handling.

1. En kunde lægger en ordre på WooCommerce. Checkout viser felterne VAT-nummer og Skattekode plus eventuelle landespecifikke felter registreret for faktura-landet (f.eks. SDI recipient code og Certified email (PEC) på IT-ordrer). VAT-feltet valideres live, mens kunden skriver — et grønt ✓-badge vises i inputtet, når kæden bekræfter nummeret, et rødt ✕ når det fejler. Hvis køberen er i en anden EU-medlemsstat og VAT’en er gyldig, nulstiller WooCommerce momsen i kurven automatisk (intra-EU B2B reverse charge — se Indstillinger → VAT-validering).
2. Når ordren rammer trigger-statussen defineret under Indstillinger → Generelt → Trigger-status (processing som standard), udsteder Invoice Pilot en faktura ved hjælp af Standardserien (INV som standard), gemmer et uforanderligt JSON-snapshot af ordren, renderer PDF’en, genererer XML-konvolutten for køberlandet og pusher til enhver aktiv integration.
3. Ordreskærmen får en Invoice Pilot-meta-boks, der lister de udstedte dokumenter med links til PDF og XML samt action-knapper til Regenerér, Genudsted, Annullér, Opret kreditnota, Opret proforma, Opret tilbud og Push til provider.

Invoice Pilot-meta-boksen viser, for det seneste ikke-annullerede dokument på ordren: dokument-nummeret (f.eks. INV-2026-0063), status-pillen (Udstedt / Betalt / Annulleret), download-knapperne PDF og XML (token-signerede REST-links), en Regenerér dokument-handling, der re-renderer artefakterne mod den aktuelle skabelon og sælgerindstillinger uden at ændre dokumentnummeret, og et Andre dokumenter-afsnit, der eksponerer ét-klik-knapperne Opret proforma og Opret tilbud. Når en integration er slået til, dukker en Push til provider-knap op ved siden af PDF- / XML-links og replayer integrations-kaldet mod det konfigurerede mål.

Manuel udstedelse

Hvis automatisk udstedelse er slået fra, eller ordren endnu ikke har nået trigger-statussen, har ordrens meta-boks en Udsted nu-knap. Samme flow gælder — snapshot, PDF, XML, integrations-push — men det kører på efterspørgsel.

Kreditnotaer fra refusioner

Når Auto-udsted kreditnota ved WC-refusion er slået til (standard), udløser enhver WooCommerce-refusion oprettet mod en ordre med en eksisterende faktura en kreditnota i CN-serien. Kreditnotaen peger tilbage på den forrige faktura og refererer den i XML’en. Den renderede PDF har en “Refund of INV-…”-disclaimer-banner øverst, en CREDIT NOTE-status-pille, Refund total i hero-cellen, og IBAN-/ betalingsmetode-footeren skjules (det oprindelige betalingsflow gælder ikke længere). Du kan også udstede en kreditnota manuelt — fuld eller delvis — fra Handlinger-kortet på fakturaens redigeringsside, så længe forrige faktura er i status issued.

Proformaer og tilbud

Når de tilsvarende kontakter er slået til, viser ordreskærmen også knapperne Opret proforma og Opret tilbud. Begge producerer ikke-fiskale dokumenter — en PDF renderes, men ingen XML genereres for tilbud. Den renderede PDF har en visuel behandling specifik for sin type: en disclaimer-banner øverst (“Proforma — not a fiscal document.” / “Quote — not a fiscal document, subject to acceptance.”), en “QUOTE”-/“PROFORMA”-status-pille i stedet for “ISSUED”, og på tilbud skifter den fremtrædende datolabel til Valid until, og hero-totalen til Estimated total. Tilbud skjuler IBAN-/ betalingsmetode-blokken, da der endnu ikke er nogen betaling.

En proforma kan konverteres til en faktura med handlingen Konverter, der renummererer dokumentet under den konfigurerede faktura-serie.

Send en faktura til kunden

Pluginet registrerer en ordre-handling Send Invoice Pilot invoice to customer under WooCommerce’ standard ordre-handlinger-dropdown, der mailer PDF’en til køberen via WordPress’ wp_mail().

Hent dokumenter

PDF’er og XML-konvolutter serveres fra et offentligt adresserbart, men token-signeret REST-endpoint:

GET /wp-json/invoice-pilot/v1/download/{id}/{format}?token=…

{format} er pdf eller xml. Tokenet genereres, når dokumentet udstedes, og trykkes ind i ordrens meta-boks og fakturatabellen.

Dashboard

Invoice Pilot → Dashboard åbner et Activity overview-kort oven på et Trends-kort. Activity overview viser en periodelinje med fire vinduer — 7 dage, 14 dage, 30 dage (standard) og 90 dage — og fem KPI-kort:

• Fakturaer — samlet antal dokumenter udstedt i perioden.
• Net revenue — sum af netto-totaler i shop-valutaen, gengivet med locale’ens valutasymbol og to decimaler (f.eks. €3,876.09 eller 3.876,09 € afhængigt af administratorens locale).
• VAT collected — sum af VAT-totaler fra det uforanderlige snapshot. Samme locale-bevidste valutaformatering som Net revenue. En separat skema-migration backfiller denne værdi for fakturaer udstedt før skemaversion 1.3.1, hvor kolonnen ikke blev udfyldt på skrivetidspunktet.
• Avg value — nettoomsætning divideret med fakturaantal, også valutaformateret.
• B2B / B2C — split af B2B-fakturaer (køber har et VAT-nummer) vs. B2C-fakturaer i samme periode.

Under KPI’erne renderer Trends-kortet to grafer side om side — Invoices over time (et dual-axis line + area-diagram med fakturaantal på den venstre akse og nettoomsætningstrenden udfyldt på den højre akse) og By buyer country (et donut-diagram over de mest hyppige køber-ISO-koder med farve-legenden nedenunder). Alle tal hydreres fra /wp-json/invoice-pilot/v1/dashboard?days=N.

Dokumentliste

Invoice Pilot → Dokumenter lister hvert udstedt dokument med status-pills (betalt / annulleret / konverteret / kladde / udstedt — farvekodet efter livscyklustilstand), en Compliance-kolonne med det farvekodede badge fra AI-pre-flight-tjekket, og PDF-/XML-/Slet-handlinger pr. række inline. Siden paginerer 20 rækker ad gangen og viser en samlet værktøjslinje, der kombinerer AI-fritekstsøgning med et dokumenttype-filter (invoice / credit_note / proforma / quote / receipt) plus en løbende tæller til højre. Når AI-søgning er slået til, accepterer søgefeltet fritekst-forespørgsler (for eksempel “Tyske fakturaer sidste måned over 1.000 EUR”), som den valgte provider oversætter til en list-query; de resolverede filter-chips vises over tabellen, så du kan se præcis, hvordan modellen parsede din sætning.

WooCommerce-ordreliste

Invoice Pilot tilføjer en enkelt Invoice-kolonne til standard-WooCommerce-ordrelisten (/wp-admin/admin.php?page=wc-orders), så shop-ejeren kan se på et øjeblik, hvilke ordrer der allerede er dokumenteret, og hvilke ikke, uden at forlade Ordrer-skærmen. Kolonnen sidder mellem Order og Date og viser det dokumentnummer, den konfigurerede serie har tildelt (for eksempel INV-2026-0063) læst ordret fra den uforanderlige number-kolonne, med et lille eye-preview-ikon ved siden af nummeret, der åbner den renderede PDF inline i en ny fane.

Ordrer uden et udstedt dokument renderer en tankestreg — nyttigt, når man fejlsøger trigger-status-uoverensstemmelser eller filtrerer ordrer, der har brug for en manuel wp invoice-pilot issue-kørsel. Den samme renderer wirer både den gamle posts-tabelkolonne (manage_edit-shop_order_columns) og HPOS-kolonnen (manage_woocommerce_page_wc-orders_columns), så oplevelsen er identisk uanset hvilken ordre-storage din shop kører på.

Integrations-log

Invoice Pilot → Log registrerer hvert integrations-push, hvert svar og hver fejl. Værktøjslinjen øverst kombinerer en Bulk actions-vælger + Apply-knap (i øjeblikket en ét-handlings bulk-delete), en provider-dropdown og en action-dropdown — begge fyldt op fra de værdier, der reelt optræder i loggen, så de kun nogensinde viser filtre, der matcher en faktisk række — og en løbende tæller med antal poster til højre.

Data-griddet har otte kolonner:

Følsomme payload-felter redactes ved skrivning af pluginets Core\Logger, så request- og response-bodies er sikre at beholde i loggen. Gamle poster ryddes af det daglige cron invoice_pilot_cleanup_logs ud fra Log-opbevaring (dage)-indstillingen på Avanceret-fanen.

Netværks-admin (Multisite)

På et Multisite-netværk dukker en ekstra side Invoice Pilot Network op i netværks-admin-sidebaren. Den aggregerer faktura-antal og totaler på tværs af hvert under-site, hvor Invoice Pilot er aktivt.

EU-27-fakturering

Invoice Pilot leverer et register over landespecifikke fakturafelter for hvert EU-27-medlemsland. Hvert felt er valgfrit ved checkout (pluginet tvinger ikke B2B-only-data på en B2C-ordre); validering fyrer kun, når køberlandet matcher feltets ISO.

Registret dækker i øjeblikket:

Blok-checkout-integrationen registrerer felter under namespacet invoice-pilot/... gennem Additional Checkout Fields API. Som standard vises kun de italienske felter i blok-checkout for ikke at overvælde ikke-italienske købere; kontakten Alle EU-27-felter ved checkout under Generelt slår hele sættet til. Den klassiske shortcode-checkout renderer altid hele registret filtreret af det valgte faktura-land.

Landefelter gemmes på ordren, kopieres ind i det uforanderlige faktura-snapshot og forbruges af XML-writerne — for eksempel bliver det italienske ei_recipient_code til CodiceDestinatario / PECDestinatario i FatturaPA-konvolutten, mens det tyske leitweg_id bliver til BuyerReference / EndpointID 0204 i XRechnung.

Integrationer

SmartBill

SmartBill (Rumænien) er koblet ind i pluginets IntegrationManager via filteret invoice_pilot_integration_providers og udstiller den standardiserede provider-grænseflade: push, pull_status, void og test_connection.

• Push mapper faktura-snapshottet til SmartBill-JSON-skemaet og kalder POST /SBORO/api/v2/invoice med den konfigurerede CIF og serie.
• Status-sync afstemmer draft- / issued- / paid-state, når cron for retry hvert kvarter kører.
• Void annullerer en tidligere pushet faktura på SmartBill, når kilde-fakturaen annulleres i WordPress.

Alle handlinger logges til integrations-loggen. Fejl sættes i kø og prøves igen af cronet invoice_pilot_retry_integrations.

Fatture in Cloud

Fatture in Cloud (Italien) følger samme provider-grænseflade og mapper faktura-snapshottet til entity-/items_list-formen, FIC’s udstedte-dokumenter-endpoint forventer. Italienske landespecifikke felter mappes eksplicit:

• ei_recipient_code → ei_code
• ei_certified_email → certified_email
• køber-VAT / skattekode / provins / land → tilsvarende entity-nøgler

OAuth-credentials krypteres at rest. Det daglige cron invoice_pilot_refresh_fic_token opdaterer access-tokenet, når integrationen er slået til. At sætte Opret kunder til til får integrationen til at oprette en ny kunde-post i FIC ved den første faktura for en køber.

Invoice Pilot indsender ikke FatturaPA til SDI for dig. SDI-indsendelse er overladt til et separat manuelt trin inde fra din Fatture in Cloud-konto.

AI smart-fill

AI-laget er fuldt valgfrit. Uden en konfigureret API-nøgle udsteder pluginet fortsat fakturaer, renderer PDF’er og XML, validerer VAT og pusher til integrationer — kun de fire AI-funktioner nedenfor er utilgængelige.

Fem providere understøttes:

API-nøglen opbevares krypteret at rest via pluginets symmetriske krypto-lag. Et tryk på Test Connection sender et minimalt kald til det valgte endpoint og blotter upstream-fejlen, hvis credentials er forkerte.

Fire funktioner kan slås til og fra hver for sig, så snart en nøgle ligger på:

• Smart-fill ved checkout — et tekstfelt “Paste billing details” dukker op ved checkout. Modellen parser den fri tekst og udfylder den strukturerede WooCommerce-faktureringsformular, inklusive landespecifikke felter. Rate-limited pr. session.
• Compliance pre-flight-tjek — hver faktura køres gennem modellen lige inden udstedelse, med mulighed for at blokere udstedelse ved fejl-niveau-findings, når et kritisk problem findes (for eksempel en italiensk B2B-faktura uden SDI-modtagerkode).
• Auto-oversæt linjer — fakturalinjers beskrivelser oversættes til køberens sprog. Når søster-pluginet Polyglot  er installeret, delegeres oversættelses-pipelinen til det.
• Natursprog-dokumentsøgning — søgefeltet på Dokumenter-admin-siden accepterer fritekst-forespørgsler, modellen oversætter til en list-query.

Hver funktion har sit eget rate limit pr. time.

Hooks og filtre

Centraliserede hook-navne lever i klassen \InvoicePilot\Core\Hooks. Hele listen:

Registrer en custom XML-writer:

add_filter(
    'invoice_pilot_xml_writer_for_country',
    function ( $writer, $iso ) {
        if ( 'NL' === $iso ) {
            return new My_Custom_Nl_Writer();
        }
        return $writer;
    },
    20,
    2
);

Registrer en custom integrations-provider:

add_filter(
    'invoice_pilot_integration_providers',
    function ( array $providers ) {
        $providers[] = new My_Custom_Provider();
        return $providers;
    }
);

Skjul eller udvid landespecifikke checkout-felter (for eksempel for at fjerne Italiens ei_certified_email (PEC) og fiscal_regime (RF-kode) prompts, når din butik aldrig har brug for dem — ingen plugin-fork nødvendig):

add_filter(
    'invoice_pilot_country_fields',
    function ( array $fields, string $iso ) {
        if ( 'IT' === $iso ) {
            $fields = array_values(
                array_filter(
                    $fields,
                    fn ( $f ) => ! in_array(
                        $f->name,
                        [ 'ei_certified_email', 'fiscal_regime' ],
                        true
                    )
                )
            );
        }
        return $fields;
    },
    10,
    2
);

Filteret kører både på PHP-submit-valideringsstien og på JS-snapshottet serveret til WC Blocks-checkoutet, så de to lag forbliver synkroniserede. Felt-maskinnavne, der i øjeblikket leveres (brug disse i filteret):

Den fulde per-land registry er defineret i CountryFieldRegistry::install_defaults() og dækker alle EU-27 ISO’er.

FAQ

Indsender Invoice Pilot FatturaPA til SDI?

Nej. Invoice Pilot genererer FatturaPA-XML’en og gemmer den på ordren; SDI-indsendelse er bevidst overladt til et separat manuelt trin (eller til Fatture in Cloud-integrationen på din konto).

Kan jeg tilføje en writer til et land, der ikke er bygget ind?

Ja. Hægt dig på invoice_pilot_xml_writer_for_country, og returner din egen implementation af \InvoicePilot\Modules\Xml\XmlWriterInterface.

Virker det med WooCommerce’ blok-checkout?

Ja. Landespecifikke felter er registreret via WooCommerce 8.6+ Additional Checkout Fields API, så de optræder både i blok-checkout og i den klassiske shortcode-checkout. På WooCommerce-versioner ældre end 8.6 bruges kun det klassiske filter-flow.

Virker det med WordPress Multisite?

Ja. Hvert under-site har sine egne tabeller, indstillinger og nummerings-tællere. En netværks-admin-side under Network Admin → Invoice Pilot Network aggregerer faktura-antal på tværs af netværket. På nye under-sites oprettes tabeller og standard-serier automatisk via hooken wp_initialize_site.

Er credentials krypteret?

Ja. SmartBill-tokens, Fatture in Cloud-OAuth-tokens og AI-API-nøglen er krypteret at rest via \InvoicePilot\Core\Crypto. Et tomt token-felt ved næste gem bevarer den eksisterende gemte værdi.

Hvad sker der med mine data, hvis jeg sletter pluginet?

Intet, medmindre du vælger det til. Standarden for Avanceret → Slet data ved afinstallation er fra, så tabeller, valg, integrations-logs og valideringscachen bevares på tværs af deaktivering / genaktivering. Slå valget til, hvis du vil have uninstall.php-rutinen til at fjerne alt, når WordPress sletter pluginet.

Hvor får jeg en API-nøgle til AI-funktionerne?

Hver provider har sin egen konsol: Anthropic på console.anthropic.com , OpenAI på platform.openai.com , Google AI Studio på aistudio.google.com , DeepSeek på platform.deepseek.com  og Grok på console.x.ai . AI-fanen linker direkte til den valgte providers konsol.

Skal jeg have en AI-nøgle for at pluginet virker?

Nej. AI-funktionerne (smart-fill, compliance-tjek, linjeoversættelse, natursprogssøgning) er valgfri. Kerne-faktureringsmotoren — dokumentlivscyklus, PDF- og XML-generering, VAT-validering, integrationer, dashboard — kører uden en API-nøgle.

Fejlfinding

Fakturaen udstedes ikke, når ordren skifter til Processing

Tjek Indstillinger → Generelt → Trigger-status. Standarden er processing; har du tilpasset den (for eksempel til completed), fyrer auto-udstedelse kun på den konfigurerede status. Du kan også trykke på Udsted nu fra ordrens meta-boks for at udstede manuelt uanset triggeren.

Checkout viser for mange (eller for få) landefelter

Standarden viser kun de italienske SDI-felter. Åbn Indstillinger → Generelt → Document defaults → Landespecifikke faktureringsfelter og vælg omfanget:

• Fra — kun de universelle VAT- og skattekode-felter vises.
• Kun Italien (SDI / PEC / fiscal regime) — standard.
• Alle EU-27 landespecifikke felter — hver ISO i registret.

Indstillingen gælder både blok-checkout og den klassiske shortcode-checkout. Landespecifikke felter skjules stadig client-side, når faktura-landet ikke matcher.

VAT-validering hænger eller timer ud

VIES-tjenesten er nu og da langsom eller utilgængelig. Pluginet holder en cache pr. VAT i den konfigurerede TTL (24 timer som standard) og revaliderer forældede poster en gang i timen via cronet invoice_pilot_revalidate_vies. Hvis VIES er nede, accepterer Format pr. land-validatoren stadig velformede numre. Du kan også hæve cache-TTL’en under Indstillinger → VAT-validering.

Dashboardet viser ingen data

Dashboardets SQL bruger JSON_EXTRACT / JSON_UNQUOTE mod den uforanderlige snapshot-kolonne. Sørg for, at din databaseserver er MySQL 5.7+ eller MariaDB 10.2+. Hvis periodelinjen viser det rigtige vindue, men kortene bliver stående på --, så åbn /wp-json/invoice-pilot/v1/dashboard?days=30 direkte og se svaret — REST-autentificeringsfejl dukker op som rest_forbidden.

Integrations-push fejler

Åbn Invoice Pilot → Log og find den fejlede post — HTTP-kolonnen markerer ikke-2xx-svar med et farvet badge, og Error-kolonnen viser upstream-fejlbeskeden i rødt. Den fejlede post prøves automatisk igen af cronet invoice_pilot_retry_integrations hvert kvarter; du kan også trykke på Push til provider i ordrens meta-boks for at prøve igen med det samme. Brug Slet-handlingen på en række for at rydde en engangs-post uden at vente på opbevarings-cronet.

Test Connection på AI-fanen rapporterer en fejl

Beskeden i rødt kommer direkte fra providerens endpoint. Almindelige årsager:

• En ugyldig eller tilbagekaldt API-nøgle — generér en ny, indsæt den i feltet API Key, og gem.
• Et modelnavn, kontoen ikke har adgang til — vælg en anden model i dropdownen.
• Hosten blokerer udgående netværk — bekræft, at udgående HTTPS til api.anthropic.com, api.openai.com, generativelanguage.googleapis.com, api.deepseek.com eller api.x.ai er tilladt.

Mail-alerts til kunden kommer ikke frem

Mail med fakturaer til kunder sendes via WordPress’ wp_mail(). Kommer ingen mail frem, ligger fejlen næsten altid i sitets mailopsætning og ikke i Invoice Pilot. Installer et transaktionsmail-plugin (for eksempel et, der sender WordPress-mail via SMTP), og udløs ordre-handlingen Send Invoice Pilot invoice to customer igen fra en test-ordre.