Skip to main content

Uploading POS/Syndicated & Depletions Data

Consumption & Depletions — Step-by-Step Reference Guide

N
Written by Nico Langlois

1. Why POS / Syndicated Data Matters

What uploading POS & Syndicated data unlocks in Confido — and when it's required. Point of sale (POS) data is the fuel that powers a large portion of Confido's forecasting, promotion planning, and performance tracking capabilities. Without it, forecasts are manual and static. With it, Confido can automatically surface insights, flag deviations, power recommendations, and enable salespeople to evaluate promotion ROI against real in-store results.

Uploading POS data enables:

• Automated forecast recommendations — Confido compares your current forecast assumptions (store counts and velocities) against the latest actuals and flags meaningful deviations for your team to review

• Baseline calculation — Confido uses actual in-store scan data to establish and update your baseline store counts and velocities, stripping out promotional lift to show true everyday performance

• Promotion performance reporting — actual lift observed at the register versus what the sales team forecasted

• Base and incremental splitting — when only total units and dollars are available, Confido uses price movement in the data to calculate base vs. promotional volume

• Deduction validation — POS actuals are used to cross-check whether deductions align with actual in-store performance

Note: POS data is not required to use Confido — you can forecast and manage promotions without it. But most of the platform's automation and intelligence features depend on it. The more data you load, and the more frequently you load it, the more value you get out of the platform.

2. Consumption vs. Depletions Data

Understanding the two types of POS data and when to use each one.

Confido supports two types of data uploads, each serving a different part of the forecast and each living in its own dedicated upload section under Sales Actuals.

Consumption

Depletions

What it is

Units scanned through the register — actual consumer purchases in store

Units shipped from distributor warehouses to retailers — a proxy for demand where POS scan data is unavailable

Source

Syndicated data providers (Nielsen, Circana/IRI, SPINS) or direct retailer portals

Distributor portals (UNFI, KeHE) or distributor depletion reports

Granularity

Weekly by retailer and item

Monthly or weekly by distributor and item. Monthly data is automatically split into weekly buckets

Upload cadence

Monthly to start; can be increased to weekly as team comfort grows

Monthly — aligned to how distributor reports are typically issued

Where in Confido

Sales Actuals → Consumption

Sales Actuals → Depletions


3. File Format Requirements

What your data file needs to contain, and how flexible the format is.

3.1 Minimum Required Fields

Regardless of the data source, every upload file must contain at minimum:

Field

Description

Planning Group (Retailer)

The retailer or distributor name. Can be mapped during upload — does not need to exactly match Confido's planning group names on the first upload. Confido remembers the mapping for future uploads.

Week Ending Date

The date the data covers. Various formats are accepted — see Section 3.3 for date handling detail.

Product Identifier

UPC (preferred) or product description. UPC is strongly preferred as descriptions vary across data sources. See Section 3.4 for detail.

Units

Total units sold (consumption) or shipped (depletions). This is the bare minimum metric. Additional metrics improve the quality of analysis.

3.2 Additional Measures (Recommended)

More measures = more capability. The full set of measures Confido can use, and what they unlock:

Measure

What It Enables

Dollar Sales

Required for Confido's automatic base/incremental calculation when a data source does not provide base and incremental separately. Confido uses price movement over time to identify promotional weeks.

Base Units

Pre-calculated base volume from your syndicated provider. If available, upload this instead of having Confido calculate it.

Incremental Units

Pre-calculated promotional lift from your syndicated provider.

Stores Selling

Number of stores scanning the item in a given week. Powers store count driver in the forecast and store count recommendations.

Average Retail Price

Used for elasticity analysis and lift estimation on future promotions.

Note: All of the above measures are available in the major syndicated platforms (Nielsen, Circana/IRI, SPINS). For retailer portal data or distributor depletion reports, you will often only have total units and possibly dollars — this is fine. The upload process accommodates both.

3.3 Date Format Handling

Confido is flexible about date formats. The general rules are:

• Any standard date format works (MM/DD/YYYY, DD/MM/YYYY, YYYY-MM-DD, etc.)

• Two-digit or four-digit year is both fine

• Week ending dates can be Saturday, Sunday, or any day of the week — Confido apportions the data to the correct forecast weeks automatically

• If your data source provides retailer-specific period numbers (e.g., 'Week 10' in a retailer's fiscal calendar rather than an actual date), you will need to translate these to real dates before uploading. Set up a week mapping lookup table in Excel — this is a one-time setup effort that makes every subsequent upload a simple paste-and-go.

Tip: If your Confido forecast week ending is Saturday but a data source provides Sunday week endings, you can either leave them as-is (Confido will apportion correctly) or subtract one day in Excel before uploading so that weeks align perfectly. Both approaches work — alignment is slightly cleaner but not required.

3.4 Product Identification (UPC)

UPC is the preferred product identifier because it is standardized across data sources and Confido's product master. Product description names vary too much between syndicated providers, portals, and internal systems to be reliable.

UPC format is flexible:

• 12-digit raw format (no dashes) — most common

• 11-digit format (leading zero dropped) — supported

• Dashes in various positions — supported

When a UPC in your file cannot be matched to a product in Confido's product master, Confido will flag it during the upload. Do not ignore these flags — investigate each one to determine whether it is:

• A discontinued SKU that can be excluded from future data pulls

• A new SKU that needs to be set up in the product master before the upload will succeed

• A data quality issue (e.g., a UPC associated with two different internal item codes — see Section 5.2)

Note: If your data source does not provide UPCs and only provides distributor-specific item codes or internal F codes, you will need a reference table that maps those codes to UPCs or product descriptions before uploading. Build this lookup once and maintain it as part of your standard data preparation template.


4. Step-by-Step Upload Process

How to upload a consumption or depletions file in Confido.

4.1 Navigate to Sales Actuals

In Confido, go to Sales Actuals. You will see two tabs: Consumption and Depletions. Select the appropriate tab for the data you are uploading. Each tab shows all previously uploaded files with the date uploaded, the planning groups included, and the products included. You can download any past upload from this screen.

4.2 Choose Whether to Split Base and Incremental

Before selecting your file, Confido asks one question: does your file already include base and incremental units separately?

Answer

When to Use It

No — file already has base and incremental

Use this for data from syndicated providers (Nielsen, Circana/IRI, SPINS) that already split base and incremental units for you. Confido will use your pre-calculated values.

Yes — let Confido split them

Use this for data sources that only provide total units and total dollars (e.g., direct retailer portals, some Canadian distributor reports). Confido will analyze price movement over time to calculate base and incremental volumes.

4.3 Upload the File

Drag and drop your Excel or CSV file into the upload area, or click to browse and select it. Confido reads the header row and displays the columns in your file alongside Confido's field schema.

Tip: If you accidentally close or navigate away during the upload, Confido saves your progress. Return to the upload screen and you can continue where you left off — though in some cases the planning group mapping may need to be re-entered.

4.4 Map Your Columns to Confido Fields

This is the core of the upload process. You need to tell Confido which column in your file corresponds to which Confido field. The mapping screen has four sections:

Planning Group Mapping

Map each retailer or distributor name from your file to the corresponding Confido planning group. If your file uses raw syndicated RMA names (e.g., 'TOTAL TARGET') or banner-level names (e.g., multiple Loblaw banners mapping to one planning group), you can select multiple source names and map them all to the same Confido planning group.

Confido remembers every mapping you create after the first upload. The next time you upload a file from the same data source, all previously mapped planning groups are pre-populated automatically.

Note: For data sources where the retailer names in the file are highly granular (e.g., banner-level data), consider adding a planning group column to your Excel preparation template that does the mapping before you upload — this can be simpler than managing the mapping inside Confido on each upload.

Week Ending Date Mapping

Map the date column in your file to the Week Ending field. If your dates include extra formatting noise (e.g., 'WE 4/5/2026' instead of '4/5/2026'), you can clean this up in the upload tool or pre-clean it in Excel before uploading.

Product Mapping

Map the UPC or product description column to the Product field. Confido will automatically match UPCs to products in the product master. Any UPCs that cannot be matched are flagged. Any that were successfully matched in a previous upload are pre-populated.

Metrics Mapping

Map your data columns to Confido's metric fields (units, dollars, base units, incremental units, stores selling, etc.). If your file follows the Confido standard template for a major syndicated platform (Nielsen, Circana/IRI, SPINS), the mapping will auto-populate perfectly. Extra columns in your file that don't map to a Confido field can simply be left unmapped — they will be ignored.

4.5 Review and Fix Errors

After completing the column mappings, Confido validates the data and flags rows with issues. Common issues include:

• Number formatting errors (e.g., units with commas: '1,234' — use 'Fix All Errors' to resolve automatically)

• Date formatting that Confido cannot parse (requires pre-cleaning in Excel)

• Rows with no valid data (e.g., footer rows, copyright lines from syndicated exports — select and delete these in the upload tool)

Use the 'Fix All Errors' button to automatically resolve formatting issues. For rows that cannot be auto-fixed, you can select them individually and delete them, or use 'Delete All Rows With Errors' to remove them all at once. Verify the count of deleted rows makes sense before proceeding.

4.6 Import and Verify

Once all rows are clean and error-free, click Import. Confido will confirm the upload succeeded and the new file will appear at the top of the upload history list with today's date.

After uploading, verify the data came in correctly by checking the forecast for one or two of the planning groups included in the upload. You should see the actuals rows update with the new data. If something looks wrong, you can delete the upload from the upload history screen — it will be removed from the forecast immediately — and re-upload a corrected file.


5. Key Decisions and Best Practices

Important choices your team needs to make about how to manage ongoing uploads.

5.1 Incremental vs. Full Reload

Every time you upload, you have two options:

Recommended approach: Upload the latest weeks only (incremental): Only upload the newest data since the last upload — typically the latest 4 weeks. This is faster, produces smaller files, and prevents any historical data from being changed if a data source issues a restatement.

• Upload the full history (full reload): Upload the entire dataset from the beginning. This captures any restatements or corrections the data provider has made to historical data, but it means your historical actuals may shift when you reload — which can affect previously reviewed recommendations and forecasts.

Decision Required: Your team needs to decide which approach to use for each data source. The recommendation is to default to incremental uploads (latest 4 weeks) for simplicity and stability. Only use full reloads when you have a specific reason to capture historical restatements from the data provider. This decision should be documented and communicated to everyone responsible for uploads.

5.2 Handling Duplicate UPCs

A known edge case: some brands have the same UPC associated with multiple internal item codes in their ERP (e.g., a US retail item and an Amazon/e-commerce item sharing the same UPC, or a US item and an international item sharing the same UPC).

When this occurs, Confido cannot automatically determine which internal item to map the POS data to. Left unresolved, it will return one of the two options — potentially the wrong one.

Solutions to investigate with the Confido team:

• If the item descriptions are different between the two items, Confido may be able to use the item description as a secondary identifier to distinguish them

• Adding a lookup column to your Excel preparation template that explicitly maps the UPC to the correct item for each data source (e.g., when uploading US retail data, always map this UPC to the US retail item code)

• Working with the Confido engineering team to add source-specific logic if the issue is widespread

Important: Do not ignore UPC mapping errors during upload. Investigate each one. A UPC that silently maps to the wrong item will corrupt the forecast actuals for that item and may not be noticed until recommendations start behaving unexpectedly.

5.3 Preparing Data for Non-Standard Sources

For data sources that do not follow a standard format — retailer portal exports, Canadian distributor reports, broker-provided files — set up an Excel preparation template for each source before your first upload. The template should:

• Map retailer-specific week numbers or period codes to real calendar dates

• Map distributor or retailer item codes to UPCs or product descriptions

• Map banner-level retailer names to Confido planning group names if needed

• Strip out any footer rows, copyright notices, or metadata that would cause upload errors

Once built, the template becomes a simple paste-and-go step before each monthly upload. The one-time setup cost is worth the ongoing time savings and error reduction.

5.4 Recommended Upload Cadence

Start with monthly uploads for all data sources. This gives the team time to build comfort with the process and establish quality checks before increasing frequency. As the team becomes more confident and if more real-time insights are needed, individual data sources can be moved to weekly uploads.

Note: For depletions data specifically, monthly is almost always the right cadence since most distributor reports are issued monthly. For consumption data from syndicated providers, weekly is available if desired but monthly is sufficient for most use cases at the start.


6. Depletions Upload Specifics

How depletions uploads differ from consumption uploads, and what to expect from pre-configured distributors.

The depletions upload process follows the same steps as consumption uploads with a few key differences.

6.1 Monthly Data is Automatically Split to Weeks

Most distributor depletion reports are issued monthly — you receive one total number per item per month rather than weekly data. When you upload a monthly depletions file, Confido automatically splits the monthly total evenly across the weeks in that month. This means you will see depletion actuals in weekly buckets in the forecast view, even though you only uploaded monthly data.

Note: There is no action required on your part to split monthly data — Confido handles it automatically. Just upload the monthly total and Confido distributes it to the correct weeks.

6.2 Store Counts in Depletions

Unlike consumption data, depletions data typically does not include a 'stores selling' measure. This is normal. Confido derives store count information for depletions customers from the item-level data itself — the number of stores that ordered in a given period is counted from the underlying store-level depletion lines. You do not need to provide store counts separately for depletions uploads.

6.3 Pre-Configured Distributors (UNFI, KeHE)

For the major US distributors — UNFI and KeHE — Confido has pre-configured upload templates. When you select these distributors in the depletions upload screen, Confido already knows the expected file format from the portal and has all column mappings pre-set. You simply download the depletion report from the UNFI or KeHE portal in the expected format and upload it — no mapping work required.

For other distributors (including Canadian distributors), the first upload requires the same column mapping exercise as a consumption upload. Confido remembers the mapping for all subsequent uploads from the same source.


7. Frequently Asked Questions

Common questions from teams setting up POS data uploads for the first time.

Q: Can I upload data even if it covers weeks I've already uploaded before?

A: Yes. Confido handles overlapping data gracefully — if the new file covers weeks that were already uploaded, Confido uses the most recently uploaded file for any overlapping weeks. This means a full reload will update historical actuals with whatever is in the new file, while an incremental upload of only new weeks will leave historical data unchanged.

Q: What if my data source uses the retailer's fiscal week numbering instead of calendar dates?

A: You will need to convert retailer fiscal week numbers to real calendar dates before uploading. The recommended approach is to build a week-number-to-date lookup table in Excel and use a VLOOKUP as part of your standard data preparation template. This is a one-time setup per retailer and makes every subsequent upload straightforward.

Q: My data source only provides total units — no base or incremental split. Can I still upload it?

A: Yes. When starting the upload, select 'Yes — let Confido split base and incremental for me.' As long as your file also includes dollar sales, Confido will analyze price movement over time to calculate which weeks were promotional (incremental) and which weeks were baseline. If your file has only units and no dollars, Confido can still ingest it but cannot calculate the split — you will only have total units in the forecast for that planning group.

Q: A UPC in my file is flagged as unmatched. What should I do?

A: Investigate before proceeding. Determine whether the UPC belongs to: (a) a discontinued SKU — in which case you can exclude it from future data pulls; (b) a new SKU that needs to be set up in the product master; or (c) a shared UPC situation (same UPC on two different internal item codes). Do not ignore unmatched UPCs as they represent real scan data that is being excluded from the forecast.

Q: How often should we upload data?

A: Start with monthly uploads for all data sources. This is manageable for a team new to the process and sufficient for driving meaningful forecast recommendations. As comfort grows and if more real-time insights are needed, individual sources can be moved to weekly. Depletions data is almost always monthly regardless of cadence preference.

Q: I uploaded a file and something looks wrong in the forecast. Can I undo it?

A: Yes. Go to Sales Actuals → Consumption (or Depletions), find the upload in the history list, and delete it. The data will be removed from the forecast immediately. You can then correct your file and re-upload.

Did this answer your question?