DanDomain
Forbind en DanDomain-webshop, så AI-klienter kan læse ordrer, produkter, kategorier og kunder, og opdatere lager, ordrestatus og tracking.
Eksempelspørgsmål
Prøv at spørge din AI-klient
-
Which DanDomain orders arrived in the last 7 days?
-
What is the stock count for product number 1001?
-
Find the customer with email shopper@example.com.
-
Write a draft order-state change for order 4521 - do not apply it yet.
-
List root categories in the connected webshop.
Overblik
Forbind en DanDomain Webshop 8, så AI-klienter kan læse ordrer, produkter, kategorier og kunder, og opdatere lager, ordrestatus og tracking via REST API v2.
Integrationen bruger shoppens egen API-nøgle. stackgate.ai har ikke en delt DanDomain-app eller OAuth-klient.
Forudsætninger
- En DanDomain Webshop 8 med API-adgang
- Rettighed til Indstillinger → Integration i shop-admin
- En stackgate.ai-konto
Classic / HostedShop SOAP-API'er understøttes ikke.
Sådan får du credentials
- Log ind på DanDomain shop-admin for den webshop, du vil forbinde.
- Åbn Indstillinger → Integration.
- Opret en API-nøgle og kopiér den. Gem shoppens HTTPS-adresse (for eksempel
https://myshop.dk). - I stackgate.ai: Mine integrationer → DanDomain.
- Indsæt shop-URL og API-nøgle, og gem. stackgate.ai verificerer nøglen mod shoppens
/admin/WEBAPI/v2/orders-endpoint. - Brug evt. Edit tool access for kun at tillade læseværktøjer.
Se DanDomain API-dokumentation. Det live v2-skema for en shop findes også på {shop}/admin/WEBAPI/swagger/ui/index.
Godkendelse er HTTP Basic med tomt brugernavn og API-nøglen som adgangskode. Læg ikke nøglen i URL'en.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/dandomainmed Sanctum bearer token - Private gateway: én config til alle integrationer - brug
dandomain__*-navngivne værktøjer
Eksempel-prompter:
- "Hvilke DanDomain-ordrer er kommet de seneste 7 dage?"
- "Hvad er lagerantallet for varenummer 1001?"
- "Find kunden med e-mail shopper@example.com."
- "List rod-kategorier i den forbundne webshop."
Fejlfinding
- 422 integration not configured - udfyld shop-URL og API-nøgle under Mine integrationer.
- 401 Unauthorized - opret en ny API-nøgle under Indstillinger → Integration og opdater Mine integrationer.
- HTTPS er påkrævet - brug
https://shop-adresser. HTTP-adresser afvises. - Could not reach the shop API - tjek at hostnavnet er den live webshop, ikke et internt admin-hostnavn.
- 403 Forbidden - nøglen mangler måske API-adgang. Opret den igen i shop-admin.
- 429 Too many requests - vent kort og prøv igen.
Sikkerhed og tilbagekaldelse
Afbryd DanDomain under Mine integrationer for at slette den gemte nøgle i stackgate.ai. Slet eller rotér også nøglen under Indstillinger → Integration i shop-admin.
Begrænsninger
- Opret eller slet af ordrer og kunder er ikke inkluderet.
- Billedkonvertering (
convertImages) og webhook-styring er ikke inkluderet. - App Store partner-install / OAuth er ikke påkrævet. Forbind med shop-URL og API-nøgle.
- SOAP Classic / HostedShop-API'er er uden for scope.
Tilgængelige værktøjer
-
list_orders
List DanDomain-ordrer i et datointerval.
-
get_order
Hent en DanDomain-ordre efter ID.
-
list_order_states
List ordrestatusser konfigureret i webshoppen.
-
list_products
List DanDomain-produkter med valgfri filtre.
-
get_product
Hent et DanDomain-produkt efter varenummer.
-
list_categories
List DanDomain-kategorier, evt. filtreret på overkategori.
-
get_category
Hent en DanDomain-kategori efter ID.
-
get_customer
Hent en DanDomain-kunde efter ID.
-
get_customer_by_email
Find en DanDomain-kunde efter e-mail.
-
list_customer_groups
List kundegrupper i webshoppen.
-
set_order_state
Sæt status på en DanDomain-ordre.
-
set_track_number
Sæt trackingnummer på en DanDomain-ordre.
-
complete_order
Markér en DanDomain-ordre som afsluttet.
-
set_stock_count
Sæt lagerantal for et DanDomain-varenummer.
-
update_product
Opdater felter på et DanDomain-produkt.
MCP-endpoint:
https://stackgate.ai/mcp/dandomain
(HTTP) eller via
private gateway.