GET /ubl

This endpoint response body can be used directly in integrations with UniMicro.
The GET /ubl endpoint will provide a representation of the invoice according to UBL 3.0 specification . The intention is to offer any invoice as an equivalent UBL Billing invoice enriched with InvoicePeriod and AccountingCost on each original invoice line.

Note: This is not the same as Accounting Lines and there is no concept of Accounting Lines in UBL Billing.

Input Invoice Line

  <cac:InvoiceLine>
    <cbc:ID>3</cbc:ID>
    <cbc:InvoicedQuantity unitCode="H87" unitCodeListID="UNECERec20">1.00</cbc:InvoicedQuantity> 
    <cbc:LineExtensionAmount currencyID="SEK">1.00</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Example description for Q3 2020</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID schemeID="UNCL5305">H</cbc:ID>
        <cbc:Percent>15.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="SEK">1</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>

 

Semine enrichment

Invoice Period

AccountingCost and InvoicePeriod will be added and populated with the corresponding values from each invoice line in Semine UI.

    <cac:InvoicePeriod>
         <cbc:StartDate>2020-10-01</cbc:StartDate>
         <cbc:EndDate>2020-12-31</cbc:EndDate>
    </cac:InvoicePeriod>

Accounting Cost

 <cbc:AccountingCost>NS4102;Konto=100510;MVAkode=1</cbc:AccountingCost>

AccountingCost will be populated as specified below in line with the suggested standard on https://vefa.difi.no/ehf/g2/invoice-and-creditnote/2.0/no/#_konteringsstrengen 

The following accounting parameters may be presented inside <cbc:AccountingCost> on each invoice line:

• Konto
• MVAkode
• Interim
• Project
• CategoryType
• FixedAsset
• TransactionType
• Supplier
• Customer
• DimensionCode = DimensionValueCode*
  *for each dimension value filled in on the invoice line, there will be one pair of DimensionCode = DimensionValueCode

Example values:

 <cbc:AccountingCost>NS4102;Konto=1111;MVAkode=1;Interim=1700;Project=P818181;CategoryType=5;FixedAsset=DK909090;TransactionType=01;DimensionABC=D123</cbc:AccountingCost>

Example Output Invoice Line when running GET /ubl

   <cac:InvoiceLine>
    <cbc:ID>3</cbc:ID>
    <cbc:InvoicedQuantity unitCode="H87" unitCodeListID="UNECERec20">1.00</cbc:InvoicedQuantity>
   <cac:InvoicePeriod>
         <cbc:StartDate>2020-10-01</cbc:StartDate>
         <cbc:EndDate>2020-12-31</cbc:EndDate>
    </cac:InvoicePeriod>
    <cbc:LineExtensionAmount currencyID="SEK">1.00</cbc:LineExtensionAmount>
    <cbc:AccountingCost>NS4102;Konto=100510;MVAkode=1</cbc:AccountingCost>
    <cac:Item>
      <cbc:Name>Example description for Q3 2020</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID schemeID="UNCL5305">H</cbc:ID>
        <cbc:Percent>15.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="SEK">1</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>