(New) Current Account Statement Integration

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.

  • GET settlements (Sales, Returns, Discounts, Coupons, Provisions)

https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/settlements

  • Sample Endpoint

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.

Sample Service Response (transactionType = Sale is used)


{
    "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
        }    
        ]
}
  • GET otherfinancials (Supplier financing, transfers, payments, invoices, supplier invoices, incoming transfers, commission reconciliation invoices)

https://api.trendyol.com/integration/finance/che/sellers/{supplierId}/otherfinancials

  • Sample Endpoint

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.

Sample Service Response (transactionType = PaymentOrder used)


{
    "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
        }
    ]
}