Common Models

Some Disbursements endpoints share a common data model for requests; these are described below.

Disbursement

{
    "contactId": "VN94T9H7815",
    "amount": 23.32,
    "designation": { "designationId": 501 },
    "batchName": "MyBatchName",
    "bankAccount": { "bankAccountId": 26 },
    "checkNumber": "12345",
    "date": "1925-04-10",
    "disclosureFields": [
    {
        "disclosureFieldId": 30007,
        "designationId": 501,
        "value": "30028"
    },
    {
        "disclosureFieldId": 30008,
        "designationId": -1,
         "value": "2016"
    }
    ],
    "note": "note goes here",
    "sourceCode": { sourceCodeId: 42 },
    "disbursementCreditCardLinkId": null,
    "disbursementReimbursementLinkId": "VN8429H8VZ2"
}

Properties:

KeyValue
contactIdRequired String; The contact ID of the disbursement.
amountRequired String; The amount of the disbursement. Value that has more than 2 digits after decimal point will not be accepted.
designationdesignationId | Required Integer; The designation to assign to the disbursement.
bankAccountbankAccountId | Integer; The numeric ID of the bank account to associate this disbursement with. The bank account must be active and belong to the same designation as the disbursement. May be retrieved in the UI.
batchNameString; a free-form description of the batch of disbursements. Not related to contribution batches.
checkNumberString; the check number associated with this disbursement, if any.
dateString; A date string between 1901-01-01 and 2075-12-31.
disbursementCreditCardLinkIdString; A disbursement to link with this disbursement, if any. When disclosing a payment made to a credit card, use disbursementCreditCardLinkId to link disbursements itemizing each purchase made to the parent disbursement with which the bill was paid.

Must be in the same designation as the disbursement in question, and must also associate the correct ExpenseSubtype disclosure field of Credit Card/Paycheck Item with this disbursement.
disbursementReimbursementLinkIdString; A disbursement to link with this disbursement, if any. When reimbursing an individual or organization for purchases made on your behalf, use disbursementReimbursementLinkId to link disbursements itemizing each purchase to the parent disbursement in which they are reimbursed.

Must be in the same designation as the disbursement in question, and must also associate the correct ExpenseSubtype disclosure field of Reimbursement Item with this disbursement.
disclosureFieldsdisclosureFieldId | Integer; The ID of the disclosure field, from among the designation-specific disbursement disclosure fields for this disbursement.
value | String; The value of the disclosure field.
designationId | Integer; the id of the designation to apply the disclosure field for. Must be the designation associated with the disbursement, or -1 for disclosure fields that are not report-specific.
noteA note detailing the disbursement.
sourceCodesourceCodeId | Integer; A source code id to attribute to the disbursement.

Disbursement Response

Successful disbursement creation returns the ID of the newly created disbursement. Example:

{
  "disbursementId": "VN8429H8VZ2"
}

The status code of the response indicates whether a new disbursement was created (201) or if an existing one was updated (200).