Passer au contenu

Limited
Get attestation chapter

Requête

Returns typed attestation data including Extended Producer Responsibility, environment compliance declarations, and ESC (circular economy) standards.

Sécurité
oauth2(Portées requises: t1_api)
Chemin
specificationIdstring, (uuid)obligatoire

The unique identifier of the specification

curl -i -X GET \
  'https://apis.traceone.com/spec/v2/packaging/specifications/{specificationId}/attestation-chapter' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Réponses

Returns the attestation chapter

Corpsapplication/json
extendedProducerResponsibilityobject or null(ExtendedProducerResponsibility)

Section extended_producer_responsibility.

environmentobject or null(EnvironmentCompliance)

Section environment.

escStandardsobject or null(EscStandards)

Section esc_standards.

customFieldsArray of objects or null(CustomFields)

Custom field VALUES, one entry per custom component of the chapter. The template places retailer-defined custom components in the chapter; each component is a group of fields with its own published JSON Schema, listed by GET /v2/public/templates/{templateId}/chapters/ {chapterType}/custom-fields-schema. A published component never changes, and the same componentId is valid in every template that uses it.

WRITE RULES

  • An entry replaces the values of its component: a field the values object does not carry is cleared. A component the array does not carry keeps what it holds. null or absent = not supplied.
  • An entry is addressed by componentId. sectionCode is needed only when the component appears in more than one section of the chapter; without it, that is a 422 naming the missing field, customFields[i].sectionCode.
  • A componentId (or componentId + sectionCode) that is not in the chapter, or the same one twice: 422 naming the entry.
  • To change one field, read the entry, change it and send the whole values object back, with If-Match: the ETag of the chapter read. Without it, an edit made in between by the counterpart company is overwritten.
  • values is validated against the component's JSON Schema (types, formats, bounds, reference-list items, files owned by your company). A refusal is a 422 naming the field, customFields[i].values.<field>.
  • Mandatory fields (CustomFieldsSchema mandatoryFields) are not checked on write; they are checked when the section is validated.
  • Who may write follows the section that holds the component: in a custom section either party may write; in a standard section the section's own rule applies (e.g. retailer or supplier sections of the general chapter: owner company only). A read returns one entry per custom component of the chapter, with sectionCode always set.
questionnairesArray of objects(Questionnaire)read-only

Questionnaires attached to this chapter. Empty when there are none.

documentsobject or null(DocumentSection)read-only

Documents attached to this chapter. null when there are none.

Réponse
{
  "extendedProducerResponsibility": {
    "supplierPaysContributionToEcoOrganization": true,
    "supplierContributionText": "string",
    "validations": [ … ]
  },
  "environment": {
    "attestationOfCompliance": true,
    "packagingComplianceCertification": true,
    "supplierCompanyId": "60e634ac-9cf5-4a73-a6b6-1e5d15116468",
    "supplierSubsidiaryCompanyId": "371cde12-4e69-485a-ba21-c3de5c42017f",
    "validations": [ … ]
  },
  "escStandards": {
    "reUsage": true,
    "substanceRecycling": true,
    "energyReProcessing": true,
    "processingThroughCompostingAndBioDegradation": true,
    "dangerousSubstances": true,
    "heavyMetals": true,
    "companyCanProvideDocuments": true,
    "preventionByReductionAtSource": true,
    "criticalPointCode": "string",
    "validations": [ … ]
  },
  "customFields": [
    { … }
  ],
  "questionnaires": [
    { … }
  ],
  "documents": {
    "files": [ … ]
  }
}