e-invoice-api 0.33.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b650f7f17adb53ea009de46ee29255b3f05d34458a79e43e9c9f967e605da88c
-  data.tar.gz: 4d8a0eaa840ade1c7631b7bbcbd2bc8696b4e0e3fea2f01064ed1d551773c9b3
+  metadata.gz: 63945a128a3304ea3dd731b93f3dbed91ef528da885f3348f0eec8bea0aa782a
+  data.tar.gz: 16d87f07042081d9f496c2bcf7cd481c91e2fcb53b38d550fa7ac63acc9ddec1
 SHA512:
-  metadata.gz: e495c40c8d1de2b1693d53547cca5a249275a93d0bf529fcc3be8b36c21e517065c6db6dc92f93be5723a0bc6416b27981609cc7049e054f77252ef0c5ad110f
-  data.tar.gz: dbea483ba88e7a640dd9f336cb74a7ee94de38737341b4ed7254da91d434008cd05235031583c805fe587fe97d6e67591ecb1123de31805e052777a61c39b99c
+  metadata.gz: 12f3fe0b95f0bb38a0461fee9b6f71e6ecd45f0593463c4bd20076a1b8b2c962af143de0052f1568e4271538ceb0db526d4a0d607d22e976cb6a3ed91a1302ed
+  data.tar.gz: b2b59631c408a3adb3696a808c5ec0c157faa8d161ca7a2c51cd385da0903f657c067bc9ffaef2aff59f390c2c9e3fc153e06948e556346a4d395873fd0d0620

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.34.0 (2026-11-03)
+
+Full Changelog: [v0.33.0...v0.34.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.33.0...v0.34.0)
+
+### Features
+
+* **api:** sync SDK with live OpenAPI spec ([#77](https://github.com/e-invoice-be/e-invoice-rb/issues/77)) ([c4a220b](https://github.com/e-invoice-be/e-invoice-rb/commit/c4a220b9729c0735f6b73b36fa66e5e6e5bf3e2b))
+
 ## 0.33.0 (2026-07-18)
 
 Full Changelog: [v0.32.0...v0.33.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.32.0...v0.33.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "e-invoice-api", "~> 0.33.0"
+gem "e-invoice-api", "~> 0.34.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/e_invoice_api/client.rb

@@ -39,6 +39,18 @@ module EInvoiceAPI
     # @return [EInvoiceAPI::Resources::Webhooks]
     attr_reader :webhooks
 
+    # @return [EInvoiceAPI::Resources::Drafts]
+    attr_reader :drafts
+
+    # @return [EInvoiceAPI::Resources::Conversion]
+    attr_reader :conversion
+
+    # @return [EInvoiceAPI::Resources::Stats]
+    attr_reader :stats
+
+    # @return [EInvoiceAPI::Resources::Mailbox]
+    attr_reader :mailbox
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -107,6 +119,10 @@ module EInvoiceAPI
       @lookup = EInvoiceAPI::Resources::Lookup.new(client: self)
       @me = EInvoiceAPI::Resources::Me.new(client: self)
       @webhooks = EInvoiceAPI::Resources::Webhooks.new(client: self)
+      @drafts = EInvoiceAPI::Resources::Drafts.new(client: self)
+      @conversion = EInvoiceAPI::Resources::Conversion.new(client: self)
+      @stats = EInvoiceAPI::Resources::Stats.new(client: self)
+      @mailbox = EInvoiceAPI::Resources::Mailbox.new(client: self)
     end
   end
 end

data/lib/e_invoice_api/models/conversion/document_create_from_pdf_task.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      # @see EInvoiceAPI::Resources::Conversion::Pdf#create
+      class DocumentCreateFromPdfTask < EInvoiceAPI::Internal::Type::BaseModel
+        # @!attribute task_id
+        #   The ID of the task that will process the PDF
+        #
+        #   @return [String]
+        required :task_id, String
+
+        # @!attribute status
+        #   The status of the task
+        #
+        #   @return [Symbol, EInvoiceAPI::Models::Conversion::DocumentCreateFromPdfTask::Status, nil]
+        optional :status, enum: -> { EInvoiceAPI::Conversion::DocumentCreateFromPdfTask::Status }
+
+        # @!method initialize(task_id:, status: nil)
+        #   @param task_id [String] The ID of the task that will process the PDF
+        #
+        #   @param status [Symbol, EInvoiceAPI::Models::Conversion::DocumentCreateFromPdfTask::Status] The status of the task
+
+        # The status of the task
+        #
+        # @see EInvoiceAPI::Models::Conversion::DocumentCreateFromPdfTask#status
+        module Status
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          PENDING = :pending
+          COMPLETED = :completed
+          FAILED = :failed
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    DocumentCreateFromPdfTask = Conversion::DocumentCreateFromPdfTask
+  end
+end

data/lib/e_invoice_api/models/conversion/pdf_create_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      # @see EInvoiceAPI::Resources::Conversion::Pdf#create
+      class PdfCreateParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        # @!attribute file
+        #
+        #   @return [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart]
+        required :file, EInvoiceAPI::Internal::Type::FileInput
+
+        # @!method initialize(file:, request_options: {})
+        #   @param file [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart]
+        #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/e_invoice_api/models/conversion/pdf_result_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      # @see EInvoiceAPI::Resources::Conversion::Pdf#result
+      class PdfResultParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        # @!attribute task_id
+        #
+        #   @return [String]
+        required :task_id, String
+
+        # @!method initialize(task_id:, request_options: {})
+        #   @param task_id [String]
+        #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/e_invoice_api/models/conversion/pdf_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    module Conversion
+      # @see EInvoiceAPI::Resources::Conversion::Pdf#retrieve
+      class PdfRetrieveParams < EInvoiceAPI::Internal::Type::BaseModel
+        extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+        include EInvoiceAPI::Internal::Type::RequestParameters
+
+        # @!attribute task_id
+        #
+        #   @return [String]
+        required :task_id, String
+
+        # @!method initialize(task_id:, request_options: {})
+        #   @param task_id [String]
+        #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/e_invoice_api/models/document_create.rb

@@ -35,6 +35,13 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :billing_address_recipient, String, nil?: true
 
+      # @!attribute buyer_reference
+      #   The buyer reference (BT-10), e.g. a cost centre or accounting reference
+      #   requested by the buyer
+      #
+      #   @return [String, nil]
+      optional :buyer_reference, String, nil?: true
+
       # @!attribute charges
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
@@ -91,6 +98,12 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :customer_peppol_id, String, nil?: true
 
+      # @!attribute customer_phone
+      #   The telephone number of the customer contact (BT-57)
+      #
+      #   @return [String, nil]
+      optional :customer_phone, String, nil?: true
+
       # @!attribute customer_tax_id
       #   Customer tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -160,6 +173,19 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
+      # @!attribute preceding_invoice_date
+      #   The preceding invoice issue date (BT-26)
+      #
+      #   @return [Date, nil]
+      optional :preceding_invoice_date, Date, nil?: true
+
+      # @!attribute preceding_invoice_id
+      #   The preceding invoice reference (BT-25): the number of the invoice this document
+      #   corrects, for example the invoice a credit note credits
+      #
+      #   @return [String, nil]
+      optional :preceding_invoice_id, String, nil?: true
+
       # @!attribute previous_unpaid_balance
       #   The previous unpaid balance from prior invoices, if any. Must be positive and
       #   rounded to maximum 2 decimals
@@ -187,6 +213,21 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :remittance_address_recipient, String, nil?: true
 
+      # @!attribute rounding_amount
+      #   The amount added to the invoice total to round the amount for payment (BT-114),
+      #   for example to whole kronor (amount_due = invoice_total + rounding_amount when
+      #   nothing is prepaid). Can be negative. Between -5.00 and 5.00, rounded to maximum
+      #   2 decimals
+      #
+      #   @return [Float, String, nil]
+      optional :rounding_amount, union: -> { EInvoiceAPI::DocumentCreate::RoundingAmount }, nil?: true
+
+      # @!attribute sales_order
+      #   The sales order reference (BT-14) assigned by the seller
+      #
+      #   @return [String, nil]
+      optional :sales_order, String, nil?: true
+
       # @!attribute service_address
       #   The address where services were performed or goods were delivered
       #
@@ -244,6 +285,14 @@ module EInvoiceAPI
       #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode, nil]
       optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::TaxCode }
 
+      # @!attribute tax_currency
+      #   The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is
+      #   accounted in a currency other than the invoice currency. Must differ from
+      #   currency and requires total_tax_in_tax_currency
+      #
+      #   @return [String, nil]
+      optional :tax_currency, String, nil?: true
+
       # @!attribute tax_details
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
@@ -266,6 +315,15 @@ module EInvoiceAPI
       #   @return [Float, String, nil]
       optional :total_tax, union: -> { EInvoiceAPI::DocumentCreate::TotalTax }, nil?: true
 
+      # @!attribute total_tax_in_tax_currency
+      #   The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #   not add to invoice_total. Requires tax_currency. Rounded to maximum 2 decimals
+      #
+      #   @return [Float, String, nil]
+      optional :total_tax_in_tax_currency,
+               union: -> { EInvoiceAPI::DocumentCreate::TotalTaxInTaxCurrency },
+               nil?: true
+
       # @!attribute vatex
       #   VATEX code list for VAT exemption reasons
       #
@@ -311,6 +369,14 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_name, String, nil?: true
 
+      # @!attribute vendor_phone
+      #   The telephone number of the vendor contact (BT-42). Required when vendor and
+      #   customer are both in Germany (DE-R-006); it must then hold at least 3 digits
+      #   (DE-R-027, a warning).
+      #
+      #   @return [String, nil]
+      optional :vendor_phone, String, nil?: true
+
       # @!attribute vendor_tax_id
       #   Vendor tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -318,7 +384,7 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, previous_unpaid_balance: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
+      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, buyer_reference: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_phone: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, preceding_invoice_date: nil, preceding_invoice_id: nil, previous_unpaid_balance: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, rounding_amount: nil, sales_order: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_currency: nil, tax_details: nil, total_discount: nil, total_tax: nil, total_tax_in_tax_currency: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_phone: nil, vendor_tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {EInvoiceAPI::Models::DocumentCreate} for more details.
       #
@@ -332,6 +398,8 @@ module EInvoiceAPI
       #
       #   @param billing_address_recipient [String, nil] The recipient name at the billing address
       #
+      #   @param buyer_reference [String, nil] The buyer reference (BT-10), e.g. a cost centre or accounting reference requeste
+      #
       #   @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
       #
       #   @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
@@ -350,6 +418,8 @@ module EInvoiceAPI
       #
       #   @param customer_peppol_id [String, nil] Customer Peppol ID
       #
+      #   @param customer_phone [String, nil] The telephone number of the customer contact (BT-57)
+      #
       #   @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
       #   @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
@@ -372,6 +442,10 @@ module EInvoiceAPI
       #
       #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
+      #   @param preceding_invoice_date [Date, nil] The preceding invoice issue date (BT-26)
+      #
+      #   @param preceding_invoice_id [String, nil] The preceding invoice reference (BT-25): the number of the invoice this document
+      #
       #   @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
       #
       #   @param purchase_order [String, nil] The purchase order reference number
@@ -380,6 +454,10 @@ module EInvoiceAPI
       #
       #   @param remittance_address_recipient [String, nil] The recipient name at the remittance address
       #
+      #   @param rounding_amount [Float, String, nil] The amount added to the invoice total to round the amount for payment (BT-114),
+      #
+      #   @param sales_order [String, nil] The sales order reference (BT-14) assigned by the seller
+      #
       #   @param service_address [String, nil] The address where services were performed or goods were delivered
       #
       #   @param service_address_recipient [String, nil] The recipient name at the service address
@@ -398,12 +476,16 @@ module EInvoiceAPI
       #
       #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode] Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
       #
+      #   @param tax_currency [String, nil] The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is accounte
+      #
       #   @param tax_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
       #
       #   @param total_discount [Float, String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
       #
       #   @param total_tax [Float, String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
       #
+      #   @param total_tax_in_tax_currency [Float, String, nil] The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #
       #   @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
       #
       #   @param vatex_note [String, nil] Textual explanation for VAT exemption
@@ -418,6 +500,8 @@ module EInvoiceAPI
       #
       #   @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
+      #   @param vendor_phone [String, nil] The telephone number of the vendor contact (BT-42). Required when vendor and cus
+      #
       #   @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
 
       class Allowance < EInvoiceAPI::Internal::Type::BaseModel
@@ -998,8 +1082,8 @@ module EInvoiceAPI
 
         # @!attribute date
         #
-        #   @return [nil]
-        optional :date, NilClass
+        #   @return [Date, nil]
+        optional :date, Date, nil?: true
 
         # @!attribute description
         #   The description of the line item.
@@ -1017,6 +1101,23 @@ module EInvoiceAPI
                  },
                  nil?: true
 
+        # @!attribute name
+        #   The item name (BT-153), for example the product name. Written to
+        #   cac:Item/cbc:Name. When omitted or blank, `description` (BT-154) is used as the
+        #   item name. A posted line item needs a `name` or a `description`; a line item
+        #   with neither is rejected with 422.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute price_base_quantity
+        #   The item price base quantity (BT-149). The number of item units to which the
+        #   unit price applies, for example 100 when the unit price is a price for each 100
+        #   units. Must be greater than 0. Defaults to 1.
+        #
+        #   @return [Float, String, nil]
+        optional :price_base_quantity, union: -> { EInvoiceAPI::DocumentCreate::Item::PriceBaseQuantity }
+
         # @!attribute product_code
         #   The product code of the line item.
         #
@@ -1057,7 +1158,7 @@ module EInvoiceAPI
         #   @return [Float, String, nil]
         optional :unit_price, union: -> { EInvoiceAPI::DocumentCreate::Item::UnitPrice }, nil?: true
 
-        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
+        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, name: nil, price_base_quantity: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
         #   Some parameter documentations has been truncated, see
         #   {EInvoiceAPI::Models::DocumentCreate::Item} for more details.
         #
@@ -1067,12 +1168,16 @@ module EInvoiceAPI
         #
         #   @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Item::Charge>, nil] The charges of the line item.
         #
-        #   @param date [nil]
+        #   @param date [Date, nil]
         #
         #   @param description [String, nil] The description of the line item.
         #
         #   @param item_attributes [Array<EInvoiceAPI::Models::DocumentCreate::Item::ItemAttribute>, nil] Item-level attributes (BG-32) from cac:AdditionalItemProperty.
         #
+        #   @param name [String, nil] The item name (BT-153), for example the product name. Written to cac:Item/cbc:Na
+        #
+        #   @param price_base_quantity [Float, String] The item price base quantity (BT-149). The number of item units to which the uni
+        #
         #   @param product_code [String, nil] The product code of the line item.
         #
         #   @param quantity [Float, String, nil] The quantity of items (goods or services) that is the subject of the line item.
@@ -1661,6 +1766,22 @@ module EInvoiceAPI
           #   @param value [String, nil] Attribute value (BT-161).
         end
 
+        # The item price base quantity (BT-149). The number of item units to which the
+        # unit price applies, for example 100 when the unit price is a price for each 100
+        # units. Must be greater than 0. Defaults to 1.
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Item#price_base_quantity
+        module PriceBaseQuantity
+          extend EInvoiceAPI::Internal::Type::Union
+
+          variant Float
+
+          variant String
+
+          # @!method self.variants
+          #   @return [Array(Float, String)]
+        end
+
         # The quantity of items (goods or services) that is the subject of the line item.
         # Must be rounded to maximum 4 decimals. Can be negative for credit notes or
         # corrections.
@@ -1737,6 +1858,23 @@ module EInvoiceAPI
         #   @return [Array(Float, String)]
       end
 
+      # The amount added to the invoice total to round the amount for payment (BT-114),
+      # for example to whole kronor (amount_due = invoice_total + rounding_amount when
+      # nothing is prepaid). Can be negative. Between -5.00 and 5.00, rounded to maximum
+      # 2 decimals
+      #
+      # @see EInvoiceAPI::Models::DocumentCreate#rounding_amount
+      module RoundingAmount
+        extend EInvoiceAPI::Internal::Type::Union
+
+        variant Float
+
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Float, String)]
+      end
+
       # The taxable base of the invoice. Should be the sum of all line items -
       # allowances (for example commercial discounts) + charges with impact on VAT. Must
       # be positive and rounded to maximum 2 decimals
@@ -1839,6 +1977,21 @@ module EInvoiceAPI
         #   @return [Array(Float, String)]
       end
 
+      # The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      # not add to invoice_total. Requires tax_currency. Rounded to maximum 2 decimals
+      #
+      # @see EInvoiceAPI::Models::DocumentCreate#total_tax_in_tax_currency
+      module TotalTaxInTaxCurrency
+        extend EInvoiceAPI::Internal::Type::Union
+
+        variant Float
+
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Float, String)]
+      end
+
       # VATEX code list for VAT exemption reasons
       #
       # Agency: CEF Identifier: vatex