GS1 + TT 02/2024 + EU DPP Mapping — Mapping chuẩn quốc tế và pháp lý GoTrace ​

1. Tổng quan 3 hệ chuẩn ​

GoTrace được thiết kế để tuân thủ đồng thời 3 hệ chuẩn — quốc tế (GS1), pháp lý Việt Nam (TT 02/2024) và yêu cầu thị trường xuất khẩu hàng đầu (EU DPP).

1.1. GS1 Global Traceability Standard ​

Cốt lõi: Mô hình Identify – Capture – Share (Định danh – Ghi nhận – Chia sẻ).

• Identify (Định danh): mỗi thực thể có mã chuẩn toàn cầu — GTIN cho sản phẩm, GLN cho địa điểm, SSCC cho lô vận chuyển, Batch/Lot cho lô sản xuất, Serial Number cho cá thể sản phẩm.
• Capture (Ghi nhận): mỗi sự kiện chuỗi cung ứng được ghi theo EPCIS (Electronic Product Code Information Services) với 5 chiều: What / When / Where / Why / How.
• Share (Chia sẻ): dữ liệu chia sẻ theo phân quyền cho các bên — DN, B2B, NTD, cơ quan, auditor.

Vai trò trong GoTrace:

• Lớp 2 Standardization tuân thủ Identify.
• Lớp 1 Capture + Lớp 3 Graph thực thi Capture (EPCIS event).
• Lớp 5 Sharing thực thi Share theo phân quyền.

1.2. TT 02/2024/TT-BKHCN ​

Cốt lõi: Thông tư 02/2024/TT-BKHCN của Bộ KH&CN quy định:

• 12 trường thông tin tối thiểu mà mọi hệ thống truy xuất nguồn gốc phải có.
• Nguyên tắc "một bước trước – một bước sau" — mỗi chủ thể phải xác định được bên cung cấp ngay trước (1 bước trước) và bên tiếp nhận ngay sau (1 bước sau).
• Cổng tra cứu công khai — DN báo cáo định kỳ qua cổng truyxuat.gov.vn (đang triển khai).

Vai trò trong GoTrace:

• COMP module quản lý compliance check tự động.
• Lớp 3 Graph đáp ứng tự nhiên nguyên tắc "1 bước trước – 1 bước sau" qua edge supplied_by và delivered_to.

1.3. EU Digital Product Passport (DPP) ​

Cốt lõi: Quy định EU 2024/1781 (Ecodesign for Sustainable Products Regulation — ESPR), bắt đầu hiệu lực 2027 cho 1 số ngành (textile, electronics, batteries...). Yêu cầu hộ chiếu số sản phẩm chứa thông tin vòng đời, vật liệu, khả năng tái chế, tuân thủ.

Vai trò trong GoTrace:

• ENV module quản lý field DPP (vật liệu, phát thải, recyclability).
• TXNG module cung cấp lineage (NCC, batch, sản xuất).
• COMP module cung cấp cert + compliance.
• Endpoint /api/v1/dpp/{gtin}/{batch} trả về DPP JSON-LD theo EU schema.

1.4. So sánh nhanh ​

2. GS1 Identify Mapping — Mã định danh ​

2.1. Format chuẩn ​

2.2. GS1 Application Identifier (AI) ​

GoTrace lưu trữ và parse các AI quan trọng khi đọc QR code 2D (DataMatrix/QR):

3. GS1 Capture Mapping — EPCIS Events ​

EPCIS định nghĩa 6 loại event chính, mỗi event capture 5 chiều What / When / Where / Why / How.

3.1. ObjectEvent ​

Định nghĩa: Event quan sát hoặc commission một (hoặc nhiều) đối tượng. Phổ biến nhất.

Khi nào dùng:

• Lô FG vừa được commission (lô SX hoàn tất).
• Quan sát đếm tồn kho.
• Cập nhật trạng thái lô (PASSED, FAILED).

Mapping với F-code:

• TXNG-F05..F08 — Production Order completion → ObjectEvent bizStep=commissioning, disposition=active.
• TXNG-F19 — Warehouse cycle count → ObjectEvent bizStep=inspecting.
• TXNG-F22 — Lô xuất khỏi kho → ObjectEvent bizStep=shipping, action=OBSERVE.

Sample EPCIS payload:

{
  "type": "ObjectEvent",
  "eventTime": "2026-05-01T08:00:00.000Z",
  "eventTimeZoneOffset": "+07:00",
  "epcList": ["urn:epc:id:sgtin:8930000.123456.SN001"],
  "action": "ADD",
  "bizStep": "urn:epcglobal:cbv:bizstep:commissioning",
  "disposition": "urn:epcglobal:cbv:disp:active",
  "bizLocation": { "id": "urn:epc:id:sgln:8930000.12345.0" },
  "readPoint": { "id": "urn:epc:id:sgln:8930000.12345.7" }
}

3.2. AggregationEvent ​

Định nghĩa: Event đóng gói nhiều đối tượng vào 1 container (case, pallet, truckload).

Khi nào dùng:

• Đóng thùng N hộp SP vào 1 carton SSCC.
• Đóng pallet từ N carton.
• Load nhiều pallet lên 1 xe tải.

Mapping với F-code: TXNG-F22 (Warehouse + Transport packing).

Sample:

{
  "type": "AggregationEvent",
  "eventTime": "2026-05-01T10:00:00.000Z",
  "parentID": "urn:epc:id:sscc:8930000.0123456789",
  "childEPCs": [
    "urn:epc:id:sgtin:8930000.123456.SN001",
    "urn:epc:id:sgtin:8930000.123456.SN002"
  ],
  "action": "ADD",
  "bizStep": "urn:epcglobal:cbv:bizstep:packing"
}

3.3. TransactionEvent ​

Định nghĩa: Event gắn đối tượng với một giao dịch B2B (đơn hàng, hợp đồng, hoá đơn).

Khi nào dùng:

• Gắn lô FG với Purchase Order khi nhận hàng từ NCC.
• Gắn lô FG với Sales Order khi xuất bán cho retailer.

Mapping với F-code: TXNG-F37 (Mạng lưới phân phối B2B), TXNG-F34 (Purchase Order).

3.4. TransformationEvent ​

Định nghĩa: Event chuyển hoá — input objects → output objects (sản xuất, chia tách, đóng gói lại).

Khi nào dùng:

• Sản xuất: RM input → FG output.
• Cắt mảnh thịt: 1 con heo → N mảnh.
• Đóng gói lại: lô lớn → lô nhỏ.

Mapping với F-code: TXNG-F05..F08 (Manufacturing Order). Đây là event quan trọng nhất cho Traceability Graph — định nghĩa edge uses (RM → MO) và produced_by (MO → FG).

Sample:

{
  "type": "TransformationEvent",
  "eventTime": "2026-04-29T07:00:00.000Z",
  "inputEPCList": ["urn:epc:id:sgtin:8930000.555555.RM-2026-0420-003"],
  "outputEPCList": ["urn:epc:id:sgtin:8930000.123456.FG-2026-0501-001"],
  "bizStep": "urn:epcglobal:cbv:bizstep:commissioning",
  "ilmd": {
    "lotNumber": "FG-2026-0501-001",
    "productionDate": "2026-05-01"
  }
}

3.5. AssociationEvent ​

Định nghĩa: Event gán/hủy gán mối liên hệ giữa 2 đối tượng (vd. gán cert cho lô).

Khi nào dùng:

• Gán certification VietGAP cho lô FG.
• Gán cert HACCP cho cơ sở SX.

Mapping với F-code: ATTP-F01 (cơ sở), ATTP-F13 (kết quả KN), COMP-F* (cert lifecycle).

3.6. DisaggregationEvent / DisassociationEvent ​

Định nghĩa:

• DisaggregationEvent: Mở pallet, mở thùng (ngược với AggregationEvent).
• DisassociationEvent: Hủy gán cert (ngược với AssociationEvent).

Mapping: TXNG-F22 (Warehouse unpack), COMP-F* (cert revoke).

4. GS1 Share Mapping — Sharing Layer ​

4.1. Cho Người tiêu dùng (NTD) ​

• Channel: QR scan → Public landing page.
• Endpoint: GET /api/v1/trace/qr/:qr_code_id (public, rate limit 60 req/phút/IP).
• Data masking: chỉ trả thông tin công khai — tên SP, ngày SX, hạn SD, chứng nhận có hiệu lực, NCC (tên + tỉnh, không lộ MST/địa chỉ chi tiết).
• F-code: TXNG-QRM-F01..F12.

4.2. Cho Khách hàng B2B (siêu thị, nhà phân phối, nhà nhập khẩu) ​

• Channel: API B2B + portal khách.
• Auth: OAuth 2.0 hoặc API Key, theo từng đối tác.
• Data: lô hàng đã giao, chứng nhận đính kèm, kết quả KN, traceability lineage.
• Endpoint: GET /api/v1/b2b/batches/:batch_id/passport — trả về DPP-style JSON-LD.
• F-code: TXNG-F37, COMP-F*.

4.3. Cho Cơ quan quản lý (CQQL) ​

• Channel: Government portal (riêng, đường truyền có VPN/eSign).
• Data: báo cáo định kỳ, mã truy xuất theo lô, dữ liệu tuân thủ.
• F-code: toàn bộ module QLNN.

4.4. Cho Auditor ​

• Channel: Auditor portal + token có thời hạn (token expire sau 1 audit cycle, mặc định 30 ngày).
• Data: hồ sơ KN, cert, nhật ký SX, truy xuất theo lô, audit trail.
• F-code: COMP-F*, QLNN-F22 (audit log).

5. TT 02/2024 — 12 trường tối thiểu ​

Mapping 12 trường bắt buộc theo TT 02/2024 với F-code GoTrace.

5.1. Output báo cáo TT 02 ​

GoTrace tự động sinh báo cáo XML/JSON theo template Bộ KHCN qua endpoint:

• POST /api/v1/compliance/tt02/reports/{period} — sinh báo cáo theo kỳ (tháng/quý).
• GET /api/v1/compliance/tt02/lookup/{trace_code} — public tra cứu (proxy cho cổng truyxuat.gov.vn).

5.2. Schema XML báo cáo ​

Theo phụ lục TT 02 (mẫu báo cáo XML/JSON do Bộ KHCN ban hành — đang chờ phụ lục chi tiết):

<TraceabilityReport>
  <Enterprise>
    <TaxId>0123456789</TaxId>
    <Name>Cà phê G7 ABC</Name>
    <GCP>893000</GCP>
  </Enterprise>
  <Period>2026-Q2</Period>
  <Batches>
    <Batch>
      <BatchCode>FG-2026-0501-001</BatchCode>
      <GTIN>8930012345678</GTIN>
      <ProductionDate>2026-05-01</ProductionDate>
      <ExpiryDate>2027-05-01</ExpiryDate>
      <Quantity>985</Quantity>
      <Suppliers>
        <Supplier OneStepBack="true">...</Supplier>
      </Suppliers>
      <Customers>
        <Customer OneStepForward="true">...</Customer>
      </Customers>
      <Certifications>...</Certifications>
    </Batch>
  </Batches>
</TraceabilityReport>

6. Nguyên tắc "Một bước trước – Một bước sau" ​

6.1. Định nghĩa ​

Theo TT 02/2024, mỗi chủ thể trong chuỗi cung ứng phải xác định được:

• 1 bước trước (One Step Back): bên cung cấp ngay trước.
• 1 bước sau (One Step Forward): bên tiếp nhận ngay sau.

Đây là nguyên tắc cốt lõi để khi 1 lô có vấn đề, có thể nhanh chóng khoanh vùng cả phía cung cấp lẫn phía tiêu thụ.

6.2. Mapping với Traceability Graph ​

6.3. Validation rule (Lớp 4 Data Quality) ​

Khi bất kỳ rule nào fail → alert COMPLIANCE_OFFICER và block lô khỏi xuất kho cho đến khi fix.

6.4. Audit query "1 bước trước – 1 bước sau" ​

-- Cho 1 batch_id, trả về 1 bước trước (NCC) + 1 bước sau (KH)
WITH one_step_back AS (
    SELECT DISTINCT s.id, s.code, s.name, s.tax_id
    FROM finished_goods_batches fg
    JOIN manufacturing_orders mo ON fg.mo_id = mo.id
    JOIN mo_raw_materials mrm ON mo.id = mrm.mo_id
    JOIN raw_material_batches rm ON mrm.rm_id = rm.id
    JOIN suppliers s ON rm.supplier_id = s.id
    WHERE fg.batch_code = $1
),
one_step_forward AS (
    SELECT DISTINCT c.id, c.code, c.name
    FROM finished_goods_batches fg
    JOIN shipment_items si ON fg.id = si.fg_id
    JOIN shipments sh ON si.shipment_id = sh.id
    JOIN customers c ON sh.customer_id = c.id
    WHERE fg.batch_code = $1
)
SELECT 'BACK' AS direction, * FROM one_step_back
UNION ALL
SELECT 'FORWARD' AS direction, * FROM one_step_forward;

7. EU Digital Product Passport (DPP) Mapping ​

7.1. DPP fields (EU Reg 2024/1781) ​

DPP yêu cầu hộ chiếu số chứa thông tin theo nhóm:

7.2. DPP Endpoint ​

GET /api/v1/dpp/:gtin/:batch

Response (JSON-LD theo schema EU):

{
  "@context": ["https://schema.eu-dpp.eu/v1"],
  "@type": "ProductPassport",
  "productID": "urn:gs1:gtin:8930012345678",
  "batchID": "FG-2026-0501-001",
  "name": "Cà phê G7 hoà tan",
  "manufacturer": {
    "name": "Cà phê G7 ABC",
    "taxID": "0123456789",
    "country": "VN"
  },
  "productionDate": "2026-05-01",
  "expiryDate": "2027-05-01",
  "materials": [
    { "name": "Coffee", "percent": 90, "origin": "VN-Daklak" },
    { "name": "Sugar", "percent": 10, "origin": "VN-TayNinh" }
  ],
  "carbonFootprint": { "value": 2.4, "unit": "kgCO2e/kg" },
  "certifications": [
    { "type": "VietGAP", "issuer": "...", "validUntil": "2027-04-30" },
    { "type": "HACCP", "issuer": "...", "validUntil": "2027-12-31" }
  ],
  "traceabilityURL": "https://gotrace.vn/qr/abc123",
  "complianceDeclarations": ["EU 2023/2006", "TT 02/2024 VN"]
}

7.3. QR code chứa DPP URL ​

QR code in trên bao bì chứa URL theo format GS1 Digital Link:

https://gotrace.vn/01/8930012345678/10/FG-2026-0501-001

URL này resolve đến /api/v1/dpp/{gtin}/{batch} trả về DPP JSON-LD.

8. Compliance Checklist tự động ​

GoTrace tự động chạy compliance check theo industry và market đích.

8.1. Per industry ​

8.2. Auto-generation hồ sơ audit ​

• POST /api/v1/compliance/audit-package/generate — sinh package zip chứa toàn bộ hồ sơ audit cho 1 batch hoặc 1 cơ sở:
  • Manufacturing log (PDF)
  • Quality check results (PDF)
  • Certifications (PDF, ký số)
  • Supplier list + cert (PDF)
  • Recall history (nếu có)
  • Audit trail (CSV)

8.3. Alert khi thiếu trường bắt buộc ​

Lớp 4 Data Quality engine chạy hourly job:

SELECT batch_code FROM finished_goods_batches
WHERE status = 'IN_STOCK'
  AND (production_date IS NULL
       OR expiry_date IS NULL
       OR NOT has_required_certifications(id, product_id));

Mọi vi phạm → alert + block khỏi xuất kho.

9. International Standards Reference ​

10. Tham chiếu ​

11. Lịch sử phiên bản ​