Distributor Dashboard Manual

Guide for distributor setup, dealer creation, and order handoff.

Quick Links

Distributor ID

Use a unique distributor ID in the format CC999, where CC is any two-letter country code and 999 is a three-digit sequence. Examples: AU001, US001, CA001.

Distributor Name

Enter the legal or operating name that staff will recognize in the dashboard.

Contact Email

This is the primary operations or owner email for that distributor. Use a real monitored mailbox when possible.

Webhook URL

This is optional. Use it if the distributor has another system that should receive event notifications such as new dealers, new orders, or provisioning milestones.

Order Agents

Use the Inventory card on the distributor dashboard to create a live distributor inventory order. The form creates an opening or reorder request through the licensing service and should generate a GHL invoice when billing is configured.

The distributor should have a valid ghl_contact_id before using this form.

Direct Customer Orders

Use the Create Direct Customer Order button on the distributor dashboard when the distributor wants a customer namespace for their own internal use or for a direct customer they manage themselves.

Those orders use the distributor's own ID as the dealer portion of the composite code, then return to the same distributor dashboard for node assignment and top-level approval.

Dealer ID

Create dealer IDs with the same CC999 format and match the dealer's operating country code where practical. Examples: AU002, US003, DE004.

Dealer Name

Use the dealer's public-facing business name so the record is easy to recognize later.

Dealer Secret

This is a required shared secret for dealer-side authentication and future secure workflows. Store it carefully.

Add Node

When an order is pending_distributor, the distributor adds the node and sends the order upward for top-level approval. For testing, node-1 is acceptable. For real operations, use the actual node or agreed logical node name.

← Back to Top Dashboard