Sign in

v1

latestOpenAPI 3.0.02026-07-2436163302.7 KB

Backfill a reported transaction

Submit a transaction that was previously reported to the tax authority with a different eInvocing solution. Otherwise called "backfill": the transaction will be available for reference in our systems

post/v1/transactions/backfill/reported

Request body

country_codestring required

ISO 3166-1 alpha-2 uppercase country code the transaction is taking place in.

Validations:

  • Required property
  • Country code must be uppercase ISO 3166-1 alpha-2.
directionstring

Document representing a transaction can be sent or received. Allows businesses to report both inbound and outbound transactions for VAT deduction purposes. Default: SENT.

Validations:

  • Maximum length: 20
  • Values allowed are (ignore case): SENT, RECEIVED
issue_datestring

The date when the transaction was issued by an external application.

Validations:

  • Must be an RFC3339 format date
tax_authority_id_1string

Main transaction identifier returned by the tax authorities. e.g., JIR in Croatia.

Validations:

  • Maximum length: 150
tax_authority_id_2string

Secondary transaction identifier returned by the tax authorities.

Validations:

  • Maximum length: 150
transaction_datestring required

RFC3339 datetime string representing the point in time when transaction is executed.

Validations:

  • Required property
  • Must be an RFC3339 format date
transaction_idstring required

Unique external transaction identifier provided by the customer. Used as idempotency key. e.g., MY_EXTERNAL_IDENTIFIER_0001.

Validations:

  • Maximum length: 150
  • Required property
transaction_numberstring

Unique and usually sequential identifier of a transaction displayed on the document and reported to tax authorities. e.g., invoice number for debit scenario or credit note number for credit scenario. e.g., IE00000001

Validations:

  • Maximum length: 50

Response

Accepted - transaction was successfully submitted for processing.

messagestring

Information about the failure reason in case the request was unsuccessful.

operation_idstring

Auto-generated unique identifier of a transaction operation returned upon async operation request.

transaction_idstring

The unique external transaction identifier provided with the initial request.