at.austriapro.ebinterface.ubl.from.AbstractToEbInterface61Converter Maven / Gradle / Ivy
/*
* Copyright (c) 2010-2015 Bundesrechenzentrum GmbH - www.brz.gv.at
* Copyright (c) 2015-2024 AUSTRIAPRO - www.austriapro.at
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package at.austriapro.ebinterface.ubl.from;
import java.math.BigDecimal;
import java.util.List;
import java.util.Locale;
import java.util.function.Supplier;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.Immutable;
import com.helger.commons.collection.CollectionHelper;
import com.helger.commons.collection.impl.CommonsArrayList;
import com.helger.commons.collection.impl.ICommonsList;
import com.helger.commons.datetime.XMLOffsetDate;
import com.helger.commons.error.SingleError;
import com.helger.commons.error.list.ErrorList;
import com.helger.commons.locale.country.CountryCache;
import com.helger.commons.math.MathHelper;
import com.helger.commons.regex.RegExHelper;
import com.helger.commons.string.StringHelper;
import com.helger.ebinterface.v61.Ebi61AccountType;
import com.helger.ebinterface.v61.Ebi61AddressIdentifierType;
import com.helger.ebinterface.v61.Ebi61AddressType;
import com.helger.ebinterface.v61.Ebi61ContactType;
import com.helger.ebinterface.v61.Ebi61CountryType;
import com.helger.ebinterface.v61.Ebi61DeliveryType;
import com.helger.ebinterface.v61.Ebi61DiscountType;
import com.helger.ebinterface.v61.Ebi61DocumentTypeType;
import com.helger.ebinterface.v61.Ebi61InvoiceType;
import com.helger.ebinterface.v61.Ebi61NoPaymentType;
import com.helger.ebinterface.v61.Ebi61PaymentConditionsType;
import com.helger.ebinterface.v61.Ebi61PaymentMethodType;
import com.helger.ebinterface.v61.Ebi61PaymentReferenceType;
import com.helger.ebinterface.v61.Ebi61RelatedDocumentType;
import com.helger.ebinterface.v61.Ebi61SEPADirectDebitType;
import com.helger.ebinterface.v61.Ebi61SEPADirectDebitTypeType;
import com.helger.ebinterface.v61.Ebi61UniversalBankTransactionType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.*;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.DescriptionType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.DocumentDescriptionType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.InstructionIDType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.InstructionNoteType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.NoteType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.PaymentIDType;
/**
* Base class for Peppol UBL to ebInterface 6.1 converter
*
* @author Philip Helger
*/
@Immutable
public abstract class AbstractToEbInterface61Converter extends AbstractToEbInterfaceConverter
{
public static final int PAYMENT_REFERENCE_MAX_LENGTH = 35;
protected AbstractToEbInterface61Converter (@Nonnull final Locale aDisplayLocale,
@Nonnull final Locale aContentLocale,
@Nonnull final IToEbinterfaceSettings aSettings)
{
super (aDisplayLocale, aContentLocale, aSettings);
}
public static void setAddressData (@Nullable final AddressType aUBLAddress,
@Nonnull final Ebi61AddressType aEbiAddress,
@Nonnull final Locale aContentLocale)
{
// Convert main address
if (aUBLAddress != null)
{
aEbiAddress.setStreet (StringHelper.getImplodedNonEmpty (' ',
StringHelper.trim (aUBLAddress.getStreetNameValue ()),
StringHelper.trim (aUBLAddress.getBuildingNumberValue ())));
aEbiAddress.setPOBox (StringHelper.trim (aUBLAddress.getPostboxValue ()));
aEbiAddress.setTown (StringHelper.trim (aUBLAddress.getCityNameValue ()));
aEbiAddress.setZIP (StringHelper.trim (aUBLAddress.getPostalZoneValue ()));
// Country
if (aUBLAddress.getCountry () != null)
{
final Ebi61CountryType aEbiCountry = new Ebi61CountryType ();
final String sEbiCountryCode = StringHelper.trim (aUBLAddress.getCountry ().getIdentificationCodeValue ());
aEbiCountry.setCountryCode (sEbiCountryCode);
final String sCountryName = StringHelper.trim (aUBLAddress.getCountry ().getNameValue ());
aEbiCountry.setValue (sCountryName);
if (StringHelper.hasNoText (sCountryName) && StringHelper.hasText (sEbiCountryCode))
{
// Write locale of country in content locale
final Locale aLocale = CountryCache.getInstance ().getCountry (sEbiCountryCode);
if (aLocale != null)
aEbiCountry.setValue (aLocale.getDisplayCountry (aContentLocale));
}
aEbiAddress.setCountry (aEbiCountry);
}
}
}
public static void validateContactData (@Nonnull final Ebi61ContactType aEbiContact,
@Nonnull final String sPartyType,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Locale aDisplayLocale)
{
if (aEbiContact.getName () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType + "/Contact/Name")
.errorText (EText.CONTACT_NO_NAME.getDisplayText (aDisplayLocale))
.build ());
}
@Nullable
public static Ebi61ContactType convertContact (@Nonnull final PartyType aUBLParty,
@Nonnull final String sPartyType,
@Nullable final String sAddressNameFallback,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Locale aDisplayLocale,
final boolean bValidate)
{
final ContactType aUBLContact = aUBLParty.getContact ();
if (aUBLContact == null && aUBLParty.getPerson ().isEmpty ())
return null;
final Ebi61ContactType aEbiContact = new Ebi61ContactType ();
if (aUBLContact != null)
{
final String sPhone = StringHelper.trim (aUBLContact.getTelephoneValue ());
if (StringHelper.hasText (sPhone))
aEbiContact.addPhone (sPhone);
final String sEmail = StringHelper.trim (aUBLContact.getElectronicMailValue ());
if (StringHelper.hasText (sEmail))
aEbiContact.addEmail (sEmail);
}
// Person name
final ICommonsList ebContacts = new CommonsArrayList <> ();
if (aUBLContact != null)
if (StringHelper.hasTextAfterTrim (aUBLContact.getNameValue ()))
ebContacts.add (StringHelper.trim (aUBLContact.getNameValue ()));
for (final PersonType aUBLPerson : aUBLParty.getPerson ())
{
if (StringHelper.hasNoText (aEbiContact.getSalutation ()))
aEbiContact.setSalutation (StringHelper.trim (aUBLPerson.getGenderCodeValue ()));
ebContacts.add (StringHelper.getImplodedNonEmpty (' ',
StringHelper.trim (aUBLPerson.getTitleValue ()),
StringHelper.trim (aUBLPerson.getFirstNameValue ()),
StringHelper.trim (aUBLPerson.getMiddleNameValue ()),
StringHelper.trim (aUBLPerson.getFamilyNameValue ()),
StringHelper.trim (aUBLPerson.getNameSuffixValue ())));
}
if (ebContacts.isNotEmpty ())
aEbiContact.setName (StringHelper.getImplodedNonEmpty ('\n', ebContacts));
if (aEbiContact.getName () == null)
aEbiContact.setName (sAddressNameFallback);
if (bValidate)
validateContactData (aEbiContact, sPartyType, aTransformationErrorList, aDisplayLocale);
return aEbiContact;
}
public static void validateAddressData (@Nonnull final Ebi61AddressType aEbiAddress,
@Nonnull final String sPartyType,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Locale aDisplayLocale)
{
if (aEbiAddress.getStreet () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType + "/PostalAddress/StreetName")
.errorText (EText.ADDRESS_NO_STREET.getDisplayText (aDisplayLocale))
.build ());
if (aEbiAddress.getTown () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType + "/PostalAddress/CityName")
.errorText (EText.ADDRESS_NO_CITY.getDisplayText (aDisplayLocale))
.build ());
if (aEbiAddress.getZIP () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType + "/PostalAddress/PostalZone")
.errorText (EText.ADDRESS_NO_ZIPCODE.getDisplayText (aDisplayLocale))
.build ());
if (aEbiAddress.getCountry () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType +
"/PostalAddress/Country/IdentificationCode")
.errorText (EText.ADDRESS_NO_COUNTRY.getDisplayText (aDisplayLocale))
.build ());
}
@Nonnull
public static Ebi61AddressType convertParty (@Nonnull final PartyType aUBLParty,
@Nonnull final String sPartyType,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Locale aContentLocale,
@Nonnull final Locale aDisplayLocale,
final boolean bValidate)
{
final Ebi61AddressType aEbiAddress = new Ebi61AddressType ();
if (aUBLParty.getPartyNameCount () > 1)
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName (sPartyType + "/PartyName")
.errorText (EText.MULTIPLE_PARTIES.getDisplayText (aDisplayLocale))
.build ());
// Convert name
final PartyNameType aUBLPartyName = CollectionHelper.getAtIndex (aUBLParty.getPartyName (), 0);
if (aUBLPartyName != null)
aEbiAddress.setName (StringHelper.trim (aUBLPartyName.getNameValue ()));
if (aEbiAddress.getName () == null && aUBLParty.hasPartyLegalEntityEntries ())
{
// For EN set from cac:PartyLegalEntity/cbc:RegistrationName
aEbiAddress.setName (StringHelper.trim (aUBLParty.getPartyLegalEntityAtIndex (0).getRegistrationNameValue ()));
}
if (aEbiAddress.getName () == null)
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sPartyType)
.errorText (EText.PARTY_NO_NAME.getDisplayText (aDisplayLocale))
.build ());
// Convert main address
setAddressData (aUBLParty.getPostalAddress (), aEbiAddress, aContentLocale);
// GLN and DUNS number
if (aUBLParty.getEndpointID () != null)
{
final String sEndpointID = StringHelper.trim (aUBLParty.getEndpointIDValue ());
if (StringHelper.hasText (sEndpointID))
{
// We have an endpoint ID
// Check all identifier types
final String sSchemeIDToSearch = StringHelper.trim (aUBLParty.getEndpointID ().getSchemeID ());
{
final Ebi61AddressIdentifierType aEbiType = new Ebi61AddressIdentifierType ();
aEbiType.setAddressIdentifierType (sSchemeIDToSearch);
aEbiType.setValue (sEndpointID);
aEbiAddress.addAddressIdentifier (aEbiType);
}
if (aEbiAddress.hasNoAddressIdentifierEntries ())
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName (sPartyType)
.errorText (EText.PARTY_UNSUPPORTED_ENDPOINT.getDisplayTextWithArgs (aDisplayLocale,
sEndpointID,
aUBLParty.getEndpointID ()
.getSchemeID ()))
.build ());
}
}
if (aEbiAddress.hasNoAddressIdentifierEntries ())
{
// check party identification
int nPartyIdentificationIndex = 0;
for (final PartyIdentificationType aUBLPartyID : aUBLParty.getPartyIdentification ())
{
final String sUBLPartyID = StringHelper.trim (aUBLPartyID.getIDValue ());
{
// Add GLN/DUNS number
final Ebi61AddressIdentifierType aEbiType = new Ebi61AddressIdentifierType ();
aEbiType.setAddressIdentifierType (aUBLPartyID.getID ().getSchemeID ());
aEbiType.setValue (sUBLPartyID);
aEbiAddress.addAddressIdentifier (aEbiType);
}
if (aEbiAddress.hasNoAddressIdentifierEntries ())
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName (sPartyType +
"/PartyIdentification[" +
nPartyIdentificationIndex +
"]")
.errorText (EText.PARTY_UNSUPPORTED_ADDRESS_IDENTIFIER.getDisplayTextWithArgs (aDisplayLocale,
sUBLPartyID,
aUBLPartyID.getID ()
.getSchemeID ()))
.build ());
++nPartyIdentificationIndex;
}
}
if (bValidate)
validateAddressData (aEbiAddress, sPartyType, aTransformationErrorList, aDisplayLocale);
return aEbiAddress;
}
@Nonnull
protected static String getAggregated (@Nonnull final Iterable aList)
{
return StringHelper.getImplodedMapped ('\n', aList, DescriptionType::getValue);
}
protected static boolean isAddressIncomplete (@Nonnull final Ebi61AddressType aEbiAddress)
{
return StringHelper.hasNoText (aEbiAddress.getName ()) ||
StringHelper.hasNoText (aEbiAddress.getTown ()) ||
StringHelper.hasNoText (aEbiAddress.getZIP ()) ||
aEbiAddress.getCountry () == null;
}
@Nonnull
public static Ebi61DeliveryType convertDelivery (@Nonnull final DeliveryType aUBLDelivery,
@Nonnull final String sDeliveryType,
@Nullable final CustomerPartyType aCustomerParty,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Locale aContentLocale,
@Nonnull final Locale aDisplayLocale)
{
final Ebi61DeliveryType aEbiDelivery = new Ebi61DeliveryType ();
// Set the delivery ID
aEbiDelivery.setDeliveryID (aUBLDelivery.getIDValue ());
// Set the delivery date
aEbiDelivery.setDate (aUBLDelivery.getActualDeliveryDateValue ());
final PartyType aUBLParty = aUBLDelivery.getDeliveryParty ();
Ebi61AddressType aEbiAddress = null;
if (aUBLParty != null)
{
aEbiAddress = convertParty (aUBLParty,
"DeliveryParty",
aTransformationErrorList,
aContentLocale,
aDisplayLocale,
false);
aEbiDelivery.setAddress (aEbiAddress);
aEbiDelivery.setContact (convertContact (aUBLParty,
"DeliveryParty",
aEbiAddress.getName (),
aTransformationErrorList,
aDisplayLocale,
true));
}
// Address present?
if (aEbiAddress == null || isAddressIncomplete (aEbiAddress))
{
final AddressType aUBLDeliveryAddress = aUBLDelivery.getDeliveryAddress ();
if (aUBLDeliveryAddress != null)
{
if (aEbiAddress == null)
aEbiAddress = new Ebi61AddressType ();
setAddressData (aUBLDeliveryAddress, aEbiAddress, aContentLocale);
aEbiDelivery.setAddress (aEbiAddress);
}
}
final LocationType aUBLDeliveryLocation = aUBLDelivery.getDeliveryLocation ();
if (aUBLDeliveryLocation != null && aUBLDeliveryLocation.getAddress () != null)
{
// Optional description
aEbiDelivery.setDescription (getAggregated (aUBLDeliveryLocation.getDescription ()));
if (aEbiAddress == null || isAddressIncomplete (aEbiAddress))
{
// No Delivery/DeliveryAddress present
if (aEbiAddress == null)
aEbiAddress = new Ebi61AddressType ();
setAddressData (aUBLDeliveryLocation.getAddress (), aEbiAddress, aContentLocale);
aEbiDelivery.setAddress (aEbiAddress);
}
}
if (aEbiAddress != null)
{
String sAddressName = null;
// Check delivery party
if (aUBLDelivery.getDeliveryParty () != null)
for (final PartyNameType aUBLPartyName : aUBLDelivery.getDeliveryParty ().getPartyName ())
{
sAddressName = StringHelper.trim (aUBLPartyName.getNameValue ());
if (StringHelper.hasText (sAddressName))
break;
}
// As fallback use delivery location name
if (StringHelper.hasNoText (sAddressName) && aUBLDeliveryLocation != null)
sAddressName = StringHelper.trim (aUBLDeliveryLocation.getNameValue ());
// As fallback use accounting customer party
if (StringHelper.hasNoText (sAddressName) && aCustomerParty != null && aCustomerParty.getParty () != null)
{
for (final PartyNameType aUBLPartyName : aCustomerParty.getParty ().getPartyName ())
{
sAddressName = StringHelper.trim (aUBLPartyName.getNameValue ());
if (StringHelper.hasText (sAddressName))
break;
}
if (StringHelper.hasNoText (sAddressName))
{
// For EN invoices
for (final PartyLegalEntityType aUBLPartyLegalEntity : aCustomerParty.getParty ().getPartyLegalEntity ())
{
sAddressName = StringHelper.trim (aUBLPartyLegalEntity.getRegistrationNameValue ());
if (StringHelper.hasText (sAddressName))
break;
}
}
}
aEbiAddress.setName (sAddressName);
if (StringHelper.hasNoText (aEbiAddress.getName ()))
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (sDeliveryType + "/DeliveryParty")
.errorText (EText.DELIVERY_WITHOUT_NAME.getDisplayText (aDisplayLocale))
.build ());
validateAddressData (aEbiAddress, sDeliveryType + "/DeliveryParty", aTransformationErrorList, aDisplayLocale);
}
if (aUBLDelivery.hasDeliveryTermsEntries ())
{
final DeliveryTermsType aDeliveryTerms = aUBLDelivery.getDeliveryTermsAtIndex (0);
if (aDeliveryTerms.hasSpecialTermsEntries ())
aEbiDelivery.setDescription (aDeliveryTerms.getSpecialTermsAtIndex (0).getValue ());
}
return aEbiDelivery;
}
@Nullable
protected static final Ebi61DocumentTypeType getAsDocumentTypeType (@Nullable final String... aValues)
{
if (aValues != null)
for (final String s : aValues)
if (s != null)
{
final String sClean = s.trim ();
try
{
// The first match wins
return Ebi61DocumentTypeType.fromValue (sClean);
}
catch (final IllegalArgumentException ex)
{
// Ignore
}
// Try the Invoice Type Codes
if (INVOICE_TYPE_CODE_FINAL_PAYMENT.equals (sClean))
return Ebi61DocumentTypeType.FINAL_SETTLEMENT;
if (INVOICE_TYPE_CODE_PARTIAL.equals (sClean))
return Ebi61DocumentTypeType.INVOICE_FOR_PARTIAL_DELIVERY;
if (INVOICE_TYPE_CODE_PREPAYMENT_INVOICE.equals (sClean))
return Ebi61DocumentTypeType.INVOICE_FOR_ADVANCE_PAYMENT;
if (INVOICE_TYPE_CODE_SELF_BILLING.equals (sClean))
return Ebi61DocumentTypeType.SELF_BILLING;
}
return null;
}
protected static void convertRelatedDocuments (@Nonnull final List aUBLBillingReferences,
@Nonnull final Ebi61InvoiceType aEbiDoc)
{
for (final BillingReferenceType aUBLBillingReference : aUBLBillingReferences)
{
if (aUBLBillingReference.getInvoiceDocumentReference () != null &&
aUBLBillingReference.getInvoiceDocumentReference ().getIDValue () != null)
{
final Ebi61RelatedDocumentType aEbiRelatedDocument = new Ebi61RelatedDocumentType ();
aEbiRelatedDocument.setInvoiceNumber (aUBLBillingReference.getInvoiceDocumentReference ().getIDValue ());
aEbiRelatedDocument.setInvoiceDate (aUBLBillingReference.getInvoiceDocumentReference ().getIssueDateValue ());
aEbiRelatedDocument.setDocumentType (Ebi61DocumentTypeType.INVOICE);
aEbiDoc.addRelatedDocument (aEbiRelatedDocument);
}
else
if (aUBLBillingReference.getCreditNoteDocumentReference () != null &&
aUBLBillingReference.getCreditNoteDocumentReference ().getIDValue () != null)
{
final Ebi61RelatedDocumentType aEbiRelatedDocument = new Ebi61RelatedDocumentType ();
aEbiRelatedDocument.setInvoiceNumber (aUBLBillingReference.getCreditNoteDocumentReference ().getIDValue ());
aEbiRelatedDocument.setInvoiceDate (aUBLBillingReference.getCreditNoteDocumentReference ()
.getIssueDateValue ());
aEbiRelatedDocument.setDocumentType (Ebi61DocumentTypeType.CREDIT_MEMO);
aEbiDoc.addRelatedDocument (aEbiRelatedDocument);
}
// Ignore other values
}
}
protected static void convertReferencedDocuments (@Nonnull final List aUBLDocumentReferences,
@Nonnull final Ebi61InvoiceType aEbiDoc)
{
for (final DocumentReferenceType aUBLDocumentReference : aUBLDocumentReferences)
if (StringHelper.hasText (aUBLDocumentReference.getIDValue ()) && aUBLDocumentReference.getAttachment () == null)
{
final Ebi61RelatedDocumentType aEbiRelatedDocument = new Ebi61RelatedDocumentType ();
aEbiRelatedDocument.setInvoiceNumber (aUBLDocumentReference.getIDValue ());
aEbiRelatedDocument.setInvoiceDate (aUBLDocumentReference.getIssueDateValue ());
final ICommonsList aComments = new CommonsArrayList <> ();
for (final DocumentDescriptionType aUBLDocDesc : aUBLDocumentReference.getDocumentDescription ())
aComments.add (aUBLDocDesc.getValue ());
final String sComment = StringHelper.getImplodedNonEmpty ('\n', aComments);
if (StringHelper.hasText (sComment))
aEbiRelatedDocument.setComment (sComment);
if (aUBLDocumentReference.getDocumentTypeCode () != null)
{
aEbiRelatedDocument.setDocumentType (getAsDocumentTypeType (aUBLDocumentReference.getDocumentTypeCode ()
.getName (),
aUBLDocumentReference.getDocumentTypeCodeValue ()));
}
aEbiDoc.addRelatedDocument (aEbiRelatedDocument);
}
}
private static void _setPaymentMeansComment (@Nonnull final PaymentMeansType aUBLPaymentMeans,
@Nonnull final Ebi61PaymentMethodType aEbiPaymentMethod)
{
if (aUBLPaymentMeans.hasInstructionNoteEntries ())
{
final ICommonsList aNotes = new CommonsArrayList <> ();
for (final InstructionNoteType aUBLNote : aUBLPaymentMeans.getInstructionNote ())
aNotes.add (StringHelper.trim (aUBLNote.getValue ()));
if (aNotes.isNotEmpty ())
aEbiPaymentMethod.setComment (StringHelper.getImplodedNonEmpty ('\n', aNotes));
}
}
protected void convertPayment (@Nonnull final Supplier aUBLTopLevelDueDate,
@Nonnull final Supplier > aUBLDocPaymentMeans,
@Nonnull final Supplier aUBLDocPayeeParty,
@Nonnull final Supplier aUBLDocAccountingSupplierParty,
@Nonnull final Supplier > aUBLDocPaymentTerms,
@Nonnull final Supplier aUBLDocLegalMonetaryTotal,
@Nonnull final ErrorList aTransformationErrorList,
@Nonnull final Ebi61InvoiceType aEbiDoc,
final boolean bIsCreditNote)
{
final Ebi61PaymentMethodType aEbiPaymentMethod = new Ebi61PaymentMethodType ();
final Ebi61PaymentConditionsType aEbiPaymentConditions = new Ebi61PaymentConditionsType ();
{
int nPaymentMeansIndex = 0;
for (final PaymentMeansType aUBLPaymentMeans : aUBLDocPaymentMeans.get ())
{
// Use the top-level due date
XMLOffsetDate aUBLDueDate = aUBLPaymentMeans.getPaymentDueDateValue ();
if (aUBLDueDate == null)
{
// Fallback
aUBLDueDate = aUBLTopLevelDueDate.get ();
}
// https://www.unece.org/trade/untdid/d16b/tred/tred4461.htm
final String sPaymentMeansCode = StringHelper.trim (aUBLPaymentMeans.getPaymentMeansCodeValue ());
if (isUniversalBankTransaction (sPaymentMeansCode))
{
// Is a payment channel code present?
final String sPaymentChannelCode = StringHelper.trim (aUBLPaymentMeans.getPaymentChannelCodeValue ());
if (isIBAN (sPaymentChannelCode))
{
_setPaymentMeansComment (aUBLPaymentMeans, aEbiPaymentMethod);
final Ebi61UniversalBankTransactionType aEbiUBTMethod = new Ebi61UniversalBankTransactionType ();
// Find payment reference
int nPaymentIDIndex = 0;
for (final PaymentIDType aUBLPaymentID : aUBLPaymentMeans.getPaymentID ())
{
String sUBLPaymentID = StringHelper.trim (aUBLPaymentID.getValue ());
if (StringHelper.hasText (sUBLPaymentID))
{
if (sUBLPaymentID.length () > PAYMENT_REFERENCE_MAX_LENGTH)
{
// Reference
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentMeans[" +
nPaymentMeansIndex +
"]/PaymentID[" +
nPaymentIDIndex +
"]")
.errorText (EText.PAYMENT_ID_TOO_LONG_CUT.getDisplayTextWithArgs (m_aDisplayLocale,
sUBLPaymentID))
.build ());
sUBLPaymentID = sUBLPaymentID.substring (0, PAYMENT_REFERENCE_MAX_LENGTH);
}
final Ebi61PaymentReferenceType aEbiPaymentReference = new Ebi61PaymentReferenceType ();
aEbiPaymentReference.setValue (sUBLPaymentID);
aEbiUBTMethod.setPaymentReference (aEbiPaymentReference);
}
++nPaymentIDIndex;
}
if (aEbiUBTMethod.getPaymentReference () == null)
{
// Legacy (see #3)
final InstructionIDType aUBLInstructionID = aUBLPaymentMeans.getInstructionID ();
if (aUBLInstructionID != null)
{
// Prefer InstructionID over payment reference
String sUBLInstructionID = StringHelper.trim (aUBLInstructionID.getValue ());
if (StringHelper.hasText (sUBLInstructionID))
{
if (sUBLInstructionID.length () > PAYMENT_REFERENCE_MAX_LENGTH)
{
// Reference
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentMeans[" +
nPaymentMeansIndex +
"]/InstructionID")
.errorText (EText.PAYMENT_ID_TOO_LONG_CUT.getDisplayTextWithArgs (m_aDisplayLocale,
sUBLInstructionID))
.build ());
sUBLInstructionID = sUBLInstructionID.substring (0, PAYMENT_REFERENCE_MAX_LENGTH);
}
final Ebi61PaymentReferenceType aEbiPaymentReference = new Ebi61PaymentReferenceType ();
aEbiPaymentReference.setValue (sUBLInstructionID);
aEbiUBTMethod.setPaymentReference (aEbiPaymentReference);
}
}
}
// Beneficiary account
final Ebi61AccountType aEbiAccount = new Ebi61AccountType ();
// BIC
final FinancialAccountType aUBLFinancialAccount = aUBLPaymentMeans.getPayeeFinancialAccount ();
if (aUBLFinancialAccount != null)
{
final BranchType aUBLBranch = aUBLFinancialAccount.getFinancialInstitutionBranch ();
if (aUBLBranch != null)
{
// Prefer FinancialInstitutionBranch over FinancialInstitution
boolean bUseFI = false;
String sBIC = null;
String sBICScheme = null;
if (aUBLBranch.getID () != null)
{
sBIC = StringHelper.trim (aUBLBranch.getID ().getValue ());
sBICScheme = StringHelper.trim (aUBLBranch.getID ().getSchemeID ());
}
if (StringHelper.hasNoText (sBIC) || !RegExHelper.stringMatchesPattern (REGEX_BIC, sBIC))
{
final FinancialInstitutionType aUBLFI = aUBLBranch.getFinancialInstitution ();
if (aUBLFI != null && StringHelper.hasText (aUBLFI.getID ().getValue ()))
{
bUseFI = true;
sBIC = StringHelper.trim (aUBLFI.getID ().getValue ());
sBICScheme = StringHelper.trim (aUBLFI.getID ().getSchemeID ());
}
}
if (StringHelper.hasText (sBIC))
{
final boolean bIsBIC = isBIC (sBICScheme);
if (bIsBIC)
aEbiAccount.setBIC (sBIC);
else
aEbiAccount.setBankName (sBIC);
if (bIsBIC && !RegExHelper.stringMatchesPattern (REGEX_BIC, sBIC))
{
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName ("PaymentMeans[" +
nPaymentMeansIndex +
"]/PayeeFinancialAccount/FinancialInstitutionBranch" +
(bUseFI ? "/FinancialInstitution" : "") +
"/ID")
.errorText (EText.BIC_INVALID.getDisplayTextWithArgs (m_aDisplayLocale,
sBIC))
.build ());
aEbiAccount.setBIC (null);
}
}
}
}
// IBAN
final String sIBAN = aUBLFinancialAccount != null ? StringHelper.trim (aUBLFinancialAccount.getIDValue ())
: null;
aEbiAccount.setIBAN (sIBAN);
if (StringHelper.getLength (sIBAN) > IBAN_MAX_LENGTH)
{
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentMeans[" +
nPaymentMeansIndex +
"]/PayeeFinancialAccount/ID")
.errorText (EText.IBAN_TOO_LONG_STRIPPING.getDisplayTextWithArgs (m_aDisplayLocale,
sIBAN,
Integer.valueOf (IBAN_MAX_LENGTH)))
.build ());
aEbiAccount.setIBAN (sIBAN.substring (0, IBAN_MAX_LENGTH));
}
// Bank Account Owner - no field present - check PayeePart or
// SupplierPartyName
String sBankAccountOwnerName = aUBLFinancialAccount != null ? aUBLFinancialAccount.getNameValue () : null;
if (StringHelper.hasNoText (sBankAccountOwnerName))
{
final PartyType aUBLPayeeParty = aUBLDocPayeeParty.get ();
if (aUBLPayeeParty != null)
for (final PartyNameType aPartyName : aUBLPayeeParty.getPartyName ())
{
sBankAccountOwnerName = StringHelper.trim (aPartyName.getNameValue ());
if (StringHelper.hasText (sBankAccountOwnerName))
break;
}
}
if (StringHelper.hasNoText (sBankAccountOwnerName))
{
final PartyType aSupplierParty = aUBLDocAccountingSupplierParty.get ().getParty ();
if (aSupplierParty != null)
for (final PartyNameType aPartyName : aSupplierParty.getPartyName ())
{
sBankAccountOwnerName = StringHelper.trim (aPartyName.getNameValue ());
if (StringHelper.hasText (sBankAccountOwnerName))
break;
}
}
aEbiAccount.setBankAccountOwner (sBankAccountOwnerName);
aEbiUBTMethod.addBeneficiaryAccount (aEbiAccount);
aEbiPaymentMethod.setUniversalBankTransaction (aEbiUBTMethod);
aEbiDoc.setPaymentMethod (aEbiPaymentMethod);
// Set due date (optional)
aEbiPaymentConditions.setDueDate (aUBLDueDate);
break;
}
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentMeans[" + nPaymentMeansIndex + "]")
.errorText (EText.PAYMENTMEANS_UNSUPPORTED_CHANNELCODE.getDisplayTextWithArgs (m_aDisplayLocale,
sPaymentChannelCode))
.build ());
}
else
if (isSEPADirectDebit (sPaymentMeansCode))
{
_setPaymentMeansComment (aUBLPaymentMeans, aEbiPaymentMethod);
// Find SEPA fields
final SEPADirectDebit aDD = extractSEPADirectDebit (aUBLDueDate,
aUBLPaymentMeans,
aUBLDocAccountingSupplierParty.get ().getParty (),
aUBLDocPayeeParty.get ());
if (StringHelper.hasText (aDD.m_sBIC) && !RegExHelper.stringMatchesPattern (REGEX_BIC, aDD.m_sBIC))
{
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName ("PaymentMeans[" +
nPaymentMeansIndex +
"]/PayeeFinancialAccount/FinancialInstitutionBranch" +
(aDD.m_bUseBICFromFinancialInstitution ? "/FinancialInstitution"
: "") +
"/ID")
.errorText (EText.BIC_INVALID.getDisplayTextWithArgs (m_aDisplayLocale,
aDD.m_sBIC))
.build ());
}
// use SEPA fields
final Ebi61SEPADirectDebitType aEbiDirectDebit = new Ebi61SEPADirectDebitType ();
aEbiDirectDebit.setType (Ebi61SEPADirectDebitTypeType.B_2_B);
aEbiDirectDebit.setBIC (aDD.m_sBIC);
aEbiDirectDebit.setIBAN (aDD.m_sIBAN);
aEbiDirectDebit.setBankAccountOwner (aDD.m_sBankAccountOwnerName);
aEbiDirectDebit.setCreditorID (aDD.m_sCreditorID);
aEbiDirectDebit.setMandateReference (aDD.m_sMandateReference);
aEbiDirectDebit.setDebitCollectionDate (aDD.m_aDebitCollectionDate);
aEbiPaymentMethod.setSEPADirectDebit (aEbiDirectDebit);
aEbiDoc.setPaymentMethod (aEbiPaymentMethod);
// Set due date (optional)
aEbiPaymentConditions.setDueDate (aUBLDueDate);
break;
}
else
{
// No supported payment means code
if (MathHelper.isEQ0 (aEbiDoc.getPayableAmount ()))
{
// As nothing is to be paid we can safely use NoPayment
_setPaymentMeansComment (aUBLPaymentMeans, aEbiPaymentMethod);
final Ebi61NoPaymentType aEbiNoPayment = new Ebi61NoPaymentType ();
aEbiPaymentMethod.setNoPayment (aEbiNoPayment);
break;
}
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName ("PaymentMeans[" + nPaymentMeansIndex + "]")
.errorText (EText.PAYMENTMEANS_CODE_INVALID.getDisplayTextWithArgs (m_aDisplayLocale,
sPaymentMeansCode,
getOrString (", ",
PAYMENT_MEANS_CREDIT_TRANSFER,
PAYMENT_MEANS_DEBIT_TRANSFER,
PAYMENT_MEANS_PAYMENT_TO_BANK_ACCOUNT,
PAYMENT_MEANS_SEPA_CREDIT_TRANSFER),
getOrString (", ",
PAYMENT_MEANS_SEPA_DIRECT_DEBIT)))
.build ());
}
++nPaymentMeansIndex;
}
}
if (aEbiDoc.getPaymentMethod () == null)
{
// No payment method found
if (m_aSettings.isInvoicePaymentMethodMandatory ())
{
if (bIsCreditNote)
{
// Create a no-payment as fallback
final Ebi61NoPaymentType aEbiNoPayment = new Ebi61NoPaymentType ();
aEbiPaymentMethod.setNoPayment (aEbiNoPayment);
aEbiDoc.setPaymentMethod (aEbiPaymentMethod);
}
else
{
aTransformationErrorList.add (SingleError.builderError ()
.errorFieldName (bIsCreditNote ? "CreditNote" : "Invoice")
.errorText (EText.ERB_NO_PAYMENT_METHOD.getDisplayText (m_aDisplayLocale))
.build ());
}
}
}
// Payment terms
{
final ICommonsList aPaymentConditionsNotes = new CommonsArrayList <> ();
int nPaymentTermsIndex = 0;
for (final PaymentTermsType aUBLPaymentTerms : aUBLDocPaymentTerms.get ())
{
// Add notes
for (final NoteType aUBLNote : aUBLPaymentTerms.getNote ())
{
final String sUBLNote = StringHelper.trim (aUBLNote.getValue ());
if (StringHelper.hasText (sUBLNote))
aPaymentConditionsNotes.add (sUBLNote);
}
if (aUBLPaymentTerms.getPaymentDueDate () != null)
{
final XMLOffsetDate aUBLDueDate = aUBLPaymentTerms.getPaymentDueDateValue ();
if (aUBLDueDate != null)
{
final XMLOffsetDate aEbiDueDate = aEbiPaymentConditions.getDueDate ();
if (aEbiDueDate != null)
{
// Error only if due dates differ
if (!aEbiDueDate.equals (aUBLDueDate))
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentTerms[" +
nPaymentTermsIndex +
"]/PaymentDueDate")
.errorText (EText.PAYMENT_DUE_DATE_ALREADY_CONTAINED.getDisplayText (m_aDisplayLocale))
.build ());
}
else
aEbiPaymentConditions.setDueDate (aUBLDueDate);
}
final BigDecimal aUBLPaymentPerc = aUBLPaymentTerms.getPaymentPercentValue ();
if (aUBLPaymentPerc != null && MathHelper.isGT0 (aUBLPaymentPerc) && MathHelper.isLT100 (aUBLPaymentPerc))
{
final MonetaryTotalType aUBLTotal = aUBLDocLegalMonetaryTotal.get ();
final BigDecimal aBaseAmount = aUBLTotal == null ? null : aUBLTotal.getPayableAmountValue ();
if (aBaseAmount != null)
{
final BigDecimal aMinimumPayment = MathHelper.getPercentValue (aBaseAmount,
aUBLPaymentPerc,
SCALE_PRICE2,
ROUNDING_MODE);
aEbiPaymentConditions.setMinimumPayment (aMinimumPayment);
}
}
}
else
if (aUBLPaymentTerms.getSettlementDiscountPercent () != null)
{
if (aUBLPaymentTerms.getSettlementPeriod () == null ||
aUBLPaymentTerms.getSettlementPeriod ().getEndDate () == null)
{
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentTerms[" +
nPaymentTermsIndex +
"]/SettlementPeriod")
.errorText (EText.SETTLEMENT_PERIOD_MISSING.getDisplayText (m_aDisplayLocale))
.build ());
}
else
{
final Ebi61DiscountType aEbiDiscount = new Ebi61DiscountType ();
aEbiDiscount.setPaymentDate (aUBLPaymentTerms.getSettlementPeriod ().getEndDateValue ());
aEbiDiscount.setPercentage (aUBLPaymentTerms.getSettlementDiscountPercentValue ());
// Optional amount value
aEbiDiscount.setAmount (aUBLPaymentTerms.getAmountValue ());
aEbiPaymentConditions.addDiscount (aEbiDiscount);
}
}
else
if (aUBLPaymentTerms.getPenaltySurchargePercent () != null)
{
aTransformationErrorList.add (SingleError.builderWarn ()
.errorFieldName ("PaymentTerms[" + nPaymentTermsIndex + "]")
.errorText (EText.PENALTY_NOT_ALLOWED.getDisplayText (m_aDisplayLocale))
.build ());
}
++nPaymentTermsIndex;
}
if (!aPaymentConditionsNotes.isEmpty ())
aEbiPaymentConditions.setComment (StringHelper.getImploded ('\n', aPaymentConditionsNotes));
}
// Set due date alternative
if (aEbiPaymentConditions.getDueDate () == null)
aEbiPaymentConditions.setDueDate (aUBLTopLevelDueDate.get ());
if (aEbiPaymentConditions.getDueDate () != null ||
aEbiPaymentConditions.getMinimumPayment () != null ||
aEbiPaymentConditions.hasDiscountEntries () ||
StringHelper.hasText (aEbiPaymentConditions.getComment ()))
{
aEbiDoc.setPaymentConditions (aEbiPaymentConditions);
}
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy