A contract line is a header containing multiple schedule lines and is tied directly to a contract.
Returns up to 100 object references from the collection with a key, ID, and link for each contract line. This operation is mostly for use in testing; use query to find objects that meet certain criteria and to specify properties that are returned.
OK
Bad Request
{- "ia::result": [
- {
- "key": "1",
- "id": "1",
- "href": "/objects/contracts/contract-line/1"
}, - {
- "key": "2",
- "id": "2",
- "href": "/objects/contracts/contract-line/2"
}, - {
- "key": "3",
- "id": "3",
- "href": "/objects/contracts/contract-line/3"
}
], - "ia::meta": {
- "totalCount": 3,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new contract line.
Contract line to create
required | object contract | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
state | string Default: "inProgress" State Example: "completed" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
startDate | string <date> Line start Example: "2024-01-01" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
endDate | string <date> Line end Example: "2024-04-30" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
changeType | string or null Default: null Change type Example: "newMRR" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
itemDescription | string Item description Example: "API usage" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deliveryStatus | string Default: "delivered" Delivery status Example: "undelivered" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
postingDate | string <date> GL posting date Example: "2024-01-01" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
memo | string or null Post Memo Example: "POSTING LINE" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shipToSource | string Default: "contractValue" Specifies where the ship-to contact information should come from Example: "contractValue" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billToSource | string Default: "contractValue" Specifies where the bill-to contact information should come from Example: "contractValue" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
revenueDeferralStatus | string Default: "deferRevenueUntilItemIsDelivered" Revenue recognition deferral status Example: "deferRevenueUntilItemIsDelivered" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isRecurring | boolean Default: false Recurring Example: false | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Created
Bad Request
{- "contract": {
- "key": "1"
}, - "item": {
- "key": "2"
}, - "dimensions": {
- "location": {
- "key": "1"
}
}, - "startDate": "2022-01-01",
- "endDate": "2022-12-31",
- "billing": {
- "quantity": "12",
- "rate": "12",
- "multiplier": "1",
- "discount": "0",
- "method": "fixedPrice",
- "amountFrequency": "includeWithEveryInvoice",
- "frequency": "monthly",
- "flatFixedAmount": "144",
- "baseFlatFixedAmount": "144",
- "totalFlatFixedAmount": "1728",
- "totalBaseFlatFixedAmount": "1728"
}, - "changeType": "newMRR",
- "lineType": "sale",
- "revenue": {
- "journal1": {
- "revenueTemplate": {
- "key": "1"
}
}
}, - "postingDate": "2022-01-01"
}
{- "ia::result": {
- "id": "26",
- "key": "26",
- "href": "/objects/contracts/contract-line/26"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Returns detailed information for a specified contract line.
key required | string System-assigned key for the contract line. Example: 99 |
OK
Bad Request
{- "ia::result": {
- "id": "3",
- "key": "3",
- "contract": {
- "key": "1",
- "id": "CON-001",
- "state": "inProgress",
- "name": "10-17 MEA bundle",
- "href": "/objects/contracts/contract/1"
}, - "parent": {
- "id": null,
- "key": null,
- "lineNumber": null
}, - "state": "inProgress",
- "lineNumber": 3,
- "recurringBillingPeriod": null,
- "startDate": "2017-01-01",
- "endDate": "2017-12-31",
- "cancelationDate": null,
- "item": {
- "key": "2552",
- "id": "16",
- "name": "Service - Gold",
- "href": "/objects/inventory-control/item/2552"
}, - "itemDescription": null,
- "revenueDeferralStatus": "deferRevenueUntilItemIsDelivered",
- "billing": {
- "quantity": null,
- "rate": null,
- "multiplier": null,
- "discount": "0",
- "template": {
- "key": "1",
- "id": "12P_BeginingPeriod",
- "method": "Predefined percentages",
- "href": "/objects/contracts/billing-template/1"
}, - "schedule": {
- "id": "11",
- "key": "11",
- "status": "inProgress",
- "href": "/objects/contracts/billing-schedule/11"
}, - "startDate": "2017-01-01",
- "endDate": "2017-12-31",
- "method": "fixedPrice",
- "amountFrequency": "useBillingTemplate",
- "frequency": null,
- "flatFixedAmount": "200",
- "baseFlatFixedAmount": "200",
- "totalFlatFixedAmount": "200",
- "totalBaseFlatFixedAmount": "200",
- "usageQuantityReset": "afterEachRenewal",
- "isUsageQuantityRecurring": false,
- "holdDate": null,
- "resumeDate": null,
- "memo": null,
- "durationInPeriods": null,
- "proratePartialPeriods": false,
- "quantityType": null,
- "committedQuantityEndAction": null,
- "committedQuantityExcess": null
}, - "currency": {
- "exchangeRateDate": "2017-01-01",
- "exchangeRate": "1.000000000000"
}, - "contacts": {
- "billTo": {
- "key": "116",
- "id": "Power Aerospace Materials(C1)",
- "href": "/objects/company-config/contact/116"
}, - "shipTo": {
- "key": "116",
- "id": "Power Aerospace Materials(C1)",
- "href": "/objects/company-config/contact/116"
}
}, - "billToSource": "contractValue",
- "shipToSource": "contractValue",
- "renewal": {
- "renew": false,
- "billingTemplate": {
- "key": null,
- "id": null
}
}, - "isRecurring": false,
- "lineType": "sale",
- "revenue": {
- "journal1": {
- "revenueTemplate": {
- "key": "5",
- "id": "STRAIGHTLINE_MANUAL",
- "recognitionMethod": "Straight line",
- "href": "/objects/contracts/revenue-template/5"
}, - "startDate": "2017-01-01",
- "endDate": "2017-12-31",
- "revenueSchedule": {
- "id": "3183",
- "key": "3183",
- "status": "inProgress",
- "href": "/objects/contracts/revenue-schedule/3183"
}, - "glJournal": {
- "key": "51",
- "id": "LEGACYREVREC",
- "name": "Legacy Revenue Recognition Journal",
- "href": "/objects/general-ledger/journal/51"
}
}, - "journal2": {
- "revenueTemplate": {
- "key": "7",
- "id": "DAILYRATE_MANUAL",
- "recognitionMethod": "Daily rate",
- "href": "/objects/contracts/revenue-template/7"
}, - "startDate": "2017-01-01",
- "endDate": "2017-12-31",
- "revenueSchedule": {
- "id": "3184",
- "key": "3184",
- "status": "inProgress",
- "href": "/objects/contracts/revenue-schedule/3184"
}, - "glJournal": {
- "key": "53",
- "id": "ASC606REVREC",
- "name": "ASC 606 Revenue Recognition Journal",
- "href": "/objects/general-ledger/journal/53"
}
}, - "totalQuantity": null,
- "holdDate": null,
- "resumeDate": null,
- "memo": null
}, - "dimensions": {
- "location": {
- "key": "1",
- "id": "1",
- "name": "United States of America",
- "href": "/objects/company-config/location/1"
}, - "department": {
- "key": null,
- "id": null,
- "name": null
}, - "task": {
- "key": null,
- "name": null,
- "id": null
}, - "customer": {
- "key": "1",
- "id": "1",
- "name": "Power Aerospace Materials",
- "href": "/objects/accounts-receivable/customer/1"
}, - "nsp::product_line1": {
- "key": null
}, - "nsp::region": {
- "key": null
}, - "nsp::vertical": {
- "key": null
}, - "project": {
- "key": null,
- "id": null,
- "name": null
}, - "vendor": {
- "key": null,
- "id": null,
- "name": null
}, - "employee": {
- "key": null,
- "id": null,
- "name": null
}, - "class": {
- "key": null,
- "id": null,
- "name": null
}
}, - "audit": {
- "createdDateTime": "2017-10-17T19:05:49Z",
- "modifiedDateTime": "2019-03-20T17:08:44Z",
- "createdBy": "1",
- "modifiedBy": "109"
}, - "changeType": null,
- "priceCalculationMemo": "Flat Amount: 200, Rate 0 per 1; Quantity less included units 0",
- "deliveryStatus": "delivered",
- "deliveryDate": "2017-01-01",
- "postingDate": "2017-01-01",
- "expense": {
- "holdDate": null,
- "resumeDate": null,
- "memo": null
}, - "memo": null,
- "renewalTriggerDate": null,
- "lineRenewalDate": null,
- "href": "/objects/contracts/contract-line/3"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing contract line by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned key for the contract line. Example: 99 |
state | string Default: "inProgress" State Example: "completed" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
startDate | string <date> Line start Example: "2024-01-01" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
endDate | string <date> Line end Example: "2024-04-30" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
changeType | string or null Default: null Change type Example: "newMRR" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
itemDescription | string Item description Example: "API usage" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deliveryStatus | string Default: "delivered" Delivery status Example: "undelivered" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
postingDate | string <date> GL posting date Example: "2024-01-01" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
memo | string or null Post Memo Example: "POSTING LINE" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shipToSource | string Default: "contractValue" Specifies where the ship-to contact information should come from Example: "contractValue" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
billToSource | string Default: "contractValue" Specifies where the bill-to contact information should come from Example: "contractValue" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
revenueDeferralStatus | string Default: "deferRevenueUntilItemIsDelivered" Revenue recognition deferral status Example: "deferRevenueUntilItemIsDelivered" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isRecurring | boolean Default: false Recurring Example: false | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object contract | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
OK
Bad Request
{- "item": {
- "key": "3"
}, - "dimensions": {
- "location": {
- "key": "1"
}
}, - "startDate": "2022-01-01",
- "endDate": "2022-12-31",
- "billing": {
- "quantity": "12",
- "rate": "12",
- "multiplier": "1",
- "discount": "0",
- "method": "fixedPrice",
- "amountFrequency": "includeWithEveryInvoice",
- "frequency": "monthly",
- "flatFixedAmount": "144",
- "baseFlatFixedAmount": "144",
- "totalFlatFixedAmount": "1728",
- "totalBaseFlatFixedAmount": "1728"
}, - "changeType": "newMRR",
- "lineType": "sale",
- "revenue": {
- "journal1": {
- "revenueTemplate": {
- "key": "1"
}
}, - "journal2": {
- "revenueTemplate": {
- "key": "2"
}
}
}, - "postingDate": "2022-01-01"
}
{- "ia::result": {
- "id": "3",
- "key": "3",
- "href": "/objects/contracts/contract-line/3"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Deletes a contract line.
key required | string System-assigned key for the contract line. Example: 99 |
No Content
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}
Use the query service to find contract lines that meet certain criteria and to specify the properties that are returned.
OK
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}