GetNextGlTransaction
- Thomas Sherman (Deactivated)
- Bettina Borces
Get the next pending GL transaction. If there are no pending transactions, then the GlTransactionNumber in the response will be -1.
After getting the transaction, it will be marked as Transmitted in Projector. You should then use UpdateGeneralLedgerTransactionStatus to mark it Confirmed or Failed. This step is very important as it lets your accounting users know whether further action to correct this batch is needed. If a batch is missing from your accounting system, it is a problem!
Rate Limiting
In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior.
Request
The service request contains:
GetNextGlTransactionRequest | ||||
|---|---|---|---|---|
Name | Data Type | Required? | Default Value | Discussion |
CompanyNumber | string(20) | no | If not supplied then matches all companies. | |
MaxPeriodCode | string(20) | no | If not supplied then matches all periods. | |
ForceTransDateWithinPeriodFlag | boolean | no | false | If true then alter transaction dates when needed to fall within the accounting period. |
Response
The following data is returned:
GetNextGlTransactionResponse | |||
|---|---|---|---|
Name | Data Type | Version | Discussion |
GlTransactionNumber | int | If -1 then there is no pending transaction to return. | |
TransactionDate | date | ||
AccountingPeriodCode | string(20) | ||
CompanyNumber | string(20) | ||
CurrencyCode | string(4) | ||
Notes | string | 4.3.2 | Transaction notes |
GlTransactionLines | array of GlTransactionLine | see below |
For each GL transaction, one or more GlTransactionLine is returned (one per GL account affected by the transaction).
GlTransactionLine | ||
|---|---|---|
Name | Data Type | Discussion |
GlCostCenterNumber | string(159) | |
GlAccountNumber | string(20) | |
DebitAmount | money | Debit is positive. Credit is negative. |
Changelog
History of changes to this web service
4.3.2 | |
|---|---|
Parameter | Notes |
Notes | Added as GetNextGlTransactionResponse parameter |