Consulta de Documentos

Consulta el estado de tus documentos emitidos y descarga XML firmados.

⚙

Para consultar documentos y descargar PDFs/XML sin código, usa tu panel de Documentos. Esta página describe los endpoints REST para quien integra por API.

Consultar por eNCF

GET /{env}/documentos-ecf/{eNCF}

curl https://ecf.frandeone.com/TesteCF/documentos-ecf/E310000000001 \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-API-KEY: ecf_sk_a1b2c3..."

const response = await fetch(
  'https://ecf.frandeone.com/TesteCF/documentos-ecf/E310000000001',
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'X-API-KEY': 'ecf_sk_a1b2c3...'
    }
  }
);
const doc = await response.json();
console.log(doc.data.estado_dgii); // "ACEPTADO"

$ch = curl_init('https://ecf.frandeone.com/TesteCF/documentos-ecf/E310000000001');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer {$accessToken}",
        'X-API-KEY: ecf_sk_a1b2c3...'
    ]
]);
$response = json_decode(curl_exec($ch), true);
echo $response['data']['estado_dgii']; // "ACEPTADO"
curl_close($ch);

Respuesta

200 OK

{
  "success": true,
  "data": {
    "id": 1,
    "encf": "E310000000001",
    "tipo_ecf": 31,
    "rnc_comprador": "101123456",
    "razon_social_comprador": "Empresa Compradora SRL",
    "monto_total": 11800.00,
    "estado_dgii": "ACEPTADO",
    "track_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "security_code": "AB12CD",
    "signed_xml": "<ECF>...</ECF>",
    "qr_url": "https://ecf.dgii.gov.do/ecf/...",
    "created_at": "2026-04-15T10:30:00Z"
  }
}

Consultar por Track ID

GET /{env}/documentos-ecf/track/{trackId}

cURL

curl https://ecf.frandeone.com/TesteCF/documentos-ecf/track/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-API-KEY: ecf_sk_a1b2c3..."

Consultar por Internal Track ID

GET /api/documents/{internalTrackId}

El internalTrackId es el UUID generado por Frande ECF al recibir el documento. Se devuelve en la respuesta del envio.

Listar documentos

GET /api/documents?limit=50&offset=0&status=ACEPTADO

Parametros de filtro

Parametro	Tipo	Descripcion
`limit`	Integer	Registros por pagina (default: 50, max: 200)
`offset`	Integer	Registros a saltar
`status`	String	Filtrar por estado: RECIBIDO, ACEPTADO, RECHAZADO, EN_COLA
`tipo_ecf`	Integer	Filtrar por tipo (31, 32, 33, etc.)
`from`	Date	Fecha inicio (YYYY-MM-DD)
`to`	Date	Fecha fin (YYYY-MM-DD)

Descargar XML firmado

GET /api/documents/{id}/xml

Devuelve el XML firmado como application/xml con header Content-Disposition: attachment.

cURL

# Descargar XML a archivo
curl -o factura_E31.xml \
  https://ecf.frandeone.com/api/documents/1/xml \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-API-KEY: ecf_sk_a1b2c3..."

Descargar RFCE

GET /api/documents/{id}/rfce

Solo disponible para documentos E32 con monto menor a RD$250,000. Devuelve el Resumen de Factura de Consumo Electronico en formato XML.

💡

El RFCE se genera automaticamente al emitir una factura E32 elegible. No necesitas hacer nada adicional.