Book a parcel
What's in it — picked from your stock with us. Optional.
Or paste a spreadsheet. First row is the header. Rows for
people you have delivered to before need only
recipient_phone; anyone new needs a
destination as well — a landmark is enough.
Send something now
One pickup, one drop, priced on distance. Different from a parcel: we come and collect it.
Your delivery credit
| When | How | Amount | State |
|---|
| Ref | Held since | Short by |
|---|
How we are doing for you
| Ref | Sent | Outcome | Journeys | Promised | Charged |
|---|
| Month | Parcels | First time | Delivered | Promised | Kept | Charged |
|---|
Your parcels
| Reference | Your ref | Destination | Cash | State | Proof |
|---|
What we're holding for you
Counted from the warehouse ledger, not from a stock sheet. Available is what we could pick today; promised is already allocated to an order.
| Code | Product | Here | Promised | Available | Shipped | Written off | Last movement |
|---|
Stock reports
Dated, numbered, and each one carries the movements since the one before.
| # | As of | Products | Here |
|---|
Your bills
One statement a week, covering Monday to Sunday and issued on the Monday after. Owed to you now is your live balance — it moves with every delivery, so the difference between it and your newest statement is the work next Monday will bill.
| Week commencing | Issued | That week | Closing balance |
|---|
Every line is one posting in our ledger, frozen on the day this statement was issued. Nothing here is recalculated.
| Date | What for | Parcel | Amount |
|---|---|---|---|
| Movement that week | |||
Your invoices
What Osoro has billed you, and what is still owed on each. Pay from your phone with one press — you approve it on the handset — or by transfer to the account on the PDF.
| Invoice | Issued | Due | Amount | Still owed | Status |
|---|
Claims
A parcel arrived damaged, short, or not at all? Tell us which parcel and what it cost you. We look at the delivery record and answer here; an accepted claim becomes a credit note on your next statement.
| Parcel | What | Claimed | Raised | Answer |
|---|
Developers
Your own software can book parcels and follow them: make a key here, keep it on your server, and read the API guide. A key is shown once. Revoke one the moment you think it has leaked.
| Key | Ends in | Made | Last used | Booked |
|---|
Your new key. Copy it now — it is not shown again.
Webhooks
An HTTPS address of yours. Every event on your parcels is posted to it as it happens, signed with a secret shown once. If your server is down we try again for two days; every attempt and its answer is listed here.
| Address | Events | Status | Waiting |
|---|
Blank sends the seven booking events. To also hear about claims, returns, what the
customer asked for and a missed delivery time, name them: claim.decided,
return.requested, return.decided, return.collected,
booking.instruction, booking.late.
The signing secret for this address. Copy it now — it is not shown again.
Verify X-Osoro-Signature with it as the guide describes.
Your shop
Connect a Shopify or WooCommerce shop and a paid order becomes a delivery on its own; when the rider hands it over, the order is marked fulfilled with the tracking link. Unpaid orders book only when the payment method is cash on delivery.
| Shop | Paste this address into the shop's webhooks | Orders | Status |
|---|
In Shopify admin: Settings › Apps and sales channels › Develop apps — create an app
with read_orders and write_fulfillments, install it, copy the Admin API access token
(the credential) and the API secret key (the secret that signs webhooks). Then Settings › Notifications › Webhooks:
add orders/paid, orders/create and orders/cancelled with the address we give you.
Connected. Paste this address into your shop's webhook settings for each topic listed:
Weekly reports
Published every Monday for the week before. The addresses table is the one worth acting on.
| Week commencing | Drops | On time |
|---|