Business account effective date

Learn about specifying the EffectiveDate for a business account in your integration.

Element type: Suggested for Core

Endpoints/models used: BusinessAccount

Your integration should provide a method for specifying a business account's effective date. This is the date when a business account becomes (or became) valid for use. This is done using the EffectiveDate field in the BusinessAccount model. Accepted date formats include:


Date format	Sample
yyyymmdd	20240901
mm/dd/yyyy	09/01/2024
m/d/yyyy	9/1/2024
mm-dd-yyyy	09-01-2024
m-d-yyyy	9-1-2024
yyyy-mm-dd	2024-09-01
yyyy-m-d	2024-9-1
yyyy-mm-ddThh:MM:ss	2024-09-01T13:45:30
yyyy-m-dThh:MM:ss	2024-9-1T13:45:30

Example

{
  "ImportName": "BE_API_TEST",  //--Required
  "UpdateMatchesMode": "INSERT",  //--Required
  "TerminateNewRecords": false,  //--Required
  "CreateAllAccountTypes": true,  //--Required
  "LoadId": "LOAD_GUID_HERE",  //--Required
  "BusinessEntities": [
    {
      "LegalName": "TEST_BE",  //--Required
      "LegalNamePriority": 0,  //--Required
      "TradeName": "TEST_BE",
      "NameControl": "TES",
      "EffectiveDate": "2024-09-01T14:55:52.950Z",  //--Required
      "ObsoleteDate": "2024-09-01T14:55:52.950Z",
      "Address1": "110 Main Street",
      "Address2": "Suite 100",
      "City": "Houston",
      "Jurisdiction": "TX",
      "PostalCode": "77002",
      "CountryCode": "USA",
      "County": "HARRIS",
      "CustomId": "TEST_BE",  //--Required
      "CustomIdPriority": 0,  //--Required
      "IdCodeAndIdTypePriority": 0,  //--Required
      "BusinessEntityMappingId": "BE_GUID_HERE", //--Required
      "BusinessEntityIdCodes": [  //--Required
        {
          "CountryCode": "USA",  //--Required
          "IdType": "FEIN",  //--Required
          "IdCode": "999999999"  //--Required
        }
      ],
      "BusinessAccounts": [
        {
          "CountryCode": "USA",
          "Jurisdiction": "CA",
          "BusinessType": "BUY",
          "BusinessSubType": "TOBMANUF",
          "CustomId": null,
          "EffectiveDate": "2020-01-01T00:00:00",
          "ObsoleteDate": null,
          "LicenseNumber": "123456789",
          "LicensePercentage": null,
          "BusinessAccountMappingId": null
        }
      ]
    }
  ]
}