SSCC carton label

Cartons from your ERP, as A5 GS1 labels in PDF

Download template

Sample data

Template
DOCX
Export as
PDF, DOCX, ODT, HTML, PNG +25 more
Carbone
5.0+

Generate SSCC carton labels from your ERP

Suppliers that deliver European retailers put a GS1 logistic label on each carton, as set by the GS1 Logistic Label Guideline and the GS1 General Specifications. At the distribution center, the receiving clerk scans the SSCC of the carton and finds it in the despatch advice of the delivery. Your ERP or WMS sends the cartons of a shipment to the Carbone API as JSON and gets back a PDF with one A5 label per page, printed at actual size on a label printer or on A5 labels in an office printer. In this example, the olive oil mill Almazara Valdemira, in Jaén, ships 3 cartons to the distribution center of Duinvelde Supermarkten in Willebroek, Belgium.

In this example, you will:

  • Generate GS1-128 barcodes at the GS1 size from the data
  • Print the human readable interpretation under each barcode
  • Print one label per carton, each on its own page

For Zebra printers, the UCC-128 carton label and the GS1 pallet label examples generate ZPL instead of PDF.

GS1 logistic label layout

The label has the three GS1 segments. The carrier and customer segments sit side by side at the top, and the supplier segment comes last, because the segment with the SSCC is always at the bottom. Each segment reads from top to bottom: free text, then data titles, then barcodes with their human readable interpretation (HRI).

Segment Free text Data titles Barcode
Carrier FROM address, CARRIER SHIP TO POST, GROSS WEIGHT (kg) (421) ship-to postal code with the ISO country code, 056 for Belgium
Customer TO address of the distribution center ORDER NUMBER, DELIVERY DATE (400) purchase order number of the retailer
Supplier Product description, CARTON 1 OF 3 SSCC, GTIN, BEST BEFORE, BATCH/LOT (01) GTIN of the carton, (15) best before date and (10) batch, then (00) SSCC alone in the lowest barcode
  • Size: four GS1-128 barcodes need at least 31.75 mm of bar height each, so the label is A5. An A6 or 4x6 label fits the SSCC and little else.
  • Barcodes: narrow bars of 0.5 mm, bars 32 mm high, and a quiet zone of at least 10 narrow bars on each side.
  • Text: data titles in English capitals, data content in 18 pt (7 mm), and HRI in regular Arial 12 pt, at least 3 mm high.
  • Application Identifiers: each carton is the trade item that the retailer orders, so the label uses (01) for its GTIN. (02) and (37) give the content and count of a pallet, and (37) never goes with (01). GS1 recommends (421) over (420) for the ship-to postal code, because it carries the country.

The GS1 Company Prefix of the example, 9524816, starts with 952, the GS1 prefix reserved for demonstrations: these SSCCs and GTINs belong to no real company.

SSCC carton label example

Template

The DOCX template is an A5 Word document: one table holds the label, and each barcode is a temporary picture with a tag in its alt text. The key tags:

Where Tag
Alt text of the SSCC barcode {d.cartons[i].sscc:prepend('(00)'):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}
Alt text of the GTIN, date and batch barcode {d.cartons[i].bestBefore:formatD('YYMMDD'):prepend('(15)'):prepend(.gtin):prepend('(01)'):append('(10)'):append(.batch):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}
Alt text of the ship-to postal code barcode {d.to.zip:prepend(.countryNumeric):prepend('(421)'):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}
HRI of the SSCC (00) {d.cartons[i].sscc:substr(0, 1)} {d.cartons[i].sscc:substr(1, 8)} {d.cartons[i].sscc:substr(8, 17)} {d.cartons[i].sscc:substr(17)}
Best before date {d.cartons[i].bestBefore:formatD('DD.MM.YYYY')}
Carton count CARTON {d.cartons[i].sscc:cumCount} OF {d.cartons:len}
After the table {d.cartons[i, i=-1].sscc:ifNEM:drop(p)} and a page break, then {d.cartons[i+1]}

JSON data

{
  "from": { "name": "Almazara Valdemira S.L.", "street": "Camino de los Olivares 21", "zip": "23009", "city": "Jaén", "country": "ES" },
  "carrier": "Corvalis Freight S.L.",
  "to": { "name": "Duinvelde Supermarkten NV", "site": "Distributiecentrum Willebroek", "street": "Logistiekweg 12", "zip": "2830", "city": "Willebroek", "country": "BE", "countryNumeric": "056" },
  "order": { "number": "780045216", "deliveryDate": "2026-11-19" },
  "cartons": [
    { "sscc": "195248160000050816", "gtin": "19524816000316", "description": "Extra virgin olive oil, 6 x 1 l glass bottles", "bestBefore": "2028-04-30", "batch": "263041", "grossWeight": 9.2 },
    { "sscc": "195248160000050823", "gtin": "19524816000316", "description": "Extra virgin olive oil, 6 x 1 l glass bottles", "bestBefore": "2028-04-30", "batch": "263041", "grossWeight": 9.2 },
    { "sscc": "195248160000050830", "gtin": "19524816000484", "description": "Extra virgin olive oil, 12 x 500 ml glass bottles", "bestBefore": "2028-05-31", "batch": "263071", "grossWeight": 10.1 }
  ]
}

How to create an SSCC carton label

1. Print one label per carton

The template is an A5 page with margins of 4 to 5 mm, and the label is a table that fills it. The table holds loop tags such as {d.cartons[i].sscc}, and two paragraphs follow it:

  1. A page break with {d.cartons[i, i=-1].sscc:ifNEM:drop(p)}
  2. {d.cartons[i+1]}, which ends the loop

Carbone repeats the table and the page break for each carton. The filter i=-1 selects the last carton, and :drop(p) removes its page break, so the PDF does not end with a blank page. The two paragraphs are 1 pt high: the label keeps the whole page.

2. Generate the GS1-128 barcodes

Each barcode is a temporary picture whose alt text holds a tag with the :barcode formatter:

{d.cartons[i].sscc:prepend('(00)'):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}
  • :prepend('(00)') adds the Application Identifier. With the gs1-128 type, write each AI in parentheses: Carbone starts the barcode with the FNC1 character and leaves out the parentheses, so scanners read ]C1 then 00195248160000050816.
  • height:22.55 makes the bars 64 times as high as the narrow bar. The temporary picture is 32.17 mm high and wider than any of the barcodes: :imageFit(contain) fits each barcode to that height, so the narrow bars are 0.5 mm and the bars 32 mm high. A longer or shorter value keeps this size, as long as the barcode fits the width of the picture.
  • includetext:false leaves the HRI to the text below, and svg:true keeps the bars sharp in the PDF, see the barcode options.

The supplier barcode joins three element strings. The tag starts from the date, because the date needs :formatD first, and .gtin and .batch are dynamic parameters that read the other fields of the carton:

{d.cartons[i].bestBefore:formatD('YYMMDD'):prepend('(15)'):prepend(.gtin):prepend('(01)'):append('(10)'):append(.batch):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}

It encodes (01)19524816000316(15)280430(10)263041. The fixed-length (01) and (15) come first and the variable-length (10) last, so the barcode needs no separator. The customer barcode encodes (400)780045216 with {d.order.number:prepend('(400)'):barcode(gs1-128, height:22.55, includetext:false, svg:true):imageFit(contain)}. The carrier barcode puts the country code before the postal code, (421)0562830, with the tag of the template table above.

3. Print the human readable interpretation

GS1 asks for the encoded data under each barcode, with the AIs in parentheses. The text under the SSCC uses :substr:

(00) {d.cartons[i].sscc:substr(0, 1)} {d.cartons[i].sscc:substr(1, 8)} {d.cartons[i].sscc:substr(8, 17)} {d.cartons[i].sscc:substr(17)}

It prints (00) 1 9524816 000005081 6: the extension digit, the GS1 Company Prefix, the serial reference and the check digit. :substr(1, 8) fits a 7-digit company prefix: change the positions for yours. The GTIN follows the same pattern, (01) 1 9524816 00031 6, and :formatD('YYMMDD') prints the date as encoded, (15) 280430. In the middle of the label, the same date has its format in the data title: BEST BEFORE (DD.MM.YYYY) above {d.cartons[i].bestBefore:formatD('DD.MM.YYYY')}, which prints 30.04.2028.

Send the SSCC with its check digit, as your WMS allocates it, and the same SSCC in the despatch advice.

4. Number the cartons

CARTON {d.cartons[i].sscc:cumCount} OF {d.cartons:len} prints CARTON 1 OF 3 with :cumCount, so the receiving clerk can check that the delivery is complete. {d.cartons[i].grossWeight:formatN(1)} prints the weight of each carton with :formatN: 9.2 under GROSS WEIGHT (kg).

Trusted by 800+ paid customers in 40+ countries

Finance
Healthcare
Insurance
Legal
Public
Retail
Energy
Software
Telecom
Dior
Thales
Younited
Danfoss
CMA CGM
Illumina
KparK
Scalingo
French Ministry of the Armed Forces
BMW
Telus
Bestseller
Flagship Biosciences
Insly
Ninox
Sodexo