Add or Update a Nominal Code

Nominal codes are made up of three distinct elements: 'Account','Cost Centre' and 'Department'. All three elements must be included in the web service POST data, however the cost centre and account elements may be empty.

Nominal codes in BigChange are stored by concatenating Account, Cost Centre and Department, separated by the / character. If existing nominal codes are submitted they will update the existing record based upon the concatenated nominal code, otherwise a new record will be created.

Query String Parameters

Name	Type	Description	Required
Action	String	ImportNominalCodes	Required

POST Data Parameters

Name	Type	Description	Note
Account	String(8)	Nominal code account.	Required
CostCentre	String(3)	Nominal code cost centre.	Required, however empty field is acceptable
Department	String(3)	Nominal code department.	Required, however empty field is acceptable
Description	String(100)	Description associated with nominal code.	Required, however empty field is acceptable
Type	String(1)	Nominal code type. Normally "P" or "B".	Required, however empty field is acceptable
Reference	String(40)	Remote system Nominal code reference.	Required, however empty field is acceptable

Response Codes

Example

Request

Request URL

https://webservice.bigchange.com/v01/services.ashx?action=importnominalcodes

Response

Response Data

{
  "Code": 0,
  "Result": [
    {
      "JourneyId": "12345",
      "StartTime": "2024-08-18T08:00:00Z",
      "EndTime": "2024-08-18T10:00:00Z",
      "StartLocation": "Location A",
      "EndLocation": "Location B",
      "Distance": 25.6,
      "Unit": "kilometers"
    }
  ]
}