Pular para o conteúdo principal

Lança um pagamento na conta a pagar

POST 

/accounts/payable/:idaccountpayable/payment

Registra um pagamento na conta a pagar, atualizando o status conforme o saldo devedor resultante. Regras:

  • Quando FinishIfPossible=1 e há pedido vinculado, tenta finalizar o pedido se todos os títulos estiverem pagos.
  • Pagamentos em conta de caixinha (BankNumber=000) só são aceitos com a caixinha fechada.
  • Quando a conta ainda não tem conta bancária de previsão definida, a conta informada em IDBankAccount passa a ser também a de previsão.
  • Quando IDAccountsPayableReceivableConciliation ou IDAccountsPayableReceivableConciliationMarketplace é informado e o Value difere do valor do título com acréscimos e descontos, o sistema procura outro título do mesmo pedido com o mesmo TID ou NSU e redistribui a diferença entre os dois; se não houver esse outro título, a requisição é recusada.
  • Quando IDAccountsPayableReceivableConciliation é informado, o lançamento é vinculado à conciliação de adquirente e ela é fechada como conciliada manualmente (ConciliationStatus=3).
  • Quando IDAccountsPayableReceivableConciliationMarketplace é informado, gera automaticamente as contas filhas das taxas do marketplace, vinculadas ao título da baixa: comissão (MarketplaceFeeValue), antecipação (MarketplaceFinancingFeeValue), frete (MarketplaceShippingFeeValue), cupom (MarketplaceCouponValue) e outras taxas (MarketplaceOtherFeeValue). Cada categoria só vira título próprio quando a integração tem um plano de contas configurado para ela e o valor é diferente de zero; antecipação, frete, cupom e outras taxas sem plano de contas configurado são somadas ao valor da comissão. O valor de impostos (MarketplaceTaxesValue) depende de um plano de contas exclusivo de impostos, que hoje não é configurável nas integrações de marketplace — na prática ele não gera título nem entra na soma da comissão. Cada conta filha recebe também o lançamento correspondente no extrato bancário e, quando a integração tem centro de custo configurado, o rateio nesse centro. Os valores entram com o sinal invertido em relação à taxa: taxa cobrada vira débito e taxa devolvida (cancelamento) vira crédito. Concluído o vínculo, a conciliação é fechada como conciliada manualmente (IDTypeStatusConciliation=3).
  • É por esta rota que se dá baixa nas despesas do canal (armazenagem, mensalidade, ajuste de comissão) que aparecem como linhas do extrato de marketplace sem pedido de origem.

Request

Responses

Pagamento lançado. Retorna a conta a pagar atualizada — ou apenas a string "sucesso" quando query=1.