{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"United States ( US )","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"united-states--us-","__idx":0},"children":["United States (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," to preserve the state and any county, city, district,"," ","or sector tax context selected by the merchant's tax system. The extension"," ","fields support all 50 states and the District of Columbia; that is a data"," ","capability, not a claim that every state imposes a statewide general sales tax."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-cheqi","__idx":1},"children":["Before Cheqi"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Determine nexus, sourcing, taxability, exemptions, and applicable"," ","jurisdictions using your tax/compliance systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Calculate each state, county, city, district, or sector tax separately."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain seller permits/registrations and any exemption or resale-certificate"," ","reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Determine whether and how tax must be stated on the receipt."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-the-cheqi-request","__idx":2},"children":["In the Cheqi request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request location"},"children":["Request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["State/DC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US:REGION"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax jurisdiction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US:TAX_JURISDICTION"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller permit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supplier identifier in the context resolved by Cheqi"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exemption/resale reference"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[].exemptionReasonCode"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exemptionReason"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}," using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALES_TAX"]}," where applicable"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"california-example","__idx":3},"children":["California example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"taxes\": [\n    {\n      \"type\": \"SALES_TAX\",\n      \"rate\": 8.625,\n      \"taxableAmount\": 100.0,\n      \"amount\": 8.625,\n      \"label\": \"Supplied state and local sales tax\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"US\",\n    \"additionalFields\": [\n      {\n        \"code\": \"US:REGION\",\n        \"value\": \"CA\",\n        \"label\": \"State\"\n      },\n      {\n        \"code\": \"US:TAX_JURISDICTION\",\n        \"value\": \"CA / supplied county / supplied city\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"region-without-supplied-sales-tax","__idx":4},"children":["Region without supplied sales tax"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the merchant tax system calculates no applicable sales tax, do not invent"," ","a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALES_TAX"]}," entry:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"taxes\": [],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"US\",\n    \"additionalFields\": [\n      {\n        \"code\": \"US:REGION\",\n        \"value\": \"OR\"\n      },\n      {\n        \"code\": \"US:TAX_JURISDICTION\",\n        \"value\": \"jurisdiction-result-supplied-by-merchant-tax-system\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cheqi does not determine nexus, source the transaction, calculate tax, or"," ","validate permits and certificates."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The presence of structured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}," entries already shows that tax is stated;"," ","do not add boolean ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRESENT"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US:TAX_SEPARATELY_STATED"]}," duplicates. Keep"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US:TAX_JURISDICTION"]}," only because the current tax structure cannot yet encode"," ","state, county, city, and district attribution."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-region-codes","__idx":5},"children":["Supported region codes"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"AL AK AZ AR CA CO CT DE FL GA HI ID IL IN IA KS KY LA ME MD MA MI MN MS\nMO MT NE NV NH NJ NM NY NC ND OH OK OR PA RI SC SD TN TX UT VT VA WA WV\nWI WY DC\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":6},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supplying jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/overview"},"children":["Country support boundary"]}]}]}]},"headings":[{"value":"United States ( US )","id":"united-states--us-","depth":1},{"value":"Before Cheqi","id":"before-cheqi","depth":2},{"value":"In the Cheqi request","id":"in-the-cheqi-request","depth":2},{"value":"California example","id":"california-example","depth":2},{"value":"Region without supplied sales tax","id":"region-without-supplied-sales-tax","depth":2},{"value":"Supported region codes","id":"supported-region-codes","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"United States","description":"Create state-aware US receipt payloads without inferring sales-tax rules","seo":{"title":"United States ( US )"}},"lastModified":"2026-07-29T20:49:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/us","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}