Ir al contenido
NovaFENovaFENovaFE

ReceivedEcfLista los e-CF recibidos

Lista los e-CF recibidos

Ver como Markdown
GET
/api/v1/received-ecf
curl --request GET \
  --url https://api.novafe.example/api/v1/received-ecf \
  --header 'X-API-Key: <X-API-Key>'

Listado paginado de los comprobantes que otros contribuyentes te han enviado.

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

Authorizations

Sección titulada «Authorizations»

Parameters

Sección titulada «Parameters»

Query Parameters

Sección titulada «Query Parameters»
Status
string

Received o NotReceived.

Decision
string

pending (recibido, de un tipo que admite aprobación comercial y sin decisión), accepted o rejected.

Search
string

Texto en el e-NCF, el RNC del emisor o su nombre.

Type
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/

Código del tipo de comprobante (31, 33, 34…).

From
string format: date
To
string format: date
Environment
string

test, cert o production. Sin valor: todos.

Page
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
PageSize
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
Skip
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/

Responses

Sección titulada «Responses»

200

Sección titulada «200»

OK

object
items
required
Array<object>

Lo que la API y los webhooks exponen de un e-CF ajeno recibido (Módulo 5). CommercialApprovalApplies es false para los tipos que la DGII no admite en una aprobación comercial (32, 41, 43, 46 y 47): nunca pueden quedar pendientes de decisión.

object
id
required
string format: uuid
status
required
string
noReceptionReason
required
null | string
issuerRnc
required
string
issuerName
required
null | string
encf
required
string
type
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
issueDate
required
null | string format: date
montoTotal
required
null | number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
receivedAt
required
string format: date-time
commercialApprovalDecision
required
null | string
commercialApprovalRejectionReason
required
null | string
commercialApprovalDecidedAt
required
null | string format: date-time
commercialApprovalSentToIssuerAt
required
null | string format: date-time
commercialApprovalSentToDgiiAt
required
null | string format: date-time
commercialApprovalApplies
required
boolean
commercialApprovalAutomatic
boolean
commercialApprovalAutomaticRule
null | string
totalCount
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
page
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
pageSize
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
totalPages
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
hasNextPage
boolean
hasPreviousPage
boolean