Skip to content

Basware Implementation Details

JustOn can send electronic invoices to the Basware Network Services, through which they are distributed to the recipients.

Info

The Basware integration is available as of JustOn 2.46.

This page summarizes specific information about the Basware integration.

Basware Status

The Basware status is a "helper" object in JustOn used to track the data transfer status, which is linked to the invoice. It includes the following fields:

Label API Name Description
Business Document Identifier (BUMID) ONB2__BumId__c A unique identifier for the invoice. Points to the UUID at the invoice.
File References ONB2__FileReferences__c Tracks which attachments have been transferred.
Invoice ONB2__Invoice__c Lookup field that specifies the invoice.
Last Error ONB2__LastError__c Shows the error message in case the data transfer has failed.
Status ONB2__Status__c Shows the Basware status:
Unsent
File Error
Files Sent
Invoice Error
Finished
Request Body PostDocumentRequestBody__c Optional field (Long Text Area (32768)) used to record the data that is sent to Basware.

The Basware statuses have the following meaning:

Status Description
Unsent The initial status upon creation.
File Error States that some attachment uploads have failed.
Files Sent States that the batch process BatchBaswareFileUpload has completed successfully and the attachments are uploaded to Basware.
Invoice Error States that the batch process BatchBaswareInvoiceUpload has completed with errors and that the invoice data upload has failed.
Finished States that the invoice transfer (both the file and data upload) to Basware has completed successfully. Invoices with the Basware status Finished are not considered for further transfer processes.

Data Transferred to Basware

data

data is the Basware object that holds the business-related content of an invoice.

Basware Name Basware Description JustOn Source Required
id External system identifier of the business document. Invoice__c.Name
issueDate The date when the Invoice was issued. Invoice__c.Date__c
documentCurrencyCode Currency presentation of the Invoice document. Invoice__c.CurrencyIsoCode
or the organization default currency

accountingSupplierParty

accountingSupplierParty is the Basware object that represents the accountable supplier of the goods/services in the referred business document.

Basware Name Basware Description JustOn Source Required
partyName A name of the party. Tenant__c.Company__c
postalZone The postal code of the area in the postal address of the party. Tenant__c.PostalCode__c
cityName The name of the city, town or village in the postal address of the party. Tenant__c.City__c
addressLine The address line of the postal address of the party. Tenant__c.Street__c
countrySubentity The sub-entity of the area in the postal address. Tenant__c.StateCode__c
countryId The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used. Tenant__c.CountryCode__c
endpoint.id Identifier for the endpoint. Tenant__c.BaswareRecipientId__c
endpoint.schemeId External global identifier of the id identifier element. Tenant__c.BaswareSchemeId__c
partyIdentifications[0].id An object holding the external system identifier of the party. Tenant__c.BaswareRecipientId__c
partyIdentifications[0].schemeId External global identifier of the id identifier element. Tenant__c.BaswareSchemeId__c

accountingCustomerParty

accountingCustomerParty is the Basware object that represents the accountable buyer of the goods/services in the referred business document.

Basware Name Basware Description JustOn Source Required
partyName A name of the party. Invoice__c.AccountName__c
postalZone The postal code of the area in the postal address of the party. Invoice__c.BillingPostalCode__c
cityName The name of the city, town or village in the postal address of the party. Invoice__c.BillingCity__c
addressLine The address line of the postal address of the party. Invoice__c.BillingStreet__c
countrySubentity The sub-entity of the area in the postal address. Invoice__c.BillingStateCode__c
(fallback: BillingState__c)
countryId The country of the postal address of party. Valid values: ISO3166-1 alpha-2 values can be used. Invoice__c.BillingCountryCode__c
(fallback: BillingCountry__c)
contact.name A contact name of the party. Invoice__c.EmailFirstName__c + Invoice__c.EmailLastName__c
contact.electronicMail An email of the contact of the party. Invoice__c.Email__c

taxTotal

taxTotal is the Basware array that holds information about the total amount of a particular type of tax.

Basware Name Basware Description JustOn Source Required
currencyId A code that identifies the currency of the total payable amount. Invoice__c.CurrencyIsoCode
or the organization default currency
amount Total amount of the taxes, the total tax amount for particular tax scheme like VAT, the sum of each of the tax subtotals for each tax category within the tax scheme. Invoice__c.TotalTax__c
taxSubTotal An object holding the information about tax. Summary of InvoiceLineItem__c fields PosTotalNet__c, PosTotalTax__c and TaxRate__c, sorted by tax rate

legalMonetaryTotal

legalMonetaryTotal is the Basware object that represents the total amount payable on the invoice.

Basware Name Basware Description JustOn Source Required
payableAmount.amount The total amount to be paid. Invoice__c.GrandTotal__c
payableAmount.currencyId A code that identifies the currency of the total payable amount. Invoice__c.CurrencyIsoCode
or the organization default currency

invoiceLine

invoiceLine is the Basware array that holds the invoice lines.

Basware Name Basware Description JustOn Source Required
id External system identifier for the Invoice line. InvoiceLinetem__c.Sequence__c
quantity.amount The quantity of the target Business Document line items. InvoiceLinetem__c.Quantity__c
lineExtension.currencyId The currency of the amount. InvoiceLineItem__c.CurrencyIsoCode
or the organization default currency
lineExtension.amount The total amount for the line item, including allowance charges but net of taxes. InvoiceLinetem__c.TotalNet__c
item.description Description of the Business Document line item. InvoiceLinetem__c.Description__c
item.name Name of the Business Document line item. InvoiceLinetem__c.Title__c
item.taxPercent Tax amount for the item. InvoiceLinetem__c.TaxRate__c
price.currencyId A code that identifies the currency of the line item price. InvoiceLineItem__c.CurrencyIsoCodeor the organization default currency
price.amount The price of the line item. InvoiceLinetem__c.UnitPrice__c
taxTotal.currencyId A code that identifies the currency of the total payable amount. InvoiceLineItem__c.CurrencyIsoCodeor the organization default currency
taxTotal.amount Total amount of the taxes. InvoiceLinetem__c.PosTotalTax__c
transactionCurrencyTax.amount Amount of tax for the transaction. InvoiceLinetem__c.PosTotalTax__c
taxTotal.taxSubTotal An object holding the information about tax. Summary of InvoiceLineItem__c TaxDetail__c fields Amount__c and Rate__c

processingPreference

Basware Name Basware Description JustOn Source Required
sendTo.id Identifier for the recipient endpoint. Invoice__c.BaswareRecipientId__c
sendTo.schemeId Identifies the namespace of the id. Invoice__c.BaswareSchemeId__c
receiveFrom.id Identifier for the sender endpoint. Tenant__c.BaswareRecipientId__c
receiveFrom.schemeId Identifies the namespace of the id. Tenant__c.BaswareSchemeId__c
printingPreference Indicates the printing preference. Invoice__c.BaswarePrintingPreference__c

Note

You may have contracted Basware to print invoices (and, consequently, have set a printing preference) and to post them locally in the corresponding destination countries. In this case, you may need to provide customized invoice templates that comply with the destination country's postal regulations. If you have contracted international postal deliveries, one generic template may be sufficient.