📝 Exemplos Request/Response - ecosif-querys

📋 Visão Geral

Este documento contém exemplos práticos de requisições e respostas para todos os endpoints.

💰 Consultar Saldo

Request

POST /balanceInquiryDetails
Authorization: Bearer <token>
Content-Type: application/json

{
  "contaId": 100,
  "empresa": "00001",
  "filial": "00001",
  "anomesini": "01/2025",
  "anomesfim": "11/2025",
  "comboType": "ALL"
}

Response (200 OK)

[
  {
    "year": "2025",
    "month": "01",
    "movdeb": 10000.00,
    "movcred": 5000.00,
    "movenc": 0.0,
    "accumulatedBalance": 15000.00,
    "openingBalance": 0.0
  },
  {
    "year": "2025",
    "month": "02",
    "movdeb": 5000.00,
    "movcred": 3000.00,
    "accumulatedBalance": 17000.00,
    "openingBalance": 0.0
  }
]

📋 Consultar Razão Geral

Request

POST /generalLedgerQuery
Authorization: Bearer <token>
Content-Type: application/json

{
  "contaId": 100,
  "empresa": "00001",
  "filial": "00001",
  "year": 2025,
  "month": 11,
  "dayStart": 1,
  "dayEnd": 30
}

Response (200 OK)

[
  {
    "lote": "001",
    "documento": "000001",
    "entry": "001",
    "debCre": "D",
    "day": "15",
    "history": "Lançamento teste",
    "value": "1000.00",
    "cdContabil": "1.1.01"
  },
  {
    "lote": "001",
    "documento": "000001",
    "entry": "002",
    "debCre": "C",
    "day": "15",
    "history": "Contrapartida",
    "value": "1000.00",
    "cdContabil": "1.2.01"
  }
]

📊 Listar Plano de Contas

Request

GET /allChartOfAccount/00001/00001
Authorization: Bearer <token>

Response (200 OK)

[
  {
    "id": 1,
    "cdAccounting": "1",
    "cdReduced": "1"
  },
  {
    "id": 2,
    "cdAccounting": "1.1",
    "cdReduced": "1.1"
  },
  {
    "id": 3,
    "cdAccounting": "1.1.01",
    "cdReduced": "1.1.01"
  }
]

❌ Erros Comuns

400 Bad Request

{
  "message": "Formato de ano/mês inicial inválido. Use MM/YYYY",
  "timestamp": "2025-11-27T10:00:00",
  "status": 400,
  "error": "Bad Request"
}

403 Forbidden

{
  "message": "Acesso negado - usuário não tem permissão para acessar esta empresa/filial",
  "timestamp": "2025-11-27T10:00:00",
  "status": 403,
  "error": "Forbidden"
}

Última Atualização: 2025-11-27