Skip to content

Billings ​


Table of Contents ​


1. Use Cases ​

Quick links: Invoicing a merchant | A merchant disputes a charge | Charging for work outside the contract

Case 1: Month-end invoicing for every merchant ​

Situation: The billing date has arrived and finance needs to invoice each merchant you work with. Over the past month the warehouse received their goods, shipped orders, ran processing jobs, consumed packing materials, and held their stock in storage the whole time. All of it has to become a number, and that number has to be defensible.

Use this feature: Every night the system converts the day's operations into charges using each merchant's rate settings and accumulates them into that merchant's current billing. Find the billing by merchant and period in the billing list, open the billing detail to review it line by line, and confirm it once the amount is right.

Result: You hold a finalised billing where every charge can be traced back to its source. Finance can invoice directly from it, and the merchant sees the exact same content in their own portal — both sides are reading one bill.


Case 2: A merchant calls to ask why this month costs more ​

Situation: After receiving the bill, a merchant points out that storage went from 30,000 last month to 50,000 this month and asks you to explain the difference. "That's what the system calculated" is not an answer — you need something you can point at.

Use this feature: Every charge keeps the basis it was calculated from. Storage shows the billable quantity of each product or shelf on that day, operation fees show which document and which activity was charged, and each line records the rate card version that applied on the day the charge occurred. Expand the calculation detail in the billing detail to compare the two periods; to lay both periods out day by day in one file, use Export by range with that merchant and a date range covering both.

Result: You can state whether the increase came from stock sitting longer or from higher shipment volume, instead of talking around it. The dispute stays about facts and does not turn into a trust problem.


Case 3: You agreed to charge for work outside the contract ​

Situation: This month you repacked a batch of returns for a merchant as a one-off and agreed a fee for it. Work like this is not one of the priced items on the rate card, so the system will not pick it up.

Use this feature: Before the billing is confirmed, add an adjustment item manually in the billing detail with the date, description, quantity and unit price. Refunds go through the same entry point — enter a negative unit price.

Result: The amount is folded into that merchant's period total and appears in both reconciliation and export, with no separate bill or follow-up email needed.


2. Features ​

Billings is where you charge each merchant for storage and warehouse operations. Every night the system uses each merchant's rate settings to convert that day's storage, inbound, outbound, return, value-added, processing, consumable and shipping activity into amounts, accumulating them into the merchant's current billing. Here you locate a billing by merchant and period, review the amount, add charges agreed outside the contract, and confirm it — only then does the merchant see it in their own portal. A single billing can be exported from its detail page as the basis for invoicing; to see one merchant's charges over any stretch of dates, export billing details by merchant and date range from this page and use the file to reconcile with the merchant.

Billings - Page overview

Quick jump: Search and filters | List columns | Billing status | Export by range

  • Search: Enter part of a Merchant name to find that merchant's billings. You can also type a year and month (for example 2026-08), but it matches the month the period starts in — if the merchant has a custom cut-off day and the period spans two months (say 08/29–09/28), searching 2026-08 finds it and 2026-09 returns nothing.
  • Merchant: Select several merchants at once to line up the customers you are reconciling together.
  • Status: Multi-select, used to pull out the billings that still need work — filtering to Pending Confirmation alone gives you today's review queue.

The list is sorted by period, newest first. Period, Total Amount, Created At and Merchant can each be used to re-sort by clicking the column header.

2.2 List columns ​

ColumnDescription
MerchantThe merchant this billing belongs to. If your plan serves a single merchant, this column and the merchant filter above are both hidden
PeriodThe billing's start and end dates, which also identify it; click to open the billing detail
StatusDetermines whether the billing can still change and whether the merchant can see it — see billing status
ItemsHow many charge items the billing contains. Operation fees of the same type on the same day are merged into one item, so this is closer to "days × fee types" than to a document count

The remaining columns are self-explanatory. Use the control at the top right of the table to choose which columns to show.

2.3 Billing status ​

StatusWhat it means
AccumulatingThe period has not been settled; nightly billing is still adding charges to it
Pending ConfirmationThe period is settled and the amount no longer grows on its own, waiting for your review
ConfirmedYou have confirmed the amount. Only from this point can the merchant see the billing in their own portal

After the period ends, the system settles the billing to Pending Confirmation automatically during the night once the final day has been billed — you do not settle it by hand. Confirm, revert and close early are all done in the billing detail.

2.4 Export by range ​

"Export" at the top of the page exports one merchant's charges between any two dates to Excel, for reconciling with the merchant. It does not split by billing period, so a range that straddles two periods, such as 07/15–08/14, exports in one go. It is also not an official bill — see "What the file looks like" below. This is available on the warehouse side only; the merchant portal does not have it.

It needs the merchant management export permission, the same one the billing detail export uses. Without it the button shows a lock icon and cannot be clicked.

▸ How to export ​

Click the button to open the "Export Billing Details by Merchant and Date Range" window. All three fields are required, and "Export" stays disabled until they are filled in:

FieldHow to fill it in
MerchantPick one. Only merchants you are authorised to manage are listed; if there is only one, it is selected for you
Date RangeBoth the start and end dates are included. The range may span several billing periods and has no limit in days; the real limit is the number of charge lines (see "Limits and errors" below)
Fee SheetsNine sheets to choose from: Storage Fees, Inbound Fees, Outbound Fees, Return Fees, Value-added Fees, Processing Fees, Consumable Fees, Shipping Fees and Adjustments. All are ticked by default and at least one must stay ticked. The storage detail sheet comes with Storage Fees and cannot be chosen separately

After you submit, the window closes; collect the download link from the notification area.

▸ By charge date, not by billing period ​

Every charge line in a billing has its own charge date — the day that charge actually occurred. Export by range only checks whether the charge date falls inside the range you chose, regardless of which billing the line is attached to. A charge posted after its period has ended is attached to the next period's billing but keeps its original charge date, so exporting by range does not lose it just because it sits on a different billing.

The total does not necessarily equal the sum of several billings, for three reasons:

  1. Charge date and billing period do not line up: the late-posted charge above counts toward the next period on the billing, but toward its original day in the range export.
  2. Storage is rounded to two decimal places day by day, so adding up the days differs by a few cents from calculating the whole month at once.
  3. The range may cover only part of a period.

The amount on the overview sheet is called "Range Total". It is the sum of the charge lines in the range at the moment you export, not the finalised amount on a billing. To invoice from finalised amounts, use the export in the billing detail.

Export by range ignores billing status: charges in billings that are still Accumulating or Pending Confirmation are included. If you hand this file to the merchant, it may contain amounts the merchant cannot yet see in their own portal.

▸ What the file looks like ​

File name: "Charge Details_merchant name_start-end.xlsx", for example "Charge Details_Acme_20260715-20260814.xlsx". It has this format even when you happen to pick a whole month, so it never shares a name with a single billing export, "Billing_merchant name_YYYY-MM".

Overview sheet: the first row states "Export Type: Date-range charge details (for reconciliation; not an official bill)". The information block is always seven rows:

RowContent
Export TypeDate-range charge details (for reconciliation; not an official bill)
Date RangeThe start and end dates you chose, marked "by charge date"
Merchant, Tax IDThe merchant you chose and their tax ID
Range TotalThe sum of the charge lines in the range for the fee sheets you ticked
Billings CoveredWhich billing periods the charge lines in the range belong to, each with its start/end dates and status (Accumulating / Pending Confirmation / Confirmed), separated by commas. More than 20 periods lists the first 20 followed by "… (N periods in total)"
Exported AtWhen the file was generated

Which sheets appear:

  • Always: the overview and the rate settings. The rate settings list only the rates used by the fee sheets you ticked: tick only Inbound Fees and you get only the inbound rates; leave Storage Fees unticked and there are no storage rates.
  • Only when you ticked storage and the range has matching data: shelf settings and product settings. If storage is not ticked, neither sheet appears.
  • By your selection: a fee sheet appears only if you ticked it and the range has data for it. If one kind of charge never occurred in the whole range (for example no returns), that sheet is simply absent and the export does not fail.

Product settings list only products whose billing attributes match the posted record: the product settings hold each product's current units per pallet, unit weight and volume, and the storage detail sheet recalculates every day's billable value from them. If a product's attributes do not match the record at the time its charges were posted (for example, because the product data was corrected afterwards), the file no longer lists it; its storage detail rows use the billable values as posted, and a note is added at the top of the product settings sheet. All other products keep recalculating from the product settings. This way the storage amounts do not drift from the posted amounts.

Rate and shelf settings across periods: if a price changed within the range, each item is listed once per "item + actual unit price", each with the dates it applied. The dates it applied are always the actual start and end dates, for example "2026-07-15 ~ 2026-08-14", or just that date when it applied on a single day. Even a unit price that covers the whole queried range never shows "Full period", because in a range export that wording is easily read as "this price held for the whole billing period". (The export in the billing detail keeps the "Full period" wording.)

▸ Limits and errors ​

SituationMessage on screenWhat to do
Dates incomplete, or the start date is later than the end dateThe date range is invalid. Please provide both dates, with the start date not later than the end date.Pick the dates again
Too many charge lines — more than 200,000This range has N detail rows, which exceeds the export limit of 200000. Please shorten the date range or select fewer fee sheets and try again. (N is the actual number of rows this time)Shorten the range, or untick fee sheets you do not need. The length of the range itself is not limited, only the row count; the system never produces a truncated file
None of the fee sheets you ticked has any charges in the rangeNo records to exportTry another range, or tick more fee sheets
The chosen merchant is no longer within your authorised merchants, or no longer existsMerchant not foundChoose the merchant again

▸ How it differs from the detail-page export ​

The export in the billing detail still exports the whole billing, the file is named "Billing_…", and its overview shows that one billing's amount; export by range looks at the merchant and charge dates and does not correspond to any single billing. The product settings exclusion rule above applies to both — the detail-page export also lists only products whose billing attributes match the posted record.


3. FAQ ​

Quick jump: FAQ | Important notes

3.1 FAQ ​

▪ Do I create billings myself? ​

No. The system creates a billing per billing period from each merchant's rate settings and accumulates charges into it daily. There is no "new billing" entry point in the list — what you do here is review, add adjustments and confirm.

▪ Can one merchant have two billings for the same period? ​

No. A merchant has exactly one billing per billing period; duplicates are not allowed.

▪ Why can't I see the "Merchant" column and filter? ​

When your plan serves a single merchant, the column and its filter are hidden automatically because every billing belongs to the same merchant.

▪ I can't find "Billings" in the menu ​

Billings requires an advanced plan and merchant management permission. If the menu item is missing, ask your plan administrator to check both.

▪ What kinds of charges appear in a billing? ​

Nine: storage, inbound, outbound, return, value-added, processing, consumable, shipping, and adjustments you add by hand. What each one covers and which date it is anchored to is described in the billing detail.

▪ Does Total Amount change on its own? ​

For an Accumulating billing it grows every night as new charges land. After settlement automatic billing no longer writes to it, but adding an adjustment item by hand still recalculates the total.

▪ A merchant says they can't see this month's billing ​

Merchants only see Confirmed billings. If this one is still Accumulating or Pending Confirmation, or it was reverted, their side is empty.

▪ Who decides the billing period? ​

The merchant's rate settings do; the system cuts non-overlapping periods from them. Two billings for the same merchant never overlap.


3.2 Important notes ​

⚠️ Important ​

  • The merchant can only see a billing once it is confirmed, and reverting removes it from their view again. Repeated reverting while a merchant is reconciling makes the billing appear and disappear on their side.
  • "Close Early" pulls the period end back to yesterday, and that period boundary cannot be undone — reverting only removes the confirmation.

💡 Tip: Filtering Status to Pending Confirmation gives you exactly the billings that need reviewing right now; confirm each one as you finish it and whatever remains is still outstanding.


FeatureDescriptionLink
Billing DetailReview charges, add adjustment items, advance the status and exportGo
MerchantsConfigure each merchant's billing method, rate card and periodGo
Value Added ServicesDefine chargeable services that attach to an inbound or an orderGo
Shipping Rate CardsDefine the shipping fee tiers charged to merchantsGo

Last updated 2026-11-16 19:57