latestOpenAPI 3.0.02026-08-10233809957.8 KB

5cdfae3fa1fa

Bills

Creates an individual bill for a business.

post/bills

Request body

Example request

{
  "connection": {
    "businessName": "Railz",
    "serviceName": "quickbooks"
  },
  "data": {
    "vendorInvoiceNumber": "254",
    "postedDate": "2021-03-29",
    "dueDate": "2021-03-29",
    "currencyRate": 1.13,
    "memo": "Example bill memo.",
    "vendorRef": "132",
    "currency": "CAD",
    "locationRef": "3",
    "subsidiaryRefs": [
      "4"
    ],
    "trackingCategoryRef": "23118",
    "lines": [
      {
        "description": "Services rendered.",
        "unitAmount": 100.5,
        "quantity": 3,
        "taxAmount": 20.5,
        "customerRef": {
          "id": "124"
        },
        "billableStatus": "notBillable",
        "accountRef": "145",
        "trackingCategoryRef": "231",
        "taxRef": "24",
        "subTotal": 301.5,
        "totalAmount": 322
      }
    ]
  }
}

Response

pushCommunicationIdstring required
requestedOnstring date-time required
status'success' | 'failed' | 'pending' required
businessNamestring required
serviceName'freshbooks' | 'quickbooks' | 'quickbooksDesktop' | 'xero' | 'oracleNetsuite' | 'sageBusinessCloud' | 'sageIntacct' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'myob' | 'zohoBooks' | 'byod' required

Example response

{
  "pushCommunicationId": "60473b57f0cdd1683ca71f60",
  "requestedOn": "2021-03-09T08:15:22.035Z",
  "status": "pending",
  "businessName": "Railz",
  "serviceName": "quickbooks",
  "data": {
    "vendorInvoiceNumber": "254",
    "postedDate": "2021-03-29",
    "dueDate": "2021-03-29",
    "currencyRate": 1.13,
    "memo": "Example bill memo.",
    "vendorRef": "132",
    "currency": "CAD",
    "locationRef": "3",
    "subsidiaryRefs": [
      "4"
    ],
    "trackingCategoryRef": "23118",
    "lines": [
      {
        "description": "Services rendered.",
        "unitAmount": 100.5,
        "quantity": 3,
        "taxAmount": 20.5,
        "customerRef": {
          "id": "124"
        },
        "billableStatus": "notBillable",
        "accountRef": "145",
        "trackingCategoryRef": "231",
        "taxRef": "24",
        "subTotal": 301.5,
        "totalAmount": 322
      }
    ]
  }
}