Skip to main content

Atualizar regra de movimentação automática

Request​

ENDPOINT
/baas/automatic_transfer/transfer_configuration
METHOD
PUT
Desativar transferência automática:
  • Para desativar uma transferência automática basta enviar o parâmetro 'is_active' com valor false
Request Body
{
        "transfer_cronstring": "*/5 * * * *",
        "automatic_transfer_key": "967c40ea-ba35-4445-89b1-fa35bd0749a4",
        "rule_configuration": {
          "destinations": [
            {
              "account_digit": "9",
              "financial_institutions_code_number": "063",
              "document_number": "48504807000198",
              "account_number": "1232046",
              "percentage": 100,
              "name": "Mateus Fonseca",
              "account_branch": "0931",
              "is_pix_transfer": false
            }
          ],
          "remaining_balance": 0
        },
        "is_active": false,
        "rule": "split_percentage"
}

BODY PARAMS​

CampoTipoDescriçãoCaracteres
transfer_cronstring*stringFrequência de transferência do dinheiro em CRON, padrão que permite expressar recorrência.CRON Guru
rule*enumRegra a ser seguida. (split_equal ou split_percentage).Enumeradores
rule_configuration*objectObjeto de configuração da regra escolhida.Object rule_configuration
account_key*uuidKey da conta origem das transferências.-
automatic_transfer_key*uuidKey da configuração a ser alterada.-

Obejto rule_configuration​

CampoTipoDescriçãoCaracteres
destinationsobjectContas destino e outros dados.Array of destination
remaining_balancefloatValor de saldo que irá permanecer na conta.-

Object destinations​

CampoTipoDescriçãoCaracteres
account_branch*stringAgência da conta destino.3
account_number*stringNúmero da conta destino.3
account_digit*stringDígito da conta destino.3
document_number*stringNúmero do documento do dono da conta.3
name*stringNome da pessoa física ou razão social da pessoa jurídica.3
financial_institutions_code_number*stringCódigo COMPE da instituição financeira (https://www.bcb.gov.br/pom/spb/estatistica/port/ASTR003.pdf)3
financial_institutions_ispb*stringNúmero ISPB da instituição financeira.8
is_pix_transfer*booleanDefine se a transferência será va pix.-
percentage*floatPorcentagem a ser destinada a essa conta.-

Enumeradores rule​

EnumeradorTradução
split_percentagedivisão percentual
split_equaldivisão igual
single_beneficiarybeneficiário único

Response​

STATUS
200
Response Body
{
  "automatic_transfer_key": "967c40ea-ba35-4445-89b1-fa35bd0749a4",
  "is_active": false,
  "rule": "split_percentage",
  "rule_configuration": {
    "destinations": [
      {
        "account_branch": "0931",
        "account_digit": "9",
        "account_number": "1232046",
        "document_number": "48504807000198",
        "financial_institutions_code_number": "063",
        "is_pix_transfer": false,
        "name": "Mateus Fonseca",
        "percentage": 100
      }
    ],
    "remaining_balance": 0
  },
  "transfer_cronstring": "*/5 * * * *"
}

STATUS
400
Response Body
{
  "data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}