Importar passivo bancário do SCR de um cliente

POST

/assets/liabilities/import/SCR/{clientId}

Cria um passivo bancário para o cliente informado em clientId a partir da consulta SCR mais recente já feita para ele. A importação é feita na hora, e a resposta já traz o passivo criado: tipo BANCARIO, descrição Importação - SCR e ano igual ao ano de conclusão da consulta. O valor do passivo é a soma dos valores usd e brl do total da carteira de crédito do relatório SCR, somados diretamente, sem conversão entre eles. A rota não faz nova consulta ao SCR: usa a que já existe. Cada chamada cria um novo passivo, mesmo que o SCR já tenha sido importado antes. Cliente sem consulta SCR, ou com consulta sem relatório, devolve 404. Requer autenticação via Bearer JWT ou header x-api-key. O cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado), cliente de outra empresa devolve 401 (Acesso negado) e usuário inativo devolve 404 (Usuário não encontrado).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Passivo importado do SCR

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠404SCR não encontrado para importação

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/assets/liabilities/import/SCR/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "item": {
        "_id": "f1a2b3c4-0000-4000-8000-000000000502",
        "type": "BANCARIO",
        "description": "Importação - SCR",
        "value": 1875000.5,
        "year": "2026"
    }
}

Modificado em 2026-10-13 09:47:06

Página anterior

Listar passivos de um cliente

Próxima página

Solicitar extração de declaração de IR de um cliente