riverty logo

Docs

Create Invoice

The creation of an invoice is the second step in the accounting process, which can be started right after you have created the order

More information can be found in our Link

Path

POST /businesses/{businessCode}/customers/{customerNumber}/orders/{orderReference}/invoices

Request Parameters

businessCode
required
string
The business in the context of which this request is to be executed, e.g. 1000
customerNumber
required
string
The customer in the context of which this request is to be executed, e.g. TFI2021072801
orderReference
required
string
The order in the context of which this request is to be executed, e.g. TFI2021072801_03
X-Request-ID
string
The unique ID of this particular request/transaction. Subsequent requests with the same request ID might get ignored.

Request Body

application/json

carrier
required
string
Carrier code (will be required for efficient chargeback handling). Only required for physical goods and if order is shipped when this information is generated.
dispatchDate
required
string
yyyy-MM-dd
Format(yyyy-MM-dd)
Date of shipment
dueDate
required
string
yyyy-MM-dd
Format(yyyy-MM-dd)
Date the invoice is due
invoiceDate
required
string
yyyy-MM-dd
Format(yyyy-MM-dd)
Date the invoice number has been created
invoiceReference
required
string
Max length: 30
maxLength(30)
Invoice number of referenced invoice
array
The items that are to be invoiced
shipmentReference
required
string
Max length: 30
maxLength(30)
Specific shipment reference from merchant
trackingCode
required
string
Tracking code of parcel (will be required for efficient chargeback handling). Only required for physical goods and if order is shipped when this information is generated.

Responses

Request Example

    
        {
 "items": [
  {
   "orderItemReference": 1
  }
 ],
 "carrier": "DHL",
 "dueDate": "2018-11-05",
 "invoiceDate": "2018-11-04",
 "dispatchDate": "2018-11-06",
 "trackingCode": "123456asfd788754sdffs987",
 "invoiceReference": "IDE12345678901",
 "shipmentReference": "S01234567"
}
    

Response Example

    
        {
 "internalRequestId": "23c9579b-baaf-468f-a529-f876226e183c"
}