Plantonizei

Painel da empresa › Financeiro

Editar conta

PATCH/api/v1/accounts/{id}Pede sessão

Como funciona

Edita uma conta. O corpo é o mesmo do lançamento, e os campos enviados substituem os gravados.

  • kind: payable (a pagar) ou receivable (a receber).
  • description é obrigatória e amountCents precisa ser positivo, em centavos.
  • dueDate é o vencimento, em AAAA-MM-DD.
  • category, counterparty (fornecedor ou cliente) e method (forma de pagamento) organizam os relatórios e os gráficos.

Fica na trilha de auditoria. Pede a permissão de criar e editar contas.

Parâmetros

  • idCaminho · string · obrigatórioIdentificador do registro, como vem na listagem.
  • amountCentsCorpo · integerValor, em centavos.
  • categoryCorpo · stringCategoria.
  • counterpartyCorpo · stringFornecedor ou cliente.
  • companyIdCorpo · stringEmpresa (centro de custo) da conta, das cadastradas do cliente (`GET /settings/registered-companies`). Vazio ou ausente = da empresa toda. Empresa de outro cliente é recusada (400). Na lista, a conta automática da escala traz a empresa da escala.
  • counterpartyDocCorpo · stringCPF ou CNPJ de quem recebe/paga. Entra com ou sem pontuação e é gravado só com dígitos; dígito verificador errado é recusado com 400. Vazio = não informado.
  • descriptionCorpo · stringDescrição.
  • dueDateCorpo · stringVencimento (`AAAA-MM-DD`).
  • kindCorpo · stringTipo.
  • methodCorpo · stringForma de pagamento.

Respostas

204 · Conta salva.

Esta resposta não traz corpo.