Trendyol Orders Import (WooCommerce)

Plugin WordPress care importă automat comenzile Trendyol (Seller API) în WooCommerce și le ține statusurile la zi.

Ce face

• Creează câte o comandă WooCommerce pentru fiecare pachet Trendyol (shipment package), fără duplicate: pachetul este recunoscut după ID la fiecare sincronizare.
• Sincronizare automată în fundal (WP-Cron, la 5/10/15/30/60 minute), plus butoane pentru Sincronizează acum, Testează conexiunea și Rescanează ultimele N zile.
• Actualizează statusul comenzilor existente când se schimbă statusul în Trendyol (ex. Created → Shipped → Delivered, Cancelled, Returned). Maparea statusurilor se poate configura, iar o comandă nu este mutată niciodată înapoi (ex. din Finalizată în Procesare).
• Potrivește produsele după SKU (SKU vânzător sau barcode Trendyol), după câmpul GTIN/EAN din WooCommerce sau după un câmp meta ales de tine. Produsele negăsite sunt adăugate doar cu numele, iar pe comandă apare o notă.
• Stoc: scade stocul la import și îl readaugă la anulare (se poate dezactiva).
• TVA: prețurile Trendyol includ TVA; dacă în WooCommerce există o cotă cu același procent (ex. 21%), TVA-ul apare pe linie separată de taxă.
• Salvează pe comandă numărul comenzii Trendyol, ID-ul pachetului, statusul Trendyol, curierul, AWB-ul (cu link de urmărire) și linkul facturii. Comenzile se pot căuta după numărul Trendyol.
• Nu trimite emailuri clienților Trendyol (de comunicarea cu ei se ocupă Trendyol). Emailurile de administrator sunt opționale.
• Compatibil cu HPOS (High-Performance Order Storage).

Instalare

1. Descarcă arhiva ZIP a repository-ului (sau arhiva plugin-ului) și încarc-o din Module › Adaugă modul › Încarcă modul.
2. Activează Trendyol Orders Import (necesită WooCommerce activ).
3. Mergi la WooCommerce › Trendyol.

Configurare

1. Completează Seller ID, API Key și API Secret. Le găsești în panoul de vânzător Trendyol, la Contul meu › Informații de integrare (Hesabım › Entegrasyon Bilgileri).
2. Salvează, apoi apasă Testează conexiunea.
3. Alege câte zile în urmă să fie importate la prima sincronizare (implicit 7), bifează Sincronizare automată și salvează.
4. Apasă Sincronizează acum pentru primul import. De aici încolo, comenzile noi și schimbările de status sunt preluate automat.

Maparea implicită a statusurilor

UnPacked înseamnă că Trendyol a împărțit pachetul în altele noi: comanda veche este anulată (stocul revine), iar pachetele noi sunt importate ca și comenzi separate.

Cum funcționează sincronizarea

• La fiecare rulare sunt cerute de la Trendyol pachetele modificate de la ultima sincronizare reușită (cu o suprapunere de 15 minute), în ferestre de maximum 2 săptămâni și pagini de câte 200 de pachete.
• Dacă o rulare eșuează, următoarea reia de unde a rămas. O singură sincronizare poate rula la un moment dat.
• Jurnalul se află în WooCommerce › Stare › Jurnale, sursa trendyol-orders.
• Din WP-CLI: wp trendyol sync (continuă de la ultima sincronizare) sau wp trendyol sync --days=30 (rescanează ultimele 30 de zile).

Pentru dezvoltatori

• trendyol_wc_find_product (filter) – întoarce un WC_Product pentru o linie Trendyol, dacă ai o regulă proprie de potrivire.
• trendyol_wc_order_created / trendyol_wc_order_updated (actions) – rulează după ce o comandă a fost creată / actualizată.
• trendyol_wc_time_offset (filter) – decalajul orar al datelor Trendyol (implicit GMT+3).

Meta pe comandă: _trendyol_package_id, _trendyol_order_number, _trendyol_status, _trendyol_cargo_provider, _trendyol_tracking_number, _trendyol_tracking_link, _trendyol_invoice_link, _trendyol_tax_number, _trendyol_tax_office.