Emite un comprobante fiscal electrónico

POST

/api/v1/ecf

curl --request POST \
  --url https://api.novafe.example/api/v1/ecf \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "type": 31, "encf": "example", "sequenceExpiresOn": "2026-04-15", "issueDate": "2026-04-15", "incomeType": "example", "pricesIncludeTax": true, "deferredDelivery": true, "nonInvoiceableAmount": 1, "internalNumber": "example", "sellerCode": "example", "additionalInfo": { "issuer": "example", "buyer": "example" }, "buyer": { "name": "example", "rnc": "example", "foreignId": "example", "email": "example", "contact": "example", "address": "example", "municipality": "example", "province": "example", "additionalInfo": "example" }, "payment": { "condition": "example", "dueDate": "2026-04-15", "methods": [ { "type": "example", "amount": 1 } ] }, "lines": [ { "name": "example", "kind": "example", "quantity": 1, "unitPrice": 1, "itbisRate": 1, "unitOfMeasure": "example", "description": "example", "discount": 0, "surcharge": 0, "priceIncludesTax": true, "declaredAmount": 1, "codes": [ { "type": "example", "value": "example" } ], "retention": { "agent": "withholding", "itbisWithheld": 0, "isrWithheld": 0 }, "additionalTaxes": [ { "code": "example", "rate": 0, "iscEspecifico": 0, "iscAdvalorem": 0, "otros": 0 } ], "foreignCurrency": { "unitPrice": 1, "discount": 1, "surcharge": 1, "lineAmount": 1 }, "details": { "referenceQuantity": 1, "referenceUnit": "example", "subquantities": [ { "quantity": 1, "unitCode": "example" } ], "alcoholDegrees": 1, "referenceUnitPrice": 1, "manufactureDate": "2026-04-15", "expiryDate": "2026-04-15", "mining": { "netWeightKilogram": 1, "netWeightMining": 1, "affiliationType": 1, "settlement": 1 } } } ], "reference": { "modifiedNcf": "example", "modifiedNcfDate": "2026-04-15", "modificationCode": "example", "otherIssuerRnc": "example" }, "globalAdjustments": [ { "line": 1, "kind": "discount", "affectsItbisRate": 1, "amount": 0, "norm1007": false, "description": "example", "percentage": 1 } ], "foreignCurrency": { "currency": "example", "exchangeRate": 1, "totals": { "montoGravadoTotal": 1, "montoGravadoI1": 1, "montoGravadoI2": 1, "montoGravadoI3": 1, "montoExento": 1, "totalItbis": 1, "totalItbis1": 1, "totalItbis2": 1, "totalItbis3": 1, "montoTotal": 1 } }, "shipping": { "shipmentDate": "2026-04-15", "shipmentNumber": "example", "containerNumber": "example", "referenceNumber": "example", "grossWeight": 1, "netWeight": 1, "grossWeightUnit": "example", "netWeightUnit": "example", "packageCount": 1, "packageUnit": "example", "volume": 1, "volumeUnit": "example", "export": { "loadingPortName": "example", "deliveryTerms": "example", "totalFob": 1, "insurance": 1, "freight": 1, "otherCharges": 1, "totalCif": 1, "customsRegime": "example", "departurePortName": "example", "unloadingPortName": "example" } }, "transport": { "driver": "example", "transportDocument": "example", "vehicleId": "example", "plate": "example", "route": "example", "zone": "example", "deliveryNote": "example", "via": "example", "originCountry": "example", "destinationAddress": "example", "destinationCountry": "example", "carrierRnc": "example", "carrierName": "example", "voyageNumber": "example" }, "subtotals": [ { "number": 1, "description": "example", "order": 1, "montoGravadoTotal": 1, "montoGravadoI1": 1, "montoGravadoI2": 1, "montoGravadoI3": 1, "totalItbis": 1, "itbis1": 1, "itbis2": 1, "itbis3": 1, "montoImpuestoAdicional": 1, "montoExento": 1, "amount": 1, "lines": 1 } ], "pagination": [ { "number": 1, "lineFrom": 1, "lineTo": 1, "montoGravadoTotal": 1, "montoGravadoI1": 1, "montoGravadoI2": 1, "montoGravadoI3": 1, "montoExento": 1, "totalItbis": 1, "itbis1": 1, "itbis2": 1, "itbis3": 1, "montoImpuestoAdicional": 1, "iscEspecifico": 1, "otrosImpuestos": 1, "amount": 1, "nonInvoiceableAmount": 1 } ], "declaredTotals": { "montoGravadoTotal": 1, "montoExento": 1, "totalItbis": 1, "montoImpuestoAdicional": 1, "montoTotal": 1 } }'

Header Idempotency-Key obligatorio, para reintento seguro. Devuelve 201 con el comprobante; 200 si la clave o el internalNumber ya se habían usado.

Autenticación: requiere una API key (header X-API-Key) con rol admin_tenant o emisor.

Authorizations

• ApiKey

Parameters

Header Parameters

Idempotency-Key

string

Request Body^required

Payload de emisión de un e-CF (POST /api/v1/ecf). Un solo objeto discriminado por int IssueEcfCommand.Type; el servidor asigna la secuencia, arma el bloque Emisor desde el perfil del tenant, calcula los totales, firma y persiste.

object

type

required

Código DGII del tipo de e-CF: 31, 32, 33, 34, 41, 43, 44, 45, 46, 47.

integer | string format: int32

default: 31 /^-?(?:0|[1-9]\d*)$/

encf

E-NCF de 13 caracteres. Solo con sequences.mode = external (y obligatorio ahí); con managed se rechaza, NovaFE asigna el suyo.

null | string

sequenceExpiresOn

<FechaVencimientoSecuencia> del e-NCF. Con sequences.mode = external es obligatorio en los tipos que llevan vencimiento (todos menos 32 y 34) y no aplica en esos dos; en managed se rechaza.

null | string format: date

issueDate

Fecha de emisión (calendario dominicano). Default: hoy.

null | string format: date

incomeType

<TipoIngresos> — “01”…“06”. Obligatorio en 31/32/33/34/44/45/46.

null | string

pricesIncludeTax

true si los precios de las líneas ya traen el ITBIS incluido.

boolean

deferredDelivery

<IndicadorEnvioDiferido> — solo contribuyentes autorizados.

boolean

nonInvoiceableAmount

<MontoNoFacturable> — reembolsos, propina voluntaria. Puede ser negativo.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

internalNumber

<NumeroFacturaInterna> — clave de dedup de negocio.

null | string

sellerCode

<CodigoVendedor>.

null | string

additionalInfo

One of:

null

null

object

Texto libre para la Representación Impresa.

object

issuer

null | string

buyer

null | string

buyer

One of:

null

null

object

Bloque <Comprador>. Rnc y ForeignId son excluyentes.

object

name

null | string

rnc

null | string

foreignId

null | string

email

null | string

contact

null | string

address

null | string

municipality

null | string

province

null | string

additionalInfo

null | string

payment

Bloque de pago del encabezado.

object

condition

null | string

dueDate

null | string format: date

methods

Array<object> | null

Una forma de pago. Type y Amount son nullable para distinguir “no vino” de un valor: el validador exige ambos y la API nunca rellena uno por su cuenta.

object

type

required

null | string

amount

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

required

Array<object>

Una línea de <DetallesItems>.

object

name

required

null | string

kind

null | string

quantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbisRate

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

unitOfMeasure

null | string

description

null | string

discount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

priceIncludesTax

null | boolean

declaredAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

codes

Array<object> | null

object

type

required

string

value

required

string

retention

One of:

null

null

object

Área <Retencion> de la línea (tipos 41 y 47). Los montos los calcula el cliente.

object

agent

string

default: withholding

itbisWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

isrWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

additionalTaxes

Array<object> | null

Desglose de impuestos adicionales por código de la Tabla I (001–039). Todos los montos los trae el cliente ya calculados. iscEspecifico (monto fijo por volumen: alcoholes 006-018, cigarrillos 019-022) integra la base imponible del ITBIS de esa línea; iscAdvalorem y otros (Propina, CDT, ISC de servicios, Primera Placa…) van “por encima”, sin tocar la base.

object

code

required

string

rate

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscAdvalorem

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otros

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

<OtraMonedaDetalle> — precio y montos de la línea en divisa (passthrough).

object

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

discount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lineAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

details

One of:

null

null

object

Campos opcionales del <Item> — passthrough. La derivación del ISC desde alcoholDegrees/referenceQuantity es un slice posterior; hoy el cliente trae el monto final del ISC en additionalTaxes (el ISC específico ahí sí integra la base del ITBIS — ver EcfAdditionalTaxPayload).

object

referenceQuantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnit

null | string

subquantities

Array<object> | null

object

quantity

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitCode

required

string

alcoholDegrees

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

manufactureDate

null | string format: date

expiryDate

null | string format: date

mining

One of:

null

null

object

<Mineria> — datos de liquidación minera (solo tipos 32/33/34/46).

object

netWeightKilogram

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeightMining

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

affiliationType

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

settlement

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

reference

One of:

null

null

object

Sección <InformacionReferencia> — Notas de Crédito/Débito y reemplazos.

object

modifiedNcf

required

string

modifiedNcfDate

required

string format: date

modificationCode

null | string

otherIssuerRnc

null | string

globalAdjustments

Array<object> | null

Un descuento o recargo global (Sección D).

object

line

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

kind

string

default: discount

affectsItbisRate

integer | string format: int32

default: 1 /^-?(?:0|[1-9]\d*)$/

amount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

norm1007

boolean

description

null | string

percentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

Facturación en divisa (<OtraMoneda>). El cliente trae los montos ya convertidos.

object

currency

required

string

exchangeRate

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totals

required

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

shipping

One of:

null

null

object

Datos de embarque (<InformacionesAdicionales>). Passthrough.

object

shipmentDate

null | string format: date

shipmentNumber

null | string

containerNumber

null | string

referenceNumber

null | string

grossWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

grossWeightUnit

null | string

netWeightUnit

null | string

packageCount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

packageUnit

null | string

volume

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

volumeUnit

null | string

export

One of:

null

null

object

Datos de exportación (solo tipo 46).

object

loadingPortName

null | string

deliveryTerms

null | string

totalFob

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

insurance

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

freight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otherCharges

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalCif

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

customsRegime

null | string

departurePortName

null | string

unloadingPortName

null | string

transport

One of:

null

null

object

Datos de transporte (<Transporte>). Passthrough.

object

driver

null | string

transportDocument

null | string

vehicleId

null | string

plate

null | string

route

null | string

zone

null | string

deliveryNote

null | string

via

null | string

originCountry

null | string

destinationAddress

null | string

destinationCountry

null | string

carrierRnc

null | string

carrierName

null | string

voyageNumber

null | string

subtotals

Array<object> | null

Subtotal informativo para la RI (Sección C). No afecta la base imponible.

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

description

null | string

order

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pagination

Array<object> | null

Página de la RI (<Paginacion>).

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineFrom

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineTo

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otrosImpuestos

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

nonInvoiceableAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

declaredTotals

One of:

null

null

object

Totales declarados por el cliente (chequeo de tolerancia; nunca bloquea).

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

Payload de emisión de un e-CF (POST /api/v1/ecf). Un solo objeto discriminado por int IssueEcfCommand.Type; el servidor asigna la secuencia, arma el bloque Emisor desde el perfil del tenant, calcula los totales, firma y persiste.

object

type

required

Código DGII del tipo de e-CF: 31, 32, 33, 34, 41, 43, 44, 45, 46, 47.

integer | string format: int32

default: 31 /^-?(?:0|[1-9]\d*)$/

encf

E-NCF de 13 caracteres. Solo con sequences.mode = external (y obligatorio ahí); con managed se rechaza, NovaFE asigna el suyo.

null | string

sequenceExpiresOn

<FechaVencimientoSecuencia> del e-NCF. Con sequences.mode = external es obligatorio en los tipos que llevan vencimiento (todos menos 32 y 34) y no aplica en esos dos; en managed se rechaza.

null | string format: date

issueDate

Fecha de emisión (calendario dominicano). Default: hoy.

null | string format: date

incomeType

<TipoIngresos> — “01”…“06”. Obligatorio en 31/32/33/34/44/45/46.

null | string

pricesIncludeTax

true si los precios de las líneas ya traen el ITBIS incluido.

boolean

deferredDelivery

<IndicadorEnvioDiferido> — solo contribuyentes autorizados.

boolean

nonInvoiceableAmount

<MontoNoFacturable> — reembolsos, propina voluntaria. Puede ser negativo.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

internalNumber

<NumeroFacturaInterna> — clave de dedup de negocio.

null | string

sellerCode

<CodigoVendedor>.

null | string

additionalInfo

One of:

null

null

object

Texto libre para la Representación Impresa.

object

issuer

null | string

buyer

null | string

buyer

One of:

null

null

object

Bloque <Comprador>. Rnc y ForeignId son excluyentes.

object

name

null | string

rnc

null | string

foreignId

null | string

email

null | string

contact

null | string

address

null | string

municipality

null | string

province

null | string

additionalInfo

null | string

payment

Bloque de pago del encabezado.

object

condition

null | string

dueDate

null | string format: date

methods

Array<object> | null

Una forma de pago. Type y Amount son nullable para distinguir “no vino” de un valor: el validador exige ambos y la API nunca rellena uno por su cuenta.

object

type

required

null | string

amount

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

required

Array<object>

Una línea de <DetallesItems>.

object

name

required

null | string

kind

null | string

quantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbisRate

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

unitOfMeasure

null | string

description

null | string

discount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

priceIncludesTax

null | boolean

declaredAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

codes

Array<object> | null

object

type

required

string

value

required

string

retention

One of:

null

null

object

Área <Retencion> de la línea (tipos 41 y 47). Los montos los calcula el cliente.

object

agent

string

default: withholding

itbisWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

isrWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

additionalTaxes

Array<object> | null

Desglose de impuestos adicionales por código de la Tabla I (001–039). Todos los montos los trae el cliente ya calculados. iscEspecifico (monto fijo por volumen: alcoholes 006-018, cigarrillos 019-022) integra la base imponible del ITBIS de esa línea; iscAdvalorem y otros (Propina, CDT, ISC de servicios, Primera Placa…) van “por encima”, sin tocar la base.

object

code

required

string

rate

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscAdvalorem

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otros

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

<OtraMonedaDetalle> — precio y montos de la línea en divisa (passthrough).

object

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

discount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lineAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

details

One of:

null

null

object

Campos opcionales del <Item> — passthrough. La derivación del ISC desde alcoholDegrees/referenceQuantity es un slice posterior; hoy el cliente trae el monto final del ISC en additionalTaxes (el ISC específico ahí sí integra la base del ITBIS — ver EcfAdditionalTaxPayload).

object

referenceQuantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnit

null | string

subquantities

Array<object> | null

object

quantity

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitCode

required

string

alcoholDegrees

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

manufactureDate

null | string format: date

expiryDate

null | string format: date

mining

One of:

null

null

object

<Mineria> — datos de liquidación minera (solo tipos 32/33/34/46).

object

netWeightKilogram

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeightMining

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

affiliationType

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

settlement

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

reference

One of:

null

null

object

Sección <InformacionReferencia> — Notas de Crédito/Débito y reemplazos.

object

modifiedNcf

required

string

modifiedNcfDate

required

string format: date

modificationCode

null | string

otherIssuerRnc

null | string

globalAdjustments

Array<object> | null

Un descuento o recargo global (Sección D).

object

line

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

kind

string

default: discount

affectsItbisRate

integer | string format: int32

default: 1 /^-?(?:0|[1-9]\d*)$/

amount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

norm1007

boolean

description

null | string

percentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

Facturación en divisa (<OtraMoneda>). El cliente trae los montos ya convertidos.

object

currency

required

string

exchangeRate

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totals

required

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

shipping

One of:

null

null

object

Datos de embarque (<InformacionesAdicionales>). Passthrough.

object

shipmentDate

null | string format: date

shipmentNumber

null | string

containerNumber

null | string

referenceNumber

null | string

grossWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

grossWeightUnit

null | string

netWeightUnit

null | string

packageCount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

packageUnit

null | string

volume

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

volumeUnit

null | string

export

One of:

null

null

object

Datos de exportación (solo tipo 46).

object

loadingPortName

null | string

deliveryTerms

null | string

totalFob

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

insurance

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

freight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otherCharges

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalCif

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

customsRegime

null | string

departurePortName

null | string

unloadingPortName

null | string

transport

One of:

null

null

object

Datos de transporte (<Transporte>). Passthrough.

object

driver

null | string

transportDocument

null | string

vehicleId

null | string

plate

null | string

route

null | string

zone

null | string

deliveryNote

null | string

via

null | string

originCountry

null | string

destinationAddress

null | string

destinationCountry

null | string

carrierRnc

null | string

carrierName

null | string

voyageNumber

null | string

subtotals

Array<object> | null

Subtotal informativo para la RI (Sección C). No afecta la base imponible.

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

description

null | string

order

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pagination

Array<object> | null

Página de la RI (<Paginacion>).

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineFrom

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineTo

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otrosImpuestos

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

nonInvoiceableAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

declaredTotals

One of:

null

null

object

Totales declarados por el cliente (chequeo de tolerancia; nunca bloquea).

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

Payload de emisión de un e-CF (POST /api/v1/ecf). Un solo objeto discriminado por int IssueEcfCommand.Type; el servidor asigna la secuencia, arma el bloque Emisor desde el perfil del tenant, calcula los totales, firma y persiste.

object

type

required

Código DGII del tipo de e-CF: 31, 32, 33, 34, 41, 43, 44, 45, 46, 47.

integer | string format: int32

default: 31 /^-?(?:0|[1-9]\d*)$/

encf

E-NCF de 13 caracteres. Solo con sequences.mode = external (y obligatorio ahí); con managed se rechaza, NovaFE asigna el suyo.

null | string

sequenceExpiresOn

<FechaVencimientoSecuencia> del e-NCF. Con sequences.mode = external es obligatorio en los tipos que llevan vencimiento (todos menos 32 y 34) y no aplica en esos dos; en managed se rechaza.

null | string format: date

issueDate

Fecha de emisión (calendario dominicano). Default: hoy.

null | string format: date

incomeType

<TipoIngresos> — “01”…“06”. Obligatorio en 31/32/33/34/44/45/46.

null | string

pricesIncludeTax

true si los precios de las líneas ya traen el ITBIS incluido.

boolean

deferredDelivery

<IndicadorEnvioDiferido> — solo contribuyentes autorizados.

boolean

nonInvoiceableAmount

<MontoNoFacturable> — reembolsos, propina voluntaria. Puede ser negativo.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

internalNumber

<NumeroFacturaInterna> — clave de dedup de negocio.

null | string

sellerCode

<CodigoVendedor>.

null | string

additionalInfo

One of:

null

null

object

Texto libre para la Representación Impresa.

object

issuer

null | string

buyer

null | string

buyer

One of:

null

null

object

Bloque <Comprador>. Rnc y ForeignId son excluyentes.

object

name

null | string

rnc

null | string

foreignId

null | string

email

null | string

contact

null | string

address

null | string

municipality

null | string

province

null | string

additionalInfo

null | string

payment

Bloque de pago del encabezado.

object

condition

null | string

dueDate

null | string format: date

methods

Array<object> | null

Una forma de pago. Type y Amount son nullable para distinguir “no vino” de un valor: el validador exige ambos y la API nunca rellena uno por su cuenta.

object

type

required

null | string

amount

required

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

required

Array<object>

Una línea de <DetallesItems>.

object

name

required

null | string

kind

null | string

quantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbisRate

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

unitOfMeasure

null | string

description

null | string

discount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

priceIncludesTax

null | boolean

declaredAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

codes

Array<object> | null

object

type

required

string

value

required

string

retention

One of:

null

null

object

Área <Retencion> de la línea (tipos 41 y 47). Los montos los calcula el cliente.

object

agent

string

default: withholding

itbisWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

isrWithheld

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

additionalTaxes

Array<object> | null

Desglose de impuestos adicionales por código de la Tabla I (001–039). Todos los montos los trae el cliente ya calculados. iscEspecifico (monto fijo por volumen: alcoholes 006-018, cigarrillos 019-022) integra la base imponible del ITBIS de esa línea; iscAdvalorem y otros (Propina, CDT, ISC de servicios, Primera Placa…) van “por encima”, sin tocar la base.

object

code

required

string

rate

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscAdvalorem

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otros

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

<OtraMonedaDetalle> — precio y montos de la línea en divisa (passthrough).

object

unitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

discount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

surcharge

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lineAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

details

One of:

null

null

object

Campos opcionales del <Item> — passthrough. La derivación del ISC desde alcoholDegrees/referenceQuantity es un slice posterior; hoy el cliente trae el monto final del ISC en additionalTaxes (el ISC específico ahí sí integra la base del ITBIS — ver EcfAdditionalTaxPayload).

object

referenceQuantity

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnit

null | string

subquantities

Array<object> | null

object

quantity

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

unitCode

required

string

alcoholDegrees

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

referenceUnitPrice

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

manufactureDate

null | string format: date

expiryDate

null | string format: date

mining

One of:

null

null

object

<Mineria> — datos de liquidación minera (solo tipos 32/33/34/46).

object

netWeightKilogram

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeightMining

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

affiliationType

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

settlement

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

reference

One of:

null

null

object

Sección <InformacionReferencia> — Notas de Crédito/Débito y reemplazos.

object

modifiedNcf

required

string

modifiedNcfDate

required

string format: date

modificationCode

null | string

otherIssuerRnc

null | string

globalAdjustments

Array<object> | null

Un descuento o recargo global (Sección D).

object

line

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

kind

string

default: discount

affectsItbisRate

integer | string format: int32

default: 1 /^-?(?:0|[1-9]\d*)$/

amount

number | string format: double

0 /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

norm1007

boolean

description

null | string

percentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

foreignCurrency

One of:

null

null

object

Facturación en divisa (<OtraMoneda>). El cliente trae los montos ya convertidos.

object

currency

required

string

exchangeRate

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totals

required

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

shipping

One of:

null

null

object

Datos de embarque (<InformacionesAdicionales>). Passthrough.

object

shipmentDate

null | string format: date

shipmentNumber

null | string

containerNumber

null | string

referenceNumber

null | string

grossWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

netWeight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

grossWeightUnit

null | string

netWeightUnit

null | string

packageCount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

packageUnit

null | string

volume

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

volumeUnit

null | string

export

One of:

null

null

object

Datos de exportación (solo tipo 46).

object

loadingPortName

null | string

deliveryTerms

null | string

totalFob

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

insurance

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

freight

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otherCharges

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalCif

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

customsRegime

null | string

departurePortName

null | string

unloadingPortName

null | string

transport

One of:

null

null

object

Datos de transporte (<Transporte>). Passthrough.

object

driver

null | string

transportDocument

null | string

vehicleId

null | string

plate

null | string

route

null | string

zone

null | string

deliveryNote

null | string

via

null | string

originCountry

null | string

destinationAddress

null | string

destinationCountry

null | string

carrierRnc

null | string

carrierName

null | string

voyageNumber

null | string

subtotals

Array<object> | null

Subtotal informativo para la RI (Sección C). No afecta la base imponible.

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

description

null | string

order

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

lines

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

pagination

Array<object> | null

Página de la RI (<Paginacion>).

object

number

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineFrom

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

lineTo

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoGravadoI3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis1

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis2

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

itbis3

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

iscEspecifico

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

otrosImpuestos

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

amount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

nonInvoiceableAmount

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

declaredTotals

One of:

null

null

object

Totales declarados por el cliente (chequeo de tolerancia; nunca bloquea).

object

montoGravadoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoExento

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

totalItbis

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoImpuestoAdicional

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

montoTotal

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

Responses

200

OK

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "encf": "example",
  "type": 1,
  "environment": "example",
  "sequenceExpiresOn": "2026-04-15",
  "issueDate": "2026-04-15",
  "issuedAt": "2026-04-15T12:00:00Z",
  "signedAt": "2026-04-15T12:00:00Z",
  "securityCode": "example",
  "qrUrl": "example",
  "submitsRfce": true,
  "internalNumber": "example",
  "toleranceWarning": "example",
  "signedDuringContingency": true,
  "montoTotal": 1,
  "buyerRnc": "example",
  "buyerName": "example",
  "documentHash": "example",
  "dgii": {
    "trackId": "example",
    "status": "example",
    "statusCode": 1,
    "sequenceUsed": true,
    "messages": [
      {
        "code": 1,
        "value": "example"
      }
    ],
    "submittedAt": "2026-04-15T12:00:00Z",
    "receivedAt": "2026-04-15T12:00:00Z",
    "processedAt": "2026-04-15T12:00:00Z"
  },
  "retry": {
    "count": 1,
    "max": 1,
    "nextAttemptAt": "2026-04-15T12:00:00Z"
  },
  "links": {
    "self": "example",
    "xml": "example",
    "rfceXml": "example",
    "representation": "example"
  }
}

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "encf": "example",
  "type": 1,
  "environment": "example",
  "sequenceExpiresOn": "2026-04-15",
  "issueDate": "2026-04-15",
  "issuedAt": "2026-04-15T12:00:00Z",
  "signedAt": "2026-04-15T12:00:00Z",
  "securityCode": "example",
  "qrUrl": "example",
  "submitsRfce": true,
  "internalNumber": "example",
  "toleranceWarning": "example",
  "signedDuringContingency": true,
  "montoTotal": 1,
  "buyerRnc": "example",
  "buyerName": "example",
  "documentHash": "example",
  "dgii": {
    "trackId": "example",
    "status": "example",
    "statusCode": 1,
    "sequenceUsed": true,
    "messages": [
      {
        "code": 1,
        "value": "example"
      }
    ],
    "submittedAt": "2026-04-15T12:00:00Z",
    "receivedAt": "2026-04-15T12:00:00Z",
    "processedAt": "2026-04-15T12:00:00Z"
  },
  "retry": {
    "count": 1,
    "max": 1,
    "nextAttemptAt": "2026-04-15T12:00:00Z"
  },
  "links": {
    "self": "example",
    "xml": "example",
    "rfceXml": "example",
    "representation": "example"
  }
}

201

Created

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "encf": "example",
  "type": 1,
  "environment": "example",
  "sequenceExpiresOn": "2026-04-15",
  "issueDate": "2026-04-15",
  "issuedAt": "2026-04-15T12:00:00Z",
  "signedAt": "2026-04-15T12:00:00Z",
  "securityCode": "example",
  "qrUrl": "example",
  "submitsRfce": true,
  "internalNumber": "example",
  "toleranceWarning": "example",
  "signedDuringContingency": true,
  "montoTotal": 1,
  "buyerRnc": "example",
  "buyerName": "example",
  "documentHash": "example",
  "dgii": {
    "trackId": "example",
    "status": "example",
    "statusCode": 1,
    "sequenceUsed": true,
    "messages": [
      {
        "code": 1,
        "value": "example"
      }
    ],
    "submittedAt": "2026-04-15T12:00:00Z",
    "receivedAt": "2026-04-15T12:00:00Z",
    "processedAt": "2026-04-15T12:00:00Z"
  },
  "retry": {
    "count": 1,
    "max": 1,
    "nextAttemptAt": "2026-04-15T12:00:00Z"
  },
  "links": {
    "self": "example",
    "xml": "example",
    "rfceXml": "example",
    "representation": "example"
  }
}

Vista de un comprobante emitido (respuesta de POST /ecf y GET /ecf/{id}). Trae la identidad fiscal, el resumen comercial (comprador, monto total — igual que EcfSummaryDto) y el resultado del intercambio con la DGII (EcfDgiiExchange? EcfDto.Dgii). El desglose por línea y el resto del detalle comercial siguen viviendo solo en el XML firmado (GET /ecf/{id}/xml).

object

id

required

string format: uuid

status

required

string

encf

required

string

type

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

environment

required

string

sequenceExpiresOn

required

null | string format: date

issueDate

required

string format: date

issuedAt

required

string format: date-time

signedAt

required

string format: date-time

securityCode

required

string

qrUrl

required

string

submitsRfce

required

boolean

internalNumber

required

null | string

toleranceWarning

required

null | string

signedDuringContingency

required

boolean

montoTotal

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

buyerRnc

required

null | string

buyerName

required

null | string

documentHash

required

string

dgii

Lo que pasó con la DGII: trackId, estado (texto y código), mensajes, secuenciaUtilizada y los instantes de envío, recepción y resolución. null mientras el comprobante no se haya enviado.

object

trackId

required

Identificador que la DGII asigna al recibir el comprobante.

null | string

status

required

El estado textual de la DGII (“Aceptado”, “Rechazado”, “En Proceso”…); en el idioma en que lo manda ella.

null | string

statusCode

required

Código de estado de la DGII: 1 aceptado · 2 rechazado · 3 en proceso · 4 aceptado condicional.

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

sequenceUsed

required

secuenciaUtilizada de la DGII: false = el e-NCF no se consumió (firma/XML inválidos); true o ausente = consumido.

null | boolean

messages

required

Observaciones o motivo de rechazo que devolvió la DGII.

Array<object>

object

code

required

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

value

required

string

submittedAt

required

Instante en que la DGII confirmó la recepción (hay string? EcfDgiiExchange.TrackId).

null | string format: date-time

receivedAt

required

La fechaRecepcion que informó la DGII; ausente si no la dio (p. ej. RFCE).

null | string format: date-time

processedAt

required

Instante en que la DGII dio un resultado definitivo.

null | string format: date-time

retry

El reintento automático en curso o ya hecho: cuántas veces NovaFE reenvió el mismo comprobante tras un rechazo transitorio de la DGII, el tope, y cuándo es el próximo intento. null mientras no haya habido ningún reintento.

object

count

required

Reenvíos automáticos que NovaFE ya hizo de este comprobante.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

max

required

Tope de reenvíos automáticos. Al agotarse, el rechazo queda firme.

integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

nextAttemptAt

required

Cuándo es el próximo intento; null si no hay uno pendiente.

null | string format: date-time

links

Enlaces a los recursos relacionados del comprobante.

object

self

required

El comprobante y su estado.

string

xml

required

El XML firmado (<ECF>).

string

rfceXml

required

El resumen firmado (<RFCE>); solo cuando submitsRfce.

null | string

representation

required

La Representación Impresa en PDF.

string

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "encf": "example",
  "type": 1,
  "environment": "example",
  "sequenceExpiresOn": "2026-04-15",
  "issueDate": "2026-04-15",
  "issuedAt": "2026-04-15T12:00:00Z",
  "signedAt": "2026-04-15T12:00:00Z",
  "securityCode": "example",
  "qrUrl": "example",
  "submitsRfce": true,
  "internalNumber": "example",
  "toleranceWarning": "example",
  "signedDuringContingency": true,
  "montoTotal": 1,
  "buyerRnc": "example",
  "buyerName": "example",
  "documentHash": "example",
  "dgii": {
    "trackId": "example",
    "status": "example",
    "statusCode": 1,
    "sequenceUsed": true,
    "messages": [
      {
        "code": 1,
        "value": "example"
      }
    ],
    "submittedAt": "2026-04-15T12:00:00Z",
    "receivedAt": "2026-04-15T12:00:00Z",
    "processedAt": "2026-04-15T12:00:00Z"
  },
  "retry": {
    "count": 1,
    "max": 1,
    "nextAttemptAt": "2026-04-15T12:00:00Z"
  },
  "links": {
    "self": "example",
    "xml": "example",
    "rfceXml": "example",
    "representation": "example"
  }
}

400

Bad Request

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

errors

object

key

additional properties

Array<string>

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

errors

object

key

additional properties

Array<string>

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

errors

object

key

additional properties

Array<string>

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}

409

Conflict

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

503

Service Unavailable

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}