ZEMA

Kontekst

ZEMA upravlja s dvije WooCommerce trgovine i za računovodstvo treba konzistentne izvoze. Traženi workflow bio je CSV s točnom shemom stupaca, točkom-zarezom kao delimiterom i kodnom tablicom prilagođenom Excelu, uz brze “drill‑down” poveznice do WooCommerce narudžbi, Minimax dokumenata i payment procesora.

Problem

• Računovodstvo treba konsolidiran CSV s predvidljivim stupcima i kodiranjem.
• Izvoz mora podržavati filtre: razdoblje plaćanja, status narudžbe i metodu plaćanja.
• Kad je narudžba već izvezena u Minimax, CSV mora sadržavati referencu na izdani račun.
• Transakcije moraju biti sljedive do provider dashboarda (Stripe/PayPal/Bankart).
• Veći volumeni narudžbi zahtijevaju determinističku paginaciju.

Pregled rješenja

Isporčili smo siguran interni alat koji:

• Omogućuje odabir jedne od dvije WooCommerce trgovine i razdoblja izvoza.
• Dohvaća sve plaćene narudžbe preko WooCommerce REST API-ja uz podršku paginaciji.
• Iz meta podataka narudžbi dohvaća Minimax reference (npr. `_minimax_exported`, `f_IssuedInvoiceId`).
• Generira računovodstveno pripremljen CSV (UTF-8 BOM, `;` delimiter), streaman preko `php://output`.

Arhitektura i tehnički pristup

Dohvat podataka iz WooCommercea

• Koristi WooCommerce PHP client (`automattic/woocommerce`) na `wc/v3`.
• Filtrira po razdoblju plaćanja (`paid_after`, `paid_before`).
• Iterira stranice prema `x-wp-totalpages` response headeru.

Mapiranje izvoza

• Mapira id/status narudžbe, billing podatke, iznose, vremenske oznake i metodu plaćanja.
• Gradi WooCommerce wp-admin URL za brzo otvaranje narudžbe.
• Ako postoji Minimax invoice id, gradi direktnu poveznicu do Minimax UI-ja.
• Ako postoji transaction id, gradi poveznicu do Stripe/PayPal/Bankart (gdje je relevantno).

CSV ispis

• Upisuje UTF-8 BOM za bolju kompatibilnost s proračunskim tablicama.
• Koristi točku-zarez kao delimiter za računovodstvene importe.
• Streama redove kako bi potrošnja memorije ostala niska.

Tehnologije

• PHP
• WooCommerce REST API + WooCommerce PHP client
• Osnovna zaštita pristupa

Rezultati i učinak

• Računovodstvo dobiva konzistentan, import-ready CSV za svaku trgovinu na zahtjev.
• Brže usklađivanje zbog “drill‑down” poveznica (WooCommerce, Minimax, payment dashboard).
• Manje ručnog rada i manje pogrešaka pri knjiženju.

Sažetak

Mala interna aplikacija koja dohvaća plaćene WooCommerce narudžbe, obogaćuje ih Minimax i payment referencama te generira računovodstveno pripremljen CSV — za multi‑store operacije i učinkovito usklađivanje.