Sign in
Conversion

Get PDF conversion result

Get the result of a PDF conversion task

get/api/conversion/pdf/{task_id}/result

Path parameters

task_idstring required

Response

Successful Response

document_type'INVOICE' | 'CREDIT_NOTE' | 'DEBIT_NOTE'
state'DRAFT' | 'TRANSIT' | 'FAILED' | 'SENT' | 'RECEIVED'
direction'INBOUND' | 'OUTBOUND'
customer_namestring nullable

The company name of the customer/buyer

customer_idstring nullable

The unique identifier for the customer in your system

customer_emailstring nullable

The email address of the customer

purchase_orderstring nullable

The purchase order reference number

invoice_idstring nullable

The unique invoice identifier/number

invoice_datestring date nullable

The date when the invoice was issued

due_datestring date nullable

The date when payment is due

notestring nullable

Additional notes or comments for the invoice

vendor_namestring nullable

The name of the vendor/seller/supplier

vendor_emailstring nullable

The email address of the vendor

vendor_addressstring nullable

The address of the vendor/seller

vendor_address_recipientstring nullable

The recipient name at the vendor address

customer_addressstring nullable

The address of the customer/buyer

customer_address_recipientstring nullable

The recipient name at the customer address

billing_addressstring nullable

The billing address (if different from customer address)

billing_address_recipientstring nullable

The recipient name at the billing address

shipping_addressstring nullable

The shipping/delivery address

shipping_address_recipientstring nullable

The recipient name at the shipping address

currency'EUR' | 'USD' | 'GBP' | 'JPY' | 'CHF' | 'CAD' | 'AUD' | 'NZD' | 'CNY' | 'INR' | 'SEK' | 'NOK' | 'DKK' | 'SGD' | 'HKD'
tax_code'AE' | 'E' | 'S' | 'Z' | 'G' | 'O' | 'K' | 'L' | 'M' | 'B'

Duty or tax or fee category codes (Subset of UNCL5305)

Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL

vatex'VATEX-EU-79-C' | 'VATEX-EU-132' | 'VATEX-EU-132-1A' | 'VATEX-EU-132-1B' | 'VATEX-EU-132-1C' | 'VATEX-EU-132-1D' | 'VATEX-EU-132-1E' | 'VATEX-EU-132-1F' | 'VATEX-EU-132-1G' | 'VATEX-EU-132-1H' | 'VATEX-EU-132-1I' | 'VATEX-EU-132-1J' | 'VATEX-EU-132-1K' | 'VATEX-EU-132-1L' | 'VATEX-EU-132-1M' | 'VATEX-EU-132-1N' | 'VATEX-EU-132-1O' | 'VATEX-EU-132-1P' | 'VATEX-EU-132-1Q' | 'VATEX-EU-143' | 'VATEX-EU-143-1A' | 'VATEX-EU-143-1B' | 'VATEX-EU-143-1C' | 'VATEX-EU-143-1D' | 'VATEX-EU-143-1E' | 'VATEX-EU-143-1F' | 'VATEX-EU-143-1FA' | 'VATEX-EU-143-1G' | 'VATEX-EU-143-1H' | 'VATEX-EU-143-1I' | 'VATEX-EU-143-1J' | 'VATEX-EU-143-1K' | 'VATEX-EU-143-1L' | 'VATEX-EU-144' | 'VATEX-EU-146-1E' | 'VATEX-EU-148' | 'VATEX-EU-148-A' | 'VATEX-EU-148-B' | 'VATEX-EU-148-C' | 'VATEX-EU-148-D' | 'VATEX-EU-148-E' | 'VATEX-EU-148-F' | 'VATEX-EU-148-G' | 'VATEX-EU-151' | 'VATEX-EU-151-1A' | 'VATEX-EU-151-1AA' | 'VATEX-EU-151-1B' | 'VATEX-EU-151-1C' | 'VATEX-EU-151-1D' | 'VATEX-EU-151-1E' | 'VATEX-EU-159' | 'VATEX-EU-309' | 'VATEX-EU-AE' | 'VATEX-EU-D' | 'VATEX-EU-F' | 'VATEX-EU-G' | 'VATEX-EU-I' | 'VATEX-EU-IC' | 'VATEX-EU-O' | 'VATEX-EU-J' | 'VATEX-FR-FRANCHISE' | 'VATEX-FR-CNWVAT'

VATEX code list for VAT exemption reasons

Agency: CEF Identifier: vatex

vatex_notestring nullable

Textual explanation for VAT exemption

subtotalstring nullable

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

total_discountstring nullable

The net financial discount/charge of the invoice (non-VAT charges minus non-VAT allowances). Can be positive (net charge), negative (net discount), or zero. Must be rounded to maximum 2 decimals

total_taxstring nullable

The total tax amount of the invoice. Must be positive and rounded to maximum 2 decimals

invoice_totalstring nullable

The total amount of the invoice including tax (invoice_total = subtotal + total_tax + total_discount). Must be positive and rounded to maximum 2 decimals

amount_duestring nullable

The amount due for payment. Must be positive and rounded to maximum 2 decimals

remittance_addressstring nullable

The address where payment should be sent or remitted to

remittance_address_recipientstring nullable

The recipient name at the remittance address

service_addressstring nullable

The address where services were performed or goods were delivered

service_address_recipientstring nullable

The recipient name at the service address

service_start_datestring date nullable

The start date of the service period or delivery period

service_end_datestring date nullable

The end date of the service period or delivery period

vendor_tax_idstring nullable

Vendor tax ID. For Belgium this is the VAT number. Must include the country prefix

vendor_company_idstring nullable

Vendor company ID. For Belgium this is the CBE number or their EUID (European Unique Identifier) number. In the Netherlands this is the KVK number.

customer_tax_idstring nullable

Customer tax ID. For Belgium this is the VAT number. Must include the country prefix

customer_company_idstring nullable

Customer company ID. For Belgium this is the CBE number or their EUID (European Unique Identifier) number. In the Netherlands this is the KVK number.

payment_termstring nullable

The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')

successboolean

Whether the PDF was successfully converted into a compliant e-invoice

ubl_documentstring nullable

The UBL document as an XML string

Example response

{
  "vendor_tax_id": "BE1018265814",
  "vendor_company_id": "1018265814",
  "customer_tax_id": "BE1018265814",
  "customer_company_id": "1018265814",
  "items": [
    {
      "tax_rate": "21.00",
      "charges": [
        {
          "tax_rate": "21.00"
        }
      ]
    }
  ],
  "charges": [
    {
      "tax_rate": "21.00"
    }
  ]
}

Changes

Changed in 5 of the 24 revisions of this API.64368

  • 182387bf80511See the full diff
    • ○

      removed the PCE enum value from the items/items/unit/anyOf[subschema #1: UnitOfMeasureCode]/ response property for the response status 200

      response-property-enum-value-removed

  • 02fc6edfd7a122215See the full diff
    • ▲

      the allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ▲

      the items/items/allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ●

      removed the optional property previous_unpaid_balance from the response with the 200 status

      response-optional-property-removed

    • ●

      added the new AE enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new AE enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new B enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new B enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new E enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new E enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new G enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new G enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new H87 enum value to the items/items/unit/anyOf[subschema #1: UnitOfMeasureCode]/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new K enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new K enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new L enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new L enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new M enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new M enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new O enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new O enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new S enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new S enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new Z enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new Z enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ○

      added AllowanceReasonCode to the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added AllowanceReasonCode to the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added ChargeReasonCode to the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added ChargeReasonCode to the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed TaxCategoryCode subschema #2 from the allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed TaxCategoryCode subschema #2 from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

  • 009e20418b5b2135See the full diff
    • ▲

      the allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ▲

      the items/items/allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property items/items/price_base_quantity from the response with the 200 status

      response-optional-property-removed

    • ○

      added TaxCategoryCode subschema #2 to the allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added TaxCategoryCode subschema #2 to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added subschema #1 to the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added subschema #1 to the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added subschema #1 to the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added subschema #1 to the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed AllowanceReasonCode from the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed AllowanceReasonCode from the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed ChargeReasonCode from the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed ChargeReasonCode from the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      the tax_rate response's property default value 21 was removed for the status 200

      response-property-default-value-removed

    • ○

      the tax_rate response's property default value 21 was removed for the status 200

      response-property-default-value-removed

    • ○

      the tax_rate response's property default value 21 was removed for the status 200

      response-property-default-value-removed

    • ○

      the tax_rate response's property default value 21 was removed for the status 200

      response-property-default-value-removed

    • ○

      the tax_rate response's property default value 21 was removed for the status 200

      response-property-default-value-removed

    • ○

      removed the AE enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the AE enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the B enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the B enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the E enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the E enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the G enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the G enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the K enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the K enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the L enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the L enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the M enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the M enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the O enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the O enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the S enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the S enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the Z enum value from the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the Z enum value from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 59acba77a8b022016See the full diff
    • ▲

      the allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ▲

      the items/items/allowances/anyOf[subschema #1]/items/tax_code response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • ●

      added the new AE enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new AE enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new B enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new B enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new E enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new E enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new G enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new G enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new K enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new K enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new L enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new L enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new M enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new M enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new O enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new O enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new S enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new S enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new Z enum value to the allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new Z enum value to the items/items/allowances/anyOf[subschema #1]/items/tax_code response property for the response status 200

      response-property-enum-value-added

    • ○

      added the optional property items/items/price_base_quantity to the response with the 200 status

      response-optional-property-added

    • ○

      added AllowanceReasonCode to the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added AllowanceReasonCode to the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added ChargeReasonCode to the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      added ChargeReasonCode to the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed TaxCategoryCode subschema #2 from the allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed TaxCategoryCode subschema #2 from the items/items/allowances/anyOf[subschema #1]/items/tax_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the items/items/allowances/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 from the items/items/charges/anyOf[subschema #1]/items/reason_code response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

    • ○

      the tax_rate response's property default value 21 was added for the status 200

      response-property-default-value-added

  • 009e20418b5b1See the full diff
    • ○

      endpoint added

      endpoint-added