- purchase_order (document level, Invoice + Order)
A reference to an order for this document, assigned by the buyer. Note that this often is a key field, since many receivers of invoices will use this field to automatically match the invoice to an order they placed. Many receivers refuse invoices that cannot be automatically matched, in particular government agencies. So it is highly recommended to fill this field whenever possible.
- billing (document level, Invoice)
A reference to a billing document. For instance, credit notes may refer to an invoice they are a credit note for.
- sales_order (document level, Invoice + Order)
A reference to an order for this document, assigned by the seller.
- buyer_reference (document level, Invoice, Order)
The buyer's reference. Used for internal routing by the receiver. For orders, this becomes the customer reference which the receiver of the order should put back in the buyer reference field in the invoice.
- contract (document level, Invoice + Order)
A reference to a contract or framework agreement that this document relates to.
- despatch_advice (document level, Invoice)
A reference to a despatch advice for this document. In the FatturaPA, this is what will become the DDT.
- originator (document level, Invoice + Order)
A reference to an originator document for this invoice.
- receipt (document level, Invoice)
A reference to a receipt document for this document.
- project (document level, Invoice)
A reference to a project document for this document.
- quotation (document level, Order)
A reference to a quotation document for this document.
- payment_url (document level, Invoice)
A to a payment URL for the invoice.
- item_classification_code (line level)
A reference to a commodity classification / item classification code for this line.
- item_commodity_code (line level)
A reference to a commodity classification / commodity code for this line.
- line_document_reference (line level)
A reference to another document for this line.
- line_standard_item_identification (line level)
A standard item identification.
- line_sellers_item_identification (line level)
The seller's item identification.
- line_buyers_item_identification (line level)
The buyer's item identification.
- item_specification (line level)
Referece to an item specification document
\n++++\n","enum":["purchase_order","buyer_reference","billing","sales_order","contract","despatch_advice","originator","receipt","project","quotation","payment_url","item_classification_code","item_commodity_code","line_document_reference","line_standard_item_identification","line_sellers_item_identification","line_buyers_item_identification","item_specification"],"title":"Document Type","type":"string"},"issueDate":{"description":"The issue date of the referenced document.","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","title":"Issue Date","type":"string"},"lineId":{"description":"The line in the referenced document.","title":"LineId","type":"string"}},"required":["documentType"],"title":"Reference","type":"object"},"Routing":{"description":"The different ways to send the invoice to the recipient. The publicIdentifiers are used to send via the Peppol network, if the recipient is not registered on the Peppol network, the invoice will be sent to the email addresses in the emails property. This property is only mandatory when sending the invoice data using the <<_openapi_invoice>> property, not when sending using the <<_openapi_invoicedata>> property, in which case this information will be extracted from the <<_openapi_invoicedata>> object. If you do specify an <<_openapi_invoicerecipient>> object and an <<_openapi_invoicedata>> object, the data from the two will be merged.","properties":{"clearWithoutSending":{"default":false,"description":"If you wish to send the document yourself in a Y-flow, use this flag. Wait for the 'cleared' webhook and use the <<_openapi_show_document_submission_evidence>> endpoint to retrieve the clearing evidence. This will include a sendable document.","title":"Clear Without Sending","type":"boolean"},"eIdentifiers":{"$ref":"#/components/schemas/EIdentifiers"},"emails":{"description":"The email addresses the invoice should be sent to if none of the other identifiers can be used","items":{"description":"The email address the invoice should be sent to","format":"email","title":"Email","type":"string"},"title":"Fallback email","type":"array"}},"title":"Recipient ids","type":"object"},"RoutingIdentifier":{"description":"An electronic routing identifier.","properties":{"id":{"description":"The actual identifier.","minLength":1,"title":"Identifier","type":"string"},"scheme":{"description":"The scheme of the identifier. See <<_receiver_identifiers_list>> for a list.","minLength":3,"title":"Scheme","type":"string"}},"title":"Routing Identifier","type":"object"},"SellerSupplierParty":{"description":"The party sending the order.","properties":{"party":{"$ref":"#/components/schemas/SenderParty"},"publicIdentifiers":{"description":"A list of legal and tax identifiers for this customer.","items":{"$ref":"#/components/schemas/PublicIdentifier"},"title":"Public identifiers","type":"array"}},"required":["party","identifiers"],"title":"Supplier","type":"object"},"SendableDocument":{"description":"The document to send.","properties":{"documentType":{"description":"The type of document to be sent.","enum":["invoice","invoice_response","order"],"title":"Document Type","type":"string"},"invoice":{"$ref":"#/components/schemas/Invoice"},"invoiceResponse":{"$ref":"#/components/schemas/DocumentInvoiceResponse"},"order":{"$ref":"#/components/schemas/DocumentOrder"},"rawDocumentData":{"$ref":"#/components/schemas/RawDocumentData"}},"required":["documentType"],"title":"Sendable Document","type":"object"},"SenderParty":{"description":"A party that can send documents","properties":{"contact":{"$ref":"#/components/schemas/Contact"}},"title":"Sender Party","type":"object"},"Tax":{"properties":{"amount":{"description":"The amount of tax. Mandatory if taxSystem == 'tax_line_amounts'. However, it is best to use taxSystem tax_line_percentages and provide only the percentage, not the actual amount. The amount is then provided at the invoice level, in the taxSubtotals element.","title":"Amount of Tax","type":"number"},"category":{"description":"The allowed values depend on the country of the tax:\n++++\n