Daptar eusi

1. Gambaran umum: platform sareng kamatangan 2. Alur sakilas 3. Ngadamel koneksi sareng kredensial 4. Pemetaan produk 5. Pesenan: nyandak sareng pesenan HNR 6. Bungkus, kirim, katampi 7. Ngirim stok sareng harga 8. Retur 9. Pencairan dana 10. Log sareng kasalahan 11. Sinkronisasi otomatis 12. Dina telepon (Taman + Léngkah)13. Idin 14. Nabız sareng Dasbor Pamilik 15. Teu acan aya dina vérsi ieu

Bantosan › Marketplace

Integrasi Marketplace — Panduan ti Nol

Perusahaan anu jualan di Trendyol, Hepsiburada, Tokopedia, atanapi Shopee biasana nyalin pesenan tina panel penjual sacara manual, ngabenerkeun stok hiji-hiji di unggal platform unggal sonten, sareng teu terang naha dana anu dicairkeun platform di ahir bulan kirang. Jandéla Marketplace nyambungkeun padamelan ieu ka HNR: pesenan platform lebet ka HNR salaku pesenan penjualan, inpormasi bungkusan sareng kiriman dilaporkeun deui ka platform, stok bébas sareng harga di HNR dikirim ka platform, retur sareng potongan platform dipantau, sareng perkiraan pencairan dana pikeun periode éta diitung.

1. Gambaran umum: platform sareng kamatangan

Aya opat platform saleresna sareng hiji driver uji. Pikeun Turki Trendyol sareng Hepsiburada, pikeun Indonésia Tokopedia sareng Shopee; Simulasi ngamungkinkeun anjeun latihan alur anu sami ku pesenan conto tanpa nyambung ka marketplace saleresna. Hiji perusahaan tiasa muka sababaraha koneksi (sanajan dua toko dina platform anu sami).

Platform	Anu kedah dicandak ti platform	Kamatangan
Trendyol (TR)	Panel Penjual › Inpormasi Akun › Inpormasi Integrasi: Seller ID, API Key, API Secret. Pikeun uji, akun lingkungan stage (uji) ti tim integrasi Trendyol.	Siap
Hepsiburada (TR)	Merchant Portal › Integrasi › Inpormasi API: Merchant ID, nami pangguna API, konci layanan (secret key), sareng nami integrator (User-Agent). Pikeun uji, akun uji SIT ti tim integrasi Hepsiburada.	Siap
Tokopedia (ID)	Tokopedia Developer Console: fs_id (App ID), Client ID, Client Secret; toko kedah parantos masihan idin (whitelist) ka aplikasi (Shop ID).	Siap
Shopee (ID)	Konsol Shopee Open Platform: Partner ID, Partner Key; sanggeus otorisasi toko (shop authorization), Shop ID, access token, sareng refresh token.	Siap
Simulasi (marketplace uji)	Teu aya: nami pangguna `demo` sareng kecap konci naon waé.	Uji: teu nyambung ka marketplace saleresna.

Naon hartosna "Siap"? Driver ditulis lengkep numutkeun dokuméntasi API resmi platform sareng diuji dina pangujian HNR nyalira ngalawan pamundut sareng réspon dina dokuméntasi éta; nanging teu acan diuji di platform ku akun toko saleresna. Damel koneksi munggaran ku lingkungan uji platform (Trendyol stage, Hepsiburada SIT, Shopee test) teras pariksa. Pamundut jaringan kaluar ka marketplace ngan kajadian sanggeus kredensial saleresna dilebetkeun sareng koneksi diuji atanapi disinkronkeun; Simulasi henteu kantos ngahubungi alamat luar.

Kredensial diénkripsi ku konci anu sami (HNR_BANKA_KIMLIK_ANAHTARI) sapertos koneksi bank langsung. Upami koncina teu acan ditetepkeun, peringatan beureum nembongan dina jandéla sareng teu aya platform anu tiasa disambungkeun; administrator sistem masihan koncina ka panggerak Node.

2. Alur sakilas

Koneksi — administrator sistem milih platform dina Pangaturan, ngalebetkeun kredensial, nangtukeun kontak platform sareng interval, teras nguji koneksi.
Pemetaan produk — unggal produk platform disambungkeun ka hiji kartu stok (manual, CSV/XLSX, atanapi tina saran barcode).
Nyandak pesenan — pesenan énggal dicandak; pesenan anu sadaya produkna parantos dipetakeun dicatet ka HNR salaku pesenan penjualan séri PZ sareng mesen stok.
Bungkus → Kirim → Katampi — unggal léngkah dilaporkeun ka platform; nomer resi asalna tina kiriman, tina platform, atanapi dieusian manual.
Stok sareng harga — stok bébas di HNR dikirim ka platform sanggeus porsi platform sareng panyangga dilarapkeun; harga dikirim kalebet PPN. Ngan anu robih anu dikirim.
Retur sareng pencairan dana — retur platform lebet sareng nunjukkeun padamelan anu kedah dilakukeun dina antrian kasalahan; tab Pencairan dana ngirangan komisi, potongan ongkos kirim, biaya layanan, sareng retur tina jualan kotor periode éta.

3. Ngadamel koneksi sareng kredensial

Koneksi aya dina Pangaturan › Informasi Perusahaan › Koneksi marketplace sareng ngan tiasa ditingali sarta dikokolakeun ku administrator sistem (pangguna anu gaduh idin marketplace ogé teu tiasa muka layar koneksi sareng kredensial). Pikeun koneksi énggal pencét Koneksi énggal; formulirna aya tilu léngkah.

Marketplace — pilih platform. Kotak némbongkeun judul dokumén platform, catetan kamatangan, sareng daptar Anu kedah dicandak ti platform; kumpulkeun datana tina panel penjual heula.
Kredensial sareng pangaturan — nami koneksi, kontak platform, gudang, kolom platform, interval; teras Simpen.
Uji — Uji koneksi: HNR nyobian nyambung ka platform ku kredensial. Upami hasil nembongan "Uji koneksi hasil" sareng status janten Nuju jalan; upami henteu, kelas kasalahan ditémbongkeun.

Kolom anu dipénta per platform (anu dibéntangan wajib; 🔒 = kolom kredensial rusiah). Nami kolom nembongan dina layar ku labél driver éta nyalira:

Trendyol: Satıcı ID* (ID penjual), Ortam (lingkungan: canli = langsung / test), Kendi kargo anlaşması (kontrak ékspédisi nyalira: hayir = henteu / evet = enya — upami enya, nomer resi dikirim ti HNR ka Trendyol), API Key* 🔒, API Secret* 🔒.
Hepsiburada: Merchant ID*, Entegratör adı (User-Agent) (nami integrator), Ortam (lingkungan), Kendi kargo anlaşması (kontrak ékspédisi nyalira), API kullanıcı adı* 🔒 (nami pangguna API), Servis anahtarı* 🔒 (konci layanan).
Tokopedia: fs_id (App ID)*, Shop ID*, Tahmini komisyon oranı (%) (perkiraan tarif komisi — daptar pesenan Tokopedia teu ngamuat komisi, janten perkiraan pencairan dana nganggo tarif ieu), Client ID* 🔒, Client Secret* 🔒.
Shopee: Partner ID*, Shop ID*, Ortam (lingkungan), Kargoya teslim (serah ka ékspédisi — dropoff: pakét dianteurkeun ka cabang · pickup: kurir ngajemput), Partner Key* 🔒, Access token* 🔒, Refresh token 🔒.
Simulasi: Tohum (seed — seed anu sami ngahasilkeun pesenan anu sami), Ürünler* (produk, hiji per baris: kode produk platform|harga|nami), Günlük sipariş sayısı (pesenan per dinten), Komisyon oranı (%) (tarif komisi), Kargodan teslime (dk) (menit ti dikirim dugi ka katampi), İade edilecek sipariş numaraları (nomer pesenan anu diretur), Platformda iptal edilecek sipariş numaraları (nomer pesenan anu dibatalkeun di platform), Para birimi (mata uang), Kullanıcı adı* 🔒 (demo), Parola* 🔒 (kecap konci).

Kredensial henteu kantos ditingalikeun deui. Kolom rusiah (🔒) disimpen kaénkripsi sareng henteu kantos diserat kana layar, réspon server, log, atanapi pesen kasalahan — administrator sistem ogé teu tiasa ningali deui. Kolom anu parantos disimpen némbongkeun disimpen (ketik pikeun ngarobih): antepkeun kosong pikeun ngajaga nilai lami, ketik pikeun ngarobih kolom éta waé. Upami konci énkripsi robih, kartu némbongkeun "Konci énkripsi parantos robih. Lebetkeun deui kredensial."

Kolom umum sami di unggal platform:

Kolom	Fungsina
Nami koneksi	Nami anu nembongan dina daptar sareng pesen (contona "Toko Shopee 1"). 1-80 karakter.
Kontak platform (pesenan dicatet ka kontak ieu)	Dina praktékna wajib. Sadaya pesenan HNR tina koneksi éta dicatet ka kartu kontak ieu; upami teu dipilih, pesenan tetep lebet tapi teu dicatet ka HNR (kode kasalahan `CARI_YOK`). Saran: damel kartu kontak misah pikeun unggal platform (contona "Shopee"); piutang pencairan dana platform ngumpul dina kontak éta.
Gudang (kosong = stok sakumna perusahaan)	Upami dieusian, stok gudang éta anu dikirim ka platform sareng baris pesenan HNR dicatet ka gudang éta. Upami kosong, stok sakumna perusahaan anu dianggo.
Interval nyandak pesenan (mnt) · Interval ngirim stok (mnt)	Sabaraha sering sinkronisasi otomatis nyandak pesenan (sareng retur) (bawaan 5, minimal 5, maksimal 120 menit) sareng ngirim stok/harga (bawaan 15, 5-1440 menit).
Mundur dinten dina nyandak munggaran	Sabaraha dinten ka tukang nyandak munggaran (bawaan 3, 0-30). Nyandak salajengna dimimitian sapoé saméméh nyandak anu hasil pamungkas (tumpang tindih nyegah aya anu kaliwat); hiji jandéla nyandak pangpanjangna 14 dinten.
Harga platform kalebet PPN	Aktip sacara bawaan. PPN dipisahkeun tina harga pesenan anu lebet sareng ditambihkeun kana harga anu kaluar (tingali §7).
Sinkronisasi otomatis (upami tugas server hurung)	Naha koneksi ieu milu sinkronisasi otomatis? Upami tugas server pareum, sinkronisasi ngan manual sanajan dicentang (tingali §11).

Status kartu koneksi: Ngantosan uji (disimpen, teu acan diuji atanapi pangaturan robih), Nuju jalan (uji atanapi sinkronisasi pamungkas hasil), Kasalahan. Koneksi anu gaduh pesenan teu tiasa dihapus sareng marketplace-na teu tiasa dirobih — pareumkeun (pareumkeun sinkronisasi otomatis) atanapi damel koneksi énggal. Ngahapus koneksi tanpa pesenan ogé ngahapus kredensial anu disimpen sareng pemetaan produkna.

Damel heula koneksi latihan ku Simulasi: ketik barcode kartu stok anjeun nyalira dina kotak Ürünler dina format barcode|harga|nami, simpen ku nami pangguna demo, uji, teras pencét Sinkronkeun ayeuna. Anjeun ningali sadaya alur (pemetaan, pesenan HNR, bungkus, kirim, ngirim stok, retur, pencairan dana) tanpa nyabak toko saleresna. Kecap konci yanlis ngalatih kasalahan kredensial sareng gecici kasalahan layanan samentawis.

4. Pemetaan produk

Platform ngenal produk ku kodena nyalira; HNR ku kartu stok. Tab Pemetaan produk nyambungkeun duanana. Konci pemetaan nyaéta kode produk platform + varian; upami baris pesenan ngamuat barcode, pemetaan ogé kapendak ngaliwatan barcode. Upami hiji baris waé teu acan dipetakeun, pesenan lebet tapi teu dicatet ka HNR (ESLEME_YOK); sanggeus nambihan pemetaan, pencét Catet deui ka HNR dina pesenan.

Manual — dina baris luhur eusian Kartu stok, Kode produk platform / barcode, Varian, Porsi stok %, Panyangga, Harga tetep teras pencét Petakeun. Upami produk platform parantos dipetakeun, pemetaanana diénggalan.
Produk platform anu teu acan dipetakeun anu katingal dina pesenan — produk tanpa pemetaan dina pesenan anu lebet didaptarkeun dina kotak konéng sareng jumlahna; klik salah sahijina pikeun mawa kodena kana formulir, teras cekap pilih kartu stok.
Saran tina barcode — némbongkeun kartu stok anu gaduh barcode anu teu acan dipetakeun salaku saran (barcode format GTIN 8/12/13/14 digit heula; kartu biaya, jasa, sareng tanaga kerja dikaluarkeun). Trendyol sareng Simulasi ngenal produk tina barcode, janten saran tiasa langsung dianggo. Hepsiburada, Tokopedia, sareng Shopee ngenal produk ku ID nyalira: saran tina barcode ngan pasti pikeun produk anu parantos katingal dina pesenan; pikeun anu sanésna anjeun ngeusian kode produk platform.
Impor CSV / XLSX — berkas anu baris kahijina judul kolom: stok, urun (atanapi barkod), varyant, sku, fiyat, pay, tampon. Pratinjau nembongan heula: "Pratinjau impor: … énggal, … badé diénggalan, … baris lepat" sareng nomer baris anu lepat; Terapkeun nyatet, Bolay ngabatalkeun. Pangseueurna 5.000 baris per berkas; produk platform anu sami teu kénging aya dua kali; baris anu kartu stokna teu kapendak dilangkungan.

Porsi stok % nyaéta persentase stok bébas anu dibuka pikeun platform ieu (bawaan 100). Panyangga nyaéta jumlah pangaman anu dikirangan sanggeus porsi (bawaan 0) — supados sababaraha barang pamungkas teu kajual di dua platform sakaligus. Upami Harga tetep dieusian, harga éta dikirim ka platform sakumaha ayana. Tibatan ngahapus pemetaan, anjeun tiasa Nonaktipkeun: stok sareng hargana teu dikirim deui, tapi pesenan lami tetep utuh.

5. Pesenan: nyandak sareng pesenan HNR

Di luhureun tab Pesenan aya opat kotak: Ngantosan dibungkus, Badé dikirim, Nuju dikirim, Antrian kasalahan; ngaklik kotak nyaring daptar kana status éta. Saringan platform sareng status, kotak "Milarian no. pesenan, palanggan, atanapi no. HNR", sareng kolom (Tanggal, Platform, No. pesenan, Palanggan, Produk, Jumlah, Status, Pesenan HNR) aya di dieu. Klik baris pikeun muka kartu pesenan.

Nyandak henteu kantos ganda. Pesenan dikenal tina nomer platform sareng nomer pakétna; upami pesenan anu sami sumping deui, teu aya catetan énggal anu didamel, ngan status, nomer resi, sareng potonganana anu diénggalan. Pesenan marketplace henteu kantos dihapus tina HNR; pembatalan ogé hiji status sareng riwayat tetep disimpen.

Pesenan HNR. Pesenan énggal anu sadaya produkna parantos dipetakeun sareng koneksina gaduh kontak platform dicatet ka HNR salaku pesenan penjualan: kontak = kontak platform, séri dokumén PZ (contona PZ2026000001, saluran "pazaryeri"; nomer dipasihkeun sakali sareng teu dianggo deui), katerangan "Tokopedia siparişi 123456 … [PZ#…]", tanggal kirim = wates kirim platform, nami palanggan ahir dina kolom Up. (kanggo). Harga baris nyaéta harga jual platform; kusabab kalebet PPN, dicatet ka HNR salaku harga = kotor ÷ (1 + PPN/100). Upami nyatet kaganggu, pesenan kapendak deui ngaliwatan tanda dina katerangan; pesenan anu sami teu kantos dicatet dua kali. Konfirmasi platform: di Tokopedia pesenan dikonfirmasi di platform sanggeus dicatet ka HNR; di platform sanés léngkah bungkus nyaéta konfirmasina.

Naha gerbang limit kiridit sareng mesin harga teu dilarapkeun? Pesenan marketplace parantos kajual di platform sareng pamayaranana dijamin ku platform; upami HNR nolak éta kusabab "limit kaleuwihan", wates waktos kiriman platform (SLA) kaliwat sareng rating toko anjeun turun. Ku kituna gerbang limit kiridit teu dilarapkeun kana pesenan ieu; hutang platform ka anjeun dipantau dina tab Pencairan dana. Sanajan kitu, upami kontak diblokir atanapi ngaleuwihan limit, atanapi harga platform di handapeun wates handap daptar harga, pesenan tetep dicatet tapi dibéré peringatan (kotak konéng dina detil pesenan, baris perhatosan di Nabız; harga di handapeun wates ogé asup kana persetujuan). Hargana ogé nyaéta harga anu dibayar palanggan di platform; mesin harga teu ngarobih harga pesenan (inpormasi diskon tetep dina catetan marketplace). Mesin harga ngan dianggo pikeun harga anu dikirim ka platform (§7).

Data palanggan ahir. Nami, e-mail, telepon, nomer idéntitas/pajeg (TCKN/VKN, NIK/NPWP), kantor pajeg, alamat faktur sareng alamat pangiriman pembeli disimpen dina catetan marketplace (kontak pesenan HNR nyaéta kontak platform; data palanggan ahir pikeun faktur e-Arsip). Dina daptar sareng kartu, nomer idéntitas disamarkeun (contona *******1234), e-mail a***@…, telepon ngan opat digit pamungkas; alamat disumputkeun. Nilai lengkep ngan katingal ku pangguna anu gaduh idin ngokolakeun marketplace, sareng unggal tampilan dicatet kana jejak audit.

Mesin status. Pesenan ngan maju: Énggal → Disatujuan → Parantos dibungkus → Nuju dikirim → Katampi. Bolay kajadian saméméh katampi; Retur sanggeus dikirim atanapi katampi. Léngkah mundur ti platform (kaca telat atanapi lami) dilangkungan; pembatalan sareng retur salawasna dilarapkeun. Upami pindah anu teu diidinan dicobian ti HNR, nembongan peringatan "Pesenan teu tiasa ngalih ti status … ka …."

Kolom Pesenan HNR némbongkeun kaayaan pasanganana: Teu acan dicatet ka HNR, Nuju dicatet ka HNR, Pesenan HNR kabuka, Parantos difakturkeun (otomatis sanggeus pesenan difakturkeun di HNR), Pesenan HNR dihapus. Dua peringatan sanés kasalahan, tapi pantes ditingali: "Stok bébas kirang, pesenan janten backorder: …" (pesenan tetep dicatet) sareng "Pesenan parantos dikirim sateuacan integrasi. Pesenan HNR teu dicatet (tiasa dicatet ku cobian deui)." (pesenan lami anu dikirim saméméh koneksi didamel teu dicatet otomatis).

6. Bungkus, kirim, katampi

Tombol dina kartu pesenan ngalakukeun léngkah salajengna sareng ngalaporkeun ka platform heula, teras nyatet status; upami platform nolak, status teu robih sareng kasalahanana ditémbongkeun. Dina daptar, tombol Bungkus / Kirim dina baris ngalakukeun hal anu sami.

Bungkus — "nuju disiapkeun/dibungkus" dilaporkeun ka platform (Trendyol Picking/Invoiced; di Hepsiburada pakét didamel sareng nomerna dicatet kana pesenan). Status Parantos dibungkus.
Kirim — kotak Nomer resi sareng Ékspédisi sipatna pilihan. Upami kosong, nomer resi heula dibaca tina Pangiriman (upami pesenan HNR atanapi fakturna aya dina hiji pangiriman, nomer resi sareng ékspédisi pangiriman éta), sareng upami teu aya, asalna tina ékspédisi rekanan platform. Di Trendyol sareng Hepsiburada, upami Kendi kargo anlaşması = evet (kontrak ékspédisi nyalira = enya), nomer resi dikirim ti HNR ka platform; di Shopee dianggo pangaturan dropoff/pickup. Status Nuju dikirim.
Katampi — biasana dilaporkeun ku platform. Upami anjeun ngirim ku ékspédisi nyalira, pesenan otomatis janten Katampi sanggeus bukti serah tarima (POD) dicandak dina Pangiriman; upami perlu, tandaan manual ku tombol Katampi dina kartu.
Batalkeun — ngabatalkeun pesenan di platform; teu tiasa dibalikeun sareng nyuhunkeun konfirmasi. Upami pesenan HNR kabuka, "Batal di platform, pesenan HNR kabuka" lebet kana antrian kasalahan: tutup ku Hapus pesenan HNR dina kartu (nganggo idin hapus pesenan HNR anjeun nyalira).

Di handapeun kartu pesenan aya bagian Retur sareng Riwayat parobihan: unggal parobihan status dicatet sareng saha anu ngalakukeunana (atanapi "sistem") sareng sumberna (manual, platform, POD pangiriman).

7. Ngirim stok sareng harga

Stok anu dikirim diitung kieu (aturan anu sami sareng ATP):
bébas = stok − teu tiasa dianggo (gudang karantina / subkontrak / nonaktip) − sésa pesenan penjualan anu kabuka (dipesen)
dikirim = minimal 0, buleudkeun ka handap(bébas × porsi stok / 100) − panyangga
Conto: stok 120, 10 di karantina, 30 dina pesenan kabuka → bébas 80; porsi 50% → 40; panyangga 5 → 35 dikirim ka platform.

Pas pesenan marketplace dicatet ka HNR, pesenan éta janten pesenan penjualan anu kabuka sareng dikirangan salaku pesenan; di platform ogé parantos ngirangan — teu diitung dua kali. Sababaraha platform masing-masing nyandak porsina tina stok bébas anu sami; jumlah porsi kénging langkung ti 100 (kaputusan sadar pangurus: unggal platform ningali barang anu sami, anu ngajual heula anu kéngingeun).

Harga dipilarian ku urutan ieu: Harga tetep dina pemetaan (dikirim sakumaha ayana) → daptar harga anu nyambung ka pemetaan → mesin harga (kontak = kontak platform, saluran Marketplace (e-commerce), tanpa kampanye — kampanye platform dikokolakeun di platform) → harga 1 kartu stok. Harga mesin sareng kartu teu acan kalebet PPN; upami Harga platform kalebet PPN aktip, anu dikirim neto × (1 + PPN/100). Kolom Sumber harga dina tabel némbongkeun mana anu dianggo.

Tab Stok sareng harga némbongkeun, pikeun unggal pemetaan, kolom Stok, Reservasi, Bébas, Porsi / panyangga, Stok HNR, Stok platform, Harga HNR, Harga platform, sareng Sumber harga; baris anu béda disorot. Nilai platform biasana nilai pamungkas dikirim; upami Tanyakeun nilai ayeuna di platform dicentang, nilai dibaca ti platform (ayeuna Trendyol sareng Simulasi ngadukung; pikeun anu sanés ditémbongkeun nilai pamungkas dikirim). Kirim anu robih ngan ngirim anu béda tina nilai pamungkas; Kirim deui sadayana maksa sadayana. Hasilna diringkes janten "… produk dikirim, … dilangkungan kusabab teu robih, … gagal."; alesan baris anu gagal nembongan dina pemetaan sareng dina antrian kasalahan.

8. Retur

Retur platform dicandak sareng pesenan (ningali ka tukang sahenteuna 14 dinten); nomer retur anu sami diolah sakali. Nalika retur sumping, pesenan janten Retur, jumlah retur nembongan dina baris sareng nilai retur dina pesenan, sarta nomer retur platform, alesan, sareng nilaina dicatet dina bagian Retur dina kartu.

Di HNR faktur retur penjualan teu didamel otomatis. Upami pesenan parantos difakturkeun, dina antrian kasalahan nembongan "Ngantosan faktur retur" — damel faktur retur tina input dokumén sapertos biasa. Upami teu acan difakturkeun, nembongan "Retur di platform, pesenan HNR kabuka" — tutup pesenan kabuka éta ku Hapus pesenan HNR dina kartu. Nilai retur dikirangan tina pencairan dana.

9. Pencairan dana

Tab Pencairan dana némbongkeun hiji baris per koneksi pikeun periode anu dipilih (bawaan bulan ieu); pesenan anu dibatalkeun teu diitung:
perkiraan pencairan dana = jualan kotor − komisi − potongan ongkos kirim − biaya layanan − retur
Jualan kotor nyaéta jumlah kalebet PPN anu dibayar palanggan. Komisi asalna tina tarif komisi baris di Trendyol, tina rincian pamayaran (escrow) platform di Shopee, tina Tahmini komisyon oranı (perkiraan tarif komisi) koneksi di Tokopedia, sareng tina tarif dina pangaturan di Simulasi; nembongan per baris sareng per pesenan dina kartu pesenan.

Teu aya jurnal komisi otomatis. Platform nagih komisi sareng biaya layanan ku fakturna nyalira (e-Fatura bulanan ti Trendyol sareng Hepsiburada, faktur ti Shopee sareng Tokopedia). Faktur éta dicatet di HNR salaku faktur pameseran, sareng akuntansi ngabukukeun bebanna ti dinya. Tabel pencairan dana ngan pikeun rékonsiliasi: bandingkeun dana anu dicairkeun platform sareng faktur anu dikaluarkeunana ku baris ieu. Ku kituna beban anu sami teu kantos dibukukeun dua kali.

Tab Pencairan dana ngan katingal ku pangguna anu gaduh idin ngokolakeun marketplace; anu sanés ningali "Pencairan dana meryogikeun idin ngokolakeun marketplace."

10. Log sareng kasalahan

Di luhureun tab Log sareng kasalahan aya antrian kasalahan: pesenan anu mawa kode kasalahan, pemetaan anu gagal dikirim, sareng koneksi anu statusna kasalahan ("… kasalahan padeukeut"). Di handapeunana, per koneksi, Nyandak pesenan pamungkas, Ngirim stok pamungkas, sareng naha sinkronisasi otomatis hurung; pangpandapna tabel log (Waktu, Koneksi, Lampah, Status, Katampi, Énggal, Diénggalan, Dikirim, Duplikat, Pesen). Upami antrian kosong kaserat "Antrian kasalahan kosong."

Kode	Dina layar	Anu kedah dilakukeun
`ESLEME_YOK`	Aya produk anu teu acan dipetakeun	Petakeun produk anu kirang dina tab Pemetaan produk, teras pencét Catet deui ka HNR dina pesenan.
`CARI_YOK`	Kontak platform teu acan dipilih	Administrator sistem milih kontak platform dina koneksi; teras Catet deui ka HNR.
`HNR_YAZILAMADI`	Pesenan HNR teu tiasa dicatet	Atasi alesan anu kaserat dina kartu (contona kartu stok kahapus, séri dokumén teu aya, nyerat HNR ditutup), teras Catet deui ka HNR.
`HNR_ACIK_IPTAL`	Batal di platform, pesenan HNR kabuka	Pencét Hapus pesenan HNR dina kartu (stok anu dipesen dileupaskeun).
`HNR_ACIK_IADE`	Retur di platform, pesenan HNR kabuka	Pesenan anu teu acan difakturkeun diretur: pencét Hapus pesenan HNR dina kartu.
`IADE_FATURASI`	Ngantosan faktur retur	Pesenan anu parantos difakturkeun diretur: damel faktur retur penjualan tina input dokumén.
`HNR_SILINDI`	Pesenan HNR parantos kahapus	Pesenan HNR dihapus ti tempat sanés, sanés tina jandéla marketplace; pesenan marketplace teu gaduh pasangan di HNR. Upami dihaja, antepkeun; upami henteu, pariksa status di platform.

Catet deui ka HNR ngan nembongan dina pesenan tanpa pasangan HNR sareng ogé nyatet pesenan anu parantos dikirim sateuacan integrasi; pesenan anu dibatalkeun teu dicatet ka HNR. Kasalahan tingkat koneksi ditémbongkeun numutkeun kelasna: Kredensial ditolak, Layanan atanapi idin teu acan aktip dina akun ieu, Pangaturan koneksi teu acan lengkep (pikeun tiluanana cobian otomatis eureun sareng administrator sistem kedah ngalereskeun sababna), Kasalahan jaringan atanapi waktosna séép, Layanan marketplace samentawis teu ngabales, Marketplace ngabalikeun data anu teu disangka (pikeun ieu interval cobian otomatis jadi dua kali unggal kasalahan, pangpanjangna 6 jam).

11. Sinkronisasi otomatis

Sinkronisasi otomatis pareum sacara bawaan (HNR teu ngahubungi platform ku nyalira). Pikeun ngahurungkeunana, administrator sistem nyerat PAZARYERI_GOREV=1 dina berkas .env server teras ngamimitian deui layanan Node. Salami pareum, jandéla némbongkeun "Sinkronisasi otomatis pareum (pangaturan server PAZARYERI_GOREV). Sinkronisasi dilakukeun sacara manual." sareng sadayana jalan ngaliwatan Sinkronkeun ayeuna.

Tugas mariksa unggal menit; unggal koneksi nyandak pesenan sareng retur dina Interval nyandak pesenan-na nyalira sareng ngirim stok sarta harga dina Interval ngirim stok-na. Ngan koneksi anu Sinkronisasi otomatis-na dicentang sareng kredensialna disimpen anu milu.
Perusahaan utama server (HNR_FIRMA) dipindai ku penjadwal; pikeun éta pangguna layanan anu gaduh idin nyerat (HNR_B2B_KULLANICI) kedah ditetepkeun dina .env. Perusahaan sanés disinkronkeun di tukang ku sési pangguna éta nyalira nalika pangguna anu gaduh idin nyerat muka jandéla Marketplace atanapi Nabız. Perusahaan anu milu tiasa diwatesan ku PAZARYERI_FIRMALAR (atanapi HNR_FIRMALAR).
Nalika tugas nampi pesenan énggal, administrator anu ngadamel koneksi nampi pesen "…: … pesenan marketplace énggal katampi."; upami koneksi gagal tilu kali padeukeut, peringatan "Koneksi marketplace … ngalaman kasalahan: …" dikirim sakali.

Sinkronkeun ayeuna (di luhureun jandéla, sareng pamilih koneksi) langsung ngajalankeun sinkronisasi pesenan, retur, sareng stok/harga dina koneksi anu dipilih, boh tugasna hurung boh henteu, teras némbongkeun "Sinkronisasi réngsé: … pesenan énggal, stok sareng harga … produk dikirim." Koneksi anu sami teu kantos disinkronkeun dua kali sakaligus ("Koneksi ieu nuju disinkronkeun. Cobian deui sakedap deui.").

12. Dina telepon (Taman + Léngkah)

Dina layar langkung alit ti 7 inci, jandéla Marketplace disederhanakeun pikeun patugas gudang: di luhur tab Badé dibungkus, Badé dikirim, sareng Gagal sareng jumlahna, kotak "Milarian no. pesenan atanapi palanggan", sareng tombol Candak pesenan énggal; di handapna kartu pesenan kalayan daérah keuna anu ageung (palanggan, kota/kacamatan, jumlah, wates kirim).

Pesenan — baris, palanggan ahir, sareng inpormasi pangiriman.
Bungkus — laporan dibungkus ku sakali toél.
Kirim — ketik nomer resi atanapi antepkeun kosong (dicandak tina kiriman atanapi platform) teras kirim.

Administrator sistem ogé tiasa ngadamel koneksi tina telepon: formulir dina Pangaturan aya tilu léngkah dina telepon (Marketplace · Kredensial sareng pangaturan · Uji). Tingali panduan Sélulér pikeun rincianana.

13. Idin

Dina Pangaturan › Pangguna, grup Marketplace gaduh dua idin: Pesenan marketplace: sinkronkeun, bungkus, kirim, batalkeun, kirim stok sareng harga (singketna pazaryeri) sareng Pemetaan produk, pencairan dana, sareng idéntitas lengkep palanggan ahir (pazaryeri_yonet; kalebet anu kahiji). Aturanana dilarapkeun di server.

Padamelan	Idin anu diperlukeun
Ningali pesenan, pemetaan, bédana stok sareng harga, sarta log; sinkronkeun ayeuna; bungkus, kirim, katampi, batalkeun; catet deui ka HNR; kirim stok sareng harga	`pazaryeri`
Nambihan, ngarobih, ngahapus pemetaan, impor CSV/XLSX; tab Pencairan dana; idéntitas lengkep, e-mail, telepon, sareng alamat palanggan ahir; data pembeli e-Arsip	`pazaryeri_yonet`
Nambihan, ngarobih, ngahapus, nguji koneksi; ngalebetkeun kredensial	Ngan administrator sistem
Hapus pesenan HNR (dina pesenan anu dibatalkeun atanapi diretur di platform)	`pazaryeri` + idin hapus pesenan milik pangguna nyalira

Pangguna ngan-maca teu tiasa ngarobih catetan marketplace; upami gerbang nyerat HNR ditutup, teu aya operasi nyerat anu dijalankeun. Koneksi, pemetaan, tampilan idéntitas, sareng unggal tindakan manual dicatet kana jejak audit server (saha, iraha, naon).

14. Nabız sareng Dasbor Pamilik

Dina layar utama Nabız dina telepon, salah sahiji tina dua baris nembongan dina daptar Salajengna: "… pesenan marketplace énggal nuju ngantosan dibungkus." atanapi "Aya … catetan dina antrian kasalahan marketplace."; nyabak baris muka jandéla Marketplace dina tab anu patali. Kotak omzét Dasbor Pamilik némbongkeun catetan suku "Marketplace: omzét … (kalebet PPN) tina … pesenan, komisi sareng potongan platform …."; ngaklikna muka tab Pencairan dana.

15. Teu acan aya dina vérsi ieu

Ngadamel produk énggal di platform (listing, gambar, déskripsi — ayeuna ngan stok sareng harga produk anu parantos aya anu dikirim), ngadamel faktur retur penjualan otomatis tina retur, neraskeun idéntitas palanggan ahir ka faktur e-Arsip sacara otomatis (datana parantos siap sareng titik sambungna sayogi), milih daptar harga dina layar pemetaan, ngokolakeun kampanye sareng kupon platform, sarta ngimpor faktur platform sacara otomatis direncanakeun salaku padamelan misah.

Panduan patali: Pangiriman jeung Logistik · Harga sareng Kampanye · Koneksi bank langsung · Pangaturan · Sélulér · Sadaya modul.