Aici puteți găsi un ghid complet despre cum să creați o comandă în Skyplanner cu toate datele aferente. O parte din aceste aspecte au fost abordate în tutorialul de integrare, dar aici vom trece în revistă structura datelor Skyplanner și procesul de integrare în detaliu.
Structura datelor #
În primul rând, vom trece în revistă modul în care este structurată o comandă Skyplanner. API-endpoint-urile pentru entitățile de date menționate aici sunt evidențiate astfel: /phaser-orders
La nivelul superior avem comanda(/phaser-orders)
Fiecare comandă trebuie să aibă un client(/customers).
Fiecare comandă poate avea mai multe articole de comandă(/phaser-Order-items)
Fiecare articol de comandă poate avea atașat un produs(/products), dar nu este obligatoriu. Fiecare produs are un stoc(/saldos). Rețineți că entitatea stoc este creată automat atunci când un produs este creat cu API.
Fiecare articol de comandă poate avea mai multe sarcini (aka etape de proces)(/phaser-jobs).
Fiecare sarcină trebuie să aibă o etapă de lucru(/workstages).
Fluxul de lucru al integrării #
Iată un exemplu pas cu pas al modului în care ați putea structura integrarea de la sistemul ERP la Skyplanner.
- Preluarea vânzărilor/ordinelor de lucru din ERP
- Crearea clientului (obțineți id-ul clientului în răspuns)
- Crearea unei comenzi cu id-ul clientului (obținerea id-ului comenzii în răspuns)
- Preluarea datelor referitoare la articolele din comenzile de vânzări/ordine de lucru din ERP
- Creați produsul (obțineți id-ul produsului în răspuns)
- Creați un articol de comandă cu id-ul comenzii și alte date (obțineți id-ul articolului de comandă în răspuns)
- Preluarea datelor privind etapele procesului din ERP
- Crearea etapei de lucru (obțineți id-ul etapei de lucru în răspuns)
- Crearea unui job cu id-ul etapei de lucru și alte date
Sfaturi suplimentare #
La ștergere #
Ștergerea comenzilor phaser, a articolelor de comandă phaser sau a lucrărilor phaser prin API (și din interfața de utilizator) se face într-o manieră soft delete. Aceasta înseamnă că datele nu sunt șterse efectiv din baza de date, ci sunt marcate ca fiind arhivate. De fapt, atributul is_archive al entității este setat la true atunci când este șters. Entitățile arhivate/șterse pot fi în continuare accesate prin API utilizând parametrul include_archived. Atunci când include_archived=true, o solicitare GET va prelua entitatea chiar dacă aceasta este arhivată.
Rețineți că ștergerea ușoară nu este disponibilă în fiecare punct final API! Prin urmare, trebuie să fiți atenți, deoarece ștergerea, de exemplu, a clienților, persoanelor etc. este permanentă!
Utilizarea etapelor de proces prestabilite pentru elementul dvs. de comandă #
Dacă ați creat niște pași de proces impliciți pentru produsul pe care îl produce articolul dvs. de comandă, puteți spune sistemului să aducă valorile implicite la articolul de comandă cu ajutorul API, utilizând atributul get_default_steps.
Adăugarea de materiale la elementul de comandă #
Dacă ați atașat materiale la produsul produs, acestea sunt atașate automat la rândul de comandă.
Cu toate acestea, dacă nu doriți să utilizați materialele atașate produsului (de exemplu, dacă articolul este o comandă specială și doriți să utilizați materiale diferite etc.), puteți utiliza atributul use_custom_materials.
