Create Invoice

post

https://api.digitax.tech/ng/v1/invoices

Creates a new PINT-AE compliant e-invoice and submits it to the Peppol network.

Body Params

party_id

string

The buyer or recipient of the goods or services

payee_party_id

string

If the payment goes to someone else, this field captures that party's ID on DigiTax

bill_party_id

string

If the payment goes to someone else, this field captures that party's ID on DigiTax

ship_party_id

string

If the payment goes to someone else, this field captures that party's ID on DigiTax

tax_representative_party_id

string

The party ID of the tax agent handling invoicing and compliance for the business if there is one

invoice_date

date

required

The date on which the invoice was created in the format YYYY-MM-DD

issue_date

date

required

The date on which this invoice was issued in the format YYYY-MM-DD

issue_time

string

The time at which this invoice was issued in the format HH:MM:SS

invoice_type_code

string

required

A code that specifies the type of invoice being issued

tax_point_date

date

The actual date when the tax becomes applicable in the format YYYY-MM-DD

document_currency_code

string

required

A code that specifies the default currency in which the invoice is issued

buyer_reference

string

A reference number or code provided by the buyer to track the invoice

trader_invoice_number

string

required

length ≤ 30

An invoice number assigned by the supplier to uniquely identify the invoice in their system

accounting_cost

string

Represents the accounting category or cost center assigned to the transaction

payment_terms_note

string

Describes the terms and conditions of payment

invoice_delivery_period

object

Defines the start and end dates for when goods or services were delivered. This helps track multi-day deliveries on a single invoice

payment_means

array of objects

Defines how the invoice will be paid and when payment is due

payment_means

allowance_charge

array of objects

Defines any discounts (allowance) or extra charges (charge)

allowance_charge

billing_document_reference

object

Links the invoice to a previous billing document (e.g., credit note, debit note, or a prior invoice)

dispatch_document_reference

object

An optional identifier of a referenced dispatch advice. Refers to the document used to track the dispatch of goods

receipt_document_reference

object

A reference to a receipt advice associated with an invoice. Links the invoice to a receipt document

originator_document_reference

object

A reference to an originator document associated with an invoice. Identifies the original document that initiated the invoice

contract_document_reference

object

A reference to a contract associated with an invoice. Links the invoice to a contract governing the transaction

additional_document_reference

array of objects

A reference to additional documents associated with an invoice. Used as a general reference field for any related documents

additional_document_reference

due_date

date

The date on which the invoice is due for payment in the format YYYY-MM-DD

notes

string

Additional invoice information that is not contained explicitly in other structures

callback_url

uri

The URL to call when we have new information about the invoice, when the invoice is signed successfully or validation has failed

invoice_kind

string

enum

Specifies the kind of invoice that was sent. It can either be Business to Business (B2B), Business to Consumer (B2C)

Allowed:

payment_status

string

enum

The current payment status of the invoice

Allowed:

items

array of objects

required

A list that captures details about each good or service being invoiced

items*

Responses

201Invoice created

defaultError response