stackgate.ai
Log ind Opret profil
Alle integrationer

Gelato

Søg i Gelato-kataloget, beregn fragt og opret eller annuller printordrer via MCP. Angiv butiks-id pr. kald, så én nøgle dækker flere butikker.

Manual setup 18 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Which Gelato catalogs can I print from?

  • Quote a poster to Copenhagen before I place anything.

  • Did the draft order for Jack ever get tracking?

  • Write a product title for the new poster template - do not publish it.

  • Show stock for the card product I am about to order.

Overblik

Forbind Gelato print-on-demand, så AI-klienter kan søge i kataloget, tjekke priser og lager, beregne fragt og oprette eller annullere printordrer med din Gelato API-nøgle.

Én API-nøgle dækker alle butikker på kontoen. Send store_id med hvert butikskald. Der gemmes ikke et butiks-id.

Nye forbindelser starter med læseværktøjer. Slå Write til under Edit tool access, før du opretter eller annullerer ordrer. create_order opretter som standard et udkast. confirm_draft_order er det kald, der sender udkastet i produktion. En Gelato-konto med betalingsmetode printer og sender en live ordre. Brug en konto uden betalingsmetode, når du vil prøve API'et uden at printe.

Forudsætninger

  • En Gelato-konto
  • En API-nøgle fra Gelato-dashboardet
  • En stackgate.ai-konto
  • Butiks- og skabelon-id kopieret fra dashboardet, når du bruger butiksværktøjer (Gelato har ikke list-stores eller list-templates)

Sådan får du adgang

  1. Log ind i Gelato-dashboardet.
  2. Åbn Developer, API Keys og opret en nøgle.
  3. Kopiér nøglen med det samme. Den vises kun én gang.
  4. I stackgate.ai: Mine integrationer → Gelato.
  5. Indsæt API-nøglen og gem. stackgate.ai verificerer nøglen med GET /v3/catalogs og gemmer den krypteret.
  6. Lad Write være slået fra, indtil du er klar til at oprette eller annullere ordrer. Slå det til under Edit tool access.

Forbind Gelato med den nøgle. Se How do I add, remove, deactivate, or replace an API key?. Gelato bruger de samme API-værter til test og live. En konto uden betalingsmetode er den sikre måde at prøve ordrer på.

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Credentials-reference

Felt Påkrævet Hvor finder du det Noter
API-nøgle Ja Developer, API Keys Gemmes krypteret. Sendes som X-API-KEY.

Butiks-id og skabelon-id er værktøjsargumenter, ikke gemte credentials.

Rettigheder

Scope Hvad det tillader Adgang
Read Kataloger, priser, lager, forsendelsesmetoder, tilbud, ordrer, butiksprodukter og skabeloner Læs
Write Oprette udkast eller live ordrer, bekræfte udkast, annullere ordrer og udgive butiksprodukter fra skabeloner Skriv

Gelato bruger ikke OAuth i dette connect-flow. Nøglen er din. stackgate.ai lægger ikke en hub-kvote oven i Gelatos grænse på ca. 100 forespørgsler pr. sekund pr. nøgle.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/gelato med Sanctum bearer token
  • Private gateway: én config til alle integrationer - brug gelato__*-navngivne værktøjer

Eksempel-prompter:

  • "List mine Gelato-kataloger og søg efter plakater."
  • "Beregn fragt på en 50x70-plakat til København. Opret ikke ordren."
  • "Søg i mine Gelato-ordrer fra denne uge og opsummér status."
  • "Opret et Gelato-udkast til denne plakat. Bekræft det ikke."
  • "List produkter i butik abc og i butik def."
  • "Hent Gelato-skabelon tmpl-42 og foreslå en titel. Udgiv den ikke."

Værktøjer

Læs:

  • list_catalogs, get_catalog, search_products, get_product
  • get_product_prices, get_cover_dimensions, get_stock_availability
  • list_shipment_methods, quote_order
  • search_orders, get_order
  • list_store_products, get_store_product, get_template

Skriv:

  • create_order (standard er udkast)
  • confirm_draft_order
  • cancel_order
  • create_store_product

Fejlfinding

Problem Sandsynlig årsag Løsning
422 integration not configured Formularen er ikke gemt Gem API-nøglen under Mine integrationer
401 Unauthorized Forkert eller roteret nøgle Opret en ny nøgle under Developer, API Keys og forbind igen
403 Forbidden Nøglen er inaktiv Bekræft at nøglen er aktiv i Gelato-dashboardet
404 Not found Forkert katalog-, produkt-, ordre-, butiks- eller skabelon-id Kopiér id fra dashboardet eller fra et tidligere værktøjssvar
429 Too many requests Mere end ca. 100 forespørgsler pr. sekund på nøglen Vent og prøv igen
Write-værktøj mangler Forbindelsen er stadig kun Read Slå Write til under Edit tool access
Ordren blev printet order_type var order, eller et udkast blev bekræftet, på en konto der kan trækkes Foretræk udkast, og brug en konto uden betalingsmetode til prøver

Sikkerhed og tilbagekaldelse

  • Afbryd Gelato under Mine integrationer for at slette den gemte API-nøgle fra stackgate.ai.
  • Deaktiver nøglen i Gelato-dashboardet, hvis du mistænker lækage.
  • Ordre- og tilbudssvar kan indeholde modtagernavn, e-mail, telefon og leveringsadresse. Foretræk ordre-id og status i opsummeringer.
  • stackgate.ai krypterer API-nøglen og gemmer ikke ordre- eller adressepayloads i hubben.

Begrænsninger

  • Ingen Gelato Network, webhooks, wallet eller upload af printfiler. Printfiler er HTTPS-URL'er på ordren.
  • Ingen list-stores eller list-templates. Kopiér de id'er fra dashboardet og send store_id pr. kald.
  • Ordreredigering er begrænset til at bekræfte et udkast og annullere før produktion.
  • Live ordrer på en konto med betalingsmetode bliver opfyldt af Gelato.

Tilgængelige værktøjer

  • list_catalogs

    List Gelato-produktkataloger.

  • get_catalog

    Hent et Gelato-katalog og de attributter, du kan filtrere på.

  • search_products

    Søg produkter i et Gelato-katalog.

  • get_product

    Hent et Gelato-produkt efter produkt-uid.

  • get_product_prices

    Hent priser for et Gelato-produkt.

  • get_cover_dimensions

    Hent cover-mål for et Gelato-produkt.

  • get_stock_availability

    Tjek regional lagerstatus for Gelato-produkt-uid.

  • list_shipment_methods

    List Gelato-forsendelsesmetoder for et land.

  • quote_order

    Beregn produktpris og fragt. Opretter ikke en ordre.

  • search_orders

    Søg i Gelato-ordrer. Leveringsadresser i svaret er persondata.

  • get_order

    Hent en Gelato-ordre efter id, inkl. varer og forsendelse.

  • create_order

    Opret en Gelato-ordre. Standard er udkast, så den ikke går i produktion.

  • confirm_draft_order

    Gør et Gelato-udkast til en live ordre.

  • cancel_order

    Annuller en Gelato-ordre, før den går i produktion.

  • list_store_products

    List produkter i en Gelato-butik. store_id vælger butikken.

  • get_store_product

    Hent et produkt fra en Gelato-butik.

  • get_template

    Hent en Gelato-produktskabelon efter id.

  • create_store_product

    Opret et produkt i en Gelato-butik ud fra en skabelon.

MCP-endpoint: https://stackgate.ai/mcp/gelato (HTTP) eller via private gateway.

Opret konto Dokumentation