UMG-UK
  1. Product
UMG-UK
  • Outbound Orders
    • Get SalesOrder List
      GET
    • Create a SalesOrder
      POST
    • Get Sales Order Information
      GET
    • Sales Order Acknowledgement
      POST
    • Bulk Upload SalesOrders
      POST
    • Get Job Status of an Async Bulk Sales Order Import
      GET
    • Get a single SalesOrder
      GET
    • Update SalesOrder
      PUT
    • Cancel SalesOrder
      DELETE
    • Get Shipments for a Sales Order
      GET
    • Get B2B Customers For Business Unit
      GET
  • Ship Confirmation
    • Sales Order Ship Confirmation
      POST
  • Business Units
    • Get Buildings associated to a Business Unit
      GET
    • Remove associated Building from a Business Unit
      DELETE
    • Associate a Building to a Business Unit
      PUT
    • Get Business Unit Detail
      GET
    • Update Business Unit
      PUT
    • List Business Units
      GET
    • Create Business Unit
      POST
    • Get Business Unit General Settings
      GET
    • Update Business Unit General Settings
      PUT
    • Update Business Unit Amazon SFP Keys
      PUT
    • Remove Business Unit Amazon SFP Keys
      DELETE
    • Get Business Unit Amazon SFP Keys
      GET
    • List Broker Accounts
      GET
    • Create Broker Account
      POST
    • Delete Broker Account
      DELETE
  • Product
    • Batch Upload SKUs
      POST
    • Get Product Information
      GET
    • List SKUs
      GET
    • Create SKU
      POST
    • Get SKU Details
      GET
    • Update SKU Details
      PATCH
    • Update SKU Details
      PUT
  • Inbound
    • List Inbound ASNs
    • Create Inbound ASN
    • Get single Inbound ASN
    • Update single Inbound ASN
    • Cancel single Inbound ASN
    • Get receipt lines for single Inbound ASN
    • Get receipt lines for single Inbound RMA
    • Get single Inbound RMA
    • Update single Inbound RMA
    • Cancel single Inbound RMA
    • List Inbound RMAs
    • Create Inbound RMA
    • Get receipt lines for single Inbound PO
    • Get single Inbound PO
    • Update single Inbound PO
    • Cancel single Inbound PO
    • List Inbound POs
    • Create Inbound PO
  • Inventory
    • List Inventory Transactions
    • List Inventory stats grouped by SKU
    • List Inventory stats grouped by Lot
    • List Inventory stats grouped by SKU and Building
    • List Inventory stats grouped by Lot and Building
    • List Inventory Serial Numbers
  • Inventory Movement
    • Inventory Movement
  • TMS Endpoints
    • Generate TMS Quotes for Sales Order
    • Book TMS Shipment for Sales Order
    • Delete Booked TMS Shipment For Sales Order
    • Update BOL for Order
    • Approve Quote for Order & Drop to WMS
    • Get ERP Token
  1. Product

Create SKU

POST
/business_units/{businessUnitId}/skus
Product
Create single sku in the item catalog for a business unit

Request

Path Params
businessUnitId
string 
required
Body Params application/json
data
object (sku) 
required
skuId
string 
required
SKU Identifier, Primary Key
<= 30 characters
skuRefId
string 
optional
Used to store an alternate part number (e.g. customer or manufacturer/vendor part number)
ERP SKU
<= 50 characters
name
string 
required
<= 255 characters
description1
string 
required
Short description
<= 60 characters
description2
string 
optional
Long description
<= 255 characters
isActive
enum<string> 
required
Allowed values:
YN
upc
string 
required
Universal Product Code - consists of 12 numeric digits that are uniquely assigned to each trade item.
Softeon does not validate if UPC is valid or not
<= 25 characters
dateOnLPN
enum<string> 
optional
E - EXPIRY
F - FIFO
B - Both
<= 2 characters
Allowed values:
EFB
ean
string 
optional
European Article Number
International Article Number: Standard describing a barcode symbology and numbering system used in global trade to identify a specific retail product type, in a specific packaging configuration, from a specific manufacturer.
<= 25 characters
gtin
string 
optional
Global Trade Item Number - an identifier for trade items, developed by GS1. Such identifiers are used to look up product information in a database which may belong to a retailer, manufacturer, collector, researcher, or other entity.
<= 25 characters
epc
string 
optional
European Product Code
unitCost
number 
optional
Sku cost. Primary material cost
Number (14,5) format
unitCostCurrencyCode
enum<string> 
optional
The ISO 4217 Currency Code associated with the item's cost.
<= 30 characters
Allowed values:
USDEURCAD
Default:
USD
layersPerPallet
number 
optional
Layers per pallet for this SKU
<= 9
casesPerPallet
number 
optional
Cases per pallet for this Sku
<= 9
casesPerLayer
number 
optional
Cases per Layer for this Sku
<= 9
defaultSellingUnit
enum<string> 
required
Units of Measure
EA - Eaches
CA - Cases
PA - Packs
<= 2 characters
Allowed values:
EACAPA
scheduleBCode
string 
optional
Schedule B for international shipment processing
https://content.govdelivery.com/accounts/USCENSUS/bulletins/22bdd9a
<= 30 characters
hsDescription
string 
optional
HS Description (free text)
<= 30 characters
hsCode
string 
optional
HS code for international shipment processing
https://hts.usitc.gov/
<= 30 characters
countryOfOrigin
string 
optional
<= 2 characters
Default:
US
isPackageInuranceRequired
enum<string> 
optional
Allowed values:
YN
isOversized
enum<string> 
optional
Allowed values:
YN
packingPreference
string 
optional
Corrugate Only/Ship Ready/Ship Alone/Corrugate Only/Poly Bag/Mailer
<= 30 characters
skuGroup2
string 
optional
Sku Group Classification
<= 30 characters
skuGroup3
string 
optional
Sku Group Classification
<= 30 characters
skuGroup4
string 
optional
Sku Group Classification
<= 30 characters
skuGroup5
string 
optional
Sku Group Classification
<= 30 characters
skuGroup6
string 
optional
Sku Group Classification
<= 30 characters
skuGroup7
string 
optional
Sku Group Classification
<= 30 characters
skuGroup8
string 
optional
Sku Group Classification
<= 30 characters
skuGroup9
string 
optional
Sku Group Classification
<= 30 characters
skuGroup10
string 
optional
Sku Group Classification
<= 30 characters
receiptTolerancePercent
number 
optional
<= 5
receiptToleranceDays
integer 
optional
<= 9
shelfLifeDays
integer 
required
expiryWarningDays
integer 
optional
To hold items warning days before expiry
isLotTracked
enum<string> 
optional
Allowed values:
YN
commodityCode
string 
optional
To identify whether taxable or not
<= 12 characters
isReturnable
enum<string> 
optional
Allowed values:
YN
isSignatureRequired
enum<string> 
optional
Allowed values:
YN
serialNumberTracking
enum<string> 
optional
Allowed values:
YN
trackPoint
enum<string> 
optional
"When 'Track Serial Numbers' is enabled, the Merchant can define when serial numbers should be capture (Inbound, Outbound or Both)\n I - Receiving - Select this option to capture serial number during receiving\n O - Picking - Select this option to enter serial number during picking.\n B - Both - Select this option to capture serial number during receiving and picking.\n \nThis a Y/N in the item upload template for CAPTURE_SERIAL_ON_OUTBOUND"
I - INBOUND
O - OUTBOUND
B - BOTH
N - NO
<= 1 characters
Allowed values:
IOBN
trackQuestionLevel
enum<string> 
optional
When 'Track Serial Numbers' is enabled, the Merchant can specify the process for receiving serialized products
U - Unit - Select this option to enable capturing the serial number only for the pieces in the Pallet
C - Case - Select this option to enable capturing the serial number only for the cases in the Pallet
B - Both - Select this option to enable capturing serial number for both the cases and pieces in the Pallet
<= 1 characters
Allowed values:
UCB
trackOnReturn
enum<string> 
optional
Allowed values:
YN
icc
object 
optional
hazmat
object 
optional
palletDimensions
object (uom-dimensions) 
optional
Units of Measure Dimensions. Used to delineate the dimensions of a Product/Item when its an Each, versus Case, versus Pallet etc...
caseDimensions
object (uom-dimensions) 
optional
Units of Measure Dimensions. Used to delineate the dimensions of a Product/Item when its an Each, versus Case, versus Pallet etc...
packDimensions
object (uom-dimensions) 
optional
Units of Measure Dimensions. Used to delineate the dimensions of a Product/Item when its an Each, versus Case, versus Pallet etc...
innerPackDimensions
object (uom-dimensions) 
optional
Units of Measure Dimensions. Used to delineate the dimensions of a Product/Item when its an Each, versus Case, versus Pallet etc...
eachDimensions
object (uom-dimensions) 
optional
Units of Measure Dimensions. Used to delineate the dimensions of a Product/Item when its an Each, versus Case, versus Pallet etc...
allocationMethod
enum<string> 
optional
Future use
Allowed values:
fifofefolifo
type
enum<string> 
required
Finished Good/Component/Kit
F - Finished Good
C - Component
K - Kit
Allowed values:
FCK
unitPrice
number 
optional
Number (14,5) format
SKU List Price
unitPriceCurrencyCode
string 
optional
The ISO 4217 Currency Code associated with the item's price.
Currency code for item cost. USD, EUR, CAD
Blank defaults to USD
<= 5 characters
coldStorage
enum<string> 
optional
R - REFRIGERATED
C - COLD
N - NORMAL
A - AMBIENT
F - FREEZER
<= 1 characters
Allowed values:
RCNAF
whseId
string 
optional
What is this for? Should it be buildingId to be consistent?
<= 5 characters
stdShipperType
string 
optional
Indicates Standard Shipper Type
<= 10 characters
unitsPerShipper
integer 
optional
Denotes Units per Shipper
volumeUOM
string 
optional
Indicates Volume Unit of Measure
<= 2 characters
trackingMethod
enum<string> 
required
DF - By FIFO
DL - By LIFO
EF - By FEFO
EL - By LEFO
<= 2 characters
Allowed values:
DFDLEFEL
imageSrc
string 
optional
<= 200 characters
highSecurityProduct
string 
optional
<= 1 characters
versionedProduct
string 
optional
if "versionedProduct" = "Y" then set "isDummyEANAllowed" to true if "versionedProduct" = "N" then set "isDummyEANAllowed" to false
<= 1 characters
Example
{
    "data": {
        "skuId": "string",
        "skuRefId": "string",
        "name": "string",
        "description1": "string",
        "description2": "string",
        "isActive": "Y",
        "upc": "string",
        "dateOnLPN": "E",
        "ean": "string",
        "gtin": "string",
        "epc": "string",
        "unitCost": 0,
        "unitCostCurrencyCode": "USD",
        "layersPerPallet": 9,
        "casesPerPallet": 9,
        "casesPerLayer": 9,
        "defaultSellingUnit": "EA",
        "scheduleBCode": "string",
        "hsDescription": "string",
        "hsCode": "string",
        "countryOfOrigin": "US",
        "isPackageInuranceRequired": "Y",
        "isOversized": "Y",
        "packingPreference": "string",
        "skuGroup2": "string",
        "skuGroup3": "string",
        "skuGroup4": "string",
        "skuGroup5": "string",
        "skuGroup6": "string",
        "skuGroup7": "string",
        "skuGroup8": "string",
        "skuGroup9": "string",
        "skuGroup10": "string",
        "receiptTolerancePercent": 5,
        "receiptToleranceDays": 9,
        "shelfLifeDays": 0,
        "expiryWarningDays": 0,
        "isLotTracked": "Y",
        "commodityCode": "string",
        "isReturnable": "Y",
        "isSignatureRequired": "Y",
        "serialNumberTracking": "Y",
        "trackPoint": "I",
        "trackQuestionLevel": "U",
        "trackOnReturn": "Y",
        "icc": {
            "ground": "string",
            "ocean": "string",
            "air": "string",
            "rail": "string"
        },
        "hazmat": {
            "unNumber": "string",
            "groundClass": "string",
            "oceanClass": "string",
            "airClass": "string",
            "railClass": "string",
            "packingGroup": "string",
            "labelCode": "string"
        },
        "palletDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "caseDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "packDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "innerPackDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "eachDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "allocationMethod": "fifo",
        "type": "F",
        "unitPrice": 0,
        "unitPriceCurrencyCode": "strin",
        "coldStorage": "R",
        "whseId": "strin",
        "stdShipperType": "string",
        "unitsPerShipper": 0,
        "volumeUOM": "st",
        "trackingMethod": "DF",
        "imageSrc": "string",
        "highSecurityProduct": "s",
        "versionedProduct": "s"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/business_units//skus' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "skuId": "string",
        "skuRefId": "string",
        "name": "string",
        "description1": "string",
        "description2": "string",
        "isActive": "Y",
        "upc": "string",
        "dateOnLPN": "E",
        "ean": "string",
        "gtin": "string",
        "epc": "string",
        "unitCost": 0,
        "unitCostCurrencyCode": "USD",
        "layersPerPallet": 9,
        "casesPerPallet": 9,
        "casesPerLayer": 9,
        "defaultSellingUnit": "EA",
        "scheduleBCode": "string",
        "hsDescription": "string",
        "hsCode": "string",
        "countryOfOrigin": "US",
        "isPackageInuranceRequired": "Y",
        "isOversized": "Y",
        "packingPreference": "string",
        "skuGroup2": "string",
        "skuGroup3": "string",
        "skuGroup4": "string",
        "skuGroup5": "string",
        "skuGroup6": "string",
        "skuGroup7": "string",
        "skuGroup8": "string",
        "skuGroup9": "string",
        "skuGroup10": "string",
        "receiptTolerancePercent": 5,
        "receiptToleranceDays": 9,
        "shelfLifeDays": 0,
        "expiryWarningDays": 0,
        "isLotTracked": "Y",
        "commodityCode": "string",
        "isReturnable": "Y",
        "isSignatureRequired": "Y",
        "serialNumberTracking": "Y",
        "trackPoint": "I",
        "trackQuestionLevel": "U",
        "trackOnReturn": "Y",
        "icc": {
            "ground": "string",
            "ocean": "string",
            "air": "string",
            "rail": "string"
        },
        "hazmat": {
            "unNumber": "string",
            "groundClass": "string",
            "oceanClass": "string",
            "airClass": "string",
            "railClass": "string",
            "packingGroup": "string",
            "labelCode": "string"
        },
        "palletDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "caseDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "packDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "innerPackDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "eachDimensions": {
            "height": 0,
            "width": 0,
            "depth": 0,
            "cubicSize": 0,
            "weight": 0,
            "eachesPer": 0,
            "upc": "string"
        },
        "allocationMethod": "fifo",
        "type": "F",
        "unitPrice": 0,
        "unitPriceCurrencyCode": "strin",
        "coldStorage": "R",
        "whseId": "strin",
        "stdShipperType": "string",
        "unitsPerShipper": 0,
        "volumeUOM": "st",
        "trackingMethod": "DF",
        "imageSrc": "string",
        "highSecurityProduct": "s",
        "versionedProduct": "s"
    }
}'

Responses

🟢200SKU succesfully created
application/json
Body
object {0}
Example
{}
🟠400Bad Request
🟠409SkuId Exists
🔴500Internal Server Error
Modified at 2024-07-02 10:16:06
Previous
List SKUs
Next
Get SKU Details
Built with