Create invoice with the party and items information

post

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

party_tin

string

The tax identification number or company incorporation number(if the party does not yet have a TIN) of the buyer of the goods or services

party_name

string

The taxpayer name of the buyer of the goods or services. It must be provided for invoices that have the party_tin provided

party_email

string

The email address of the buyer of the goods or services. If it is not provided and the party_tin is provided, we will use [email protected] as the party's email address

party_address

object

The address of the buyer of the goods or services. If not provided and the party_tin is provided, we will use a default address

payee_party_tin

string

The tax identification number or company incorporation number(if the party does not yet have a TIN) of the party to whom the payment goes to; if it goes to someone else

payee_party_name

string

The taxpayer name of the party to whom the payment goes to; if it goes to someone else. It must be provided for invoices that have the payee_party_tin provided

payee_party_email

string

The email address of the party to whom the payment goes to; if it goes to someone else. If it is not provided and the payee_party_tin is provided, we will use [email protected] as the party's email address

payee_party_address

object

The address of the party to whom the payment goes to; if it goes to someone else. If not provided and the payee_party_tin is provided, we will use a default address

bill_party_tin

string

The tax identification number or company incorporation number(if the party does not yet have a TIN) of the party to whom the payment goes to; if it goes to someone else

bill_party_name

string

The taxpayer name of the party to whom the payment goes to; if it goes to someone else. It must be provided for invoices that have the bill_party_tin provided

bill_party_email

string

The email address of the party to whom the payment goes to; if it goes to someone else. If it is not provided and the bill_party_tin is provided, we will use [email protected] as the party's email address

bill_party_address

object

The address of the party to whom the payment goes to; if it goes to someone else. If not provided and the bill_party_tin is provided, we will use a default address

ship_party_tin

string

The tax identification number or company incorporation number(if the party does not yet have a TIN) of the party to whom the payment goes to; if it goes to someone else

ship_party_name

string

The taxpayer name of the party to whom the payment goes to; if it goes to someone else. It must be provided for invoices that have the ship_party_tin provided

ship_party_email

string

The email address of the party to whom the payment goes to; if it goes to someone else. If it is not provided and the ship_party_tin is provided, we will use [email protected] as the party's email address

ship_party_address

object

The address of the party to whom the payment goes to; if it goes to someone else. If not provided and the ship_party_tin is provided, we will use a default address

tax_representative_party_tin

string

The tax identification number or company incorporation number(if the party does not yet have a TIN) of the tax agent handling invoicing and compliance for the business if there is one

tax_representative_party_name

string

The taxpayer name of the tax agent handling invoicing and compliance for the business. It must be provided for invoices that have the tax_representative_party_tin provided

tax_representative_party_email

string

The email address of the tax agent handling invoicing and compliance for the business. If it is not provided and the tax_representative_party_tin is provided, we will use [email protected] as the party's email address

tax_representative_party_address

object

The address of the tax agent handling invoicing and compliance for the business. If not provided and the tax_representative_party_tin is provided, we will use a default address

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