DCSA Reference Documentation / Standards / Standard Releases / Verified Gross Mass / Verified Gross Mass v1.0.0

DCSA VGM 1.0.0 - Implementing VGM Standard

This is a guide to implementing the DCSA Verified Gross Mass (VGM) standard version 1.0, written for the technical teams of DCSA adopting organizations.

Contents

• Reference Documentation
• Implementing the Standard
  • VGM Producer Implementation
  • VGM Consumer Implementation
• Versions overview

Reference Documentation

To get acquainted with the standard, refer to the VGM Introduction.

To understand the Purpose & Scope, User Stories, Use Cases, Endpoint Overview, Business Process Model and Data Overview of the standard, refer to the VGM Documentation page.

To understand the data structures used by the standard and how they can be mapped to your own organization’s data types, consult the VGM Information Model.

Implementing the Standard

The DCSA VGM 1.0 standard is designed and is expected to be implemented following the DCSA API Design and Implementation Guidelines 2025.Q4 (formerly named v3.0).

To review the reference implementation of the VGM standard, created by DCSA to verify the standard and used for measuring the conformance of adopter implementations, consult the VGM module of the DCSA conformance GitHub repository.

To ensure that your organization becomes a successful adopter in the DCSA VGM standard API ecosystem, use the DCSA conformance framework periodically throughout your implementation project, to measure the conformance of your implementation and to improve it as needed.

You can use a DCSA conformance sandbox as a counterpart in your development, since it allows you to easily test the most relevant conformance scenarios that your application needs to support. The VGM standard includes the list of conformance scenarios and validations that adopters are expected to support.

The DCSA VGM OpenAPI specification is available publicly on SwaggerHub.

VGM Producer Implementation

To implement the VGM standard API as a VGM producer, use your organization’s technology stack to implement the “GET /vgm-declarations” endpoint of the VGM OpenAPI specification.

VGM Consumer Implementation

To receive VGM declarations from any VGM producer, use your organization’s technology stack to build the “POST /vgm-declarations” endpoint of the VGM OpenAPI specification.

Use the publisher’s proprietary process to register your endpoint(s) for receiving VGM declarations.

Versions overview

List of changes and the version in which they are released:

Version	Date of Publication	Change	Purpose of change
1.0.0	2025-11-18	Initial release of VGM.	N/A