Fgts

POST

https://sandbox.api.finqia.com.br/assets/v1/fgts/operations

Esse endpoint permite realizar o cadastro de uma operação de FGTS para um fundo especifico de um dos cedentes parceiros.
Através desse endpoint a operação será cadastrada e validada, retornando o resultado de forma assincrona com a aprovação ou recusa da operação

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Success

application/json

Bodyapplication/json

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://sandbox.api.finqia.com.br/assets/v1/fgts/operations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "number": "654322",
    "assignorId": 1,
    "principalAmount": 150000,
    "financedAmount": 180000,
    "grossAmount": 240000,
    "installmentAmount": 40000,
    "term": 6,
    "firstDueDate": "2026-08-20",
    "lastDueDate": "2027-02-20",
    "monthlyRate": 4.98,
    "annualCet": 45.00,
    "monthlyCet": 5.98,
    "insurancePremium": 0,
    "iofAmount": 7234,
    "payer": {
        "name": "Fulano de Tal",
        "cpf": "12345678909",
        "birthDate": "1994-07-30",
        "gender": "M",
        "civilStatusId": 1,
        "nationalityId": 1,
        "rgNumber": "21234563",
        "rgUf": "SP",
        "rgIssuer": "SSP",
        "address": {
            "zipcode": "24465016",
            "street": "Rua teste da Silva",
            "number": "12",
            "neighborhood": "Bairro teste",
            "city": "Limeira",
            "state": "SP"
        },
        "scoreTypeId": 1,
        "bankData": {
            "bankCode": "001",
            "agencyNumber": "0001",
            "agencyDigit": "0",
            "accountNumber": "12312542",
            "accountDigit": "1"
        },
        "contacts": [
            {"contact": "11934741881", "type": "celphone"}
        ]
    },
    "installments": [
        {"number": 1, "daysInterval": 90, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2026-08-20"},
        {"number": 2, "daysInterval": 30, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2026-09-20"},
        {"number": 3, "daysInterval": 31, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2026-10-20"},
        {"number": 4, "daysInterval": 30, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2026-11-20"},
        {"number": 5, "daysInterval": 31, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2027-01-20"},
        {"number": 6, "daysInterval": 29, "principalAmount": 40000, "interestAmount": 32000, "amortizationAmount": 8000, "dueDate": "2027-02-20"}
    ]
}'

Response Example

201 - Created

{
    "message": "Operação cadastrada com sucesso!",
    "data": []
}