STUDIJA SLUČAJA
RUN-TIGER
Amazon izvozi pretvoreni u mjesečne Minimax zbirne račune za računovodstvo i zalihe.
Sažetak
- Industrija: Globalni e-commerce (Amazon marketplace)
- Deliverable: Web app koji iz Amazon exporta izrađuje Minimax “zbirni račun” (mjesečni sažetak)
- Uloga: Arhitektura, implementacija, računovodsko mapiranje
- Integracijske točke: Amazon CSV izvozi (EU OSS / US / CA), Minimax OAuth2 + REST API (customers, items, issued invoices)
- Status: Produkcijski interni alat
Kontekst
RUN-TIGER prodaje diljem svijeta putem Amazona. Za računovodstvo i vođenje zaliha prodaje i povrati moraju biti evidentirani u Minimaxu u strukturiranom, audit-friendly obliku. Amazon izvještaji su “sirovi” izvozi i zahtijevaju normalizaciju, agregaciju i računovodstvenu logiku prije nego ih možemo knjižiti kao ERP dokumente.
Problem
- Knjiženje jedne fakture po narudžbi nije operativno izvedivo na Amazonovom obujmu.
- Računovodstvo zahtijeva mjesečnu agregaciju i razdvajanje po državama/tržištima.
- EU OSS zahtijeva strogo filtriranje i country-specific logiku PDV-a.
- Izvozi (US/CA) zahtijevaju tretman PDV-a 0% te odgovarajuće opise na dokumentima.
- Minimax treba stabilne reference na kupce i artikle za determinističan unos.
Ciljevi projekta
- Iz Amazon exporta izraditi mjesečne Minimax zbirne račune.
- Agregirati stavke po SKU-u (i shipping stavke gdje je relevantno).
- Povrate obrađivati odvojeno s negativnim količinama.
- Po potrebi izraditi nedostajuće Minimax master podatke (kupci, placeholder artikli).
- Podržati više formata (EU OSS, US, CA) uz jednostavan workflow.
Pregled rješenja
Implementirali smo upload-based aplikaciju koja:
- Prima regionalno specifične Amazon CSV izvoze (EU/US/CA) kroz minimalan UI.
- Normalizira i agregira retke po državi/tržištu i SKU-u.
- Kreira ili primjenjuje Minimax kupce po tržištu (npr. `am_XX`).
- Pobrine se da SKU postoji kao Minimax artikl (placeholder za nepoznate SKU-ove).
- U Minimax unosi izdane račune za prethodni mjesec s odgovarajućim tečajevima i logikom PDV-a.
Arhitektura i tehnički pristup
Ulazi i parsing
- EU OSS export: filtrira na odgovarajuću shemu, izdvaja kupce s VAT brojem i grupira po državi odredišta.
- US/CA exporti: parsiraju settlement-style retke i agregiraju prodaje/povrate po SKU-u.
Agregacijski model
- Prodaje i povrati se vodijo ločeno.
- SKU total se pretvara u jednu Minimax stavku po SKU-u.
- Shipping se može mapirati na namjenski “shipping SKU”.
Minimax unos
- Ustvari/primijeni kupce po trgu (`am_XX`).
- Dohvaća tečaj na datum završetka razdoblja i postavlja exchange rate na dokumentu.
- Vnese `InvoiceType = R` izdane račune z mesečnim oknom (`DateTransactionFrom` → `DateTransaction`).
- Primjenjuje pravila PDV-a po flowu (EU OSS vs izvozi) i postavlja skladište za zalihe.
Tehnološki stack
- PHP (upload UI, CSV parsing, agregacija)
- Minimax OAuth2 + REST API
- Composer dependency (PhpSpreadsheet po potrebi)
- Osnovna zaštita pristupa preko `.htaccess` / `.htpasswd`
Rezultati i učinak
- Čisti mesečni dokumenti u Minimaxu namesto per-order šuma.
- Konzistentan obuhvat prodaja i povrata kroz više regija.
- Brže knjigovodstvo i pouzdaniji workflow zaliha/računovodstva.
- Nedostajući kupac/SKU više ne blokira proces.
Sažetak
Alat pretvara Amazon marketplace izvoze u mjesečne Minimax zbirne račune te pokriva regionalne formate, EU OSS filtriranje, tečajeve/valute, pravila PDV-a i pripremu master podataka — za globalno e-commerce računovodstvo i zalihe.