{"openapi":"3.1.0","info":{"title":"Muito Verde API","version":"0.4.0","description":"Contrato oficial da Plataforma Muito Verde Cloud (Sandbox e Production). Inclui os 11 módulos de Automação do Caderno de Campo, os 5 módulos de Monitoramento Orbital Sentinel-2 (Alvo Certo), Carteira Muito Verde, Jornada Muito Verde, Eco-FinOps CodeCarbon e Servidor MCP nativo para Google Antigravity."},"servers":[{"url":"https://api.muitoverde.com.br","description":"Gateway oficial da API Muito Verde Cloud."}],"paths":{"/api/b2b/v1/notebook/properties":{"get":{"operationId":"get_notebook_properties","summary":"Listar propriedades rurais","description":"Retorna a lista de fazendas vinculadas ao produtor consentido (ou a Fazenda Experimental de Ariquemes/RO em sandbox).","parameters":[{"name":"userId","in":"query","required":false,"description":"ID do produtor com consentimento ativo para notebook:read (opcional em sandbox).","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"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}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_properties","summary":"Cadastrar nova propriedade rural","description":"Insere uma nova unidade produtiva auditada via API com Idempotency-Key e telemetria CodeCarbon.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência (8 a 120 caracteres).","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"environment":"sandbox","data":{"module":"properties","status":"created","propertyId":"prop_nbk_prop_001","name":"Fazenda Boa Esperança — Setor Cacau","totalAreaHa":350,"billing":{"creditsCharged":1,"remainingCredits":99,"idempotentReplay":false}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/fields":{"get":{"operationId":"get_notebook_fields","summary":"Listar talhões da propriedade","description":"Recupera os recortes geográficos ativos, cultura principal e geometria GeoJSON WGS84.","parameters":[{"name":"propertyId","in":"query","required":false,"description":"Filtra talhões pelo ID da fazenda.","schema":{"type":"string"}},{"name":"userId","in":"query","required":false,"description":"ID do produtor com consentimento ativo para fields:read.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"fields:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"environment":"sandbox","data":{"module":"fields","count":4,"fields":[{"id":"ro-ariquemes-cacau-saf-01","name":"Talhão 01 — Cacau Clonal em SAF","crop":"Cacau (Theobroma cacao)","areaHa":18.4}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/production":{"get":{"operationId":"get_notebook_production","summary":"Consultar lotes e romaneios de colheita","description":"Lista tickets de pesagem, lotes colhidos e planos produtivos por talhão.","parameters":[{"name":"fieldId","in":"query","required":false,"description":"Filtra a produção pelo ID do talhão.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"production","tickets":[{"ticketId":"tk_ro_2026_101","fieldId":"ro-ariquemes-soja-graos-04","truckPlate":"ROX-4E26","grossWeightKg":42500,"tareWeightKg":14500,"liquidWeightKg":27720,"sacks60Kg":462,"status":"processed"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_production","summary":"Registrar romaneio de balança","description":"Registra peso bruto e tara da colheita associada ao talhão e calcula peso líquido/sacas.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"production","status":"processed","ticketId":"tk_romaneio_001","liquidWeightKg":27500,"sacks60Kg":458.33,"billing":{"creditsCharged":1,"remainingCredits":98}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/operations":{"get":{"operationId":"get_notebook_operations","summary":"Listar parque de máquinas e horímetros","description":"Lista tratores, pulverizadores e colheitadeiras vitais da operação.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"operations","count":3,"machines":[{"id":"maq_jd_6150j","name":"Trator John Deere 6150J","powerHp":150,"hourmeterHours":1482.5,"fuelType":"DIESEL_S10"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_operations","summary":"Sincronizar horímetro e telemetria de máquina","description":"Atualiza o horímetro e o consumo de combustível da máquina via API.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"operations","status":"synchronized","machineId":"maq_jd_6150j","hourmeterHours":1490,"billing":{"creditsCharged":1}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/inventory":{"get":{"operationId":"get_notebook_inventory","summary":"Consultar saldos de insumos no almoxarifado","description":"Apresenta a quantidade física, lote, validade e custo médio em armazém.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"inventory","items":[{"itemId":"ins_bio_trichoderma_01","name":"Biofungicida Trichoderma harzianum","unit":"L","availableStock":420,"averageUnitCostBrl":68.5}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_inventory","summary":"Registrar consumo/baixa de insumo","description":"Remove item do saldo via consumo em aplicação no campo de forma idempotente.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"inventory","status":"stock_updated","itemId":"ins_bio_trichoderma_01","usedAmount":25,"remainingStockEstimate":395,"billing":{"creditsCharged":1}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/teams":{"get":{"operationId":"get_notebook_teams","summary":"Listar equipes e operadores de campo","description":"Retorna equipes operacionais e certificações técnicas sincronizadas no app.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"teams","count":2,"teams":[{"teamId":"team_ro_agroflorestal_01","name":"Equipe Manejo Agroflorestal & Perenes (Cacau/Café)","members":[{"id":"op_01","name":"Carlos Eduardo Mendes","role":"AGRONOMIST"}]}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/activities":{"get":{"operationId":"get_notebook_activities","summary":"Listar atividades e Ordens de Serviço de campo","description":"Lista atividades concluídas, em andamento e programadas por talhão.","parameters":[{"name":"fieldId","in":"query","required":false,"description":"Filtra atividades pelo ID do talhão.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"activities","count":3,"activities":[{"activityId":"act_ro_2026_801","fieldId":"ro-ariquemes-cacau-saf-01","title":"Aplicação de Bioinsumo Trichoderma e Poda Fitosanitária","status":"CONCLUIDA"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_activities","summary":"Registrar Ordem de Serviço agrícola","description":"Agenda ou registra uma aplicação no talhão vinculada aos insumos utilizados.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"activities","status":"scheduled","activityId":"act_os_2026_01","fieldId":"ro-ariquemes-cacau-saf-01","billing":{"creditsCharged":1}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/finance":{"get":{"operationId":"get_notebook_finance","summary":"Consultar DRE Rural Consolidada e custo por hectare","description":"Retorna Receita Operacional Bruta, Custos Diretos/Indiretos, EBITDA e custo por hectare por cultura.","parameters":[{"name":"propertyId","in":"query","required":false,"description":"ID da propriedade rural.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"finance","season":"2025/2026","dreSummary":{"grossOperatingRevenueBrl":1485000,"directProductionCostsBrl":642000,"ebitdaBrl":600500,"ebitdaMarginPct":40.44}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/environment":{"get":{"operationId":"get_notebook_environment","summary":"Consultar Dossiê Ambiental, CAR e Indicadores ESG","description":"Retorna status do CAR, Reserva Legal, APP, EUDR e indicadores ESG.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"environment","carRegistration":{"carCode":"RO-1100023-8F92A4C1E3B74D09A112C5E80019B2A4","status":"ATIVO_REGULAR","legalReservePct":80.2,"eudrCompliant":true},"esgIndicators":{"waterUseEfficiencyIndex":94.2,"soilCarbonStockTonCo2ePerHa":142.8}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/forest":{"get":{"operationId":"get_notebook_forest","summary":"Consultar inventários florestais e planos de silvicultura","description":"Lista inventários de parcelas florestais, volume em pé (m³/ha) e carbono estocado.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"forest","inventories":[{"plotId":"plot_saf_castanheira_01","fieldId":"ro-ariquemes-cacau-saf-01","meanDapCm":28.4,"estimatedStandingVolumeM3PerHa":86.5,"estimatedBiomassCarbonTonCo2ePerHa":118.4}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_forest","summary":"Registrar parcela de inventário florestal e calcular cubagem","description":"Registra árvores amostradas (DAP e altura) e retorna o cálculo volumétrico e de carbono.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":2,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"forest","status":"inventory_computed","volumeM3":4.15,"carbonStockTonCo2e":5.6,"billing":{"creditsCharged":2}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/notebook/fiscal":{"get":{"operationId":"get_notebook_fiscal","summary":"Listar Notas Fiscais Rurais (NFe) arquivadas","description":"Retorna notas fiscais de compra de insumos e venda de produção integradas ao estoque.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"fiscal","count":2,"invoices":[{"invoiceId":"nfe_ro_2026_001094","number":"1094","supplierName":"Cooperativa Agroindustrial de Ariquemes","totalAmountBrl":63825,"stockIntegrated":true}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_notebook_fiscal","summary":"Importar e parsear XML de NFe Rural","description":"Processa o XML da nota fiscal e gera entrada correspondente no almoxarifado.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"notebook:write","x-credits-cost":2,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"fiscal","status":"parsed_and_archived","parsed":true,"nfNumber":"1189","stockEntryGenerated":true,"billing":{"creditsCharged":2}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/geo/fields":{"get":{"operationId":"get_geo_fields","summary":"Listar talhões monitorados e polígonos GeoJSON","description":"Consulta os 4 talhões de referência em Ariquemes/RO e os talhões reais do produtor que concedeu fields:read.","parameters":[{"name":"userId","in":"query","required":false,"description":"Opcional. ID do produtor com consentimento ativo para fields:read.","schema":{"type":"string"}},{"name":"includeDemo","in":"query","required":false,"description":"Padrão true. Inclui os 4 talhões de referência de Ariquemes/RO.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"fields:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"environment":"sandbox","data":{"referenceCount":4,"userFieldsCount":0,"fields":[{"id":"ro-ariquemes-cacau-saf-01","name":"Talhão 01 — Cacau Clonal em SAF","municipality":"Ariquemes","state":"RO","crop":"Cacau (Theobroma cacao)","areaHa":18.4}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/geo/spectral-index":{"post":{"operationId":"post_geo_spectral-index","summary":"Calcular índice espectral e matriz de calor Sentinel-2","description":"Calcula estatísticas (mean, min, max, stdDev, p10, p50, p90), grade espacial 12x12, série histórica e evidência verificável para a Jornada Muito Verde.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única da execução (8 a 120 caracteres).","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"geo:compute","x-credits-cost":5,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"executionId":"a91f4c08-73bc-4d19-9a0b-508b22019c14","fieldName":"Polígono de Teste — Ariquemes/RO","indexType":"NDVI","stats":{"mean":0.784,"min":0.612,"max":0.891,"p10":0.665,"p50":0.791,"p90":0.858},"diagnostic":{"vigorClass":"ALTO","summary":"Dossel com biomassa fotossinteticamente ativa elevada e uniforme."},"vectorLayer":{"type":"FeatureCollection","features":[]},"metering":{"costCredits":5,"ecoFinOps":{"durationMs":42,"energyKwh":0.0000012,"carbonGramsCo2eq":0.00046}}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/monitoring/images":{"get":{"operationId":"get_monitoring_images","summary":"Consultar imagens e camadas satelitais do talhão","description":"Retorna as URLs das camadas recortadas e metadados de passagem do satélite Sentinel-2.","parameters":[{"name":"fieldId","in":"query","required":true,"description":"ID do talhão (ex: ro-ariquemes-cacau-saf-01).","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Data da cena no formato YYYY-MM-DD.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"fields:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"images","fieldId":"ro-ariquemes-cacau-saf-01","satellite":"Sentinel-2A/2B L2A (ESA Copernicus)","cloudCoverPct":3.8,"layers":{"rgbTrueColorTileUrl":"https://api.muitoverde.com.br/images/sentinel2/ro-ariquemes-cacau-saf-01/2026-10-12/rgb.png","ndviHeatmapTileUrl":"https://api.muitoverde.com.br/images/sentinel2/ro-ariquemes-cacau-saf-01/2026-10-12/ndvi.png"}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/monitoring/management-zones":{"get":{"operationId":"get_monitoring_management-zones","summary":"Consultar zonas de manejo do talhão","description":"Retorna as 3 zonas de manejo (Baixo, Médio e Alto vigor) com área (ha) e recomendação.","parameters":[{"name":"fieldId","in":"query","required":true,"description":"ID do talhão.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"fields:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"management-zones","fieldId":"ro-ariquemes-cacau-saf-01","clustersCount":3,"zones":[{"zoneId":"Z1_BAIXO_VIGOR","sharePct":18,"meanNdvi":0.56,"colorHex":"#eab308"},{"zoneId":"Z2_MEDIO_VIGOR","sharePct":49,"meanNdvi":0.73,"colorHex":"#22c55e"},{"zoneId":"Z3_ALTO_VIGOR","sharePct":33,"meanNdvi":0.84,"colorHex":"#15803d"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_monitoring_management-zones","summary":"Processar nova grade de Zonas de Manejo (K-Means)","description":"Dispara a clusterização K-Means sobre o talhão com tarifação de 5 Créditos Muito Verde.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"geo:compute","x-credits-cost":5,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"jobId":"mz_ro_2026_001","status":"completed","clustersRequested":3,"billing":{"creditsCharged":5}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/monitoring/reports":{"get":{"operationId":"get_monitoring_reports","summary":"Listar laudos técnicos gerados para o talhão","description":"Lista os relatórios e laudos PDF disponíveis para download.","parameters":[{"name":"fieldId","in":"query","required":false,"description":"ID do talhão.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"fields:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"module":"reports","reports":[{"reportId":"rep_ro_ariquemes_2026_01","fieldId":"ro-ariquemes-cacau-saf-01","title":"Laudo Técnico Agroambiental & Diagnóstico Espectral Sentinel-2","eudrComplianceStatus":"CONFORME"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}},"post":{"operationId":"post_monitoring_reports","summary":"Gerar novo Laudo Técnico PDF assinado","description":"Compila o relatório PDF de vistoria espectral e dossiê CAR do talhão.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única de idempotência.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"geo:compute","x-credits-cost":5,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"reportId":"rep_laudo_001","status":"completed","eudrComplianceVerified":true,"downloadUrl":"https://api.muitoverde.com.br/reports/b2b/ro-ariquemes-cacau-saf-01/rep_laudo_001.pdf","billing":{"creditsCharged":5}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/wallet/balance":{"get":{"operationId":"get_wallet_balance","summary":"Consultar saldos da Carteira Muito Verde, Créditos e Pontos do usuário","description":"Exige consentimento ativo do titular em /integrations/authorize para o escopo wallet:read. Não movimenta recursos financeiros.","parameters":[{"name":"userId","in":"query","required":true,"description":"ID do usuário na Muito Verde que autorizou wallet:read.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"wallet:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"userId":"uid_produtor_ro_01","wallet":{"availableBrl":1250,"reservedBrl":0,"currency":"BRL"},"credits":{"available":340,"unit":"Créditos Muito Verde"},"rewards":{"balance":1540,"currency":"Pontos Muito Verde"}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/jornada/event":{"post":{"operationId":"post_jornada_event","summary":"Registrar evento auditável na Jornada Muito Verde","description":"Valida a evidência (ex: executionId de uma análise espectral em b2b_service_executions) e concede XP sem duplicação em caso de retry.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Identificador único do evento externo (8 a 120 caracteres).","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"jornada:write","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"impactEventId":"imp_99201a","eventType":"SPECTRAL_INDEX_ANALYZED","xpAwarded":100,"totalXp":600,"level":2,"idempotentReplay":false}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/mcp":{"post":{"operationId":"post_mcp","summary":"Endpoint JSON-RPC 2.0 do Servidor MCP Muito Verde Cloud","description":"Suporta initialize, tools/list, tools/call, resources/list e resources/read autenticados pela chave do aplicativo.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"mcp:use","x-credits-cost":0,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"jsonrpc":"2.0","id":1,"result":{"tools":[{"name":"mv_get_app_profile"},{"name":"mv_list_fields"},{"name":"mv_calculate_spectral_index"},{"name":"mv_query_field_notebook"},{"name":"mv_manage_monitoring"},{"name":"mv_get_wallet_balance"},{"name":"mv_record_jornada_event"},{"name":"mv_get_webapp_starter_blueprint"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/apps/me":{"get":{"operationId":"get_apps_me","summary":"Inspecionar aplicativo, ambiente, tier da conta e saldo de Créditos Muito Verde","description":"Retorna appId, accountId, accountTier (email_sandbox ou business_cnpj), environment (sandbox ou production), scopes e creditsBalance.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"app:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"appId":"7f8c9d10-1234-4a5b-8c9d-0123456789ab","accountTier":"email_sandbox","environment":"sandbox","scopes":["app:read","fields:read","geo:compute","notebook:read","mcp:use"],"creditsBalance":100}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/meter/consume":{"post":{"operationId":"post_meter_consume","summary":"Consumir Créditos Muito Verde e registrar telemetria CodeCarbon","description":"Debita o saldo pré-pago da conta Cloud com Idempotency-Key e calcula energia e pegada de carbono da execução.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única da execução (8 a 120 caracteres).","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"meter:write","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"executionId":"exec_8812a","action":"custom.backend.route","costCredits":1,"balanceBefore":100,"balanceAfter":99,"ecoFinOps":{"energyKwh":0.0000018,"carbonGramsCo2eq":0.00014,"region":"southamerica-east1"}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/subscriptions/status":{"get":{"operationId":"get_subscriptions_status","summary":"Consultar status de assinaturas autorizadas do usuário","description":"Retorna o tier global e as assinaturas ativas do usuário que concedeu subscriptions:read.","parameters":[{"name":"userId","in":"query","required":true,"description":"ID do usuário na Muito Verde que autorizou subscriptions:read.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"subscriptions:read","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"userId":"uid_produtor_ro_01","globalPlatformTier":"PRO","subscriptions":[{"id":"sub_01","product_code":"CADERNO_VERDE_PRO","status":"ACTIVE","cycle":"MONTHLY","value":149.9,"currency":"BRL"}]}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/checkout/sessions":{"post":{"operationId":"post_checkout_sessions","summary":"Criar sessão de checkout / venda de créditos para o cliente do aplicativo","description":"Gera link de pagamento e PIX dinâmico EMVCo com entrega automática de Créditos Muito Verde e consolidação no ERP.","parameters":[],"security":[{"PartnerKey":[]}],"x-required-scope":"checkout:write","x-credits-cost":0,"x-codecarbon-measured":false,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"session":{"id":"chk_9182a","title":"Pacote 5.000 Créditos Muito Verde","amount_cents":29900,"credits_granted":5000,"status":"open"},"checkoutUrl":"https://muitoverde.com.br/checkout/session/chk_9182a","pix":{"copyPaste":"00020126580014br.gov.bcb.pix...","qrCodeUrl":"https://api.qrserver.com/..."}}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}},"/api/b2b/v1/meter/charge":{"post":{"operationId":"post_meter_charge","summary":"Cobrança direta de operação / serviço embutido no aplicativo","description":"Debita créditos atribuídos ao cliente final ou empresa e registra telemetria computacional e energética CodeCarbon.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave única da execução financeira.","schema":{"type":"string"}}],"security":[{"PartnerKey":[]}],"x-required-scope":"billing:charge","x-credits-cost":1,"x-codecarbon-measured":true,"x-supports-email-sandbox":true,"responses":{"200":{"description":"Operação autorizada.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"partner":{"type":"string"},"data":{"success":true,"data":{"executionId":"exec_charge_01","action":"custom.backend.route","costCredits":1,"balanceBefore":5000,"balanceAfter":4999}}}}}}},"400":{"description":"Parâmetro ou JSON inválido.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Chave ausente, legada, inválida, expirada ou inativa.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"403":{"description":"Escopo ou consentimento de usuário ausente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"429":{"description":"Limite por credencial excedido; Retry-After: 60.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}},"503":{"description":"Serviço indisponível ou migration pendente.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}}}}}}}}},"components":{"securitySchemes":{"PartnerKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Credencial mv_test_ (sandbox) ou mv_live_ (production) emitida no CRM Cloud e armazenada exclusivamente no backend ou Servidor MCP."}},"schemas":{"Error":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"}}}}},"Scope":{"type":"string","enum":["app:read","wallet:read","subscriptions:read","meter:write","jornada:write","fields:read","geo:compute","mcp:use","notebook:read","notebook:write","checkout:write","billing:charge"]}}},"x-consent":{"origin":"https://muitoverde.com.br","path":"/integrations/authorize?appId={appId}","grantEndpoint":"/api/integrations/grants","authentication":"Firebase ID token da própria pessoa, emitido pela Muito Verde; e-mail verificado. Não usar a chave do app para conceder consentimento.","expirationDays":{"default":7,"max":30}}}