49 - Movimentação de Conta

Scopes:

api.ext api.conta.movimento

Endpoint responsável por consultar os movimentos financeiros de uma conta bancária por período de parceiro.

cURL

curl --request GET \
  --url https://api.ext.dbs.moneyp.dev.br/api/Conta/Movimento \
  --header 'Authorization: <api-key>'

200

{
  "sucesso": true,
  "mensagem": "<string>",
  "parametros": {
    "dtInicial": "2023-12-25",
    "dtFinal": "2023-12-25",
    "operacoes": [
      "<string>"
    ]
  },
  "movimentos": [
    {
      "dtMovimento": "2023-11-07T05:31:56Z",
      "codigoConta": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "codigoOperacao": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "descOperacao": "<string>",
      "identificadorOperacao": "<string>",
      "documentoFederal": "<string>",
      "nome": "<string>",
      "documentoFederalCorrentista": "<string>",
      "nomeCorrentista": "<string>",
      "vlrMovimento": 123,
      "tipoLancamento": "<string>",
      "nsu": 123,
      "codigoMovimento": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Por meio deste endpoint, o parceiro pode visualizar todas as movimentações de débito ou crédito realizadas na sua conta.

Mostrar Mensagens de requisições com erro

O retorno de uma requisição com status HTTP 400 (Bad Request) pode incluir as seguintes mensagens de erro:

Endpoint	Mensagem de erro
/api/Conta/Movimento	Operador não configurado para esta integração
/api/Conta/Movimento	Parceiro não configurado
/api/Conta/Movimento	Lista de operações deve ser informada
/api/Conta/Movimento	Data inicial deve ser informada
/api/Conta/Movimento	Data inicial informada inválida
/api/Conta/Movimento	Data final deve ser informada
/api/Conta/Movimento	Data final informada inválida
/api/Conta/Movimento	Necessário informar ao menos uma operação
/api/Conta/Movimento	Operação inválida informada
/api/Conta/Movimento	A data inicial deve ser menor ou igual a data final do período
/api/Conta/Movimento	O período da consulta não pode exceder um intervalo de 5 dias

Autorizações

Authorization · string · header · obrigatório

Copie 'Bearer ' + token

Parâmetros de consulta

DtInicial · string<date>

Data inicial do período

DtFinal · string<date>

Data final do período

Operacoes · string[]

Lista de operações a serem retornadas

Resposta

200

application/json

Success

sucesso · boolean

mensagem · string | null

parametros · object

Show child attributes

movimentos · object[] | null

Show child attributes