Verify and register beverage alcohol shipments with the AvaTax shipping verification API

domain: avalara.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. After creating a Sales Invoice transaction in AvaTax, call GET /api/v2/companies/{companyCode}/transactions/{transactionCode}/shipment/verify to check compliance for that transaction.
  2. Read the response's `compliant` boolean; if true, `successMessages` explains which jurisdiction rules passed (e.g. valid license, age checks, volume limits).
  3. If `compliant` is false, inspect `failureMessages` (and per-line `failureMessages`) to identify exactly which part of the transaction violated a jurisdiction's rules.
  4. Note that VerifyShipment only checks compliance — it does not record shipped volume; call the RegisterShipment endpoint separately to commit the volume, or use RegisterShipmentIfCompliant to verify and register in one call.
  5. When verifying shipments for a Return Invoice, include `documentType=ReturnInvoice` in the request URL — omitting it causes a 'Document not found' error because the API defaults to SalesInvoice.
  6. Use the DeleteShipmentRegistration endpoint to undo a registration if an order is later canceled or voided.

Known gotchas

Related routes

Implement alcohol delivery compliance with age verification in a delivery API integration
food-delivery-general · 5 steps · unrated
Build a customs declaration and commercial invoice payload for an international shipment label via carrier APIs
logistics/shipping · 6 steps · unrated
Use Sovos ShipCompliant's license management features to track and maintain alcohol shipping/producer licenses across states
sovos.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans