Guia: Compliance Ambiental

Fluxos para gerar relatórios de compliance ambiental. Os quatro relatórios são independentes entre si — não há ordem obrigatória — e cada um é processado de forma síncrona (a resposta HTTP já traz o relatório gerado, com timeout de 30s).

Como o produtor é identificado

O produtor não é identificado por producer_id nestes endpoints. A identificação é feita por:

• producer_document — CPF ou CNPJ, com ou sem pontuação
• producer_name — nome do produtor

Se o produtor já estiver nos Cadastros com o mesmo documento, o sistema resolve o vínculo automaticamente e devolve o producer_id interno no campo producer_data.producer_id da resposta. Caso contrário, o relatório é gerado a partir dos dados informados na requisição — o cadastro prévio não é pré-requisito.

O mesmo vale para a propriedade: ela é identificada pelo código CAR (car / cars[]), não por farm_id.

Visão geral dos relatórios

Relatório	Identificação do produtor	CAR
EUDR	producer_document + producer_name (ambos obrigatórios)	car obrigatório
Socioambiental (ESG)	producer_document ou car (pelo menos um)	car condicional
CBIOS	producer_document + producer_name (ambos obrigatórios)	cars[] opcional
2BSVS	producer_document + producer_name (ambos obrigatórios)	cars[] obrigatório

Socioambiental (ESG)

Gera um relatório pré-invoice de compliance socioambiental. A identificação aceita CAR, documento do produtor, ou ambos — pelo menos um é obrigatório.

Identificação flexível:

• Informando apenas o CAR: o sistema analisa apenas aquele CAR.
• Informando apenas o documento: o sistema analisa apenas o produtor.
• Informando ambos: analisa aquele CAR e vincula o produtor pelo documento.

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

Campos do corpo:

Campo	Tipo	Obrigatório	Observação
car	String	Condicional	Pelo menos um entre car e producer_document
producer_document	String	Condicional	CPF ou CNPJ, com ou sem pontuação. Pelo menos um entre car e producer_document
producer_name	String	Não

A resposta traz esg_status_summary (CONFORME / NAO_CONFORME / NAO_ENCONTRADO / PROCESSANDO), além do detalhamento por CAR no array esg[]. Detalhes completos em Gerar Relatório Socioambiental.

EUDR — Análise de Desmatamento (CAR)

Relatório de conformidade com o Regulamento de Desmatamento da União Europeia. Todos os três campos são obrigatórios.

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

Campo	Tipo	Obrigatório
car	String	Sim
producer_name	String	Sim
producer_document	String (CPF/CNPJ)	Sim

Detalhes completos em Gerar Relatório EUDR.

CBIOS — Créditos de Descarbonização

Verifica elegibilidade para geração de CBIOS (RenovaBio) analisando supressão de vegetação e produtividade.

curl -X POST \
  https://api.merx.tech/api/v1/integration/cbios/report \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "producer_name": "João da Silva",
    "producer_document": "12345678901",
    "civil_year": 2024,
    "harvest_code": 2024,
    "layer": "SOY",
    "cars": ["MT-5107925-7515B28AEE9240ACAB464D8DF624D470"]
  }'

Campo	Tipo	Obrigatório
producer_name	String	Sim
producer_document	String (CPF/CNPJ)	Sim
civil_year	Integer	Sim
harvest_code	Integer	Sim
layer	Enum: SOY, CORN	Sim
cars	Array de strings (CAR)	Não

Detalhes completos em Gerar Relatório CBIOS.

2BSVS — Biomass-Based Voluntary Sustainability

Verifica conformidade com critérios 2BSVS (supressão, APP, reserva legal, áreas protegidas).

curl -X POST \
  https://api.merx.tech/api/v1/integration/bsvs/report \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "producer_name": "João da Silva",
    "cooperative_name": "Cooperativa ABC",
    "producer_document": "12345678901",
    "civil_year": 2024,
    "harvest_code": 2024,
    "layer": "SOY",
    "cars": ["MT-5107925-7515B28AEE9240ACAB464D8DF624D470"]
  }'

Campo	Tipo	Obrigatório
producer_name	String	Sim
cooperative_name	String	Sim
producer_document	String (CPF/CNPJ)	Sim
civil_year	Integer	Sim
harvest_code	Integer	Sim
layer	Enum: SOY, CORN	Sim
cars	Array de strings (CAR)	Sim

Detalhes completos em Gerar Relatório 2BSVS.