🚧 Em Construção 🚧
Skip to main content

Cria um novo book

POST 
/v1/ledgers/:ledger_identifier/books

O Book é uma entidade fundamental que representa uma conta contábil no LKe. Com sua natureza definida como credora ou devedora, ele organiza e registra lançamentos financeiros de maneira estruturada, rastreável e segregada conforme a finalidade contábil ou operacional.

Como unidade básica na estrutura do ledger, os Books proporcionam um controle preciso sobre saldos, movimentações e conciliações.

Todo Book deve estar vinculado a um Asset, que representa a moeda utilizada (seja fiduciária ou não) nas transações. Além disso, pode ser associado a um Chapter do Ledger para otimizar a gestão e o controle financeiro.

Request​

Responses​

Book criado com sucesso.

Response Headers
    Content-Type

    Tipo de contrato retornado.

    Example: application/vnd.guardia.v1+json
    Content-Length

    Indica o tamanho, em bytes, do corpo da resposta retornado pela API.

    Example: <length>
    Content-Language

    O idioma em que a API retorna as mensagens de erro. Use en para inglês americano, es para espanhol ou pt-BR para português brasileiro.

    Example: en
    Cache-Control

    Controla o comportamento de cache para respostas HTTP. Deve ser 'no-store' para dados sensíveis. Deve ser 'public' para respostas de sucesso sem dados sensíveis que podem ser compartilhadas, ou 'private' para respostas de sucesso sem dados sensíveis que não podem ser compartilhadas, seguido da diretiva 'max-age' determinando o tempo máximo de cache em segundos.

    Example: public, max-age=900
    Idempotency-Key

    Chave para garantir idempotência da requisição.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    Content-Digest

    Hash do payload usado para garantir integridade em requisições idempotentes.

    Example: sha-256=<hash>
    Last-Modified

    Indica a última data de modificação de uma entidade.

    Example: Wed, 21 Oct 2015 07:28:00 GMT
    X-Grd-Correlation-Id

    Identificador de correlação para rastreamento distribuído.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    X-Grd-Trace-Id

    Identificador único da requisição gerado pela infraestrutura Guardia.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    X-RateLimit-Limit

    Cota de requisições por segundos por cliente (org id + tenant id).

    Example: 30
    X-RateLimit-Remaining

    Cota de requisições restantes no mesmo segundo.

    Example: 10
    X-RateLimit-Reset

    Tempo restante em segundos para a próxima requisição.

    Example: 60