Shopify: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Shopify ziet. Je opent haar met Hulp bij deze fout. Zoek de melding en volg de stappen.

Gaat het om inloggen in het algemeen, een gepauzeerde of gestopte flow, of opnieuw proberen? Zie dan Verbinding of inloggen mislukt, Flow gepauzeerd of gestopt en Mislukte records en opnieuw proberen.

Fouten van APIcenter

Executed GraphQL query response contains errors!

Oorzaak: Shopify heeft op een aanvraag van APIcenter een fout teruggegeven. De fouten van Shopify staan in de activiteit onder errors. Een mogelijke reden is een recht dat de app in Shopify mist, bijvoorbeeld read_orders of write_inventory.

Oplossing:

1. Open de activiteit en lees de fout van Shopify onder errors.
2. Mist de app een recht? Voeg de scope toe in Shopify, release een nieuwe versie van de app en installeer die. Zie Shopify koppelen aan APIcenter.
3. Klik bij de Shopify-verbinding op Testverbinding en probeer het record opnieuw.

Failed to create product with SKU / Failed to update product with SKU

Oorzaak: Shopify heeft het product geweigerd. De reden staat in de activiteit onder userErrors.

Oplossing:

1. Open de activiteit en lees userErrors.
2. Pas het veld aan dat Shopify noemt, in de bronapplicatie of onder Data mapping van de flow Producten naar Shopify sturen.
3. Probeer het product opnieuw.

Not allowed to update product

Oorzaak: Het product bestaat al in Shopify en de instelling Update existing products staat uit. APIcenter werkt bestaande producten dan niet bij.

Oplossing:

1. Open de flow Producten naar Shopify sturen en ga naar het tabblad Instellingen.
2. Zet Update existing products aan en sla op.
3. Probeer het product opnieuw.

Found multiple products with the same SKU

Oorzaak: APIcenter vond meer dan één product in Shopify voor dezelfde SKU. De SKU moet uniek zijn per product en per variant.

Oplossing:

1. Zoek de producten die in de melding staan in Shopify.
2. Maak de SKU of het veld Product type uniek.
3. Controleer de keuze bij Use SKU to search for van de flow. Zie Producten naar Shopify sturen.

Product not found

Oorzaak: APIcenter vindt het product of de variant niet in Shopify. Dit kan bij de flows voor verzendingen, voorraad en verkoopprijzen.

Oplossing:

1. Controleer of het product of de variant in Shopify bestaat, met precies deze SKU of barcode.
2. Maak het product eerst aan, bijvoorbeeld met Producten naar Shopify sturen.
3. Controleer de keuze bij Use SKU to search for in de flow.
4. Probeer het record opnieuw. Zie Mislukte records en opnieuw proberen.

Options [...] exceeds limit of 3

Oorzaak: Een variant heeft meer dan 3 opties. Shopify staat maximaal 3 opties per product toe.

Oplossing: Verminder het aantal opties in de bronapplicatie of onder Data mapping van de flow Producten naar Shopify sturen en probeer het opnieuw.

Options [...] not found

Oorzaak: Het product in Shopify heeft een optie die de variant in de gegevens niet heeft, of de waarde van die optie is leeg. Shopify staat geen lege optiewaarden toe.

Oplossing: Zorg dat elke variant dezelfde opties heeft als het product, met een waarde voor elke optie. Probeer het product opnieuw.

Inventory levels containing 'on_hand' quantity in combination with ... will result into conflicts!

Oorzaak: In dezelfde voorraadgegevens staat on_hand samen met available, committed, damaged, quality_control, reserved of safety_stock.

Oplossing: Stuur on_hand alleen, of stuur de andere hoeveelheden zonder on_hand. incoming mag wel samen met on_hand. Pas de koppeling aan onder Data mapping van de flow Voorraad naar Shopify sturen.

The selected order type ... is not supported

Oorzaak: De instelling Send Order as heeft een andere waarde dan Order of Draft Order.

Oplossing:

1. Open de flow Verkooporders naar Shopify sturen en ga naar het tabblad Instellingen.
2. Kies Order of Draft Order bij Send Order as en sla op.
3. Probeer de order opnieuw.

Failed to create order with reference / Failed to update order

Oorzaak: Shopify heeft de bestelling geweigerd. De reden staat in de activiteit onder userErrors.

Oplossing:

1. Open de activiteit en lees userErrors.
2. Pas het veld aan dat Shopify noemt, in de bronapplicatie of onder Data mapping. Een bekende reden is een orderregel zonder aantal.
3. Probeer de order opnieuw. Zie Verkooporders naar Shopify sturen.

Error sending request to finalize salesOrder

Oorzaak: APIcenter heeft de conceptbestelling aangemaakt, maar Shopify kon die niet afronden. Dit gebeurt als Make from a a draft order a finalized order aanstaat.

Oplossing:

1. Open de activiteit en lees de fout van Shopify.
2. Controleer de conceptbestelling in Shopify. Rond de bestelling daar zelf af, of los de fout op.
3. Wil je de conceptbestelling niet afronden? Zet dan Make from a a draft order a finalized order uit.

Failed to create customer / Failed to update customer

Oorzaak: Shopify heeft de klant geweigerd. De reden staat in de activiteit.

Oplossing:

1. Open de activiteit en lees de fout van Shopify.
2. Pas het veld aan dat Shopify noemt, in de bronapplicatie of onder Data mapping.
3. Probeer de klant opnieuw. Zie Klanten naar Shopify sturen.

Phone number is already in use

Oorzaak: Het telefoonnummer van de klant hoort in Shopify al bij een andere klant. APIcenter laat een telefoonnummer maar bij één klant toe.

Oplossing:

1. Zoek in Shopify de klant met dit telefoonnummer.
2. Controleer of dit dezelfde klant is als in de bronapplicatie. Pas anders het telefoonnummer in de bronapplicatie aan.
3. Probeer de klant opnieuw.

The order identifier supplied in the data cannot be found / No order information could be found for order

Oorzaak: De flow voor verzendingen vindt geen bestelling in Shopify met het ordernummer uit de gegevens. APIcenter zoekt op de naam van de bestelling.

Oplossing:

1. Controleer of de bestelling in Shopify bestaat.
2. Controleer onder Data mapping van de flow Verzendingen naar Shopify sturen of het ordernummer klopt, zoals #1001.
3. Probeer de verzending opnieuw.

Order is already shipped / The specified orderline ... is already marked as shipped

Oorzaak: In Shopify is niets meer te verzenden: de bestelling of de orderregel heeft geen open fulfillment order meer.

Oplossing:

1. Open de bestelling in Shopify en controleer de status.
2. Is de bestelling al verzonden? Dan is er niets meer te doen.
3. Is de bestelling niet verzonden, maar krijg je toch deze melding? Controleer of de SKU in de verzending klopt.

The order line with sku ... in the shipment more than the open quantity

Oorzaak: Het aantal in de verzending is groter dan het open aantal van de orderregel in Shopify.

Oplossing: Pas het aantal in de bronapplicatie aan of laat het aantal leeg om het open aantal te verzenden. Probeer de verzending opnieuw.

Inventory could not be activated for location

Oorzaak: APIcenter kon de variant niet activeren op een locatie, omdat de locatie ongeldig is. De voorraadwijzigingen voor die locatie zijn overgeslagen. Dit staat in het flowresultaat.

Oplossing:

1. Controleer het locatie-ID in de voorraadgegevens, of de instelling Set the default location for your stock van de flow.
2. Zoek de locatie in Shopify en gebruik het juiste ID.
3. Probeer de voorraad opnieuw. Zie Voorraad naar Shopify sturen.

Failed to set metafield / Failed to set publishable

Oorzaak: Het product is aangemaakt of bijgewerkt, maar Shopify weigerde een metafield of de publicatie. De reden staat in het flowresultaat.

Oplossing:

1. Lees de melding in het flowresultaat. Shopify noemt het veld en de reden.
2. Pas de waarde van het metafield aan.
3. Stuur het product opnieuw.

The following fields are required and need to be present in the data

Oorzaak: In de gegevens ontbreekt een verplicht veld. De melding noemt het veld. Dit zijn de verplichte velden per flow: het e-mailadres bij klanten, de referentie bij verkooporders, de SKU bij producten en verkoopprijzen, het ordernummer bij verzendingen en de SKU of barcode bij voorraad.

Oplossing:

1. Vul het veld in de bronapplicatie in.
2. Controleer onder Data mapping van de flow dat het veld aan het juiste veld is gekoppeld.
3. Probeer het record opnieuw.

Fouten van Shopify

Shopify geeft fouten terug met een code. Die staat in de activiteit.

ACCESS_DENIED of Invalid API key or access token

Oorzaak: Shopify weigert het token van de app: het is ongeldig, verlopen of ingetrokken, of de app is verwijderd.

Oplossing:

1. Controleer in Shopify of de app is geïnstalleerd.
2. Maak zo nodig een nieuw token. Bij een oudere custom app uit het Shopify-beheer kan dat alleen door de app te deïnstalleren en opnieuw te installeren. Bij een app uit het Dev Dashboard vraagt een ontwikkelaar een nieuw token aan. Zo'n token verloopt na 24 uur.
3. Werk de gegevens van de verbinding in APIcenter bij en klik op Testverbinding. Zie Shopify koppelen aan APIcenter en Verbinding of inloggen mislukt.

THROTTLED of MAX_COST_EXCEEDED

Oorzaak: Er zijn te veel aanvragen gedaan, of een aanvraag is te zwaar. Shopify rekent met kostpunten. APIcenter rekent met een emmer van 1000 punten die met 50 punten per seconde weer vol loopt. Shopify kan per abonnement andere waarden hebben.

Oplossing:

1. Wacht even. APIcenter wacht zelf tussen aanvragen en probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen.
2. Komt het vaak voor? Verlaag het aantal items per run bij Amount to process van de flow.

SHOP_INACTIVE, 402, 403 of 423

Oorzaak: De winkel is niet beschikbaar voor de API. Shopify noemt hiervoor deze redenen: de winkel is bevroren omdat een openstaand saldo niet is betaald (402), de winkel is geblokkeerd (403), of de winkel is vergrendeld (423, bijvoorbeeld als een winkel de limieten herhaaldelijk overschrijdt).

Oplossing: Controleer de status van je winkel in Shopify en neem zo nodig contact op met Shopify. Probeer het daarna opnieuw.

INTERNAL_SERVER_ERROR of 5xx

Oorzaak: Shopify heeft een storing.

Oplossing: Wacht en probeer het later opnieuw. Zie Mislukte records en opnieuw proberen. De status van Shopify staat op de statuspagina van Shopify.

Bestellingen van meer dan 60 dagen geleden ontbreken

Oorzaak: Zonder het recht read_all_orders geeft Shopify alleen bestellingen van de afgelopen 60 dagen.

Oplossing: Voeg read_all_orders toe aan de app in Shopify, release een nieuwe versie en installeer die. Zie Shopify koppelen aan APIcenter.

Meer over de limieten en foutcodes van Shopify staat in de documentatie van de GraphQL Admin API en op de limieten van Shopify.