SSCC Validation in Node.js — GS1 Serial Shipping Container Code Explained

1. What is an SSCC?

The Serial Shipping Container Code (SSCC) is an 18-digit identifier defined by GS1 for tracking logistics units — pallets, parcels, cases, and containers — as they move through the supply chain. It is the globally unique "licence plate" for any physical shipment.

SSCCs are assigned by the company that creates the logistics unit (the packer, manufacturer, or 3PL). Once assigned, the SSCC follows the unit from origin to destination, appearing in advance shipping notices (ASN), warehouse management systems (WMS), and transport management systems (TMS).

The standard is part of the GS1 system and is encoded in GS1-128 barcodes using Application Identifier (AI) 00. It is widely used in retail, healthcare, automotive, and general logistics.

2. SSCC structure — 18 digits decoded

An SSCC has exactly 18 digits, split into three logical parts:

3. The GS1 check digit algorithm

The SSCC uses the same mod-10 check digit algorithm as EAN, GTIN, and GLN — alternating weights of 3 and 1, applied from right to left (or equivalently, the leftmost digit of the 17 data digits gets weight 3).

Let's walk through 106141411234567897:

// ssccCheckDigit.js — GS1 mod-10 check digit for SSCC
function validateSscc(raw) {
  const digits = raw.replace(/[\s-]/g, '');
  if (!/^\d{18}$/.test(digits)) return false;

  let sum = 0;
  for (let i = 0; i < 17; i++) {
    const weight = i % 2 === 0 ? 3 : 1;
    sum += parseInt(digits[i], 10) * weight;
  }

  const checkDigit = (10 - (sum % 10)) % 10;
  return checkDigit === parseInt(digits[17], 10);
}

console.log(validateSscc('106141411234567897')); // true  ✓
console.log(validateSscc('106141411234567890')); // false ✗ wrong check digit
console.log(validateSscc('340123450000000018')); // checks dynamically

4. Why SSCC validation matters

5. The production-ready solution

The IsValid SSCC API validates the format, computes the GS1 mod-10 check digit, and returns the parsed components — extension digit, company prefix with serial reference, and check digit — in a single call.

Full parameter reference and response schema: SSCC Validation API docs →

6. Node.js code example

import { createClient } from '@isvalid-dev/sdk';

const iv = createClient({ apiKey: process.env.ISVALID_API_KEY });

// ── Example usage ────────────────────────────────────────────────────────────

const result = await iv.sscc('106141411234567897');

if (!result.valid) {
  console.log('Invalid SSCC');
} else {
  console.log('Extension digit:', result.extensionDigit);     // → '1'
  console.log('Company + Serial:', result.companyAndSerial);  // → '0614141123456789'
  console.log('Check digit:', result.checkDigit);             // → '7'
}

// Validate SSCCs in an inbound ASN before warehouse receipt
async function processAsn(pallets) {
  const results = [];

  for (const pallet of pallets) {
    if (!pallet.sscc) {
      results.push({ ...pallet, status: 'missing' });
      continue;
    }

    const check = await validateSscc(pallet.sscc);

    if (!check.valid) {
      results.push({ ...pallet, status: 'invalid' });
      continue;
    }

    results.push({
      ...pallet,
      sscc: pallet.sscc.replace(/[\s-]/g, ''),
      extensionDigit: check.extensionDigit,
      companyAndSerial: check.companyAndSerial,
      status: 'valid',
    });
  }

  return results;
}

7. cURL example

Validate a valid SSCC:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/sscc?value=106141411234567897"

Validate an SSCC with an incorrect check digit:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/sscc?value=106141411234567890"

Validate an SSCC with extension digit 0:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/sscc?value=006141411234567893"

8. Understanding the response

Valid SSCC:

{
  "valid": true,
  "extensionDigit": "1",
  "companyAndSerial": "0614141123456789",
  "checkDigit": "7"
}

Invalid SSCC:

{
  "valid": false
}

9. Edge cases — extension digits, GS1-128, and AI 00

// Strip AI 00 prefix from GS1-128 barcode scan
function extractSscc(scan) {
  // GS1-128 scan may include AI: "00106141411234567897"
  if (scan.startsWith('00') && scan.length === 20) {
    return scan.slice(2); // remove AI 00
  }
  return scan; // already 18 digits
}