Gå til hovedinnhold

[Ordremottak – GCW] Integrere GelatoConnect med Cloudprinter

Juliana Maciel Maruri da Cunha avatar
Skrevet av Juliana Maciel Maruri da Cunha
Oppdatert for over 2 uker siden

Velkommen til guiden for å koble sammen Gelato Connect med Cloudprinter. Med denne integrasjonen kan du enkelt la de to plattformene snakke sammen, slik at du mottar bestillinger fra Cloudprinter og behandler dem effektivt via GelatoConnect. Følg disse enkle stegene for å sette opp integrasjonen, så kan du begynne å håndtere Cloudprinter-bestillinger på minutter eller timer – ikke måneder.

Det er 3 steg for å motta og behandle Cloudprinter-bestillinger med GelatoConnect:

  1. Sett opp API-integrasjon for å gjøre kommunikasjon mulig.

  2. Legg til Cloudprinter sitt produktutvalg i GelatoConnect.

  3. Sett opp produksjonsflyt for smidig prosessering.


Steg 1: Koble til API

Første steg er å koble sammen systemene via API. Da kan ordrer og oppdateringer flyte mellom GelatoConnect og Cloudprinter.

  1. Lag produksjons- og signalgrensesnitt i Cloudprinter:

    • I Cloudprinter-kontoen din, opprett et produksjonsgrensesnitt med navnet «GelatoConnect API – Dev»: Velg malen «Din egen API». I vert-feltet skriver du bare inn «www.gelato.com», og i IP-adressefeltet skriver du «184.169.223.162». Konfigurer resten etter Cloudprinters hjelpeside. Sett dette opp i «testmodus» og lav prioritet, slik at ikke ekte bestillinger begynner å gå gjennom denne tilkoblingen.

    • I Cloudprinter-kontoen din, opprett et Signals-grensesnitt med navnet «GelatoConnect Signals – Dev». Sett dette til lav prioritet, siden det bare skal brukes til testing.

  2. Opprett kunde «Cloudprinter» i GelatoConnect:

    • Logg inn på GelatoConnect.

    • Gå til Kunder-delen i menyen til venstre.

    • Klikk på Opprett kunde og gi kunden navnet Cloudprinter.

    • Velg Bruk forhåndsinnstilling for Cloudprinter for å laste inn innstillingene automatisk.

    • I vinduet som vises, kopier og lim inn API-nøklene fra Produksjon og Signals-grensesnittene du opprettet i Cloudprinter i steg 1.

  3. Godkjenn kommunikasjon:

    • GelatoConnect lager en endepunktvert når du legger inn API-nøklene i pop-up-vinduet

    • Kopier denne endepunktadressen og lim den inn i «Host»-feltet i produksjonsgrensesnittet (bytt ut det midlertidige vertsnavnet «www.gelato.com» du la til i steg 1).

  4. Lag kobling for fraktmetode:

    • Lag et oppslag i GelatoConnect for å koble Cloudprinter-fraktmetoder til Gelato-fraktmetoder. Følg instruksjonene i her og bruk den vedlagte Excel-filen for å gjøre koblingen.

    • I bestillingsmalen din kan det hende du må bytte ut følgende rad nederst i malen:

      "shipmentMethodUid": ##{{ order.shipping.method|js }},

      med:

      "shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},

      hvor «alias» viser til malfeltet som er satt som ##{{alias}} i oppslaget ditt.

Når alt er klart, er systemene synkronisert. De nødvendige API-endepunktene for oppgaver som å sende inn og oppdatere bestillinger er forhåndsinnstilt, så kommunikasjonen går av seg selv.


Steg 2: Slik setter du opp Cloudprinter-produkter

Deretter importerer du Cloudprinter sitt produktkatalog til GelatoConnect.

1. Gå til produktmodeller:

  • Gå til Produkter-delen i menyen til venstre og klikk på Produktmodeller.

  • Klikk på Legg til fra katalog > Legg til fra kunde, og velg Cloudprinter.

2. Last ned referansefiler fra Cloudprinter:

  • Åpne en ny fane og logg inn på Cloudprinter-kontoen din.

  • Gå til Produktkatalog > Last ned referanser.

  • Last ned de to nødvendige filene: Produktreferanse og Alternativreferanse.

3. Last opp referansefilene i GelatoConnect:

  • Dra og slipp de nedlastede filene inn i opplastingsområdet i GelatoConnect.

  • GelatoConnect viser alle produktene som er satt opp i Cloudprinter-kontoen din.

4. Velg produktkategorier:

  • Se gjennom produktlisten (den vil variere avhengig av din Cloudprinter-konto).

  • Velg hvilke kategorier du vil produsere, for eksempel brevpapir, brosjyrer og lignende.

5. Koble papirtyper:

  • Velg riktige papirtyper for hvert produkt.

  • Hvis du har egne avtaler med Cloudprinter om personlig tilpasset lager, kan du justere tilordningen her.

  • Ellers anbefaler vi å bruke standardinnstillingene.

6. Lag produkter og varianter:

  • Klikk på Fortsett for å lage de valgte produktmodellene.

  • GelatoConnect oppretter automatisk produkter med tilknyttede attributter og interne produkt-ID-er for produksjon.

Når du er ferdig, kan du se det opprettede produktet og sjekke detaljer som papirkvalitet, etterbehandlingsvalg og produkt-ID-er.


Steg 3: Slik setter du opp produksjonsflyt

Til slutt, sett opp eller oppdater arbeidsflyter så de passer til produksjonen din.

  1. Gå til produksjonsinnstillinger:

    • Bruk verktøyet for produksjonskonfigurasjon i GelatoConnect for å definere produksjonstrinn (for eksempel trykking, laminering, innbinding) for hver produktkategori (for eksempel visittkort, heftede bøker).

    • Sørg for at alle Cloudprinter-formater har en produksjonskonfigurasjon som er definert og aktiv

For detaljerte instruksjoner og en video om hvordan du setter opp produksjonsoppsett, kan du sjekke det aktuelle steget i onboarding-guiden her.


Steg 4: Aktiver live-ordrer fra Cloudprinter

  1. Lag testbestillinger via Cloudprinters Test Center eller ved å samarbeide direkte med Cloudprinter-teamet. Sjekk at bestillingen og filen er klare for produksjon.

  2. Send fraktpriser til Cloudprinter

    1. Be om å få tilsendt den redigerbare prislisten for Cloudprinter fra din GelatoConnect Implementation Manager

    2. Fyll ut skjemaet og send de oppdaterte fraktratene dine til Cloudprinter ved oppstart av onboarding – og deretter hvert år etter endringer i transportørens priser.

  3. Informer Cloudprinter-teamet om testprosessen og få samtykke til å overføre live-bestillinger til GelatoConnect.

  4. Bytt til å motta bestillinger i sanntid i GelatoConnect:

    1. Opprett et nytt produksjonsgrensesnitt med navnet «GelatoConnect API – Prod». Bruk de samme parameterne som for «GelatoConnect API – Dev»-tilkoblingen du laget tidligere, men sett høyeste prioritet og «Live-modus» for å motta de ekte bestillingene.

    2. Bytt tidligere produksjonsgrensesnitt til «Testmodus» slik at bestillinger ikke havner der lenger.

    3. Opprett et nytt Signals-grensesnitt med navnet «GelatoConnect Signals - Prod». Bruk de samme parameterne som for «GelatoConnect Signals - Dev»-tilkoblingen du laget tidligere, men sett høyeste prioritet slik at det brukes til live bestillinger.

Svarte dette på spørsmålet?