Visualizar consolidado das produções de um cliente

GET

/v2/rural-production/{clientId}/consolidated

Consolida as produções do cliente em três safras — a do ano informado em year, a anterior e a seguinte — e devolve, por cultura, a receita bruta e o custo bruto de cada safra, além dos totais por safra: receita bruta total, custo bruto total, EBITDA (receita menos custo) e margem (EBITDA dividido pela receita, em fração: 0.75 = 75%). O resultado estimado é a média do EBITDA das safras que têm produção cadastrada. A margem vem com 4 casas decimais; o EBITDA e o resultado estimado, com 2. Safras sem produção aparecem com valores zerados. Nas respostas, cada safra é identificada pelo ano de colheita: a safra 24/25 aparece como 2025. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Harvested 200

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Filtro inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/v2/rural-production//consolidated?year=2025&cultures=[%221%22%2C%222%22]' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "cultures": [
        {
            "content": [
                {
                    "crop": "2024",
                    "gross_cost": 0,
                    "gross_income": 0
                },
                {
                    "crop": "2025",
                    "gross_income": 1600000,
                    "gross_cost": 400000
                },
                {
                    "crop": "2026",
                    "gross_cost": 0,
                    "gross_income": 0
                }
            ],
            "culture": "Soja"
        }
    ],
    "total_gross_cost": [
        {
            "crop": "2024",
            "amount": 0
        },
        {
            "crop": "2025",
            "amount": 400000
        },
        {
            "crop": "2026",
            "amount": 0
        }
    ],
    "total_gross_revenue": [
        {
            "crop": "2024",
            "amount": 0
        },
        {
            "crop": "2025",
            "amount": 1600000
        },
        {
            "crop": "2026",
            "amount": 0
        }
    ],
    "ebitda": [
        {
            "crop": "2024",
            "amount": 0
        },
        {
            "crop": "2025",
            "amount": 1200000
        },
        {
            "crop": "2026",
            "amount": 0
        }
    ],
    "margin": [
        {
            "crop": "2024",
            "amount": 0
        },
        {
            "crop": "2025",
            "amount": 0.75
        },
        {
            "crop": "2026",
            "amount": 0
        }
    ],
    "estimated_result": 1200000
}

Modificado em 2026-10-13 09:47:06

Página anterior

Cadastrar produções de um cliente

Próxima página

Exportar consolidado das produções de um cliente (Excel)