Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • QueryString: Find all accounting periods matching specified string in accounting period code or name
  • AccountingPeriodIdentity: If specified, the identified accounting period will be returned . And (QueryString will be ignored).

This request also has seven flag filters that decide can further determine which accounting periods to be included, five . Five of the flags applies (indicated by asterisks below) apply to operations that are company based and they . They are

  • IncludeOpenForAdjustmentsFlag
  • IncludeOpenForApTransactionsFlag *
  • IncludeOpenForArTransactionsFlag *
  • IncludeOpenForCostFlag *
  • IncludeOpenForGlTransactionsFlag *
  • IncludeOpenForTimeFlag *
  • IncludeFullyClosedFlag

If CompanyIdentity is omitted, these five filters are ignored.  And another one IncludeFullyClosedFlag only applies to time/Cost adjustment operation which is not company based. flags marked with asterisks are ignored.

Request Format

Panel
titlePwsGetAccountingPeriodList Request
  • PwsGetAccountingPeriodList
    • serviceRequest: PwsGetAccountingPeriodListRq
      • RequestId: Int32
      • SessionTicket: String
      • AccountingPeriodIdentity: PwsAccountingPeriodRef
      • IncludeFullyClosedFlag: Boolean
      • IncludeOpenForAdjustmentsFlag: Boolean
      • IncludeOpenForApTransactionsFlag: Boolean
      • IncludeOpenForArTransactionsFlag: Boolean
      • IncludeOpenForCostFlag: Boolean
      • IncludeOpenForGlTransactionsFlag: Boolean
      • IncludeOpenForTimeFlag: Boolean
      • MaxRowsToReturn: Int32
      • QueryString: String
      • CompanyIdentity: PwsCompanyRef

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.


SessionTicket

String

Yes


Click here for more information.

ATtU220EvBSE2+GCN9U58g==

AccountingPeriodIdentity

PwsAccountingPeriodRef

No


The unique keys used to identify identity of a single accounting period to be retrieved. If this is specified, all other criteria is ignored. Click here for more information.


IncludeFullyClosedFlag

Boolean

No

false

If a CompanyIdentity is omittedset to 'true', accounting periods closed for all activity will be included in the results, provided they meet any other criteria specified. Note that is no CompanyIdentity is specified, this flag only applies to the time/cost adjustment operation. Otherwise open for adjustments flag and, if set to 'true', will cause all accounting periods that are closed for all operations for the specified company are included in the response. The operations include time entry, cost entry, time/cost adjustment, GL transactions, AP transactions and AR transactionsnot open for adjustments to be included in the response.

false

IncludeOpenForAdjustmentsFlag

Boolean

No

false

If set to 'true', the accounting period periods that is are open time/cost adjustment is adjustments are included in the response. This filter is not company based.

false

IncludeOpenForApTransactionsFlag

Boolean

No

false

If a CompanyIdentity is omitted, this flag is ignored. Otherwise if set to 'true', accounting periods that are open for AP transactions is are included in the response.

false

IncludeOpenForArTransactionsFlag

Boolean

No

false

If a CompanyIdentity is omitted, this flag is ignored. Otherwise if set to 'true', accounting periods that are open for AR transactions is are included in the response.

false

IncludeOpenForCostFlag

Boolean

No

false

If a CompanyIdentity is omitted, this flag is ignored. Otherwise if set to 'true', accounting periods that are open for cost entry is are included in the response.

false

IncludeOpenForGlTransactionsFlag

Boolean

No

false

If a CompanyIdentity is omitted, this flag is ignored. Otherwise if set to 'true', accounting periods that are open for GL transactions is are included in the response.

false

IncludeOpenForTimeFlag

Boolean

No

false

If a CompanyIdentity is omitted, this flag is ignored. Otherwise if set to 'true', accounting periods that are open for time entry is are included in the response.

false

MaxRowsToReturn

Int32

No


The maximum number of accounting periods to be retrieved. This flag is disregarded if an accounting period is specified in AccountingPeriodIdentity.

5

QueryString

String

No


A search string to narrow down the results. An accounting period will be included in the results if the search string matches the accounting period's code or name. This value is disregarded if an accounting period is specified in AccountingPeriodIdentity.

Rev

CompanyIdentity

PwsCompanyRef

No


The identity of a company for determining whether the company whose accounting periods are being retrieved. Click here for more informationaccounting period is open for time, cost, AP transactions, AR transactions and/or GL transactions for filtering purposes.


Usage Example(s)

Code Block
languagexml
titleExample 01 - Accounting period is not specified
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsGetAccountingPeriodList>
         <pws:serviceRequest>
            <req:SessionTicket>ATtU220EvBSE2+GCN9U58g==</req:SessionTicket>
            <req:IncludeOpenForAdjustmentsFlag>false</req:IncludeOpenForAdjustmentsFlag>
            <req:IncludeOpenForApTransactionsFlag>true</req:IncludeOpenForApTransactionsFlag>
            <req:IncludeOpenForArTransactionsFlag>false</req:IncludeOpenForArTransactionsFlag>
            <req:IncludeOpenForCostFlag>true</req:IncludeOpenForCostFlag>
            <req:IncludeOpenForGlTransactionsFlag>true</req:IncludeOpenForGlTransactionsFlag>
            <req:IncludeOpenForTimeFlag>true</req:IncludeOpenForTimeFlag>
            <req:MaxRowsToReturn>5</req:MaxRowsToReturn>
            <req:CompanyIdentity>
               <com:CompanyName>Revolutionary Solutions Corporation CA</com:CompanyName>
            </req:CompanyIdentity>
         </pws:serviceRequest>
      </pws:PwsGetAccountingPeriodList>
   </soapenv:Body>
</soapenv:Envelope>

...