Koppelhandleiding

CCV Shop verbinden met OrderSyncer

Maak in CCV Shop een API-sleutel aan en vul de gegevens in bij je koppeling in OrderSyncer. Hieronder vind je de stappen, de benodigde rechten en afbeeldingen van de instellingen.

Zo maak je een CCV Shop API-sleutel

Screenshots uit de proefwinkel, vastgelegd op 14 oktober 2026. API-gegevens zijn afgeschermd.

  1. Log in op de onderhoudstool van je eigen CCV Shop.

    Het inlogscherm van de CCV Shop-onderhoudstool.
    Het inlogscherm van de CCV Shop-onderhoudstool. Klik op de afbeelding om te vergroten.
  2. Open App Store, zoek de app “Api” van CCV Shop en installeer deze. Staat er “Deïnstalleren”? Dan is de app al geïnstalleerd.

    De app Api van CCV Shop. Deïnstalleren betekent dat deze al is geïnstalleerd.
    De app Api van CCV Shop. Deïnstalleren betekent dat deze al is geïnstalleerd. Klik op de afbeelding om te vergroten.
  3. Ga naar Mijn webshop › Instellingen › Algemeen › API gegevens en klik op Nieuwe API key.

    Mijn webshop → Instellingen → Algemeen. Rechts staat API gegevens.
    Mijn webshop → Instellingen → Algemeen. Rechts staat API gegevens. Klik op de afbeelding om te vergroten.
    Klik rechtsboven op Nieuwe API key. Bestaande sleutels staan in het overzicht; de codes zijn afgeschermd.
    Klik rechtsboven op Nieuwe API key. Bestaande sleutels staan in het overzicht; de codes zijn afgeschermd. Klik op de afbeelding om te vergroten.
  4. Vul op het tabblad Algemeen bij API Naam “OrderSyncer” in. CCV Shop vult de API Key en API Secret voor je in.

    Algemeen: API Naam, API Key en API Secret. De automatisch ingevulde codes zijn afgeschermd.
    Algemeen: API Naam, API Key en API Secret. De automatisch ingevulde codes zijn afgeschermd. Klik op de afbeelding om te vergroten.
  5. Open het tabblad Rechten en schakel Volledige toegang uit. Selecteer GET bij orders, orderrows, products, attributecombinations, returns en returnrows. Selecteer PATCH bij orders, products en attributecombinations.

    Rechten: laat Volledige toegang uit. De kolommen zijn GET, POST, PATCH en DELETE. Bij attributecombinations staan GET en PATCH aan.
    Rechten: laat Volledige toegang uit. De kolommen zijn GET, POST, PATCH en DELETE. Bij attributecombinations staan GET en PATCH aan. Klik op de afbeelding om te vergroten.
    Verder omlaag: orderrows heeft GET; orders heeft GET en PATCH.
    Verder omlaag: orderrows heeft GET; orders heeft GET en PATCH. Klik op de afbeelding om te vergroten.
    Products heeft GET en PATCH. Returnrows en returns hebben alleen GET. Laat de andere getoonde regels uit.
    Products heeft GET en PATCH. Returnrows en returns hebben alleen GET. Laat de andere getoonde regels uit. Klik op de afbeelding om te vergroten.
    Op WebHook rechten hoef je niets aan te vinken.
    Op WebHook rechten hoef je niets aan te vinken. Klik op de afbeelding om te vergroten.
  6. Kopieer de API Key en API Secret uit het tabblad Algemeen en klik op TOEPASSEN. Controleer in het overzicht API gegevens of “OrderSyncer” erbij staat.

    Klik onderaan op TOEPASSEN om de sleutel en rechten op te slaan.
    Klik onderaan op TOEPASSEN om de sleutel en rechten op te slaan. Klik op de afbeelding om te vergroten.
    Controleer daarna het overzicht API gegevens. Onze eerder opgeslagen sleutel heet OrderSyncer demo; zoek hier je eigen gekozen naam.
    Controleer daarna het overzicht API gegevens. Onze eerder opgeslagen sleutel heet OrderSyncer demo; zoek hier je eigen gekozen naam. Klik op de afbeelding om te vergroten.
  7. Vul in OrderSyncer je webshop-URL, API-sleutel en API-secret in en klik op Verbind met CCV Shop. Gebruik alleen de HTTPS-URL van je webshop, bijvoorbeeld https://jouwshop.ccvshop.nl, zonder /onderhoud of /api.

    Kies CCV Shop in OrderSyncer en vul je webshop-URL, API-sleutel en API-secret in.
    Kies CCV Shop in OrderSyncer en vul je webshop-URL, API-sleutel en API-secret in. Klik op de afbeelding om te vergroten.
Rechten per resource in CCV Shop
ResourceGETPATCH
ordersAanAan
orderrowsAanUit
productsAanAan
attributecombinationsAanAan
returnsAanUit
returnrowsAanUit

POST, DELETE, WebHook rechten en Volledige toegang zijn niet nodig.

Kom je bij OPSLAAN of TOEPASSEN op het inlogscherm? Log opnieuw in en controleer het overzicht API gegevens. Staat de sleutel er niet, maak hem opnieuw aan en sla hem op. Alleen een ingevuld formulier betekent nog niet dat de sleutel is opgeslagen.

OrderSyncer stuurt verzendstatus, tracking en annuleringen terug zonder de automatische statusmail van CCV Shop te versturen. Regel klantmeldingen via je vervoerder of verstuur ze zelf vanuit CCV Shop.

Je kunt een bestelling over meerdere pakketten verdelen. CCV Shop krijgt de status verzonden pas na het laatste pakket. CCV Shop bewaart één trackingcode per bestelling: de code van het laatst verwerkte pakket vervangt de vorige.

Gebruik hele aantallen voor bestellingen én voorraad. Een voorraad zoals 34,5 kan niet worden geïmporteerd of gesynchroniseerd. Bij een product met decimale voorraad stopt ook de catalogusimport of het overnemen van voorraad; controleer dit eerst in CCV Shop.

Nieuwe bestellingen worden elke minuut gecontroleerd. Oudere openstaande bestellingen worden in groepen gecontroleerd; bij een grote achterstand kan dit meerdere minuten duren. Oude, later afgeronde winkelwagens en wijzigingen in oude afgehandelde bestellingen worden bij de volledige controle elk uur meegenomen. Bestellingen die op betaling wachten blijven geblokkeerd, ook bij een historische import.

Wijzig je na import de producten of het adres van een bestelling in CCV Shop? OrderSyncer blokkeert de verwerking om dubbele voorraadmutaties en verkeerde labels te voorkomen. Annuleer een nog niet verzonden bestelling in CCV Shop en maak daar zo nodig een nieuwe bestelling aan.

Retouren aanmaken, afhandelen en crediteren doe je in CCV Shop. OrderSyncer neemt de retourstatus over.

Bekijk wat je na het verbinden kunt doen met de CCV Shop koppeling, of lees meer over voorraad synchroniseren.