Dhaftar isi
1. Gambaran umum: platform lan kamatengan2. Alur sakilas3. Nggawé koneksi lan kredensial4. Pemetaan produk5. Pesenan: njupuk lan pesenan HNR6. Bungkus, kirim, ditampa7. Ngirim stok lan rega8. Retur9. Pencairan dana10. Log lan kasalahan11. Sinkronisasi otomatis12. Ing telpon (Taman + Langkah)13. Idin14. Nabız lan Dasbor Pemilik15. Durung ana ing vèrsi ikiPitulungan › Marketplace
Integrasi Marketplace — Pandhuan saka Nol
Perusahaan sing dodolan ing Trendyol, Hepsiburada, Tokopedia, utawa Shopee biyasané nyalin pesenan saka panel penjual kanthi manual, mbenerake stok siji-siji ing saben platform saben sore, lan ora ngerti kenapa dana sing dicairaké platform ing pungkasan sasi kurang. Jendhéla Marketplace nyambungaké gawéan iki menyang HNR: pesenan platform mlebu HNR minangka pesenan dodolan, informasi bungkusan lan kiriman dilaporaké manèh menyang platform, stok bebas lan rega ing HNR dikirim menyang platform, retur lan potongan platform dipantau, lan kira-kira pencairan dana kanggo periode iku diétung.
1. Gambaran umum: platform lan kamatengan
Ana papat platform sejatiné lan siji driver uji. Kanggo Turki Trendyol lan Hepsiburada, kanggo Indonésia Tokopedia lan Shopee; Simulasi ndadèkaké panjenengan bisa gladhen alur sing padha nganggo pesenan conto tanpa nyambung menyang marketplace sejatiné. Siji perusahaan bisa mbukak sawetara koneksi (malah loro toko ing platform sing padha).
| Platform | Sing kudu dijupuk saka platform | Kamatengan |
|---|---|---|
| Trendyol (TR) | Panel Penjual › Informasi Akun › Informasi Integrasi: Seller ID, API Key, API Secret. Kanggo uji, akun lingkungan stage (uji) saka tim integrasi Trendyol. | Siap |
| Hepsiburada (TR) | Merchant Portal › Integrasi › Informasi API: Merchant ID, jeneng pangguna API, kunci layanan (secret key), lan jeneng integrator (User-Agent). Kanggo uji, akun uji SIT saka tim integrasi Hepsiburada. | Siap |
| Tokopedia (ID) | Tokopedia Developer Console: fs_id (App ID), Client ID, Client Secret; toko kudu wis mènèhi idin (whitelist) marang aplikasi (Shop ID). | Siap |
| Shopee (ID) | Konsol Shopee Open Platform: Partner ID, Partner Key; sawisé otorisasi toko (shop authorization), Shop ID, access token, lan refresh token. | Siap |
| Simulasi (marketplace uji) | Ora ana: jeneng pangguna demo lan tembung sandhi apa waé. | Uji: ora nyambung menyang marketplace sejatiné. |
Apa tegesé "Siap"? Driver ditulis jangkep miturut dokumentasi API resmi platform lan diuji ing pangujian HNR dhéwé nglawan panyuwunan lan wangsulan ing dokumentasi iku; nanging durung diuji ing platform nganggo akun toko sejatiné. Gawéa koneksi sepisanan nganggo lingkungan uji platform (Trendyol stage, Hepsiburada SIT, Shopee test) banjur priksa. Panyuwunan jaringan metu menyang marketplace mung kedadéan sawisé kredensial sejatiné dilebokaké lan koneksi diuji utawa disinkronaké; Simulasi ora tau ngubungi alamat njaba.
Kredensial dienkripsi nganggo kunci sing padha (HNR_BANKA_KIMLIK_ANAHTARI) kaya koneksi bank langsung. Yèn kunci durung ditetepaké, pènget abang katon ing jendhéla lan ora ana platform sing bisa disambungaké; administrator sistem mènèhi kunci menyang pamiwiti Node.
2. Alur sakilas
- Koneksi — administrator sistem milih platform ing Setelan, nglebokaké kredensial, nemtokaké kontak platform lan interval, banjur nguji koneksi.
- Pemetaan produk — saben produk platform disambungaké menyang siji kertu stok (manual, CSV/XLSX, utawa saka saran barcode).
- Njupuk pesenan — pesenan anyar dijupuk; pesenan sing kabèh produké wis dipetakaké dicathet menyang HNR minangka pesenan dodolan seri PZ lan mesen stok.
- Bungkus → Kirim → Ditampa — saben langkah dilaporaké menyang platform; nomer resi asalé saka kiriman, saka platform, utawa diisi manual.
- Stok lan rega — stok bebas ing HNR dikirim menyang platform sawisé porsi platform lan penyangga ditrapaké; rega dikirim klebu PPN. Mung sing owah sing dikirim.
- Retur lan pencairan dana — retur platform mlebu lan nuduhaké gawéan sing kudu ditindakaké ing antrian kasalahan; tab Pencairan dana ngurangi komisi, potongan ongkos kirim, biaya layanan, lan retur saka dodolan kotor periode iku.
3. Nggawé koneksi lan kredensial
Koneksi ana ing Setelan › Informasi Perusahaan › Koneksi marketplace lan mung bisa dideleng sarta diatur déning administrator sistem (pangguna sing duwé idin marketplace uga ora bisa mbukak layar koneksi lan kredensial). Kanggo koneksi anyar pencèten Koneksi anyar; formulire ana telung langkah.
- Marketplace — pilihen platform. Kothak nuduhaké judhul dokumèn platform, cathetan kamatengan, lan dhaptar Sing kudu dijupuk saka platform; kumpulna datané saka panel penjual dhisik.
- Kredensial lan setelan — jeneng koneksi, kontak platform, gudhang, kolom platform, interval; banjur Simpen.
- Uji — Uji koneksi: HNR nyoba nyambung menyang platform nganggo kredensial. Yèn kasil katon "Uji koneksi kasil" lan status dadi Lagi mlaku; yèn ora, kelas kasalahan dituduhaké.
Kolom sing dijaluk saben platform (sing ditandhani lintang wajib; 🔒 = kolom kredensial rahasia). Jeneng kolom katon ing layar nganggo label driver iku dhéwé:
- Trendyol: Satıcı ID* (ID penjual), Ortam (lingkungan: canli = langsung / test), Kendi kargo anlaşması (kontrak ekspedisi dhéwé: hayir = ora / evet = iya — yèn iya, nomer resi dikirim saka HNR menyang Trendyol), API Key* 🔒, API Secret* 🔒.
- Hepsiburada: Merchant ID*, Entegratör adı (User-Agent) (jeneng integrator), Ortam (lingkungan), Kendi kargo anlaşması (kontrak ekspedisi dhéwé), API kullanıcı adı* 🔒 (jeneng pangguna API), Servis anahtarı* 🔒 (kunci layanan).
- Tokopedia: fs_id (App ID)*, Shop ID*, Tahmini komisyon oranı (%) (kira-kira tarif komisi — dhaptar pesenan Tokopedia ora ngemot komisi, mula kira-kira pencairan dana nganggo tarif iki), Client ID* 🔒, Client Secret* 🔒.
- Shopee: Partner ID*, Shop ID*, Ortam (lingkungan), Kargoya teslim (serah menyang ekspedisi — dropoff: paket diterké menyang cabang · pickup: kurir njupuk), Partner Key* 🔒, Access token* 🔒, Refresh token 🔒.
- Simulasi: Tohum (seed — seed sing padha ngasilaké pesenan sing padha), Ürünler* (produk, siji saben baris:
kode produk platform|rega|jeneng), Günlük sipariş sayısı (pesenan saben dina), Komisyon oranı (%) (tarif komisi), Kargodan teslime (dk) (menit saka dikirim nganti ditampa), İade edilecek sipariş numaraları (nomer pesenan sing diretur), Platformda iptal edilecek sipariş numaraları (nomer pesenan sing dibatalaké ing platform), Para birimi (mata uang), Kullanıcı adı* 🔒 (demo), Parola* 🔒 (tembung sandhi).
Kredensial ora tau dituduhaké manèh. Kolom rahasia (🔒) disimpen kanthi enkripsi lan ora tau ditulis ing layar, wangsulan server, log, utawa pesen kasalahan — administrator sistem uga ora bisa ndeleng manèh. Kolom sing wis disimpen nuduhaké wis disimpen (ketik kanggo ngowahi): jarna kosong kanggo njaga nilai lawas, ketik kanggo ngowahi kolom iku waé. Yèn kunci enkripsi owah, kertu nuduhaké "Kunci enkripsi wis owah. Lebokna manèh kredensial."
Kolom umum padha ing saben platform:
| Kolom | Fungsiné |
|---|---|
| Jeneng koneksi | Jeneng sing katon ing dhaptar lan pesen (contoné "Toko Shopee 1"). 1-80 karakter. |
| Kontak platform (pesenan dicathet menyang kontak iki) | Ing praktiké wajib. Kabèh pesenan HNR saka koneksi iku dicathet menyang kertu kontak iki; yèn ora dipilih, pesenan tetep mlebu nanging ora dicathet menyang HNR (kode kasalahan CARI_YOK). Saran: gawéa kertu kontak kapisah kanggo saben platform (contoné "Shopee"); piutang pencairan dana platform nglumpuk ing kontak iku. |
| Gudhang (kosong = stok sakabèhé perusahaan) | Yèn diisi, stok gudhang iku sing dikirim menyang platform lan baris pesenan HNR dicathet menyang gudhang iku. Yèn kosong, stok sakabèhé perusahaan sing dienggo. |
| Interval njupuk pesenan (mnt) · Interval ngirim stok (mnt) | Sepira kerepé sinkronisasi otomatis njupuk pesenan (lan retur) (gawan 5, paling sithik 5, paling akèh 120 menit) lan ngirim stok/rega (gawan 15, 5-1440 menit). |
| Mundur dina nalika njupuk sepisanan | Pira dina mundur nalika njupuk sepisanan (gawan 3, 0-30). Njupuk sabanjuré diwiwiti sedina sadurungé njupuk sing kasil pungkasan (tumpang tindih nyegah ana sing kliwat); siji jendhéla njupuk paling suwé 14 dina. |
| Rega platform klebu PPN | Urip kanthi gawan. PPN dipisahaké saka rega pesenan sing mlebu lan ditambahaké ing rega sing metu (delengen §7). |
| Sinkronisasi otomatis (yèn tugas server urip) | Apa koneksi iki mèlu sinkronisasi otomatis? Yèn tugas server mati, sinkronisasi mung manual senajan dicenthang (delengen §11). |
Status kertu koneksi: Ngenteni uji (wis disimpen, durung diuji utawa setelan owah), Lagi mlaku (uji utawa sinkronisasi pungkasan kasil), Kasalahan. Koneksi sing duwé pesenan ora bisa dibusak lan marketplace-é ora bisa diowahi — patènana (patèni sinkronisasi otomatis) utawa gawéa koneksi anyar. Mbusak koneksi tanpa pesenan uga mbusak kredensial sing disimpen lan pemetaan produké.
Gawéa dhisik koneksi gladhen nganggo Simulasi: ketik barcode kertu stok panjenengan dhéwé ing kothak Ürünler kanthi format barcode|rega|jeneng, simpen nganggo jeneng pangguna demo, uji, banjur pencèten Sinkronaké saiki. Panjenengan ndeleng kabèh alur (pemetaan, pesenan HNR, bungkus, kirim, ngirim stok, retur, pencairan dana) tanpa nyenggol toko sejatiné. Tembung sandhi yanlis nggladhi kasalahan kredensial lan gecici kasalahan layanan sauntara.
4. Pemetaan produk
Platform ngenali produk nganggo kodhé dhéwé; HNR nganggo kertu stok. Tab Pemetaan produk nyambungaké loro-loroné. Kunci pemetaan yaiku kode produk platform + varian; yèn baris pesenan ngemot barcode, pemetaan uga ditemokaké liwat barcode. Yèn siji baris waé durung dipetakaké, pesenan mlebu nanging ora dicathet menyang HNR (ESLEME_YOK); sawisé nambah pemetaan, pencèten Cathet manèh menyang HNR ing pesenan.
- Manual — ing baris dhuwur isi Kartu stok, Kode produk platform / barcode, Varian, Porsi stok %, Penyangga, Rega tetep banjur pencèten Petakaké. Yèn produk platform wis dipetakaké, pemetaané dianyari.
- Produk platform sing durung dipetakaké sing katon ing pesenan — produk tanpa pemetaan ing pesenan sing mlebu kadhaptar ing kothak kuning karo cacahé; klik salah siji kanggo nggawa kodhé menyang formulir, banjur cukup pilih kertu stok.
- Saran saka barcode — nuduhaké kertu stok sing duwé barcode sing durung dipetakaké minangka saran (barcode format GTIN 8/12/13/14 digit dhisik; kertu biaya, jasa, lan tenaga kerja ora mèlu). Trendyol lan Simulasi ngenali produk saka barcode, mula saran bisa langsung dienggo. Hepsiburada, Tokopedia, lan Shopee ngenali produk nganggo ID dhéwé: saran saka barcode mung pasti kanggo produk sing wis katon ing pesenan; kanggo liyané panjenengan ngisi kode produk platform.
- Impor CSV / XLSX — berkas sing baris kapisané judhul kolom:
stok,urun(utawabarkod),varyant,sku,fiyat,pay,tampon. Pratinjau katon dhisik: "Pratinjau impor: … anyar, … arep dianyari, … baris salah" karo nomer baris sing salah; Trapake nyathet, Batal mbatalaké. Paling akèh 5.000 baris saben berkas; produk platform sing padha ora kena ana kaping pindho; baris sing kertu stoké ora ditemokaké diliwati.
Porsi stok % yaiku persentase stok bebas sing dibukak kanggo platform iki (gawan 100). Penyangga yaiku cacah pengaman sing dikurangi sawisé porsi (gawan 0) — supaya sawetara barang pungkasan ora kedol ing rong platform bebarengan. Yèn Rega tetep diisi, rega iku dikirim menyang platform apa anané. Tinimbang mbusak pemetaan, panjenengan bisa Nonaktifaké: stok lan regané ora dikirim manèh, nanging pesenan lawas tetep wutuh.
5. Pesenan: njupuk lan pesenan HNR
Ing sisih dhuwur tab Pesenan ana papat kothak: Ngenteni dibungkus, Arep dikirim, Lagi dikirim, Antrian kasalahan; ngeklik kothak nyaring dhaptar menyang status iku. Saringan platform lan status, kothak "Golèk no. pesenan, pelanggan, utawa no. HNR", lan kolom (Tanggal, Platform, No. pesenan, Pelanggan, Produk, Jumlah, Status, Pesenan HNR) ana ing kéné. Klik baris kanggo mbukak kertu pesenan.
Njupuk ora tau dobel. Pesenan dikenali saka nomer platform lan nomer pakeé; yèn pesenan sing padha teka manèh, ora ana cathetan anyar sing digawé, mung status, nomer resi, lan potongané sing dianyari. Pesenan marketplace ora tau dibusak saka HNR; pembatalan uga sawijining status lan riwayat tetep disimpen.
Pesenan HNR. Pesenan anyar sing kabèh produké wis dipetakaké lan koneksiné duwé kontak platform dicathet menyang HNR minangka pesenan dodolan: kontak = kontak platform, seri dokumèn PZ (contoné PZ2026000001, saluran "pazaryeri"; nomer diwènèhaké sepisan lan ora dienggo manèh), katrangan "Tokopedia siparişi 123456 … [PZ#…]", tanggal kirim = wates kirim platform, jeneng pelanggan pungkasan ing kolom Up. (kanggo). Rega baris yaiku rega dodolan platform; amarga klebu PPN, dicathet menyang HNR minangka rega = kotor ÷ (1 + PPN/100). Yèn nyathet kepedhot, pesenan ditemokaké manèh liwat tandha ing katrangan; pesenan sing padha ora tau dicathet kaping pindho. Konfirmasi platform: ing Tokopedia pesenan dikonfirmasi ing platform sawisé dicathet menyang HNR; ing platform liya langkah bungkus iku konfirmasiné.
Kenapa gerbang limit kredit lan mesin rega ora ditrapaké? Pesenan marketplace wis kedol ing platform lan pambayarané dijamin platform; yèn HNR nolak amarga "limit kliwat", wates wektu kiriman platform (SLA) kliwat lan rating toko panjenengan mudhun. Mula gerbang limit kredit ora ditrapaké ing pesenan iki; utang platform marang panjenengan dipantau ing tab Pencairan dana. Senadyan mangkono, menawa kontak diblokir utawa ngluwihi limit, utawa rega platform ing sangisoré wates ngisor daftar rega, pesenan tetep dicathet nanging diwènèhi pènget (kothak kuning ing rincian pesenan, baris perhatian ing Nabız; rega ing sangisoré wates uga mlebu persetujuan). Regané uga rega sing dibayar pelanggan ing platform; mesin rega ora ngowahi rega pesenan (informasi diskon tetep ing cathetan marketplace). Mesin rega mung dienggo kanggo rega sing dikirim menyang platform (§7).
Data pelanggan pungkasan. Jeneng, e-mail, telpon, nomer identitas/pajeg (TCKN/VKN, NIK/NPWP), kantor pajeg, alamat faktur lan alamat pangiriman panuku disimpen ing cathetan marketplace (kontak pesenan HNR yaiku kontak platform; data pelanggan pungkasan kanggo faktur e-Arsip). Ing dhaptar lan kertu, nomer identitas disamaraké (contoné *******1234), e-mail a***@…, telpon mung patang digit pungkasan; alamat didhelikaké. Nilai jangkep mung katon déning pangguna sing duwé idin ngatur marketplace, lan saben tampilan dicathet ing jejak audit.
Mesin status. Pesenan mung maju: Anyar → Disarujuki → Wis dibungkus → Lagi dikirim → Ditampa. Batal kedadéan sadurungé ditampa; Retur sawisé dikirim utawa ditampa. Langkah mundur saka platform (kaca telat utawa lawas) ora digatèkaké; pembatalan lan retur tansah ditrapaké. Yèn pindhah sing ora diidini dicoba saka HNR, katon pènget "Pesenan ora bisa pindhah saka status … menyang …."
Kolom Pesenan HNR nuduhaké kahanan pasangané: Durung dicathet menyang HNR, Lagi dicathet menyang HNR, Pesenan HNR mbukak, Wis difakturaké (otomatis sawisé pesenan difakturaké ing HNR), Pesenan HNR dibusak. Rong pènget dudu kasalahan, nanging pantes dideleng: "Stok bebas kurang, pesenan dadi backorder: …" (pesenan tetep dicathet) lan "Pesenan wis dikirim sadurungé integrasi. Pesenan HNR ora dicathet (bisa dicathet nganggo coba manèh)." (pesenan lawas sing dikirim sadurungé koneksi digawé ora dicathet otomatis).
6. Bungkus, kirim, ditampa
Tombol ing kertu pesenan nindakaké langkah sabanjuré lan lapor menyang platform dhisik, banjur nyathet status; yèn platform nolak, status ora owah lan kasalahané dituduhaké. Ing dhaptar, tombol Bungkus / Kirim ing baris nindakaké bab sing padha.
- Bungkus — "lagi disiapaké/dibungkus" dilaporaké menyang platform (Trendyol Picking/Invoiced; ing Hepsiburada paket digawé lan nomeré dicathet ing pesenan). Status Wis dibungkus.
- Kirim — kothak Nomer resi lan Ekspedisi sipaté pilihan. Yèn kosong, nomer resi dhisik diwaca saka Pangiriman (yèn pesenan HNR utawa fakturé ana ing sawijining pangiriman, nomer resi lan ekspedisi pangiriman iku), lan yèn ora ana, asalé saka ekspedisi mitra platform. Ing Trendyol lan Hepsiburada, yèn Kendi kargo anlaşması = evet (kontrak ekspedisi dhéwé = iya), nomer resi dikirim saka HNR menyang platform; ing Shopee dienggo setelan dropoff/pickup. Status Lagi dikirim.
- Ditampa — biyasané dilaporaké platform. Yèn panjenengan ngirim nganggo ekspedisi dhéwé, pesenan otomatis dadi Ditampa sawisé bukti serah tampa (POD) dijupuk ing Pangiriman; yèn perlu, tandhanana manual nganggo tombol Ditampa ing kertu.
- Batalaké — mbatalaké pesenan ing platform; ora bisa dibalèkaké lan njaluk konfirmasi. Yèn pesenan HNR mbukak, "Batal ing platform, pesenan HNR mbukak" mlebu antrian kasalahan: tutupen nganggo Busak pesenan HNR ing kertu (nganggo idin busak pesenan HNR panjenengan dhéwé).
Ing sisih ngisor kertu pesenan ana bagéan Retur lan Riwayat owah-owahan: saben owah-owahan status dicathet karo sapa sing nindakaké (utawa "sistem") lan sumberé (manual, platform, POD pangiriman).
7. Ngirim stok lan rega
Stok sing dikirim diétung mangkéné (aturan sing padha karo ATP):
bebas = stok − ora bisa dienggo (gudhang karantina / subkontrak / nonaktif) − turahan pesenan dodolan sing mbukak (dipesen)
dikirim = paling sithik 0, bunderaké mudhun(bebas × porsi stok / 100) − penyangga
Conto: stok 120, 10 ing karantina, 30 ing pesenan mbukak → bebas 80; porsi 50% → 40; penyangga 5 → 35 dikirim menyang platform.
Nalika pesenan marketplace dicathet menyang HNR, pesenan iku dadi pesenan dodolan sing mbukak lan dikurangi minangka pesenan; ing platform uga wis suda — ora diétung kaping pindho. Sawetara platform saben-saben njupuk porsiné saka stok bebas sing padha; gunggung porsi kena luwih saka 100 (keputusan sadhar pangurus: saben platform ndeleng barang sing padha, sing ngedol dhisik sing éntuk).
Rega digolèki kanthi urutan iki: Rega tetep ing pemetaan (dikirim apa anané) → dhaptar rega sing gegandhèngan karo pemetaan → mesin rega (kontak = kontak platform, saluran Marketplace (e-commerce), tanpa kampanye — kampanye platform diatur ing platform) → rega 1 kertu stok. Rega mesin lan kertu durung klebu PPN; yèn Rega platform klebu PPN urip, sing dikirim neto × (1 + PPN/100). Kolom Sumber rega ing tabel nuduhaké endi sing dienggo.
Tab Stok lan rega nuduhaké, kanggo saben pemetaan, kolom Stok, Reservasi, Bebas, Porsi / penyangga, Stok HNR, Stok platform, Rega HNR, Rega platform, lan Sumber rega; baris sing béda disorot. Nilai platform biyasané nilai pungkasan dikirim; yèn Takon nilai saiki ing platform dicenthang, nilai diwaca saka platform (saiki Trendyol lan Simulasi ndhukung; kanggo liyané dituduhaké nilai pungkasan dikirim). Kirim sing owah mung ngirim sing béda saka nilai pungkasan; Kirim manèh kabèh meksa kabèh. Asilé diringkes dadi "… produk dikirim, … diliwati amarga ora owah, … gagal."; alesan baris sing gagal katon ing pemetaan lan ing antrian kasalahan.
8. Retur
Retur platform dijupuk bebarengan karo pesenan (ndeleng mundur paling sithik 14 dina); nomer retur sing padha diolah sepisan. Nalika retur teka, pesenan dadi Retur, cacah retur katon ing baris lan nilai retur ing pesenan, sarta nomer retur platform, alesan, lan nilainé dicathet ing bagéan Retur ing kertu.
Ing HNR faktur retur dodolan ora digawé otomatis. Yèn pesenan wis difakturaké, ing antrian kasalahan katon "Ngenteni faktur retur" — gawéa faktur retur saka input dokumèn kaya biyasané. Yèn durung difakturaké, katon "Retur ing platform, pesenan HNR mbukak" — tutupen pesenan mbukak iku nganggo Busak pesenan HNR ing kertu. Nilai retur dikurangi saka pencairan dana.
9. Pencairan dana
Tab Pencairan dana nuduhaké siji baris saben koneksi kanggo periode sing dipilih (gawan sasi iki); pesenan sing dibatalaké ora diétung:
kira-kira pencairan dana = dodolan kotor − komisi − potongan ongkos kirim − biaya layanan − retur
Dodolan kotor yaiku jumlah klebu PPN sing dibayar pelanggan. Komisi asalé saka tarif komisi baris ing Trendyol, saka rincian pambayaran (escrow) platform ing Shopee, saka Tahmini komisyon oranı (kira-kira tarif komisi) koneksi ing Tokopedia, lan saka tarif ing setelan ing Simulasi; katon saben baris lan saben pesenan ing kertu pesenan.
Ora ana jurnal komisi otomatis. Platform nagih komisi lan biaya layanan nganggo fakturé dhéwé (e-Fatura saben sasi saka Trendyol lan Hepsiburada, faktur saka Shopee lan Tokopedia). Faktur iku dicathet ing HNR minangka faktur tuku, lan akuntansi mbukokaké bebané saka kono. Tabel pencairan dana mung kanggo rekonsiliasi: bandhingaké dana sing dicairaké platform lan faktur sing diterbitaké karo baris iki. Kanthi mangkono beban sing padha ora tau dibukokaké kaping pindho.
Tab Pencairan dana mung katon déning pangguna sing duwé idin ngatur marketplace; liyané ndeleng "Pencairan dana mbutuhaké idin ngatur marketplace."
10. Log lan kasalahan
Ing sisih dhuwur tab Log lan kasalahan ana antrian kasalahan: pesenan sing nggawa kode kasalahan, pemetaan sing gagal dikirim, lan koneksi sing statusé kasalahan ("… kasalahan urut-urutan"). Ing ngisoré, saben koneksi, Njupuk pesenan pungkasan, Ngirim stok pungkasan, lan apa sinkronisasi otomatis urip; paling ngisor tabel log (Wektu, Koneksi, Tumindak, Status, Ditampa, Anyar, Dianyari, Dikirim, Dhobel, Pesen). Yèn antrian kosong katulis "Antrian kasalahan kosong."
| Kode | Ing layar | Sing kudu ditindakaké |
|---|---|---|
ESLEME_YOK | Ana produk sing durung dipetakaké | Petakaké produk sing kurang ing tab Pemetaan produk, banjur pencèten Cathet manèh menyang HNR ing pesenan. |
CARI_YOK | Kontak platform durung dipilih | Administrator sistem milih kontak platform ing koneksi; banjur Cathet manèh menyang HNR. |
HNR_YAZILAMADI | Pesenan HNR ora bisa dicathet | Atasi alesan sing katulis ing kertu (contoné kertu stok kebusak, seri dokumèn ora ana, nulis HNR ditutup), banjur Cathet manèh menyang HNR. |
HNR_ACIK_IPTAL | Batal ing platform, pesenan HNR mbukak | Pencèten Busak pesenan HNR ing kertu (stok sing dipesen diculaké). |
HNR_ACIK_IADE | Retur ing platform, pesenan HNR mbukak | Pesenan sing durung difakturaké diretur: pencèten Busak pesenan HNR ing kertu. |
IADE_FATURASI | Ngenteni faktur retur | Pesenan sing wis difakturaké diretur: gawéa faktur retur dodolan saka input dokumèn. |
HNR_SILINDI | Pesenan HNR wis kebusak | Pesenan HNR dibusak saka panggonan liya, dudu saka jendhéla marketplace; pesenan marketplace ora duwé pasangan ing HNR. Yèn disengaja, jarna; yèn ora, priksa status ing platform. |
Cathet manèh menyang HNR mung katon ing pesenan tanpa pasangan HNR lan uga nyathet pesenan sing wis dikirim sadurungé integrasi; pesenan sing dibatalaké ora dicathet menyang HNR. Kasalahan tingkat koneksi dituduhaké miturut kelasé: Kredensial ditolak, Layanan utawa idin durung aktif ing akun iki, Setelan koneksi durung jangkep (kanggo telu iki coba otomatis mandheg lan administrator sistem kudu ndandani sababé), Kasalahan jaringan utawa wektuné entèk, Layanan marketplace sauntara ora nanggapi, Marketplace mbalèkaké data sing ora dinyana (kanggo iki interval coba otomatis dadi kaping pindho saben kasalahan, paling suwé 6 jam).
11. Sinkronisasi otomatis
Sinkronisasi otomatis mati kanthi gawan (HNR ora ngubungi platform dhéwé). Kanggo nguripaké, administrator sistem nulis PAZARYERI_GOREV=1 ing berkas .env server banjur miwiti manèh layanan Node. Sauntara mati, jendhéla nuduhaké "Sinkronisasi otomatis mati (setelan server PAZARYERI_GOREV). Sinkronisasi ditindakaké kanthi manual." lan kabèh mlaku liwat Sinkronaké saiki.
- Tugas mriksa saben menit; saben koneksi njupuk pesenan lan retur ing Interval njupuk pesenan-é dhéwé lan ngirim stok sarta rega ing Interval ngirim stok-é. Mung koneksi sing Sinkronisasi otomatis-é dicenthang lan kredensialé disimpen sing mèlu.
- Perusahaan utama server (
HNR_FIRMA) dipindai déning penjadwal; kanggo iku pangguna layanan sing duwé idin nulis (HNR_B2B_KULLANICI) kudu ditetepaké ing.env. Perusahaan liya disinkronaké ing latar mburi nganggo sesi pangguna iku dhéwé nalika pangguna sing duwé idin nulis mbukak jendhéla Marketplace utawa Nabız. Perusahaan sing mèlu bisa diwatesi nganggoPAZARYERI_FIRMALAR(utawaHNR_FIRMALAR). - Nalika tugas nampa pesenan anyar, administrator sing nggawé koneksi nampa pesen "…: … pesenan marketplace anyar ditampa."; yèn koneksi gagal kaping telu urut-urutan, pènget "Koneksi marketplace … ngalami kasalahan: …" dikirim sepisan.
Sinkronaké saiki (ing sisih dhuwur jendhéla, karo pamilih koneksi) langsung nglakokaké sinkronisasi pesenan, retur, lan stok/rega ing koneksi sing dipilih, tugasé urip utawa ora, banjur nuduhaké "Sinkronisasi rampung: … pesenan anyar, stok lan rega … produk dikirim." Koneksi sing padha ora tau disinkronaké kaping pindho bebarengan ("Koneksi iki lagi disinkronaké. Coba manèh sedhela manèh.").
12. Ing telpon (Taman + Langkah)
Ing layar luwih cilik saka 7 inci, jendhéla Marketplace disederhanakaké kanggo petugas gudhang: ing dhuwur tab Arep dibungkus, Arep dikirim, lan Gagal karo cacahé, kothak "Golèk no. pesenan utawa pelanggan", lan tombol Jupuk pesenan anyar; ing ngisoré kertu pesenan kanthi area sentuh gedhé (pelanggan, kutha/kecamatan, jumlah, wates kirim).
- Pesenan — baris, pelanggan pungkasan, lan informasi pangiriman.
- Bungkus — laporan dibungkus kanthi sepisan demok.
- Kirim — ketik nomer resi utawa jarna kosong (dijupuk saka kiriman utawa platform) banjur kirim.
Administrator sistem uga bisa nggawé koneksi saka telpon: formulir ing Setelan ana telung langkah ing telpon (Marketplace · Kredensial lan setelan · Uji). Delengen pandhuan Sélulèr kanggo rinciané.
13. Idin
Ing Setelan › Pangguna, grup Marketplace duwé rong idin: Pesenan marketplace: sinkronaké, bungkus, kirim, batalaké, kirim stok lan rega (cekaké pazaryeri) lan Pemetaan produk, pencairan dana, lan identitas jangkep pelanggan pungkasan (pazaryeri_yonet; klebu sing kapisan). Aturané ditrapaké ing server.
| Gawéan | Idin sing dibutuhaké |
|---|---|
| Ndeleng pesenan, pemetaan, bédané stok lan rega, sarta log; sinkronaké saiki; bungkus, kirim, ditampa, batalaké; cathet manèh menyang HNR; kirim stok lan rega | pazaryeri |
| Nambah, ngowahi, mbusak pemetaan, impor CSV/XLSX; tab Pencairan dana; identitas jangkep, e-mail, telpon, lan alamat pelanggan pungkasan; data panuku e-Arsip | pazaryeri_yonet |
| Nambah, ngowahi, mbusak, nguji koneksi; nglebokaké kredensial | Mung administrator sistem |
| Busak pesenan HNR (ing pesenan sing dibatalaké utawa diretur ing platform) | pazaryeri + idin busak pesenan duwèké pangguna dhéwé |
Pangguna mung-maca ora bisa ngowahi cathetan marketplace; yèn gerbang nulis HNR ditutup, ora ana operasi nulis sing ditindakaké. Koneksi, pemetaan, tampilan identitas, lan saben tumindak manual dicathet ing jejak audit server (sapa, kapan, apa).
14. Nabız lan Dasbor Pemilik
Ing layar utama Nabız ing telpon, salah siji saka rong baris katon ing dhaptar Sabanjuré: "… pesenan marketplace anyar ngenteni dibungkus." utawa "Ana … cathetan ing antrian kasalahan marketplace."; nyenggol baris mbukak jendhéla Marketplace ing tab sing gegayutan. Kothak omzet Dasbor Pemilik nuduhaké cathetan sikil "Marketplace: omzet … (klebu PPN) saka … pesenan, komisi lan potongan platform …."; ngeklik iku mbukak tab Pencairan dana.
15. Durung ana ing vèrsi iki
Nggawé produk anyar ing platform (listing, gambar, deskripsi — saiki mung stok lan rega produk sing wis ana sing dikirim), nggawé faktur retur dodolan otomatis saka retur, nerusaké identitas pelanggan pungkasan menyang faktur e-Arsip kanthi otomatis (datané wis siap lan titik sambungé wis cumepak), milih dhaptar rega ing layar pemetaan, ngatur kampanye lan kupon platform, sarta ngimpor faktur platform kanthi otomatis direncanakaké minangka gawéan kapisah.
Pandhuan gegayutan: Pangiriman lan Logistik · Rega lan Kampanye · Koneksi bank langsung · Setelan · Sélulèr · Kabèh modul.