FAMA LOGISTICS Operations Platform

Last sync 09:42 CST / 03:42 CAT

Need support? Our team is ready to help.

Dashboard

Search Lang

Action Secure Sign in to load actions.

Login required-Sign in to load dashboard

Branch operating snapshot

All branches at a glance

Branch	Entity Type	Manager	Warehouse Stock	Sales	Shipments	Expenses	Status	Actions
Sign in to load dashboard

Today’s action queue

Sign in to load actions

Exception follow-up log

Assigned owners, due dates, and resolution status

Follow-up	Exception	Branch	Owner	Due	Status	Action note	Actions
Sign in to load data

Branch directory

Each branch has a manager and assigned operating scope

Branch	Country/City	Manager	Staff	Role	Market Report	Status	Actions
Sign in to load data

Role permissions

Founder role can be assigned to multiple trusted founder accounts Founder Account 1: Founder / CEO Founder Account 2: Co-founder / Director Founder accounts see all branches, update stock, and approve expenses Manager sees own branch and updates stock Warehouse staff updates stock only Accountant approves expenses Client tracks own shipment only

Staff account directory

Real login accounts scoped by branch and role

Name	Email	Role	Branch	Status	Created	Actions
Sign in to load staff

Client records0Sign in to load

Wholesale buyers0Sign in to load

Logistics clients0Sign in to load

Mixed clients0Sign in to load

Follow ups0Sign in to load

Clients manager

Archive, restore, or permanently delete client records.

Sign in to load client records

My logistics app

Shipments, invoices, swaps, replies

Shipments0Own logistics records

Open invoices0Awaiting payment

Currency swaps0Requests and replies

ShipmentsSign in to load shipments

InvoicesSign in to load invoices

Service requestsRequest air, sea, documents, or consolidation help

Founder replies appear here.

My account

Email, country, and active client access

NameLogin required

EmailLogin required

CountryLogin required

Client profile

Required during transaction

Client database

Cumulative real client record

Client	Phone	Country	Type	Transactions	Last Activity	Status	Actions
Sign in to load data

Client history

Latest client activity

Sign in to load data

Founder currency swap inbox

Requests to review

PendingLogin as Founder to load requests

Currency swap conversation

Founder replies are sent to the client account

Select a request to review the latest client/founder exchange.

Currency swap desk

Founders review and reply here

Request	Buying	Paying	Status	Actions
Sign in to load data

Product records0Sign in to load

QR identities0Sign in to load

Categories0Sign in to load

Destination branches0Sign in to load

Stock units0Sign in to load

Product master list

Single source of truth for goods

Stock Keeping Unit	QR ID	Product	Category	Supplier	Landed Cost	Sell Price	Stock	Margin	Batch	Destination	Actions
Sign in to load data

Product record fields

Product identityName, stock keeping unit, QR ID, category, photos

Purchase detailSupplier, buy price, batch

Sales detailBranch selling price and margin

Movement detailWarehouse, container, status

Restock / market demand applications

Branch demand requests requiring Founder decision

Request	Branch	Product	Current	Requested	Demand	Target Price	Status	Actions
Sign in to load data

Login required-Sign in to load stock

Warehouse view

Choose location

QR scan console Open a goods record from carton, pallet, or client package code

QR ID Scan location Action Scan result appears above the table

Proof centerPhotos, invoices, labels, evidence

PhotosCartons, pallets, damage

Supplier documentsInvoice, packing list, and delivery note

QR historyScans linked to goods

ReviewApprove sale or transfer

Goods in warehouse

System quantity versus counted quantity

QR ID	Stock Keeping Unit / Batch	Goods	Warehouse	System Qty	Counted Qty	Reserved	Condition	Proof	Status	Actions
Sign in to load data

Proof packet

Login required

Secure

QR record Scan to open full goods record, count history, photos, supplier, and movement trail.

PhotoStack A count label

InvoiceSupplier invoice attached

Manager noteConfirm before sale or transfer

AuditSign in to load audit

01 Receive supplier/client goods Source, supplier, quantity, warehouse, QR.

02 Print and attach QR Link stock, proof, dispatch, and transfer.

03 Upload arrival proof Add invoice, packing list, or photos.

Inbound receipt

Warehouse staff entry

Print and attach QR Attach to carton, pallet, or client package before warehouse storage.

Inbound queue

Received, inspected, and stored

ID	QR ID	Date	Goods	Source	Warehouse	Qty	Proof	Status	Actions
Sign in to load data

01 Outbound release control Scan QR, confirm quantity, route, and payment.

02 Attach loading proof Upload photo, waybill, or receiver proof.

03 Create shipment tracking Create sea, air, road, or port tracking.

Outbound dispatch board

Reason and proof required

ID	QR ID	Reason	Goods	From	Destination	Qty	Transport	Status	Actions
Sign in to load data

Dispatch documents

OUT-4407

Outbound noteApproved by China HQ Admin

Truck proofDriver ID and loading photos

Client goodsClient can track own shipment

Logistics command center

China-to-Africa logistics, tracking, service requests, and client support.

Global freight solutions

Real-time visibility

Dedicated client support

Secure & compliant

0active shipments

0in transit (sea)

0in transit (air)

0in transit (road)

0at port

♢ Trusted logistics partner for China-to-Africa trade Real-time tracking Global network On-time delivery Secure handling

IN TRANSIT

Air freight Request urgent China-to-Africa cargo movement with live updates and express clearance. Request service

GLOBAL LANES

Sea freight Container and LCL shipment support with port progress and competitive rates. Request service

SMART GROUPING

Consolidation Store supplier parcels at the China warehouse, group them, then dispatch together. Request service

REAL-TIME RATES

Currency swap Swap between USD, RMB, and local African currencies securely within FAMA. Request service

Service noticesTracking and service requests are live. Login is required before submitting private requests.

FAMA LOGISTICS APP

Track China-to-Africa cargo in real time.

Follow shipment stages, request logistics support, and keep your FAMA support thread close.

Air + SeaChina to Africa lanes

ConsolidationPackage grouping and shipment preparation

TrackingShipment progress and service updates

✈Air freightFast cargo movement with live updates.

▣Sea freightContainer and port progress in one place.

⌁ConsolidationPackage grouping and shipment preparation.

View current FAMA rates

Published freight and currency swap estimates

No published rates yetFAMA will publish current rates here.

Consolidation workspace

Store supplier parcels at the FAMA China warehouse, group them, then dispatch together.

Forwarding rule Always include your FAMA client code when suppliers send goods to the China warehouse.

1

My FAMA China receiving address

Use this address when suppliers deliver goods to FAMA for inspection, storage, consolidation, or export.

Consignee: FAMA client code
Company: XIONGAN FAMA LOGISTICS CO. LTD SHENZHEN BRANCH COMPANY
Address: China receiving warehouse, FAMA Logistics desk
Phone: Assigned by China warehouse
Postcode: 518000

PrecautionYour FAMA client code must be included in the consignee or address line so warehouse staff can identify your package.

3

Pack, quote, pay, dispatch

Warehouse receivingFAMA confirms arrival and scans package identity.

Inspection and groupingWarehouse checks goods category, volume, and export readiness.

Fee and dispatchWarehousing, packing, freight, and destination movement are confirmed before shipment.

Shipment stages

Login required

China warehouseGoods received

Origin portSign in to load port status

Sea transitVessel departed

CustomsSign in to load customs

Local warehousePending delivery

Branch transfer board

Request, approve, ship, and receive inter-branch stock moves

Transfer	QR ID	Goods	Source	Destination	Qty	Cost	Shipment	Status	Actions
Sign in to load data

Shipment tracking board

Client and internal logistics records

	Shipment	QR ID	Client	Mode	Origin	Destination	Container/AWB	Expected arrival	Stage	Status	Actions
Sign in to load data

Sales orders--Sign in to load

Invoices issued--Commercial invoice PDF records

Outstanding balance--Invoices needing payment follow-up

Paid receipts--Receipt PDFs issued after payment

Payment risk--Partially paid or overdue invoices

Shipping quotes

Formal pricing documents — Draft → Issued → Accepted → auto-invoice

Quote	Client	Branch	Service	Route	Total	Valid until	Status	Actions
Sign in to load quotes

Wholesale sales ledger

Branch trading records

Order	Invoice	Client	Phone	Branch	Product	Qty	Total	Payment	Stock Rule	Actions
Sign in to load data

Sales summary

This month

Paid sales-

Pending-

Top branch-

Top product-

Invoice workspace

Sales Orders → Invoices → Payments → Receipts

FAMA LOGISTICS Commercial Invoice

Verify invoice

Invoice No.-

Client-

Phone-

StatusLogin required

Product	Qty	Unit Price	Total
Sign in to load invoices

Useful statusesQuotation, Proforma invoice, Commercial invoice, Paid receipt

Payment statesDraft, sent, partially paid, paid, overdue, cancelled, refunded

Audit trailSign in to load audit.

Scan QR or enter invoice number to verify payment status.

Stock rules

Draft invoice does not reduce stock Proforma invoice can reserve stock Confirmed commercial invoice deducts stock Cancelled invoice restores stock Refunded invoice requires founder/finance review

Outbound transfers

Transfers sent from your branch

ID	To	Currency	Amount	Method	Reference	Status	Submitted	Actions
Sign in to load data

Inbound transfers

Transfers received by your branch — confirm or dispute

ID	From	Currency	Amount	Method	Reference	Status	Submitted	Actions
Sign in to load data

Expense entry

Manager submission

Branch Category Amount Currency Description

Approval queue

Proof required before approval

ID	Branch	Manager	Category	Amount	Proof	Status	Actions
Sign in to load data

Profit by branch

Revenue − cost of goods − expenses, in each branch's own currency. No conversion.

Branch	Currency	Revenue	Cost of goods	Gross profit	Expenses	Net profit	Margin
Choose a date range and click Calculate.

Report library

Inventory ReportDaily

Stock by warehouse

Available, reserved, damaged, missing, and in-transit quantities.

Branch scopedLogin requiredExport CSV

Shipment ReportDaily

Goods in transit

China warehouse, port, sea/air, customs, local delivery, and completed states.

Branch scopedLogin requiredClient view

Branch Transfer ReportDaily

Inter-branch stock movement

Requested, approved, in-transit, received, and proof status for goods moved between branches.

Source branchDestination branchProof status

Expense ReportWeekly

Proof and approval

Branch expenses by manager, category, proof status, and approval decision.

Branch scopedLogin requiredAudit ready

Sales ReportDaily

Wholesale sales performance

Orders, invoices, clients, payments, stock rules, and totals by branch.

Local currencyPaid statusExport CSV

Restock Demand ReportWeekly

Market demand requests

Branch restock applications with requested quantity, target price, urgency, supplier notes, and approval status.

Demand signalFounder decisionExport PDF

Currency Swap ReportWeekly

Client currency swap desk

Client swap requests, source and target currencies, rates, proof, status, and responsible sales staff.

Swap statusProof trailExport CSV

Exception ReportLive queue

Unresolved operational issues

Queue items from stock, expenses, shipments, sales, transfers, and restock requests.

SeverityNext ScreenExport PDF

Audit Trail ReportLive

User actions and record changes

Founder-only history for logins, invoices, stock, expenses, uploads, notifications, and exports.

Founder onlyExport CSVExport PDF

Notification Delivery ReportLive

WhatsApp and SMS delivery evidence

Provider SID, failure reason, recipient, channel, and queued-by history.

Role scopedExport CSVExport PDF

Invoice Aging ReportDaily

Outstanding receivables by age

Unpaid and partially paid invoices grouped by branch, client, balance, and aging bucket.

Local currencyPayment riskExport PDF

Client Statement ReportOn demand

Client invoice and payment statement

Invoice totals, paid amounts, balances, payment status, and PDF links by client.

Client ledgerLocal currencyExport CSV

Founder brief

Snapshot

Best sales branchLogin as Founder to load

Highest stock riskLogin as Founder to load

Most active portLogin as Founder to load

Expense riskLogin as Founder to load

Report preview

Generate a report to preview live rows before export

Report	Scope	Rows
Sign in to load reports

Document archive

Invoices, receipts, uploaded proofs, and generated reports

Type	ID	Title	Branch	File	Status	Created	Actions
Sign in to load data

Audit trail

Founder-only history of user actions and record changes

Search Branch Action Record type

Time	User	Action	Record	Branch	Details	Actions
Sign in to load audit

Report subscriptions

Scheduled report reminders for founders and branch managers

ID	Report	Frequency	Channel	Recipient	Status	Next run	Owner	Actions
Sign in to load subscriptions

Notification outbox

Queued WhatsApp, SMS, and operational reminders

Time	Channel	Recipient	Message	Status	Related record	Provider	Queued by	Actions
-	Ready	Manager	Open backend to load live notifications	Ready	-	-	System	-

Database--Sign in to load

Schema--Migration status

Storage--Upload directories

Notifications--Provider status

Recent errors--Server log review

Runtime and storage

Not loaded

Area	Status	Path
Login as Founder to load system health

Latest backup

Database safety copy

No backup loaded Create a backup from Settings before major updates.

Offsite backup

Separate copy outside the app backup folder

Offsite backup not loaded Configure an offsite destination and sync the latest verified backup.

Scheduler monitor

Automatic backup, report, and health job status

Scheduler not loaded Login as Founder to load automation status.

Recovery actions

Founder controls for backups, alerts, jobs, and notification dispatch

Recent server errors

Latest structured error log entries

Time	Request	Path	Error	Message
No server errors loaded

Automation job history

Recent scheduled and manual founder operations

Time	Job	Status	Run date	Details	Actor
No automation jobs loaded

Pilot launch control

Founder view of live readiness, blockers, backups, notifications, and go-live actions

--ready

Login as Founder to load launch readiness

Mode not loaded

Open blockers

Launch readiness has not been loaded

Next founder actions

Go-live checklist Login as Founder to load checklist

1

Checklist not loadedFounder launch steps appear here

Configuration tables

Admin-managed basic settings

Languages5 values

EnglishChineseFrenchPortugueseSwahili

Currencies6 values

USDRMBBWPNADZMWNGN

Warehouses16 configured values

China HQ warehouseChina branch warehousesAfrica trading warehousesPortTransit

Categories2 values

ProductsExpenses

Roles6 values

FounderManagerWarehouseSalesFinanceClient

Role permission matrix

Visible modules, branch scope, and approved actions by account type

Role	Scope	Modules	Actions
Sign in to load roles

Branch company profiles

Legal names, currencies, warehouse addresses, invoices, and PDF details

Logo	Display	Legal name	Country	Currency	Invoice prefix	Manager	Actions
Login as Founder to load branch profiles

Founder-managed rate cards

Publish sea, air, and currency swap rates for clients

Identity & status

Service type Status

Route

Origin Destination

Currency pair

From currency To currency

Pricing

Rate label Rate amount Quote currency Minimum charge Handling fee Min swap amount Max swap amount

Timing & validity

Transit time Valid from Valid until

Notes

Rate note

Rate	Lane	Basis	Price	Minimum	Transit	Status	Actions
Login as Founder to load rate cards

Public announcement banner

Display a notice on the public landing page — rate updates, service alerts, promotions

Status Banner type Headline Effective date Body text Button label Button target

Privacy policy generator

Fill the fields, generate a draft, edit it, then publish for signed-in users

Status Company / legal name Contact email Effective date Governing country / jurisdiction

Data the app collects Name & contact details Shipping / delivery addresses Shipment & cargo details Customs / ID documents Payment & billing info Account credentials Device & usage data Support communications

Policy content (editable — generate, then refine)

Terms of Service generator

Founder-set Company / Contact / Jurisdiction / Effective date. Generate, review, publish for all signed-in users.

Compliance Statement generator

Multi-jurisdiction AML / KYC / data-protection summary published alongside Terms and Privacy.

Notification preferences

Branch delivery channels for automatic operational updates

Branch	WhatsApp	WhatsApp recipient	SMS	SMS recipient	Actions
Login as Founder to load notification preferences

Notification template preview Updates with the selected interface language

Language English

WhatsApp Sign in to load the WhatsApp template

SMS Sign in to load the SMS template

Production readiness

Public URL, SMTP email, backups, and HTTPS must be configured before launch

Public URL configured for verification links SMTP sender configured for email verification and password reset Secure secret key, database path, upload path, backups, and HTTPS ready

Reset branch data

Wipe a branch's operational records so a manager can start fresh. Accounts are kept; a backup is taken first.

Destructive

Operating branches

The branches available in every picker (New Quote, Sales, Warehouse, etc.). Changes take effect immediately — no redeploy needed.

API keys & integrations

Tokens for external apps (WeChat mini-program, partner integrations).

Webhooks

Push FAMA events (quote accepted, shipment departed, etc.) to external URLs.

Enabled screens

User and role management Product information management Multi-warehouse management Inbound and outbound records Sales, expenses, reports

Accounting — Xero integration

Connect Xero to push journal entries automatically on invoices, payments, expenses, and treasury transfers

Connection status

Loading…

Set FAMA_XERO_CLIENT_ID + FAMA_XERO_CLIENT_SECRET in Fly secrets, then click Connect Xero.

Sync status

Event type	Total	Synced	Pending	Error
Connect Xero to see sync status

Chart of accounts

Push FAMA's GL account structure to Xero (33 accounts). Safe to run multiple times — existing accounts are skipped.

Founder override history

Every Founder edit / void / disable, across all entity types — append-only audit trail.

Entity type Action Since

When	Actor	Entity	ID	Action	Reason	Xero reversal	Detail
Click Refresh to load the override history.