Before setting up and testing a bunker transaction integration other integrations need to be in place.
When a bunker transaction is posted in Dataloy VMS, the document status is set to Ready-for-Posting. Set up a scheduled task and use the request under Data Transaction to extract bunker transactions that are ready for posting. When a bunker transaction is transferred to accounting, update the status to Posted.
Test data for bunker transactions can be generated in Booking and Operations > Bunkers-FO tab > Bunker Transactions.
To get bunker transactions that are ready for posting in the following subscription can be created:
Alternatively a scheduled job can be setup to use the following request:
Get bunker transactions that are ready for posting to accounting
Post Transaction
When an invoice is successfully transferred to the accounting system, the document status has to be updated to Posted in Dataloy VMS. This is done in a PUT request:
Update status to posted for a specific invoice
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(EQ)ACC
{
"eventType":"U",
"user": the user code to be used in the subscription,
"objectType":"Document",
"expression": "dlpObject.getInvoicingStatus() != null && dlpObject.getInvoicingStatus().getStatusTypeCode().equals(\"RFP\") && (dlpObject.getDocumentType().getDocumentType().equals(\"ACC\"))",
"url":"your webhook url"
}PUT /Document/{key}
{
"invoicingStatus": "POS"
}