API financeira

CRUD de títulos, baixas, lote, settings e crédito de carteira.

Prefixo /financial-transactions. Headers de tenant obrigatórios.

Leitura

MétodoRota
GET/filial/:filialId (filtros: mvType, status, vencimento, pagamento, parte, valor, origem, centro, overdueOnly, category)
GET/summary/:filialId
GET/dashboard/:filialId
GET/cash-flow/:filialId
GET/aging/:filialId
GET/top-suppliers/:filialId · /top-customers/:filialId
GET/monthly-comparison/:filialId
GET/:id · /:id/history · /timeline · /audit-log · /linked-origins · /origin-items
GET/older-open/:partyType/:partyId
GET/settings/:filialId

Escrita

MétodoRota
POST/ e /batch
PATCH/:id
DELETE/:id
PATCH/:id/pay
POST/batch-pay
PATCH/:id/settle-without-movement · /cancel · /change-due-date · /apply-discount · /reopen · /apply-interest · /change-amount
POST/:id/reverse · /:id/renegociar · /:id/aglutinar · /aglutinar-selecao
PATCH/settings/:filialId
POST/settings/:filialId/apply-late-interest

curl — listar CR em aberto

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "x-company-id: $COMPANY" -H "x-filial-id: $FILIAL" \
  "$API/financial-transactions/filial/$FILIAL?mvType=CR&status=ABERTA"

curl — baixar

curl -s -X PATCH "$API/financial-transactions/$ID/pay" \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-company-id: $COMPANY" -H "x-filial-id: $FILIAL" \
  -H "Content-Type: application/json" \
  -d '{"paidAmount":1500.00,"paymentMethod":"PIX","notes":"Baixa operacional"}'

Campos exatos do DTO: Swagger (RegisterPaymentDto). Com operador logado, a filial precisa de caixa aberto.

Crédito

/customer-credit/grants — ver títulos.