com.helger.ubl21.helper.UBL21InvoiceHelper Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ph-ubl21 Show documentation
Show all versions of ph-ubl21 Show documentation
Library for reading and writing UBL 2.1 documents
/**
* Copyright (C) 2014-2020 Philip Helger (www.helger.com)
* philip[at]helger[dot]com
*
* 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 com.helger.ubl21.helper;
import java.util.ArrayList;
import java.util.List;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.Immutable;
import com.helger.commons.collection.impl.CommonsArrayList;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.AllowanceChargeType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.BillingReferenceType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.CreditNoteLineType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.DeliveryType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.DocumentReferenceType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.InvoiceLineType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.LineReferenceType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.OrderLineReferenceType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.PaymentMeansType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.PaymentTermsType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.PeriodType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.SignatureType;
import oasis.names.specification.ubl.schema.xsd.commonaggregatecomponents_21.TaxTotalType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.CreditNoteTypeCodeType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.CreditedQuantityType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.InvoiceTypeCodeType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.InvoicedQuantityType;
import oasis.names.specification.ubl.schema.xsd.commonbasiccomponents_21.NoteType;
import oasis.names.specification.ubl.schema.xsd.creditnote_21.CreditNoteType;
import oasis.names.specification.ubl.schema.xsd.invoice_21.InvoiceType;
/**
* Some helper methods based on Invoice data types.
*
* @author Philip Helger
* @since 6.1.3
*/
@Immutable
public final class UBL21InvoiceHelper
{
private UBL21InvoiceHelper ()
{}
/**
* @param aSrc
* Source {@link InvoicedQuantityType}
* @return The created {@link CreditedQuantityType}
*/
@Nonnull
public static CreditedQuantityType cloneToCreditedQuantity (@Nonnull final InvoicedQuantityType aSrc)
{
final CreditedQuantityType ret = new CreditedQuantityType ();
aSrc.cloneTo (ret);
return ret;
}
/**
* @param aSrc
* Source {@link InvoiceTypeCodeType}
* @return The created {@link CreditNoteTypeCodeType}
*/
@Nullable
public static CreditNoteTypeCodeType cloneToCreditNoteTypeCode (@Nullable final InvoiceTypeCodeType aSrc)
{
if (aSrc == null)
return null;
final CreditNoteTypeCodeType ret = new CreditNoteTypeCodeType ();
aSrc.cloneTo (ret);
return ret;
}
/**
* Clone an {@link InvoiceLineType} to a {@link CreditNoteLineType}. No values
* or signs or anything is changed.
*
* @param aSrc
* Source invoice line. May not be null.
* @param aDst
* Destination credit note line. May not be null.
*/
public static void cloneToCreditNoteLine (@Nonnull final InvoiceLineType aSrc, @Nonnull final CreditNoteLineType aDst)
{
aDst.setAccountingCost (aSrc.getAccountingCost () == null ? null : aSrc.getAccountingCost ().clone ());
aDst.setAccountingCostCode (aSrc.getAccountingCostCode () == null ? null : aSrc.getAccountingCostCode ().clone ());
{
final List retAllowanceCharge = new ArrayList <> ();
for (final AllowanceChargeType aItem : aSrc.getAllowanceCharge ())
retAllowanceCharge.add (aItem == null ? null : aItem.clone ());
aDst.setAllowanceCharge (retAllowanceCharge);
}
{
final List retBillingReference = new ArrayList <> ();
for (final BillingReferenceType aItem : aSrc.getBillingReference ())
retBillingReference.add (aItem == null ? null : aItem.clone ());
aDst.setBillingReference (retBillingReference);
}
{
final List retDelivery = new ArrayList <> ();
for (final DeliveryType aItem : aSrc.getDelivery ())
retDelivery.add (aItem == null ? null : aItem.clone ());
aDst.setDelivery (retDelivery);
}
// 1:n
aDst.setDeliveryTerms (aSrc.getDeliveryTerms () == null ? null : new CommonsArrayList <> (aSrc.getDeliveryTerms ().clone ()));
{
final List retDespatchLineReference = new ArrayList <> ();
for (final LineReferenceType aItem : aSrc.getDespatchLineReference ())
retDespatchLineReference.add (aItem == null ? null : aItem.clone ());
aDst.setDespatchLineReference (retDespatchLineReference);
}
// Not in Invoice
/*
* { final List retDiscrepancyResponse = new ArrayList <> ();
* for (final ResponseType aItem : aSrc.getDiscrepancyResponse ())
* retDiscrepancyResponse.add (aItem == null ? null : aItem.clone ());
* aDst.setDiscrepancyResponse (retDiscrepancyResponse); }
*/
{
final List retDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getDocumentReference ())
retDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setDocumentReference (retDocumentReference);
}
aDst.setFreeOfChargeIndicator (aSrc.getFreeOfChargeIndicator () == null ? null : aSrc.getFreeOfChargeIndicator ().clone ());
aDst.setID (aSrc.getID () == null ? null : aSrc.getID ().clone ());
{
final List retInvoicePeriod = new ArrayList <> ();
for (final PeriodType aItem : aSrc.getInvoicePeriod ())
retInvoicePeriod.add (aItem == null ? null : aItem.clone ());
aDst.setInvoicePeriod (retInvoicePeriod);
}
// Name change
aDst.setCreditedQuantity (aSrc.getInvoicedQuantity () == null ? null : cloneToCreditedQuantity (aSrc.getInvoicedQuantity ()));
aDst.setItem (aSrc.getItem () == null ? null : aSrc.getItem ().clone ());
aDst.setItemPriceExtension (aSrc.getItemPriceExtension () == null ? null : aSrc.getItemPriceExtension ().clone ());
aDst.setLineExtensionAmount (aSrc.getLineExtensionAmount () == null ? null : aSrc.getLineExtensionAmount ().clone ());
{
final List retNote = new ArrayList <> ();
for (final NoteType aItem : aSrc.getNote ())
retNote.add (aItem == null ? null : aItem.clone ());
aDst.setNote (retNote);
}
{
final List retOrderLineReference = new ArrayList <> ();
for (final OrderLineReferenceType aItem : aSrc.getOrderLineReference ())
retOrderLineReference.add (aItem == null ? null : aItem.clone ());
aDst.setOrderLineReference (retOrderLineReference);
}
aDst.setOriginatorParty (aSrc.getOriginatorParty () == null ? null : aSrc.getOriginatorParty ().clone ());
aDst.setPaymentPurposeCode (aSrc.getPaymentPurposeCode () == null ? null : aSrc.getPaymentPurposeCode ().clone ());
{
final List retPaymentTerms = new ArrayList <> ();
for (final PaymentTermsType aItem : aSrc.getPaymentTerms ())
retPaymentTerms.add (aItem == null ? null : aItem.clone ());
aDst.setPaymentTerms (retPaymentTerms);
}
aDst.setPrice (aSrc.getPrice () == null ? null : aSrc.getPrice ().clone ());
aDst.setPricingReference (aSrc.getPricingReference () == null ? null : aSrc.getPricingReference ().clone ());
{
final List retReceiptLineReference = new ArrayList <> ();
for (final LineReferenceType aItem : aSrc.getReceiptLineReference ())
retReceiptLineReference.add (aItem == null ? null : aItem.clone ());
aDst.setReceiptLineReference (retReceiptLineReference);
}
// Name change
{
final List retSubLine = new ArrayList <> ();
for (final InvoiceLineType aItem : aSrc.getSubInvoiceLine ())
if (aItem == null)
retSubLine.add (null);
else
{
final CreditNoteLineType aDstItem = new CreditNoteLineType ();
cloneToCreditNoteLine (aItem, aDstItem);
retSubLine.add (aDstItem);
}
aDst.setSubCreditNoteLine (retSubLine);
}
aDst.setTaxPointDate (aSrc.getTaxPointDate () == null ? null : aSrc.getTaxPointDate ().clone ());
{
final List retTaxTotal = new ArrayList <> ();
for (final TaxTotalType aItem : aSrc.getTaxTotal ())
retTaxTotal.add (aItem == null ? null : aItem.clone ());
aDst.setTaxTotal (retTaxTotal);
}
aDst.setUUID (aSrc.getUUID () == null ? null : aSrc.getUUID ().clone ());
// Not in CreditNote
/*
* { final List retWithholdingTaxTotal = new ArrayList <> ();
* for (final TaxTotalType aItem : aSrc.getWithholdingTaxTotal ())
* retWithholdingTaxTotal.add (aItem == null ? null : aItem.clone ());
* aDst.seWithholdingTaxTotal (retWithholdingTaxTotal); }
*/
}
/**
* Clone an {@link InvoiceType} to a {@link CreditNoteType}. No values or
* signs or anything is changed.
*
* @param aSrc
* Source invoice. May not be null.
* @param aDst
* Destination credit note. May not be null.
*/
public static void cloneInvoiceToCreditNote (@Nonnull final InvoiceType aSrc, @Nonnull final CreditNoteType aDst)
{
aDst.setAccountingCost (aSrc.getAccountingCost () == null ? null : aSrc.getAccountingCost ().clone ());
aDst.setAccountingCostCode (aSrc.getAccountingCostCode () == null ? null : aSrc.getAccountingCostCode ().clone ());
aDst.setAccountingCustomerParty (aSrc.getAccountingCustomerParty () == null ? null : aSrc.getAccountingCustomerParty ().clone ());
aDst.setAccountingSupplierParty (aSrc.getAccountingSupplierParty () == null ? null : aSrc.getAccountingSupplierParty ().clone ());
{
final List retAdditionalDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getAdditionalDocumentReference ())
retAdditionalDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setAdditionalDocumentReference (retAdditionalDocumentReference);
}
{
final List retAllowanceCharge = new ArrayList <> ();
for (final AllowanceChargeType aItem : aSrc.getAllowanceCharge ())
retAllowanceCharge.add (aItem == null ? null : aItem.clone ());
aDst.setAllowanceCharge (retAllowanceCharge);
}
{
final List retBillingReference = new ArrayList <> ();
for (final BillingReferenceType aItem : aSrc.getBillingReference ())
retBillingReference.add (aItem == null ? null : aItem.clone ());
aDst.setBillingReference (retBillingReference);
}
aDst.setBuyerCustomerParty (aSrc.getBuyerCustomerParty () == null ? null : aSrc.getBuyerCustomerParty ().clone ());
aDst.setBuyerReference (aSrc.getBuyerReference () == null ? null : aSrc.getBuyerReference ().clone ());
{
final List retContractDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getContractDocumentReference ())
retContractDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setContractDocumentReference (retContractDocumentReference);
}
aDst.setCopyIndicator (aSrc.getCopyIndicator () == null ? null : aSrc.getCopyIndicator ().clone ());
aDst.setCustomizationID (aSrc.getCustomizationID () == null ? null : aSrc.getCustomizationID ().clone ());
{
final List retDelivery = new ArrayList <> ();
for (final DeliveryType aItem : aSrc.getDelivery ())
retDelivery.add (aItem == null ? null : aItem.clone ());
aDst.setDelivery (retDelivery);
}
// 1:n
aDst.setDeliveryTerms (aSrc.getDeliveryTerms () == null ? null : new CommonsArrayList <> (aSrc.getDeliveryTerms ().clone ()));
{
final List retDespatchDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getDespatchDocumentReference ())
retDespatchDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setDespatchDocumentReference (retDespatchDocumentReference);
}
// DiscrepancyResponse is not present in Invoice
aDst.setDocumentCurrencyCode (aSrc.getDocumentCurrencyCode () == null ? null : aSrc.getDocumentCurrencyCode ().clone ());
// Not in CreditNote
/*
* aDst.setDueDate (aSrc.getDueDate () == null ? null : aSrc.getDueDate
* ().clone ());
*/
aDst.setID (aSrc.getID () == null ? null : aSrc.getID ().clone ());
// Name change
{
final List retInvoiceLine = new ArrayList <> ();
for (final InvoiceLineType aItem : aSrc.getInvoiceLine ())
if (aItem == null)
retInvoiceLine.add (null);
else
{
final CreditNoteLineType aNewLine = new CreditNoteLineType ();
cloneToCreditNoteLine (aItem, aNewLine);
retInvoiceLine.add (aNewLine);
}
aDst.setCreditNoteLine (retInvoiceLine);
}
{
final List retInvoicePeriod = new ArrayList <> ();
for (final PeriodType aItem : aSrc.getInvoicePeriod ())
retInvoicePeriod.add (aItem == null ? null : aItem.clone ());
aDst.setInvoicePeriod (retInvoicePeriod);
}
// Name change
aDst.setCreditNoteTypeCode (cloneToCreditNoteTypeCode (aSrc.getInvoiceTypeCode ()));
aDst.setIssueDate (aSrc.getIssueDate () == null ? null : aSrc.getIssueDate ().clone ());
aDst.setIssueTime (aSrc.getIssueTime () == null ? null : aSrc.getIssueTime ().clone ());
aDst.setLegalMonetaryTotal (aSrc.getLegalMonetaryTotal () == null ? null : aSrc.getLegalMonetaryTotal ().clone ());
aDst.setLineCountNumeric (aSrc.getLineCountNumeric () == null ? null : aSrc.getLineCountNumeric ().clone ());
{
final List retNote = new ArrayList <> ();
for (final NoteType aItem : aSrc.getNote ())
retNote.add (aItem == null ? null : aItem.clone ());
aDst.setNote (retNote);
}
aDst.setOrderReference (aSrc.getOrderReference () == null ? null : aSrc.getOrderReference ().clone ());
{
final List retOriginatorDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getOriginatorDocumentReference ())
retOriginatorDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setOriginatorDocumentReference (retOriginatorDocumentReference);
}
aDst.setPayeeParty (aSrc.getPayeeParty () == null ? null : aSrc.getPayeeParty ().clone ());
aDst.setPaymentAlternativeCurrencyCode (aSrc.getPaymentAlternativeCurrencyCode () == null ? null
: aSrc.getPaymentAlternativeCurrencyCode ()
.clone ());
aDst.setPaymentAlternativeExchangeRate (aSrc.getPaymentAlternativeExchangeRate () == null ? null
: aSrc.getPaymentAlternativeExchangeRate ()
.clone ());
aDst.setPaymentCurrencyCode (aSrc.getPaymentCurrencyCode () == null ? null : aSrc.getPaymentCurrencyCode ().clone ());
aDst.setPaymentExchangeRate (aSrc.getPaymentExchangeRate () == null ? null : aSrc.getPaymentExchangeRate ().clone ());
{
final List retPaymentMeans = new ArrayList <> ();
for (final PaymentMeansType aItem : aSrc.getPaymentMeans ())
retPaymentMeans.add (aItem == null ? null : aItem.clone ());
aDst.setPaymentMeans (retPaymentMeans);
}
{
final List retPaymentTerms = new ArrayList <> ();
for (final PaymentTermsType aItem : aSrc.getPaymentTerms ())
retPaymentTerms.add (aItem == null ? null : aItem.clone ());
aDst.setPaymentTerms (retPaymentTerms);
}
// Not in CreditNote
/*
* { final List retPrepaidPayment = new ArrayList <> (); for
* (final PaymentType aItem : src.getPrepaidPayment ())
* retPrepaidPayment.add (aItem == null ? null : aItem.clone ());
* ret.setPrepaidPayment (retPrepaidPayment); }
*/
aDst.setPricingCurrencyCode (aSrc.getPricingCurrencyCode () == null ? null : aSrc.getPricingCurrencyCode ().clone ());
aDst.setPricingExchangeRate (aSrc.getPricingExchangeRate () == null ? null : aSrc.getPricingExchangeRate ().clone ());
aDst.setProfileExecutionID (aSrc.getProfileExecutionID () == null ? null : aSrc.getProfileExecutionID ().clone ());
aDst.setProfileID (aSrc.getProfileID () == null ? null : aSrc.getProfileID ().clone ());
// Not in CreditNote
/*
* { final List retProjectReference = new ArrayList
* <> (); for (final ProjectReferenceType aItem : aSrc.getProjectReference
* ()) retProjectReference.add (aItem == null ? null : aItem.clone ());
* aDst.setProjectReference (retProjectReference); }
*/
{
final List retReceiptDocumentReference = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getReceiptDocumentReference ())
retReceiptDocumentReference.add (aItem == null ? null : aItem.clone ());
aDst.setReceiptDocumentReference (retReceiptDocumentReference);
}
aDst.setSellerSupplierParty (aSrc.getSellerSupplierParty () == null ? null : aSrc.getSellerSupplierParty ().clone ());
{
final List retSignature = new ArrayList <> ();
for (final SignatureType aItem : aSrc.getSignature ())
retSignature.add (aItem == null ? null : aItem.clone ());
aDst.setSignature (retSignature);
}
{
final List retStatementDocument = new ArrayList <> ();
for (final DocumentReferenceType aItem : aSrc.getStatementDocumentReference ())
retStatementDocument.add (aItem == null ? null : aItem.clone ());
aDst.setStatementDocumentReference (retStatementDocument);
}
aDst.setTaxCurrencyCode (aSrc.getTaxCurrencyCode () == null ? null : aSrc.getTaxCurrencyCode ().clone ());
aDst.setTaxExchangeRate (aSrc.getTaxExchangeRate () == null ? null : aSrc.getTaxExchangeRate ().clone ());
aDst.setTaxPointDate (aSrc.getTaxPointDate () == null ? null : aSrc.getTaxPointDate ().clone ());
aDst.setTaxRepresentativeParty (aSrc.getTaxRepresentativeParty () == null ? null : aSrc.getTaxRepresentativeParty ().clone ());
{
final List retTaxTotal = new ArrayList <> ();
for (final TaxTotalType aItem : aSrc.getTaxTotal ())
retTaxTotal.add (aItem == null ? null : aItem.clone ());
aDst.setTaxTotal (retTaxTotal);
}
aDst.setUBLExtensions (aSrc.getUBLExtensions () == null ? null : aSrc.getUBLExtensions ().clone ());
aDst.setUBLVersionID (aSrc.getUBLVersionID () == null ? null : aSrc.getUBLVersionID ().clone ());
aDst.setUUID (aSrc.getUUID () == null ? null : aSrc.getUUID ().clone ());
// Not in CreditNote
/*
* { final List retWithholdingTaxTotal = new ArrayList <> ();
* for (final TaxTotalType aItem : aSrc.getWithholdingTaxTotal ())
* retWithholdingTaxTotal.add (aItem == null ? null : aItem.clone ());
* aDst.setWithholdingTaxTotal (retWithholdingTaxTotal); }
*/
}
}