Sales

Returns a paginated list of sale receipts. In BOCP the sale receipt is the document that moves stock out. It can be issued with or without an invoice, with or without a fiscal receipt.

Filters are passed as URL path segments. Example: /sales/list/year:2024/modifiedafter:2024-06-01%2000:00:00/page:2/.

Standard filters: year, yearmonth, yearmonthday, date, modifiedafter, modifiedthrough, id, minid, skipcancelled, page.

Include: items, transactions, invoiced.

Exclude: added-by-api, invoiced.

Responses

Status	Description
200	OK — response uses the shared envelope.
400	Request is malformed or a required field is missing / invalid.
401	Missing or invalid Basic Auth credentials.

Returns the JSON schema and allowed payment types for creating a payment on the given sale. Useful for building your integration UI.

Parameters

Name	In	Type	Required	Description
bv_id	path	integer	yes	BOCP ID of the sale.

Responses

Status	Description
200	OK — response uses the shared envelope.
404	The requested resource does not exist.

Records an incasso (or payment) against an existing sale receipt.

Notes:
- You can register multiple payments on the same sale (partial payments, installments).
- incasare_id in the response identifies the payment inside /payments/list/.
- payment_type accepts the string codes returned by /payments/types/.

Parameters

Name	In	Type	Required	Description
bv_id	path	integer	yes	BOCP ID of the sale.

Request body (JSON)

{
    "amount": 250,
    "payment_type": "bank_transfer",
    "date": "2026-05-20",
    "currency": "RON",
    "mentions": "OP 1234 BT",
    "external_ref": "TXN-98765"
}

Responses

Status	Description
200	Payment registered.
400	Missing/invalid fields, or the sale is cancelled.
401	Missing or invalid Basic Auth credentials.
404	The requested resource does not exist.