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=1e 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
IDBankAccountpassa a ser também a de previsão. - Quando
IDAccountsPayableReceivableConciliationouIDAccountsPayableReceivableConciliationMarketplaceé informado e oValuedifere 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
- 200
- 400
Pagamento lançado. Retorna a conta a pagar atualizada — ou apenas a string "sucesso" quando query=1.
Erros de validação (prefixo [BadRequest]):
Conta a receber/pagar não existeConta bancária não existeCaixinha está aberto e não pode ter pagamentos efetuadosValor a conciliar divergente de valor do título e não há outro lançamento relacionadoConciliação marketplace inexistenteErro ao criar lançamento de taxa adquirente