

DocsDocumentation
How can we help?
Two guides: the User Guide for running your business on DISTRYB, and the Developer Guide for building on our API.
📣 See what's new →User Guide
Set up your store, sell, stay compliant, and run your beverage business on DISTRYB — step by step.
Open User Guide →
Developer Guide
Authenticate with an API key and build on DISTRYB — endpoints, errors, and pagination.
Open Developer Guide →
User Guide
Account
Connect Claude or ChatGPT to your business
Point the AI you already use at your own DISTRYB data — ask what is running low or who has not paid, and let it act only as far as your own permissions reach.
Analytics & insights
See what is selling, where, and to whom — drawn from your orders and invoices.
Plans & billing
Free, Pro and Enterprise by role, what Pro includes, upgrading, and team seats.
Times and time zones
Which times you see in your own time zone, and the few that count in UTC.
Connectors
Integrate the commerce and fulfillment tools you already run.
Connect your Shopify store
Bring a Shopify catalogue across by CSV or by connecting the store, keep stock counts current, and optionally send your paid Bottl.Service orders back to Shopify to pick and ship.
Team & roles
Invite teammates and control what each person can access with roles.
Social Team — your people on Bottl.Service
Authorize real people to represent your business on the Bottl.Service feed, and link their personal profile to your company page.
Selling
Put a buy button on your own website
A "Buy now" button for each of your products, to paste into Shopify, Squarespace, Wix or any site. It checks where the order is going before checkout, and a licensed retailer sells and ships it.
Put a wholesale order button on your website
For distributors, brokers and producers selling to retailers: an "Order wholesale" button for your own site that opens your public catalog on DISTRYB, where licensed retailers sign in to order.
Product photos: who sets them, and how to change yours
Add or replace a photo from your catalog, add up to 10 of your own that nobody can overwrite, and why a brand owner controls the main one.
Rebates vs discounts on alcohol
Why brand-funded offers run as rebates, not instant discounts — and what we need from you.
Promotions & discount codes
Run codes and automatic promotions across your storefront and wholesale.
Placing & managing orders
Create wholesale orders and collaborate with the other party in real time.
Invoices & payments
How invoices are minted and how money moves.
Key accounts (off-platform buyers)
Record what you sell to buyers who aren’t on DISTRYB, so your invoices, tax returns and reports are complete.
Trade spend: programs between a brand and its distributor
Offer a depletion allowance, billback or volume incentive to a distributor, see what it accrues from their sales on DISTRYB, and track claims and settlements — DISTRYB records the money, it never moves it.
Get started
Getting started with DISTRYB
What DISTRYB is and how to get your organization up and running.
PLUG — your AI assistant
The built-in AI assistant that answers from the docs and your live account.
Report a bug or send an idea
DISTRYB is in beta — here's how to flag something broken, confusing, or missing, and what happens next.
Your store
Set up your store & go live for pickup
Stand up your own storefront so local customers can order your products for pickup or local delivery.
Payments & getting paid
Connect Stripe to take customer payments, turn on sales tax, and get paid out.
Where you can sell
How state law and per-product registrations determine where your products can be sold.
Inventory & stock
Track what you have on hand, price it, and keep your storefront and wholesale orders in sync.
Link your location to its venue listing
Tell us which licensed premises is yours, so visits and the people who bring them are counted at your venue.
Compliance & Tax
Compliance
How DISTRYB enforces three-tier law, state registration, and licensing.
Tax filing
Native beverage-tax filings generated from your activity.
Price postings (New York and Connecticut)
Prepare the monthly price schedule that fits your licence in a post-and-hold state, from the prices you already set — then file it yourself.
Illinois: what DISTRYB enforces
The Illinois rules DISTRYB applies — samples & tastings, brokers — each with its source and the date it was checked.
Production & TTB
Production & TTB: getting started
Set up each DSP permit as a plant, add your equipment, carry in opening balances from your last filed reports, and switch over from your old records.
Recording on the Floor
Mash in, charge the still, collect cuts, gauge and enter, fill and dump barrels, blend, process, bottle and ship — what each Floor action records, and how to undo one.
Gauging and proof
How DISTRYB turns a hydrometer reading, a scale weight or a tank volume into proof gallons, how it rounds, and what sweetened or flavored spirits need.
Month end and your TTB reports
What the Reports tab computes for the 5110.40, 5110.11, 5110.28 and the 5000.24, what you still complete by hand, and how a month is signed, filed and amended.
Excise tax and the CBMA reduced rate
Which removals DISTRYB prices at the reduced CBMA rate and which at the full $13.50, why bought-in-bond and imported spirits are treated differently, and what to check before you file.
Ask PLUG about production
Ask PLUG what is in your tanks and barrels, what still blocks a month, or tell it what you did on the floor. It proposes the record and you tap Confirm.
Brokers
Brokers & partnerships
Find or invite brokers, set commission terms, and grow within your plan.
Broker commissions & payouts
How commissions accrue, when payouts run, and getting paid via Stripe.
Selling bottles at your events
One QR code you print once, the events you work, selling tickets and working the door, and how a guest at a tasting gets credited to you.
Events
Co-hosting an event: brands, offers and the lineup
How a brand joins an event -- the host invites it, or the brand asks to co-host -- and how the host picks what sells and what pours from the bottles each co-host brings.
After the night: pours, damage, refunds and closing out
What the host and each supplying brand do once an event is over -- record what was poured, report anything broken, lost or replaced, move what is left to the next night, and close out so the rest goes back on the shelf.
Event emails: who hears what, and when
Every email and notification an event sends -- to guests, to the host, to supplying brands and to creators -- with when it goes and what it says.
How creators are paid
When a sale counts, when the money is sent, and what a creator sees on their Commissions page.
Developer Guide
Endpoints
Inventory import
Keep a location's shelf current by posting your register's export on a schedule.
Orders
List and retrieve wholesale orders your org is a party to.
Invoices
List and retrieve invoices your org is a party to.
Partnerships
List broker partnerships your org is a party to.
Products
List the org's catalog (brands it owns or produces).
Commissions
A broker org's commission ledger with payout status.
Need a hand?
Ask PLUG — our AI assistant answers from these docs instantly and points you to the right page.