Flux de lucru pentru integrarea API a pieselor de schimb
Last updated: October 14, 2026
Tehnicienii folosesc sistemul de întreținere L2L pentru a gestiona anomaliile de pe platforma de producție. Toate activitățile de întreținere sunt înregistrate într-o Expediere L2L, similară unei Ordonanțe de lucru ERP. Tehnicienii solicită piese de schimb din ecranul Expediere L2L, iar piesele de schimb pot fi eliberate din ecranul Coada pieselor de schimb L2L.
Piesele de schimb pot fi gestionate în L2L sau într-o altă aplicație, cum ar fi un ERP. Atunci când piesele de schimb sunt gestionate într-un sistem ERP, înregistrările pieselor de schimb pot fi sincronizate cu L2L, astfel încât să poată fi utilizate de tehnicieni în sistemul Expediere L2L. Înregistrările de consum pot fi apoi sincronizate din L2L către sistemul ERP pentru a finaliza procesul de gestionare a pieselor de schimb.
Piesele de schimb dintre L2L și ERP pot fi menținute sincronizate folosind două procese automatizate. Acest document oferă documentația necesară pentru construirea acestor procese.
Acest document oferă instrucțiuni pentru integrarea pieselor de schimb ERP cu piesele de schimb L2L. Aceasta include sincronizarea înregistrărilor de consum al pieselor de schimb din L2L către ERP. De asemenea, este furnizată documentația pentru sincronizarea Expedierilor L2L cu Ordonanțele de lucru ERP, dacă acest lucru este necesar pentru ERP.
Diagramă a fluxului procesului
Următoarea diagramă a fluxului procesului reprezintă un flux tipic al înregistrărilor pieselor de schimb într-o fabrică. Aplicația de integrare este reprezentată prin casete galbene în diagramă.

Aplicație de integrare middleware
Sincronizarea înregistrărilor de consum
Acesta este procesul prin care solicitările de piese de schimb din L2L sunt inserate în ERP ca înregistrări de consum. Acest proces corespunde pasului 2a din diagrama de mai sus.
Obiectiv: Înregistrările de consum sunt actualizate în ERP.
Interval sugerat: 1-5 minute
Schița procesului - METODA 1:
Preluați din L2L înregistrările noi ale solicitărilor de piese de schimb.
GET https://[customer].leading2lean.com/api/1.0/spares/?auth=[api key]&site=[site id]&status__lte=3Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.
Inserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.
Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.
Marcați fiecare înregistrare a piesei de schimb ca „sincronizată” în L2L pe măsură ce este inserată în ERP. Dacă procesul este întrerupt, piesele marcate ca sincronizate nu vor fi incluse în sarcina utilă a solicitării de piese de schimb, iar înregistrările de consum nu vor fi duplicate.
POST https://[customer].leading2lean.com/api/1.0/spares/synchronize/[spare id]/?auth=[api key]Parametri POST:
status=6Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.
Schița procesului - METODA 2:
Aceasta este metoda preferată dacă utilizați funcționalitatea de Kitare sau dacă utilizați stările pieselor de schimb „La comandă” și „Primite”.
Identificați cel mai recent moment la care procesul de sincronizare a fost finalizat cu succes. În mod ideal, acest moment este stocat local, astfel încât procesul să poată fi rulat din nou dacă este întrerupt.
Dacă acest lucru nu este posibil, următoarea interogare va returna momentul ultimei sincronizări din L2L. Această interogare trebuie limitată pentru a lua în considerare numai solicitările de piese de schimb care au fost sincronizate în decurs de o săptămână (sau mai puțin), pentru a menține performanța interogării. Proprietateasynchronized_ona solicitării de piese de schimb returnate va fi utilizată la pasul următor ca parametru de interogarelastupdated__gte=[time of last sync].GET https://[customer].leading2lean.com/api/1.0/spares/?auth=[api key]&site=[site id]&synchronized_on__gte=[one week ago]&order_by=-synchronized_on&limit=1Preluați din L2L înregistrările noi ale solicitărilor de piese de schimb.
GET https://[customer].leading2lean.com/api/1.0/spares/?auth=[api key]&site=[site id]&lastupdated__gte=[time of last sync]&order_by=lastupdatedInserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.
Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.
Setați data
synchronized_onpe înregistrarea piesei de schimb pentru a indica faptul că înregistrarea piesei de schimb a fost sincronizată. Dacă stocați local momentul ultimei sincronizări reușite, utilizați ora UTC curentă pentrusynchronized_on. Dacă nu stocați local momentul ultimei sincronizări reușite, setațisynchronized_onla valoarealastupdatedînregistrării piesei de schimb. Astfel, procesul va putea relua în mod corespunzător de unde a rămas dacă nu se finalizează cu succes. Trebuie să transmiteți starea curentă a înregistrării piesei de schimb, astfel încât aceasta să nu fie setată automat ca sincronizată.
POST https://[customer].leading2lean.com/api/1.0/spares/synchronize/[spare id]/?auth=[api key]Parametri POST:
synchronized_on=[lastupdated OR current UTC time]&status=[current status]
Informații suplimentare:
Acest proces nu va fi întrerupt dacă solicitarea de piese de schimb este închisă din interfața web Coada pieselor de schimb L2L înainte ca înregistrările să fie sincronizate. Închiderea unei solicitări de piese de schimb în interfața web și sincronizarea solicitării de piese de schimb prin API se pot efectua în orice ordine.
Dacă utilizați Metoda 1, L2L va seta automat proprietatea
synchronized_onla ora UTC curentă atunci când setați starea lasynchronized. Acest lucru va facilita migrarea la Metoda 2.
Sincronizarea pieselor de schimb
ERP este sistemul de referință pentru o piesă de schimb. Pentru a le oferi angajaților de pe platforma de producție o listă exactă a pieselor de schimb, acestea trebuie sincronizate cu L2L în mod regulat. Acest proces corespunde pasului 4 din diagrama de mai sus.
Obiectiv: Toate piesele de schimb sunt actualizate în L2L.
Interval sugerat: 1-5 minute
Schița procesului:
Preluați din ERP toate înregistrările pieselor de schimb care au fost actualizate de la ultima sincronizare a pieselor. Pentru aceasta, va trebui să urmăriți momentul la care rulează instrumentul de sincronizare.
Actualizați fiecare piesă de schimb în L2L.
POST https://[customer].leading2lean.com/api/1.0/billofmaterials/inbound_sync/?auth=[api key]Parametri POST:
site=[site]&partnumber=[part number]&description=[description]&location=[location]&quantity=[quantity]&minimum=[minimum]&optimum=[optimum]&cost=[cost]Consultați documentația API pentru lista completă a parametrilor.
Opțional: Eliminați locațiile neutilizate. Atunci când locațiile sunt eliminate dintr-un ERP, acestea trebuie eliminate în mod explicit și din L2L.
Colectați o listă a locațiilor de depozit pentru o piesă de schimb.
GET https://[customer].leading2lean.com/api/1.0/binlocations/?auth=[api key]&site=[site id]&billofmaterials=[bill of materials id]Dezactivați locațiile neutilizate și setați
quantityla0. (Aceasta utilizează aceeași metodă API ca pasul 2 de mai sus).POST https://[customer].leading2lean.com/api/1.0/billofmaterials/inbound_sync/?auth=[api key]Parametri POST:
site=[site]&partnumber=[part number]&location=[location]&quantity=0&active=false
Opțional: Adăugați informațiile furnizorului la piesă.
Obțineți ID-ul furnizorului
GET https://[customer].leading2lean.com/api/1.0/vendors/?auth=[api key]&site=[site id]&name=[vendor name]Adăugați o înregistrare nouă
POST https://l2l.leading2lean.com/api/1.0/billofmaterialsvendor/?auth=[api key]Parametri POST:
site=[site]&billofmaterials=[bill of materials id]&partnumber=[vendor part number]&primary=[true or false]&vendors=[vendor id]
Sincronizarea înregistrărilor de consum cu Ordonanțele de lucru (opțional)
Utilizați acest proces dacă înregistrările de consum trebuie atașate unei Ordonanțe de lucru în ERP. Din cauza complexității suplimentare, este preferată sincronizarea înregistrărilor de consum fără Ordonanțe de lucru. Acest proces este identic cu procesul de sincronizare a înregistrărilor de consum, cu câțiva pași suplimentari pentru integrarea cu Ordonanțele de lucru. Acest proces corespunde pașilor 2a și 2b din diagrama de mai sus.
Obiectiv: Înregistrările de consum sunt actualizate în sistemul ERP.
Interval sugerat: 1-5 minute
Schița procesului:
Preluați din L2L înregistrările noi ale solicitărilor de piese de schimb.
GET https://[customer].leading2lean.com/api/1.0/spares/?auth=[api key]&status__lte=3Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.
Pentru fiecare solicitare de piese de schimb, obțineți obiectul Expediere din L2L utilizând parametrul de expediere din înregistrarea solicitării de piese de schimb.
GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&id=[dispatch]Dacă în ERP a fost creată o Ordonanță de lucru din Expediere, actualizați-o. În caz contrar, creați o Ordonanță de lucru în ERP utilizând detaliile Expedierii. Consultați procesul de sincronizare a Ordonanțelor de lucru de mai jos pentru documentația privind asocierea unei Expedieri L2L cu o Ordonanță de lucru ERP
Inserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.
Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.
Marcați fiecare înregistrare a piesei de schimb ca „sincronizată” în L2L pe măsură ce este inserată în ERP. Dacă procesul este întrerupt, piesele marcate ca sincronizate nu vor fi incluse în sarcina utilă a solicitării de piese de schimb, iar înregistrările de consum nu vor fi duplicate
POST https://[customer].leading2lean.com/api/1.0/spares/synchronize/[spare id]/?auth=[api key]Parametri POST:
status=6Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.
Sincronizarea Ordonanțelor de lucru (opțional)
Sincronizarea Ordonanțelor de lucru nu este de obicei necesară pentru Integrarea pieselor de schimb. Această documentație a procesului este furnizată pentru Integrările care pot necesita sincronizarea Ordonanțelor de lucru din alte motive.
Obiectiv: Ordonanțele de lucru create în L2L sunt sincronizate în ERP.
Interval sugerat: 5 - 60 de minute
Schița procesului:
FIE extrageți toate Expedițiile din L2L care au fost actualizate de la ultima sincronizare a Expedițiilor.
GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&lastupdated__gte=[last synchronized date, YYYY-MM-DD+HH:MM]SAU extrageți toate Expedițiile din L2L care au fost închise de la ultima sincronizare a Expedițiilor.
GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&closed__gte=[last synchronized date, YYYY-MM-DD+HH:MM]Dacă Expedierea a fost deja adăugată în ERP ca Ordonanță de lucru, actualizați Ordonanța de lucru din ERP. În caz contrar, creați o nouă Ordonanță de lucru în ERP.
Stocați ID-ul Ordonanței de lucru din ERP în înregistrarea Expediției L2L. Acesta va fi utilizat pentru a identifica dacă a fost creată o Ordonanță de lucru ERP pentru o Expediere L2L. De asemenea, poate fi utilizat pentru a căuta Expediții după ID-ul Ordonanței de lucru ERP.
POST https://[customer].leading2lean.com/api/1.0/dispatches/set_externalid/[dispatch id]/?auth=[api key]Parametri POST:
externalid=[erp work order id]
Referințe
Documentația API poate fi găsită conectându-vă la L2L ca administrator, făcând clic pe pictograma meniului „Asistență” și apoi făcând clic pe „Documentația API”.
Stări piese de schimb:
1. Problema solicitată
2. În proces
3. Finalizat
5. Șters
6. Sincronizat
7. Comandat
8. Primit
10. Kit solicitat
11. Kit rezervat
12. Deplasare piesă solicitată
13. Deplasare piesă aprobată
14. Deplasare piesă expediată
15. Deplasare piesă respinsă
Tipuri de tranzacții:
0. Consum: Utilizat ori de câte ori o piesă de schimb este eliberată prin intermediul unuia dintre ecranele noastre de solicitare a pieselor de schimb.
1. Recepție: Utilizat atunci când piesele sunt primite în sistem printr-o PartOrder
2. Ajustare inventar: Utilizat ori de câte ori o cantitate este modificată în aplicație prin Controlul inventarului. Aceasta poate fi pe ecranul cu detaliile piesei sau pe ecranul cu detaliile locației.
3. Ajustarea costului pieselor primite prin comandă: Utilizată atunci când costul este modificat într-o PartOrder. Această tranzacție va avea loc numai dacă quantity_received din PartOrder este 3e 0. Această tranzacție este utilizată doar pentru a reprezenta o diferență a costurilor de recepție și modul în care aceasta afectează inventarul disponibil.
4. Ajustarea costului pieselor consumate prin comandă: Utilizată atunci când costul este modificat într-o PartOrder și quantity_consumed este 3e 0. Această tranzacție este utilizată în anumite rapoarte de consum, cum ar fi raportul lunar, deoarece reflectă o modificare validă a costurilor de consum care trebuie recunoscută.
5. Consum piesă învechită: Utilizat la eliberarea unei piese care a fost marcată ca învechită. Nu este reflectat în raportul lunar, dar este reflectat în rapoartele obișnuite.
6. Ajustarea costului piesei învechite: Utilizată la marcarea unei piese ca învechită. Costul întregului inventar existent este inclus în această tranzacție și reflectat în raportul lunar. Toate eliberările ulterioare
nu sunt reflectate în acest raport.7. Consum prin deplasarea piesei. Utilizat atunci când o piesă este transferată către un alt amplasament. Celălalt amplasament va avea o tranzacție asociată de recepție prin deplasarea piesei.
8. Recepție prin deplasarea piesei. Utilizat atunci când o piesă este transferată de la un alt amplasament. Celălalt amplasament va avea o tranzacție asociată de consum prin deplasarea piesei.
Întrebări frecvente
1. Nu există o stare a pieselor de schimb pentru „Eroare de sincronizare” sau ceva similar, care să indice depozitului sau departamentului IT că a apărut o problemă la sincronizarea solicitării piesei de schimb cu ERP.
Răspuns: Aveți dreptate, nu există o stare dacă a apărut o problemă în timpul sincronizării. Indicația pentru utilizatorul final că înregistrarea solicitării piesei de schimb nu este sincronizată este faptul că nu are starea „Sincronizat”. Cu alte cuvinte, dacă o piesă nu se sincronizează, aceasta va avea în continuare starea „Problema solicitată” sau „În proces”. Partea dificilă este că o eroare de sincronizare poate apărea în multe locuri. Este chiar posibil să apară o eroare la setarea stării solicitării piesei de schimb. Prin urmare, dacă utilizatorul vede înregistrări de piese de schimb blocate în starea „Problema solicitată” sau „În proces”, ar trebui să știe că există o problemă cu utilitarul de sincronizare.
2. Am ales o categorie de consum nevalidă atunci când am solicitat piesa de schimb (Exemplu: am ales o categorie de consum administrativă pentru o expediere/mașină care nu este administrativă în JDE, astfel încât a generat corect o eroare)a. Din câte pot vedea, nu există nicio modalitate de a edita solicitarea piesei de schimb pentru a schimba categoria de consum. Este corect? Dacă da, cum rezolv problema?
Răspuns: Aveți dreptate, nu puteți schimba o categorie de consum după ce a fost creată o solicitare de piesă de schimb. Ar trebui să anulați solicitarea și să solicitați din nou piesa de schimb. Acesta este procesul preferat atunci când se menține o coadă de piese de schimb de tip „registru”. Dacă o piesă solicitată nu mai este necesară, tehnicianul ar returna piesa în inventar solicitând o cantitate negativă din acea piesă, anulând astfel solicitarea inițială.
3. Pot fi categoriile de consum dinamice, ca în alte zone ale sistemului, unde pot indica L2L că Expedierile pentru mașinile de producție afișează doar categoriile Consumabile sau Reparații, în timp ce Expedierile pentru săli de conferință sau mașini de tuns iarba permit doar categoriile Administrativ sau Clădiri/terenuri?
Răspuns: Categoriile de consum nu sunt dinamice. Dacă trebuie să impuneți legătura dintre categoriile de consum și zone, va trebui să o integrați în instrumentul de integrare.
4. Putem bloca anumite stări ale pieselor de schimb? Nu vreau ca nimeni să schimbe starea din „Finalizat” în „Sincronizat” – doar integrarea ar trebui să poată face acest lucru.
Răspuns: În prezent, nu putem bloca stările pieselor de schimb. De obicei, nu avem probleme cu tehnicienii care aleg starea greșită. În general, gestionăm aceste tipuri de probleme prin antrenament.
5. Putem elimina butonul „Închidere” dacă o solicitare nu are anumite stări?
Răspuns: Butonul „Închidere” va seta starea solicitării piesei de schimb la „Finalizat”. Prin urmare, dacă o piesă de schimb este solicitată, eliberată și închisă înainte ca instrumentul de integrare să o preia, aceasta va apărea în continuare în lista dvs. dacă filtrați după „status__lte=3”. Apoi, după ce instrumentul de integrare a finalizat procesarea, puteți seta starea la 4, sincronizat. A fost creat în acest mod pentru a nu împiedica utilizatorul final să elibereze piese – logica integrării este pur și simplu o reflectare a ceea ce se întâmplă în MRO.
6. Pot crea o singură locație pentru fiecare piesă de schimb. Pot crea mai mult de o locație pentru fiecare piesă de schimb?
Răspuns: Da. Există o setare pe ecranul Piese de schimb → Setări care controlează numărul de locații disponibile pentru o piesă de schimb. Dacă doriți să adăugați mai mult de o locație, asigurați-vă că setarea „Limitare la o singură locație per piesă la sincronizare/import” este dezactivată.