| Term | Id | What it is |
|---|---|---|
| Organization | The API key selects it. | Your account with Beach. |
| FBO (For Benefit Of) account | id. vaultId is PV-###### and is not that id. | One customer. Items, inbound shipments, and outbound shipments belong to one FBO account. |
| Primary FBO | The row with isPrimary: true. | Created with the organization. One per organization. Pass it when the inventory belongs to you. |
| Product | id from List Products. | A catalog SKU. Shared. Not a piece in the vault. |
| Inventory item | id. | One physical piece of a product on one FBO account. It is readable once the inbound shipment is accepted. |
| Inbound line | inventoryItemIds on the line. | The accepted units of one product on an inbound shipment. |
| Alias | aliasVaultId. | A 7–20 digit id that resolves to the same FBO account at intake. Separate from vaultId. |
| Address | id. | A return, billing, or alternate location stored on the FBO account. The intake address is not one of these. |
| Insured ceiling | maxInsuredValueCents. | The account ceiling is on Get FBO Account. The organization has its own. Format is on Conventions. |
Inventory status
Shipment statuses are on the inbound, transfer, and outbound lifecycles. Inventory has these:| Status | Meaning |
|---|---|
in_vault | The item is readable on List Inventory. |
pending_transfer | fboAccountId is still the source account. Journeys says this can be skipped. |
pending_outbound | The outbound shipment is being prepared. That change sends no inventory webhook. |
shipped_out | The item has left. Delivery stays on the outbound shipment. |