Financial reporting feature
Allow the Seller to collect all the financial data provided
by the Octopia financial system
Why use it
Allows sellers to retrieve all financial informations. Most common operations : payment details, payment overview, operation and invoice details, invoice download.
Retrieve your invoices
Consult payment
Set up commercial operations
Use cases
Retrieve daily operations
Search for order or invoice operations
Consult payment summary (estimated and paid)
Consult invoice details
Download invoices
How the Finance work
Financial information concerning orders is made available the day after the acceptation of the order by the seller.
Sellers can therefore retrieve all the financial information of an order (or refund) at Day +1.
They can also retrieve all financial information available by entering the desired period.
Commission statements are issued every 10 days on 9/19/29 of the month. It is a document of grouping of invoices.
The invoice documents (PDF files) are available at the same time as the invoice information.
Finally, payments are triggered automatically every 10 days on 1/11/21 of the month or on demand as soon as the funds are cleared.
Sellers can retrieve the details of the payments made on each payout, as well as payment history.
Here is an operating diagram of Octopia's financial workflow :
Endpoints
Download an invoice
GET /invoices/{invoiceId}/documents
Allows sellers to download the PDF of a specific invoice.
Recommended call frequency : One time after each 10 days (on 9, 19 and 29 of each month). This is because the invoices are generated before the payout.
Count invoice details
GET/invoices/{invoiceId}/details/count
Allows sellers to count the number of orders/operations in an invoice.
Recommended call frequency : One time after each 10 days (on 9, 19 and 29 of each month). This is because the invoices are generated before the payout.
Retrieve invoice details
GET /invoices
Allows sellers to retrieve the details of an invoice in order to reconcile the operations concerned (sales, refunds, shipments).
Recommended call frequency : One time after each 10 days (on 9, 19 and 29 of each month). This is because the invoices are generated before the payout.
Download invoices
GET /invoice-documents
Allows sellers to download up to 10 invoices at the same time in an archived file.
Recommended call frequency : One time after each 10 days (on 9, 19 and 29 of each month). This is because the invoices are generated before the payout.
Count payments
GET /payments/count
Allows sellers to count the number of payments according to date, sales channel and payment status.
Recommended call frequency : On each payout in order to reconcile payments with the amount received by the Seller on his bank account / On demand in order to check payment history.
Count payment operations
GET /operations/count
Allows sellers to count the number of operations related to a payment (order, commissions, invoices, guarantee reserve...). Allows sellers to count item details related to a financial operation (order/refund).
Recommended call frequency : Daily in order to monitor business accounting / On each payout in order to reconcile accouting items.
Retrieve payments
GET /product
Allows sellers to retrieve the payment overall for each payout. All operations are group by date, sales channel and payment status.
Recommended call frequency : On each payout in order to reconcile payments with the amount received by the Seller on his bank account / On demand in order to check payment history.
Retrieve payment operations
GET /operations
Allows sellers to retrieve all financial informations related to a payment (order, commissions, invoices, guarantee reserve...). Allows sellers to search for a financial operation (order/refund) and retrieves its details.
Recommended call frequency : On each payout in order to reconcile accouting items.