Isox.Camt053 (Isox v0.1.0)

Copy Markdown View Source

Modelo ISO 20022 do camt.053 (saldo/demonstrativo da Conta PI, resposta a camt.060), versão 1.4.

Stmt é max: ilimitado — camt.060 pede uma conta por vez, então o caminho comum é 1, mas encode/3 aceita 1 mensagem ou uma lista (lote: vários Stmt na mesma Document) e decode/1 devolve 1 struct ou uma lista de volta, mesmo padrão do Pacs002/Pacs004/ Pacs008. Já Bal dentro de cada Stmt é max: ilimitado de verdade — um extrato reporta vários tipos de saldo ao mesmo tempo (disponível, bloqueado, remuneração...) — e é modelado como lista.

CdtDbtInd (enum de valor único "CRDT") fica fixo.

Summary

Types

saldo()
t()
version()

Functions

decode(xml)

Decodifica um XML de camt.053 de volta para a struct — ou, quando a mensagem traz mais de um Stmt (lote), para uma lista de structs.

encode(message, header, version)

Monta o XML (envelope completo, AppHdr + Document) para a versão dada. Aceita 1 mensagem ou uma lista de mensagens (lote — vira vários Stmt na mesma Document).

Types

saldo()

@type saldo() :: %{
  tp_prtry: String.t(),
  value: String.t() | number(),
  dt_tm: DateTime.t()
}

t()

@type t() :: %Isox.Camt053{
  acct_ispb: String.t(),
  balances: [saldo()],
  created_at: DateTime.t(),
  msg_id: String.t(),
  stmt_id: String.t()
}

version()

@type version() :: :v1_4

Functions

decode(xml)

@spec decode(binary()) :: {:ok, t() | [t(), ...], version()} | {:error, term()}

Decodifica um XML de camt.053 de volta para a struct — ou, quando a mensagem traz mais de um Stmt (lote), para uma lista de structs.

encode(message, header, version)

@spec encode(t() | [t(), ...], Isox.AppHdr.t(), version()) ::
  {:ok, binary()} | {:error, String.t()}

Monta o XML (envelope completo, AppHdr + Document) para a versão dada. Aceita 1 mensagem ou uma lista de mensagens (lote — vira vários Stmt na mesma Document).

msg_id/created_at são de GrpHdr (uma vez por mensagem XML) — em lote, têm que ser iguais em todos os itens da lista.