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ă.

Spares_Integration_Workflow.jpg

 

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:

  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=3
    1. Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.

  2. Inserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.

    1. Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.

  3. 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]
    1. Parametri POST: status=6

      1. Consultaț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”.

  1. 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. Proprietatea synchronized_on a solicitării de piese de schimb returnate va fi utilizată la pasul următor ca parametru de interogare lastupdated__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=1
  2. 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]&lastupdated__gte=[time of last sync]&order_by=lastupdated
  1. Inserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.

    1. Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.

  2. Setați data synchronized_on pe î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ă pentru synchronized_on. Dacă nu stocați local momentul ultimei sincronizări reușite, setați synchronized_on la valoarea lastupdated î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]
  1. 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_on la ora UTC curentă atunci când setați starea la synchronized. 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:

  1. 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.

  2. Actualizați fiecare piesă de schimb în L2L.

    POST https://[customer].leading2lean.com/api/1.0/billofmaterials/inbound_sync/?auth=[api key]
    1. Parametri POST: site=[site]&partnumber=[part number]&description=[description]&location=[location]&quantity=[quantity]&minimum=[minimum]&optimum=[optimum]&cost=[cost]

    2. Consultați documentația API pentru lista completă a parametrilor.

  3. 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.

    1. 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]
    2. Dezactivați locațiile neutilizate și setați quantity la 0. (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]
      1. Parametri POST: site=[site]&partnumber=[part number]&location=[location]&quantity=0&active=false

  4. Opțional: Adăugați informațiile furnizorului la piesă.

    1. Obțineți ID-ul furnizorului

      GET https://[customer].leading2lean.com/api/1.0/vendors/?auth=[api key]&site=[site id]&name=[vendor name]
    2. Adăugați o înregistrare nouă

      POST https://l2l.leading2lean.com/api/1.0/billofmaterialsvendor/?auth=[api key]
      1. 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:

  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]&status__lte=3
    1. Consultați lista stărilor pieselor de schimb din secțiunea de referințe de mai jos.

  2. 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]
  3. 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

  4. Inserați fiecare înregistrare a solicitării de piese de schimb în sistemul ERP ca înregistrare de consum.

    1. Atașați înregistrarea de consum ERP la Ordonanța de lucru ERP.

  5. 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]
    1. Parametri POST: status=6

      1. Consultaț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:

  1. 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]
  2. 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]
  3. 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.

    1. 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]
      1. 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ă.