Inbound deliveries

To insert a document in FarPay, the POST method is the standard option to delivery invoices in various formats

In this document we will mention all inbound capabilities in the POST Deliveries endpoint, and have a combination of a surface description, and an in depth description of how the delivery is expressed and sent to FarPay.

Insert an invoice

When inserting an invoice to the delivery endpoint following formats are available.

Type

Description

more...

Bill

A proprietary document, with a small set of properties, that enables a payment - that is:

  • Date
  • Amount
  • Customer reference.

Bill

OIOXL

OIO XML format - Standard invoice document.

OIOUBL

OIO UBL format - Standard invoice document.

Standard

Other documents

Other document types can also be inserted into the deliveries endpoint, and will typically only serve as a supplement to existing formal data.


FormatDecriptionProcessing
OIO UBL UtsUtility statement, based on the OIO UBL schemepassthrough

OIO UBL UTS

The utility document complies with the OIO UBL standard and will be sent as a passthrough in FarPay. However, the XML distribution gateway will perform the necessary validations to ensure a correct and reliable distribution.

Introduction to express an OIO UBL UTS document is found here: OIO UBL UTS

Example delivery

{
  "DeliveryType": "uts",
  "DeliveryFormat": "oioubluts",
  "File": {
    "Filename": "UTS_Statement_january.xml",
    "Data" : "<base64>"
  }
}

The delivery is received, and will return with a DeliveryID, the handle to that specific file.