Documentação API
  • Introdução
  • Setup
  • Autenticação
  • Autenticação ( Authorization Code Flow )
  • Caraterísticas dos pedidos
  • API-v1
    • Introdução à API v1
    • Documentos de venda
    • Notas de venda
    • Notas de liquidação de venda
    • Recibos
    • Documentos de compra
    • Notas de compra
    • Notas de liquidação de compra
    • Pagamentos
    • Documentos e notas de venda no regime de Balcão Único do IVA (OSS)
  • API-v0
    • Introdução à API v0
    • Clientes
    • Fornecedores
    • Contactos
    • Moradas
    • Produtos e serviços
    • Documentos de venda
    • Recibos
    • Descarregar PDF de documentos e recibos
    • Envio de documentos e recibos por email
    • Documentos de compra
    • Pagamentos
    • Anexar ficheiros
    • Comunicação de documentos à AT
  • Contabilidade
    • Consulta de lançamentos
    • Criação de lançamentos
    • Alteração de lançamentos
    • Eliminação de lançamentos
    • Lançamentos com analítica
    • Lançamentos com fluxos de caixa
    • Relação com outros recursos
    • Pedidos com várias operações
    • Relatórios
    • Configurações
  • Configurações globais
Powered by GitBook
On this page
  1. Contabilidade

Alteração de lançamentos

PreviousCriação de lançamentosNextEliminação de lançamentos

Last updated 23 days ago

Alteração do cabeçalho de um lançamento

Um determinado lançamento pode ser alterado da seguinte forma:

Alteração de uma linha de lançamento

Uma linha de lançamento pode ser alterada da seguinte forma:

Eliminar linha de lançamento

Uma linha de lançamento pode ser eliminada da seguinte forma:

Finalizar ou reabrir lançamento

Para finalizar ou reabrir um lançamento, deverá ser efetuado um pedido de alteração, sendo indicado o "status" de deleted ou draft, respectivamente.

delete
Path parameters
idstringRequired

Identificador do lançamento a eliminar

Responses
200
OK
delete
DELETE /accounting_transaction_lines/{id} HTTP/1.1
Host: 
Accept: */*
200

OK

No content

  • Alteração do cabeçalho de um lançamento
  • PATCH/accounting_transactions/{id}
  • Alteração de uma linha de lançamento
  • PATCH/accounting_transaction_lines/{id}
  • Eliminar linha de lançamento
  • DELETE/accounting_transaction_lines/{id}
  • Finalizar ou reabrir lançamento
patch
Path parameters
idintegerRequired

Identificador do lançamento a atualizar

Body
Responses
200
OK
application/json
patch
PATCH /accounting_transactions/{id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 512

{
  "data": {
    "type": "accounting_transactions",
    "id": "1",
    "attributes": {
      "status": "draft",
      "transaction_date": "2024-01-01",
      "document_date": "2023-12-10",
      "description": "Lançamento novo via API",
      "external_reference": "D20236712",
      "currency_conversion_rate": 1.21,
      "third_party_control_id": "CLIENTE",
      "third_party_entity_id": 20
    },
    "relationships": {
      "accounting_document_type": {
        "data": {
          "type": "accounting_document_types",
          "id": "DP"
        }
      },
      "currency": {
        "data": {
          "type": "text",
          "id": "text"
        }
      },
      "journal": {
        "data": {
          "type": "journals",
          "id": "BNC"
        }
      }
    }
  }
}
200

OK

{
  "data": {
    "type": "accounting_transactions",
    "id": "1",
    "attributes": {
      "status": "draft",
      "transaction_date": "2024-01-01",
      "document_date": "2023-12-10",
      "description": "Lançamento novo via API",
      "external_reference": "D20236712",
      "currency_conversion_rate": 1.21,
      "third_party_control_id": "CLIENTE",
      "third_party_entity_id": 20,
      "created_at": "2024-01-01 10:20:30.123456",
      "finalized_at": null,
      "journal_entry": null,
      "document_no": null,
      "accounting_document_series_no": 1,
      "debit_total_fiscal_currency": 0,
      "credit_total_fiscal_currency": 0,
      "debit_total_document_currency": 0,
      "credit_total_document_currency": 0,
      "accountable_id": null,
      "accountable_document_type": null,
      "accountable_document_no": null
    },
    "relationships": {
      "accounting_document_series": {
        "data": null
      },
      "accounting_document_type": {
        "data": {
          "type": "accounting_document_types",
          "id": "DP"
        }
      },
      "currency": {
        "data": {
          "type": "currency",
          "id": "1"
        }
      },
      "journal": {
        "data": {
          "type": "journals",
          "id": "BNC"
        }
      },
      "lines": {
        "data": [
          {
            "type": "text",
            "id": "text"
          }
        ]
      },
      "user": {
        "data": {
          "type": "users",
          "id": "1"
        }
      }
    }
  }
}
patch
Path parameters
idintegerRequired

Identificador do lançamento a atualizar

Body
Responses
200
OK
application/json
patch
PATCH /accounting_transaction_lines/{id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 600

{
  "data": {
    "type": "accounting_transaction_lines",
    "id": "1",
    "attributes": {
      "seqno": 1,
      "transaction_id": 1,
      "account_id": 11001,
      "description": "Linha de lançamento nova via API",
      "debit_amount": 10.5,
      "credit_amount": 20,
      "debit_expression": "9+1.5",
      "credit_expression": "10*2",
      "cost_dimension_id": 1
    },
    "relationships": {
      "account": {
        "data": {
          "type": "general_ledger",
          "id": "1"
        }
      },
      "transaction": {
        "data": {
          "type": "accounting_transactions",
          "id": "1"
        }
      },
      "vat_code": {
        "data": {
          "type": "vat_codes",
          "id": "1"
        }
      },
      "cost_dimension": {
        "data": {
          "type": "cost_dimensions",
          "id": "0101"
        }
      },
      "transaction_line_cash_flows": [],
      "transaction_line_costs": []
    }
  }
}
200

OK

{
  "data": {
    "type": "accounting_transaction_lines",
    "id": "1",
    "attributes": {
      "seqno": 0,
      "transaction_id": 1,
      "account_id": 11001,
      "description": "Linha de lançamento nova via API",
      "debit_amount": 10.5,
      "credit_amount": 20,
      "debit_expression": "9+1.5",
      "credit_expression": "10*2",
      "cost_dimension_id": 1
    },
    "relationships": {
      "account": {
        "data": {
          "type": "general_ledger",
          "id": "1"
        }
      },
      "transaction": {
        "data": {
          "type": "accounting_transactions",
          "id": "1"
        }
      },
      "vat_code": {
        "data": {
          "type": "vat_codes",
          "id": "1"
        }
      },
      "cost_dimension": {
        "data": {
          "type": "cost_dimensions",
          "id": "0101"
        }
      },
      "transaction_line_cash_flows": [],
      "transaction_line_costs": []
    }
  }
}