Skip to main content

FBN Reports

noon provides a set of inventory reports that give visibility into stock movements, balances, and aging across the fulfillment network. Reports are generated asynchronously and downloaded as files once processing is complete. See the Export API for how to request and retrieve reports.


INVENTORY_LEDGER_DETAILED_VIEW_V2

info

export_category_code: fbn_inventoryv2_ledgerdetailedview

Data availability: last 18 months, up to the previous day.

A detailed record of all inventory movements across the fulfillment network. This report captures every event where stock:

  • Enters the fulfillment network (e.g., inbound)
  • Leaves the fulfillment network (e.g., customer_outbound)
  • Changes operational attributes (e.g., transfer_in, transfer_out)

Optional Search Inputs

Every parameter below is optional. If you omit a filter, the report includes all values for that field—for example, if partner_barcode is not set, the report includes movements for all partner_barcodes.

ParameterDescription
country_codeFilter by country where the inventory is located.
transaction_typeFilter by movement category. See Transaction Types below.
nfskuFilter by noon Fulfillment SKU.
skuFilter by noon SKU.
partner_skuFilter by seller-assigned SKU.
partner_barcodeFilter by seller-provided barcode.

Attributes

ColumnDescription
transaction_dateDate when the movement was recorded.
transaction_typeMovement category. See Transaction Types below.
reference_nrExternal document reference number.
reference_typeType of the external reference. See Reference Types below.
country_codeCountry where the inventory is located.
warehouse_codeWarehouse identifier (e.g., DXB05, AE_IN_TRANSIT).
fulfillment_typeFulfillment type in the warehouse (e.g., fbn, transit).
nfskuNoon Fulfillment SKU assigned to the item.
skuNoon SKU for the item.
partner_skuSeller-assigned SKU for the item.
partner_barcodeSeller-provided barcode for the item.
inventory_conditionInventory condition: SALEABLE or UNSALEABLE.
quantity_deltaSigned quantity change. Positive = inbound; negative = outbound.
qc_fail_item_identifierIdentifier for a set of items that share the same QC reject reason.

Transaction Types

The ledger uses a signed quantity model: positive (+) = inventory in, negative (−) = inventory out.

ValueQuantity SignDescription
inbound+Inventory received into the network.
vendor_returnInventory returned to the vendor.
disposalInventory disposed.
customer_outboundInventory shipped to a customer.
customer_return+Inventory returned by a customer (includes non-delivered returns).
transfer_in+Inventory came in from another warehouse.
transfer_outInventory went out to another warehouse.
transit+/−Inventory in transit between warehouses.
lostInventory recorded as lost.
found+Inventory recorded as found.
damaged+/−Inventory recorded as damaged.

Reference Types

ValueTransaction TypeDescription
sale_item_nrcustomer_outbound, customer_returnSale item reference.
asn_nrinboundAdvanced Shipment Notice reference.
return_request_nrvendor_returnReturn request reference.

Other transaction types do not include an external reference.


INVENTORY_LEDGER_SUMMARY_VIEW_V2

info

export_category_code: fbn_inventoryv2_ledgersummaryview

Data availability: last 18 months, up to the previous day.

An aggregated view of inventory movements for a given reporting period. Each row represents the activity of one noon Fulfillment SKU (NFSKU) within a single reporting window, including:

  • Opening balance
  • Movement quantities grouped by Transaction Type
  • Closing balance

Optional Search Inputs

Every parameter below is optional. If you omit a filter, the report includes all values for that field—for example, if partner_barcode is not set, the report includes movements for all partner_barcodes. aggregate_by_location and aggregate_by_time use the defaults in the table when omitted.

ParameterDescription
aggregate_by_locationCOUNTRY (default) or WAREHOUSE.
aggregate_by_timeMONTHLY (default), WEEKLY, or DAILY.
country_codeFilter by country where the inventory is located.
nfskuFilter by noon Fulfillment SKU.
skuFilter by noon SKU.
partner_skuFilter by seller-assigned SKU.
partner_barcodeFilter by seller-provided barcode.

Attributes

ColumnDescription
dateLast day of the reporting period (depends on aggregate_by_time).
locationCountry or warehouse, depending on the aggregation input.
nfskuNoon Fulfillment SKU assigned to the item.
skuNoon SKU for the item.
partner_skuSeller-assigned SKU for the item.
partner_barcodeSeller-provided barcode for the item.
inventory_conditionInventory condition: SALEABLE or UNSALEABLE.
opening_quantityInventory quantity at the start of the period.
inbound_quantityQuantity received.
vendor_return_quantityQuantity returned to vendors.
disposal_quantityQuantity disposed.
customer_outbound_quantityQuantity shipped to customers.
customer_return_quantityQuantity returned by customers.
transfer_in_quantityQuantity came in from other warehouses.
transfer_out_quantityQuantity went out to other warehouses.
transit_quantityNet quantity in transit between warehouses.
lost_quantityQuantity recorded as lost.
found_quantityQuantity recorded as found.
damaged_quantityQuantity recorded as damaged.
other_quantityQuantity for transaction types not individually listed above.
closing_quantityInventory quantity at the end of the period.

Examples of how aggregate_by_time maps a movement window to the row date (period end):

  • MONTHLY: movements recorded between [2026-01-01 00:00:00, 2026-01-31 23:59:59]date = 2026-01-31
  • WEEKLY: movements recorded between [2026-02-02 00:00:00, 2026-02-08 23:59:59]date = 2026-02-08
  • DAILY: movements recorded between [2026-03-15 00:00:00, 2026-03-15 23:59:59]date = 2026-03-15

INVENTORY_AGING_V2

info

export_category_code: fbn_inventoryv2_aging

Data availability: last 18 months, up to the previous day.

Shows how long current inventory has been held within the fulfillment network by grouping on-hand stock into age buckets.

Optional Search Inputs

Every parameter below is optional. If you omit a filter, the report includes all values for that field—for example, if partner_barcode is not set, the report includes movements for all partner_barcodes.

ParameterDescription
country_codeFilter by country where the inventory is located.
skuFilter by noon SKU.
partner_skuFilter by seller-assigned SKU.
partner_barcodeFilter by seller-provided barcode.

Attributes

ColumnDescription
snapshot_dateInventory snapshot date.
country_codeCountry where the inventory is located.
skuNoon SKU for the item.
partner_skuSeller-assigned SKU for the item.
partner_barcodeSeller-provided barcode for the item.
inventory_conditionInventory condition: SALEABLE or UNSALEABLE.
qc_fail_item_identifierIdentifier for a set of items that share the same QC reject reason.
first_received_dateDate the inventory was first received into the network.
last_movement_dateDate of the most recent inventory movement.
gross_quantityTotal on-hand quantity.
quantity_0_30dQuantity aged 0–30 days.
quantity_31_60dQuantity aged 31–60 days.
quantity_61_90dQuantity aged 61–90 days.
quantity_91_180dQuantity aged 91–180 days.
quantity_181_365dQuantity aged 181–365 days.
quantity_366dQuantity aged 366+ days.