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.