EcfConsulta un comprobante emitido

Consulta un comprobante emitido

GET

/api/v1/ecf/{id}

const url = 'https://api.novafe.example/api/v1/ecf/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

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.novafe.example/api/v1/ecf/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'X-API-Key: <X-API-Key>'

Devuelve el comprobante emitido y su estado.

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

Authorizations

ApiKey

Parameters

Path Parameters

required

string format: uuid

Responses

200

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

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

object

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

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"
  }
}

object

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

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"
  }
}

404

Not Found

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"
}

Consulta un comprobante emitido

Authorizations

Parameters

Path Parameters

Responses

200

Examplegenerated

Examplegenerated

404

Examplegenerated

Examplegenerated

Example^generated

Example^generated

Example^generated

Example^generated