Kako konfigurirati Apple GSX integraciju?
Fixably integrira koristeći Apple's najnoviji REST API. Naš alat za certifikate generira prilagođene certifikate za korištenje s GSX.
- Bilješke o izdanju
- Nedavno objavljene značajke
- Početak rada
- Upravljanje narudžbama
- Upravljanje zaposlenicima
- Upravljanje kupcima
- Portal za korisnike
- Automatizacije
- Upravljanje zalihama
- Fakturiranje
- Izvještavanje
- Prilagođena polja
- Integracije
- GSX
- Cjenici
- Pošiljke
- Ugovori o uslugama
- Konfiguriranje vašeg okruženja
- Zahtjevi za dijelove
- Dolazna alokacija dijelova
- Rezervacija termina
Table of Contents
Prije postavljanja vaše GSX integracije, pregledajte popis kako biste potvrdili da imate sve potrebne informacije dostupne prije nego što započnete.
Ako ovo nije prvi put da završavate ovaj proces, molimo vas da spremite svoje trenutne datoteke odlaskom na Postavke sustava > Integracije > GSX > Alat za certifikate i kliknite na ikonu datoteka u gornjem desnom kutu. Također kopirajte lozinku.
Nakon što preuzmete datoteke, molimo vas da završite resetiranje certifikata. Upute za to možete pronaći na dnu ovog članka.
Nakon što ste započeli proces i poslali svoj zahtjev Apple NE resetirajte alat za certifikate.
Pristupanje GSX alatu za certifikate
- Koristeći administratorski račun, idite na Fixably početni ekran.
- Odaberite svoje Izbornik korisničkog imena i zatim kliknite Postavke sustava.

- Iz izbornika Postavke, odaberite Integracije i zatim kliknite GSX.

- Pomaknite se dolje i kliknite na gumb Alat za certifikate.
Generiranje CSR datoteka
- Nakon što se alat za certifikate otvori, ispunite sva polja kao što je prikazano u nastavku. Zatim kliknite Kreiraj zahtjev za certifikat kada završite.

- Nakon što unesene informacije budu potvrđene, generira se datoteka zahtjeva za certifikat: certreq_rest.csr. Kliknite na vezu za preuzimanje zahtjeva za certifikat REST API.

- Kliknite na predložak e-pošte. Slijedite upute u predlošku kako biste ispunili zahtjev za e-poštu. Molimo osigurajte da kopirate svog Apple menadžera računa, GSX administratora (ako niste imenovani GSX administrator), i svog Fixably menadžera za uspjeh kupaca. Pobrinite se da je .csr datoteka koju preuzmete priložena e-pošti.
Napomena: Predložak e-pošte otvorit će se u vašem zadnjem klijentu e-pošte. Osigurajte da pošaljete e-poštu s iste e-mail adrese registrirane s GSX.
***** POČETAK UPUTA
*
* 1. Priložite datoteke zahtjeva za certifikat `certreq_rest.csr` i `certreq_soap.csr` iz alata za certifikate ovoj e-pošti.
* 2. Dodajte svoju gsxws@apple.com u polje Za.
* 3. Dodajte svog Apple menadžera za zemlju u polje Cc.
* 4. Dodajte svog GSX administratora računa u polje Cc (ako niste).
* 5. Uklonite ove upute iz predloška.
* 6. Pošaljite e-poštu.
*
***** KRAJ UPUTA
Okruženje: Proizvodnja (REST, SOAP)
GSX broj računa za prodaju: 0000123456
Ime glavnog IT kontakta: [IME KONTAKTA]
E-pošta glavnog IT kontakta: [E-MAIL ADRESA OVDJE]
Broj telefona glavnog IT kontakta: [BROJ TELEFONA OVDJE]
Ime(i) glavnog poslovnog kontakta za komunikaciju vezanu uz API: [IME KONTAKTA]
E-mail adresa(e) glavnog poslovnog kontakta za komunikaciju vezanu uz API: [E-MAIL ADRESA OVDJE]
Staticka IP adresa(e) izlaznog poslužitelja koje šalju zahtjeve u GSX proizvodno okruženje web usluga: 209.50.52.238
Staticka IP adresa(e) izlaznog poslužitelja koje šalju zahtjeve u GSX testno okruženje web usluga: 209.50.52.238
Staticka IP adresa(e) izlaznog poslužitelja koje šalju zahtjeve u proizvodnju raspoređivača termina: 209.50.52.238
Staticka IP adresa(e) izlaznog poslužitelja koje šalju zahtjeve u testno okruženje raspoređivača termina: 209.50.52.238
Pregled dizajna sustava: [Primjenjivo i potrebno za interno/prilagođeno razvijanje]
Popis API-ja koji treba integrirati: [Primjenjivo i potrebno za interno/prilagođeno razvijanje]
Rješenje za integraciju treće strane: Naziv tvrtke i proizvoda: Fixably
Završavanje zahtjeva za certifikat
Nakon što primite dovršene certifikate od Apple, datoteke treba učitati u alat za certifikate kako bi se generirale datoteke certifikata koje se mogu koristiti s Fixably.
- Ponovno idite na alat za certifikate odlaskom na Postavke sustava > Integracije > GSX > Alat za certifikate. Odaberite .pem datoteku klikom na ikonu dokumenta desno od polja i kliknite Učitaj kada završite.

- Napomena: Ne preimenujte niti uređujte naziv datoteke. Apple ga isporučuje u očekivanom formatu.
Instalacija certifikata
- Nakon što se datoteka certifikata učita, preuzmite .p12 datoteke certifikata iz Koraka 4 i kopirajte lozinku certifikata.

- Ponovno idite na Postavke sustava.
- Iz izbornika Postavke, odaberite Integracije i zatim GSX.
- Ispunite informacije o Sold-To i Ship-To. Osigurajte da je odabrano ispravno GSX okruženje, obično Proizvodnja. Učitajte REST certifikat generiran u Koraku 3 i unesite lozinku u gumb “Promijeni lozinku”.

- Ako se nalazite u području koje koristi države ili provincije, odaberite potvrdni okvir pored Korištena država ako nije već odabran.
- Odaberite Tipove popravaka koje koristi vaše poslovanje. Svi tipovi popravaka koji nisu odabrani neće biti vidljivi prilikom kreiranja popravka.
- Kada završite, kliknite Spremi postavke.
Postavljanje GSX korisničkih postavki
- Iz Fixably početnog ekrana, idite na Korisničke postavke.

- Kliknite Proširi pored naslova GSX kako biste vidjeli postavke GSX na temelju korisnika.

- Unesite svoj Apple ID i Tehnički ID kao što je prikazano iznad. Generirajte Aktivacijski token klikom na vezu Zatraži novi aktivacijski token klikom ovdje.
- Kliknite Spremi postavke kada završite.
Napomena: Aktivacijski tokeni će isteći i bit će potrebno povremeno ih regenerirati.
Postavljanje zajedničkog GSX pristupa
Ako korisnik nema osobni GSX pristup, Fixably omogućuje pretraživanje uređaja i informacija dijeljenjem GSX računa. Omogućite ovu funkciju ako koristite Portal za kupce ili imate unutarnje osoblje koje možda nema osobni GSX račun.
- Idite na Postavke sustava/Integracije/GSX računi.
- Kliknite na trokut otkrivanja pored računa korisnika koji želite podijeliti. Zatim kliknite Podijeli ovaj račun.
- Ako vaše poslovanje ima više Lokacija, osigurajte da Zajednički račun ima pristup svim lokacijama u Apple MyAccess.
Testiranje GSX integracije
Nakon što su sve postavke konfigurirane, posljednji korak je potvrditi da Fixably ispravno komunicira s GSX.
- Idite na Postavke sustava/Integracije/GSX.
- Zatim kliknite Testiraj vezu kako biste pokrenuli tester integracije.

- Pregledajte status pored svakog koraka veze.
Konfiguriranje postavki GSX temeljenih na lokaciji
- Idite na Postavke sustava/Lokacije.
- Kliknite na naziv Lokacija.
- Unesite GSX Sold-To i Ship-To brojeve u predviđena polja.

- Kada završite, kliknite Spremi.
Otklanjanje uobičajenih pogrešaka
-
Greška: 1. Sold-to je postavljen, nevažeći ili nedostaje broj sold to.
- Potvrdite da je ispravan broj Sold-to unesen u Koraku 4. Ponovno pokrenite test nakon validacije broja Sold-to.
-
Greška: 2. Okruženje je odabrano. Nevažeća ili nedostaje postavka okruženja.
- Potvrdite da je ispravna postavka okruženja konfigurirana u Koraku 4. Obično bi ovo trebalo biti postavljeno na Proizvodnju, osim ako nije drugačije navedeno od strane Fixably podrške.
-
Greška: 3. Certifikat je učitan. Certifikat nedostaje.
- Datoteka certifikata iz Koraka 3 je ili nevažeća ili nedostaje. Potvrdite da je ispravan certifikat učitan i da je lozinka ispravna.
-
Greška: 4. Testiranje povezivanja na GSX poslužitelj u Test Connection.
- To se obično događa jer Apple nije stavio na bijelu listu IP adrese Fixably. Kontaktirajte tim za web usluge GSX kako biste potvrdili zahtjev za stavljanje na bijelu listu poslan u Koraku 2.
-
Greška: 5. Testiranje autentifikacije koristeći zajednički GSX račun.
- Nema korisnika konfiguriranog za zajednički GSX. Idite na Postavke sustava/Integracije/GSX Računi kako biste omogućili barem jedan zajednički račun.
-
Greška: Aktivacijski token je nevažeći. Novi se mora zatražiti.
- To se može dogoditi jer korisnički Apple ID nema dodijeljene dozvole za web usluge. Potvrdite putem MyAccess da su ispravne dozvole dodijeljene i zatim zatražite novi aktivacijski token.
- To se može dogoditi jer korisnički Apple ID nema dodijeljene dozvole za web usluge. Potvrdite putem MyAccess da su ispravne dozvole dodijeljene i zatim zatražite novi aktivacijski token.
Resetiranje alata za certifikate
- Ako je potreban novi certifikat ili ako ste upute dobili od Fixably podrške, administratori mogu resetirati alat za certifikate klikom na Resetiraj ovaj alat.

- Ova akcija nepovratno briše sve pohranjene podatke iz alata za certifikate.
- Obavezno preuzmite i spremite sve datoteke certifikata i lozinke na sigurnom mjestu prije resetiranja alata.