Skip to main content

Data Interface Requirements

Judi Zietsman avatar
Written by Judi Zietsman
Updated over 3 months ago

Quick Summary: This article describes the complete set of data input requirements for a custom integration with Netstock Inventory Advisor. It defines file formats, naming rules, validation methods, and required vs. optional data files.

Data Extraction Scheduling

  • Daily refresh required: Netstock requires a full daily refresh of source data.

  • Recommended timing: Run data extraction at midnight or early morning.

  • File delivery: Files are exchanged with Netstock via a secure transfer service.

    • In some cases, this is handled by a local integration program installed on a server.


File Format

All source files must follow the CSV (Comma-Separated Values) format.

General rules:

  • File names must match the required specification exactly (all-lowercase).

  • No column headings should be included (except in custom ut_###.csv files).

  • If a field is not provided, its position must still be included (leave blank values by placing a comma).

  • All character fields must be wrapped in double quotes (e.g., "ABC123").

  • Character fields must not include line breaks or carriage returns.

  • Double quotes inside field values must be escaped by doubling them ("").

  • Files must use UTF-8 encoding. This enables faster processing and error-free handling of symbols, emojis, and foreign language characters.


Data Validation Service

Netstock provides a data validation service to confirm file validity. Regional services ensure compliance with data sovereignty requirements.


Unit of Measure

All stock-related quantities must use a common unit of measure (β€œNetstock UOM”):

  • Typically, this should be the stocking UOM.

  • It must be granular enough to avoid decimals in Netstock.

  • Any required conversions (e.g., cases β†’ units) must be performed by the data extraction process.


Data Files

The following table summarizes input files accepted by Netstock:

Data

File Name

Importance

Description

location.csv

Required

Physical stocking locations (warehouses and branches)

supplier.csv

Required

Active vendors

master.csv

Required

Basic product information

stock.csv

Required

Data about products at locations, including current stock position

lots.csv

If Applicable

Stock lots and expiration dates

group.csv

Required

Codes and descriptions for custom fields

sales.csv

Required

Sales and returns transaction history

po.csv

Required

Outstanding purchase/production order lines

co.csv

If Applicable

Outstanding customer order lines

transfer.csv

If Applicable

Outstanding transfer lines

pohist.csv

Preferred

Completed purchase order lines and receipts

control.csv

Required

Information about the interface and data extraction

bom.csv

If Applicable

The relationship between finished goods and raw materials

supersessions.csv

If Applicable

Product replacement relationships

ut_###.csv

If Applicable

Custom file(s) for customised business rules


Data Types

Data Type

Description

Char

Text up to 255 characters long.

Integer

Numeric values without a decimal component.

Decimal

Numeric values with a 12-digit maximum, including 4 decimal places. Decimal places must be delimited by a full-stop character.

Date

Date values should be formatted as YYYY/MM/DD. For example, 22 August 2011 should be provided as 2011/08/22.

Bit

Valid values are 0 (false) and 1 (true).


A Note About Lead Times

Accurate lead times are critical to Netstock. Availability varies across ERP systems, so multiple methods are supported (ranked from best to fallback):

  1. Preferred: Provide lead times in the Stock file (stock.csv).

  2. Alternative #1: Provide lead times in the Supplier file (supplier.csv).

  3. Alternative #2: Maintain lead times manually in Netstock.

  4. Alternative #3: Let Netstock calculate lead times automatically from Completed Purchase Orders (pohist.csv).


Forget about these πŸ‘‡ 😞 😐 πŸ˜ƒ Have your say here!

Did this answer your question?