• Venue and event management in the cloud

How Can We Help?


Events: Create or Update Charge Catalogue

In this article


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.

{
   "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"
   }
}