Jump to

• Request
• Response

1b Subcontracts Audit

get

/api/v1/import/insert-contracts/{jobID}

This API allows the user to import subcontract(s), using a unique combination of the parameters: ContractNumber, VendorID, and MainJobNumber. If the subcontract does not exist in Texura, Textura will create a new subcontract with the specified values. If the subcontract does exist in Textura and if the subcontract has not been completed (accepted by the subcontractors), the existing subcontract will be replaced with the subcontract import data.There are certain pre-conditions for a successful transaction:

• General Contractor is assigned to an SWS accounting package
• The Project has a unique internal project number set on the project
• General Contractor has not invited any subs for the projecty
• The REST Client payload or import file is prepared and ready for import

A URI is sent as a response to a succesful import POST. Sending a GET to the URI, provides the user with an audit file for the import. For an example of a more detailed audit payload, see the example section below.

Request

Path Parameters

• jobID(required): integer(int64)
  Unique identifier of the job number.

Header Parameters

• Authentification(required):
  The protocol for the API requires a valid username and password for TPM.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

The job was successfully created.

Body ()

Root Schema : schema

Type: object

Show Source

• formattedMessage: string
  Example: Created Subcontract #2330054.010 on Project 10-2330054
• isoDateTime: string
  Example: 2023-02-01T09:42:04.998304
• mainJobNumber: string
  Example: 01-17011
• status: string
  Example: SUCCESS
• subcontractNumber: string
  Example: 1000
• subJobNumber: string
  Example: 17011
• texturaJobID: number
  Example: 61
• totalDuplicate: number
  Example: 0
• totalError: number
  Example: 1
• totalInfo: number
  Example: 0
• totalSuccess: number
  Example: 0
• vendorID: string
  Example: RON095

{
    "type":"object",
    "properties":{
        "texturaJobID":{
            "type":"number",
            "example":"61",
            "nullable":true
        },
        "totalDuplicate":{
            "type":"number",
            "example":"0",
            "nullable":true
        },
        "totalError":{
            "type":"number",
            "example":"1",
            "nullable":true
        },
        "totalInfo":{
            "type":"number",
            "example":"0",
            "nullable":true
        },
        "totalSuccess":{
            "type":"number",
            "example":"0",
            "nullable":true
        },
        "formattedMessage":{
            "type":"string",
            "example":"Created Subcontract #2330054.010 on Project 10-2330054",
            "nullable":true
        },
        "isoDateTime":{
            "type":"string",
            "example":"2023-02-01T09:42:04.998304",
            "nullable":true
        },
        "mainJobNumber":{
            "type":"string",
            "example":"01-17011",
            "nullable":true
        },
        "status":{
            "type":"string",
            "example":"SUCCESS",
            "nullable":true
        },
        "subJobNumber":{
            "type":"string",
            "example":"17011",
            "nullable":true
        },
        "subcontractNumber":{
            "type":"string",
            "example":"1000",
            "nullable":true
        },
        "vendorID":{
            "type":"string",
            "example":"RON095",
            "nullable":true
        }
    }
}

Examples

Select an example Insert-contracts response

202 Response

Accepted. Encountered when the requestor has asked for request export data or an audit log, but the request is still in process.

Default Response

Links to working URLs

Links

Production URL

https://services.texturacorp.com/ebis/api/v1/import/insert-contracts/{jobID}

Test URL

https://usint1.textura.oraclecloud.com/ebis/api/v1/import/insert-contracts/{jobID}

Back to Top