API rešenja za poreze i dostavu u Shopify-ju

Shopify nema endpoint koji pozivate da biste izračunali porez ili dostavu. Porezi dolaze iz poreskog servisa koji izaberete u Settings > Taxes and duties (Shopify Tax, partnerska aplikacija kao što su Avalara ili Vertex, ili ručno unete stope), a dostava iz delivery profila, carrier service aplikacija sa cenama u realnom vremenu i Shopify Functions koje u checkout-u preimenuju, sortiraju ili sakrivaju opcije dostave.

REST pozivi kao što je /admin/api/2021-01/taxes/calculate.json, koje stariji vodiči i dalje navode, ne postoje u aktuelnoj Shopify API dokumentaciji, a REST Admin API je zastareo (legacy) od 1. oktobra 2024. U nastavku su opcije koje danas rade, ograničenja po planovima i GraphQL Admin API objekti koji su bitni, provereno za API verziju 2026-10.

Koje poreske servise Shopify prodavnica može da koristi?

Prema stranici Choose a tax service, promena servisa u SAD, Kanadi, EU i UK može biti trajna, zato odlučite pre nego što sačuvate. Sopstveni poreski sistem ne možete da povežete sa checkout-om: Tax Platform je dostupan samo po pozivu odabranim kompanijama za poreski softver.

Šta preko API-ja možete da kontrolišete kod poreza?

• Oporezivost proizvoda: ProductVariant.taxable uključuje ili isključuje porez po varijanti. Shopify Tax čita kategoriju proizvoda, pa vodite računa da kategorije budu tačne kada proizvode sinhronizujete iz ERP-a ili PIM-a.
• Oslobađanje kupaca: Customer.taxExempt za potpuno oslobađanje, ili customerAddTaxExemptions za konkretne šifre oslobađanja.
• Override-i: tax overrides se podešavaju u admin panelu, za ručno napravljene kolekcije i za dostavu po regionu. Imaju prednost nad kategorijom proizvoda.
• Pregled pre porudžbine: draftOrderCalculate vraća iznose, uključujući totalTaxSet, bez kreiranja draft porudžbine. To je najbliža zamena za stare "calculate" pozive.

U headless projektima, polja totalTaxAmount i totalDutyAmount na Storefront API objektu CartCost su zastarela, a konačan porez se obračunava u checkout-u. Više o tome u tekstu o porezima u headless Shopify checkout-u.

Kako funkcionišu carine i uvozne takse?

Uključuju se u Settings > Taxes and duties, u odeljku Duties and import taxes. Shopify obračunava carine na osnovu HS koda i zemlje porekla svakog proizvoda, pa oba podatka moraju biti popunjena, i naplaćuje naknadu po porudžbini sa carinom, čija visina zavisi od toga da li koristite Shopify Payments. Ograničenja: nema carina u zoni Rest of world, ne rade uz tax overrides ni ručne stope, ne podržava se Shopify Fulfillment Network, i ne podržava svaki kurir DDP nalepnice.

Ako ne želite poresku registraciju u inostranstvu, Managed Markets postavlja Global-e za merchant of record: on uplaćuje porez, rešava carine i nudi lokalne načine plaćanja. Dostupan je trgovcima sa sedištem u kontinentalnom delu SAD i određenim prodavnicama u Kanadi i UK.

Kako prikazati cene kurira u realnom vremenu u checkout-u?

Preko Carrier Service API-ja. Aplikacija registruje callback URL mutacijom carrierServiceCreate (scope write_shipping). U checkout-u Shopify šalje korpu i adresu na taj URL, a aplikacija vraća niz rates.

mutation CarrierServiceCreate($input: DeliveryCarrierServiceCreateInput!) {
  carrierServiceCreate(input: $input) {
    carrierService { id name callbackUrl active }
    userErrors { field message }
  }
}

Svaka cena mora da ima service_name, description, service_code, currency i total_price u najmanjim jedinicama valute (500 znači 5,00). Prema DeliveryCarrierService dokumentaciji, ponovnog pokušaja nema: ako istekne vreme ili dođe do greške, prikazuju se rezervne (backup) cene.

Ograničenja po planu: obračun dostave preko kurira trećih strana uključen je u Advanced i Shopify Plus. Grow prodavnice mogu da ga dodaju uz mesečnu naknadu ili uz godišnje plaćanje. Ako prodavnica pređe na niži plan, carrier service se deaktivira.

Kako preimenovati, sortirati ili sakriti opcije dostave?

Pomoću Delivery Customization funkcije. Ona vraća operacije deliveryOptionRename, deliveryOptionMove i deliveryOptionHide, na primer da sakrije ekspresnu dostavu za glomazne proizvode. Cenu dostave ne može da menja. Aplikacija je aktivira mutacijom deliveryCustomizationCreate, a jedna prodavnica može da ih ima najviše 25. Javne aplikacije iz App Store-a sa funkcijama rade na svim planovima, ali custom aplikacije sa Shopify Functions zahtevaju Shopify Plus.

Gde se uklapaju lično preuzimanje, lokalna dostava i nalepnice?

Obe lokalne opcije podešavaju se po lokaciji u Settings > Shipping and delivery > Additional delivery methods. Pickup in store određuje vreme preuzimanja i uputstva, što aplikacije mogu da urade i mutacijom locationLocalPickupEnable. Local delivery dozvoljava do 10 zona po lokaciji, po poštanskom broju ili u radijusu do 160 km, svaku sa svojom cenom i opcionim minimalnim iznosom porudžbine.

Shopify nalepnice za slanje kupuju se iz admin panela za podržane lokacije za ispunjenje porudžbina. Dostupni kuriri zavise od zemlje, a popusti od plana.

Koji GraphQL Admin API objekti su bitni?

Na strani prodavnice, Cart.deliveryGroups vraća dostupne opcije, svaku sa poljima handle, title i estimatedCost.

Mi pravimo carrier service aplikacije, delivery customization funkcije i ERP integracije za cene dostave za Shopify Plus prodavnice. Ako vam treba nešto od toga, pogledajte našu uslugu Shopify API integracije.

FAQ

Mogu li i dalje da koristim taxes/calculate.json ili calculate_shipping_rates.json?

Ne. Nijedan od njih nije u aktuelnoj Shopify API dokumentaciji, a REST Admin API je zastareo od 1. oktobra 2024. Za pregled poreza i iznosa koristite draftOrderCalculate, a za cene u realnom vremenu carrier service.

Koji Shopify planovi mogu da koriste obračun dostave preko kurira trećih strana?

Advanced i Shopify Plus ga uključuju. Grow prodavnice mogu da ga dodaju uz mesečnu naknadu ili prelaskom na godišnje plaćanje. Basic plan ga ne podržava.

Mogu li da povežem Avalaru ili Vertex sa Shopify checkout-om?

Da. Oba su navedena na Shopify stranici o poreskoj platformi. Instalirajte partnersku aplikaciju iz odeljka Tax apps u Settings > Taxes and duties, pa je izaberite kao poreski servis za region.

Može li Shopify funkcija da promeni cenu dostave?

Delivery Customization funkcija ne može. Ona samo preimenuje, sortira ili sakriva opcije. Za samu cenu koristite cene u delivery profilu ili carrier service koji vraća vaše cene.