Skip to main content

Documentation

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 →

Set up your store, sell, stay compliant, and run your beverage business on DISTRYB — step by step.

InventoryGet startedYour storeSellingAccountCompliance & TaxBrokersBuyingMessaging

Open User Guide →

Developer Guide

Authenticate with an API key and build on DISTRYB — endpoints, errors, and pagination.

EndpointsBasics

Open Developer Guide →

User Guide

Inventory

Tracking your inventory: in DISTRYB, or somewhere else

Which sales DISTRYB can see, why that decides whether its stock numbers are yours, and how to connect a POS later.

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.

Selling

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.

Account

Analytics & insights

See what is selling, where, and to whom — drawn from your orders and invoices.

Plans & billing

Tiers, what each unlocks, upgrading, and team seats.

Integrate the commerce and fulfillment tools you already run.

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.

Compliance & Tax

How DISTRYB enforces three-tier law, state registration, and licensing.

Native beverage-tax filings generated from your activity.

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.

Buying

Buying inventory (purchase orders)

Create purchase orders to your suppliers and receive stock into inventory.

Messaging

Messages, channels & reach credits

DMs, group chats, and industry channels in one place — plus how reach credits, replies, and the who-viewed-you signal work.

Developer Guide

Endpoints

Inventory import

Keep a location's shelf current by posting your register's export on a schedule.

List and retrieve wholesale orders your org is a party to.

List and retrieve invoices your org is a party to.

List broker partnerships your org is a party to.

List the org's catalog (brands it owns or produces).

A broker org's commission ledger with payout status.

Basics

What the DISTRYB API is, the base URL, and conventions.

Create an API key and authenticate requests.

Errors & pagination

Error format, status codes, and how lists are paged.

Need a hand?

Ask PLUG — our AI assistant answers from these docs instantly and points you to the right page.