Linhas de Lançamento

Este endpoint gerencia as linhas individuais (débitos e créditos) que compõem um Lançamento Contábil. É aqui que a lógica de impostos e movimentação de estoque é tratada para transações de compra e venda.

Objeto Linha de Lançamento

Atributo	Tipo	Descrição
id	string	O ID único da linha (UUID).
journal_entry_id	string	O ID do lançamento contábil ao qual a linha pertence.
account_id	string	O ID da conta contábil sendo debitada ou creditada.
debit	number	O valor do débito. null se for um crédito.
credit	number	O valor do crédito. null se for um débito.
product_id	string	Opcional. O ID do produto associado à transação.
quantity	integer	Opcional. A quantidade do produto.
icms_value	number	O valor calculado de ICMS.
ipi_value	number	O valor calculado de IPI.
pis_value	number	O valor calculado de PIS.
cofins_value	number	O valor calculado de COFINS.
icms_st_value	number	O valor calculado de ICMS-ST.

---

Listar Linhas de um Lançamento

Retorna todas as linhas de lançamento para um journal_entry_id específico.

GET/api/entry-lines

Parâmetros de Query

Parâmetro	Tipo	Descrição
journal_entry_id	string	Obrigatório. O ID do lançamento contábil para filtrar as linhas.

Resposta

Retorna um array de objetos de Linha de Lançamento.

Códigos de Status HTTP

• 200 OK: Linhas de lançamento listadas com sucesso.
• 400 Bad Request: Parâmetro journal_entry_id ausente ou inválido.
• 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
• 404 Not Found: Lançamento contábil não encontrado.
• 500 Internal Server Error: Erro interno do servidor ao listar as linhas de lançamento.

---

Criar Linhas de Lançamento (Venda/Compra)

Cria um conjunto de linhas de lançamento para uma transação de venda ou compra. A API abstrai a complexidade dos múltiplos débitos e créditos necessários, gerando-os automaticamente com base no tipo de transação.

POST/api/entry-lines

Corpo da Requisição

O corpo da requisição varia ligeiramente entre venda e compra, mas a estrutura principal é a seguinte:

{
  "journal_entry_id": "f1g2h3i4-j5k6-7890-1234-567890abcdef",
  "account_id": "c1d2e3f4-g5h6-7890-1234-567890abcdef", // ID da conta de Clientes (venda) ou Fornecedores (compra)
  "transaction_type": "sale", // ou "purchase"
  "product_id": "p1q2r3s4-t5u6-7890-1234-567890abcdef", // Opcional
  "quantity": 10 // Opcional
}

Resposta

201 Created com um array contendo todas as linhas de lançamento que foram criadas pela transação.

Códigos de Status HTTP

• 201 Created: Linhas de lançamento criadas com sucesso.
• 400 Bad Request: Dados da requisição inválidos (ex: journal_entry_id ou transaction_type ausente/inválido).
• 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
• 404 Not Found: Lançamento contábil ou produto não encontrado.
• 500 Internal Server Error: Erro interno do servidor ao criar as linhas de lançamento.