Ecwid koppelen aan APIcenter

Je koppelt Ecwid aan APIcenter met het Store ID en een toegangstoken van je Ecwid-winkel. Je doet dit één keer. Daarna gebruik je Ecwid in al je integraties.

Wat je nodig hebt

• Een Ecwid-winkel.
• Het Store ID van je winkel (Store ID). Je vindt het in de URL van een pagina in de Ecwid-beheeromgeving of in de footer van die pagina.
• Een toegangstoken (access token). Ecwid vraagt voor elk API-verzoek een toegangstoken. Voor je eigen winkel gebruik je het secret token van een custom app. Dit token verloopt niet. Bewaar het veilig en deel het met niemand.

Ecwid heeft geen testmodus. Probeer de koppeling daarom eerst uit met een aparte testwinkel.

Zo krijg je het toegangstoken

1. Open in de Ecwid-beheeromgeving het overzicht van je custom apps (Custom Apps). Na het aanmaken van je Ecwid-account heb je daar al een custom app.
2. Open de Details-pagina van de custom app.
3. Kopieer het secret token.

Is de custom app uit je winkel verwijderd? Klik dan op de Details-pagina op Install en kopieer daarna het token.

Welke rechten de app nodig heeft

Het token geeft alleen toegang tot wat de custom app mag. Een custom app heeft standaard de rechten read_store_profile, read_catalog, update_catalog, create_catalog, read_orders, update_orders en public_storefront. Voor sommige flows heb je meer rechten nodig:

• Verkooporders ophalen: read_orders. APIcenter haalt bij een order ook de producten en, als de order geen factuuradres heeft, de klant op. Daarvoor zijn read_catalog en read_customers nodig.
• Voorraad ophalen: read_catalog.
• Producten sturen: read_catalog, create_catalog en update_catalog.
• Verkooporders sturen: read_orders, create_orders, read_catalog, read_customers en create_customers.
• Voorraad sturen: read_catalog en update_catalog.
• De orderstatussen, verzendopties en betaalopties ophalen: read_store_profile.

De rechten create_orders, read_customers en create_customers staan niet in de standaardrechten van een custom app. Pas je de rechten van de app aan in Ecwid, installeer de app dan opnieuw om de wijziging toe te passen.

Zo koppel je Ecwid

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Ecwid.
2. Vul de velden in die APIcenter toont: het Store ID en het toegangstoken.
3. Sla op en klik op Testverbinding.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Limiet van Ecwid

Ecwid accepteert maximaal 600 verzoeken per minuut per token. Daarboven weigert Ecwid de verzoeken met de fout 429.

Als het niet lukt

Zie Ecwid: veelvoorkomende fouten voor de foutcodes van Ecwid, zoals INVALID_API_TOKEN, STORE_NOT_FOUND en INSUFFICIENT_APP_SCOPE. Zie ook Verbinding of inloggen mislukt.

Volgende stappen

Maak een integratie met Ecwid en controleer de instellingen. Zie Ecwid verbindings- en integratie-instellingen.

Meer informatie van Ecwid zelf staat in Make your first API request en App settings.