Add PriceBook

Use this operation to add new PriceBook object.

Parameters

Body Params
JSON:json
PriceBook details needs to be passed as body parameter,it should be in JSON format.
XML:string
PriceBook details needs to be passed as body parameter,it should be in XML format.
Path Params
yourCompany:string
The Company name need to passed in the base URL.For eg. if you enter xyzcompany name, the url https://{yourCompany}.agiliron.net/agiliron/api-40.php/PriceBook will change to https://xyzcompany.agiliron.net/agiliron/api-40.php/PriceBook
Header Params
Accept:string
Response header need to be passed for eg. application/json or application/xml.
Query Auth
key:string
API key needs to be passed in this variable.The option to enter API key will appear when you click on Try it button.This will be the first option in AUTHENTICATION block.Default is SET to 0.
Header Auth
apiKey:string
Dedicated API key needs to be passed in this variable via header.The option to enter API key will appear when you click on Try it button.This will be the second option in AUTHENTICATION block.Default is SET to 0.

Sample Code

{
    "PriceBooks": {
        "PriceBook": {
            "PriceBookName": "Default PriceBook",
            "Active": "Yes",
            "IsSpecialPriceBook": "No",
            "IsVendorPriceBook": "No",
            "IsVolumePriceBook": "No",
            "SpecialsStartDate": "00-00-0000",
            "SpecialsEndDate": "00-00-0000",
            "DefaultCurrency": "US Dollar",
            "Description": "Description Goes Here.",
            "CreatedTime": "03-18-2025 11:44:57",
            "CreatedTimeUTC": "03-18-2025 06:14:57",
            "ModifiedTime": "03-18-2025 11:45:10",
            "ModifiedTimeUTC": "03-18-2025 06:15:10"
        },
        "TotalRecords": "1",
        "CurrentPage": "1",
        "TotalPages": "1",
        "PageSize": "50"
    }
}
<PriceBooks>
		<PriceBook>
			<PriceBookId>142993</PriceBookId>
			<PriceBookName>Default PriceBook</PriceBookName>
			<Active>Yes</Active>
			<IsSpecialPriceBook>No</IsSpecialPriceBook>
			<IsVendorPriceBook>No</IsVendorPriceBook>
			<IsVolumePriceBook>No</IsVolumePriceBook>
			<SpecialsStartDate>00-00-0000</SpecialsStartDate>
			<SpecialsEndDate>00-00-0000</SpecialsEndDate>
			<DefaultCurrency>US Dollar</DefaultCurrency>
			<Description>Description Goes Here.</Description>
			<CreatedTime>03-18-2025 11:44:57</CreatedTime>
			<CreatedTimeUTC>03-18-2025 06:14:57</CreatedTimeUTC>
			<ModifiedTime>03-18-2025 11:45:10</ModifiedTime>
			<ModifiedTimeUTC>03-18-2025 06:15:10</ModifiedTimeUTC>
		</PriceBook>
		<TotalRecords>1</TotalRecords>
		<CurrentPage>1</CurrentPage>
		<TotalPages>1</TotalPages>
		<PageSize>50</PageSize>
	</PriceBooks>

Sample Response

{
    "MCM": {
        "response": {
            "objectType": "PriceBook",
            "syncTime": "2025-03-28 07:43:53"
        },
        "parameters": {
            "results": {
                "message": {
                    "status": "Success",
                    "success_message": {
                        "pricebook_name": "Default PriceBook",
                        "pricebook_id": "143231"
                    }
                }
            }
        }
    }
}
<MCM>
		<response>
			<objectType>PriceBook</objectType>
			<syncTime>2025-03-28 07:43:53</syncTime>
		</response>
		<parameters>
			<results>
				<message>
					<status>Success</status>
					<success_message>
						<pricebook_name>Default PriceBook</pricebook_name>
						<pricebook_id>143231</pricebook_id>
					</success_message>
				</message>
			</results>
		</parameters>
	</MCM>

WADL

<?xml version="1.0" encoding="utf-8"?>
<application>
   <resources base="https://{yourCompany}.agiliron.net/agiliron/api-40/">
     <resource path="PriceBook">
       <method name="POST">
         <request>
           <param name="key" type="xsd:string" style="query" required="true"/>
           <param name="PriceBookName" type="xsd:string" style="body" required="true"/>
           <param name="Active" type="xsd:string" style="body"/>
           <param name="IsSpecialPriceBook" type="xsd:string" style="body"/>
           <param name="IsVendorPriceBook" type="xsd:string" style="body"/>
           <param name="IsVolumePriceBook" type="xsd:string" style="body"/>
           <param name="SpecialsStartDate" type="xsd:date" style="body"/>
           <param name="SpecialsEndDate" type="xsd:date" style="body"/>
           <param name="DefaultCurrency" type="xsd:string" style="body"/>
           <param name="Description" type="xsd:string" style="body"/>
           <param name="CreatedTime" type="xsd:dateTime" style="body"/>
           <param name="ModifiedTime" type="xsd:dateTime" style="body"/>
         </request> 
         <response status="200"> 
            <representation mediaType="application/xml" element="yn:ResultSet"/> 
         </response> 
         <response status="400"> 
            <representation mediaType="application/xml" element="ya:Error"/> 
         </response> 
       </method> 
     </resource> 
   </resources>
 </application>

© Copyright 2022 Agiliron - All Rights Reserved.