Descargar el JSON o el PDF

# -D - vuelca las cabeceras de la respuesta, con RateLimit-Remaining (y, si aplica, Retry-After).
curl --fail-with-body -X GET "$FACTA_API_BASE_URL/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json" \
  -H "X-Facta-Key: $FACTA_API_KEY" \
  -D - \
  --max-time 60 \
  -o "archivo.json"

// JavaScript puro, sin ninguna librería de Facta. Node 22 o 24; fetch es global.
const base = process.env.FACTA_API_BASE_URL;

const headers = {
  "X-Facta-Key": process.env.FACTA_API_KEY,
};

const controlador = new AbortController();
const plazo = setTimeout(() => controlador.abort(), 60_000);

const respuesta = await fetch(base + "/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json", {
  method: "GET",
  headers,
  signal: controlador.signal,
}).finally(() => clearTimeout(plazo));

console.log("cupo restante:", respuesta.headers.get("RateLimit-Remaining"));

if (!respuesta.ok) throw new Error(`HTTP ${respuesta.status}`);
// Los bytes exactos: nunca se parsean ni se vuelven a serializar.
const bytes = new Uint8Array(await respuesta.arrayBuffer());
await writeFile("archivo.json", bytes);

import { Facta, FactaError } from "@facta/api";

const facta = new Facta({
  apiKey: process.env.FACTA_API_KEY!,
});

// Los bytes EXACTOS, sin parsear ni volver a serializar.
const archivo = await facta.downloadDocument("7875BC7A-9580-441D-94E4-FA455E9D8BD0", "json");

await writeFile(archivo.filename ?? `${archivo}.json`, archivo.bytes);
console.log(archivo.contentType);   // "application/json"

import json
import os
import urllib.error
import urllib.request

base = os.environ["FACTA_API_BASE_URL"]

cabeceras = {
    "X-Facta-Key": os.environ["FACTA_API_KEY"],
}

peticion = urllib.request.Request(
    base + "/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json",
    method="GET",
    headers=cabeceras,
)

try:
    # El Ministerio puede tardar unos cuarenta segundos en contestar.
    with urllib.request.urlopen(peticion, timeout=60) as respuesta:
        print("cupo restante:", respuesta.headers.get("RateLimit-Remaining"))
        # Los bytes exactos: nunca se parsean ni se vuelven a serializar.
        datos = respuesta.read()
        with open("archivo.json", "wb") as archivo:
            archivo.write(datos)
except urllib.error.HTTPError as fallo:
    error = json.load(fallo).get("error", {})
    if error.get("code") == "mh_rejected":
        detalle = error.get("details", {})
        print("rechazado:", error.get("message"), "· número gastado:", detalle.get("numeroControl"))
    else:
        raise

<?php
// PHP 8 con la extensión cURL. No hay librería de Facta para PHP.
$base = getenv("FACTA_API_BASE_URL");

$cabeceras = [
    "X-Facta-Key: " . getenv("FACTA_API_KEY"),
];

$conexion = curl_init($base . "/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json");
curl_setopt_array($conexion, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => $cabeceras,
]);

$crudo = curl_exec($conexion);
$estado = curl_getinfo($conexion, CURLINFO_RESPONSE_CODE);
$tamCabeceras = curl_getinfo($conexion, CURLINFO_HEADER_SIZE);
curl_close($conexion);

$cabecerasRespuesta = substr($crudo, 0, $tamCabeceras);
echo "cupo restante: " . (preg_match("/RateLimit-Remaining: (\d+)/i", $cabecerasRespuesta, $m) ? $m[1] : "?") . "\n";

// Los bytes exactos: nunca se parsean ni se vuelven a serializar.
$bytes = substr($crudo, $tamCabeceras);
file_put_contents("archivo.json", $bytes);

// .NET 8 con HttpClient. No hay librería de Facta para C#.
using System.Net.Http.Json;
using System.Text.Json;

var base_ = Environment.GetEnvironmentVariable("FACTA_API_BASE_URL");
using var cliente = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };

var peticion = new HttpRequestMessage(HttpMethod.Get, base_ + "/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json");
peticion.Headers.Add("X-Facta-Key", Environment.GetEnvironmentVariable("FACTA_API_KEY"));

var respuesta = await cliente.SendAsync(peticion);
Console.WriteLine($"cupo restante: {respuesta.Headers.GetValues("RateLimit-Remaining").FirstOrDefault()}");

// Los bytes exactos: nunca se parsean ni se vuelven a serializar.
var bytes = await respuesta.Content.ReadAsByteArrayAsync();
await File.WriteAllBytesAsync("archivo.json", bytes);

// JDK 17 o superior, con java.net.http. No hay librería de Facta para Java.
import java.net.URI;
import java.net.http.*;
import java.time.Duration;

public final class Archivo {
  public static void main(String[] args) throws Exception {
    var base = System.getenv("FACTA_API_BASE_URL");
    var constructor = HttpRequest.newBuilder(URI.create(base + "/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json"))
        .header("X-Facta-Key", System.getenv("FACTA_API_KEY"))
        .timeout(Duration.ofSeconds(60))
        .GET();
    var peticion = constructor.build();

    var respuesta = HttpClient.newHttpClient().send(peticion, HttpResponse.BodyHandlers.ofByteArray());
    System.out.println("cupo restante: " + respuesta.headers().firstValue("RateLimit-Remaining").orElse("?"));
    // Los bytes exactos: nunca se parsean ni se vuelven a serializar.
    java.nio.file.Files.write(java.nio.file.Path.of("archivo.json"), respuesta.body());
  }
}

// Go 1.22 con net/http. No hay librería de Facta para Go.
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"time"
)

func main() {
	base := os.Getenv("FACTA_API_BASE_URL")
	peticion, _ := http.NewRequest("GET", base+"/v1/dte/7875BC7A-9580-441D-94E4-FA455E9D8BD0/file?kind=json", nil)
	peticion.Header.Set("X-Facta-Key", os.Getenv("FACTA_API_KEY"))

	cliente := &http.Client{Timeout: 60 * time.Second}
	respuesta, err := cliente.Do(peticion)
	if err != nil {
		panic(err)
	}
	defer respuesta.Body.Close()

	fmt.Println("cupo restante:", respuesta.Header.Get("RateLimit-Remaining"))

	// Los bytes exactos: nunca se parsean ni se vuelven a serializar.
	bytes, _ := io.ReadAll(respuesta.Body)
	os.WriteFile("archivo.json", bytes, 0o600)
}