API do TributoX

curl -X POST https://api.tributox.studiolabsai.com/api/fiscal/v1/auditar \
  -H "X-API-Key: $TRIBUTOX_API_KEY" \
  -H "X-TributoX-CNPJ: 11222333000181" \
  -H "Idempotency-Key: pedido-erp-000123" \
  -H "Content-Type: application/json" \
  -d '{
    "entrada": "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional."
  }'

const API = "https://api.tributox.studiolabsai.com/api/fiscal/v1";

async function auditar(entrada, idempotencyKey) {
  for (let tentativa = 0; tentativa < 3; tentativa++) {
    const r = await fetch(`${API}/auditar`, {
      method: "POST",
      headers: {
        "X-API-Key": process.env.TRIBUTOX_API_KEY,
        "X-TributoX-CNPJ": "11222333000181",
        "Idempotency-Key": idempotencyKey,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ entrada }),
    });
    if (r.status === 429 || r.status === 503) {
      await new Promise((ok) => setTimeout(ok, Number(r.headers.get("Retry-After") ?? 5) * 1000));
      continue;
    }
    if (!r.ok) throw new Error(`auditar: ${r.status} ${await r.text()}`); // 401, 403, 413, 422: corrigir o pedido
    return r.json();
  }
  throw new Error("API indisponivel depois de 3 tentativas");
}

const res = await auditar(
  "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional.",
  "pedido-erp-000123",
);
for (const campo of ["aliquota_interestadual", "cfop", "difal"]) {
  const d = res.regras_icms[campo];
  console.log(campo, d.status, d.valor, d.faltando);
}

import os, time, httpx

API = "https://api.tributox.studiolabsai.com/api/fiscal/v1"
H = {
    "X-API-Key": os.environ["TRIBUTOX_API_KEY"],
    "X-TributoX-CNPJ": "11222333000181",
    "Idempotency-Key": "pedido-erp-000123",
}

def auditar(entrada: str):
    for _ in range(3):
        r = httpx.post(f"{API}/auditar", json={"entrada": entrada}, headers=H, timeout=60)
        if r.status_code in (429, 503):
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()  # 401, 403, 413, 422: corrigir o pedido
        return r.json()
    raise RuntimeError("API indisponivel depois de 3 tentativas")

res = auditar("Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, "
              "origem 0, para contribuinte do ICMS, emitente no Simples Nacional.")
for campo in ("aliquota_interestadual", "cfop", "difal"):
    d = res["regras_icms"][campo]
    print(campo, d["status"], d["valor"], d["faltando"])

<?php
$api = "https://api.tributox.studiolabsai.com/api/fiscal/v1";
$entrada = "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, "
         . "para contribuinte do ICMS, emitente no Simples Nacional.";

function auditar(string $api, string $entrada): array {
    for ($tentativa = 0; $tentativa < 3; $tentativa++) {
        $retryAfter = 5;
        $ch = curl_init("$api/auditar");
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_HTTPHEADER => [
                "X-API-Key: " . getenv("TRIBUTOX_API_KEY"),
                "X-TributoX-CNPJ: 11222333000181",
                "Idempotency-Key: pedido-erp-000123",
                "Content-Type: application/json",
            ],
            CURLOPT_POSTFIELDS => json_encode(["entrada" => $entrada], JSON_UNESCAPED_UNICODE),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 60,
            CURLOPT_HEADERFUNCTION => function ($ch, $linha) use (&$retryAfter) {
                if (stripos($linha, "Retry-After:") === 0) { $retryAfter = (int) trim(substr($linha, 12)); }
                return strlen($linha);
            },
        ]);
        $corpo = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($status === 429 || $status === 503) { sleep($retryAfter); continue; }
        if ($status !== 200) { throw new RuntimeException("auditar: $status $corpo"); } // 401, 403, 413, 422
        return json_decode($corpo, true);
    }
    throw new RuntimeException("API indisponivel depois de 3 tentativas");
}

$res = auditar($api, $entrada);
foreach (["aliquota_interestadual", "cfop", "difal"] as $campo) {
    $d = $res["regras_icms"][$campo];
    echo $campo, " ", $d["status"], " ", json_encode($d["valor"]), " ", json_encode($d["faltando"]), "\n";
}

curl -X POST https://api.tributox.studiolabsai.com/api/fiscal/v1/sugerir \
  -H "Authorization: Bearer $TRIBUTOX_API_KEY" \
  -H "X-TributoX-CNPJ: 11222333000181" \
  -H "Idempotency-Key: sugestao-erp-000123" \
  -H "Content-Type: application/json" \
  -d '{
    "demanda": "Empresa de servicos no Simples Nacional. O Fator R muda o anexo?",
    "contexto": { "regime": "simples", "uf": "SP", "atividade": "desenvolvimento de software" }
  }'

curl https://api.tributox.studiolabsai.com/api/fiscal/v1/sugestao/3f2b9c1e-7a4d-4e8b-9c2a-1d5e6f7a8b9c \
  -H "Authorization: Bearer $TRIBUTOX_API_KEY" \
  -H "X-TributoX-CNPJ: 11222333000181"

const API = "https://api.tributox.studiolabsai.com/api/fiscal/v1";
const headers = {
  Authorization: `Bearer ${process.env.TRIBUTOX_API_KEY}`,
  "X-TributoX-CNPJ": "11222333000181",
  "Content-Type": "application/json",
};

const criar = await fetch(`${API}/sugerir`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": "sugestao-erp-000123" },
  body: JSON.stringify({
    demanda: "Empresa de servicos no Simples Nacional. O Fator R muda o anexo?",
    contexto: { regime: "simples", uf: "SP", atividade: "desenvolvimento de software" },
  }),
});
if (criar.status !== 202) throw new Error(`criar: ${criar.status}`);
const { job_id } = await criar.json();

for (let i = 0; i < 30; i++) {
  await new Promise((ok) => setTimeout(ok, 2000)); // cada consulta conta no limite por minuto
  const r = await fetch(`${API}/sugestao/${job_id}`, { headers });
  if (r.status === 202) continue;
  if (r.status === 429) {
    await new Promise((ok) => setTimeout(ok, Number(r.headers.get("Retry-After") ?? 5) * 1000));
    continue;
  }
  const job = await r.json();
  if (job.status === "erro") throw new Error("job com erro: crie outro");
  console.log(job.resultado.sugestao, job.resultado.confianca);
  break;
}

import os, time, httpx

API = "https://api.tributox.studiolabsai.com/api/fiscal/v1"
H = {"Authorization": f"Bearer {os.environ['TRIBUTOX_API_KEY']}",
     "X-TributoX-CNPJ": "11222333000181"}

criar = httpx.post(
    f"{API}/sugerir",
    headers={**H, "Idempotency-Key": "sugestao-erp-000123"},
    json={
        "demanda": "Empresa de servicos no Simples Nacional. O Fator R muda o anexo?",
        "contexto": {"regime": "simples", "uf": "SP", "atividade": "desenvolvimento de software"},
    },
    timeout=30,
)
criar.raise_for_status()  # esperado: 202
job_id = criar.json()["job_id"]

for _ in range(30):
    time.sleep(2)  # cada consulta conta no limite por minuto
    r = httpx.get(f"{API}/sugestao/{job_id}", headers=H, timeout=30)
    if r.status_code == 202:
        continue
    if r.status_code == 429:
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    r.raise_for_status()
    job = r.json()
    if job["status"] == "erro":
        raise RuntimeError("job com erro: crie outro")
    print(job["resultado"]["sugestao"], job["resultado"]["confianca"])
    break

<?php
$api = "https://api.tributox.studiolabsai.com/api/fiscal/v1";
$headers = [
    "Authorization: Bearer " . getenv("TRIBUTOX_API_KEY"),
    "X-TributoX-CNPJ: 11222333000181",
    "Content-Type: application/json",
];

function chamar(string $metodo, string $url, array $headers, ?array $corpo = null): array {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => $metodo,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    if ($corpo !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($corpo, JSON_UNESCAPED_UNICODE));
    }
    $resposta = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return [$status, json_decode($resposta, true)];
}

[$status, $job] = chamar("POST", "$api/sugerir",
    array_merge($headers, ["Idempotency-Key: sugestao-erp-000123"]),
    [
        "demanda" => "Empresa de servicos no Simples Nacional. O Fator R muda o anexo?",
        "contexto" => ["regime" => "simples", "uf" => "SP", "atividade" => "desenvolvimento de software"],
    ]);
if ($status !== 202) { throw new RuntimeException("criar: $status"); }

for ($i = 0; $i < 30; $i++) {
    sleep(2); // cada consulta conta no limite por minuto
    [$status, $corpo] = chamar("GET", "$api/sugestao/" . $job["job_id"], $headers);
    if ($status === 202) { continue; }
    if ($status === 200 && $corpo["status"] === "concluido") {
        echo $corpo["resultado"]["sugestao"], " (", $corpo["resultado"]["confianca"], ")\n";
        break;
    }
    throw new RuntimeException("falha: $status");
}

curl -X POST https://api.tributox.studiolabsai.com/api/fiscal/v1/lotes \
  -H "Authorization: Bearer $TRIBUTOX_API_KEY" \
  -H "X-TributoX-CNPJ: 11222333000181" \
  -H "Idempotency-Key: lote-2026-03-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "itens": [
      { "referencia": "PED-1001", "entrada": "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional." },
      { "referencia": "PED-1002", "entrada": "Venda de mercadoria, NCM 84713012, de SP para MG em 2026-03-11, origem 0, para contribuinte do ICMS, emitente no Lucro Presumido." }
    ]
  }'

curl https://api.tributox.studiolabsai.com/api/fiscal/v1/lotes/9d4c7e21-5b3a-4f60-8a1e-2c7d9b0e4f13 \
  -H "Authorization: Bearer $TRIBUTOX_API_KEY" \
  -H "X-TributoX-CNPJ: 11222333000181"

const API = "https://api.tributox.studiolabsai.com/api/fiscal/v1";
const base = {
  Authorization: `Bearer ${process.env.TRIBUTOX_API_KEY}`,
  "X-TributoX-CNPJ": "11222333000181",
};

const criar = await fetch(`${API}/lotes`, {
  method: "POST",
  headers: { ...base, "Idempotency-Key": "lote-2026-03-0001", "Content-Type": "application/json" },
  body: JSON.stringify({
    itens: [
      { referencia: "PED-1001", entrada: "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional." },
      { referencia: "PED-1002", entrada: "Venda de mercadoria, NCM 84713012, de SP para MG em 2026-03-11, origem 0, para contribuinte do ICMS, emitente no Lucro Presumido." },
    ],
  }),
});
if (criar.status !== 202) throw new Error(`lote: ${criar.status} ${await criar.text()}`);
const { lote_id } = await criar.json();

while (true) {
  await new Promise((ok) => setTimeout(ok, 3000)); // cada consulta conta no limite por minuto
  const r = await fetch(`${API}/lotes/${lote_id}`, { headers: base });
  if (r.status === 429) {
    await new Promise((ok) => setTimeout(ok, Number(r.headers.get("Retry-After") ?? 5) * 1000));
    continue;
  }
  if (r.status === 202) continue;
  const lote = await r.json(); // 200: todos terminaram
  for (const item of lote.itens) console.log(item.referencia, item.status, item.erro ?? item.resultado.fonte);
  break;
}

import os, time, httpx

API = "https://api.tributox.studiolabsai.com/api/fiscal/v1"
H = {"Authorization": f"Bearer {os.environ['TRIBUTOX_API_KEY']}",
     "X-TributoX-CNPJ": "11222333000181"}

criar = httpx.post(
    f"{API}/lotes",
    headers={**H, "Idempotency-Key": "lote-2026-03-0001"},
    json={"itens": [
        {"referencia": "PED-1001", "entrada": "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional."},
        {"referencia": "PED-1002", "entrada": "Venda de mercadoria, NCM 84713012, de SP para MG em 2026-03-11, origem 0, para contribuinte do ICMS, emitente no Lucro Presumido."},
    ]},
    timeout=30,
)
criar.raise_for_status()  # esperado: 202
lote_id = criar.json()["lote_id"]

while True:
    time.sleep(3)  # cada consulta conta no limite por minuto
    r = httpx.get(f"{API}/lotes/{lote_id}", headers=H, timeout=30)
    if r.status_code == 429:
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    if r.status_code == 202:
        continue
    r.raise_for_status()
    lote = r.json()  # 200: todos terminaram
    for item in lote["itens"]:
        print(item["referencia"], item["status"], item["erro"] or item["resultado"]["fonte"])
    break

<?php
$api = "https://api.tributox.studiolabsai.com/api/fiscal/v1";
$base = [
    "Authorization: Bearer " . getenv("TRIBUTOX_API_KEY"),
    "X-TributoX-CNPJ: 11222333000181",
];

function chamar(string $metodo, string $url, array $headers, ?array $corpo = null): array {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => $metodo,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    if ($corpo !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($corpo, JSON_UNESCAPED_UNICODE));
    }
    $resposta = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return [$status, json_decode($resposta, true)];
}

[$status, $lote] = chamar("POST", "$api/lotes",
    array_merge($base, ["Idempotency-Key: lote-2026-03-0001", "Content-Type: application/json"]),
    ["itens" => [
        ["referencia" => "PED-1001", "entrada" => "Venda de producao propria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional."],
        ["referencia" => "PED-1002", "entrada" => "Venda de mercadoria, NCM 84713012, de SP para MG em 2026-03-11, origem 0, para contribuinte do ICMS, emitente no Lucro Presumido."],
    ]]);
if ($status !== 202) { throw new RuntimeException("lote: $status"); }

while (true) {
    sleep(3); // cada consulta conta no limite por minuto
    [$status, $corpo] = chamar("GET", "$api/lotes/" . $lote["lote_id"], $base);
    if ($status === 202 || $status === 429) { continue; }
    if ($status !== 200) { throw new RuntimeException("consulta: $status"); }
    foreach ($corpo["itens"] as $item) {
        echo $item["referencia"], " ", $item["status"], " ", $item["erro"] ?? $item["resultado"]["fonte"], "\n";
    }
    break;
}