Mill Certification

Download mill certification

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/download

Downloads mill certification data. Returns ZIP archive of scanned PDFs (application/zip) when export=scans, or CSV with certification details (text/csv) when export=csv. Default export is scans. For scans export, use groupBy parameter to group files by 'page' (default) or 'heat'.

Download mill certification › path Parameters

companyId

string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId

string · uuid · required

The unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Download mill certification › query Parameters

export

string

Export format: 'scans' (default, returns application/zip with PDFs) or 'csv' (returns text/csv with details)

groupBy

string

For scans export only: 'page' (default) or 'heat' to group files in the ZIP archive

Download mill certification › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Download mill certification › Responses

Success - content type varies based on export parameter (application/zip for scans, text/csv for CSV export)

string · binary

Generate branded Material Test Certificate PDF

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/branded-report

Generates a branded landscape A4 PDF derived from an ingested mill certification. Includes a DRAFT watermark when the certificate has not been approved. The generated PDF is stored in blob storage for audit purposes.

Generate branded Material Test Certificate PDF › path Parameters

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certification to derive the report from

Generate branded Material Test Certificate PDF › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Generate branded Material Test Certificate PDF › Responses

Generated PDF returned as a file download

string · binary

Get mill certification details

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}

Retrieves detailed information about a specific mill certification including document-level metadata (supplier, mill, standard, quality, production process, CARES QR, certificate date, customer), pages, heats with chemical composition, and mechanical properties

Get mill certification details › path Parameters

companyId

string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId

string · uuid · required

The unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Get mill certification details › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get mill certification details › Responses

Mill certification details retrieved successfully

object[]

object

newFileName

string

defenderResultId

string · uuid

dateInserted

string · date-time

dateModified

string · date-time

heatCodes

string

millCertificationId

string · uuid

companyId

string · uuid

originalFileName

string

storageFileName

string

status

integer · int32

millCertificationStatusLabel

string

millCertificationStatusNotes

string

millCertificationStatusType

string

GET/api/company/{companyId}/millcertification/{millCertificationId}

curl --request GET \
  --url https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "pages": [
    {
      "heats": [
        {
          "mechanicalProperties": [
            {
              "testNumber": 0,
              "massPerMeter": 0,
              "createdAt": "2024-08-25T15:00:00Z",
              "updatedAt": "2024-08-25T15:00:00Z",
              "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
              "companyId": "00000000-0000-0000-0000-000000000000",
              "millCertificationHeatId": "00000000-0000-0000-0000-000000000000"
            }
          ],
          "heatNumber": "heatNumber",
          "diameter": 0,
          "length": 0,
          "carbonEquivalent": 0,
          "createdAt": "2024-08-25T15:00:00Z",
          "updatedAt": "2024-08-25T15:00:00Z",
          "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
          "companyId": "00000000-0000-0000-0000-000000000000",
          "millCertificationPageId": "00000000-0000-0000-0000-000000000000"
        }
      ],
      "newFileName": "newFileName",
      "classificationModelResult": "classificationModelResult",
      "extractionModel": "extractionModel",
      "extractionModelResult": "extractionModelResult",
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "millCertificationStatusLabel": "millCertificationStatusLabel",
      "millCertificationStatusNotes": "millCertificationStatusNotes",
      "millCertificationStatusType": "millCertificationStatusType",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationId": "00000000-0000-0000-0000-000000000000",
      "blobUri": "blobUri",
      "originalFileName": "originalFileName",
      "status": 0
    }
  ],
  "defenderResult": {
    "defenderResultId": 0,
    "subject": "subject",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "blobUri": "blobUri",
    "eTag": "eTag",
    "scanFinishedTimeUtc": "2024-08-25T15:00:00Z",
    "scanResultType": "scanResultType",
    "malwareNamesFound": "malwareNamesFound",
    "malwareSha256": "malwareSha256",
    "eventType": "eventType",
    "dataVersion": "dataVersion",
    "metadataVersion": "metadataVersion",
    "eventTime": "2024-08-25T15:00:00Z",
    "topic": "topic",
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z"
  },
  "newFileName": "newFileName",
  "defenderResultId": "00000000-0000-0000-0000-000000000000",
  "dateInserted": "2024-08-25T15:00:00Z",
  "dateModified": "2024-08-25T15:00:00Z",
  "heatCodes": "heatCodes",
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "originalFileName": "originalFileName",
  "storageFileName": "storageFileName",
  "status": 0,
  "millCertificationStatusLabel": "millCertificationStatusLabel",
  "millCertificationStatusNotes": "millCertificationStatusNotes",
  "millCertificationStatusType": "millCertificationStatusType"
}

json

application/json

Upload a mill certification

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}

Uploads a single mill certification PDF with rate limiting and validation. The client supplies the mill certification GUID.

Upload a mill certification › path Parameters

companyId

string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId

string · uuid · required

Client-generated GUID that identifies this mill certification. Used as the record ID and the blob storage file name.

Upload a mill certification › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Upload a mill certification › Request Body

Upload a mill certification › Responses

Mill certification uploaded successfully

millCertificationId

string · uuid

companyId

string · uuid

defenderResultId

string · uuid

originalFileName

string

newFileName

string

storageFileName

string

status

integer · enum · int32

Enum values:

Default: 0

isTestRun

boolean

Get mill certification PDF page content

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/pdf-page/{millCertificationPageId}

Streams the PDF content for a specific mill certification page. Use this endpoint to render PDFs without cross-origin issues.

Get mill certification PDF page content › path Parameters

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certification

millCertificationPageId

string · uuid · required

The unique identifier of the mill certification page

Get mill certification PDF page content › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get mill certification PDF page content › Responses

PDF content streamed successfully

string · binary

Get signed URLs for mill certification PDF pages

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/pdf-urls

Retrieves time-limited signed URLs for accessing mill certification PDF page blobs

Get signed URLs for mill certification PDF pages › path Parameters

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certification

Get signed URLs for mill certification PDF pages › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get signed URLs for mill certification PDF pages › Responses

PDF URLs retrieved successfully

object[]

millCertificationPageId

string · uuid

pageFileName

string

pageNumber

integer · int32

signedUrl

string

List mill certifications

GET

https://api.gosmarter.ai

/api/company/{companyId}/millcertification

Retrieves a list of all mill certifications for a company

List mill certifications › path Parameters

companyId

string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

List mill certifications › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List mill certifications › Responses

List of mill certifications retrieved successfully

object[]

newFileName

string

defenderResultId

string · uuid

dateInserted

string · date-time

dateModified

string · date-time

heatCodes

string

millCertificationId

string · uuid

companyId

string · uuid

originalFileName

string

storageFileName

string

status

integer · int32

millCertificationStatusLabel

string

millCertificationStatusNotes

string

millCertificationStatusType

string

GET/api/company/{companyId}/millcertification

curl --request GET \
  --url https://api.gosmarter.ai/api/company/:companyId/millcertification \
  --header 'Authorization: <string>'

shell

Example Responses

[
  {
    "newFileName": "newFileName",
    "defenderResultId": "00000000-0000-0000-0000-000000000000",
    "dateInserted": "2024-08-25T15:00:00Z",
    "dateModified": "2024-08-25T15:00:00Z",
    "heatCodes": "heatCodes",
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "originalFileName": "originalFileName",
    "storageFileName": "storageFileName",
    "status": 0,
    "millCertificationStatusLabel": "millCertificationStatusLabel",
    "millCertificationStatusNotes": "millCertificationStatusNotes",
    "millCertificationStatusType": "millCertificationStatusType"
  }
]

json

application/json

Manually create a mill certification

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/manual

Creates a mill certification with user-provided data. The PDF is stored in a separate container and no AI pipeline is triggered.

Manually create a mill certification › path Parameters

companyId

string · uuid · required

The unique identifier of the company.

millCertificationId

string · uuid · required

Client-generated GUID that identifies this mill certification.

Manually create a mill certification › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Manually create a mill certification › Request Body

Manually create a mill certification › Responses

Mill certification created successfully

millCertificationId

string · uuid

companyId

string · uuid

originalFileName

string

storageFileName

string

status

integer · enum · int32

Enum values:

Default: 0

isTestRun

boolean

supplier

string

mill

string

standard

string

quality

string

productionProcess

string

caresQR

string

certificateDate

string

customerName

string

customerAddress

string

POST/api/company/{companyId}/millcertification/{millCertificationId}/manual

curl --request POST \
  --url https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/manual \
  --header 'Authorization: <string>' \
  --header 'Content-Type: multipart/form-data'

shell

Example Request Body

{}

json

Example Responses

{
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "originalFileName": "originalFileName",
  "storageFileName": "storageFileName",
  "status": 0,
  "isTestRun": true,
  "supplier": "supplier",
  "mill": "mill",
  "standard": "standard",
  "quality": "quality",
  "productionProcess": "productionProcess",
  "caresQR": "caresQR",
  "certificateDate": "certificateDate",
  "customerName": "customerName",
  "customerAddress": "customerAddress"
}

json

application/json

Review a mill certification

POST

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/review

Submits or updates a review decision (Approved or Issue) for a completed mill certification.

Review a mill certification › path Parameters

companyId

string · uuid · required

The unique identifier of the company

millCertificationId

string · uuid · required

The unique identifier of the mill certification

Review a mill certification › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Review a mill certification › Request Body

reviewStatus

integer · enum · int32

Enum values:

Default: 1

comment

string

Review a mill certification › Responses

Review submitted successfully

millCertificationId

string · uuid

reviewStatus

integer · int32

reviewStatusLabel

string

reviewComment

string

reviewedByName

string

reviewedAt

string · date-time

message

string

POST/api/company/{companyId}/millcertification/{millCertificationId}/review

curl --request POST \
  --url https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/review \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reviewStatus": 1,
  "comment": "comment"
}
'

shell

Example Request Body

{
  "reviewStatus": 1,
  "comment": "comment"
}

json

Example Responses

{
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "reviewStatus": 0,
  "reviewStatusLabel": "reviewStatusLabel",
  "reviewComment": "reviewComment",
  "reviewedByName": "reviewedByName",
  "reviewedAt": "2024-08-25T15:00:00Z",
  "message": "message"
}

json

application/json

Update mill certification data

PUT

https://api.gosmarter.ai

/api/company/{companyId}/millcertification/{millCertificationId}/update

Persists the full mill certification state — document-level fields, heat records, and mechanical property records — in a single request. The frontend sends the complete object as it expects it to be after save. Each section is optional; omitted sections are not touched.

Update mill certification data › path Parameters

companyId

string · uuid · required

The unique identifier of the company.

millCertificationId

string · uuid · required

The unique identifier of the mill certification.

Update mill certification data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Update mill certification data › Request Body

object

object[]

deletedHeatIds

string[]

deletedMechanicalPropertyIds

string[]

object[]

Update mill certification data › Responses

All changes persisted successfully

object

object[]

deletedHeatIds

string[]

deletedMechanicalPropertyIds

string[]

object[]

PUT/api/company/{companyId}/millcertification/{millCertificationId}/update

curl --request PUT \
  --url https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/update \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "standard": "standard",
    "quality": "quality",
    "productionProcess": "productionProcess",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ]
}
'

shell

Example Request Body

{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "standard": "standard",
    "quality": "quality",
    "productionProcess": "productionProcess",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ]
}

json

Example Responses

{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "standard": "standard",
    "quality": "quality",
    "productionProcess": "productionProcess",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ]
}

json

application/json

OrderLineItems MillCertifications