Financeiro

Gerencie registros financeiros do escritório: honorários, despesas, custos processuais e receitas.

GET /v1/financial

Lista todos os registros financeiros.

Query Parameters

Parâmetro	Tipo	Padrão	Descrição
`page`	number	1	Página atual
`limit`	number	20	Itens por página (máx: 100)
`type`	string	-	Filtrar por tipo: `revenue`, `expense`, `cost`
`status`	string	-	Filtrar por status: `pending`, `paid`, `cancelled`
`category`	string	-	Filtrar por categoria
`case_id`	string	-	Filtrar por processo
`client_id`	string	-	Filtrar por cliente
`from`	string	-	Data inicial (YYYY-MM-DD)
`to`	string	-	Data final (YYYY-MM-DD)
`sort`	string	`-date`	Ordenação

Request

curl -X GET "https://api.juspilot.co/v1/financial?type=revenue&status=pending" \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "fin_abc123def456",
      "type": "revenue",
      "category": "honorarios",
      "description": "Honorários - Ação de Cobrança",
      "amount": 15000.00,
      "currency": "BRL",
      "date": "2026-02-15",
      "due_date": "2026-02-28",
      "status": "pending",
      "case": {
        "id": "case_xyz789",
        "title": "Ação de Cobrança",
        "number": "0001234-56.2026.8.26.0100"
      },
      "client": {
        "id": "cli_abc123",
        "name": "João da Silva"
      },
      "created_at": "2026-02-01T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

POST /v1/financial

Cria um novo registro financeiro.

Request Body

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	Tipo: `revenue`, `expense`, `cost`
`category`	string	Sim	Categoria do registro
`description`	string	Sim	Descrição
`amount`	number	Sim	Valor
`currency`	string	Não	Moeda (padrão: `BRL`)
`date`	string	Sim	Data do registro (YYYY-MM-DD)
`due_date`	string	Não	Data de vencimento (YYYY-MM-DD)
`paid_date`	string	Não	Data do pagamento (YYYY-MM-DD)
`status`	string	Não	Status: `pending`, `paid` (padrão: `pending`)
`case_id`	string	Não	ID do processo vinculado
`client_id`	string	Não	ID do cliente vinculado
`payment_method`	string	Não	Método de pagamento
`invoice_number`	string	Não	Número da nota fiscal
`notes`	string	Não	Observações
`metadata`	object	Não	Dados customizados

Tipos de Registro

Tipo	Descrição
`revenue`	Receita (honorários, sucumbência, etc.)
`expense`	Despesa operacional
`cost`	Custo processual (custas, perícias, etc.)

Categorias Sugeridas

Receitas (revenue):

honorarios - Honorários advocatícios
sucumbencia - Honorários de sucumbência
consultoria - Consultoria jurídica
exito - Honorários de êxito

Despesas (expense):

aluguel - Aluguel do escritório
pessoal - Folha de pagamento
marketing - Marketing e publicidade
tecnologia - Software e tecnologia

Custos (cost):

custas - Custas processuais
pericia - Honorários periciais
diligencias - Diligências
cartorio - Despesas cartorárias

Request

curl -X POST https://api.juspilot.co/v1/financial \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "revenue",
    "category": "honorarios",
    "description": "Honorários advocatícios - Parcela 1/3",
    "amount": 15000.00,
    "date": "2026-02-15",
    "due_date": "2026-02-28",
    "case_id": "case_xyz789ghi012",
    "client_id": "cli_abc123def456",
    "notes": "Primeira parcela conforme contrato"
  }'

Response

{
  "success": true,
  "data": {
    "id": "fin_new123abc456",
    "type": "revenue",
    "category": "honorarios",
    "description": "Honorários advocatícios - Parcela 1/3",
    "amount": 15000.00,
    "currency": "BRL",
    "date": "2026-02-15",
    "due_date": "2026-02-28",
    "status": "pending",
    "case_id": "case_xyz789ghi012",
    "client_id": "cli_abc123def456",
    "notes": "Primeira parcela conforme contrato",
    "created_at": "2026-02-04T10:30:00Z",
    "updated_at": "2026-02-04T10:30:00Z"
  }
}

GET /v1/financial/:id

Busca um registro específico.

Request

curl -X GET https://api.juspilot.co/v1/financial/fin_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "fin_abc123def456",
    "type": "revenue",
    "category": "honorarios",
    "description": "Honorários - Ação de Cobrança",
    "amount": 15000.00,
    "currency": "BRL",
    "date": "2026-02-15",
    "due_date": "2026-02-28",
    "paid_date": null,
    "status": "pending",
    "case": {
      "id": "case_xyz789",
      "title": "Ação de Cobrança",
      "number": "0001234-56.2026.8.26.0100"
    },
    "client": {
      "id": "cli_abc123",
      "name": "João da Silva",
      "email": "joao@email.com"
    },
    "payment_method": null,
    "invoice_number": null,
    "notes": "Primeira parcela conforme contrato",
    "metadata": {},
    "created_at": "2026-02-01T10:00:00Z",
    "updated_at": "2026-02-04T14:00:00Z"
  }
}

PUT /v1/financial/:id

Atualiza um registro financeiro.

Request

curl -X PUT https://api.juspilot.co/v1/financial/fin_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "paid",
    "paid_date": "2026-02-25",
    "payment_method": "pix",
    "invoice_number": "NF-2026-0001"
  }'

Response

{
  "success": true,
  "data": {
    "id": "fin_abc123def456",
    "status": "paid",
    "paid_date": "2026-02-25",
    "payment_method": "pix",
    "invoice_number": "NF-2026-0001",
    "updated_at": "2026-02-25T10:00:00Z"
  }
}

DELETE /v1/financial/:id

Cancela um registro financeiro.

Registros pagos não podem ser cancelados. Crie um registro de estorno se necessário.

Request

curl -X DELETE https://api.juspilot.co/v1/financial/fin_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "fin_abc123def456",
    "status": "cancelled",
    "cancelled_at": "2026-02-04T15:00:00Z"
  }
}

GET /v1/financial/summary

Retorna um resumo financeiro do período.

Query Parameters

Parâmetro	Tipo	Descrição
`from`	string	Data inicial (YYYY-MM-DD)
`to`	string	Data final (YYYY-MM-DD)
`group_by`	string	Agrupar por: `day`, `week`, `month` (padrão: `month`)

Request

curl -X GET "https://api.juspilot.co/v1/financial/summary?from=2026-01-01&to=2026-12-31" \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "period": {
      "from": "2026-01-01",
      "to": "2026-12-31"
    },
    "totals": {
      "revenue": 450000.00,
      "expense": 120000.00,
      "cost": 35000.00,
      "profit": 295000.00
    },
    "pending": {
      "revenue": 75000.00,
      "expense": 15000.00,
      "cost": 5000.00
    },
    "by_category": {
      "honorarios": 380000.00,
      "sucumbencia": 50000.00,
      "consultoria": 20000.00
    },
    "by_month": [
      {
        "month": "2026-01",
        "revenue": 35000.00,
        "expense": 10000.00,
        "cost": 2500.00,
        "profit": 22500.00
      },
      {
        "month": "2026-02",
        "revenue": 42000.00,
        "expense": 10000.00,
        "cost": 3000.00,
        "profit": 29000.00
      }
    ],
    "top_clients": [
      {
        "client_id": "cli_abc123",
        "name": "Empresa XYZ",
        "total_revenue": 85000.00
      },
      {
        "client_id": "cli_def456",
        "name": "João da Silva",
        "total_revenue": 45000.00
      }
    ]
  }
}

GET /v1/financial/overdue

Lista registros financeiros em atraso.

Request

curl -X GET https://api.juspilot.co/v1/financial/overdue \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "fin_overdue123",
      "type": "revenue",
      "category": "honorarios",
      "description": "Honorários - Parcela 2/3",
      "amount": 15000.00,
      "due_date": "2026-01-31",
      "days_overdue": 4,
      "client": {
        "id": "cli_abc123",
        "name": "João da Silva"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3,
    "pages": 1
  }
}

Status dos Registros

Status	Descrição
`pending`	Pendente de pagamento
`paid`	Pago/Recebido
`cancelled`	Cancelado

Métodos de Pagamento

Método	Descrição
`pix`	PIX
`boleto`	Boleto bancário
`cartao`	Cartão de crédito/débito
`transferencia`	Transferência bancária
`dinheiro`	Dinheiro
`cheque`	Cheque

Erros Comuns

Código	Erro	Solução
`400`	`Invalid type`	Use: `revenue`, `expense` ou `cost`
`400`	`Invalid amount`	Valor deve ser maior que zero
`400`	`Invalid date format`	Use formato YYYY-MM-DD
`404`	`Record not found`	Verifique o ID
`422`	`Cannot cancel paid record`	Registros pagos não podem ser cancelados

Financeiro

On this page