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
The resources available in this module.
BatchListApi
Reuse or return a new System Batch for Workbench Import or list of all Workbench batchesProvides API access to the Export Control(#/Batch/BatchList.aspx) Web Workbench screen.
/api/BatchDetailApi
Method
/api/BatchListApi | |||||
---|---|---|---|---|---|
Method | Description | Performed As | Request Query | Request Body | Response |
GET | Reuse or returns a new Retrieve (and create, if necessary) the default System Batch for Workbench Import. Requires: BatchType, LocationCode, FinCoCode, YearNo and PeriodNothe specified Type, Date, Location, and Financial Company. | Logged in User | -- | ||
POSTReturn | all Workbench batchesRetrieve a filtered list of Batches. |
BatchDetailApi
Return or create batch Web Workbench screen.
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 | ||||
POST | GET | Get Batch with JobTransactions for a BatchID | - | Create a new batch or update existing batch with batch transactions.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). |
Parameters
Parameter
⬆️ Back to top
BatchKey
Property | Type | Description |
---|
BatchNo |
batchType
String
Integer | The unique number of the |
Batch. |
BatchType |
docDate
date-time
Batch date?
query
locationCode
String
Location comes from the FinCo
query
finCoCode
String
Code of the finance company of the batch.
query
batchGroup
String
Batch group.
query
GridResult_BatchBatchLine
Field
Type
Description
Total
Integer
Total number of batches
Page
Integer
Number of screen page or current page?
Records
Integer
Total of record?
Rows
Array
Array [BatchBatchLine]
Form
Object
Widgets
BatchBatchFields
Field
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
HiddenBatchNotes
String
BatchStatus
Status of the batch
BatchTotal
ReversingJournal
Button
AttachmentsDialog
Import
Button
ImportAdjustment
PayrollPeriod
Currency
The currency
FcConversionRate
Foreign currency conversation rate.
UseForeignCurrency
Boolean
Does the batch use foreign currency?
BatchBatchKey
Field
Type
Description
BatchNo
Integer
Batch number/code
BatchType
String
Batch type.
FinCoCode
String
Number code of the finance company
Exported
Boolean
Is the batch exported?
InterCoStatus
String
HasExportErrored
Boolean
The exporting error.
BatchBatchLine
Field
Type
Description
Type
String
BatchNo
Integer
Code/number of the batch
Date
String
Year
String
Period
Integer
The financial period
YearPeriodIndex
Integer
CreatedDate
String
Date created.
CreatedById
Integer
ID of person who created the batch.
CreatedByName
String
Name of person who created the batch.
FinancialCompany
String
Financial company.
Location
String
Location.
Reference
String
Reference text
Notes
String
Batch note
Reversal
Integer
Closed
Boolean
Status of the batch.
ReversingJournal
Boolean
ClosedById
Integer
Code of person who closed the batch.
NotForExport
Boolean
Value of Not For Export flag.
Exported
Boolean
Exported status.
ExportedById
Integer
ID of person exported the batch.
ExportDate
String
Exported date.
ClosedDate
String
Closed date.
ExportStatus
String
Export status.
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
JobTransactionApiModel
Field
Type
Description
Key
Fields
Rows
ValidationErrors
Array [MvcValidationError]
Parameters
Parameter
Data Type
Description
Parameter Type
batchNo
Integer
Number of the batch
batchType
String
Batch type.
JobTransactionsJobTransactionKey
Field
Type
Description
BatchNo
Integer
Number of the batch.
BatchType
String
Batch type.
JobTransactionsJobTransactionDetailKey
Field
Type
Description
JobTranId
Integer
PersonId
Integer
JobCode
String
Job code.
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 Centre.
WorkCentreCodeValue
String
Code of Work Centre.
ItemId
Integer
StockLocationCodeValue
String
Stock location code.
CostRateValue
Number
Cost rate.
BatchType
String
Batch type
OrderDerivedLine
Boolean
DocketDerivedLine
Boolean
StockDerivedLine
Boolean
Type
String = ['InwardsGoodsEntry', 'InwardsGoodsEdit', 'Issue', 'Return', 'Transfer', 'Requisition']
PurchaseOrderLineIdValue
Integer
LogHeaderId
Integer
KeyName
String
CompanyId
Integer
GSTTypeCodeValue
String
JobTransactionsJobTransactionLine
Field
Type
Description
TranDate
String
LogHeaderID
Integer
FcCost
Number
Foreign currency code
FcRetail
Number
PurchaseOrderLineId
Integer
StockLocationInactive
Boolean
Unit
String
EnteredByID
Integer
ID of person who entered data.
SourceID
Integer
FCGST
Number
JobCodeValue
Job code.
LogHeader
ActivityCodeValue
Activity code.
WorkCentreCodeValue
Work Centre code.
QuantityValue
Quantity
FcCostValue
CostValue
GSTTypeValue
GST type.
GSTTypeCodeValue
GSTRateValue
GST rate
GSTValue
GST value
NetValueValue
Net value
ReferenceValue
FcRetailValue
RetailValue
LineDescriptionValue
Description of line
DetailsValue
Details
FromPONumberValue
PurchaseOrderLineIdValue
StockLocationCodeValue
StockItemCodeValue
TotalLineCostValue
CostRateValue
UnitValue
FCGSTValue
Delete
Serials
SerialRows
Array [TabletSerialLine]
Status
String
ReadonlyFlag
Integer
ReadonlyMessage
String
OriginalKey
CurrentKey
Key
Index
Integer
MvcValidationError
Field
Type
Description
TranDate
String
LogHeaderID
Integer
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 |
---|---|---|
Key | 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 | 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 | 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 | 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 | The status of the Batch (Created, In Progress, Error, Successful). |
ExportStatusValue | The status of the Batch (Created, In Progress, Error, Successful). | |
InterCoStatus | String | 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 | The unique ID of the Job Transaction. |
PersonId | Integer | The ID of the User. |
FinCoCode | String | The 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 | The Work Centre Code on the Job Transaction. |
ItemId | Integer | The ID of the Item on the Job Transaction. |
StockLocationCodeValue | String | The Reference on the Job Transaction. |
Type | String | The Job Transaction Type ('Issue' or 'Return'). |
GSTTypeCodeValue | String | The GST Type Code on the Job Transaction. |
⬆️ Back to top
JobTransactionLine
Field | Type | Description |
---|---|---|
Key | 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 | ||||
---|---|---|---|---|
|