Guias

Vendas, recebimentos e contas a receber

Onde encontrar cada informação financeira: vendas, recebimentos e parcelas do crediário.

No ssOtica, vendas, recebimentos e contas a receber são informações distintas, tanto nas telas do sistema quanto na API. Cada uma possui uma consulta específica:

InformaçãoConsulta
Itens vendidos e formas de pagamento utilizadasVendas (formas_pagamento)
Valores recebidos na loja, na data do recebimentoLançamentos de caixa
Data de crédito dos valores na conta, inclusive cada parcela do cartãoExtrato (data_credito)
Parcelas do crediário (boleto, carnê) e a situação de cada umaContas a receber (situacao)

Contas a receber

O contas a receber reúne as parcelas do crediário da loja, geradas por formas de pagamento a prazo como boleto e carnê, estejam elas pagas ou em aberto. Cada parcela informa o vencimento e a situação (A vencer, Pago, Em atraso, entre outras).

Pagamentos em dinheiro, PIX ou cartão não geram parcelas no contas a receber: o valor é recebido no ato ou, no caso do cartão, repassado pela operadora. Esses valores constam nos lançamentos de caixa e no extrato.

Lançamentos de caixa e extrato

Os lançamentos de caixa registram cada entrada na loja: pagamentos à vista de vendas, adiantamentos de ordens de serviço e pagamentos de parcelas do contas a receber, estes identificados pelo mesmo numero_documento do título.

O extrato apresenta a data em que cada valor é creditado na conta. No cartão de crédito parcelado, cada parcela repassada pela operadora gera um crédito, com a respectiva data prevista.

Exemplos

Venda de R$ 1.000: R$ 200 no PIX e R$ 800 em 4x no cartão de crédito

ConsultaResultado
Vendasa venda, com PIX e cartão em formas_pagamento
Lançamentos de caixaPIX (R$ 200) e cartão (R$ 800), na data da venda
Extratoo crédito do PIX na mesma data e quatro créditos do cartão, nas datas previstas pela operadora
Contas a recebernenhum registro

Venda de R$ 600 no carnê em 3x, com a 1ª parcela paga no PIX

ConsultaResultado
Vendasa venda, com o carnê em formas_pagamento
Contas a recebertrês parcelas: a 1ª com situação Pago e as demais A vencer
Lançamentos de caixao pagamento da 1ª parcela, no PIX, na data em que foi realizado
Extratoo crédito do PIX

Cruzamento das consultas

  • Vendas e contas a receber: a venda de origem da parcela é informada em titulo.venda.id. Utilize a mesma referência de data nas duas consultas: tipo_periodo=dataLancamento nas vendas e tipo_periodo=lancamento no contas a receber.
  • Parcelas pagas: utilize tipo_periodo=pagamento no contas a receber. A forma de pagamento consta no lançamento de caixa com o mesmo numero_documento.
  • Vendas, caixa e extrato: os lançamentos de caixa e o extrato informam a venda de origem no campo venda.

On this page