create_manual_account
Criar conta ou cartão manual.
Contas e organização · Criar · Escrita local
Efeito da chamada
Esta ferramenta altera dados locais da instalação. Confirme a ação e o espaço com o proprietário antes de enviar confirmed: true e uma chave de idempotência. Ela não altera registros nem executa pagamentos no banco.
Parâmetros
| Campo | Obrigatório | Tipo | Uso |
|---|---|---|---|
confirmed | Sim | true | Deve ser true somente depois da confirmação explícita do proprietário. |
idempotency_key | Sim | texto | Chave única para esta solicitação. Reutilize apenas para repetir exatamente a mesma operação. |
spaceId | Sim | texto | Espaço da instalação. Consulte get_spaces; o espaço inicial é personal. |
closeDay | Não | inteiro | Dia de fechamento do cartão manual, dentro dos limites do contrato. Máximo: 31. Mínimo: 1. |
creditLimitMinor | Não | texto | Limite local do cartão em unidades menores; null restaura o valor importado. |
currency | Sim | "BRL" / "USD" / "EUR" / "GBP" / "ARS" / "AUD" / "BHD" / "CAD" / "CHF" / "CLP" / "JPY" / "KWD" | Moeda da operação. Valores de moedas diferentes permanecem separados. |
dueDay | Não | inteiro | Dia de vencimento do cartão manual. Máximo: 31. Mínimo: 1. |
name | Sim | texto | Nome de exibição do registro. |
openingBalanceMinor | Não | texto | Saldo inicial da conta manual, em unidades menores da moeda. Padrão: "0". |
personId | Não | texto | Titular declarado. Obtenha seu ID em caderninho_status. |
type | Sim | "BANK" / "CREDIT" | Tipo do registro ou visualização, conforme as opções desta ferramenta. |
Filtros compostos e limites estão no schema completo. Campos não listados são recusados.
Exemplo de chamada
Substitua os IDs fictícios pelos da sua instalação, obtidos nas consultas indicadas nos parâmetros.
{
"name": "create_manual_account",
"arguments": {
"confirmed": true,
"idempotency_key": "docs:create_manual_account:01",
"spaceId": "personal",
"currency": "BRL",
"name": "Mercado de exemplo",
"type": "BANK"
}
}
Interpretar o resultado
Confira o resultado da chamada antes de dar a alteração como concluída. Se a rede falhar, repita somente os mesmos argumentos com a mesma chave. Atualize a leitura se a revisão estiver obsoleta antes de confirmar outra operação.
O registro desta ferramenta não declara outputSchema. Consulte as regras de resposta no guia de contratos.
Contrato completo
Ver JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"confirmed": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"spaceId": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"closeDay": {
"type": "integer",
"minimum": 1,
"maximum": 31
},
"creditLimitMinor": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,29})$"
},
"currency": {
"type": "string",
"enum": [
"BRL",
"USD",
"EUR",
"GBP",
"ARS",
"AUD",
"BHD",
"CAD",
"CHF",
"CLP",
"JPY",
"KWD"
]
},
"dueDay": {
"type": "integer",
"minimum": 1,
"maximum": 31
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"openingBalanceMinor": {
"default": "0",
"type": "string",
"pattern": "^(0|[1-9]\\d{0,29})$"
},
"personId": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"type": {
"type": "string",
"enum": [
"BANK",
"CREDIT"
]
}
},
"required": [
"confirmed",
"idempotency_key",
"spaceId",
"currency",
"name",
"type"
],
"additionalProperties": false
}