ZEMA

Kontekst

ZEMA upravlja dve WooCommerce trgovini in za računovodstvo potrebuje konsistentne izvoze. Zahtevan workflow je bil CSV z natančno shemo stolpcev, podpičjem kot ločilom in Excelu prijazno kodno tabelo, hkrati pa tudi hitre “drill‑down” povezave do WooCommerce naročil, Minimax dokumentov in payment procesorjev.

Problem

• Računovodstvo potrebuje konsolidiran CSV s predvidljivimi stolpci in kodiranjem.
• Izvoz mora podpirati filtre: obdobje plačil, status naročila in plačilno metodo.
• Ko je naročilo že izvoženo v Minimax, mora CSV vsebovati referenco na izdan račun.
• Transakcije morajo biti sledljive do provider dashboardov (Stripe/PayPal/Bankart).
• Večji volumni naročil zahtevajo deterministično paginacijo.

Pregled rešitve

Dostavili smo varno interno orodje, ki:

• Omogoča izbor ene izmed dveh WooCommerce trgovin in obdobja izvoza.
• Pridobi vsa plačana naročila preko WooCommerce REST API-ja s podporo paginaciji.
• Iz meta podatkov naročil prebere Minimax reference (npr. `_minimax_exported`, `f_IssuedInvoiceId`).
• Generira računovodsko pripravljen CSV (UTF-8 BOM, `;` delimiter), streaman preko `php://output`.

Arhitektura in tehnični pristop

WooCommerce pridobivanje podatkov

• Uporablja WooCommerce PHP client (`automattic/woocommerce`) na `wc/v3`.
• Filtrira po obdobju plačil (`paid_after`, `paid_before`).
• Iterira strani glede na `x-wp-totalpages` response header.

Mapiranje izvoza

• Mapira id/status naročila, billing podatke, zneske, časovne žige in plačilno metodo.
• Zgradi WooCommerce wp-admin URL za hitro odpiranje naročila.
• Če obstaja Minimax invoice id, zgradi direktno povezavo do Minimax UI-ja.
• Če obstaja transaction id, zgradi povezavo do Stripe/PayPal/Bankart (kjer je relevantno).

CSV izpis

• Zapiše UTF-8 BOM za boljšo kompatibilnost s preglednicami.
• Uporablja podpičje kot delimiter za računovodske importe.
• Row-e streama, da ostane poraba pomnilnika nizka.

Tehnologije

• PHP
• WooCommerce REST API + WooCommerce PHP client
• Osnovna zaščita dostopa

Rezultati in vpliv

• Računovodstvo dobi konsistenten, import-ready CSV za vsako trgovino na zahtevo.
• Hitrejše usklajevanje zaradi “drill‑down” povezav (WooCommerce, Minimax, payment dashboard).
• Manj ročnega dela in manj napak pri knjiženju.

Povzetek

Majhna interna aplikacija, ki pridobi plačana WooCommerce naročila, jih obogati z Minimax in payment referencami ter generira računovodsko pripravljen CSV — za multi‑store operacije in učinkovito usklajevanje.