- 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"]
}
issueDate: {
type: "string"
description: "The issue date of the referenced document."
}
lineId: {
type: "string"
description: "The line in the referenced document."
}
}
}
}
sellersItemIdentification: {
type: "string"
description: "DEPRECATED. Use the references array with 'line_sellers_item_identification' documentType. The ID the seller assigned to this item."
}
standardItemIdentification: {
type: "string"
description: "Standardized ID for the item."
}
standardItemIdentificationSchemeAgencyId: {
type: "string"
description: "DEPRECATED. Use the references array with 'line_standard_item_identification' documentType. The scheme agency for the standardized ID for the item."
}
standardItemIdentificationSchemeId: {
type: "string"
description: "DEPRECATED. Use the references array with 'line_standard_item_identification' documentType. The scheme for the standardized ID for the item."
}
tax: {
type: "object"
additionalProperties: true
}
taxesDutiesFees: {
type: "array"
description: "An array of taxes, duties and fees for this invoice line. Multiple taxesDutiesFees items is allowed only for IN (India) and US (USA) taxes. All other countries can only have a single Tax item in this array."
items: {
type: "object"
additionalProperties: true
}
}
}
}
}
invoiceNumber: {
type: "string"
description: "The invoice number you assigned to the invoice. The invoiceNumber should be unique for the legalEntityId and year of the issueDate. This means invoice numbers can be reused in different years, as is customary in some countries."
}
invoicePeriod: {
type: "string"
description: "The period (or specific date) to which the invoice applies. Format: yyyy-mm-dd - yyyy-mm-dd."
}
invoiceType: {
type: "string"
description: "DEPRECATED. Do not use. This field is available for legacy reasons only. If you want to send a regular invoice (aka UBL type '380'), make sure you have a positive invoice amount. For a credit note (aka UBL type '381'), simply provide a negative invoice amount. If you, in addition to a negative invoice amount, also specify a billingReferences, your invoice will become a corrective invoice (aka UBL type '384'). If your invoice is not sent in the UBL syntax, Storecove will provide the appropriate type for the syntax the invoice is sent in."
enum: ["380", "381", "384"]
}
issueDate: {
type: "string"
description: "Format: yyyy-mm-dd."
}
issueReasons: {
type: "array"
description: "An array reasons for issuing the invoice."
items: {
type: "string"
}
}
note: {
type: "string"
description: "A note to add to the invoice"
}
orderReference: {
type: "string"
description: "DEPRECATED. Use a reference object with a documentType 'purchase_order'. A reference to an order for this invoice, 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."
}
paymentMeansArray: {
type: "array"
description: "An array of payment means (ways to pay the invoice)."
items: {
type: "object"
description: "A PaymentMeans is a way to pay the invoice."
required: ["code"]
properties: {
account: {
type: "string"
description: "The account number."
}
amount: {
type: "number"
description: "The amount to be paid for this category. Only used for Dutch G-Account invoices. The amount nl_ga_beneficiary + amount nl_ga_gaccount must add up to the amountExcludingVat"
}
branche_code: {
type: "string"
description: "The bank branch code. Not required for IBAN numbers. Often referred to as Swift or Bic code."
}
code: {
type: "string"
description: "How the invoice has been / will be paid. The code determines which type of PaymentMeans is used and which fields are mandatory.\n++++\n