Versions Compared

Key

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

Short Description

...

Certain integrations need to be in place before the set-up and testing of an invoice integration:

...

Anchor
AccIntAPI1
AccIntAPI1
Data Transaction

To extract all invoices in Dataloy VMS that get invoices that are ready for posting use the requests below in conjunction with the base URLposting in Webhooks the following subscription can be created:

Code Block
titleGet invoices that are ready for posting to accounting
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(IN)(INI,INO,CRI,CRO)

More information: /DocumentType/Document.

Payment Terms

There will be only one Document object in the API despite two payment terms for an invoice (for example 95/5 percent). However, the Document will have two documentPaymentTerms objects in the Document.documentPaymentTerms list.

To create two documents when integrating:

  1. Loop on paymentTerms and create one document for each payment term.

  2. Calculate the following values:

    • dueDate: document.documentPaymentTerms.dueDate

    • documentAmount: document.documentAmount * document.documentPaymentTerms.percentage / 100

    • companyCurrencyAmount: document.companyCurrencyAmount * document.documentPaymentTerms.percentage / 100

    • sourceCurrencyAmount: document.sourceCurrencyAmount * document.documentPaymentTerms.percentage / 100
Test Data

Test data for invoicing integration can be generated in the Dataloy VMS post fixture modules (Accounts Receivable, Accounts Payable and Hire Payable).

Post Transaction 

When an invoice is successfully transferred to an accounting system, the document status must be updated to Posted in Dataloy VMS. This is done in a PUT request:

Code Block
titleUpdate status to posted for a specific invoice
PUT request on /Document/{key}
 
{
    "invoicingStatus": "POS"
}

...

Prerequisites

No prerequisites.

Integration Set-Up

Accounting systems often require voyage related data before transferring accounting related transactions. Set up a scheduled task and use the request under Data Transaction to gather all voyages that has been modified since the last time a scheduled task was run.

Test Data

Modify some existing voyages in the Booking and Operations module for testing, for example, changing a date in the schedule (note: changing dates will also affect the schedule for other voyages).

Data Transaction

To extract all fixed voyages from Dataloy VMS that has been modified since a given date, use request below in conjunction with the base URL:

Code Block
titleGet all fixed voyages modified since given date
GET /VoyageHeader?filter=modifiedDate(GTE)2014-01-01T12:30:00

Post Transaction 

No post transaction is required.

...

Prerequisites

Synchronization of business partners between Dataloy VMS and the applicable accounting system is required before transferring accounting related transactions. To synchronize business partner updates between systems, decide which system is to be the Master System (where the business partners will be updated). The Master System will then send updated business partner data to the other system.

Integration Set-Up

...

{
    "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(\"INO\") || dlpObject.getDocumentType().getDocumentType().equals(\"INI\") || dlpObject.getDocumentType().getDocumentType().equals(\"CRI\") || dlpObject.getDocumentType().getDocumentType().equals(\"CRO\"))",
    "url": "your webhook url"
}


Alternatively a scheduled job can be setup to use the following request:

Code Block
titleGet invoices that are ready for posting to accounting
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(IN)(INI,INO,CRI,CRO)

More information: /DocumentType/Document.

Payment Terms

There will be only one Document object in the API despite two payment terms for an invoice (for example 95/5 percent). However, the Document will have two documentPaymentTerms objects in the Document.documentPaymentTerms list.

To create two documents when integrating:

  1. Loop on paymentTerms and create one document for each payment term.

  2. Calculate the following values:

    • dueDate: document.documentPaymentTerms.dueDate

    • documentAmount: document.documentAmount * document.documentPaymentTerms.percentage / 100

    • companyCurrencyAmount: document.companyCurrencyAmount * document.documentPaymentTerms.percentage / 100

    • sourceCurrencyAmount: document.sourceCurrencyAmount * document.documentPaymentTerms.percentage / 100
Test Data

Test data for invoicing integration can be generated in the Dataloy VMS post fixture modules (Accounts Receivable, Accounts Payable and Hire Payable).

Post Transaction 

When an invoice is successfully transferred to an accounting system, the document status must be updated to Posted in Dataloy VMS. This is done in a PUT request:

Code Block
titleUpdate status to posted for a specific invoice
PUT request on /Document/{key}
 
{
    "invoicingStatus": "POS"
}

Anchor
voyage
voyage
Voyages

Prerequisites

No prerequisites.

Integration Set-Up

Accounting systems often require voyage related data before transferring accounting related transactions. Set up a scheduled task and use the request under Data Transaction

...

to gather all

...

voyages that has been modified since the last time a scheduled task was run.

...

Data Transaction

  • Dataloy VMS as a master for business partners

...

Test Data

Modify some existing voyages in the Booking and Operations module for testing, for example, changing a date in the schedule (note: changing dates will also affect the schedule for other voyages).

Data Transaction

To extract all fixed voyages from Dataloy VMS that has been modified since a

...

given date, use request below in conjunction with the base URL:

Code Block
titleGet

...

all fixed voyages modified since given date
GET /

...

VoyageHeader?filter=modifiedDate(GTE)2014-01-01T12:30:00

...

  • Other system as Master for Business Partners

...

Check if relevant business partner/s is/are already existing in Dataloy VMS by using the following request in conjunction with the base URL:

Code Block
titleGet business partner by key
GET /BusinessPartner?filter=businessPartnerCode(EQ)99999

...

Update Business Partner:

Code Block
titleUpdate Business Partner
PUT /BusinessPartner/{BusinessPartner key}
 
{
"businessPartnerName": "Updated Test Name"
}

...

Update Address:

Code Block
titleUpdate Address
PUT /Address/{Address key}
 
{
"address1": "Updated address"
}

...

Update Bank:

Code Block
titleUpdate Bank
PUT /Bank/{Bank key}
 
{
"swiftAddress": "Updated Swift address"
}

...

Update Bank Account:

Code Block
titleUpdate Bank Account
PUT /BankAccount/{Bank account key}
 
{
"bankAccountNo": "UpdatedNumber"
}

Update Contact Information:

...

titleUpdate Contact Info

...

Post Transaction 

No post transaction is required.

Anchor
businessPartner
businessPartner
Business Partners

Prerequisites

Synchronization of business partners between Dataloy VMS and the applicable accounting system is required before transferring accounting related transactions. To synchronize business partner updates between systems, decide which system is to be the Master System (where the business partners will be updated). The Master System will then send updated business partner data to the other system.

Integration Set-Up

  • Dataloy VMS used as master: Set up a scheduled task and use the request under Data Transaction (below) to gather all business partners data having been modified since the last time a scheduled task was run.
  • Dataloy VMS is not used as master: Use the requests under Data Transaction (below) to insert and update the business partners in Dataloy VMS.

Data Transaction

  • Dataloy VMS as a master for business partners

  1. Extract the business partners whose data has been modified since a selected date from Dataloy VMS using the following request in conjunction with the base URL:

    Code Block
    titleGet business partner information
    GET /BusinessPartner?filter=modifiedDate(GTE)2014-01-01T12:30:00


  2. Set up a scheduled task and gather all voyages that have been modified since the last time a scheduled task was run. 
  • Other system as Master for Business Partners

  1. Check if relevant business partner/s is/are already existing in Dataloy VMS by using the following request in conjunction with the base URL:

    Code Block
    titleGet business partner by key
    GET /BusinessPartner?filter=businessPartnerCode(EQ)99999


  2. If the business partner is
    1.  already entered in Dataloy VMS. For versions prior to API 3.0:
      1. Update Business Partner:

        Code Block
        titleUpdate Business Partner
        PUT /BusinessPartner/{BusinessPartner key}
         
        {
        "emailbusinessPartnerName": "updated@emailaddress.comUpdated Test Name"
        }
      2. Link an existing Bank Account to the Business Partner (new in API version 2.0.0).

        Code Block
        POST /BusinessPartner/{business partner key}/BankAccount/{bank account key}/link
      3. Unlink an existing Bank Account to a Business Partner (new in API version 2.0.0).

        Code Block
        POST /BusinessPartner/{business partner key}/BankAccount/{bank account key}/unlink

      already entered in Dataloy VMS. For versions from API 3.0:


      1. PUT the BusinessPartner object:

        Code Blockput /BusinessPartner {  "key":1111111, "businessPartnerName": "Test Name", "businessPartnerCode": "123456789", "businessPartnerSort": "TESTNAME", "companyRegistrationNo": "123456789", "businessPartnerType": "C", "bankAccounts":[

        Update Address:

        Code Block
        titleUpdate Address
        PUT /Address/{Address key}
         
        {
        "address1": "Updated address"
        }


      2. Update Bank:

        Code Block
        titleUpdate Bank
        PUT /Bank/{Bank key}
         
        {
        "swiftAddress": "Updated Swift address"
        }


      3. Update Bank Account:

        Code Block
        titleUpdate Bank Account
        PUT /BankAccount/{Bank account key}
         
        {
        "bankAccountNo": "UpdatedNumber"
        }


      4. Update Contact Information:

        Code Block
        titleUpdate Contact Info
        PUT /ContactInfo/{ContactInfo key}
         
        {
        "email": "updated@emailaddress.com"
        }


      5. Link an existing Bank Account to the Business Partner (new in API version 2.0.0).

        Code Block
        POST /BusinessPartner/{business partner key}/BankAccount/{bank account key}/link


      6. Unlink an existing Bank Account to a Business Partner (new in API version 2.0.0).

        Code Block
        POST /BusinessPartner/{business partner key}/BankAccount/{bank account key}/unlink


    2. already entered in Dataloy VMS. For versions from API 3.0:

      1. PUT the BusinessPartner object:

        Code Block
        put /BusinessPartner
         
        {
              "key":2222221111111,
        	  "ibanbusinessPartnerName": "9754Test Name",
              "bankAccountNobusinessPartnerCode": "6523123456789",
         
            "bankbusinessPartnerSort": 1033615"TESTNAME",
              "currencycompanyRegistrationNo": 400132"123456789",  
          }     ]"businessPartnerType": "C",
         
             "addressesbankAccounts":[
          [  	{
        		      "key":333333222222,
        	    "countryiban": "NL9754",
        	      "address1bankAccountNo": "6523"Street,
        Name 54", 	    "address2bank": 1033615,
        "5th floor", 	    "address3currency": "",400132
        	    "city": "Amsterdam",
        	}
            ],
        "postalCode": "1000 AA"
        	}     ],
            "contactInfo"addresses": [
        	{
        		"key":333333,
        	    "country": "NL",
        {	    "address1": "Street Name 54",
        	     "keyaddress2":444444, 			"email": "test@test.com"5th floor",
                	    "faxNoaddress3": "55555555",
        	    "city": "Amsterdam",
        	      "mobileNopostalCode": "66666666",
        1000 AA"
        	}
            ],
            "contactInfo": [
                {
                   "phoneNo "key":444444,
        			"email": "77777777test@test.com",
                    "telexNofaxNo": "8888888855555555",
                }    "mobileNo": "66666666",
         ]
        }           "phoneNo": "77777777",
                    "telexNo": "88888888"
                }
            ]
        }

         

    3. not entered in Dataloy VMS: 
      1. POST the new business partner. Note: Required fields: businessPartnerName, businessPartnerCode, businessPartnerSort.

        Code Block
        titleInsert a new business partner
        POST /BusinessPartner
         
        {
            "businessPartnerName": "Test Name",
            "businessPartnerCode": "123456789",
            "businessPartnerSort": "TESTNAME",
            "companyRegistrationNo": "123456789",  
            "businessPartnerType": "C",
         
            "bankAccounts":[
            {
              "iban":"9754",
              "bankAccountNo":"6523",
              "bank": {
                "bankName":"BP bank",
                "abaNumber":"1111",   
                "chip":"2222",
                "swiftAddress":"42341"
               },
              "currency": 400132
            }
            ],
          
            "addresses": [
        	{
        	    "country": "NL",
        	    "address1": "Street Name 54",
        	    "address2": "5th floor",
        	    "address3": "",
        	    "city": "Amsterdam",
        	    "postalCode": "1000 AA"
        	}
            ],
            "contactInfo": [
                {
                    "email": "test@test.com",
                    "faxNo": "55555555",
                    "mobileNo": "66666666",
                    "phoneNo": "77777777",
                    "telexNo": "88888888"
                }
            ]
        }

        More Info: /BusinessPartner/Address, /ContactInfo/BankAccount/Bank

...

Create test data for transferring business partners from Dataloy VMS by updating Business Partners in Master Data.

Post Transaction 

No post transaction is required.

...

Before setting up and testing a bunker transaction integration other integrations need to be in place.

Integration Set-Up

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 an 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.

Data Transaction

To extract all get bunker transactions that are ready for posting from Dataloy VMS use the request (below) in conjunction with the base URL:

Code Block
titleGet invoices that are ready for posting to accounting
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(EQ)ACC

More information: /DocumentType/Document.

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:

...

titleUpdate status to posted for a specific invoice

...

in Webhooks the following subscription can be created:

Code Block
{
    "eventType":"U",
    "user": the user code to be used in the subscription,
    "invoicingStatusobjectType":"Document",
    "POSexpression"
}

Payments/Receipts

Prerequisites

Before setting up and testing an invoice integration other integrations need to be in place.

Integration Set-Up

When a payment is registered in the accounting system, it should be transferred as applicable to the Posted sections of either the Accounts Payable or the Accounts Receivable modules (where the matching invoice/s can be found) in Dataloy VMS.

Since a payment in accounting systems may cover multiple Dataloy VMS payments/receipts, extracting payments from accounting means extracting invoices matching to a payment. Only payments/receipts records with a matching invoice in the applicable accounting system and with a required reference to a Dataloy invoice are to be extracted.

In Dataloy VMS all payments must match with the referenced invoice. To insert a payment/receipt in Dataloy VMS use the request under Data Transaction (below).

Data Transaction

  • A payment record should ONLY ever have one document line. Never more.

More information: /DocumentType/Document.

Amount Prefix

This matrix is showing which prefix the payment amount should have for the various cases.

 Accounts Payable and Hire PayableAccounts Receivable
Receipt (PMI)Positive AmountNegative amount
Payment (PMO)Negative AmountPositive Amount
To Post a Payment/Receipt to Dataloy VMS:

...

Note

Updated for API version 2.0.0 using the new required date format yyyy-dd-MMThh:mi:ss to conform ISO 8601, (prior versions has date format: yyyy-dd-MM hh:mi:ss).

Code Block
titlePost a payment/receipt to Dataloy
POST /Document
 
{
    "documentAmount": 10000.00,
    "companyCurrencyAmount": 10000.00,
    : "dlpObject.getInvoicingStatus() != null && dlpObject.getInvoicingStatus().getStatusTypeCode().equals(\"RFP\") && (dlpObject.getDocumentType().getDocumentType().equals(\"ACC\"))",
    "url":"your webhook url"
}


Alternatively a scheduled job can be setup to use the following request:

Code Block
titleGet invoices that are ready for posting to accounting
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(EQ)ACC

More information: /DocumentType/Document.

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:

Code Block
titleUpdate status to posted for a specific invoice
PUT /Document/{key}
 
{
    "invoicingStatus": "POS"
}

Payments/Receipts

Prerequisites

Before setting up and testing an invoice integration other integrations need to be in place.

Integration Set-Up

When a payment is registered in the accounting system, it should be transferred as applicable to the Posted sections of either the Accounts Payable or the Accounts Receivable modules (where the matching invoice/s can be found) in Dataloy VMS.

Since a payment in accounting systems may cover multiple Dataloy VMS payments/receipts, extracting payments from accounting means extracting invoices matching to a payment. Only payments/receipts records with a matching invoice in the applicable accounting system and with a required reference to a Dataloy invoice are to be extracted.

In Dataloy VMS all payments must match with the referenced invoice. To insert a payment/receipt in Dataloy VMS use the request under Data Transaction (below).

Data Transaction

  • A payment record should ONLY ever have one document line. Never more.

More information: /DocumentType/Document.

Amount Prefix

This matrix is showing which prefix the payment amount should have for the various cases.


Accounts Payable and Hire PayableAccounts Receivable
Receipt (PMI)Positive AmountNegative amount
Payment (PMO)Negative AmountPositive Amount
To Post a Payment/Receipt to Dataloy VMS:


Note: From version 1.0.0 voyage is not required for payment/receipts.

Note

Updated for API version 2.0.0 using the new required date format yyyy-dd-MMThh:mi:ss to conform ISO 8601, (prior versions has date format: yyyy-dd-MM hh:mi:ss).


Code Block
titlePost a payment/receipt to Dataloy
POST /Document
 
{
    "documentAmount": 10000.00,
    "companyCurrencyAmount": 10000.00,
    "sourceCurrencyAmount": 10000.00,
    "documentCurrency": "USD",
    "documentDate": "2014-01-01T00:00:00",
    "documentType": "PMO",
    "documentNo": "111111199",
	"externalDocumentNo": "50300",
    "company": "01",
    "businessPartner": "60526",
    "invoicingStatus": "POS",    
    "documentText": "text here",
    "documentLines": 
    [
        {
            "documentAmount": 10000.00,
            "companyCurrencyAmount": 10000.00,
            "sourceCurrencyAmount": 10000.00,
            "documentCurrency": "USD",
            "invoicingStatus": "POS",
            "documentLineText": "text here",
            "businessPartner": "BPCODE",
            "isAccountsPayable": true,
            "refDocument": "71800125"
        }
    ]    
}

More information: /DocumentType/Document.

 

Note

documentNo can be skipped. The payment will then get the new document key as documentNo. If skipping then remove documentNo from JSON, do not set the value empty.

 

Test data

Create an invoice in Dataloy VMS and transfer it to the accounting system. Create a payment in the accounting system and transfer it to Dataloy VMS.

Post transaction 

No post transaction is required.

...

Prerequisites

Invoice Integration need to be in place before setting up and testing actuals integration.

Integration Set-Up

Transfer of actuals (or physicals) from Accounting to Dataloy VMS can either be setup as a manual task through the Period-End-Closing Process or as a scheduled task. Actuals in accounting are actual costs and revenues, and once entered into Dataloy VMS, the actual record will appear in the Posted section of the Accruals module. Bunker transactions in Accounting that has been transferred from Dataloy VMS are not to be transferred, as they are already treated as actuals in Dataloy VMS (more information: actuals and accruals page and the Period-End-Closing process.

Data Transaction

To insert an actual in Dataloy VMS:

  • An actual record should ONLY ever have one document line. Never more.
  • The document date should be the first day of the period month.
  • Client can choose to insert actuals one by one or group actuals by period, currency, voyage, account and company
  • Set a unique document number (documentNo).

Use request:

Note

Updated for API version 2.0.0 using the new required date format yyyy-dd-MMThh:mi:ss to conform ISO 8601, (prior versions has date format: yyyy-dd-MM hh:mi:ss).

Code Block
titlePost an actual to Dataloy
POST /Document
 
{
    "documentAmount": 10000.00,
    "companyCurrencyAmount": 10000.00,
    "sourceCurrencyAmount     }
    ]    
}

More information: /DocumentType/Document.


Note

documentNo can be skipped. The payment will then get the new document key as documentNo. If skipping then remove documentNo from JSON, do not set the value empty.


Test data

Create an invoice in Dataloy VMS and transfer it to the accounting system. Create a payment in the accounting system and transfer it to Dataloy VMS.

Post transaction 

No post transaction is required.

Anchor
actuals
actuals
Actuals

Prerequisites

Invoice Integration need to be in place before setting up and testing actuals integration.

Integration Set-Up

Transfer of actuals (or physicals) from Accounting to Dataloy VMS can either be setup as a manual task through the Period-End-Closing Process or as a scheduled task. Actuals in accounting are actual costs and revenues, and once entered into Dataloy VMS, the actual record will appear in the Posted section of the Accruals module. Bunker transactions in Accounting that has been transferred from Dataloy VMS are not to be transferred, as they are already treated as actuals in Dataloy VMS (more information: actuals and accruals page and the Period-End-Closing process.

Data Transaction

To insert an actual in Dataloy VMS:

  • An actual record should ONLY ever have one document line. Never more.
  • The document date should be the first day of the period month.
  • Client can choose to insert actuals one by one or group actuals by period, currency, voyage, account and company
  • Set a unique document number (documentNo).

Use request:

Note

Updated for API version 2.0.0 using the new required date format yyyy-dd-MMThh:mi:ss to conform ISO 8601, (prior versions has date format: yyyy-dd-MM hh:mi:ss).


Code Block
titlePost an actual to Dataloy
POST /Document
 
{
    "documentAmount": 10000.00,
    "companyCurrencyAmount": 10000.00,
    "sourceCurrencyAmount": 10000.00,
    "documentDate": "2014-01-01T00:00:00",
    "documentType": "ACC",
    "documentNo": "111111187",
    "company": "01",
    "invoicingStatus": "POS",
    "documentCurrency": "USD",
    "documentText": "text here",
    "glAccount": "1000",
    "documentLines": 
    [
        {
            "documentAmount": 10000.00,
    "documentDate": "2014-01-01T00:00:00",        "documentTypecompanyCurrencyAmount": "ACC", 10000.00,
      "documentNo": "111111187",     "companysourceCurrencyAmount": "01"10000.00,
    "invoicingStatus": "POS",        "documentCurrency": "USD",
    "documentText": "text here",        "glAccountexchangeRate": "1000"1,
      "documentLines      "invoicingStatus": "POS",
    [         {"documentLineText": "text here",
            "documentAmountvoyage": 10000.00,"VOY100",
            "glAccount":  "companyCurrencyAmount1000":
10000.00,        }
    "sourceCurrencyAmount": 10000.00,
            "documentCurrency": "USD",
            "exchangeRate": 1,
            "invoicingStatus": "POS",
       ]
}

More information: /DocumentType/Document.

Post Transaction

No post transaction is required.

Accruals

Prerequisites

Before setting up and testing an invoice integration other integrations need to be in place:

Integration Set-Up

When accruals have been verified and posted in Dataloy VMS, the document status is set to Ready-for-Posting.

More information, go to Accruals and Period-End-Closing.

Data Transactions

To get accruals that are ready for posting in Webhooks the following subscription can be created:

Code Block
{
    "eventType":"U",
    "documentLineTextuser": "text here",
      the user code to be used in the subscription,
     "voyageobjectType": "VOY100Document",
  
         "glAccount": "1000"
        }
    ]
}

More information: /DocumentType/Document.

Post Transaction

No post transaction is required.

Accruals

Prerequisites

Before setting up and testing an invoice integration other integrations need to be in place:

Integration Set-Up

When accruals have been verified and 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 (below) to extract invoices and credit notes ready for posting. When an accrual is transferred to Accounting, update the status to Posted. More information, go to Accruals and Period-End-Closing.

Data Transactions

...

 "expression": "dlpObject.getInvoicingStatus() != null && dlpObject.getInvoicingStatus().getStatusTypeCode().equals(\"RFP\") && (dlpObject.getDocumentType().getDocumentType().equals(\"ACR\") || dlpObject.getDocumentType().getDocumentType().equals(\"ACP\"))",
    "url":"your webhook url"
}


Alternatively a scheduled job can be setup to use the following request:

Code Block
titleGet accruals and accrual reversals that are ready for posting to accounting
GET /Document?filter=invoicingStatus.statusTypeCode(EQ)RFP&filter=documentType.documentType(IN)ACP,ACR

More information: /DocumentType/Document.

Test Data

Test data for accruals integration can be generated in the Accruals module in Dataloy VMS. Generate and batch post the accruals.

Post Transaction  

When an accrual is successfully transferred to an accounting system, the accrual status must to be updated to Posted in Dataloy VMS. This is done in a PUT request: 

...

 
Field NameDescriptionNot possible to user in filters
documentAmount
  • For /DocumentTypes INO, INI, CRI, CRO: Amount in order currency/sales currency. The original currency.
  • For /DocumentTypes PMI, PMO: Amount in Invoice Currency.
  • For /DocumentTypes ACR, ACP: Amount in Voyage Currency.
  • For /DocumentTypes APR: Amount in Advance Currency
  • For /DocumentTypes ACC: Amount in Invoice Currency (use Voyage currency if Invoice Currency is not present)
 
companyCurrencyAmount

For all /DocumentTypes : Amount in Company Currency for the Document.Company.

 
sourceCurrencyAmount 
documentCurrency.currencyCode

Currency Code for documentAmount. More information, see documentAmount

 
sourceCurrencyCodeCurrency code for sourceCurrencyAmount. More information see sourceCurrencyAmount 
exchangeRateExchange Rate between documentAmount and sourceCurrencyAmount 
exchangeRateDateExchange Rate Date 
glAccountGeneral Ledger AccountX
quantityHas Different Meaning Depending on Document Type:
  • Accruals - Onhire Days Within Accrual Period
  • Bunkers - Bunker Quantity
  • Freight - Cargo Quantity
  • Charter Hire - Days
  • Meals and Cables - Days
  • VAT - VAT Amount is Quantity * vatRate
  • Various, Days - Voyage Days
  • Various, Rate - Cargo Quantity
  • Offhire - Offhire Days
  • Deadfreight - Deadfreight Quantity
  • Demurrage/Despatch - Days
 
unitPriceUnit Price. Quantity * Unit Price = Document Amount 
invoicingStatus.statusTypeCodeStatus Code, see Document Status List 
documentLineTextDocument Line Text/Description 
businessPartner

Business Partner Object. (Value: businessPartnerCode or businessPartner Key).

Invoice and Payment/Receipt:

  • Outgoing invoice:
    • document.company is the company in Dataloy VMS issuing the invoice.
    • document.businessPartner is the business partner receiving the invoice.
    • On the referring payment, document.company is receiving the payment.
  • Incoming invoice:
    • document.businessPartner is issuing the invoice.
    • document.company is receiving the invoice.
    • On the referring payment document.company is the one paying the invoice.
 

isAccountsPayablefalse = Accounts Receivable, true = Accounts Payable

Inserting Payment/Receipt:
For payments referring to Accounts Receivable invoices set value to 0. For payments referring to Accounts Payable invoice set value to 1. This value should always have the same value as for the referring invoice.
 
refDocument

Referring Document for Reversals, Payments and Receipts. To set refDocument use Document Number or Key.

Payment/Receipts: Setting refDocument for payment receipts, documentLine.voyage will be set equal to the documentLine.voyage of the referring invoice.

 


vatRate.vatRateVAT Rate 
vatRate.vat.vatCodeVAT Code
freightRateFreight Rate Object 
portCallportCall Object 
handlingCosthandlingCost Object 
businessUnitbusinessUnit Object 
accountAccount Object, use glAccount instead 
handlingCostCodehandlingCostCode Object, use glAccount instead 
billOfLadingbillOfLading Object 
claimClaim Object 
offhireOffhire Object 
voyageVoyage Object 

Anchor
bankFields
bankFields
Bank Fields List

  
Field NameDescriptionRequiredUniqueNot Possible to Set in Filters
bankNameBank NameYes  

swiftAddressSWIFT CodeYesYes 
chipChip ID   


abaNumberABA Code  


addressesAddress 

X
contactInfoContact Info  

X

Top
Back

Related Content

Expand
titleExpand to see related content


Wiki Markup
{dynamiccontentbylabel:showLabels=false|showSpace=false}