Consignment¶

The store has three separate consignment relationships. They share a word and little else. Read this page before you touch any of them, so you know which set of screens you are in.

The three relationships¶

A private consignor's gun. A private party leaves a gun with you to sell on their behalf. You never bought it. You take it in on Receive Goods with Acquisition Type set to Consignment and a Consignment Commission %, and you owe the owner their share once it sells. The owner is called the consignor, and they get paid through ordinary accounts payable. On the receipt the gun's cost stays at $0. What the store owes the consignor is worked out at the sale as the net price times one minus the commission, and that figure is the cost shown on the Sales Report. This is part of the POS itself and works whether or not the consignment extension is on.

Consignment Out. You send your own guns to a partner FFL dealer, who puts them on their rack and sells them for you. The guns stay yours, and stay on your books, until that dealer sells one. You then bill the dealer at your dealer price. Most of the pages in this section describe this.

Consignment In. A partner store that runs this same POS sends you its guns to sell. You receive them as pay-on-sale stock: they sit in your inventory at the partner's price, and you owe the partner that price only once a gun sells. See Receiving from a partner store.

	Private consignor	Consignment Out	Consignment In
Who owns the gun	A private consignor	Your store	Your store, paid for at sale
Where the gun sits	Your showroom	A partner FFL's rack	Your showroom
Who pays whom	You pay the consignor	The dealer pays you	You pay the partner store
Where you work	Receive Goods, then the register	Consignment Out, Dealer Orders	Consignment In, then the register
Bound book at handover	An Acquisition when it arrives	A Dealer Transfer disposition when it ships	An Acquisition from the partner's FFL when you receive it

A pay-on-sale supplier is not a consignor

A distributor or another dealer who ships you guns and invoices you only when each one sells is a pay-on-sale supplier, not a consignor. Those guns are yours from day one: receive them as a normal purchase with their real cost, so the books carry the right value and the supplier is paid the invoice, not a commission. A partner store on Consignment In is set up exactly this way.

A private consignor's gun can never be shipped out to a partner dealer. The serial picker on Consignment Out greys those rows out with the message "Consignor-owned gun cannot be re-consigned.", and the ship step refuses them a second time by serial number. This is a deliberate rule. Settlement with a dealer runs off the wholesale dealer price, and paying a consignor's commission off that number instead of a retail sale price would short-pay them without anyone noticing.

Turning consignment on¶

Consignment Out, Dealer Orders, Dealer Onboarding and Consignment In come from the OSA Consignment extension. It needs POS 1.4.0 or later. A System Manager turns it on or off on its card under Settings → Extensions.

When it is off:

The four pages show "OSA Consignment is turned off for this store." and point to Settings → Extensions.
Every consignment record stays, read only. Nothing is deleted.
A partner POS can no longer report to you or send you a consignment, and shipped boxes are no longer tracked.
A gun on a draft consignment stays held for it at the counter.

The extension cannot be uninstalled while it holds consignment records. Turn it off instead.

Where the pages are¶

In the sidebar, the Consignment section sits right above Settings and lists Consignment Out, Dealer Orders, Consignment In and Dealer Onboarding. The same four links are under Consignment in the Dashboard's All records. Each shows only to the roles that can open it, and the section disappears while the extension is switched off. You can also go straight to the address.

Page	Address	Who can open it
Consignment Out	`/app/osa-ship-consignment`	Sales Manager, Stock Manager, System Manager
Dealer Orders	`/app/osa-dealer-orders`	Sales User, Sales Manager, Stock Manager, System Manager
Dealer Onboarding	`/app/osa-dealer-onboarding`	Sales Manager, Stock Manager, System Manager
Consignment In	`/app/osa-receive-consignment`	Sales User, Sales Manager, Stock Manager, System Manager

Use these addresses, not /app/osa-consignment-out or /app/osa-consignment-in. Those two open plain lists of records instead of the guided pages.

Dealers on our POS, and dealers without it¶

A partner dealer either runs this same POS with the consignment extension, or does not.

A dealer on our POS has a Partner POS on file. When you dispose a consignment to them, it is pushed into their own POS, where it appears on their Consignment In page. Their POS reports back by itself when they receive a gun and when they sell one. Nobody signs in anywhere.
A dealer without our POS has no Partner POS on file. You can still ship to them. They phone or email you when the box arrives and when they sell a gun, and you record it on their card with Mark received and Mark sold.

The Consignment Out page shows which kind a dealer is: a Partner POS badge, or No POS — you mark its sales. See Connecting a dealer for setting up the link.

Pricing words, and the one that bites¶

Consignment Out has two prices per gun, and one of them shares a name with a field used by a different part of the system. Get these straight before you edit anything.

What you see	Where	What it means
Dealer Price	The Consignment Out page	What the dealer owes you when this gun sells. This is the settlement amount.
MSRP	The Consignment Out page	A suggested retail price passed to the dealer. Optional. Nothing is billed off it.
Cost	The Item form	The item's dealer-channel price. Despite the label, it is a selling price, not what you paid.
Dealer Sell Price	The Serial No form	The same idea as above, for a gun priced individually rather than by model.
Purchase Rate	The Serial No form	What you actually paid for this gun. Never used in Consignment Out math.

When you add a gun to a shipment, its Dealer Price is prefilled from the item's Cost field, or from that serial's Dealer Sell Price for a per-gun-priced item. The MSRP is prefilled from the gun's normal selling price.

Do not correct a settlement price toward Purchase Rate

Settling with a dealer at the dealer price is a deliberate decision: the dealer price is what these dealers pay. If a settlement amount looks wrong, check whether the item's Cost field or the serial's Dealer Sell Price is blank or stale. That is the field worth fixing, not the acquisition cost.

A third price never enters any math. Sold at on Dealer Orders is what the dealer sold the gun for: the price their POS reported, or what you typed into They sold it for (optional) when you marked a sale for a dealer without our POS. It is there so you can see what your guns fetch on someone else's shelf. A dealer whose sale price is blank owes exactly the same amount as one whose price is recorded.

Other words you will see¶

Word	Meaning
At Dealer	A gun that has shipped and not yet sold, been recalled, or been voided.
Dispose	Books the bound book transfer and moves the gun into the dealer's warehouse.
Partner POS	The dealer's or partner store's own POS, on file so the two stores can talk.
Recall	Brings guns back from the dealer into your stock.
Coming back	A dealer on our POS sent guns back. Book them in with Receive back.
Void	Undoes a ship that should never have happened.
Send back	On Consignment In, returns a partner store's gun to it.

Where to go next¶

Page	What it covers
Connecting a dealer	Setting up a partner FFL, its API login and its Partner POS
Shipping a consignment	Building, disposing, shipping and managing a consignment
Receiving from a partner store	Taking in, selling and sending back a partner store's guns
Settlement and payout	Billing the dealer, collecting, and paying a consignor or partner store