ŠTUDIJA PRIMERA
RUN-TIGER
Amazon izvozi pretvorjeni v mesečne Minimax zbirne račune za računovodstvo in zalogo.
Povzetek
- Industrija: Globalni e-commerce (Amazon marketplace)
- Deliverable: Web app, ki iz Amazon exportov izdela Minimax “zbirni račun” (mesečni povzetek)
- Vloga: Arhitektura, implementacija, računovodsko mapiranje
- Integracijske točke: Amazon CSV izvozi (EU OSS / US / CA), Minimax OAuth2 + REST API (customers, items, issued invoices)
- Status: Produkcijsko interno orodje
Kontekst
RUN-TIGER prodaja po celem svetu preko Amazona. Za računovodstvo in vodenje zalog morajo biti prodaje in vračila v Minimaxu evidentirana v strukturirani in audit-friendly obliki. Amazon poročila so “surovi” izvozi in potrebujejo normalizacijo, agregacijo ter računovodsko logiko, preden jih lahko knjižimo kot ERP dokumente.
Problem
- Knjiženje enega računa na naročilo ni operativno izvedljivo pri Amazon obsegu.
- Računovodstvo zahteva mesečno agregacijo in ločevanje po državah/trgih.
- EU OSS zahteva striktno filtriranje in country-specific DDV logiko.
- Izvozi (US/CA) potrebujejo 0% DDV tretma ter ustrezne opise na dokumentih.
- Minimax potrebuje stabilne reference na kupce in artikle za determinističen vnos.
Cilji projekta
- Iz Amazon exportov ustvariti mesečne Minimax zbirne račune.
- Agregirati postavke po SKU (in shipping postavke kjer je relevantno).
- Vračila obravnavati ločeno z negativnimi količinami.
- Po potrebi ustvariti manjkajoče Minimax master podatke (kupci, placeholder artikli).
- Podpreti več formatov (EU OSS, US, CA) z lahkim workflowom.
Pregled rešitve
Implementirali smo upload-based aplikacijo, ki:
- Sprejme region-specifične Amazon CSV izvoze (EU/US/CA) prek minimalnega UI-ja.
- Normalizira in agregira vrstice po državi/trgu in SKU.
- Ustvari ali uporabi Minimax kupce po trgu (npr. `am_XX`).
- Poskrbi, da SKU obstaja kot Minimax artikel (placeholder za neznane SKU).
- V Minimax vnese izdane račune za pretekli mesec z ustreznimi tečaji in DDV logiko.
Arhitektura in tehnični pristop
Vhodi in parsing
- EU OSS export: filtrira na upravičeno shemo, izloči kupce z VAT številko, grupira po državi prihoda.
- US/CA exporti: parsirajo settlement-style vrstice in agregirajo prodaje/vračila po SKU.
Agregacijski model
- Prodaje in vračila se vodijo ločeno.
- SKU total se pretvori v eno Minimax postavko na SKU.
- Shipping se lahko mapira na namenski “shipping SKU”.
Minimax vnos
- Ustvari/uporabi kupce po trgu (`am_XX`).
- Prebere tečaj na datum konca obdobja in nastavi exchange rate na dokumentu.
- Vnese `InvoiceType = R` izdane račune z mesečnim oknom (`DateTransactionFrom` → `DateTransaction`).
- Uporabi DDV pravila po flowu (EU OSS vs izvozi) in nastavi skladišče za zalogo.
Tehnološki sklad
- PHP (upload UI, CSV parsing, agregacija)
- Minimax OAuth2 + REST API
- Composer dependency (PhpSpreadsheet na voljo)
- Osnovna zaščita dostopa prek `.htaccess` / `.htpasswd`
Rezultati in učinek
- Čisti mesečni dokumenti v Minimaxu namesto per-order šuma.
- Konsistenten zajem prodaj in vračil čez več regij.
- Hitrejši bookkeeping in bolj zanesljiv workflow zalog/računovodstva.
- Manjkajoč kupec/SKU ne blokira več procesa.
Povzetek
Orodje pretvori Amazon marketplace izvoze v mesečne Minimax zbirne račune, pri čemer obvlada regionalne formate, EU OSS filtriranje, tečaje/valute, DDV pravila in pripravo master podatkov — za globalno e-commerce računovodstvo in zalogo.