Purpose
Shipping connects FlintPOS to Shippo for shipping-rate requests and label purchases. It also controls the label file and layout defaults, the register printer used for labels, sender information, and the packed-product measurements used in rating.
Where to find it
- An admin opens Settings.
- Choose Shipping under the website and integrations settings.
- After Shippo is enabled and saved, staff open Inventory and edit a product to enter its Ready-To-Ship Package values.
Product locationSettings > Shipping · Inventory > Product > Edit > Ready-To-Ship Package
Before you start
- Only an admin can set up Shippo in the current Settings page. Staff can use product shipping fields after the admin completes Shippo setup.
- Enter a Shippo API key supplied through your Shippo account. FlintPOS keeps the saved key when the field is left blank. Do not place a key in a public note or article.
- Product package fields appear after shipping labels are set up and only when the product is marked Shippable.
- The desktop app is needed for the local shipping-label printer workflow. A browser-only screen may save settings but cannot load local printers.
Set up Shippo
- Open Settings > Shipping as an admin.
- Turn on Enable Shippo.
- Enter the Shippo API key. Leave the field blank only when retaining the saved key.
- Choose Label File Type and Label Layout for generated labels.
- In the desktop app, choose Refresh. Then select Printer for this register or leave it on the system default.
- Enter the default sender name, company, phone, and email used for shipment requests. Then select Save Shipping Settings.
Enter packed-product measurements
- Open or create a product in Inventory after Shippo setup is saved.
- Turn on Shippable.
- Enter the packed box or parcel’s length, width, height, and weight. Use the packed package, not the loose item or bulk delivery measurement.
- Save the product. When a shipment is created, use the delivery or shipment flow to enter the recipient details and request rates.
- Review the rate, choose a service, and buy the label only after checking the recipient, package, and sender values.
Fields and choices
| Field | Meaning, default, and validation |
|---|---|
| Enable Shippo | Allows ship orders to request rates and buy labels through Shippo. The checkbox shows the saved setting. |
| Shippo API Key | Password-style password input. Leave blank to keep the current saved key. Entering a new value replaces it. FlintPOS does not display the saved secret as a public value. |
| Label File Type | Choose PDF or PNG. The form starts from the saved value and sends the chosen output type with label requests. |
| Label Layout | Choose 4 x 6 or Letter. Use the layout that matches the chosen printer and label stock. |
| Refresh | Loads printers available to the desktop app. It is disabled while printers are loading. |
| Printer for this register | Chooses the register’s shipping-label printer. The default option uses the system default printer. An explicit printer can be chosen when the desktop app reports one. |
| Sender Name | Default sender name sent with shipment requests. The saved value is loaded into the settings form. |
| Sender Company | Default sender company sent with shipment requests. |
| Sender Phone | Default sender phone sent with shipment requests. Enter the number customers or carriers should use. |
| Sender Email | Default sender email sent with shipment requests and available for shipment communications. |
| Saving… / Save Shipping Settings | Saves Shippo and sender settings. The action is disabled while saving. The desktop app requirement applies to local printer setup. |
| Length (in) | Packed package length in inches. Product form minimum is 0 with 0.01-inch steps. |
| Width (in) | Packed package width in inches. Product form minimum is 0 with 0.01-inch steps. |
| Height (in) | Packed package height in inches. Product form minimum is 0 with 0.01-inch steps. |
| Weight (lb) | Packed package weight in pounds. Product form minimum is 0 with 0.01-pound steps. |
Check the result
Configured shippable products can request shipping rates, and staff can buy a label through the shipment flow. The chosen file type, layout, sender details, and printer check the generated label output.
Troubleshooting
- Product shipping fields are missing: confirm Shippo is enabled, the API key has been saved, and the product is marked Shippable.
- Rates cannot be loaded: check the recipient address, package measurements, sender details, and Shippo connection. The current UI may show that a delivery estimate is not available when no rate is returned.
- Printer list is empty: use the desktop app, choose Refresh, and confirm the intended printer is available to that workstation.
- Label is the wrong size or format: review Label File Type, Label Layout, printer selection, and real label stock.
- Rate is unexpectedly high: verify the packed dimensions and weight. Ready-To-Ship Package values must describe the packed parcel; Dispatch Pro’s loose-bulk measurements belong in Delivery Product Capability.