Consultar lançamentos por período

curl --fail-with-body "$RURALZAP_BASE_URL/api/v1/integration/transactions?startDate=2026-01-01&endDate=2026-01-31" \
  -H "Authorization: Bearer $RURALZAP_API_KEY"

// Execute no servidor com Node.js 22+ e tsx. Não registre o payload financeiro.
const base = process.env.RURALZAP_BASE_URL;
const key = process.env.RURALZAP_API_KEY;
if (!base || !key) throw new Error('Configure RURALZAP_BASE_URL e RURALZAP_API_KEY.');
const origin = new URL(base);
if (origin.protocol !== 'https:' || origin.username || origin.password || origin.pathname !== '/' || origin.search || origin.hash) throw new Error('Informe uma origem HTTPS sem caminho ou credenciais.');
const response = await fetch(new URL('/api/v1/integration/transactions?startDate=2026-01-01&endDate=2026-01-31', origin), {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(30000),
  redirect: 'error',
});
if (!response.ok) throw new Error(`HTTP ${response.status}; consulte /guias/erros.`);
const data: unknown = await response.json();
// Valide data com /openapi.json antes de persistir. Preserve decimais como strings.
export { data };

"""Chamada única, Python 3, servidor. Não registra respostas financeiras."""
import json
import os
import urllib.request
from urllib.parse import urlsplit

base = os.environ['RURALZAP_BASE_URL']
key = os.environ['RURALZAP_API_KEY']
origin = urlsplit(base)
if origin.scheme != 'https' or not origin.netloc or origin.username or origin.password or origin.path not in ('', '/') or origin.query or origin.fragment:
    raise ValueError('Informe uma origem HTTPS sem caminho ou credenciais.')

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

request = urllib.request.Request(base.rstrip('/') + '/api/v1/integration/transactions?startDate=2026-01-01&endDate=2026-01-31', headers={'Authorization': 'Bearer ' + key})
with urllib.request.build_opener(NoRedirect).open(request, timeout=30) as response:
    data = json.load(response)
# Valide data com /openapi.json. Preserve dinheiro como string ou Decimal.

{
  "data": [
    {
      "id": "019a1000-0000-7000-8000-000000000001",
      "reference": "#105",
      "type": "INCOME",
      "status": "COMPLETED",
      "amount": "100.0000",
      "reportAmount": "1234.5678",
      "compositionVersion": 0,
      "compositionLines": [],
      "currency": "BRL",
      "description": "Venda sintética de grãos",
      "date": "2026-01-15",
      "competenceDate": null,
      "walletId": null,
      "categoryId": null,
      "categoryName": null,
      "cardId": null,
      "transferSourceWalletId": null,
      "transferDestinationWalletId": null,
      "isAdjustment": false,
      "isInvoicePayment": false,
      "ignored": false,
      "settlementManaged": false,
      "settledPrincipal": "100.0000",
      "settledCashAmount": "100.0000",
      "remainingAmount": "0.0000",
      "settlementStatus": "PAID",
      "createdAt": "2026-10-03T12:00:00.000Z",
      "updatedAt": "2026-10-03T12:00:00.000Z"
    },
    {
      "id": "019a1000-0000-7000-8000-000000000002",
      "reference": "#105",
      "type": "EXPENSE",
      "status": "COMPLETED",
      "amount": "200.0000",
      "reportAmount": "1234.5678",
      "compositionVersion": 0,
      "compositionLines": [],
      "currency": "BRL",
      "description": "Compra sintética de insumos",
      "date": "2026-01-15",
      "competenceDate": null,
      "walletId": null,
      "categoryId": null,
      "categoryName": null,
      "cardId": null,
      "transferSourceWalletId": null,
      "transferDestinationWalletId": null,
      "isAdjustment": false,
      "isInvoicePayment": false,
      "ignored": false,
      "settlementManaged": false,
      "settledPrincipal": "200.0000",
      "settledCashAmount": "200.0000",
      "remainingAmount": "0.0000",
      "settlementStatus": "PAID",
      "createdAt": "2026-10-03T12:00:00.000Z",
      "updatedAt": "2026-10-03T12:00:00.000Z"
    },
    {
      "id": "019a1000-0000-7000-8000-000000000003",
      "reference": "#105",
      "type": "INCOME",
      "status": "COMPLETED",
      "amount": "300.0000",
      "reportAmount": "1234.5678",
      "compositionVersion": 0,
      "compositionLines": [],
      "currency": "BRL",
      "description": "Serviço sintético",
      "date": "2026-01-15",
      "competenceDate": null,
      "walletId": null,
      "categoryId": null,
      "categoryName": null,
      "cardId": null,
      "transferSourceWalletId": null,
      "transferDestinationWalletId": null,
      "isAdjustment": false,
      "isInvoicePayment": false,
      "ignored": false,
      "settlementManaged": false,
      "settledPrincipal": "300.0000",
      "settledCashAmount": "300.0000",
      "remainingAmount": "0.0000",
      "settlementStatus": "PAID",
      "createdAt": "2026-10-03T12:00:00.000Z",
      "updatedAt": "2026-10-03T12:00:00.000Z"
    }
  ],
  "meta": {
    "hasMore": false,
    "nextCursor": null
  }
}