Skattebefrielser

Om ni säljer till återförsäljare, myndigheter eller ideella organisationer innehar dessa köpare befrielseintyg som befriar dem från omsättningsskatt i specifika delstater. Zonos lagrar dessa intyg mot en kundprofil så att en befriad köpare kan identifieras i Checkout.

Befrielser registreras per jurisdiktion. En kund som är skattebefriad i South Carolina är inte automatiskt befriad i Texas, så varje delstat kunden innehar ett intyg för är en separat post med egna datum och intygsnummer.

Befrielser kopplas till en befintlig kund, så synkronisering sker i två anrop: skapa kunden och synkronisera sedan deras intyg. Båda är kopplade till ert eget kund-ID — samma customerId som ni använder på andra ställen i Checkout. Zonos kräver aldrig att ni lagrar ett internt ID.

Den här funktionen är endast tillgänglig för anpassade API-integrationer.

Skapa eller uppdatera kunden 

checkoutCustomerUpsert skapar en kundprofil, eller uppdaterar den om en redan finns för det customerId. Till skillnad från checkoutCustomerProfileAuthenticate kräver detta inte att köparen är närvarande, så ni kan förbereda er kundlista i förväg. Se skapa eller uppdatera en profil utan en köpare för det fullständiga fältbeteendet.

Eftersom den matchar på customerId uppdaterar upprepade anrop samma profil istället för att skapa dubbletter. Det är säkert att köra mot hela er kundlista vid varje synkronisering.

Synkronisera skattebefrielser 

checkoutCustomerTaxExemptionsSync accepterar flera kunder samtidigt. Varje post ersätter kundens fullständiga uppsättning befrielser.

Ett utelämnat expiresAt innebär att intyget inte upphör att gälla. Ett utelämnat exemptionReason blir som standard UNSPECIFIED.

Så fungerar synkroniseringen 

Tre regler styr varje synkronisering.

Listan är den auktoritativa källan. taxExemptions är kundens fullständiga uppsättning, inte en lista över ändringar. Varje befrielse som redan finns registrerad men som saknas i listan tas bort — så slutar ett återkallat intyg att gälla. Att skicka en ofullständig lista tar tyst bort allt den utelämnar.

Varje post är en befrielse. Det finns inget sätt att registrera att en kund inte är befriad någonstans — se anmärkningen nedan.

Att ta bort alla befrielser är en tom lista. För att rensa en kunds intyg skickar ni dem med "taxExemptions": []. Att utelämna kunden helt från nyttolasten lämnar deras befintliga poster orörda.

Befrielseorsaker 

exemptionReason beskriver varför kunden är befriad. Fältet är valfritt och standardvärdet är UNSPECIFIED, men det är värt besväret att ange det — se nedan.

Orsakerna delas in i två grupper, och skillnaden spelar roll. Entitetsbaserade orsaker — myndighet, välgörenhet, religion, utbildning — befriar köparen oavsett vad de köper. Användningsbaserade orsaker, framför allt RESALE, omfattar bara varor som kvalificerar sig: ett återförsäljningsintyg täcker lager köparen ska sälja vidare, inte kontorsmöblerna på samma order.

Utan en orsak kan Zonos inte skilja de två åt och kan bara befria hela ordrar, vilket är svårast att försvara för återförsäljningsintyg. Om de flesta av era befrielser gäller återförsäljning är det oftast betydligt mindre arbete att skicka RESALE som standard med undantag listade individuellt än att klassificera varje kund.

Intygsreferens 

exemptionReference är numret som står tryckt på kundens befrielsedokumentation. Beroende på delstat och typ av befrielse kan det vara ett återförsäljnings- eller säljartillståndsnummer, ett delstatligt befrielseintygsnummer, ett direktbetalningstillståndsnummer eller ett federalt skatte-ID.

Det krävs för varje post. Lagra och skicka det exakt som det står på intyget — format varierar kraftigt mellan jurisdiktioner (SR EAA 12-345678, 85-8012345678C-9, 12-3456789), och Zonos bevarar värdet som det skickas, bortsett från att omgivande blanksteg trimmas bort. Ändra inte versaler/gemener och ta inte bort bindestreck eller mellanslag.

Avvisade poster 

Poster valideras en i taget. En avvisad post rapporteras i rejected och gör inte att resten av batchen misslyckas, och den påverkar inte heller den befrielse som redan finns registrerad för den jurisdiktionen.

Okända kunder avvisas i stället för att skapas, så ett felstavat customerId syns i svaret istället för att skapa en profil som aldrig matchar en verklig köpare.

Endast amerikanska administrativa områden valideras. Underindelningar i andra länder accepteras som de skickas.

Läsa av och ta bort 

Läs av en kunds befrielser för att bekräfta att en synkronisering har gått igenom:

För att ta bort alla befrielser för en kund — till exempel när de avslutar sitt konto — använd checkoutCustomerTaxExemptionsDelete. Den returnerar SUCCESS oavsett om kunden hade några befrielser eller inte, så det är säkert att anropa den mer än en gång.