Gegevenswoordenlijst voor winkelmigratie

Deze pagina is afgedrukt op May 09, 2024. Ga voor de huidige versie naar https://help.shopify.com/nl/partners/building-stores-for-merchants/data-dictionary.

De gegevenswoordenlijst voor winkelmigratie bevat informatie over de Customer-, Order- en Producthulpbronnen van REST in de Shopify-beheercentrum-API. De gegevenswoordenlijst is aanvullend referentiemateriaal voor ervaren Partners die winkels migreren naar Shopify.

Op deze pagina

Customer broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de Customerhulpbron REST in de Shopify-beheercentrum-API.

Gegevens over belangrijke eigenschappen omtrent REST, de hulpbron voor klanten
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte Veldtoegang Cruciaal vereist veld
accepts_marketing Default: 0 Of de klant heeft ingestemd met het ontvangen van marketingmateriaal. Boolean tinyint(1) Y
accepts_marketing_
updated_at		 De datum en tijd in ISO 8601-indeling waarop de klant instemde met of bezwaar maakte tegen het ontvangen van marketingmateriaal per e-mail. DateTime
adressen Een lijst met adressen die aan de klant zijn gekoppeld. [{ Address }]
valuta; De drielettercode in ISO 4217-indeling voor de valuta die de klant heeft gebruikt bij de betaling van diens laatste bestelling. String De valuta van de winkel alleen-lezen
created_at Default: NULL De datum en tijd in ISO 8601-indeling wanneer de klant aan de winkel werd toegevoegd. DateTime datetime alleen-lezen
default_address Het standaardadres voor de klant. { Address }
e-mail Default: NULL Het unieke e-mailadres van de klant. String varchar(255)
first_name Default: NULL De voornaam van de klant. String varchar(255)
id Default: NULL Een wereldwijd unieke ID. (Deze waarde neemt automatisch toe.) Geheel getal bigint(20) Y
last_name Default: NULL De achternaam van de klant. String varchar(255)
last_order_id Default: NULL De ID van de laatste bestelling van de klant. Geheel getal bigint(20) alleen-lezen
last_order_name Default: NULL De naam van de laatste bestelling van de klant. String alleen-lezen
metaveld Default: NULL Geeft een metaveld terug met behulp van de naamruimte en de sleutel die bij de bron hoort. { Metafield }
marketing_opt_
in_level
  • null
  • single_opt_in
  • confirmed_opt_in
  • onbekend
Default: NULL		 Het toestemmingsniveau van het marketingabonnement (zoals beschreven in de richtlijn voor best practices van M3AAWG) dat de klant heeft opgegeven toen deze ermee instemde om marketingmateriaal per e-mail te ontvangen. String, enum
multipass_identifier Default: NULL Een unieke ID voor de klant die wordt gebruikt voor het aanmelden met Multipass. String varchar(255)
Opmerking Default: NULL Een aantekening over de klant. String mediumtext
orders_count Default: 0 Het totale aantal bestellingen dat de klant ooit in de winkel heeft geplaatst. Geheel getal int(11) alleen-lezen
telefoon Default: NULL Het unieke (voor de hele winkel) telefoonnummer (E.164-indeling) voor deze klant. String varchar(255)
sms_marketing_
consent		 Default: NULL De huidige staat voor sms-marketing voor het telefoonnummer van de klant. String
state
  • disabled
  • invited
  • ingeschakeld
  • afgewezen
Default: disabled		 De staat van het account van de klant bij de winkel. String, enum varchar(255) alleen-lezen
tags Default: NULL Een door komma's gescheiden lijst met maximaal 250 tags die aan de klant zijn toegevoegd. String 255 per tag
tax_exempt Default: 0 Of de klant is vrijgesteld van het betalen van belasting op bestellingen. Boolean tinyint(1) Y
tax_exemptions Raadpleeg de hulpbron voor Klant voor een volledige lijst met waarden. De lijst met belastingvrijstellingen die op de klant zijn toegepast. String
total_spent Default: 0 Het totale bedrag dat de klant ooit aan bestellingen heeft uitgegeven. Vermeld in winkelvaluta. Als meerdere valuta worden gebruikt, wordt het bedrag weergegeven in de standaard valuta zonder wisselkoers. Nummer decimal(21,3) alleen-lezen
updated_at De datum en tijd waarop de klant voor het laatst is bijgewerkt. Gebaseerd op de tijdzone van de winkel. DateTime datetime alleen-lezen
verified_email Default: 1 Of de klant diens e-mailadres heeft geverifieerd. Staat standaard op 'waar' als de klant wordt aangemaakt via het Shopify-beheercentrum of -API. Boolean tinyint(1) alleen-lezen

CustomerAddress broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de hulpbron REST in de Shopify-beheercentrum-API CustomerAddress. Er zijn geen cruciale verplichte velden voor deze hulpbron.

Gegevens over belangrijke eigenschappen omtrent REST, de hulpbron voor klantadressen
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte Veldtoegang
adres1 Default: NULL Het postadres van de klant. 100 per klantaccount. String varchar(255)
adres2 Default: NULL Een extra veld voor het postadres van de klant. String varchar(255)
stad Default: NULL De woonplaats van de klant. String varchar(255)
bedrijf Default: NULL Het bedrijf van de klant. String varchar(255)
land Default: NULL Het land van de klant. String varchar(255)
first_name Default: NULL De voornaam van de klant. String varchar(255)
country_code De tweeletterige landcode die overeenkomt met het land van de klant. String alleen-lezen
country_name De genormaliseerde landnaam van de klant. String
last_name Default: NULL De achternaam van de klant. String varchar(255)
naam De voor- en achternaam van de klant. String
telefoon Default: NULL Het telefoonnummer van de klant op dit adres. String varchar(255)
provincie Default: NULL De naam van de regio van de klant. Meestal een provincie, een staat of een prefectuur. String varchar(255)
province_code De tweeletterige regiocode van de klant. String alleen-lezen
postcode Default: NULL De postcode van de klant, ook wel bekend als zip, Eircode, enz. String varchar(255)

Order broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de Orderhulpbron REST in de Shopify-beheercentrum-API.

Gegevens over belangrijke eigenschappen van de bestellingshulpbron REST
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte Veldtoegang Cruciaal vereist veld
app_id Default: NULL De ID van de app die de bestelling heeft aangemaakt. integer bigint(20) alleen-lezen
billing_address Default: NULL Het postadres dat aan de betaalmethode is gekoppeld. Dit adres is een optioneel veld dat niet beschikbaar is voor bestellingen waarvoor geen betaalmethode nodig is. integer bigint(20)
browser_ip Het IP-adres van de browser die door de klant werd gebruikt toen deze de bestelling plaatste. Zowel IPv4 als IPv6 worden ondersteund. tekenreeks varchar(255) alleen-lezen
buyer_accepts_marketing Default: 0 Of de klant toestemming heeft gegeven om e-mailupdates van de winkel te ontvangen. boolean tinyint(1)
cancel_reason
  • klant
  • fraude
  • voorraad
  • afgewezen
  • overige
Default: NULL		 De reden waarom de bestelling is geannuleerd tekenreeks varchar(255)
cancelled_at Default: NULL De datum en tijd waarop de bestelling werd geannuleerd. Geeft null weer als de bestelling niet is geannuleerd. date datetime alleen-lezen
cart_token Default: NULL Een unieke waarde wanneer verwezen wordt naar de winkelwagen die aan de bestelling is gekoppeld. tekenreeks varchar(255) alleen-lezen
checkout_token Default: NULL Een unieke waarde bij het verwijzen naar de checkout die aan de bestelling is gekoppeld. tekenreeks varchar(64) alleen-lezen
client_details
  • accept_language
  • browser_height
  • browser_ip
  • browser_width
  • session_hash
  • user_agent
 Informatie over de browser die de klant heeft gebruikt toen deze diens bestelling plaatste:

accept_language: de talen en landinstellingen die de browser begrijpt.
browser_height: de hoogte van het browserscherm in pixels, indien beschikbaar.
browser_ip: het IP-adres van de browser.
browser_width: de breedte van het browserscherm in pixels, indien beschikbaar.
session_hash: een hash van de sessie.
user_agent: gegevens van de browsende client, inclusief software en besturingssystemen.		 object alleen-lezen
closed_at Default: NULL De datum en tijd (ISO 8601-indeling) waarop de bestelling werd gesloten. Geeft null weer als de bestelling niet is gesloten. date datetime alleen-lezen
created_at Default: NULL De automatisch gegenereerde datum en tijd (ISO 8601-indeling) waarop de bestelling werd aangemaakt in Shopify. De waarde van deze eigenschap kan niet worden gewijzigd. date datetime(6) alleen-lezen
valuta; Default: NULL De drielettercode (ISO 4217-indeling) voor de valuta van de winkel. tekenreeks char(3)
current_subtotal_price De huidige subtotaalprijs van de bestelling in de valuta van de winkel. De waarde van dit veld geeft bewerkingen van bestellingen, retouren en terugbetalingen weer. tekenreeks varchar(255) alleen-lezen
current_subtotal_price_set De huidige subtotaalprijs van de bestelling in winkel- en presentatievaluta. De bedragen gekoppeld aan dit veld geven bewerkingen van bestellingen, retouren en terugbetalingen weer. object alleen-lezen
current_total_discounts De huidige totale kortingen op de bestelling in de valuta van de winkel. De waarde van dit veld geeft bewerkingen van bestellingen, retouren en terugbetalingen weer. tekenreeks varchar(255) alleen-lezen
current_total_discounts_set De huidige totale kortingen op de bestelling in winkel- en presentatievaluta. De bedragen gekoppeld aan dit veld geven bewerkingen van bestellingen, retouren en terugbetalingen weer. object alleen-lezen
current_total_duties_set De huidige totale douanerechten die zijn berekend over de bestelling in winkel- en presentatievaluta. De bedragen gekoppeld aan dit veld geven bewerkingen van bestellingen, retouren en terugbetalingen weer. object alleen-lezen
current_total_price De huidige totaalprijs van de bestelling in de valuta van de winkel. De waarde van dit veld geeft bewerkingen van bestellingen, retouren en terugbetalingen weer. tekenreeks varchar(255) alleen-lezen
current_total_price_set De huidige totaalprijs van de bestelling in winkel- en presentatievaluta. De bedragen gekoppeld aan dit veld geven bewerkingen van bestellingen, retouren en terugbetalingen weer. object alleen-lezen
current_total_tax De huidige totale belastingen die zijn berekend over de bestelling in de valuta van de winkel. De waarde van dit veld geeft bewerkingen van bestellingen, retouren en terugbetalingen weer. tekenreeks varchar(255) alleen-lezen
current_total_tax_set De huidige totale belastingen die zijn berekend over de bestelling in winkel- en presentatievaluta. De bedragen gekoppeld aan dit veld geven bewerkingen van bestellingen, retouren en terugbetalingen weer. object alleen-lezen
klant Default: NULL Informatie over de klant. De bestelling heeft mogelijk geen klant en apps mogen niet afhankelijk zijn van het bestaan van een klantobject. Deze waarde is mogelijk null als de bestelling is aangemaakt via Shopify POS integer bigint(20)
customer_locale Default: NULL De twee- of drieletterige taalcode, eventueel gevolgd door een regiomodificator. tekenreeks varchar(255) alleen-lezen
discount_applications Een geordende lijst met gestapelde kortingsapplicaties.

De eigenschap discount_applications bevat 3 typen: discount_code, manual en script. Alle 3 typen hebben een gemeenschappelijke structuur en hebben bepaalde typespecifieke attributen.		 array alleen-lezen
discount_codes Een lijst met kortingen die op de bestelling zijn toegepast. array
e-mail Het e-mailadres van de klant. varchar(255)
estimated_taxes Of de belastingen op de bestelling worden geschat. Veel factoren kunnen veranderen tussen het moment dat een klant een bestelling plaatst en het moment waarop de bestelling wordt verzonden, wat van invloed kan zijn op de berekening van de belastingen. Deze eigenschap geeft 'false' weer wanneer de belastingen op de bestelling definitief zijn en niet onderhevig zijn aan wijzigingen. boolean tinyint(1)
financial_status
  • in behandeling
  • authorized
  • partially_paid
  • betaald
  • partially_refunded
  • refunded
Default: NULL		 De status van betalingen die aan de bestelling zijn gekoppeld. Kan alleen worden ingesteld wanneer de bestelling is aangemaakt. tekenreeks varchar(255) alleen-lezen
fulfillment_status
  • afgehandeld
    • openstaand
  • null
  • gedeeltelijk
  • restocked
Default: unfulfilled		 De status van de bestelling wat betreft afgehandelde orderregels. tekenreeks varchar(255)
fulfilments Een reeks fulfilments die aan de bestelling zijn gekoppeld array
id Default: NULL De ID van de bestelling, gebruikt voor API-doeleinden. Dit is anders dan de eigenschap order_number. Dit is de ID die wordt gebruikt door de winkeleigenaar en klant. integer bigint(20) alleen-lezen
landing_site Default: NULL De URL voor de pagina waarop de koper is terechtgekomen toen deze de winkel binnenkwam. tekenreeks varchar(4096) alleen-lezen
line_items Een lijst met orderregelobjecten, die elk informatie over een artikel in de bestelling bevatten array Y
location_id Default: NULL De ID van de fysieke locatie waar de bestelling werd verwerkt. Gebruik de hulpbron FulfillmentOrder als je de locatie wilt controleren bij een bestelling. integer bigint(20)
naam Default: NULL De bestellingsnaam, gegenereerd door de eigenschap order_number te combineren met de voor- en achtervoegsels van de bestelling die zijn ingesteld in de algemene instellingen van de merchant. Dit is anders dan de eigenschap ID; dat is de ID van de bestelling die door de API wordt gebruikt. Dit veld kan ook door de API worden ingesteld als een tekenreekswaarde. tekenreeks varchar(255)
Opmerking Default: NULL Een optioneel bericht dat een winkeleigenaar aan de bestelling kan toevoegen. tekenreeks
note_attributes Default: NULL Extra informatie die aan de bestelling is toegevoegd. Verschijnt in het gedeelte Aanvullende gegevens van een pagina met bestelgegevens. Elke matrix-invoer moet een hash met naam- en waardesleutels bevatten. tekenreeks
number Default: NULL De positie van de bestelling in het aantal bestellingen van de winkel. Getallen zijn opeenvolgend en beginnen bij 1. integer int(11) alleen-lezen
order_number De positie van de bestelling in het aantal bestellingen beginnend bij 1001. Bestelnummers zijn opeenvolgend. integer bigint(20) alleen-lezen
order_status_url De URL die naar de webpagina van de bestelstatus verwijst, indien van toepassing. tekenreeks varchar(255) alleen-lezen
original_total_duties_set De oorspronkelijke totale douanerechten die zijn berekend over de bestelling in winkel- en presentatievaluta. object alleen-lezen
payment_gateway_names Default: NULL De lijst met betalingsgateways die zijn gebruikt voor de bestelling.
 varchar(255) alleen-lezen
payment_terms Default: NULL De algemene voorwaarden waaronder een betaling moet worden verwerkt. object bigint(20) alleen-lezen
telefoon Default: NULL Het telefoonnummer van de klant voor het ontvangen van sms-meldingen. tekenreeks varchar(255)
presentment_currency Default: NULL De presentatievaluta die werd gebruikt om de prijzen aan de klant weer te geven. tekenreeks char(3)
processed_at Default: NULL De datum en tijd (ISO 8601-indeling) waarop een bestelling werd verwerkt. Deze waarde is de datum die verschijnt op je bestellingen en die wordt gebruikt in de analytische rapporten. Als je bestellingen importeert vanuit een app of een ander platform, dan kun je processed_at instellen op een datum en tijd in het verleden die overeenkomen met het moment waarop de oorspronkelijke bestelling is aangemaakt. date datetime(6)
processing_method
  • checkout
  • direct
  • handmatig
  • offsite
  • express
  • gratis
 Hoe de betaling is verwerkt tekenreeks varchar(255) alleen-lezen
referring_site Default: NULL De website waarop de klant op een link naar de winkel heeft geklikt. tekenreeks varchar(4096)
terugbetalingen Een lijst met terugbetalingen die op de bestelling zijn toegepast array alleen-lezen
shipping_address Default: NULL Het postadres waar de bestelling naar wordt verzonden. Dit adres is optioneel en is niet beschikbaar voor bestellingen waarvoor geen verzending is vereist integer bigint(20)
shipping_lines Een matrix met objecten, die elk een gebruikte verzendmethode weergeven. array
source_name Default: NULL Waar de bestelling vandaan kwam. Kan alleen worden ingesteld tijdens het aanmaken van de bestelling en kan daarna niet meer worden geschreven. Waarden voor Shopify-kanalen zijn beschermd en kunnen niet worden toegewezen door andere API-cliënten: web, pos, shopify_draft_order, iphone en android. Bestellingen die via de API zijn aangemaakt, kunnen elke andere tekenreeks van je keuze toegewezen krijgen. Als nieuwe bestellingen niet gespecificeerd zijn, krijgen ze de waarde van de ID van je app toegewezen. tekenreeks varchar(255)
subtotal_price De prijs van de bestelling in de valuta van de winkel na kortingen, maar vóór verzending, douanerechten, belastingen en fooien. integer bigint(20)
subtotal_price_set Het subtotaal van de bestelling in winkel- en presentatievaluta na kortingen, maar vóór verzending, douanerechten, belastingen en fooien. object
tags Tags gekoppeld aan de bestelling, ingedeeld als een tekenreeks door komma's gescheiden waarden. Tags zijn aanvullende korte beschrijvingen, vaak gebruikt voor filteren en zoeken. Elke individuele tag is beperkt tot 40 tekens lang. tekenreeks varchar(4096)
tax_lines Een matrix van belastingregelobjecten, die elk een belasting weergeven die van toepassing is op de bestelling. Elk object heeft de volgende eigenschappen:

Bij het maken van een bestelling via de API kunnen belastingregels worden opgegeven op de bestelling of de orderregels, maar niet beide. Belastingregels die in de bestelling zijn opgegeven, worden gesplitst over de belastbare orderregels in de aangemaakte bestelling.		 array
taxes_included
  • true
  • false
Default: 0		 Of belastingen zijn opgenomen in het subtotaal van de bestelling. boolean tinyint(1)
test
  • true
  • false
Default: 0		 Of dit een testbestelling is. boolean tinyint(1) alleen-lezen
token Default: NULL Een unieke waarde bij het verwijzen naar de bestelling. tekenreeks varchar(32) alleen-lezen
total_discounts Default: 0 De totale kortingen die zijn toegepast op de prijs van de bestelling in de valuta van de winkel. tekenreeks decimal(21,3)
total_discounts_set De totale kortingen die zijn toegepast op de prijs van de bestelling in de winkel- en presentatievaluta. object
total_line_items_price Default: 0 De som van alle orderregelprijzen in de valuta van de winkel. tekenreeks decimal(21,3)
total_line_items_price_set Het totaal van alle orderregelprijzen in de winkel- en presentatievaluta. object
total_outstanding Default: 0 Het totale openstaande bedrag van de bestelling in de valuta van de winkel. tekenreeks decimal(21,3)
total_price Default: 0 De som van alle orderregelprijzen, kortingen, verzendkosten, belastingen en fooien in de valuta van de winkel. Moet positief zijn. tekenreeks decimal(21,3)
total_price_set De totale prijs van de bestelling in de winkel- en presentatievaluta. object
total_shipping_price_set De totale verzendkosten van de bestelling, exclusief kortingen en retouren, in de winkel- en presentatievaluta. Als taxes_included is ingesteld op 'true', dan is total_shipping_price_set inclusief belastingen. object
total_tax Default: 0 De som van alle belastingen die op de bestelling zijn toegepast in de valuta van de winkel. Moet positief zijn. tekenreeks decimal(21,3)
total_tax_set De totale belasting die op de bestelling is toegepast in de winkel- en presentatievaluta. object
total_tip_received De som van alle fooien in de bestelling in de valuta van de winkel. integer bigint(20) alleen-lezen
total_weight Default: 0 De som van de gewichten van alle orderregels in grammen. De som wordt niet aangepast als artikelen uit de bestelling worden verwijderd. integer bigint(20) unsigned
updated_at De datum en tijd (ISO 8601-indeling) waarop de bestelling voor het laatst werd aangepast. date datetime(6) alleen-lezen
user_id Default: NULL De ID van de gebruiker die is ingelogd bij Shopify POS en die de bestelling heeft verwerkt, indien van toepassing. integer bigint(20)

Product broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de Producthulpbron REST in de Shopify-beheercentrum-API.

Gegevens over belangrijke eigenschappen van de producthulpbron REST
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte Veldtoegang Cruciaal vereist veld
body_html Default: NULL Een beschrijving van het product. Ondersteunt HTML-indeling. tekenreeks mediumtext
created_at Default: NULL De datum en tijd (ISO 8601-indeling) waarop het product werd aangemaakt. date datetime alleen-lezen
handle Default: NULL tekenreeks varchar(255)
id Default: NULL Een unsigned 64-bit geheel getal dat wordt gebruikt als een unieke ID voor het product. Elke ID is uniek in het Shopify-systeem. Geen twee producten zullen hetzelfde ID hebben, zelfs niet als ze uit verschillende winkels komen. integer bigint(20) alleen-lezen Y
afbeeldingen Een lijst met productafbeeldingsobjecten, die elk een afbeelding vertegenwoordigen die aan het product is gekoppeld. [{ product_image }]
opties De aangepaste producteigenschappen. Bijvoorbeeld Maat, Kleur en Materiaal. Elk product kan maximaal 3 opties hebben en elke optiewaarde kan maximaal 255 tekens zijn. Productvarianten zijn gemaakt van combinaties van optiewaarden. Opties kunnen niet worden gemaakt zonder waarden. Om een nieuwe optie te maken, moet ook een variant met een bijbehorende optiewaarde worden gemaakt. array
product_type Default: NULL Een categorisatie voor het product die wordt gebruikt bij het filteren en zoeken van producten. tekenreeks varchar(255)
published_at Default: NULL De datum en tijd (ISO 8601-indeling) waarop het product werd gepubliceerd. Kan als null worden ingesteld om het product niet langer op het Online Store-kanaal te publiceren. date datetime
published_scope
  • web
  • global
 Of het product is gepubliceerd op het Point of Sale-kanaal. tekenreeks
status
  • actief
  • opgeslagen
  • concept
Default: active		 De status van het product. tekenreeks varchar(32)
tags Een tekenreeks door komma's gescheiden tags die worden gebruikt voor filteren en zoeken. Een product kan maximaal 250 tags bevatten. Elke tag kan maximaal 255 tekens bevatten. tekenreeks
template_suffix Default: NULL Het achtervoegsel van de Liquid-template dat wordt gebruikt voor de productpagina. Als deze eigenschap wordt gespecificeerd, gebruikt de productpagina een template met de naam 'product.suffix.liquid', waarbij 'suffix' de waarde van deze eigenschap is. Als deze eigenschap '' of null is, gebruikt de productpagina de standaardtemplate 'product.liquid'. tekenreeks varchar(255)
titel Default: NULL De naam van het product tekenreeks varchar(255)
updated_at Default: NULL De datum en tijd (ISO 8601-indeling) waarop het product voor het laatst werd gewijzigd. De waarde updated_at van een product kan om verschillende redenen veranderen. Als een bestelling bijvoorbeeld wordt geplaatst voor een product met voorraadtracking, dan wordt de voorraadwijziging geteld als een wijziging. date datetime alleen-lezen
varianten Een matrix van productvarianten, die elk een andere versie van het product vertegenwoordigen. De positie-eigenschap is alleen-lezen. De positie van varianten wordt aangegeven door de volgorde waarin ze worden vermeld. array
vendor Default: NULL De naam van de verkoper van het product. tekenreeks varchar(255)

ProductImage broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de hulpbron REST in de Shopify-beheercentrum-API ProductImage. Er zijn geen alleen-lezen- of cruciale verplichte velden voor deze hulpbron.

Gegevens over belangrijke eigenschappen met betrekking tot de hulpbron REST ProductImage
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte
created_at Default: NULL De datum en tijd waarop de productafbeelding werd aangemaakt. De API geeft deze waarde weer in de indeling ISO 8601. date datetime
height Default: NULL Hoogteafmeting van de afbeelding die bij het uploaden wordt bepaald. smallint(4) unsigned
id Default: NULL Een unieke, numerieke id voor de productafbeelding. (auto_increment) integer bigint(20)
position Default: 0 De volgorde van de productafbeeldingen in de lijst. De eerste productafbeelding staat op positie 1 en is de 'hoofd'-afbeelding voor het product. smallint(5) unsigned
product_id Default: NULL De ID van het product dat aan de afbeelding is gekoppeld. bigint(20)
src Geeft de locatie van de productafbeelding op. Deze parameter ondersteunt URL-filters die je kunt gebruiken om aangepaste exemplaren van de afbeelding op te halen. Voeg bijvoorbeeld _small toe aan de bestandsnaam om een geschaalde kopie van de afbeelding op te halen van 100 x 100 px (bijvoorbeeld ipod-nano_small.png) of voeg _2048x2048 toe om een kopie van de afbeelding op te halen met een px-resolutie van 2048 x 2048 (bijvoorbeeld ipod-nano_2048x2048.png).
updated_at Default: NULL De datum en tijd waarop de productafbeelding voor het laatst werd gewijzigd. De API geeft deze waarde weer in de indeling ISO 8601. date datetime
variant_ids Een matrix met variant-ID's die aan de afbeelding zijn gekoppeld.
breedte Default: NULL Breedteafmeting van de afbeelding die wordt bepaald bij het uploaden. smallint(4) unsigned

ProductVariant broneigenschappen

In de volgende tabel staat wat nuttige informatie over de eigenschappen van de hulpbron REST in de Shopify-beheercentrum-API ProductVariant. Er zijn geen cruciale verplichte velden voor deze hulpbron.

Gegevens over belangrijke eigenschappen met betrekking tot de hulpbron REST ProductVariant
Eigenschappen Waarden Beschrijving Gegevenstype Veldlengte Veldtoegang
barcode Default: NULL De barcode, UPC of het ISBN-nummer van het product. varchar(255)
compare_at_price Default: NULL De oorspronkelijke prijs van het artikel vóór een aanpassing of een verkoop. decimal(20,2)
created_at Default: NULL De datum en tijd in ISO 8601-indeling waarop de productvariant werd aangemaakt. date datetime
fulfillment_service
  • handmatig
  • { handle of fulfillment service }
Default: manual 		De fulfilmentservice die aan de productvariant is gekoppeld. varchar(255)
grams Het gewicht van de productvariant in grammen.
id Default: NULL De unieke, numerieke id voor de productvariant. Deze waarde neemt automatisch toe. bigint(20)
image_id Default: NULL De unieke, numerieke id voor de afbeelding van een product. De afbeelding moet aan hetzelfde product zijn gekoppeld als de variant. bigint(20)
inventory_item_id De unieke id voor het voorraadartikel, die wordt gebruikt in de voorraad-API om query's te sturen voor voorraadgegevens.
inventory_management
  • shopify
  • null
  • { handle of fulfillment service }
    • Default: NULL     		De fulfilmentservice die het aantal artikelen op voorraad voor de productvariant volgt. varchar(255)
    inventory_policy
    • deny
    • continue
    Default: deny    		 Of klanten een bestelling voor de productvariant mogen plaatsen als deze niet op voorraad is. varchar(40)
    inventory_quantity Default: 1 Een samengestelde voorraad voor alle locaties. Gebruik de hulpbron InventoryLevel om voorraad op een specifieke locatie aan te passen. int(11) alleen-lezen
    option De aangepaste eigenschappen die een winkeleigenaar gebruikt om productvarianten te definiëren. Je kunt drie opties voor een productvariant definiëren: option1, option2, option3. Standaardwaarde: Standaardtitel. Het titelveld is een aaneenschakeling van de velden option1, option2 en option3. Bij het bijwerken van de optievelden wordt het titelveld bijgewerkt.
    position Default: 0 De volgorde van de productvarianten in de lijst met productvarianten. De eerste positie in de lijst is 1. De positie van varianten wordt aangegeven door de volgorde waarin ze worden vermeld. smallint(5) unsigned alleen-lezen
    presentment_prices Een lijst met de presentatieprijzen en de vergelijkingsprijzen van de variant in elk van de ingeschakelde presentatievaluta van de winkel. Elk prijsobject heeft de volgende eigenschappen:
    -currency_code: de drielettercode (ISO 4217-indeling) voor een van de ingeschakelde presentatievaluta van de winkel.
    -amount: de prijs of vergelijkingsprijzen van de variant in de presentatievaluta.
    Vereist de koptekst 'X-Shopify-Api-Features': 'include-presentment-prices'.    		 alleen-lezen
    prijs Default: 0 De prijs van de productvariant. decimal(20,2)
    product_id Default: NULL Het unieke identificatiecijfer van het product. bigint(20)
    requires_shipping Default: 1 Deze eigenschap is verouderd. Gebruik in plaats daarvan de eigenschap 'requires_shipping' in de hulpbron InventoryItem. boolean tinyint(1)
    sku Een unieke id voor de productvariant in de winkel. Vereist om te kunnen koppelen met een FulfillmentService. varchar(255)
    tax_code Deze parameter is alleen van toepassing op de winkels die de Avalara AvaTax-app hebben geïnstalleerd. Specificeert de Avalara-belastingtariefgroep voor de productvariant.
    belastbaar Default: 1 Of er btw wordt berekend wanneer de productvariant wordt verkocht. boolean tinyint(1)
    titel De titel van de productvariant. Het titelveld is een aaneenschakeling van de velden option1, option2 en option3. Je kunt de titel alleen indirect bijwerken door de optievelden te gebruiken. varchar(255) alleen-lezen
    updated_at Default: NULL De datum en tijd waarop de productvariant voor het laatst werd gewijzigd. Wordt weergegeven in de indeling ISO 8601. date datetime
    weight Het gewicht van de productvariant in het eenheidssysteem dat met weight_unit wordt gespecificeerd.
    weight_unit
    • g
    • kg
    • g
    • lb
    Default: NULL    		 De maateenheid die van toepassing is op het gewicht van de productvariant. Als je geen waarde opgeeft voor weight_unit, wordt de standaard maateenheid van de winkel toegepast. varchar(2)