Events: Create or Update Charge Catalogue

Updated June 14, 2023 16:13

Create or Update Charge Catalogue

POST /v2/event/save/catl/charges

This API creates a Charge Catalogue in an event and returns a unique Id and its associated details. This same API allows you to update an existing Charge Catalogue e.g. change the comments or the qty etc.

Parameters

Id Long

The Id of the charge catalogue. Required only if you are updating the charge catalogue.

TemplateId Long

The id of the charge item.

Event Object {Id}

The event to which the catalogue item should be associated with. The event must exist in your Priava Account. Passed in JSON format where:
Id = Id of the Event.

StartDate DateTime

The start date and time of the catalogue item.

EndDate DateTime

The end date and time of the catalogue item.

Contact Object {Id}

The contact to whom the catalogue item should be associated to. The contact must exist in your Priava Account. Passed in JSON format where:

Venue (optional) Object {Id}

The venue with which the catalogue item should be associated to. The venue must exist in your Priava Account. Passed in JSON format where:
Id = Id of the Venue.

VenueBookingId (optional) Array [Id]

List of Venue Booking with which the catalogue item should be associated. The booking must exist in your Priava Account. Passed in an Array format where:
Id = Id of the Venue Booking.
Can pass multiple Venue Booking Ids in the Array in Create case and single Venue Booking Id in Update case.

In the case of Create scenario, it will create one Event Catalogue per booking passed.

In the case of Update scenario, it will accept only one value in an array. As you can not associate multiple venue Booking to a single Event Catalogue Item.

NOTE: If both VenueBookingId and Venue data are passed, VenueBookingId arrays takes precedence over Venue.

CreditOrDebit String

This represents whether the catalogue item should be credited or debited to the event. Only values supported are Credit or Debit.

Qty Integer

The required quantity of the catalogue item.

UnitCost Double

The unit cost of one catalogue item.

UnitPrice Double

The unit price of one catalogue item.

DiscountType String

This represents the type of discount provided. The possible values could be 'P' and 'C', where 'P' is the percentile discount and 'C' is a fixed discount amount.

DiscountValue String

This represents the discount provided for the catalogue item. The value provided is used along with the discount type to calculate the total discount amount.

TaxType Object {Id, Name}

The tax type to be associated to catalogue item. Tax type must exist in your Priava Account. Passed in JSON format where:
Id = Id of the Tax Type.
Name = Name of the Tax Type.

CatalogueComments String

The comment to be associated with the catalogue item.

FinancialComments string

The financial comment to be associated with the catalogue item.

JSON

{
   "StartDate": "30/03/2019 15:30",
   "Qty": 2,
   "CreditOrDebit": "Debit",
   "CatalogueComments": "",
   "TemplateId": 27186,
   "Venue": {
      "Id": 100172339
   },
   "EndDate": "31/03/2019 01:00",
   "VenueBooking": {},
   "DiscountAmount": "50.00",
   "Contact": {
      "ContactId": 99964
   },
   "UnitCost": "0.00",
   "TaxType": {
      "Id": 28,
      "Name": "(no tax) internal only"
   },
   "UnitPrice": "500.00",
   "FinancialComments": "",
   "DiscountType": "P",
   "Event": {
      "Id": 101550014
   },
   "Id": "",
   "DiscountValue": "10.00"
}

Response:

{
   "success": true,
   "result": {
      "Abbreviation": "CH",
      "RefPkgId": "",
      "Tax": "0.00",
      "FormulaToolTip": "",
      "TotalUnitCost": "0.00",
      "NetTotalExTax": "900.00",
      "Name": "Gold",
      "StartDate": "30/03/2019 15:30",
      "Formula": {},
      "Qty": 2,
      "ProfitAmount": "900.00",
      "ProfitPercentage": "100.00",
      "CreditOrDebit": "Debit",
      "CatalogueComments": "",
      "TemplateId": 27186,
      "Venue": {
         "Id": 100172339,
         "Name": "Venue Name"
      },
      "EndDate": "31/03/2019 01:00",
      "VenueBooking": {},
      "DiscountAmount": "100.00",
      "Contact": {
         "Firstname": "Jhet",
         "Email": "jw@priava.com",
         "Organisation": "Test Mandatory Field",
         "Phone": "8383430000",
         "Lastname": "Willis",
         "Inactive": false,
         "ContactId": 99964,
         "JobTitle": "Test"
      },
      "UnitCost": "0.00",
      "TaxType": {
         "TaxPercentage": 0,
         "Position": 11,
         "TaxIncluded": false,
         "Inactive": false,
         "Id": 28,
         "Name": "(no tax) internal only"
      },
      "UnitPrice": "500.00",
      "FinancialComments": "",
      "DiscountType": "P",
      "GrandTotal": "900.00",
      "Event": {
         "Id": 101550014,
         "Name": "Catalogue API DND"
      },
      "Id": 104545476,
      "DiscountValue": "10.00"
   }
}

Was this article helpful?

Have more questions? Submit a request