RArailz
PurchaseOrder
Purchase Orders

POST /purchaseOrders

Changed on

Posts an individual purchase order for a business.

Request

  • Base URL
    https://api.railz.ai
  • Auth
    HTTP bearer

Request body

Example request

{
  "connection": {
    "businessName": "Railz",
    "serviceName": "quickbooks"
  },
  "data": {
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    },
    "postedDate": "2021-03-29",
    "dueDate": "2021-03-29",
    "deliveryDate": "2021-03-29",
    "memo": "Example memo.",
    "vendorRef": "130",
    "currency": "CAD",
    "billRef": "164",
    "expectedDeliveryDate": "2021-03-29",
    "shipToAddress": {
      "line1": "1234 Park Street",
      "line2": "Suite 1000",
      "city": "Toronto",
      "region": "ON",
      "country": "CAN",
      "postalCode": "A0B1C2"
    },
    "shipToContact": {
      "name": "John Smith",
      "email": "email@example.com",
      "phone": "800-123-4567"
    },
    "lines": [
      {
        "description": "Services rendered.",
        "accountRef": "12",
        "taxRef": "45",
        "inventoryRef": "32",
        "memo": "Example memo."
      }
    ]
  }
}

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": {
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    },
    "postedDate": "2021-03-29",
    "dueDate": "2021-03-29",
    "deliveryDate": "2021-03-29",
    "memo": "Example memo.",
    "vendorRef": "130",
    "currency": "CAD",
    "billRef": "164",
    "expectedDeliveryDate": "2021-03-29",
    "shipToAddress": {
      "line1": "1234 Park Street",
      "line2": "Suite 1000",
      "city": "Toronto",
      "region": "ON",
      "country": "CAN",
      "postalCode": "A0B1C2"
    },
    "shipToContact": {
      "name": "John Smith",
      "email": "email@example.com",
      "phone": "800-123-4567"
    },
    "lines": [
      {
        "description": "Services rendered.",
        "accountRef": "12",
        "taxRef": "45",
        "inventoryRef": "32",
        "memo": "Example memo."
      }
    ]
  }
}

Changes

  • 1383b9a47ac9Revision changes
    • info

      api tag PurchaseOrder added

  • 5cdfae3fa1faRevision changes
    • breaking

      the / request property format changed from date-time to date

    • breaking

      the / request property format changed from date-time to date

    • breaking

      the / request property format changed from date-time to date

    • breaking

      the / request property format changed from date-time to date

    • breaking

      the response's property format changed from uuid to no format for status

    • warning

      added the new byod enum value to the response property for the response status

    • warning

      added the new dynamics365Finance enum value to the response property for the response status

    • warning

      added the new dynamicsBusinessCentral enum value to the response property for the response status

    • warning

      added the new freshbooks enum value to the response property for the response status

    • warning

      added the new myob enum value to the response property for the response status

    • warning

      added the new oracleNetsuite enum value to the response property for the response status

    • warning

      added the new quickbooks enum value to the response property for the response status

    • warning

      added the new quickbooksDesktop enum value to the response property for the response status

    • warning

      added the new sageBusinessCloud enum value to the response property for the response status

    • warning

      added the new sageIntacct enum value to the response property for the response status

    • warning

      added the new wave enum value to the response property for the response status

    • warning

      added the new xero enum value to the response property for the response status

    • warning

      added the new zohoBooks enum value to the response property for the response status

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      request property /// deprecated

    • info

      the / request property format was generalized from uuid to no format

    • info

      added to the response property allOf list for the response status

    • info

      removed from the response property allOf list for the response status