Consulta de Reportes, Compras y Logs de Errores

Documentación de los endpoints GET /reports/encf, GET /fe/compras y GET /logs/errors.

La API de Medasoft incluye endpoints paginados y filtrables para auditar comprobantes emitidos, facturas de compras recibidas y registros de excepciones de procesamiento XML.

📊 1. Reporte Unificado de e-NCFs (`GET /reports/encf`)

Combina en una sola consulta paginada todos los comprobantes emitidos por la empresa (logs de información de facturas aceptadas y logs de errores de facturas rechazadas).

Petición HTTP (`GET`)

GET /reports/encf?Page=1&PageSize=20&Status=Aceptado&TypeCode=31 HTTP/1.1
Host: medasoftfe.com
Authorization: Bearer YOUR_JWT_TOKEN

Tabla de Parámetros de Consulta (Query Parameters)

Parámetro	Tipo	Requerido	Descripción
`Page`	`int`	No	Número de página (1-indexed, defecto: 1).
`PageSize`	`int`	No	Registros por página (Máx: 500, defecto: 20).
`Status`	`string`	No	Filtrar por estado (`Aceptado` / `Rechazado`).
`TypeCode`	`string`	No	Código tipo de e-CF (`31`, `32`, `33`, `34`, `41`, `43`, `45`, `46`, `47`).
`ENcf`	`string`	No	Búsqueda por eNCF exacto o parcial.
`StartDate`	`string`	No	Fecha inicio en formato `YYYY-MM-DD`.
`EndDate`	`string`	No	Fecha fin en formato `YYYY-MM-DD`.
`SearchTerm`	`string`	No	Búsqueda general en eNCF o detalle de estado.

Respuesta JSON (`200 OK`)

{
  "page": 1,
  "pageSize": 20,
  "totalItems": 142,
  "totalPages": 8,
  "hasPreviousPage": false,
  "hasNextPage": true,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "eNcf": "E310000000001",
      "typeCode": "31",
      "typeName": "Factura de Crédito Fiscal Electrónica",
      "sequence": "0000000001",
      "status": "Aceptado",
      "statusDetails": "Comprobante procesado exitosamente por DGII",
      "statusCode": "1",
      "dateTime": "2026-07-25T08:00:00Z",
      "server": "Production",
      "total": 2050.00,
      "totalItbis": 312.71,
      "url": "https://ecf.dgii.gov.do/testecf/ConsultaTimbre?..."
    }
  ]
}

🛒 2. Consulta de Compras Recibidas (`GET /fe/compras`)

Obtiene el listado paginado de facturas electrónicas recibidas de proveedores (Acuses de Recibo B2B almacenados).

Petición HTTP (`GET`)

GET /fe/compras?Page=1&PageSize=20 HTTP/1.1
Host: medasoftfe.com
Authorization: Bearer YOUR_JWT_TOKEN

🚨 3. Logs de Errores de Procesamiento XML (`GET /logs/errors`)

Permite auditar los fallos o rechazos tributarios al transmitir comprobantes a los servidores de la DGII.

Petición HTTP (`GET`)

GET /logs/errors?Page=1&PageSize=20 HTTP/1.1
Host: medasoftfe.com
Authorization: Bearer YOUR_JWT_TOKEN

Respuesta JSON (`200 OK`)

{
  "page": 1,
  "pageSize": 20,
  "totalItems": 4,
  "totalPages": 1,
  "hasPreviousPage": false,
  "hasNextPage": false,
  "data": [
    {
      "id": 105,
      "eNcf": "E310000000002",
      "error": "RNC del comprador no se encuentra activo en el padrón de la DGII",
      "codeError": "ERR-DGII-404",
      "dateTime": "2026-07-25T11:15:20Z"
    }
  ]
}

Consulta de Reportes, Compras y Logs de Errores

On this page