Ir al contenido
NovaFENovaFE

FinanceConsulta el resumen fiscal de un período

Consulta el resumen fiscal de un período

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

Resumen fiscal entre from y to (inclusive), por fecha de emisión.

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»
from
string format: date
to
string format: date

Responses

Sección titulada «Responses»

200

Sección titulada «200»

OK

Resumen fiscal del lado ventas (lo que el contribuyente emitió) para un rango de fechas — visibilidad interna, no un formato de envío de la DGII (606/607/608): ese mapeo exacto queda para cuando se consiga el spec real. Un e-CF rejected no cuenta en ningún total: nunca quedó facturado ante la DGII.

object
from
required
string format: date
to
required
string format: date
totalCount
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
totalInvoiced
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbis
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbis1
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbis2
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbis3
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalExempt
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbisWithheld
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalIsrWithheld
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalCreditNoteAmount
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalDebitNoteAmount
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
netCreditDebitEffect
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
byType
required
Array<object>

Totales de un tipo de e-CF puntual dentro del rango.

object
type
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
typeName
required
string
count
required
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
totalAmount
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/
totalItbis
required
number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/