After June 1st, the old accounting service will be disabled. Until this date, both services are active.
You can get your financial records created in Trendyol system through integration with this service.
The 2 services to be used (settlements, otherfinancials) provide separate transaction records.
You can get sales, returns, discounts, coupons, provision transactions from the settlements service and you can get the details of supplier financing, transfer, payments (progress payment), invoices (from Trendyol to supplier), supplier invoices (from supplier to Trendyol), incoming transfers, commission reconciliation invoices from the otherfinancials service.
NOTE 1: Financial records are created after the order is delivered.
NOTE 2: TransactionType must be entered. Only 1 type can be entered in 1 request.
NOTE 3: The paymentOrderId is formed after the order has been paid. Except for exceptions, a payment order is created every Wednesday for orders that are due in the relevant week.
NOTE 4: With paymentOrderId, you can match your orders and payments.
NOTE 5: The start and end date are required and the interval between cannot be longer than 15 days.
NOTE 6: Store information is used by Market vendors. It will return "null" for Marketplace vendors.
https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/settlements
https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/settlements?endDate={endDate}&startDate={startDate}&transactionType={Type}&page=0&size=500
| Parameter | Parameter Value | Description | Type | Required |
|---|---|---|---|---|
| transactionType | Sale, Return, Discount, DiscountCancel, Coupon, CouponCancel, ProvisionPositive, ProvisionNegative | It is a type of financial transaction. | string | Yes |
| startDate | Returns transaction records after a certain date. Timestamp should be sent in miliseconds. | int | Yes | |
| endDate | Returns transaction records after a certain date. Timestamp should be sent as milisecond. | int | Yes | |
| page | Returns information on the specified page only | int | No | |
| size | It can take values of 500 or 1000. (Default = 500) | Specifies the maximum number to be listed on a page. | int | No |
| supplierId | ID information of the relevant supplier must be sent | long | Yes |
The explanations of the transaction types that can be used for transactionType are as follows.
| transactionType | Description |
|---|---|
| Sale | Gives sales records of orders |
| Return | Returns records of orders |
| Discount | It shows the discount amount covered by the supplier. |
| DiscountCancel | It is the record discarded when the product is canceled or returned. Can be thought of as the opposite of discount records |
| Coupon | It shows the coupon amount paid by the supplier. |
| CouponCancel | Record discarded when the product is canceled or returned. Can be thought of as the reverse of coupon registration |
| ProvisionPositive | A settlement provision is recorded for the amount differences arising from the weight difference. In addition, when cancellation or return is made to an order that is recorded as provision positive, the provision is recorded as negative. |
| ProvisionNegative | A settlement provision is recorded for the amount differences arising from the weight difference. In addition, when cancellation or return is made to an order that is recorded as provision negative, the provision is recorded as positive. |
{
"page": 0,
"size": 500,
"totalPages": 878,
"totalElements": 438974,
"content": [
{
"id": "725041340",
"transactionDate": 1613397671561,
"barcode": "8681385952874",
"transactionType": "Satış",
"receiptId": 48376618,
"description": "Satış",
"debt": 0.0,
"credit": 59.99,
"paymentPeriod": 30,
"commissionRate": 12.5,
"orderNumber": "501915861",
"paymentOrderId": 112360,
"paymentDate": 1615989671561,
"sellerId": 123456,
"storeId": null,
"storeName": null,
"storeAddress": null
},
{
"id": "725041335",
"transactionDate": 1613397671557,
"barcode": "8681387147421",
"transactionType": "Satış",
"receiptId": 48376618,
"description": "Satış",
"debt": 0.0,
"credit": 49.99,
"paymentPeriod": 30,
"commissionRate": 12.5,
"orderNumber": "501915861",
"paymentOrderId": 112360,
"paymentDate": 1615989671557,
"sellerId": 123456,
"storeId": null,
"storeName": null,
"storeAddress": null
}
]
}
https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/otherfinancials
https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/otherfinancials?endDate={endDate}&startDate={startDate}&transactionType={Type}&page=0&size=500
| Parameter | Parameter Value | Description | Type | Required |
|---|---|---|---|---|
| transactionType | CashAdvance, WireTransfer, IncomingTransfer, ReturnInvoice, CommissionAgreementInvoice, PaymentOrder, DeductionInvoices | It is a type of financial transaction. | string | Yes |
| startDate | Returns transaction records after a certain date. Timestamp should be sent in miliseconds. | int | Yes | |
| endDate | Returns transaction records after a certain date. Timestamp should be sent as milisecond. | int | Yes | |
| page | Returns information on the specified page only | int | No | |
| size | It can take values of 500 and 1000. (Default = 500) | Specifies the maximum number to be listed on a page. | int | No |
| supplierId | ID information of the relevant supplier must be sent | long | Yes |
The explanations of the transaction types that can be used for transactionType are as follows.
| transactionType | Description |
|---|---|
| CashAdvance | It is the record when early payment is received for progress payments that are not yet due. |
| WireTransfer | It is the record for the transfer between Trendyol and the Supplier. |
| IncomingTransfer | It is the record for the payments made to the Trendyol from the debtor supplier status |
| ReturnInvoice | These are the return invoices by the supplier to the Trendyol. Affects the balance as +. |
| CommissionAgreementInvoice | In the event that the supplier has no receivables to be cleared, the commission received from the supplier for returned products is the settlement invoice. |
| PaymentOrder | It is the progress payment made to the supplier by calculating from the due transactions |
| DeductionInvoices | It is the invoice issued to the supplier for the services provided by Trendyol. |
{
"page": 0,
"size": 500,
"totalPages": 1,
"totalElements": 2,
"content": [
{
"id": "1639160",
"transactionDate": 1613062815995,
"barcode": null,
"transactionType": "Ödeme",
"receiptId": null,
"description": null,
"debt": 8754732.06,
"credit": 0.0,
"paymentPeriod": null,
"commissionRate": null,
"orderNumber": null,
"paymentOrderId": 112360,
"paymentDate": null,
"sellerId": 123456,
"storeId": null,
"storeName": null,
"storeAddress": null
},
{
"id": "1576967",
"transactionDate": 1612458029832,
"barcode": null,
"transactionType": "Ödeme",
"receiptId": null,
"description": null,
"debt": 5707246.85,
"credit": 0.0,
"paymentPeriod": null,
"commissionRate": null,
"orderNumber": null,
"paymentOrderId": 1576967,
"paymentDate": null,
"sellerId": 123456,
"storeId": null,
"storeName": null,
"storeAddress": null
}
]
}