RArailz
InventoryControllerV2
Inventory

Create an Inventory Item

Changed on

Supported for:

freshbooks quickbooks xero oracleNetsuite sageIntacct dynamicsBusinessCentral wave myob zohoBooks

post/v2/accounting/inventory

Request

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

Request body

connectionUuidstring required

Unique connection identifier.

Example request

{
  "connectionUuid": "CON-396d5daa-26b2-4979-89b6-cafb2c298155",
  "data": {
    "code": "GOL-W",
    "type": "inventory",
    "name": "White golf balls.",
    "quantityOnHand": [
      {
        "quantity": 2.5,
        "locationRef": {
          "id": "32"
        },
        "accountRef": {
          "id": "200"
        }
      }
    ],
    "billItem": {
      "description": "Item description.",
      "unitPrice": 2.5,
      "accountRef": {
        "id": "200"
      },
      "taxRateRef": {
        "id": "12"
      }
    },
    "invoiceItem": {
      "description": "Item description.",
      "unitPrice": 2.5,
      "accountRef": {
        "id": "200"
      },
      "taxRateRef": {
        "id": "12"
      }
    },
    "isBillItem": true,
    "isInvoiceItem": true,
    "subsidiaryRefs": [
      {
        "id": "4"
      }
    ],
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    }
  }
}

Response

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

Example response

{
  "connectionUuid": "CON-396d5daa-26b2-4979-89b6-cafb2c298155",
  "businessName": "Railz",
  "serviceName": "xero",
  "pushCommunicationId": "60473b57f0cdd1683ca71f60",
  "requestedOn": "2021-03-09T08:15:22.035Z",
  "status": "pending",
  "data": {
    "code": "GOL-W",
    "type": "inventory",
    "name": "White golf balls.",
    "quantityOnHand": [
      {
        "quantity": 2.5,
        "locationRef": {
          "id": "32"
        },
        "accountRef": {
          "id": "200"
        }
      }
    ],
    "billItem": {
      "description": "Item description.",
      "unitPrice": 2.5,
      "accountRef": {
        "id": "200"
      },
      "taxRateRef": {
        "id": "12"
      }
    },
    "invoiceItem": {
      "description": "Item description.",
      "unitPrice": 2.5,
      "accountRef": {
        "id": "200"
      },
      "taxRateRef": {
        "id": "12"
      }
    },
    "isBillItem": true,
    "isInvoiceItem": true,
    "subsidiaryRefs": [
      {
        "id": "4"
      }
    ],
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    }
  }
}

Changes