CAR — demonstrativo (Reserva Legal e APP)

// Execute somente no backend (Node.js 22+). Configure o token no servidor.
// const pedido = await consultarOficialData(process.env.OFICIALDATA_TOKEN, dados);
// Guarde pedido.protocolo. Depois use acompanharOficialData(token, pedido.protocolo).
// Cada POST inicia uma nova consulta, mesmo com dados iguais.
// Resposta perdida: confira o histórico antes de reenviar; outro POST é outro pedido.

export async function consultarOficialData(token, dados = {"cpf_cnpj":"12345678000190","car":"MG-3103405-4266.D811.310B.4471.B6F1.8330.051D.1255"}) {
  const corpo = await enviar(token, "https://api.oficialdata.com.br/v1/consultas/car-demonstrativo", dados);
  const protocolo = corpo.data?.[0]?.protocolo;
  if (corpo.code !== 202 || !protocolo) throw new Error(JSON.stringify(corpo));
  return { protocolo: String(protocolo), resposta: corpo };
}

export async function acompanharOficialData(token, protocolo) {
  if (!/^\d+$/.test(String(protocolo))) throw new Error('Informe o protocolo recebido.');
  const corpo = await enviar(token, "https://api.oficialdata.com.br" + '/v1/consultas/' + encodeURIComponent(protocolo));
  // code 202: aguarde intervalo_consulta_segundos e consulte novamente por GET.
  // code 200/6xx: confira o resultado. Não repita o POST para acompanhar.
  return { protocolo: String(protocolo), resposta: corpo };
}

async function enviar(token, url, dados) {
  if (!token) throw new Error('Informe o token de acesso.');
  const post = dados !== undefined;
  const resposta = await fetch(url, {
    method: post ? 'POST' : 'GET',
    headers: {
      Authorization: 'Bearer ' + token, Accept: 'application/json',
      ...(post && { 'Content-Type': 'application/json' }),
    },
    ...(post && { body: JSON.stringify(dados) }),
    signal: AbortSignal.timeout(30000),
  });
  const corpo = await resposta.json();
  // Não repita POST automaticamente após timeout: o pedido pode ter sido aceito.
  if (!resposta.ok) throw new Error('HTTP ' + resposta.status + ': ' + JSON.stringify(corpo));
  return corpo;
}

<?php

// Salve como oficialdata.php no backend Laravel. Configure o token no servidor.
// $consultar = require base_path('oficialdata.php');
// $pedido = $consultar(config('services.oficialdata.token'), $dados);
// Guarde $pedido['protocolo']; acompanhe com $consultar($token, null, $protocolo).
// Cada POST inicia uma nova consulta, mesmo com dados iguais.
// Resposta perdida: confira o histórico antes de reenviar; outro POST é outro pedido.
use Illuminate\Support\Facades\Http;

return function (string $token, ?array $dados = null, ?string $protocolo = null): array {
    if ($token === '') {
        throw new RuntimeException('Informe o token de acesso.');
    }
    $http = Http::withToken($token)->acceptJson()->timeout(30);
    if ($protocolo !== null) {
        if (! ctype_digit($protocolo)) {
            throw new RuntimeException('Informe o protocolo recebido.');
        }
        $resposta = $http->get("https://api.oficialdata.com.br".'/v1/consultas/'.rawurlencode($protocolo));
    } else {
        $dados ??= json_decode('{"cpf_cnpj":"12345678000190","car":"MG-3103405-4266.D811.310B.4471.B6F1.8330.051D.1255"}', true, flags: JSON_THROW_ON_ERROR);
        $resposta = $http->post("https://api.oficialdata.com.br/v1/consultas/car-demonstrativo", $dados);
    }
    // Não repita POST automaticamente após timeout: o pedido pode ter sido aceito.
    $resposta->throw();
    $corpo = $resposta->json();
    if ($protocolo === null) {
        $protocolo = $corpo['data'][0]['protocolo'] ?? null;
        if (($corpo['code'] ?? null) !== 202 || ! $protocolo) {
            throw new RuntimeException(json_encode($corpo, JSON_THROW_ON_ERROR));
        }
    }

    // code 202: aguarde intervalo_consulta_segundos e faça GET; code 200/6xx: leia o resultado.
    return ['protocolo' => (string) $protocolo, 'resposta' => $corpo];
};

{
    "status_consulta": "SUCESSO",
    "identificadores": {
        "car": "MG-3103405-4266D811310B4471B6F18330051D1255"
    },
    "dados": {
        "situacao": "Ativo",
        "condicao_cadastro": "Aguardando análise",
        "area": 684.5179,
        "modulos_fiscais": 10.531,
        "municipio": "Araçuaí",
        "uf": "MG",
        "registro_data": "26/03/2021",
        "retificacao_data": "27/12/2022",
        "area_preservacao_permanente": 0,
        "area_uso_restrito": 0,
        "reserva_legal_situacao": "Não Analisada",
        "reserva_legal_minima": 135.9059,
        "reserva_legal_declarada": 0,
        "passivo_reserva_legal": -135.9059,
        "solo_area_nativa": 0,
        "solo_servidao_administrativa": 4.988470975401066,
        "sobreposicao_outros_imoveis": 5.5878,
        "sobreposicao_terra_indigena": 0
    },
    "mensagem": "Situação do cadastro: Ativo. Condição: Aguardando análise.",
    "consultado_em": "2026-10-20T13:43:38-03:00"
}