Skip to documentation
Porosi documentation

The operating manual for every connected order.

Configure products, customer accounts, pricing, ordering, fulfilment and finance in the order they depend on one another.

Jump to:
DocumentationConfigure the system and understand each handoff.
Help CentreResolve a live issue or unexpected result.
Current workflow reference · Reviewed
REFERENCE MAP / 01 In sequence
01FoundationBrand · access · team
02CatalogueProducts · units · prices
03AccountsCustomers · rules · access
04OrdersWeb · apps · review
05OperationsPick · deliver · stock
06FinanceInvoice · Xero · export
POROSIOne order.
Every dependency.
06connected areas
30reference guides
Begin in order
01 Implementation order

Build the dependencies once. Then test the whole order.

Porosi works as one connected system, so configuration should follow the same direction as a real wholesale order.

  1. 01
    FoundationConfirm the supplier identity and team.

    Brand, workspace, staff access and implementation owner.

  2. 02
    CataloguePrepare products, units and availability.

    Use one clean product model before assigning customer prices.

  3. 03
    AccountsAttach commercial rules to customers.

    Account access, catalogue visibility, pricing and delivery context.

  4. 04
    OrderingChoose the customer ordering channels.

    Supplier-branded web ordering, iOS and Android share the account model.

  5. 05
    OperationsDefine review, pick and delivery handoffs.

    Decide where staff control exceptions and what can run automatically.

  6. 06
    FinanceProve the invoice round trip.

    Create, amend and reconcile one test order before go-live.

02 Reference library

Find the object, rule or handoff you need.

Showing all 30 documentation references.

01
Foundation

Workspace, people and customer access

01.1
Supplier setup checklist

Prepare the workspace, brand and implementation owner.

Guide
01.2
Permissions and team access

Give staff the access their operational role requires.

Guide
01.3
Invite and manage customers

Connect customer users to the correct trade account.

Guide
02
Products & pricing

Catalogue structure and commercial context

02.1
Manage products, pricing and featured items

Maintain the customer-visible catalogue and its commercial rules.

Guide
02.2
Add products, images, units and availability

Define the product record buyers and operations rely on.

Guide
02.3
Bulk import products and customer prices

Prepare and validate structured catalogue data before launch.

Guide
02.4
Understand missing products or wrong prices

Trace visibility and price back to the selected customer account.

Guide
02.5
Boxes, kilograms, actual weights and stock

Choose the selling unit, capture supplied weights and review what to buy.

Workflow
03
Customer ordering

Supplier-branded web and mobile journeys

03.1
Customer ordering guide

Understand the customer path from account access to submission.

Guide
03.2
Place an order from web, iOS or Android

Use the same account and catalogue context across every channel.

Guide
03.3
Delivery dates, cut-offs and checkout rules

Understand which operational rules shape checkout.

Guide
03.4
Change, cancel or repeat an order

Keep the customer action connected to the supplier workflow.

Guide
03.5
Sense: connected email, WhatsApp and voicemail intake

Bring supported requests into one queue for staff to check and confirm.

Workflow
04
Operations

Review, pick, stock, delivery and reporting

04.1
Admin orders, fulfilment and delivery runs

Follow a submitted order through the supplier dashboard.

Guide
04.2
Process orders, picking and substitutions

Keep staff decisions attached to the same order record.

Guide
04.3
Set up delivery runs and route visibility

Connect fulfilment to the delivery context your team uses.

Guide
04.4
Reports and operational exports

Choose output based on the operational question.

Guide
04.5
Stock, warehouses and Xero sync

Understand the boundary between operational stock and finance.

Guide
04.6
Picking, delivery manifests, invoices and credits

Follow supplied lines into driver paperwork and controlled accounting.

Workflow
04.7
Sense and Insights: included with every plan

Prepare orders and investigate business changes at no extra software charge.

Included
04.8
Paperless iPad and Android tablet picking with scales

Choose a station, capture live weights and confirm each supplied line.

Workflow
04.9
Porosi Bridge, scale stations and Wi-Fi setup

Connect station hardware and recover a network connection from a phone.

Setup
05
Finance

Invoices, accounting handoff and corrections

05.1
Find invoices and understand invoice status

Read the invoice state from the connected order context.

Guide
05.2
Xero invoicing and accounting

Follow the finance handoff without losing the Porosi order.

Guide
05.3
Troubleshoot Xero sync errors

Use the exact validation result and source order to diagnose a failure.

Guide
05.4
QuickBooks availability and rollout

Review the current integration position before planning a handoff.

Product
06
Apps & API

White-label release and approved system access

06.1
Mobile apps and white-label access

Prepare supplier identity, customer access and release ownership.

Guide
06.2
Mobile and web parity checks

Verify the same supported workflow across each customer channel.

Guide
06.3
Request API access

Agree the purpose, scope and validation plan before credentials are issued.

Access
06.4
Plan an integration handoff

Define system ownership and the records that cross the boundary.

Plan
03 Connected object model

One order is the result of six linked records.

Select an object to see what it owns, what controls it and what it passes into the next stage.

OBJECT / 01

Customer account

The commercial identity behind access, catalogue visibility, pricing and delivery context.

Stores
Customer identity, users, delivery details and commercial relationship.
Controls
Which supplier catalogue, account prices and ordering rules apply.
Passes forward
The account context every new order must retain.
Open account reference
04 Products & pricing

Start with the product record. Attach account context after.

Product data describes what can be sold. Customer records determine who can see it and which commercial price applies.

  1. 01
    Product

    Name, category, image, unit, tax treatment and availability.

  2. 02
    Price context

    Base price, pricing tier or a customer-specific override.

  3. 03
    Customer visibility

    The selected account determines the catalogue and price shown.

Porosi supplier products screen showing the product catalogue
REFERENCE 02.1

Review catalogue records before assigning customer pricing.

04A Units, weights & stock

Sell by the box, each or kilogram.

Porosi supports configured Box, Each and kg selling units, with the appropriate product and customer price. Capture an actual weight automatically from a connected scale through Porosi Bridge, or enter it manually. Staff confirm the supplied quantity.

  1. 01
    Choose the selling unit

    Open the order line and select a supported Box, Each or kg option. Review the unit price for that product and customer before saving.

  2. 02
    Change a box order to its actual supplied kg

    For example, if one box weighs 10.840 kg, select the configured kg selling unit. Porosi Bridge sends the live scale reading to the picking app; staff check its stable weight, customer kg price and line total, then confirm it. Manual weight entry is available under Other options.

  3. 03
    Confirm the order, then sync its invoice

    Confirmed weight updates the order quantity and totals. Invoice changes remain pending until staff explicitly choose Sync Invoice. Existing invoice-state and payment controls still apply.

Stock visibility

See what is on hand, committed and incoming.

Inventory shows the stock held, quantities committed to orders, expected incoming stock and projected availability. Maintain minimum levels and review the dated buying report to see suggested buying against projected stock.

Receiving and counting

Keep a record of what changed.

Receive stock with the product, unit, quantity, optional cost, supplier and note. Complete a stocktake for the date and review stock movements with their quantities and reasons.

Keep inventory quantities in a consistent unit. Selecting a sales unit does not automatically convert purchased boxes into a shared kilogram stock balance.

Read the inventory reference
04B Paperless picking

Weigh, confirm and move to the next item.

Use the native iPad or Android tablet picking workspace with a station scale. Live readings arrive in the app; one confirmation marks the item supplied and applies its weight to the order. Existing desktop and phone layouts stay unchanged.

The picking sequence
  1. 01
    Sign in and choose your station

    Pickers use Porosi's admin login with their authorised account, then select a picking station. The selection is remembered for that user and device. Each station has one active tablet; moving control to another tablet requires an explicit takeover.

  2. 02
    Find the order for your delivery date

    Search the tablet orders list, review delivery-date summaries and use status filters with order counts. More orders load as you scroll. Opening an order loads its full details into a split item list and picking workspace.

  3. 03
    Work through the current item

    See the current item and picking progress beside the order list. Coloured item-status dropdowns and sticky picking actions stay close to the work. Use Not Available or Back Order when the requested item cannot be supplied.

  4. 04
    Choose Supply & Next Item

    After reviewing the item and its weight, confirm it with Supply & Next Item. Porosi selects the next item automatically and scrolls it into view, keeping the picker moving through the order.

Live weighing

Use the right scale and a stable reading.

Kg lines support automatic weighing, with a per-line weighing override. The station shows its assigned scale name, live reading and stability state. A warning highlights a difference between the ordered and scaled weight for the picker to review.

Picked-so-far and remaining values animate as the weighing progresses. Recorded weight history and three-decimal kilogram formatting make measurements such as 10.840 kg clear.

Corrections and fallback

Keep the picker in control of the supplied line.

Use Other options for manual weight entry, or replace a confirmed weight when it needs correcting. Edit the unit price inline and review the line total before confirmation. The confirmed weight updates the order quantity and totals; picking and manual changes are audited.

Confirmation and finance

Save once. Sync the invoice deliberately.

Live scale updates use a continuous connection. Porosi checks that a reading is recent and stable before accepting it, and protects confirmations against duplicates and conflicting updates.

An invoice change is shown as pending. Staff choose Sync Invoice explicitly when ready; paid, credited and settled invoice controls still apply. A scale reading by itself does not rewrite an invoice.

See Porosi Bridge and picking hardware
04C Porosi Bridge setup

Connect the scales your picking stations need.

Up to four scales connect to one Porosi Bridge. Each scale can serve a separate picking station, so the picker receives readings from the station they selected.

Hardware and station setup
  1. 01
    Plan the scales and tablets

    Porosi can supply the number of scales your operation needs. Optional supplied iPads or lower-cost Android tablets are restricted to Porosi use. Ask us to include the scales and any tablets in your quote.

  2. 02
    Discover and assign scales

    Station admin settings show unassigned scales so you can connect each one to the intended picking station. Persistent hardware IDs keep the scales identifiable across reconnects.

  3. 03
    Connect the Bridge to the network

    Ethernet is preferred for a dependable warehouse connection. Saved Wi-Fi is used when available. The Bridge starts automatically after its Raspberry Pi restarts and reconnects automatically when its connection returns.

  4. 04
    Check the station before picking

    On the tablet, select the station and check the displayed scale name, connection and reading. Use an explicit station takeover if another tablet currently holds that station.

Plan your Porosi Bridge setup
Set up from a phone

Join the Bridge's setup hotspot.

When offline, the Bridge automatically offers a setup Wi-Fi network named Porosi-Bridge-XXXX. Connect your phone to that hotspot and open the captive setup page. A manual IP-address fallback is available if the page does not open automatically.

Scan nearby Wi-Fi networks and choose the warehouse network, or enter a hidden network. Wi-Fi provisioning works from the phone without connecting a screen or keyboard to the Bridge.

Connection recovery

Retry setup without losing the route back.

Connection failures show clear feedback and a retry route. If a Wi-Fi attempt fails, the Bridge restores setup mode so the phone can reconnect and correct the details. Once connected, the Bridge resumes its automatic reconnect behaviour.

If a scale is unavailable while picking, check the station and connection before continuing. Manual weight entry remains available under Other options; staff still review and confirm the supplied quantity.

04D Sense order intake

Bring incoming requests into one review queue.

Sense captures and prepares supported requests from connected channels. Your team checks the customer, products, units, quantities, prices and delivery details before confirming the order.

Supported intake routes
  1. 01
    Microsoft 365 and Outlook

    Connect a mailbox and select the order folder. Sense checks new changes in the background; accessible shared mailboxes are supported for business accounts.

  2. 02
    Forwarded order email

    Forward supported emails to your dedicated Sense address, including from Gmail or another mail service. Email bodies and supported PDF, document and audio attachments can be prepared for review.

  3. 03
    WhatsApp Business and answerphones

    Connect WhatsApp Business for text messages and voice notes. Compatible phone systems can forward voicemail emails with an attached recording for transcription and review.

  4. 04
    Staff-entered requests

    Paste a message or upload a supported recording when a request reaches the team through another route.

Customer context

Use the catalogue and the customer's history.

Sense uses your product catalogue, reviewed customer order history and prior corrections to help interpret recurring shorthand, products, quantities and units. Staff resolve uncertain matches and missing details.

Confirmation

Prepared automatically. Confirmed by your team.

Automatic capture and preparation save retyping. Staff review remains part of the process: check the draft, make corrections and confirm it into the normal order workflow.

Explore Sense order intake
05 Order lifecycle

The same order moves from customer intent to finance.

Each team works from the shared order record instead of rebuilding it at every handoff.

  1. 01SubmitCustomer account and basket
  2. 02ReviewSupplier decisions and amendments
  3. 03PickActual quantities and substitutions
  4. 04DeliverRun, handoff and progress
  5. 05InvoiceFinal order value and accounting
Porosi warehouse automation settings for automatic order acceptance and picking slip printing
Automation boundary

Accept and print without losing control.

Porosi can send eligible incoming orders to a connected printer as orders arrive and accept them after the picking slip prints successfully. Failed prints and exceptions remain visible for staff review.

Read the picking workflow
Correction boundary

Correct the order within its financial state.

Eligible unpaid invoice changes can update the connected Xero invoice after review. Pending picking changes require an explicit Sync Invoice action. Paid, credited or settled invoices retain financial locks; use the supported credit-note or refund workflow for financial corrections.

Read the invoice workflow
06 Finance & integrations

Know which system owns the decision.

Porosi carries the wholesale order and its operational amendments. Accounting integrations receive the finance record without replacing the order workflow.

Porosi Xero management screen showing connected invoice controls
System ownership matrixFollow the record, not the logo.
Record or decisionPrimary systemDocumentation rule
Customer accessPorosi

Users enter through a supplier relationship and an approved customer account.

Catalogue visibility & account pricingPorosi

The selected account keeps products and commercial rules attached.

Order review & amendmentsPorosi

Operational decisions remain on the source order through fulfilment.

Connected invoicePorosi + Xero

Porosi sends reviewed invoice details to Xero. Further changes follow invoice-state, payment and credit controls.

Ledger, tax reporting & reconciliationXero

The accounting platform remains the finance system of record.

External data exchangeApproved interface

API or ERP access follows an agreed scope and validation plan.

06A Fulfilment, delivery & finance

Keep the supplied order connected to the paperwork.

Resolve picking decisions, prepare the delivery run and invoice from the reviewed order. Each stage keeps the customer, product and quantity context attached.

Warehouse to driver
  1. 01
    Resolve picking and replacements

    Work through To Pick, Supplied, Not Available, Back Order and Substituted lines. Select a replacement product, check its quantity, unit and price, then mark what was supplied. The original and replacement remain linked.

  2. 02
    Plan the delivery run

    Create named runs and assign regular customer defaults. Move orders between runs, reorder stops and save one-off changes for a particular delivery date.

  3. 03
    Prepare driver and warehouse documents

    Export ordered, run-filtered manifests as PDF or CSV. Use product totals for the selected orders to help the warehouse prepare demand before dispatch.

Read the delivery-run guide
Invoice readiness

Resolve trade picking before invoicing.

Ordinary trade orders need unresolved positive To Pick quantities resolved before invoicing. Supplied lines carry the charge; a back-order source can remain visible at zero charge while the supplied follow-up carries its value.

Review the saved quantity, selling unit, price and invoice state before sending the accounting handoff to Xero.

After invoicing

Give a missing or damaged case a clear correction.

Staff can issue a reasoned, line-linked quantity or price credit within the remaining creditable amount. The original invoice stays intact, the customer balance is adjusted and the connected Xero credit can be synced and allocated.

A credit note is separate from a cash refund or a stock return. Paid, credited and settled invoice values are protected from a direct rewrite.

Read the invoice and credit workflow
06B Included intelligence

Sense and Insights come with every Porosi plan.

Sense and Insights are free to use and always included with every Porosi plan. There is no separate Porosi add-on charge for either feature.

  1. 01
    Sense prepares the order

    Bring supported messages and recordings into a reviewable draft using your catalogue and customer history. Staff check and confirm the result.

  2. 02
    Insights highlights what needs attention

    Review customers ordering differently, usual products missing from established buying patterns, demand changes, margin pressure and stock risks.

  3. 03
    Your team chooses the response

    Open the supporting records, assign follow-up, add notes or snooze a signal. Observations help the team investigate; they do not prove why a customer changed or guarantee a future sale.

Useful evidence

Analysis based on your business's own records.

Insights uses relevant order, product and operational history. Buying-pattern signals need enough repeat activity; margin analysis needs sufficient cost coverage; inventory signals depend on maintained stock data.

Getting started

Included in the plan. Set up for your operation.

We help enable the supported workflows and connect the channels your business uses. Staff permissions, available history and applicable order workflows determine what each person can use and which analyses are ready.

Channel setup includes a review of messaging-provider requirements and the permissions your team needs.

See Sense and Insights with your workflow
07 White-label apps & API

A release has two identities: your customer brand and the connected system behind it.

Prepare the app-store identity, customer access and integration boundary as one controlled release.

Supplier-branded Porosi mobile ordering app showing products
01Supplier identityName · icon · colour
02Customer contextAccount · catalogue · price
03Shared workflowWeb · iOS · Android
White-label release packet
  1. 01
    Brand identity

    Supplier name, icon, colours and customer-facing domain.

  2. 02
    Store identity

    App identifiers, listing information and release ownership.

  3. 03
    Test context

    Approved customer account, catalogue, pricing and ordering checks.

  4. 04
    Parity approval

    Confirm supported ordering behaviour on web, iOS and Android.

Read the white-label app overview
API ACCESS / CONTROLLEDPermission comes before credentials.

Porosi API access is not self-serve. Contact us with the system, purpose, records and expected direction of data before an interface is approved.

Request API permission
08 Go-live proof

Do not approve screens. Approve one complete order.

Use a representative customer account and follow the same order through the customer channel, supplier team, fulfilment and finance handoff.

Implementation proofNot started
Need implementation context?

Bring the workflow. We will map the dependencies with you.

Use the Help Centre for an immediate product question. Contact Porosi when the answer depends on rollout scope, data ownership or an approved integration.