Business

Retrieve a certification Invoice

GET

/v1/business/certification/invoices/{invoiceId}

const url = 'https://api.timbro.do/v1/business/certification/invoices/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.timbro.do/v1/business/certification/invoices/example \
  --header 'Authorization: Bearer <token>'

Authentication

secretKey
adminKey

Parameters

Path parameters

invoiceId

required

string

>= 1 characters

Responses

200

Default Response

application/json

Response fields and codes

discriminator: status

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

Allowed values: barrel bag jar bundle bottle box cigarette_pack centimetre cylinder set container day dozen bale gallon degree gram bulk hour crate kilogram kilowatt_hour pound litre lot metre square_metre cubic_metre million_btu minute package pair foot piece roll envelope second tank ton tube yard square_yard unit element thousand sack tin display drum ration quintal gross_register_tonnage square_foot passenger inch boat_berth_stay tray hectare millilitre milligram ounce troy_ounce

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: rejected

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

stage

required

string

Allowed values: admitted signed consumerSummarySigned submitted authorityProcessing

status

required

string

Allowed values: processing

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: verifying

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: accepted

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: acceptedWithObservations

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: authorityRejected

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: operatorRequired

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

An Organization administrator closed the Invoice before DGII received it. Its e-NCF stays retained for cancellation, and a replacement issues the sale under a new e-NCF.

object

acceptedAt

required

string | null format: date-time

additionalInformation

required

null
InvoiceAdditionalInformationResource

null

buyer

required

null
InvoiceBuyerIdentity

null

buyerDeliveryReadiness

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

corrections

required

Array<object>

object

affectedDocument

required

object

attribution

required

discriminator: kind

object
object

object

invoiceId

required

string format: uuid

kind

required

string

Allowed values: internalOperation

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

fiscalNumber

required

string

issuedOn

required

string

issuerTaxId

required

string

createdAt

required

string format: date-time

modificationCode

required

string

reason

required

string

relationshipKind

required

Stable semantic kind for a cross-document fiscal relationship.

string

Allowed values: modification

createdAt

required

string format: date-time

currency

required

string

Allowed values: DOP BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

diagnostics

required

Array<object>

<= 20 items

object

code

required

string

message

required

string

path

required

string

environment

required

DGII execution environment selected before lifecycle admission.

string

Allowed values: sandbox certification production

exchangeRate

required

null
InvoiceExchangeRate

null

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

files

required

object

pdf

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

xml

required

discriminator: status

object

status

required

string

Allowed values: notApplicable

fiscalIdentity

required

object

eNcf

required

string

/^E(31|32|33|34|41|43|44|45|46|47)[0-9]{10}$/

signature

required

null
InvoiceSignature

null

The signature facts DGII requires on every printed e-CF, read from the signed document.

Print the buyer’s copy after DGII accepts the Invoice; DGII sequences the printed e-CF after its validation result, including the Type 32 below DOP 250,000 it validates by RFCE summary.

object

securityCode

required

The first six characters of the signature value, printed below the QR code.

string

/^[A-Za-z0-9+/]{6}$/

signedAt

required

The exact FechaHoraFirma instant as RFC 3339 in DGII’s fixed GMT-4, so its date and time read as the printed dd-MM-aaaa HH:mm:ss.

string

/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}-04:00$/

verificationUrl

required

The DGII consultation URL the printed QR code encodes.

string format: uri

/^https://(ecf|fc)\.dgii\.gov\.do//

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

foreignPayment

required

null
InvoiceForeignPaymentResource

null

governmentEligibility

required

null
InvoiceGovernmentEligibility

null

required

string format: uuid

invoiceReference

required

string

issuerTaxId

required

string

/^[0-9]{9}([0-9]{2})?$/

items

required

Array<object> | null

object

additionalDescription

required

null
string

null

additionalTaxCodes

required

Array<string>

adjustments

required

null
InvoiceLinePriceAdjustmentsResource

null

description

required

string

required

string

itemCodes

required

Array<object>

object

code

required

string

>= 1 characters <= 35 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

typeCode

required

string

>= 1 characters <= 14 characters /^(?=.*[^\p{White_Space}])(?!.*[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF])[\s\S]+$/

kind

required

Whether a Source line describes a good or a service.

string

Allowed values: good service

legalTip

required

boolean

quantity

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

tax

required

discriminator: kind

object

included

required

boolean

kind

required

string

Allowed values: itbis_18

unit

required

A DGII e-CF unit of measure: a readable lowercase name on the Source and Invoice wire, the official numeric catalog code in fiscal documents.

string

unitPrice

required

string

/^[0-9]{1,16}(\.[0-9]{1,4})?$/

withholding

required

null
InvoiceItemWithholding

null

latestEvent

required

null
InvoiceLatestEvent

null

originalInvoiceId

required

string | null format: uuid

paymentTerms

required

null
InvoicePaymentTermsResource

null

discriminator: type

object

allocations

required

Array<object>

<= 7 items

One payment method and its amount, in DOP whatever the Invoice’s currency. The allocations sum to the DOP total.

object

amount

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,16}(\.[0-9]{1,2})?$/

method

required

Named payment methods whose official codes are owned by fiscal-document.

string

Allowed values: cash bank_transfer card credit_sale gift_certificate barter credit_note other

type

required

string

Allowed values: immediate

paymentAccount

object

accountNumber

required

null
string

null

bankName

required

null
string

null

referenceInformation

required

null
InvoiceReferenceInformationResource

null

replacesInvoiceId

required

The predecessor retained when this Invoice replaced a rejected or closed Source operation.

string | null format: uuid

source

required

object

contentSha256

required

string

/^[0-9a-f]{64}$/

required

string

version

required

string

status

required

string

Allowed values: closed

supplier

required

null
InvoiceSupplierResource

null

totals

required

null
InvoiceTotals

null

object

foreign

required

null
InvoiceForeignTotals

null

An Invoice’s totals in the currency it is priced in. total equals the price total.

object

currency

required

string

Allowed values: BRL CAD CHF CHY XDR DKK EUR GBP JPY NOK SCP SEK USD VEF HTG MXN COP

exchangeRate

required

The exchange rate of record: DOP per one unit of the Invoice’s currency.

object

rate

required

string

/^(?=[0-9.]*[1-9])[0-9]{1,3}(\.[0-9]{1,4})?$/

net

required

string

/^[0-9]+\.[0-9]{2}$/

tax

required

string

/^[0-9]+\.[0-9]{2}$/

total

required

string

/^[0-9]+\.[0-9]{2}$/

net

required

string

nonBillable

required

string

tax

required

string

total

required

string

type

required

string

Allowed values: E31 E32 E33 E34 E41 E43 E44 E45 E46 E47

updatedAt

required

string format: date-time

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

400

The request could not be understood.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "The request could not be understood.",
  "status": 400,
  "code": "parameter_invalid",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: parameter_invalid custody_certificate_malformed custody_signature_algorithm_unsupported custody_certificate_trust_profile_unsupported custody_certificate_chain_untrusted custody_certificate_purpose_unsupported source_provider_installation_request_invalid missing_idempotency_key invalid_idempotency_key malformed_json invalid_request invoice_original_invalid invalid_collection_query invalid_collection_cursor invalid_replay_scope webhook_destination_not_allowed commercial_response_motive_invalid

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 400

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

Allowed values: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

401

The credential is missing, malformed, or no longer valid.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "The credential is missing, malformed, or no longer valid.",
  "status": 401,
  "code": "api_key_missing",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: api_key_missing api_key_invalid checkout_token_invalid checkout_token_expired unauthenticated invalid_login invalid_credential credential_revoked

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 401

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

403

The credential is valid but not permitted to perform this operation.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "The credential is valid but not permitted to perform this operation.",
  "status": 403,
  "code": "operation_not_permitted",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: operation_not_permitted

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 403

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

404

No endpoint serves this method and path, or no resource with this identifier exists within the caller’s scope.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "No endpoint serves this method and path, or no resource with this identifier exists within the caller's scope.",
  "status": 404,
  "code": "route_not_found",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: route_not_found webhook_endpoint_not_found webhook_event_not_found organization_not_found legal_issuer_not_found invitation_invalid certificate_custody_binding_not_found integration_not_found source_provider_authorization_not_found certification_test_run_document_not_found fiscal_operation_not_found invoice_not_found fiscal_artifact_not_found invoice_receipt_not_found fiscal_delivery_not_found received_document_not_found receiving_issuer_not_found

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 404

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

409

The request conflicts with the current state of the resource or with a previous request using the same Idempotency-Key.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "The request conflicts with the current state of the resource or with a previous request using the same Idempotency-Key.",
  "status": 409,
  "code": "webhook_endpoint_deleted",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: webhook_endpoint_deleted webhook_endpoint_suspended email_already_registered organization_slug_taken hosted_tenant_conflict legal_issuer_already_registered onboarding_legal_issuer_identity_conflict legal_issuer_profile_incomplete already_a_member certificate_custody_binding_conflict certificate_custody_certificate_not_active certificate_custody_certificate_version_not_active integration_not_connected source_provider_authorization_required source_provider_installation_disabled source_provider_installation_removed source_provider_scope_insufficient source_provider_target_access_removed source_provider_authorization_conflict source_provider_installation_callback_replayed integration_creation_conflict integration_activation_conflict integration_activation_verification_rejected certification_environment_required certification_test_set_required certification_test_run_in_progress idempotency_key_conflict fiscal_number_already_used sequence_changed sequence_source_record_conflict source_version_stale source_predecessor_conflict source_history_requires_reconciliation source_content_conflict source_action_conflict source_command_conflict invoice_reference_conflict invoice_totals_mismatch printed_representation_profile_conflict source_record_already_fiscalized source_operation_pending source_outcome_unknown authority_rejected_replacement fiscal_operation_not_in_intervention intervention_not_resumable intervention_not_closable correction_target_unsettled correction_target_closed invoice_receipt_not_ready fiscal_delivery_outcome_conflict webhook_endpoint_registration_conflict commercial_response_decision_conflict receiving_issuer_held_elsewhere production_reception_certificate_required production_reception_integration_required production_reception_already_filed

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 409

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

500

The request could not complete. Recover by the retained resource reference or retry with the same command identity.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "The request could not complete. Recover by the retained resource reference or retry with the same command identity.",
  "status": 500,
  "code": "internal_error",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: internal_error fiscal_artifact_unverified

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 500

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.

503

A required service is temporarily unavailable. Retry with the same reference or command identity.

application/problem+json

Example

{
  "type": "about:blank",
  "title": "A required service is temporarily unavailable. Retry with the same reference or command identity.",
  "status": 503,
  "code": "business_fiscal_binding_unavailable",
  "requestId": "request_000000000000000000000001"
}

Response fields and codes

RFC 9457 problem details. Every failure of this API is one of these, and each operation narrows code to the subset it can emit.

object

code

required

Stable machine-readable code. Branch on this, never on title.

string

Allowed values: business_fiscal_binding_unavailable

requestId

required

string

status

required

integer format: int32

>= 400 <= 599

Allowed value: 503

title

required

string

type

required

string

Allowed values: about:blank

Optional fields

detail

string

invoiceId

Present only when the rejected request produced a Fiscal operation.

string

issuanceBlockers

Present only when the authoritative issuance rules refused to issue.

Array<string>

problems

Present only when the rejection points at a value the request carried.

Array<object>

One stable public document problem retained for a rejected admission.

object

code

required

string

message

required

string

path

required

string

Headers

request-id

required

string

Identifies this request. Quote it when you contact support.