Create Contract

Creates a new contract in the system.

Endpoint

POST /contracts

Authentication

Required: Authorization header with valid token

Request Body

{
  "title": "string",
  "pickUpAddress": "string",
  "deliveryAddress": "string",
  "selfPickUp": "boolean",
  "clientId": "uuid",
  "number": "string",
  "startDate": "date-time",
  "endDate": "date-time",
  "structureId": "uuid",
  "externalId": "string",
  "city": "string",
  "country": "string",
  "constructionName": "string",
  "zipCode": "string",
  "contactName": "string",
  "contractPosition": "string",
  "contactPhone": "string",
  "contactEmail": "string",
  "additionalInformation": "string",
	"street": "string",
  "point": {
    "lng": "number",
    "lat": "number"
  }
}

Required Fields

  • clientId - UUID of the client
  • startDate - Contract start date (ISO 8601 format)
  • endDate - Contract end date (ISO 8601 format)
  • structureId - UUID of the structure

Fields description see here: Contract Management

Response

ContractEntity Schema

Error

Error Schema

Example Usage

curl -X POST "https://integration-api.ram.syniotec.com/master-data/v1/contract-management/contracts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Construction Site Contract",
    "clientId": "75f18aa7-b0aa-4d2c-b104-b513bec82a5f",
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-12-31T23:59:59Z",
    "structureId": "123e4567-e89b-12d3-a456-426614174000",
    "pickUpAddres": "123 Main St, City",
    "deliveryAddress": "456 Construction Ave, City",
    "selfPickUp": false,
    "street": "456 Construction Ave",
    "city": "City",
    "country": "Country",
    "zipCode": "12345",
    "contactName": "John Doe",
    "contactPhone": "+1234567890",
    "contactEmail": "[email protected]"
  }'

Now this is just the POST Create Contract endpoint. Would you like me to provide the GET Get Contracts endpoint separately?