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
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

Exemplo de Requisição

curl -X POST\
-H "Authorization: [[apiKey]]"\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
-d '{
    "car": "MG-3135209-56FC399E093348DDBFECABA544B54904",
    "producer_name": "Nome do Produtor",
    "producer_document": "00000000000"
}'\
"https://homolog.api.merx.tech/api/v1/integration/eudr"

Parâmetros

Parâmetros de Cabeçalho

Nome	Descrição	Tipo	Obrigatório
Authorization		String	Sim

Parâmetros do Corpo

Nome	Descrição	Tipo	Obrigatório
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

Dicionário de dados

Nome	Descrição	Tipo
status	Status do processamento do relatório. Valores: "GENERATED", "PROCESSING", "GENERATING_REPORT", "UPDATING_CAR", "ERROR", "ERROR_TIMEOUT", "ERROR_UPDATING"	Enum
processing_date	Data de processamento do relatório	DateTime
created_at	Data de criação do relatório	DateTime
report_request_id	Identificador único do relatório gerado	UUID
cooperative_id	ID da cooperativa	UUID
cooperative_name	Nome da cooperativa	String
commitment_id	ID da negociação vinculada (quando aplicável)	UUID
report_integration_id	ID de integração do relatório	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
extracted_related_farms	Indica se fazendas relacionadas foram extraídas	Boolean
prodes_source	Fonte do PRODES utilizada. Valores: "AMAZONIA_LEGAL", "BIOMA_AMAZONIA"	Enum
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.producer_id	ID do produtor	UUID
producer_data.document	CPF ou CNPJ do produtor	String
producer_data.name	Nome do produtor	String
producer_data.dap_code	Código DAP	String
producer_data.caf_code	Código CAF	String
producer_data.ricaf_code	Código RiCAF	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.id_report	ID do relatório da propriedade	UUID
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.geometry	Geometria do imóvel (WKT)	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.city	Cidade	String
eu.property_data.address.state	Estado	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	DateTime
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" ou "NAO_CONFORME"	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.merx_updated_at	Data de atualização MERX	DateTime
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_updated_at	Data de atualização da camada	DateTime
eu.layer_data.esg_status	Status EUDR da camada. Valores: "CONFORME" ou "NAO_CONFORME"	Enum
eu.layer_data.total_area	Área total afetada (ha)	Number
eu.layer_data.total_issues	Total de apontamentos na camada	Number
eu.layer_data.layer_columns	Colunas de dados da camada	Array
eu.layer_data.items	Detalhes dos apontamentos	Array
eu.layer_data.items.item_values	Valores do apontamento (conforme layer_columns)	Array
eu.layer_data.geometries	Geometrias dos apontamentos	Array
eu.layer_data.geometries.geo_json	GeoJSON da geometria	String
eu.layer_data.geometries.area	Área (ha)	Number
eu.prodes_layer_data	Camadas PRODES de análise de desmatamento	Array
eu.prodes_layer_data.layer_esg_enum	Identificador da camada PRODES	String
eu.prodes_layer_data.layer_name	Nome da camada PRODES	String
eu.prodes_layer_data.layer_updated_at	Data de atualização da camada	DateTime
eu.prodes_layer_data.esg_status	Status EUDR da camada PRODES. Valores: "CONFORME" ou "NAO_CONFORME"	Enum
eu.prodes_layer_data.total_area	Área total desmatada (ha)	Number
eu.prodes_layer_data.total_issues	Total de apontamentos na camada	Number
eu.prodes_layer_data.layer_columns	Colunas de dados da camada	Array
eu.prodes_layer_data.items	Detalhes dos apontamentos	Array
eu.prodes_layer_data.items.item_values	Valores do apontamento (conforme layer_columns)	Array
eu.prodes_layer_data.geometries	Geometrias dos apontamentos	Array

Respostas

200 - Ok

{
    "status": "GENERATED",
    "processing_date": "2026-03-11T14:30:00-03:00",
    "created_at": "2026-03-11T14:30:00.000+00:00",
    "report_request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "cooperative_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "cooperative_name": "Cooperativa Exemplo",
    "commitment_id": null,
    "report_integration_id": "c3d4e5f6-7890-1234-abcd-ef5678901234",
    "eu_status_summary": "NAO_CONFORME",
    "eu_status_farms": "NAO_CONFORME",
    "extracted_related_farms": false,
    "prodes_source": "BIOMA_AMAZONIA",
    "anonimyzed": false,
    "forest_loss_data": {
        "total_area": 0.319
    },
    "producer_data": {
        "producer_id": null,
        "document": "00000000000",
        "name": "Nome do Produtor",
        "dap_code": null,
        "caf_code": null,
        "ricaf_code": null
    },
    "producer_data_eu": {
        "document": "00000000000",
        "name": "Nome do Produtor"
    },
    "layer_data_producer": [],
    "eu": [
        {
            "id_report": "d4e5f6a7-b890-1234-cdef-567890123456",
            "farm_id": null,
            "property_data": {
                "farm_name": null,
                "car": "MG-3135209-56FC399E093348DDBFECABA544B54904",
                "area": 4.743,
                "geometry": "MULTIPOLYGON((...))",
                "centroid": "POINT(-44.123 -15.456)",
                "latitude": -15.456,
                "longitude": -44.123,
                "address": {
                    "city": "Januária",
                    "state": "MG"
                },
                "car_status": "AT",
                "car_status_updated_at": "2025-02-20T00:00:00Z"
            },
            "property_data_eu": {
                "farm_name": null,
                "car": "MG-3135209-56FC399E093348DDBFECABA544B54904",
                "eu_status": "NAO_CONFORME",
                "total_issues": 2
            },
            "car_declaration_sigef": {
                "declared_area": 4.743,
                "legal_reserve_area": 0.95,
                "permanent_protection_area": 0.48,
                "tax_modules": 0.15,
                "analysis_date": "2024-01-15",
                "registration_date": "2020-06-10",
                "merx_updated_at": "2025-02-20T00:00:00Z"
            },
            "layer_data": [
                {
                    "layer_esg_enum": "IBAMA_PROPRIEDADE",
                    "layer_name": "IBAMA - EMBARGOS",
                    "layer_updated_at": "2025-02-20T00:00:00Z",
                    "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": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "TERRAS_INDIGENAS",
                    "layer_name": "FUNAI - TERRAS INDIGENAS",
                    "layer_updated_at": "2025-02-20T00:00:00Z",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["Nome", "Etnia", "Cidade", "Estado", "Modalidade", "Area (ha)", "Fase"],
                    "items": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "UNIDADE_CONSERVACAO",
                    "layer_name": "ICMBIO - UNIDADES DE CONSERVAÇÃO",
                    "layer_updated_at": "2025-02-20T00:00:00Z",
                    "esg_status": "NAO_CONFORME",
                    "total_area": 4.743,
                    "total_issues": 1,
                    "layer_columns": ["Nome", "Sigla", "Categoria", "Cidade", "Estado", "Área (ha)", "Bioma"],
                    "items": [
                        {
                            "item_values": ["ÁREA DE PROTEÇÃO AMBIENTAL CAVERNAS DO PERUAÇU", "APA", "US", "Não informado", "MG", "4,74", "CERRADO"]
                        }
                    ],
                    "geometries": [
                        {
                            "geo_json": "{\"type\":\"Polygon\",\"coordinates\":[...]}",
                            "area": 4.743
                        }
                    ]
                }
            ],
            "prodes_layer_data": [
                {
                    "layer_esg_enum": "PRODES",
                    "layer_name": "INPE - PRODES - AMAZÔNIA",
                    "layer_updated_at": "2025-02-20T00:00:00Z",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "PRODES_CAATINGA",
                    "layer_name": "INPE - PRODES CAATINGA",
                    "layer_updated_at": "2025-02-20T00:00:00Z",
                    "esg_status": "NAO_CONFORME",
                    "total_area": 0.319,
                    "total_issues": 1,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [
                        {
                            "item_values": ["MG", "06/10/2020", "0,32", "desmatamento"]
                        }
                    ],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "PRODES_CERRADO",
                    "layer_name": "INPE - PRODES CERRADO",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "PRODES_MATA_ATLANTICA",
                    "layer_name": "INPE - PRODES MATA ATLÂNTICA",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "PRODES_PANTANAL",
                    "layer_name": "INPE - PRODES PANTANAL",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["State", "Date", "Area (ha)", "Class"],
                    "items": [],
                    "geometries": []
                },
                {
                    "layer_esg_enum": "PRODES_PAMPA",
                    "layer_name": "INPE - PRODES PAMPA",
                    "esg_status": "CONFORME",
                    "total_area": 0.0,
                    "total_issues": 0,
                    "layer_columns": ["Estado", "Data", "Área (ha)", "Classe"],
                    "items": [],
                    "geometries": []
                }
            ],
            "sigef_portions": null,
            "related_farms": null,
            "state_information": null
        }
    ]
}

400 - Bad Request

{
    "timestamp": "string (date-time)",
    "status": "integer (int32)",
    "error": "string"
}

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​