v2 > Services > CertificationsCreate

Create one or more certifications in Origin.

• URL

  /connect/v2/certifications/create

  /connect/v2/async/certifications/create

• Method:

  POST

• URL Params

  none

• Request :

• Sample Request (Required fields):

{
  "certifications":[
    {
      "locale":"en",
      "externalId":"ABC-123",
      "url":"https://public.facing.url/certificate.pdf",
      "certificateNumber":"123456",
      "reportingBody":{
        "name":"Veritas"
      },
      "standard":{
        "code":"ISO 9001"
      }
    }
  ]
}

• Sample Request (All fields):

{
   "certifications":[
      {
         "locale":"en",
         "externalId":"ABC-123",
         "certificateNumber":"ABC-123-000001",
         "url":"https://public.facing.url/certificate.pdf",
         "additionalsDocuments":[
            {
               "originalUrl":"https://public.facing.url/image.jpg"
            }
         ],
         "reportingBody":{
            "name":"Veritas"
         },
         "standard":{
            "code":"FSC®"
         },
         "issueDate":"2008-09-15T15:53:00",
         "expiryDate":"2010-09-15T15:53:00",
         "brands":[
            {
               "name":"ACME Inc.",
               "website":"www.acmexyz.com"
            }
         ],
         "contacts":[
            {
               "externalId":"JOHNSMITHVENDOR1",
               "type":"VENDOR",
               "companyName":"ACME Inc.",
               "name":"John Smith",
               "website":"https://www.acme.com/",
               "postalAddress":"2500 Street Avenue P.O. Box 999 Manchester, PA 1234",
               "phone":"1-999-123-1234",
               "email":"salesrep@acme.com"
            }
         ],
         "channels":[
            {
               "name":"ORIGIN"
            }
         ],
         "regulatoryStandardCompliances":[
            {
               "code":"ISO 9001"
            }
         ],
         "featuresCustoms":[
            {
               "code":"CUSTOM_TEXT_ATTRIBUTE",
               "name":"Highest supported temperature",
               "value":{
                  "content":"1500C"
               }
            }
         ],
         "featuresProperties":[
            {
               "code":"LIFEEXPECTANCY",
               "value":{
                  "content":"3"
               },
               "unit":{
                  "code":"YEAR"
               }
            },
            {
               "code":"FSC_LABEL_TYPE",
               "value":{
                  "code":"FSC 100%"
               }
            }
         ],
         "voc":{
            "content":{
               "densityLimitGL":"10",
               "densityUnit": {
                  "code": "EM_GL"
               },
               "containsAddedMCPCE":"true",
               "regulatoryStandardCompliances":[
                  {
                     "standard":{
                        "code":"CARB SCM (2007)"
                     },
                     "productTypeCode":"Specialty Coatings - Bituminous Roof Coatings"
                  }
               ],
               "regulatoryStandardCustoms":[
                  {
                     "standard":{
                        "code":"A CUSTOM CODE"
                     }
                  }
               ],
               "testMethods":[
                  {
                     "standard":{
                        "code":"ASTM Methods D2369"
                     }
                  }
               ],
               "exemptCompounds":[
                  {
                     "CAS":"142731-63-32",
                     "name":"TRANS-3-HEPTENE",
                     "percentByWeight":"1.9"
                  }
               ]
            },
            "emission":{
               "densityMin":"250",
               "densityMax":"500",
               "densityUnit": {
                  "code": "EM_UGM3"
               },
               "regulatoryStandardCompliances":[
                  {
                     "standard":{
                        "code":"Blue Angel Elastic Floorings"
                     }
                  }
               ]
            }
         }
      }
   ]
}

• Response (sync mode) :

• Sample Response (Success in sync mode):

  HTTP Code : 200

{
  "status":{
    "state":"SUCCESS"
  },
  "result":{
    "entityType":"CERTIFICATION",
    "correlations":[
      {
        "externalId":"ABC-123",
        "originId":"f6f2c73e-4054-44bc-95f2-9e033b9c2282"
      }
    ]
  },
  "connectRequest":{
    "certifications":[
      {
        "locale":"en",
        "externalId":"ABC-123",
        "certificateNumber":"123456",
        "url":"https://public.facing.url/certificate.pdf",
        "reportingBody":{
          "name":"Veritas"
        },
        "standard":{
          "code":"ISO 9001"
        }
      }
    ]
  }
}

• Response (async mode):

• Sample Response (Success in async mode):

  HTTP Code : 200

{
  "status":{
    "state":"SUCCESS"
  },
  "result":{
    "poolingCallback":"https://origin.build/equinox/connect/v2/result/certifications_create/batch/1c8a06b6-45be-4e68-9e2d-5c1f075e6ca2"
  },
  "connectRequest":{
    "certifications":[
      {
        "locale":"en",
        "externalId":"ABC-123",
        "certificateNumber":"123456",
        "url":"https://public.facing.url/certificate.pdf",
        "reportingBody":{
          "name":"Veritas"
        },
        "standard":{
          "code":"ISO 9001"
        }
      }
    ]
  }
}

• Sample Response (Error):

  HTTP Code : 400, 500

{
  "status":{
    "state":"ERROR",
    "code":"CE00001 - Connect request failed validation. Refer to provided messages for details.",
    "messages":[
      "certifications[1] require one locale.",
      "certifications[1] require one externalId.",
      "certifications[1] require one reportingBody.name.",
      "certifications[1] require one standard.code.",
      "certifications[1] has an invalid date format for issueDate. Date must be ISO-8601.",
      "certifications[1] require one url or additionalsDocuments."
    ]
  },
  "connectRequest":{
    "certifications":[
      {
        "certificateNumber":"123456",
        "issueDate":"2017-09-15T15:53:00ZBC",
        "expiryDate":"2018-09-15T15:53:00"
      }
    ]
  }
}