Skip to main content
Skip table of contents

What API do I use to create/update tanks?

Tank API

Example 1 - with minimum properties

CODE
{
  "name": "tank 1",
  "stop": {
    "id": 1234
  },
  "xid": "17987"
}

Example 2 - with IDs and default effective dates

CODE
{
  "id": 0,
  "code": "tank 1",
  "name": "tank 1",
  "description": "description of tank",
  "isactive": true,
  "productsubtype": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "tanktype": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "tankstrapping": {
    "id": 3
  },
  "latitude": 123.12356,
  "longitude": 123.123456,
  "stop": {
    "id": 1234
  },
  "deliveryconfiguration": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "seqnum": 1,
  "dailyreset": false,
  "defaultpurchaser": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "defaulttransporeter": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "allocationdisposition": [
    {
      "value": {
        "id": 123
      }
    }
  ],
  "userfieldvalues": {
    "Division": 2964,
    "Prospect": 2962,
    "BatteryName": 294,
    "AnyPicklist": [
      {
        "value": {
          "id": 1234
        }
      }
    ],
    "AnyPicklistWithEffectiveDate": [
      {
        "value": {
          "id": 1234
        }
      }
    ]
  },
  "xid": "17987"
}

Example 3 - with names and effective values

CODE
{
  "id": 0,
  "code": "tank 1",
  "name": "tank 1",
  "description": "description of tank",
  "isactive": true,
  "productsubtype": [
    {
      "value": {
        "name": "Mix"
      },
      "effectivefrom": "2024-02-29",
      "effectiveto": "2024-03-29"
    },
    {
      "value": {
        "name": "crude Oil"
      },
      "effectivefrom": "2024-03-30",
      "effectiveto": null
    }
  ],
  "tanktype": [
    {
      "value": {
        "name": "Drip Tank"
      },
      "effectivefrom": "2024-02-29",
      "effectiveto": null
    }
  ],
  "tankstrapping": {
    "name": "Default"
  },
  "latitude": 123.12356,
  "longitude": 123.123456,
  "stop": {
    "id": 1234
  },
  "deliveryconfiguration": [
    {
      "value": {
        "name": "Test"
      }
    }
  ],
  "seqnum": 1,
  "dailyreset": false,
  "defaultpurchaser": [
    {
      "value": {
        "name": "Purchaser1"
      }
    }
  ],
  "defaulttransporeter": [
    {
      "value": {
        "name": "Purchaser2"
      }
    }
  ],
  "allocationdisposition": [
    {
      "value": {
        "name": "Sales"
      }
    }
  ],
  "userfieldvalues": {
    "Division": 2964,
    "Prospect": 2962,
    "BatteryName": 294,
    "AnyPicklist": [
      {
        "value": {
          "name": "name1"
        }
      }
    ],
    "AnyPicklistWithEffectiveDate": [
      {
        "value": {
          "name": "name1"
        },
        "effectivefrom": "2024-02-29",
        "effectiveto": null
      }
    ]
  },
  "xid": "17987"
}

Example 4 - with null values

CODE
{
  "code": null,
  "name": "Tank 1",
  "description": null,
  "isactive": true,
  "stop": {
    "id": 1234
  },
  "deliveryconfiguration": null,
  "seqnum": 1,
  "dailyreset": false,
  "defaultpurchaser": null,
  "defaulttransporeter": null,
  "allocationdisposition": null,
  "userfieldvalues": null,
  "xid": null,
  "userstring1": null,
  "userstring2": null,
  "userstring3": null,
  "userstring4": null,
  "userstring5": null,
  "userinteger1": null,
  "userinteger2": null,
  "userinteger3": null,
  "userinteger4": null,
  "userinteger5": null,
  "userdecimal1": null,
  "userdecimal2": null,
  "userdecimal3": null,
  "userdecimal4": null,
  "userdecimal5": null,
  "userdatetime1": null,
  "userdatetime2": null,
  "userdatetime3": null,
  "userdatetime4": null,
  "userdatetime5": null
}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.