🔒 Kræver administrator. Denne handling tilgår en ekstern integration direkte og er kun synlig i SyncTool, når du er logget ind som administrator.
SyncTool kan koble din Sapera-butik sammen med Bosch eBike Connect-portalen (bruges bl.a. for Gazelle og andre Bosch-tilknyttede cykelmærker). Der er tre selvstændige handlinger, som typisk køres planlagt.
De to indberetninger (salg og lagerbeholdning) arbejder kun med produkter fra én bestemt leverandør — den leverandør i Sapera, der repræsenterer producenten. Du peger på den med parameteren SupplierIdentifier. Produkter fra andre leverandører rører handlingerne ikke.
Retning: fra Bosch til en fil — ikke til Bosch. Handlingen henter produktoversigten fra eBike Connect og skriver den til en CSV-fil på den sti, du angiver i ExportPath.
Hvad hentes: Alle produkter, der er tilgængelige for din virksomhed i eBike Connect — også komponenter og reservedele. Data hentes sidevis (100 ad gangen), indtil der ikke er flere.
Filen overskrives ved hver kørsel (første side opretter filen på ny, resten føjes til).
Afgrænses af din CompanyCode og evt. CustomerNumber.
Bemærk: handlingen sender ikke noget til Bosch — den trækker data ud af portalen.
Retning: fra Sapera til Bosch. Kun ændringer. Handlingen indberetter dit nye salg til Bosch, så producenten kan se, hvad der faktisk er solgt ud af butikken.
Kun ændringer siden sidst: SyncTool husker, hvor langt den nåede sidste gang (id'et på den sidst indberettede lagerpostering gemmes), og fortsætter derfra ved næste kørsel. Allerførste kørsel medtager salg fra det seneste døgn.
Hvad medtages: kun udgående posteringer (salg/forbrug) på produkter, hvis leverandør er den konfigurerede Bosch-leverandør. Posteringer på alle andre produkter springes over.
Pr. salg sendes leverandørens varenummer, det solgte antal og — for serienummervarer — stel-/serienummer.
Salget grupperes pr. bilag (salgsdokument).
Retning: fra Sapera til Bosch. Alle varer — fuldt øjebliksbillede. Handlingen indberetter din aktuelle lagerbeholdning til Bosch, så producenten har opdateret tilgængelighed.
Hvilke varer: alle varer, hvor den konfigurerede Bosch-leverandør er hovedleverandør, og som er på lager (lagerantal mindst 1). Det er altså ikke kun ændringer — hele beholdningen sendes hver gang.
Indberetningen overskriver den nuværende beholdning hos Bosch (idempotent), så det er helt sikkert at køre igen.
Pr. vare sendes leverandørens varenummer, det aktuelle lagerantal, evt. stelnumre for serienummervarer, lagertilstand "ny" og dags dato.
Robusthed: hver vare forsøges op til 3 gange ved fejl, og en enkelt vare, der ikke kan indberettes, stopper ikke resten. Timeout pr. kald sættes med RequestTimeoutMinutes (eBike Connect kan til tider være langsom).
Alle tre handlinger deler de samme forbindelsesoplysninger til eBike Connect:
Parameter | Forklaring |
API-endpoint (ApiEndPoint) | Basis-URL'en for eBike Connect-API'et. |
API-version (ApiVersion) | Versionen af eBike Connect-API'et, der skal kaldes. |
Klient-id (ClientId) | Klient-id'et (applikationsnøglen), der bruges til at logge på eBike Connect. |
Klientsprog (ClientLanguage) | Sprogkoden, der sendes til eBike Connect for lokaliserede svar. |
Klienthemmelighed (ClientSecret) | Klienthemmeligheden, der hører sammen med klient-id'et ved godkendelse. |
Virksomhedskode (CompanyCode) | Virksomhedskoden, der identificerer din virksomhed i eBike Connect. |
Virksomhedsnavn (CompanyName) | Virksomhedsnavnet, der vises for din virksomhed i eBike Connect. |
Kundenummer (CustomerNumber) | Dit kundenummer hos eBike Connect-tjenesten (Bosch). |
OAuth2-endpoint (Oauth2Endpoint) | OAuth2-token-endpointet, der bruges til at logge på eBike Connect. |
Timeout for forespørgsel (minutter) (RequestTimeoutMinutes) | Timeout pr. kald i minutter (eBike Connect kan være langsom). |
Kun for de enkelte handlinger:
Parameter | Bruges af | Forklaring |
Eksportsti (ExportPath) | Eksportér katalog | Mappen/filen, hvor den hentede CSV-fil skrives. |
Leverandør-identifikator (SupplierIdentifier) | Salg + lagerbeholdning | Identifikator på den leverandør i Sapera, der repræsenterer Bosch/producenten. Kun varer fra denne leverandør indgår. |
Se også oversigten SyncTool – handlinger.
Vil du vide mere?
Læs mere i disse relaterede artikler:
Standardparametre for alle handlinger
De generelle parametre der findes på de fleste SyncTool-handlinger: styring af trinnet, fejlhåndtering, timeout m.m.
