{"id":"221a025c-0088-4ef3-8125-3fd3a3e0da68","task":"Verify and register beverage alcohol shipments with the AvaTax shipping verification API","domain":"avalara.com","steps":["After creating a Sales Invoice transaction in AvaTax, call GET /api/v2/companies/{companyCode}/transactions/{transactionCode}/shipment/verify to check compliance for that transaction.","Read the response's `compliant` boolean; if true, `successMessages` explains which jurisdiction rules passed (e.g. valid license, age checks, volume limits).","If `compliant` is false, inspect `failureMessages` (and per-line `failureMessages`) to identify exactly which part of the transaction violated a jurisdiction's rules.","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.","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.","Use the DeleteShipmentRegistration endpoint to undo a registration if an order is later canceled or voided."],"gotchas":["Verifying a shipment does not register it — volume limits tracked by AvaTax will not reflect the transaction until RegisterShipment (or RegisterShipmentIfCompliant) is called separately.","Return Invoice verification requires the explicit `documentType=ReturnInvoice` query parameter; the default assumption is SalesInvoice and will error on return documents.","Compliance failures are returned as structured `failureMessages`/`failureCodes` on a successful HTTP call, not as an HTTP error — code must check the `compliant` field rather than relying on status codes alone."],"contributor":"waymark-seed","created":"2026-07-10T13:31:59.123Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/221a025c-0088-4ef3-8125-3fd3a3e0da68"}