Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Provides access to Batch related data. In Workbench, documents are stored in batches before they can be exported to the financial software. These APIs are about these batches.
Endpoints
BatchDetailApi
Return or create batchThe resources available in this module.
BatchListApi
Provides API access to the Export Control(#/Batch/BatchList.aspx) Web Workbench screen.
/api/ |
---|
BatchListApi | |||||
---|---|---|---|---|---|
Method | Description | Performed As | Request Query | Request Body | Response |
GET |
Retrieve (and create, if necessary) the default System Batch for the specified Type, Date, Location, and Financial Company. | Logged in User | - | ||
POST |
Create a new batch or update existing batch with batch transactions.
BatchListApi
Reuse or return a new System Batch for Workbench Import or list of all Workbench batches.
/api/BatchListApi | ||||||
---|---|---|---|---|---|---|
Method | Description | Performed AsRetrieve a filtered list of Batches. | Logged in User | - |
BatchDetailApi
Provides API access to the Job Transaction Batch Entry (#/Batch/BatchEntryList.aspx) detail Web Workbench screens ('Job Adjustment Batch Entry', ‘Disbursement Batch Entry', ‘Stock Issue Batch Entry’, 'Stock Return Batch Entry’).
/api/BatchDetailApi | ||||
---|---|---|---|---|
Method | Performed As | Request Query | Request Body | Response |
GET |
Reuse or returns a new System Batch for Workbench Import. Requires: BatchType, LocationCode, FinCoCode, YearNo and PeriodNo
-
-
POST
Retrieve a specific Batch (including its Job Transactions). | Admin User | - | ||
POST Update an existing Batch and its Job Transactions. | Admin User | - |
Models
The definitions of models specific to endpoints in this module.
SystemBatchApiModelSystemBatchKey
Property | Type | Description |
---|
BatchType |
String | The Batch |
Type. (required) |
DocDate |
string
Type of the batch.
BatchDate
String
To determines what period the batch is created.
PeriodNo
Integer
The period of the batch.
YearNo
Integer
The year of the batch
CreatedById
Integer
[ID of user or account?]
CreatedDateTime
String
DateTime | The Date. (required) | |
LocationCode | String | The Code of the Location. (required) |
FinCoCode | String | The Code of the Financial Company. (required) |
BatchGroup | String | The Batch Group. |
SystemBatchModel
Property | Type | Description | |
---|---|---|---|
BatchNo | Integer | The Batch number. | |
BatchType | String | Type of the Batch. | |
BatchDate | String | The end date of the Period of the Batch.. | |
PeriodNo | Integer | The period of the Batch. | |
YearNo | Integer | The year of the Batch | |
CreatedById | Integer | The ID of the user who created the Batch. | |
CreatedDateTime | String | The date and time when the Batch was created. | |
LocationCode | String | The location Location Code from the financial companyFinancial Company. | |
CompanyCode | String | The Financial Company Code of the company for the batchBatch. | |
BatchReference | String | Reference textThe Batch reference. | |
BatchNotes | String | The Batch comment. | |
ClosedFlagReversingJournal | IntegerReversingJournal | The Reversing Journal flag on the Batch. | |
ClosedFlag | Integer | ReversingJournal | IntegerThe Closed flag on the Batch. |
ClosedDate | String | Date the batch is The date the Batch was closed. | |
ClosedById | Integer | Code The ID of person the user who close closed the batchBatch. | |
NotForExportFlag | IntegerFlag | to mark the batch is for exporting or notThe Not For Export flag on the Batch. | |
NotForExportDate | String | Date the batch is The date the Batch was marked as Not for For Export. | |
NotForExportId | Integer | Code The ID of person the user who marked batch the Batch as Not for For Export. | |
ExportDate | StringDate | of the exportThe date the Batch was exported. | |
ExportedById | String | Code The ID of person the user who made exported the exportBatch. | |
ExportStatus | String | Includes: The status of the Batch (Created, In progressProgress, Error, Successful). |
⬆️ Back to top
GridResult_BatchBatchLine
FieldBatchKey
Property | Type | Description |
---|
BatchNo | Integer |
The unique number of |
the Batch. |
BatchType |
Integer
Page
Records
Integer
Records
Rows
Array
Array [BatchBatchLine]
Form
Object
Widgets
⬆️ Back to top
BatchBatchFields
String | The Batch Type. | |
FinCoCode | String | The Financial Company Code. |
InterCoStatus | String | The Inter-Company status of the Batch. |
Exported | Boolean | A flag indicating if the Batch has been exported. |
HasExportErrored | Boolean | A flag indicating if the Batch has a status of ‘Error’. |
BatchLine
Property | Type | Description |
---|
⬆️ Back to top
BatchBatchLine
Field
Type
Description
Type
String
Line type
BatchNo
Integer
Batch number
Date
String
Date
Year
String
Year
Period
Integer
The financial period
YearPeriodIndex
Integer
CreatedDate
String
Key |
Number of the batch
BatchType
Batch type.
BatchDate
Batch date.
Period
The financial period of the batch
CreatedBy
Person who created the batch
CreatedDate
Created date..
Location
Location in the batch
FinancialCompany
Financial company for the batch
Closed
Status of the batch
ClosedDate
Date the batch has been closed.
ClosedBy
Who closed the batch.
Exported
Export status of the batch.
ExportedDate
Export date.
ExportedBy
Who exported the batch.
NotForExport
The batch is not for exporting.
NotForExportDate
Date marked as Not for Export
NotForExportBy
Who marked Not for Export.
Reference
Reference text.
BatchNotes
Notes/comments
ReversalOfBatch
HiddenBatchNotes
String
BatchStatus
Status of the batch
BatchTotal
ReversingJournal
AttachmentsDialog
Import
ImportAdjustment
PayrollPeriod
Currency
The currency
FcConversionRate
Foreign currency conversation rate.
UseForeignCurrency
Boolean
Foreign currency status.
⬆️ Back to top
BatchBatchKey
Field
Type
Description
BatchNo
Integer
Batch number/code
BatchType
String
Batch type.
FinCoCode
String
Code of the finance company
Exported
Boolean
Exported status.
InterCoStatus
String
HasExportErrored
Boolean
The exporting error status.
The unique key for the line. | ||
Type | String | The Type of the Batch. |
TypeValue | The Type of the Batch. | |
BatchNo | Integer | The unique number of the Batch. |
BatchNoValue | The unique number of the Batch. | |
Date | String | The date of the Batch. |
DateValue | The date of the Batch. | |
Year | String | The year of the Year/Period of the Batch. |
Period | Integer | The period of the Year/Period of the Batch. |
YearPeriodIndex | Integer | The unique index of the Year/Period of the Batch. |
YearPeriodValue | The formatted Year/Period of the Batch. | |
CreatedDate | String | The date the Batch was created. |
CreatedById | Integer | The ID of |
the user who created the |
Batch. |
CreatedByName | String |
Location
String
The name of the user who created the Batch. | ||
CreatedByValue | The name of the user who created the Batch. | |
Location | String | The Location Code of the Batch. |
FinancialCompany | String |
Financial company.
The Financial Company Code of the Batch. | ||
FinancialCompanyValue | The Financial Company Code of the Batch. | |
Reference | String |
The Batch reference. | ||
ReferenceValue | The Batch reference. | |
Notes | String |
The Batch comment. | ||
NotesValue | The Batch comment. | |
Reversal | Integer |
The Batch No of the Batch this Batch reverses. | ||
ReversalValue | The Batch No of the Batch this Batch reverses. | |
Closed | Boolean |
The Closed flag on the Batch. |
ClosedValue |
Boolean
The Closed flag on the Batch. | |
ClosedById | Integer |
The ID of |
the user who closed the |
Batch. | |
NotForExport | Boolean |
The Not For Export flag on the Batch. | ||
NotForExportValue | The Not For Export flag on the Batch. | |
Exported | Boolean |
A flag indicating if the Batch has been exported. | ||
ExportedById | Integer | The ID of |
the user who exported the |
Batch. | |
ExportDate | String |
The date the Batch was exported. |
ExportDateValue |
The date the Batch was exported. | |
ExportStatus | String |
Export status.
The status of the Batch (Created, In Progress, Error, Successful). | ||
ExportStatusValue | The status of the Batch (Created, In Progress, Error, Successful). | |
InterCoStatus | String |
Status of inter-company.
Select
Export
TypeValue
Batch type.
BatchNoValue
Batch number.
DateValue
Batch date.
YearPeriodValue
Financial year period of the batch.
CreatedByValue
Person who created the batch.
FinancialCompanyValue
Financial company.
ReferenceValue
Reference text
NotesValue
Batch note.
ReversalValue
ClosedValue
Closed status.
NotForExportValue
Value of Not for Export flag.
ClosedDateValue
Closed date.
ExportDateValue
Exported date.
ExportStatusValue
Export status.
InterCo
Internal company.
InterCoStatusValue
Internal company.
BatchStatus
String
Batch status.
Status
String
Batch status.
ReadonlyFlag
Integer
Value of Read-Only property.
ReadonlyMessage
String
OriginalKey
CurrentKey
Key
Index
Integer
⬆️ Back to top
JobTransactionApiModel
Field
Type
Description
Key
Fields
Rows
ValidationErrors
Array [MvcValidationError]
⬆️ Back to top
JobTransactionsJobTransactionKey
Field
Type
Description
BatchNo
Integer
Number of the batch.
BatchType
String
Batch type.
⬆️ Back to top
JobTransactionsJobTransactionDetailKey
The Inter-Company status of the Batch. | ||
InterCoStatusValue | The Inter-Company status of the Batch. |
⬆️ Back to top
JobTransactionKey
Property | Type | Description |
---|---|---|
BatchNo | Integer | The unique number of the Batch. |
BatchType | String | The Batch Type. |
⬆️ Back to top
JobTransactionApiModel
Property | Type | Description |
---|---|---|
Key | The unique key of the Batch. | |
Fields | General data associated with the Batch. | |
Rows | Array<JobTransactionLine> | Job Transactions associated with the Batch. |
ValidationErrors | Array<MvcValidationError> | A list of specific validation errors if the save was unsuccessful. |
⬆️ Back to top
BatchFields
Property | Type | Description |
---|---|---|
BatchNo | Number of the batch | |
BatchType | Batch type. | |
BatchDate | Batch date. | |
Period | The financial period of the batch | |
CreatedBy | Person who created the batch | |
CreatedDate | Created date.. | |
Location | Location in the batch | |
FinancialCompany | Financial company for the batch | |
Closed | Status of the batch | |
ClosedDate | Date the batch has been closed. | |
ClosedBy | Who closed the batch. | |
Exported | Export status of the batch. | |
ExportedDate | Export date. | |
ExportedBy | Who exported the batch. | |
NotForExport | The batch is not for exporting. | |
NotForExportDate | Date marked as Not for Export | |
NotForExportBy | Who marked Not for Export. | |
Reference | Reference text. | |
BatchNotes | Notes/comments | |
ReversalOfBatch | The Batch this Batch is a reversal of. | |
BatchStatus | Status of the batch | |
ReversingJournal | The Reversing Journal flag on the Batch. | |
AttachmentsDialog | The file attachments information for the Batch. | |
Currency | The currency | |
FcConversionRate | Foreign currency conversation rate. | |
UseForeignCurrency | Boolean | Foreign currency status. |
⬆️ Back to top
JobTransactionDetailKey
Property | Type | Description |
---|---|---|
JobTranId | Integer |
|
PersonId | Integer | Person id. |
JobCode | String | Job code The unique ID of the Job Transaction. |
PersonId | Integer | The ID of the User. |
FinCoCode | String | Code of financial company. |
ActivityCode | String | Activity code. |
ActivityCodeValue | String | Activity code. |
ActivityType | String | Activity type. |
ActivitySubType | String | Activity sub type |
WorkCentreCode | String | Code of Work CentreThe Financial Company Code on the Batch. |
BatchType | String | The Batch Type of the Batch. |
JobCode | String | The Job Code on the Job Transaction. |
ActivityCodeValue | String | The Activity Code on the Job Transaction. |
WorkCentreCodeValue | String | Code of The Work Centre Code on the Job Transaction. |
ItemId | Integer Item | id The ID of the Item on the Job Transaction. |
StockLocationCodeValue | String | Stock location code. |
CostRateValue | Number | Cost rate. |
BatchType | String | Batch type | OrderDerivedLine | Boolean |
DocketDerivedLine | Boolean |
|
StockDerivedLine | Boolean | The Reference on the Job Transaction. |
Type | String | = ['InwardsGoodsEntry', 'InwardsGoodsEdit', 'Issue', 'Return', 'Transfer', 'Requisition'] |
PurchaseOrderLineIdValue | Integer | Purchase Order line id. |
LogHeaderId | Integer | Log header id. |
KeyName | String |
|
CompanyId | Integer | company id. |
GSTTypeCodeValue | String | The Job Transaction Type ('Issue' or 'Return'). |
GSTTypeCodeValue | String | The GST Type Code on the Job Transaction. |
⬆️ Back to top
JobTransactionsJobTransactionLineJobTransactionLine
Field | Type | Description |
---|---|---|
TranDateKey | String |
|
LogHeaderID | Integer | Log header id. |
lFcCost | Number | Foreign currency code |
FcRetail | Number | Foreign currency retail. |
PurchaseOrderLineId | Integer | Purchase Order line id. |
StockLocationInactive | Boolean |
|
Unit | String | Unit |
EnteredByID | Integer | ID of person who entered data. |
SourceID | Integer |
|
FCGST | Number | Foreign currency tax. |
JobCodeValue | Job code. | |
LogHeader | Job code. | |
ActivityCodeValue | Activity code. | |
WorkCentreCodeValue | Work Centre code. | |
QuantityValue | Quantity | |
FcCostValue | Foreign currency cost. | |
CostValue | Cost. | |
GSTTypeValue | Tax type. | |
GSTTypeCodeValue | Code of tax type. | |
GSTRateValue | Tax rate | |
GSTValue | Tax value | |
NetValueValue | Net value | |
ReferenceValue | Reference. | |
FcRetailValue | Foreign currency retail | |
RetailValue | Retail. | |
LineDescriptionValue | Description of line | |
DetailsValue | Details | |
FromPONumberValue | From Purchase Order number | |
PurchaseOrderLineIdValue | Purchase Order line id. | |
StockLocationCodeValue |
| |
StockItemCodeValue | Stock item code. | |
TotalLineCostValue | Total line cost. | |
CostRateValue | Cost rate. | |
UnitValue | Unit. | |
FCGSTValue | Foreign currency tax. | |
Delete |
| |
Serials |
| |
SerialRows | Array [TabletSerialLine] |
|
Status | String | Status. |
ReadonlyFlag | Integer |
|
ReadonlyMessage | String |
|
OriginalKey |
| |
CurrentKey |
| |
Key |
| |
Index | Integer |
|
⬆️ Back to top
The unique key for the line. | ||
EnteredByID | Integer | The ID of the Person who created the Job Transaction. |
JobCode | String | The Job Code on the Job Transaction. |
JobCodeValue | The Job Code on the Job Transaction. | |
LogHeaderID | Integer | The Log Header on the Job Transaction. |
LogHeader | The Log Header on the Job Transaction. | |
StockItemCode | String | The Stock Item on the Job Transaction |
StockItemCodeValue | The Stock Item on the Job Transaction | |
StockLocationCode | String | The Stock Location on the Job Transaction |
StockLocationCodeValue | The Stock Location on the Job Transaction | |
StockLocationInactive | Boolean | A flag to indicate if the Stock Location is closed and finalised. |
ActivityCode | String | The Activity Code on the Job Transaction. |
ActivityCodeValue | The Activity Code on the Job Transaction. | |
WorkCentreCode | String | The Work Centre Code on the Job Transaction. |
WorkCentreCodeValue | The Work Centre Code on the Job Transaction. | |
Unit | String | The Unit of the Stock Item on the Job Transaction. |
UnitValue | The Unit of the Stock Item on the Job Transaction. | |
CostRate | Decimal | The Cost Rate. |
CostRateValue | The Cost Rate. | |
Quantity | Decimal | The Quantity. |
QuantityValue | The Quantity. | |
FcCost | Decimal | The Foreign Currency Cost. |
FcCostValue | The Foreign Currency Cost. | |
Cost | Decimal | The Cost. |
CostValue | The Cost. | |
FcRetail | Decimal | The Foreign Currency Retail Value. |
FcRetailValue | The Foreign Currency Retail Value. | |
Retail | Decimal | The Retail Value. |
RetailValue | The Retail Value. | |
FCGST | Decimal | The Foreign Currency Tax. |
FCGSTValue | The Foreign Currency Tax. | |
LineDescription | String | The Description on the Job Transaction. |
LineDescriptionValue | The Description on the Job Transaction. | |
Details | String | The Details on the Job Transaction. |
DetailsValue | The Details on the Job Transaction. | |
GSTType | String | The GST Type Code on the Job Transaction. |
GSTTypeDescription | String | The Description of the GST Type on the Job Transaction. |
GSTTypeCodeValue | The GST Type on the Job Transaction. | |
GSTRate | Decimal | The Tax Rate of the GST Type on the Job Transaction. |
GSTRateValue | The Tax Rate of the GST Type on the Job Transaction. | |
TotalLineCost | Decimal | The Cost Rate multiplied by the Quantity. |
TotalLineCostValue | The Cost Rate multiplied by the Quantity. |
⬆️ Back to top
Sample
Returns a new Batch for Workbench Import.
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response Sample
|
Get the list of Workbench batches
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response Sample
|
Get Batch with JobTransactions for a BatchID
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response Sample
|
title | Click to view |
---|
Request
language | json |
---|
Response
language | json |
---|
Response Sample
⬆️ Back to top
On this page
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|