Priority ERP

engini’s priority erp activities allow you to create and modify records, activate form activations, and make api calls from your priority erp using priority’s webhooks module getting started with priority erp prerequisites priority api license open access to priority via port 443 if you can’t open this access, you can also just whitelist our ip (see below) 34 159 217 185 34 141 24 31 optional – dictionary module to enable language specific operations for both crud operations (create, read, update, delete) and procedures, ensure that the dictionary module is activated in your priority erp system by default, the api will operate according to the system language unless specified otherwise connecting engini to priority erp enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the top bar choose priority erp’s option from the available applications enter the following details in the “edit connection” form connection name choose a significant name public connection enable this option to allow multiple users and workflows to share the same connection instead of creating separate connections api url including the tabula ini for example https //erp engini io/odata/priority/tabula ini https //erp engini io/odata/priority/tabula ini to specify the language for api operations, append a comma and the language code to the end of the url for example, for american english, use “ https //erp engini io/odata/priority/tabula ini,3 https //erp engini io/odata/priority/tabula ini,3 “ database name company id in companies form api username companies that use priority identity management module should place their personal access token api password companies that use priority identity management module should place “pat” in all caps websdk url optional used when using a dedicated priority connector x app id & x app key websdk username optional used when using a priority’s form activations, for example, for printing a price quotation document websdk password optional used when using a priority’s form activations, for example, for printing a price quotation document time zone choose the correct time zone of your location, or you enterprise location communication channel choose the appropriate connection type based on your setup cloud if you are connecting to a database hosted in a cloud environment, select “cloud” opa if your database is on premises and you are using an on premises agent (opa) for the connection, select “opa” in this case, an additional field will appear on prem agent choose the specific on premises agent that you want to use for this connection if you have multiple agents configured advanced settings provides additional configuration options for specific setup requirements, such as security settings and custom connection parameters these settings are usually only needed in advanced scenarios save settings click on the save button located at the bottom of the form triggers record updated this action triggers when a record is updated and sends the updated data to a specified webhook url for further processing url the webhook endpoint where the updated record data will be sent this is the destination that receives the event object type defines which type of record or entity you want to monitor for updates (e g , item, order, contact) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions actions create record this action creates a new record in the selected object type with the data you provide in the fields object type specifies the type of record you want to create (e g , customer order, contact, item) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update record this action updates an existing record in the selected object type using the data provided in the fields object type specifies the type of record you want to update (e g , customer order, contact, item) record (customer order) a required field that identifies the specific record to update for each object type, this field will dynamically match the relevant entity (e g , order id, contact id) that was connected or selected add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields get record this action retrieves a specific record from the selected object type and returns the requested data fields object type specifies the type of record you want to retrieve (e g , customer order, contact, item) record (customer order) a required field that identifies the specific record to retrieve for each object type, this field dynamically represents the relevant entity (e g , order id, contact id) that was connected or selected output fields allows you to choose which fields from the record will be returned in the response get records this action retrieves a list of records from the selected object type, with options to filter, sort, and limit the results object type specifies the type of records you want to retrieve (e g , customer orders, contacts, items) top n you can set the maximum number of sales order records engini will return during one workflow cycle (default = all records) if you set top n = 1 , a single record will be returned instead of an array if no record is found, the action will fail, allowing you to implement an if condition within the workflow this can be useful for processes where the existence of a record determines the next steps in the workflow offset the offset parameter allows you to skip a certain number of records from the beginning of the result set (default = 0 records) add filter click add filter to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add filters add sort click add sort to organize the data list by a selected field in ascending or descending order to learn more about sorting data, click here https //help engini ai/workflow editor#add sorts delete record this action deletes a specific record from the selected object type object type specifies the type of record you want to delete (e g , customer order, contact, item) record (id) a required field that represents the unique identifier of the record you want to delete this value corresponds to the specific object selected (e g , order id, contact id) form activation form name choose the form name from the drop down menu the available forms are the open parent screens and child screens from your priority account activation choose the activation from the drop down menu according to the form name, an identifier field will appear enter a static value as you can see at the image below run press run each run can add new fields to fill in fill in the required fields ensure all necessary fields are filled in correctly before proceeding run procedure prerequisites eprog form is accessible to api in formlimited form the user used for the integration should have at least read privileges to eprog form the user used for the integration should have privileges to execute the relevant procedure to use priority’s run procedure, follow the following steps procedure name choose the procedure name from the field options tab in the tooltip menu all the available procedures run press run each run can add new fields to fill in when you need to reset the values you can press the “reset” button repeat steps 2 until all required fields are filled up and “ran successfully” message will appear after the procedure ran successfully, you can now change the relevant static values to parameters to allow the workflow to run using dynamic values send api request this action sends a custom api request to an external service, allowing you to interact with endpoints using different methods, headers, and payloads base url the main endpoint of the api you want to call (e g , the server or service url) relative url the specific path or resource you want to access, appended to the base url method defines the http method used for the request (e g , get, post, put, delete) body type specifies the format of the request body (e g , json, form data) body the payload sent with the request, usually required for methods like post or put add headers allows you to include additional headers (e g , authorization, content type) required by the api add queries allows you to add query parameters to the request url (e g , filters, pagination)