Automação: Caderno de Campo

Autenticação: Header x-api-key ou Bearer mv_test_

Acesse as APIs correspondentes aos 11 módulos do aplicativo Caderno de Campo para sincronizar propriedades, talhões, safras, máquinas, almoxarifado, equipes, atividades, DRE rural, conformidade socioambiental, inventário florestal e notas fiscais via X-API-Key do CRM Cloud.

Listagem de FazendasGestão de Matrículas e CARAssociação de Produtores

GET/api/b2b/v1/notebook/properties— Listar propriedades rurais

scope: notebook:readGrátis (Leitura)

Retorna a lista de fazendas vinculadas ao produtor consentido (ou a Fazenda Experimental de Ariquemes/RO em sandbox).

Escopo Exigidonotebook:read

Tarifação CloudGrátis (Leitura)

Acesso Sem CNPJHabilitado (mv_test_)

Consentimento ProdutorObrigatório em Production

Parâmetros e Headers

Nome	Local	Obrigatório	Descrição
userId	query	Opcional	ID do produtor com consentimento ativo para notebook:read (opcional em sandbox).

curl -X GET "https://api.muitoverde.com.br/api/b2b/v1/notebook/properties?userId=UID_PRODUTOR_AUTORIZADO" \
  -H "Authorization: Bearer mv_test_SUA_CHAVE_AQUI" \
  -H "Accept: application/json"

Resposta 200/201 JSON (Exemplo)

{
  "success": true,
  "environment": "sandbox",
  "data": {
    "module": "properties",
    "source": "ariquemes_ro_reference_catalog",
    "count": 1,
    "properties": [
      {
        "id": "prop-ro-ariquemes-ifro-01",
        "name": "Fazenda Experimental IFRO — Ariquemes/RO",
        "municipality": "Ariquemes",
        "state": "RO",
        "carCode": "RO-1100023-8F92A4C1E3B74D09A112C5E80019B2A4",
        "fieldsCount": 4,
        "totalAreaHa": 168.4
      }
    ]
  }
}

POST/api/b2b/v1/notebook/properties— Cadastrar nova propriedade rural

scope: notebook:write1 Crédito Muito VerdeCodeCarbon

Geometria via GeoJSONVinculação de Safra e CulturaCálculo de Área Automático

GET/api/b2b/v1/notebook/fields— Listar talhões da propriedade

scope: fields:readGrátis (Leitura)

Segurança, Isolamento & LGPD Agro

Guia de Onboarding e Consentimento do Produtor (/integrations/authorize)

Abrir Console CRM Cloud

PASSO 1 — CONTA CLOUD

Ative com ou sem CNPJ

Estudantes e desenvolvedores entram pelo Modo Sandbox Pessoal (apenas e-mail verificado, 1.000 Créditos Muito Verde, chave mv_test_). Empresas ativam com CNPJ válido (1.000 créditos iniciais, chaves mv_test_ e mv_live_).

PASSO 2 — CREDENCIAL

Selecione os Escopos da Chave

Ao gerar sua chave no CRM Cloud, marque os escopos necessários: app:read, fields:read, geo:compute, notebook:read, notebook:write, wallet:read, jornada:write e mcp:use.

PASSO 3 — CONSENTIMENTO

Autorização Revogável do Titular

Em sandbox, você pode testar imediatamente usando o catálogo demonstrativo de Ariquemes/RO. Para ler ou gravar dados reais de um produtor, envie o link de consentimento abaixo.

Simulador da URL de Consentimento do seu Aplicativo (Informe o App ID do CRM Cloud)

https://muitoverde.com.br/integrations/authorize?appId=SEU_APP_ID_DO_CRM

Transparência de Custos e Sustentabilidade Computacional

Tabela FinOps (Créditos Muito Verde) & Telemetria CodeCarbon

Leituras HTTP (GET) e repetições idempotentes (idempotentReplay: true) não geram débito de créditos. O débito ocorre exclusivamente na conta Cloud do aplicativo, nunca na Carteira Muito Verde pessoal do usuário.

Segmento / Módulo	Método & Rota	Escopo	Custo (Créditos Muito Verde)	CodeCarbon
Caderno de Campo · Propriedades	GET/api/b2b/v1/notebook/properties	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Propriedades	POST/api/b2b/v1/notebook/properties	notebook:write	1 Crédito Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Campos (Talhões)	GET/api/b2b/v1/notebook/fields	fields:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Produção	GET/api/b2b/v1/notebook/production	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Produção	POST/api/b2b/v1/notebook/production	notebook:write	1 Crédito Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Operações	GET/api/b2b/v1/notebook/operations	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Operações	POST/api/b2b/v1/notebook/operations	notebook:write	1 Crédito Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Estoque	GET/api/b2b/v1/notebook/inventory	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Estoque	POST/api/b2b/v1/notebook/inventory	notebook:write	1 Crédito Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Equipes	GET/api/b2b/v1/notebook/teams	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Atividades	GET/api/b2b/v1/notebook/activities	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Atividades	POST/api/b2b/v1/notebook/activities	notebook:write	1 Crédito Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Financeiro	GET/api/b2b/v1/notebook/finance	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Ambiental	GET/api/b2b/v1/notebook/environment	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Florestal	GET/api/b2b/v1/notebook/forest	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Florestal	POST/api/b2b/v1/notebook/forest	notebook:write	2 Créditos Muito Verde	Ativo (kWh / gCO2eq)
Caderno de Campo · Fiscal	GET/api/b2b/v1/notebook/fiscal	notebook:read	Grátis (Leitura)	Isento (Leitura)
Caderno de Campo · Fiscal	POST/api/b2b/v1/notebook/fiscal	notebook:write	2 Créditos Muito Verde	Ativo (kWh / gCO2eq)
Monitoramento & Satélite · Status de Cobertura (Talhões Monitorados)	GET/api/b2b/v1/geo/fields	fields:read	Grátis (Leitura)	Isento (Leitura)
Monitoramento & Satélite · Índices & Cores (NDVI, NDRE, MSAVI, NDMI, RECI)	POST/api/b2b/v1/geo/spectral-index	geo:compute	5 Créditos (Cache Miss) / 0 (Cache Hit)	Ativo (kWh / gCO2eq)
Monitoramento & Satélite · Gerador Satelital (Tiles PNG & Recortes)	GET/api/b2b/v1/monitoring/images	fields:read	Grátis (Leitura)	Isento (Leitura)
Monitoramento & Satélite · Manejo (Zonas K-Means)	GET/api/b2b/v1/monitoring/management-zones	fields:read	Grátis (Leitura)	Isento (Leitura)
Monitoramento & Satélite · Manejo (Zonas K-Means)	POST/api/b2b/v1/monitoring/management-zones	geo:compute	5 Créditos Muito Verde	Ativo (kWh / gCO2eq)
Monitoramento & Satélite · Relatórios (Laudos PDF)	GET/api/b2b/v1/monitoring/reports	fields:read	Grátis (Leitura)	Isento (Leitura)
Monitoramento & Satélite · Relatórios (Laudos PDF)	POST/api/b2b/v1/monitoring/reports	geo:compute	5 Créditos Muito Verde	Ativo (kWh / gCO2eq)
Recompensas & Carteira · Saldos da Carteira Muito Verde	GET/api/b2b/v1/wallet/balance	wallet:read	Grátis (Leitura Consentida)	Isento (Leitura)
Recompensas & Carteira · Impacto & Gamificação (Jornada Muito Verde)	POST/api/b2b/v1/jornada/event	jornada:write	Grátis (Bonificação de Impacto)	Isento (Leitura)
FinOps, Auth & MCP · Servidor MCP Oficial (Google Antigravity)	POST/api/b2b/v1/mcp	mcp:use	0 na descoberta (Tools tarifadas conforme uso)	Ativo (kWh / gCO2eq)
FinOps, Auth & MCP · Servidor MCP Oficial (Google Antigravity)	GET/api/b2b/v1/apps/me	app:read	Grátis (Diagnóstico de Credencial)	Isento (Leitura)
FinOps, Auth & MCP · Eco-FinOps, Assinaturas & CodeCarbon API Meter	POST/api/b2b/v1/meter/consume	meter:write	Variável conforme action (ex: 1 a 15 créditos)	Ativo (kWh / gCO2eq)
FinOps, Auth & MCP · Eco-FinOps, Assinaturas & CodeCarbon API Meter	GET/api/b2b/v1/subscriptions/status	subscriptions:read	Grátis (Leitura Consentida)	Isento (Leitura)
FinOps, Auth & MCP · Venda & Faturamento Embutido (Embedded Partner Billing)	POST/api/b2b/v1/checkout/sessions	checkout:write	Grátis (Operação Financeira)	Isento (Leitura)
FinOps, Auth & MCP · Venda & Faturamento Embutido (Embedded Partner Billing)	POST/api/b2b/v1/meter/charge	billing:charge	Conforme action (ex: 1 a 20 créditos)	Ativo (kWh / gCO2eq)

Nome

Local

Obrigatório

Descrição

userId

query

Opcional

ID do produtor com consentimento ativo para notebook:read (opcional em sandbox).

{ "success": true, "environment": "sandbox", "data": { "module": "properties", "source": "ariquemes_ro_reference_catalog", "count": 1, "properties": [ { "id": "prop-ro-ariquemes-ifro-01", "name": "Fazenda Experimental IFRO — Ariquemes/RO", "municipality": "Ariquemes", "state": "RO", "carCode": "RO-1100023-8F92A4C1E3B74D09A112C5E80019B2A4", "fieldsCount": 4, "totalAreaHa": 168.4 } ] } }

Segmento / Módulo

Método & Rota

Escopo

Custo (Créditos Muito Verde)

CodeCarbon

Caderno de Campo · Propriedades

GET/api/b2b/v1/notebook/properties

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Propriedades

POST/api/b2b/v1/notebook/properties

notebook:write

1 Crédito Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Campos (Talhões)

GET/api/b2b/v1/notebook/fields

fields:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Produção

GET/api/b2b/v1/notebook/production

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Produção

POST/api/b2b/v1/notebook/production

notebook:write

1 Crédito Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Operações

GET/api/b2b/v1/notebook/operations

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Operações

POST/api/b2b/v1/notebook/operations

notebook:write

1 Crédito Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Estoque

GET/api/b2b/v1/notebook/inventory

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Estoque

POST/api/b2b/v1/notebook/inventory

notebook:write

1 Crédito Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Equipes

GET/api/b2b/v1/notebook/teams

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Atividades

GET/api/b2b/v1/notebook/activities

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Atividades

POST/api/b2b/v1/notebook/activities

notebook:write

1 Crédito Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Financeiro

GET/api/b2b/v1/notebook/finance

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Ambiental

GET/api/b2b/v1/notebook/environment

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Florestal

GET/api/b2b/v1/notebook/forest

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Florestal

POST/api/b2b/v1/notebook/forest

notebook:write

2 Créditos Muito Verde

Ativo (kWh / gCO2eq)

Caderno de Campo · Fiscal

GET/api/b2b/v1/notebook/fiscal

notebook:read

Grátis (Leitura)

Isento (Leitura)

Caderno de Campo · Fiscal

POST/api/b2b/v1/notebook/fiscal

notebook:write

2 Créditos Muito Verde

Ativo (kWh / gCO2eq)

Monitoramento & Satélite · Status de Cobertura (Talhões Monitorados)

GET/api/b2b/v1/geo/fields

fields:read

Grátis (Leitura)

Isento (Leitura)

Monitoramento & Satélite · Índices & Cores (NDVI, NDRE, MSAVI, NDMI, RECI)

POST/api/b2b/v1/geo/spectral-index

geo:compute

5 Créditos (Cache Miss) / 0 (Cache Hit)

Ativo (kWh / gCO2eq)

Monitoramento & Satélite · Gerador Satelital (Tiles PNG & Recortes)

GET/api/b2b/v1/monitoring/images

fields:read

Grátis (Leitura)

Isento (Leitura)

Monitoramento & Satélite · Manejo (Zonas K-Means)

GET/api/b2b/v1/monitoring/management-zones

fields:read

Grátis (Leitura)

Isento (Leitura)

Monitoramento & Satélite · Manejo (Zonas K-Means)

POST/api/b2b/v1/monitoring/management-zones

geo:compute

5 Créditos Muito Verde

Ativo (kWh / gCO2eq)

Monitoramento & Satélite · Relatórios (Laudos PDF)

GET/api/b2b/v1/monitoring/reports

fields:read

Grátis (Leitura)

Isento (Leitura)

Monitoramento & Satélite · Relatórios (Laudos PDF)

POST/api/b2b/v1/monitoring/reports

geo:compute

5 Créditos Muito Verde

Ativo (kWh / gCO2eq)

Recompensas & Carteira · Saldos da Carteira Muito Verde

GET/api/b2b/v1/wallet/balance

wallet:read

Grátis (Leitura Consentida)

Isento (Leitura)

Recompensas & Carteira · Impacto & Gamificação (Jornada Muito Verde)

POST/api/b2b/v1/jornada/event

jornada:write

Grátis (Bonificação de Impacto)

Isento (Leitura)

FinOps, Auth & MCP · Servidor MCP Oficial (Google Antigravity)

POST/api/b2b/v1/mcp

mcp:use

0 na descoberta (Tools tarifadas conforme uso)

Ativo (kWh / gCO2eq)

FinOps, Auth & MCP · Servidor MCP Oficial (Google Antigravity)

GET/api/b2b/v1/apps/me

app:read

Grátis (Diagnóstico de Credencial)

Isento (Leitura)

FinOps, Auth & MCP · Eco-FinOps, Assinaturas & CodeCarbon API Meter

POST/api/b2b/v1/meter/consume

meter:write

Variável conforme action (ex: 1 a 15 créditos)

Ativo (kWh / gCO2eq)

FinOps, Auth & MCP · Eco-FinOps, Assinaturas & CodeCarbon API Meter

GET/api/b2b/v1/subscriptions/status

subscriptions:read

Grátis (Leitura Consentida)

Isento (Leitura)

FinOps, Auth & MCP · Venda & Faturamento Embutido (Embedded Partner Billing)

POST/api/b2b/v1/checkout/sessions

checkout:write

Grátis (Operação Financeira)

Isento (Leitura)

FinOps, Auth & MCP · Venda & Faturamento Embutido (Embedded Partner Billing)

POST/api/b2b/v1/meter/charge

billing:charge

Conforme action (ex: 1 a 20 créditos)

Ativo (kWh / gCO2eq)

Developer Portal Muito Verde

Automação: Caderno de Campo

Propriedades

Parâmetros e Headers

Campos (Talhões)

Produção

Operações

Estoque

Equipes

Atividades

Financeiro

Ambiental

Florestal

Fiscal

Guia de Onboarding e Consentimento do Produtor (/integrations/authorize)

Ative com ou sem CNPJ

Selecione os Escopos da Chave

Autorização Revogável do Titular

Tabela FinOps (Créditos Muito Verde) & Telemetria CodeCarbon

Developer Portal Muito Verde

Automação: Caderno de Campo

Propriedades

Parâmetros e Headers

Campos (Talhões)

Produção

Operações

Estoque

Equipes

Atividades

Financeiro

Ambiental

Florestal

Fiscal

Guia de Onboarding e Consentimento do Produtor (/integrations/authorize)

Ative com ou sem CNPJ

Selecione os Escopos da Chave

Autorização Revogável do Titular

Tabela FinOps (Créditos Muito Verde) & Telemetria CodeCarbon