Gerar Relatório EUDR

Descrição: Gera um relatório pré-invoice de compliance EUDR (Regulamento de Desmatamento da União Europeia) a partir de um CAR, de forma síncrona. O relatório é processado por completo e retornado na mesma resposta HTTP, com timeout máximo de 30 segundos.

Endpoint

POST/api/v1/integration/eudr

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
car	Código CAR do imóvel	String	Sim
producer_name	Nome do produtor	String	Sim
producer_document	CPF ou CNPJ do produtor	String	Sim	Com ou sem pontuação

Exemplo de Requisição

cURL
Java
JavaScript
Python
SDK Java

curl -X POST \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "car": "MT-5107925-A1B2C3D4E5F6",
    "producer_name": "Nome do Produtor",
    "producer_document": "00000000000"
  }' \
  "https://api.merx.tech/api/v1/integration/eudr"

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = "{\"car\": \"MT-5107925-A1B2C3D4E5F6\", \"producer_name\": \"Nome do Produtor\", \"producer_document\": \"00000000000\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.merx.tech/api/v1/integration/eudr"))
    .header("Authorization", "{SUA_API_KEY}")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpClient client = HttpClient.newHttpClient();
try {
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
} catch (Exception e) {
    e.printStackTrace();
}

const response = await fetch(
  'https://api.merx.tech/api/v1/integration/eudr',
  {
    method: 'POST',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      car: 'MT-5107925-A1B2C3D4E5F6',
      producer_name: 'Nome do Produtor',
      producer_document: '00000000000',
    }),
  }
);
const data = await response.json();
console.log(data);

import requests

url = "https://api.merx.tech/api/v1/integration/eudr"

headers = {
    "Authorization": "{SUA_API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "car": "MT-5107925-A1B2C3D4E5F6",
    "producer_name": "Nome do Produtor",
    "producer_document": "00000000000"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

import com.merx.sdk.api.MerxClient;
import com.merx.sdk.core.Environment;
import com.merx.sdk.model.carbon.eudr.EudrReportRequest;

MerxClient merx = MerxClient.builder()
    .apiKey("{SUA_API_KEY}")
    .environment(Environment.SANDBOX)
    .build();

var report = merx.eudr().createReport(EudrReportRequest.builder()
    .car("PR-1234567890")
    .producerName("Produtor Demo")
    .producerDocument("12345678901")
    .build());

Parâmetros

Parâmetros de Cabeçalho

Nome	Descrição	Tipo	Obrigatório
Authorization	Chave de API obtida via support-api@merx.tech	String	Sim
Content-Type	application/json	String	Sim

Parâmetros do Corpo

Nome	Descrição	Tipo	Obrigatório	Validações
car	Código CAR do imóvel	String	Sim
producer_name	Nome do produtor	String	Sim
producer_document	CPF ou CNPJ do produtor	String	Sim	Com ou sem pontuação

Dicionário de dados

Nome	Descrição	Tipo
status	Status do processamento do relatório. Valores: "PROCESSING", "UPDATING_CAR", "ERROR_UPDATING", "GENERATING_REPORT", "GENERATED", "ERROR_TIMEOUT", "ERROR"	Enum
processing_date	Data de processamento do relatório	Number (epoch s)
created_at	Data de criação do relatório	Number (epoch ms)
report_request_id	Identificador único do relatório gerado	UUID
cooperative_id	ID da cooperativa	UUID
cooperative_name	Nome da cooperativa	String
external_id	Identificador externo do relatório (não-anonimizado), utilizado para compartilhamento público	UUID
eu_status_summary	Status consolidado de conformidade EUDR. Valores: "CONFORME", "NAO_CONFORME", "NAO_ENCONTRADO", "PROCESSANDO"	Enum
eu_status_farms	Status consolidado das fazendas. Valores: "CONFORME", "NAO_CONFORME", "NAO_ENCONTRADO", "PROCESSANDO"	Enum
prodes_source	Fonte do PRODES utilizada. Valores: "AMAZONIA_LEGAL", "BIOMA_AMAZONIA"	Enum
anonimyzed	Indica se o relatório foi gerado de forma anonimizada (sempre presente)	Boolean
forest_loss_data	Dados de perda florestal	Object
forest_loss_data.total_area	Área total desmatada (ha)	Number
producer_data	Dados do produtor	Object
producer_data.document	CPF ou CNPJ do produtor	String
producer_data.name	Nome do produtor	String
producer_data_eu	Dados EUDR do produtor	Object
producer_data_eu.document	CPF ou CNPJ	String
producer_data_eu.name	Nome do produtor	String
eu	Lista de resultados por propriedade (CAR)	Array
eu[].farm_id	ID da fazenda	UUID
eu[].property_data	Dados da propriedade	Object
eu[].property_data.farm_name	Nome da fazenda	String
eu[].property_data.car	Código CAR	String
eu[].property_data.area	Área do imóvel (ha)	Number
eu[].property_data.legal_reserve_area	Área de reserva legal do imóvel (ha)	Number
eu[].property_data.permanent_protection_area	Área de preservação permanente do imóvel (ha)	Number
eu[].property_data.consolidated_area	Área consolidada do imóvel (ha)	Number
eu[].property_data.mod_fiscais	Número de módulos fiscais do imóvel	Number
eu[].property_data.geometry	Geometria do imóvel (GeoJSON)	String
eu[].property_data.centroid	Centróide da geometria	String
eu[].property_data.latitude	Latitude	Number
eu[].property_data.longitude	Longitude	Number
eu[].property_data.address	Endereço da propriedade	Object
eu[].property_data.address.street	Logradouro	String
eu[].property_data.address.number	Número	String
eu[].property_data.address.complement	Complemento	String
eu[].property_data.address.neighborhood	Bairro	String
eu[].property_data.address.zip_code	CEP	String
eu[].property_data.address.city	Cidade	String
eu[].property_data.address.state	Estado	String
eu[].property_data.address.country	País	String
eu[].property_data.state_subscription	Inscrição estadual do imóvel	String
eu[].property_data.car_status	Status do CAR. Valores: "AT", "CA", "SU", "PE"	Enum
eu[].property_data.car_status_updated_at	Data de atualização do status do CAR	Number (epoch s)
eu[].property_data.created_at	Data de criação do CAR na base do SICAR	Number (epoch s)
eu[].property_data.updated_at	Data da última atualização do CAR na base do SICAR	Number (epoch s)
eu[].property_data_eu	Dados EUDR da propriedade	Object
eu[].property_data_eu.farm_name	Nome da fazenda	String
eu[].property_data_eu.car	Código CAR	String
eu[].property_data_eu.eu_status	Status EUDR da propriedade. Valores: "CONFORME", "NAO_CONFORME", "NAO_ENCONTRADO", "PROCESSANDO"	Enum
eu[].property_data_eu.total_issues	Total de apontamentos da propriedade	Number
eu[].car_declaration_sigef	Dados da declaração CAR/SIGEF	Object
eu[].car_declaration_sigef.declared_area	Área declarada (ha)	Number
eu[].car_declaration_sigef.legal_reserve_area	Área de reserva legal (ha)	Number
eu[].car_declaration_sigef.permanent_protection_area	Área de proteção permanente (ha)	Number
eu[].car_declaration_sigef.tax_modules	Módulos fiscais	Number
eu[].car_declaration_sigef.analysis_date	Data de análise	String
eu[].car_declaration_sigef.registration_date	Data de registro	String
eu[].car_declaration_sigef.rectification_date	Data de retificação	String
eu[].car_declaration_sigef.merx_updated_at	Data de atualização no Merx	Number (epoch s)
eu[].layer_data	Camadas de análise EUDR da propriedade	Array
eu[].layer_data[].layer_esg_enum	Identificador da camada	String
eu[].layer_data[].layer_name	Nome da camada/órgão fiscalizador	String
eu[].layer_data[].layer_color	Cor da camada para renderização (hexadecimal)	String
eu[].layer_data[].layer_question	Pergunta associada à camada	String
eu[].layer_data[].layer_updated_at	Data de atualização da camada	Number (epoch s)
eu[].layer_data[].esg_status	Status EUDR da camada. Valores: "CONFORME", "NAO_CONFORME", "NAO_ENCONTRADO", "PROCESSANDO"	Enum
eu[].layer_data[].total_area	Área total afetada (ha)	Number
eu[].layer_data[].total_issues	Total de apontamentos na camada (sempre presente, inclusive `0`)	Number
eu[].layer_data[].layer_columns	Nomes das colunas correspondentes a cada posição de `items[].item_values`	Array
eu[].layer_data[].items	Apontamentos encontrados na camada	Array
eu[].layer_data[].items[].item_values	Valores do apontamento, na ordem de `layer_columns`	Array
eu[].layer_data[].geometries	Geometrias dos apontamentos da camada	Array
eu[].layer_data[].geometries[].geo_json	Geometria em formato GeoJSON	String
eu[].layer_data[].geometries[].area	Área da geometria (ha)	Number
eu[].layer_data[].eu_deforestation_layer	Indica se a camada é considerada camada de desmatamento para EUDR	Boolean
eu[].layer_data[].source_link	Link da fonte oficial do dado da camada	String
eu[].prodes_layer_data	Camadas PRODES de análise de desmatamento (mesma estrutura de `eu[].layer_data`)	Array

Respostas

200 - Ok

{
    "status": "GENERATED",
    "processing_date": 1773239400.000000000,
    "created_at": 1773239400000,
    "report_request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "cooperative_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "cooperative_name": "Cooperativa Exemplo",
    "external_id": "f6a7b8c9-0123-4567-8901-234567890123",
    "eu_status_summary": "NAO_CONFORME",
    "eu_status_farms": "NAO_CONFORME",
    "prodes_source": "BIOMA_AMAZONIA",
    "anonimyzed": false,
    "forest_loss_data": {
        "total_area": 0.319
    },
    "producer_data": {
        "document": "00000000000",
        "name": "Nome do Produtor"
    },
    "producer_data_eu": {
        "document": "00000000000",
        "name": "Nome do Produtor"
    },
    "eu": [
        {
            "farm_id": "6f2b1d10-6f4e-4a54-9f0e-2a0f3c1b7e55",
            "property_data": {
                "farm_name": "Fazenda São José",
                "car": "MT-5107925-A1B2C3D4E5F6",
                "area": 259.48,
                "legal_reserve_area": 90.12,
                "permanent_protection_area": 12.4,
                "consolidated_area": 140.2,
                "mod_fiscais": 3.5,
                "address": {
                    "city": "Sorriso",
                    "state": "MT"
                },
                "car_status": "AT",
                "car_status_updated_at": 1740009600.000000000,
                "created_at": 1592179200.000000000,
                "updated_at": 1705276800.000000000
            },
            "property_data_eu": {
                "farm_name": "Fazenda São José",
                "car": "MT-5107925-A1B2C3D4E5F6",
                "eu_status": "NAO_CONFORME",
                "total_issues": 2
            },
            "car_declaration_sigef": {
                "declared_area": 259.48,
                "legal_reserve_area": 90.12,
                "permanent_protection_area": 12.4,
                "tax_modules": 3.5,
                "analysis_date": "2024-01-01",
                "registration_date": "2020-06-15",
                "rectification_date": "2023-08-22",
                "merx_updated_at": 1705315800.000000000
            },
            "layer_data": [
                {
                    "layer_esg_enum": "IBAMA_PROPRIEDADE",
                    "layer_name": "IBAMA - EMBARGOS",
                    "layer_color": "#D32D1F",
                    "layer_updated_at": 1740009600.000000000,
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["Nome", "Data", "Termo de Apreensão e Depósito", "Município/UF", "Área (ha)", "Descrição Infração"],
                    "items": [],
                    "eu_deforestation_layer": false,
                    "source_link": "https://www.gov.br/ibama"
                }
            ],
            "prodes_layer_data": [
                {
                    "layer_esg_enum": "PRODES",
                    "layer_name": "INPE - PRODES - AMAZÔNIA",
                    "layer_color": "#335690",
                    "layer_updated_at": 1740009600.000000000,
                    "esg_status": "NAO_CONFORME",
                    "total_area": 0.319,
                    "total_issues": 2,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [
                        { "item_values": ["MT", "2023", "0.319", "d2023"] }
                    ],
                    "geometries": [
                        { "geo_json": "{\"type\":\"Polygon\",\"coordinates\":[...]}", "area": 0.319 }
                    ],
                    "eu_deforestation_layer": true,
                    "source_link": "http://terrabrasilis.dpi.inpe.br"
                }
            ]
        }
    ]
}

400 - Bad Request

{
  "messages": ["message.entidade.campo-inválido"]
}

401 - Unauthorized
404 - NotFound

Gerar Relatório EUDR

Endpoint​

Regras​

Exemplo de Requisição​

Parâmetros​

Parâmetros de Cabeçalho​

Parâmetros do Corpo​

Dicionário de dados​

Respostas​