# Cancellation Requests

## Reject cancellation request

> Reject a specific cancellation request.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/reject/":{"post":{"summary":"Reject cancellation request","description":"Reject a specific cancellation request.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"responses":{"200":{"description":"Cancellation request rejected successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequest"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Retrieve cancellation request

> Retrieve a specific cancellation request by ID.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}":{"get":{"summary":"Retrieve cancellation request","description":"Retrieve a specific cancellation request by ID.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"responses":{"200":{"description":"Cancellation request retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequest"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Retrieve detailed cancellation request

> Retrieve a specific cancellation request by ID with detailed information.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"CancellationRequestDetailed":{"type":"object","properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"object","$ref":"#/components/schemas/OrderItemDetailed"},"reason":{"type":"object","$ref":"#/components/schemas/CancellationReason"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false},"channel":{"type":"object","$ref":"#/components/schemas/Channel"},"customer":{"type":"object","$ref":"#/components/schemas/Customer"}}},"OrderItemDetailed":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"pk":{"type":"integer","format":"int64","readOnly":true,"description":"Order Item ID"},"order":{"$ref":"#/components/schemas/Order"},"product":{"type":"object","$ref":"#/components/schemas/Product"},"price_list":{"type":"object","$ref":"#/components/schemas/PriceList"},"stock_list":{"type":"object","$ref":"#/components/schemas/StockList"},"status":{"$ref":"#/components/schemas/OrderStatus"},"price_currency":{"$ref":"#/components/schemas/CurrencyEnum"},"price":{"type":"number","format":"decimal","description":"Price of the item"},"tax_rate":{"type":"number","format":"decimal","description":"Tax rate of the item"},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany","nullable":true},"shipment_code":{"type":"string","description":"Shipment code for the item","nullable":true},"cancel_status":{"$ref":"#/components/schemas/CancelStatusEnum","nullable":true},"is_tradable":{"type":"boolean","description":"Indicates if the item is tradable","readOnly":true},"installment_interest_amount":{"type":"number","format":"decimal","description":"Installment interest amount","nullable":true},"benefitapplicant_set":{"type":"array","items":{"$ref":"#/components/schemas/BenefitApplicant"},"nullable":true},"external_status":{"type":"object","$ref":"#/components/schemas/OrderExternalStatus"},"datasource":{"type":"object","$ref":"#/components/schemas/DataSource","nullable":true},"tracking_url":{"type":"string","format":"uri","description":"Tracking URL for the item","readOnly":true},"shipping_option_group":{"type":"object","$ref":"#/components/schemas/ShippingOptionGroup"},"forced_refund":{"type":"boolean","description":"Indicates if refund is forced","nullable":true},"extra_field":{"type":"object","description":"Extra field for additional data","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"Order":{"type":"object","required":["number","channel","customer","date_placed","amount","status"],"properties":{"pk":{"type":"integer","description":"Unique identifier for the order."},"number":{"type":"string","description":"Order number, unique within the context of a channel."},"channel":{"type":"integer","description":"ID of the channel associated with the order."},"customer":{"type":"integer","description":"ID of the customer who placed the order."},"date_placed":{"type":"string","format":"date-time","description":"Timestamp when the order was placed."},"extra_field":{"type":"object","additionalProperties":true,"description":"Additional information about the order."},"payment_option":{"type":"integer","description":"ID of the payment option used for the order."},"payment_option_slug":{"type":"string","nullable":true,"description":"Slug of the payment option."},"bin_number":{"type":"string","nullable":true,"description":"First 6 digits of the customer's card used in the transaction."},"installment":{"type":"integer","description":"ID of the installment object used for the order."},"installment_count":{"type":"integer","nullable":true,"description":"Number of installments for the payment."},"installment_interest_amount":{"type":"number","format":"decimal","description":"Interest charged on installment payments."},"cargo_company":{"type":"integer","description":"ID of the cargo company used for shipping."},"is_send":{"type":"boolean","description":"Indicates whether the order has been sent."},"delivery_type":{"type":"string","enum":["same_day","next_day","standard","in_store"],"nullable":true,"description":"Type of delivery selected for the order."},"cancellation_info":{"type":"object","description":"Details regarding the cancellation of the order."},"cancel_status":{"type":"string","enum":["waiting","confirmation_waiting","confirmed","approved","rejected","waiting_for_payment","manuel_refund_need","completed"],"nullable":true,"description":"Status of the order cancellation."},"shipping_interest_amount":{"type":"number","format":"decimal","description":"Interest applied to the shipping cost."},"external_status":{"type":"integer","description":"ID of the external status associated with the order."},"client_type":{"type":"string","enum":["default","android","ios","instore","b2b"],"description":"Type of client placing the order."},"carrier_shipping_code":{"type":"string","nullable":true,"description":"Tracking code assigned by the carrier."},"segment":{"type":"string","nullable":true,"description":"Customer segment for the order."},"checkout_provider_id":{"type":"integer","nullable":true,"description":"ID of the provider used for checkout."},"status":{"type":"string","description":"Status of the order","enum":[50,100,200,300,350,400,450,500,510,520,540,544,545,546,547,550,600]},"currency":{"type":"string","description":"Currency type for the order, following ISO 4217 currency codes.","enum":["try","eur","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"amount":{"type":"number","format":"decimal","description":"Total amount for the order."},"discount_amount":{"type":"number","format":"decimal","description":"Discount applied to the order."},"shipping_amount":{"type":"number","format":"decimal","description":"Shipping charge for the order."},"shipping_tax_rate":{"type":"number","format":"decimal","nullable":true,"description":"Tax rate applied to the shipping charge."},"refund_amount":{"type":"number","format":"decimal","description":"Total refund amount for the order. Shipping refund amount included."},"discount_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the discount."},"shipping_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the shipping."},"invoice_number":{"type":"string","nullable":true,"description":"Invoice number for the order."},"invoice_date":{"type":"string","format":"date-time","nullable":true,"description":"Invoice date for the order."},"e_archive_url":{"type":"string","format":"url","nullable":true,"description":"URL for the e-archive of the invoice."},"tracking_number":{"type":"string","nullable":true,"description":"Tracking number for the order."},"defined_tracking_url":{"type":"string","format":"url","nullable":true,"description":"URL for tracking the order."},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"remote_addr":{"type":"string","format":"ipv4","nullable":true,"description":"IP address from where the order was placed."},"has_gift_box":{"type":"boolean","description":"Indicates whether the order has a gift box."},"gift_box_note":{"type":"string","nullable":true,"description":"Message for the gift box."},"language_code":{"type":"string","nullable":true,"description":"Language code for the order."},"notes":{"type":"string","nullable":true,"description":"Customer instructions for the order."},"delivery_range":{"type":"object","description":"Date range for delivery.","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"shipping_option_slug":{"type":"string","nullable":true,"description":"Slug for the shipping option."},"created_date":{"type":"string","format":"date-time","description":"Creation Date"},"modified_date":{"type":"string","format":"date-time","description":"Last Modification Date"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"Product":{"type":"object","properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Unique identifier for the product"},"name":{"type":"string","description":"Name of the product","maxLength":255},"base_code":{"type":"string","description":"Base code for product variants","nullable":true},"sku":{"type":"string","description":"Stock keeping unit - unique identifier for the product","maxLength":255},"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product price."},"description":{"type":"string","description":"Detailed description of the product","maxLength":512,"nullable":true},"brand":{"type":"integer","description":"Foreign key to Brand model","nullable":true},"erp_categories":{"type":"array","items":{"type":"integer"},"description":"List of ERP category IDs"},"tax_rate":{"type":"number","format":"decimal","description":"Tax rate percentage","maximum":999.99,"minimum":0,"nullable":true},"weight":{"type":"number","format":"decimal","description":"Product weight","maximum":99999999.99,"minimum":0,"nullable":true},"product_type":{"type":"string","enum":["pre_product","simple","product_meta","bundle","grouped","pre_miscellaneous","miscellaneous","offer"],"description":"Type of the product"},"productization_date":{"type":"string","format":"date-time","nullable":true,"description":"Date when product was productized from pre status"},"data_source":{"type":"integer","description":"Foreign key to DataSource model","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp when the product was created"},"modified_date":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp when the product was last updated"},"is_active":{"type":"boolean","description":"Whether the product is currently active","default":true},"attribute_set":{"type":"integer","description":"Foreign key to AttributeSet model","nullable":true},"parent":{"type":"integer","description":"Foreign key to parent Product","nullable":true},"group_products":{"type":"array","items":{"type":"integer"},"description":"List of product IDs in the group","nullable":true},"attributes":{"type":"object","description":"Dynamic attributes stored as JSON","additionalProperties":true,"nullable":true},"listing_code":{"type":"string","description":"Listing code for the product","nullable":true},"is_seller_product":{"type":"boolean","description":"Whether the product is a seller product","default":false},"custom_attribute_set":{"type":"integer","description":"Foreign key to AttributeSet model","nullable":true}},"required":["name","sku","barcode","product_type"]},"PriceList":{"type":"object","properties":{"pk":{"type":"integer","format":"int64","description":"Price List ID"},"name":{"type":"string","maxLength":64,"description":"Name of the price list."},"code":{"type":"string","nullable":true,"maxLength":64,"description":"Unique code for the price list. Can be null or blank."},"currency":{"$ref":"#/components/schemas/CurrencyEnum"},"is_auto_sync":{"type":"boolean","description":"Indicates whether the price list is auto-synchronized with an external integration.","default":false},"created_date":{"type":"string","format":"date-time","description":"Creation Date of the Price List"},"modified_date":{"type":"string","format":"date-time","description":"Last Modification Date of the Price List"}}},"CurrencyEnum":{"type":"string","description":"Currency type for the price list.","enum":["tr","eu","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"StockList":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the stock list","readOnly":true},"name":{"type":"string","description":"The name of the stock list","maxLength":255},"code":{"type":"string","description":"The code of the stock list","maxLength":50},"is_auto_sync":{"type":"boolean","description":"Indicates if the stock list is set to auto-sync","default":false}}},"OrderStatus":{"type":"string","enum":["cancellation_waiting","cancelled","waiting","payment_waiting","confirmation_waiting","approved","preparing","shipped","shipped_and_informed","ready_for_pickup","attempted_delivery","review_started","review_waiting","waiting_for_payment","paid","delivered","refunded"],"description":"Status of the order item"},"CancelStatusEnum":{"type":"string","description":"Cancellation status of the order item","enum":["waiting","confirmation_waiting","confirmed","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"BenefitApplicant":{"type":"object","description":"Represents a benefit applicant in the system","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the benefit applicant","readOnly":true},"discount_item":{"type":"integer","description":"The ID of the discount item associated with this benefit applicant"},"order_item":{"type":"integer","description":"The ID of the order item associated with this benefit applicant"},"discount_share":{"type":"number","format":"decimal","description":"The share amount of the discount","minimum":0}},"required":["discount_item","order_item","discount_share"]},"OrderExternalStatus":{"type":"object","description":"A model representing external statuses of an order with a name and unique code.","properties":{"pk":{"type":"integer","description":"Unique identifier for the order.","readOnly":true},"uuid":{"type":"string","format":"uuid","description":"The unique identifier for the external status."},"name":{"type":"string","maxLength":64,"description":"The name of the external status."},"code":{"type":"string","maxLength":64,"description":"A unique code representing the external status."},"modified_date":{"type":"string","format":"date-time","readOnly":true,"description":"Modified Date"},"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"Created Date"}},"required":["name","code"]},"DataSource":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","format":"int64","readOnly":true,"description":"Data Source ID"},"name":{"type":"string","description":"Name of the data source"},"slug":{"type":"string","description":"URL-friendly version of the name","readOnly":true},"stock_list":{"type":"integer","description":"Related stock list ID"},"price_list":{"type":"integer","description":"Related price list ID"},"is_active":{"type":"boolean","description":"Indicates if the data source is active","default":true},"token":{"type":"string","description":"Authentication token for the data source","readOnly":true},"conf":{"type":"object","description":"Configuration settings for the data source","default":{},"nullable":true},"commission":{"type":"number","format":"decimal","description":"Commission rate for the data source","default":0,"minimum":0,"maximum":100},"maturity":{"type":"integer","description":"Maturity period in days","readOnly":true},"supplier_code":{"type":"string","description":"Supplier code for the data source","nullable":true},"supplier_detail":{"type":"object","description":"Supplier details","default":{},"nullable":true},"easy_return_detail":{"type":"object","description":"Easy return details","default":{},"nullable":true},"extras":{"type":"object","description":"Additional data source information","default":{},"nullable":true},"data_source_type":{"type":"string","description":"Type of the data source","enum":["unified","distributed"],"default":"unified"}},"required":["pk","name","created_date","modified_date"]},"ShippingOptionGroup":{"type":"object","description":"Represents a shipping option group in the system","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the shipping option group","readOnly":true},"amount":{"type":"number","format":"decimal","description":"The amount of the shipping option group"},"tax_rate":{"type":"number","format":"decimal","description":"The tax rate of the shipping option group"},"shipping_option_slug":{"type":"string","format":"slug","description":"The slug of the shipping option group","maxLength":128,"nullable":true},"created_date":{"type":"string","format":"date-time","description":"The date and time when the shipping option group was created","readOnly":true},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the shipping option group was last modified","readOnly":true}},"required":["amount","tax_rate"]},"CancellationReason":{"type":"object","description":"Represents a reason for order cancellation","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"Primary key of the cancellation reason","readOnly":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"extra_information_needed":{"type":"boolean","description":"Whether extra information is needed for this cancellation reason","default":false},"order":{"type":"integer","description":"Order of display for the cancellation reason","default":100},"subject":{"type":"string","description":"Subject/name of the cancellation reason","maxLength":100},"is_active":{"type":"boolean","description":"Whether the cancellation reason is active","default":true},"send_to_remote":{"type":"boolean","description":"Whether to send this reason to remote systems"},"send_to_oms":{"type":"boolean","description":"Whether to send this reason to OMS"},"translations":{"type":"object","description":"Translations for the cancellation reason","readOnly":true},"uuid":{"type":"string","description":"Unique identifier for the cancellation reason","readOnly":true}},"required":["cancellation_type","subject"]},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"Customer":{"type":"object","properties":{"pk":{"format":"int64","readOnly":true,"description":"Customer ID"},"email":{"type":"string","format":"email","description":"Email address of the customer"},"first_name":{"type":"string","description":"First name of the customer","maxLength":255},"last_name":{"type":"string","description":"Last name of the customer","maxLength":255},"phone_number":{"type":"string","description":"Phone number of the customer","nullable":true,"maxLength":128},"is_active":{"type":"boolean","description":"Indicates if the customer is active","default":false},"channel_code":{"type":"string","description":"Code representing the channel the customer belongs to","maxLength":64},"erp_code":{"type":"string","description":"Partner customer code (ERP code)","nullable":true,"maxLength":64},"attributes":{"type":"object","description":"Attributes as a JSON object"},"attribute_kwargs":{"type":"object","description":"Attribute kwargs as a JSON object"},"localized_attributes":{"type":"object","description":"Localized attributes as a JSON object"},"localized_attribute_kwargs":{"type":"object","description":"Localized attribute kwargs as a JSON object"},"extra_field":{"type":"object","description":"Additional fields as a JSON object"},"email_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving emails"},"sms_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving SMS"},"call_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving calls"},"date_joined":{"type":"string","format":"date-time","description":"The date when the customer joined","nullable":true},"gender":{"type":"string","description":"Gender of the customer","nullable":true,"enum":["male","female"]},"user_type":{"type":"string","description":"Type of user","nullable":true,"enum":["guest","registered"]},"date_of_birth":{"type":"string","format":"date","description":"Date of birth of the customer","nullable":true},"channel":{"type":"integer","nullable":true,"description":"ID of the channel the customer belongs to"}},"required":["email","channel_code","is_active","email_allowed","sms_allowed","call_allowed"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/detailed/":{"get":{"summary":"Retrieve detailed cancellation request","description":"Retrieve a specific cancellation request by ID with detailed information.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"responses":{"200":{"description":"Detailed cancellation request retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequestDetailed"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Get tags of an Cancellation Request

> Retrieve tags associated with a specific Cancellation Request by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/get_tags/":{"get":{"summary":"Get tags of an Cancellation Request","description":"Retrieve tags associated with a specific Cancellation Request by ID","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"responses":{"200":{"description":"Tags retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Add tags to an Cancellation Request

> Add tags to a specific Cancellation Request by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"SimpleTagOperations":{"type":"object","properties":{"key":{"type":"string","description":"Tag key to add to the object."}},"required":["key"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/add_tag/":{"post":{"summary":"Add tags to an Cancellation Request","description":"Add tags to a specific Cancellation Request by ID","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimpleTagOperations"}}}},"responses":{"200":{"description":"Tags added successfully"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Add multiple tags to an Cancellation Request

> Add multiple tags to a specific Cancellation Request by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"BulkTagOperations":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"},"description":"List of tag keys to add to the objects."}},"required":["keys"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/bulk_add_tag/":{"post":{"summary":"Add multiple tags to an Cancellation Request","description":"Add multiple tags to a specific Cancellation Request by ID","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkTagOperations"}}}},"responses":{"200":{"description":"Tags added successfully"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Remove tags to an Cancellation Request

> Remove tags to a specific Cancellation Request by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"SimpleTagOperations":{"type":"object","properties":{"key":{"type":"string","description":"Tag key to add to the object."}},"required":["key"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/remove_tag/":{"post":{"summary":"Remove tags to an Cancellation Request","description":"Remove tags to a specific Cancellation Request by ID","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimpleTagOperations"}}}},"responses":{"200":{"description":"Tags removed successfully"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Remove multiple tags to an Cancellation Request

> Remove multiple tags to a specific Cancellation Request by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"BulkTagOperations":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"},"description":"List of tag keys to add to the objects."}},"required":["keys"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/bulk_remove_tags/":{"post":{"summary":"Remove multiple tags to an Cancellation Request","description":"Remove multiple tags to a specific Cancellation Request by ID","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkTagOperations"}}}},"responses":{"200":{"description":"Tags removed successfully"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List cancellation requests with tag filtering

> List all cancellation requests with the ability to filter by tags and other parameters. 'key' parameter is required in query param or body.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/filter_by_tag/":{"get":{"summary":"List cancellation requests with tag filtering","description":"List all cancellation requests with the ability to filter by tags and other parameters. 'key' parameter is required in query param or body.","tags":["Cancellation Requests"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"Tag to filter cancellation requests by."}}}}}},"responses":{"200":{"description":"cancellation requests successfully listed","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of results."},"next":{"type":"string","format":"uri","nullable":true,"description":"URL of the next page of results."},"previous":{"type":"string","format":"uri","nullable":true,"description":"URL of the previous page of results."},"results":{"type":"array","items":{"$ref":"#/components/schemas/CancellationRequest"}}}}}}},"401":{"$ref":"#/components/responses/401"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List cancellation requests with tag exclusion filtering

> List all cancellation requests with the ability to exclude by tags and other parameters. 'key' parameter is required in query param or body.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/exclude_by_tag/":{"get":{"summary":"List cancellation requests with tag exclusion filtering","description":"List all cancellation requests with the ability to exclude by tags and other parameters. 'key' parameter is required in query param or body.","tags":["Cancellation Requests"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"Tag to filter cancellation requests by."}}}}}},"responses":{"200":{"description":"cancellation requests successfully listed","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of results."},"next":{"type":"string","format":"uri","nullable":true,"description":"URL of the next page of results."},"previous":{"type":"string","format":"uri","nullable":true,"description":"URL of the previous page of results."},"results":{"type":"array","items":{"$ref":"#/components/schemas/CancellationRequest"}}}}}}},"401":{"$ref":"#/components/responses/401"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Bulk add tags to cancellation requests

> Bulk add tags to cancellation requests.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"BulkObjTagOperations":{"type":"object","properties":{"objs":{"type":"array","items":{"type":"integer"},"description":"List of object IDs to which tags will be added."},"keys":{"type":"array","items":{"type":"string"},"description":"List of tag keys to add to the objects."}},"required":["objs","keys"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/bulk_add_tags/":{"post":{"summary":"Bulk add tags to cancellation requests","description":"Bulk add tags to cancellation requests.","tags":["Cancellation Requests"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkObjTagOperations"}}}},"responses":{"200":{"description":"Successfully added tags to cancellation requests"},"401":{"$ref":"#/components/responses/401"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Bulk remove tags from cancellation requests

> Bulk remove tags from cancellation requests.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"BulkObjTagOperations":{"type":"object","properties":{"objs":{"type":"array","items":{"type":"integer"},"description":"List of object IDs to which tags will be added."},"keys":{"type":"array","items":{"type":"string"},"description":"List of tag keys to add to the objects."}},"required":["objs","keys"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/bulk_remove_tags_with_many_instances/":{"post":{"summary":"Bulk remove tags from cancellation requests","description":"Bulk remove tags from cancellation requests.","tags":["Cancellation Requests"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkObjTagOperations"}}}},"responses":{"200":{"description":"Successfully removed tags from cancellation requests"},"401":{"$ref":"#/components/responses/401"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List cancellation requests

> Retrieve a paginated list of all cancellation requests with filtering support.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"Specifies the page number of the current dataset","schema":{"type":"integer","minimum":1,"default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"Indicates the number of rows on the current page.","schema":{"type":"integer","minimum":1,"default":10}},"created_date":{"name":"created_date","in":"query","required":false,"description":"Filter by creation date using supported lookup expressions (e.g., `gt`, `gte`, `lt`, `lte`, `date__gt`, etc.).","schema":{"type":"string","format":"date-time"}},"modified_date":{"name":"modified_date","in":"query","required":false,"description":"Filter by modification date using supported lookup expressions (e.g., `gt`, `gte`, `lt`, `lte`, `date__gt`, etc.).","schema":{"type":"string","format":"date-time"}},"uuid":{"name":"uuid","in":"query","description":"Filter by UUID.","required":false,"schema":{"type":"string"}},"pk":{"name":"pk","in":"query","required":false,"description":"Filters by primary key","schema":{"type":"integer"}},"pk__gt":{"name":"pk__gt","in":"query","description":"Filter by primary key greater than a specific value.","schema":{"type":"string"}},"pk__gte":{"name":"pk__gte","in":"query","required":false,"description":"Filters by primary key greater than or equal to the given value","schema":{"type":"integer"}},"pk__lt":{"name":"pk__lt","in":"query","required":false,"description":"Filters by primary key less than the given value","schema":{"type":"integer"}},"pk__lte":{"name":"pk__lte","in":"query","required":false,"description":"Filters by primary key less than or equal to the given value","schema":{"type":"integer"}},"pk__in":{"name":"pk__in","in":"query","description":"Filter by multiple primary key values (comma-separated list of integers)","required":false,"schema":{"type":"array","items":{"type":"integer"}},"style":"form","explode":false},"cancellation_type":{"name":"cancellation_type","in":"query","description":"Filter by cancellation type","required":false,"schema":{"type":"string","enum":["cancel","refund"]}},"cancellationRequestStatus":{"name":"status","in":"query","required":false,"description":"Status of the cancellation request.","schema":{"$ref":"#/components/schemas/CancellationRequestStatus"}},"number":{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Order number (case-insensitive)"},"date_placed":{"name":"date_placed","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Order number (case-insensitive)"},"sku":{"name":"sku","in":"query","required":false,"schema":{"type":"string"},"description":"Product SKU (case-insensitive)"},"channel":{"name":"channel","in":"query","description":"ID of the channel the customer belongs to","required":false,"schema":{"type":"integer"}},"customer_first_name":{"name":"customer_first_name","in":"query","required":false,"schema":{"type":"string"},"description":"Customer's first name (case-insensitive)"},"customer_last_name":{"name":"customer_last_name","in":"query","required":false,"schema":{"type":"string"},"description":"Customer's last name (case-insensitive)"},"customer_email":{"name":"customer_email","in":"query","required":false,"schema":{"type":"string","format":"email"},"description":"Customer's email (case-insensitive)"},"order_id":{"name":"order_id","in":"query","required":false,"schema":{"type":"integer"},"description":"Order ID"},"cancellation_plan_status":{"name":"cancellation_plan_status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/CancellationPlanStatus"},"description":"Status of related cancellation plan"},"easy_return_code":{"name":"easy_return_code","in":"query","required":false,"schema":{"type":"string"},"description":"Easy return code (case-insensitive)"},"tracking_number":{"name":"tracking_number","in":"query","required":false,"schema":{"type":"string"},"description":"Tracking number (case-insensitive)"},"currency_filter":{"name":"currency","in":"query","description":"Filter by currency type.","schema":{"$ref":"#/components/schemas/CurrencyEnum"}},"order_item__shipping_option_group__shipping_option_slug":{"name":"order_item__shipping_option_group__shipping_option_slug","in":"query","required":false,"description":"Filter by shipping option slug (case-insensitive)","schema":{"type":"string"}},"order_item":{"name":"order_item","in":"query","description":"Filter by order item ID.","required":false,"schema":{"type":"integer"}},"cancellation_reason_id":{"name":"reason","in":"query","required":false,"description":"Filter by cancellation reason ID","schema":{"type":"integer"}},"description":{"name":"description","in":"query","description":"Filter by product description.","schema":{"type":"string"}},"iban":{"name":"iban","in":"query","required":false,"description":"Filter by IBAN","schema":{"type":"string"}},"holder_name":{"name":"holder_name","in":"query","required":false,"description":"Filter by holder name","schema":{"type":"string"}},"easy_return_id":{"name":"easy_return","in":"query","required":false,"description":"Filter by easy return ID","schema":{"type":"integer"}},"quantity":{"name":"quantity","in":"query","required":false,"description":"Filter by quantity","schema":{"type":"integer"}},"fully_refund_as_loyalty_money":{"name":"fully_refund_as_loyalty_money","in":"query","required":false,"description":"Filter by fully refund as loyalty money flag","schema":{"type":"boolean"}}},"schemas":{"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationPlanStatus":{"type":"string","description":"Status of the cancellation plan","enum":["completed","waiting","waiting_supplier","approved","confirmation_waiting","confirmed","cancelled","failed","rejected","waiting_for_payment","manuel_refund_need"]},"CurrencyEnum":{"type":"string","description":"Currency type for the price list.","enum":["tr","eu","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/":{"get":{"summary":"List cancellation requests","description":"Retrieve a paginated list of all cancellation requests with filtering support.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/created_date"},{"$ref":"#/components/parameters/modified_date"},{"$ref":"#/components/parameters/uuid"},{"$ref":"#/components/parameters/pk"},{"$ref":"#/components/parameters/pk__gt"},{"$ref":"#/components/parameters/pk__gte"},{"$ref":"#/components/parameters/pk__lt"},{"$ref":"#/components/parameters/pk__lte"},{"$ref":"#/components/parameters/pk__in"},{"$ref":"#/components/parameters/cancellation_type"},{"$ref":"#/components/parameters/cancellationRequestStatus"},{"$ref":"#/components/parameters/number"},{"$ref":"#/components/parameters/date_placed"},{"$ref":"#/components/parameters/sku"},{"$ref":"#/components/parameters/channel"},{"$ref":"#/components/parameters/customer_first_name"},{"$ref":"#/components/parameters/customer_last_name"},{"$ref":"#/components/parameters/customer_email"},{"$ref":"#/components/parameters/order_id"},{"$ref":"#/components/parameters/cancellation_plan_status"},{"$ref":"#/components/parameters/easy_return_code"},{"$ref":"#/components/parameters/tracking_number"},{"$ref":"#/components/parameters/currency_filter"},{"$ref":"#/components/parameters/order_item__shipping_option_group__shipping_option_slug"},{"$ref":"#/components/parameters/order_item"},{"$ref":"#/components/parameters/cancellation_reason_id"},{"$ref":"#/components/parameters/description"},{"$ref":"#/components/parameters/iban"},{"$ref":"#/components/parameters/holder_name"},{"$ref":"#/components/parameters/easy_return_id"},{"$ref":"#/components/parameters/quantity"},{"$ref":"#/components/parameters/fully_refund_as_loyalty_money"}],"responses":{"200":{"description":"A paginated list of cancellation requests.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of cancellation requests available."},"next":{"type":"string","nullable":true,"description":"URL of the next results page."},"previous":{"type":"string","nullable":true,"description":"URL of the previous results page."},"results":{"type":"array","items":{"$ref":"#/components/schemas/CancellationRequest"}}}}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Create cancellation request

> Create a new cancellation request for an order item.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"CancellationRequestCreate":{"type":"object","required":["order_item","reason","cancellation_type"],"properties":{"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true}}},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/":{"post":{"summary":"Create cancellation request","description":"Create a new cancellation request for an order item.","tags":["Cancellation Requests"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequestCreate"}}}},"responses":{"201":{"description":"Cancellation request created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequest"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List detailed cancellation requests

> Retrieve a paginated list of cancellation requests with detailed information. Use export\_format parameter to get a different set of fields optimized for data export purposes.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"Specifies the page number of the current dataset","schema":{"type":"integer","minimum":1,"default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"Indicates the number of rows on the current page.","schema":{"type":"integer","minimum":1,"default":10}},"export_format":{"name":"export_format","in":"query","description":"Export format for the report","required":false,"schema":{"type":"string","enum":["csv","xls"],"default":"csv"}},"created_date":{"name":"created_date","in":"query","required":false,"description":"Filter by creation date using supported lookup expressions (e.g., `gt`, `gte`, `lt`, `lte`, `date__gt`, etc.).","schema":{"type":"string","format":"date-time"}},"modified_date":{"name":"modified_date","in":"query","required":false,"description":"Filter by modification date using supported lookup expressions (e.g., `gt`, `gte`, `lt`, `lte`, `date__gt`, etc.).","schema":{"type":"string","format":"date-time"}},"pk":{"name":"pk","in":"query","required":false,"description":"Filters by primary key","schema":{"type":"integer"}},"pk__gt":{"name":"pk__gt","in":"query","description":"Filter by primary key greater than a specific value.","schema":{"type":"string"}},"pk__gte":{"name":"pk__gte","in":"query","required":false,"description":"Filters by primary key greater than or equal to the given value","schema":{"type":"integer"}},"pk__lt":{"name":"pk__lt","in":"query","required":false,"description":"Filters by primary key less than the given value","schema":{"type":"integer"}},"pk__lte":{"name":"pk__lte","in":"query","required":false,"description":"Filters by primary key less than or equal to the given value","schema":{"type":"integer"}},"pk__in":{"name":"pk__in","in":"query","description":"Filter by multiple primary key values (comma-separated list of integers)","required":false,"schema":{"type":"array","items":{"type":"integer"}},"style":"form","explode":false},"cancellation_type":{"name":"cancellation_type","in":"query","description":"Filter by cancellation type","required":false,"schema":{"type":"string","enum":["cancel","refund"]}},"cancellationRequestStatus":{"name":"status","in":"query","required":false,"description":"Status of the cancellation request.","schema":{"$ref":"#/components/schemas/CancellationRequestStatus"}},"number":{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Order number (case-insensitive)"},"date_placed":{"name":"date_placed","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Order number (case-insensitive)"},"sku":{"name":"sku","in":"query","required":false,"schema":{"type":"string"},"description":"Product SKU (case-insensitive)"},"channel":{"name":"channel","in":"query","description":"ID of the channel the customer belongs to","required":false,"schema":{"type":"integer"}},"customer_first_name":{"name":"customer_first_name","in":"query","required":false,"schema":{"type":"string"},"description":"Customer's first name (case-insensitive)"},"customer_last_name":{"name":"customer_last_name","in":"query","required":false,"schema":{"type":"string"},"description":"Customer's last name (case-insensitive)"},"customer_email":{"name":"customer_email","in":"query","required":false,"schema":{"type":"string","format":"email"},"description":"Customer's email (case-insensitive)"},"order_id":{"name":"order_id","in":"query","required":false,"schema":{"type":"integer"},"description":"Order ID"},"cancellation_plan_status":{"name":"cancellation_plan_status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/CancellationPlanStatus"},"description":"Status of related cancellation plan"},"easy_return_code":{"name":"easy_return_code","in":"query","required":false,"schema":{"type":"string"},"description":"Easy return code (case-insensitive)"},"tracking_number":{"name":"tracking_number","in":"query","required":false,"schema":{"type":"string"},"description":"Tracking number (case-insensitive)"},"currency_filter":{"name":"currency","in":"query","description":"Filter by currency type.","schema":{"$ref":"#/components/schemas/CurrencyEnum"}},"order_item__shipping_option_group__shipping_option_slug":{"name":"order_item__shipping_option_group__shipping_option_slug","in":"query","required":false,"description":"Filter by shipping option slug (case-insensitive)","schema":{"type":"string"}},"order_item":{"name":"order_item","in":"query","description":"Filter by order item ID.","required":false,"schema":{"type":"integer"}},"cancellation_reason_id":{"name":"reason","in":"query","required":false,"description":"Filter by cancellation reason ID","schema":{"type":"integer"}},"description":{"name":"description","in":"query","description":"Filter by product description.","schema":{"type":"string"}},"iban":{"name":"iban","in":"query","required":false,"description":"Filter by IBAN","schema":{"type":"string"}},"holder_name":{"name":"holder_name","in":"query","required":false,"description":"Filter by holder name","schema":{"type":"string"}},"easy_return_id":{"name":"easy_return","in":"query","required":false,"description":"Filter by easy return ID","schema":{"type":"integer"}},"quantity":{"name":"quantity","in":"query","required":false,"description":"Filter by quantity","schema":{"type":"integer"}},"fully_refund_as_loyalty_money":{"name":"fully_refund_as_loyalty_money","in":"query","required":false,"description":"Filter by fully refund as loyalty money flag","schema":{"type":"boolean"}}},"schemas":{"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationPlanStatus":{"type":"string","description":"Status of the cancellation plan","enum":["completed","waiting","waiting_supplier","approved","confirmation_waiting","confirmed","cancelled","failed","rejected","waiting_for_payment","manuel_refund_need"]},"CurrencyEnum":{"type":"string","description":"Currency type for the price list.","enum":["tr","eu","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"CancellationRequestDetailed":{"type":"object","properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"object","$ref":"#/components/schemas/OrderItemDetailed"},"reason":{"type":"object","$ref":"#/components/schemas/CancellationReason"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false},"channel":{"type":"object","$ref":"#/components/schemas/Channel"},"customer":{"type":"object","$ref":"#/components/schemas/Customer"}}},"OrderItemDetailed":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"pk":{"type":"integer","format":"int64","readOnly":true,"description":"Order Item ID"},"order":{"$ref":"#/components/schemas/Order"},"product":{"type":"object","$ref":"#/components/schemas/Product"},"price_list":{"type":"object","$ref":"#/components/schemas/PriceList"},"stock_list":{"type":"object","$ref":"#/components/schemas/StockList"},"status":{"$ref":"#/components/schemas/OrderStatus"},"price_currency":{"$ref":"#/components/schemas/CurrencyEnum"},"price":{"type":"number","format":"decimal","description":"Price of the item"},"tax_rate":{"type":"number","format":"decimal","description":"Tax rate of the item"},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany","nullable":true},"shipment_code":{"type":"string","description":"Shipment code for the item","nullable":true},"cancel_status":{"$ref":"#/components/schemas/CancelStatusEnum","nullable":true},"is_tradable":{"type":"boolean","description":"Indicates if the item is tradable","readOnly":true},"installment_interest_amount":{"type":"number","format":"decimal","description":"Installment interest amount","nullable":true},"benefitapplicant_set":{"type":"array","items":{"$ref":"#/components/schemas/BenefitApplicant"},"nullable":true},"external_status":{"type":"object","$ref":"#/components/schemas/OrderExternalStatus"},"datasource":{"type":"object","$ref":"#/components/schemas/DataSource","nullable":true},"tracking_url":{"type":"string","format":"uri","description":"Tracking URL for the item","readOnly":true},"shipping_option_group":{"type":"object","$ref":"#/components/schemas/ShippingOptionGroup"},"forced_refund":{"type":"boolean","description":"Indicates if refund is forced","nullable":true},"extra_field":{"type":"object","description":"Extra field for additional data","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"Order":{"type":"object","required":["number","channel","customer","date_placed","amount","status"],"properties":{"pk":{"type":"integer","description":"Unique identifier for the order."},"number":{"type":"string","description":"Order number, unique within the context of a channel."},"channel":{"type":"integer","description":"ID of the channel associated with the order."},"customer":{"type":"integer","description":"ID of the customer who placed the order."},"date_placed":{"type":"string","format":"date-time","description":"Timestamp when the order was placed."},"extra_field":{"type":"object","additionalProperties":true,"description":"Additional information about the order."},"payment_option":{"type":"integer","description":"ID of the payment option used for the order."},"payment_option_slug":{"type":"string","nullable":true,"description":"Slug of the payment option."},"bin_number":{"type":"string","nullable":true,"description":"First 6 digits of the customer's card used in the transaction."},"installment":{"type":"integer","description":"ID of the installment object used for the order."},"installment_count":{"type":"integer","nullable":true,"description":"Number of installments for the payment."},"installment_interest_amount":{"type":"number","format":"decimal","description":"Interest charged on installment payments."},"cargo_company":{"type":"integer","description":"ID of the cargo company used for shipping."},"is_send":{"type":"boolean","description":"Indicates whether the order has been sent."},"delivery_type":{"type":"string","enum":["same_day","next_day","standard","in_store"],"nullable":true,"description":"Type of delivery selected for the order."},"cancellation_info":{"type":"object","description":"Details regarding the cancellation of the order."},"cancel_status":{"type":"string","enum":["waiting","confirmation_waiting","confirmed","approved","rejected","waiting_for_payment","manuel_refund_need","completed"],"nullable":true,"description":"Status of the order cancellation."},"shipping_interest_amount":{"type":"number","format":"decimal","description":"Interest applied to the shipping cost."},"external_status":{"type":"integer","description":"ID of the external status associated with the order."},"client_type":{"type":"string","enum":["default","android","ios","instore","b2b"],"description":"Type of client placing the order."},"carrier_shipping_code":{"type":"string","nullable":true,"description":"Tracking code assigned by the carrier."},"segment":{"type":"string","nullable":true,"description":"Customer segment for the order."},"checkout_provider_id":{"type":"integer","nullable":true,"description":"ID of the provider used for checkout."},"status":{"type":"string","description":"Status of the order","enum":[50,100,200,300,350,400,450,500,510,520,540,544,545,546,547,550,600]},"currency":{"type":"string","description":"Currency type for the order, following ISO 4217 currency codes.","enum":["try","eur","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"amount":{"type":"number","format":"decimal","description":"Total amount for the order."},"discount_amount":{"type":"number","format":"decimal","description":"Discount applied to the order."},"shipping_amount":{"type":"number","format":"decimal","description":"Shipping charge for the order."},"shipping_tax_rate":{"type":"number","format":"decimal","nullable":true,"description":"Tax rate applied to the shipping charge."},"refund_amount":{"type":"number","format":"decimal","description":"Total refund amount for the order. Shipping refund amount included."},"discount_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the discount."},"shipping_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the shipping."},"invoice_number":{"type":"string","nullable":true,"description":"Invoice number for the order."},"invoice_date":{"type":"string","format":"date-time","nullable":true,"description":"Invoice date for the order."},"e_archive_url":{"type":"string","format":"url","nullable":true,"description":"URL for the e-archive of the invoice."},"tracking_number":{"type":"string","nullable":true,"description":"Tracking number for the order."},"defined_tracking_url":{"type":"string","format":"url","nullable":true,"description":"URL for tracking the order."},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"remote_addr":{"type":"string","format":"ipv4","nullable":true,"description":"IP address from where the order was placed."},"has_gift_box":{"type":"boolean","description":"Indicates whether the order has a gift box."},"gift_box_note":{"type":"string","nullable":true,"description":"Message for the gift box."},"language_code":{"type":"string","nullable":true,"description":"Language code for the order."},"notes":{"type":"string","nullable":true,"description":"Customer instructions for the order."},"delivery_range":{"type":"object","description":"Date range for delivery.","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"shipping_option_slug":{"type":"string","nullable":true,"description":"Slug for the shipping option."},"created_date":{"type":"string","format":"date-time","description":"Creation Date"},"modified_date":{"type":"string","format":"date-time","description":"Last Modification Date"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"Product":{"type":"object","properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Unique identifier for the product"},"name":{"type":"string","description":"Name of the product","maxLength":255},"base_code":{"type":"string","description":"Base code for product variants","nullable":true},"sku":{"type":"string","description":"Stock keeping unit - unique identifier for the product","maxLength":255},"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product price."},"description":{"type":"string","description":"Detailed description of the product","maxLength":512,"nullable":true},"brand":{"type":"integer","description":"Foreign key to Brand model","nullable":true},"erp_categories":{"type":"array","items":{"type":"integer"},"description":"List of ERP category IDs"},"tax_rate":{"type":"number","format":"decimal","description":"Tax rate percentage","maximum":999.99,"minimum":0,"nullable":true},"weight":{"type":"number","format":"decimal","description":"Product weight","maximum":99999999.99,"minimum":0,"nullable":true},"product_type":{"type":"string","enum":["pre_product","simple","product_meta","bundle","grouped","pre_miscellaneous","miscellaneous","offer"],"description":"Type of the product"},"productization_date":{"type":"string","format":"date-time","nullable":true,"description":"Date when product was productized from pre status"},"data_source":{"type":"integer","description":"Foreign key to DataSource model","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp when the product was created"},"modified_date":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp when the product was last updated"},"is_active":{"type":"boolean","description":"Whether the product is currently active","default":true},"attribute_set":{"type":"integer","description":"Foreign key to AttributeSet model","nullable":true},"parent":{"type":"integer","description":"Foreign key to parent Product","nullable":true},"group_products":{"type":"array","items":{"type":"integer"},"description":"List of product IDs in the group","nullable":true},"attributes":{"type":"object","description":"Dynamic attributes stored as JSON","additionalProperties":true,"nullable":true},"listing_code":{"type":"string","description":"Listing code for the product","nullable":true},"is_seller_product":{"type":"boolean","description":"Whether the product is a seller product","default":false},"custom_attribute_set":{"type":"integer","description":"Foreign key to AttributeSet model","nullable":true}},"required":["name","sku","barcode","product_type"]},"PriceList":{"type":"object","properties":{"pk":{"type":"integer","format":"int64","description":"Price List ID"},"name":{"type":"string","maxLength":64,"description":"Name of the price list."},"code":{"type":"string","nullable":true,"maxLength":64,"description":"Unique code for the price list. Can be null or blank."},"currency":{"$ref":"#/components/schemas/CurrencyEnum"},"is_auto_sync":{"type":"boolean","description":"Indicates whether the price list is auto-synchronized with an external integration.","default":false},"created_date":{"type":"string","format":"date-time","description":"Creation Date of the Price List"},"modified_date":{"type":"string","format":"date-time","description":"Last Modification Date of the Price List"}}},"StockList":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the stock list","readOnly":true},"name":{"type":"string","description":"The name of the stock list","maxLength":255},"code":{"type":"string","description":"The code of the stock list","maxLength":50},"is_auto_sync":{"type":"boolean","description":"Indicates if the stock list is set to auto-sync","default":false}}},"OrderStatus":{"type":"string","enum":["cancellation_waiting","cancelled","waiting","payment_waiting","confirmation_waiting","approved","preparing","shipped","shipped_and_informed","ready_for_pickup","attempted_delivery","review_started","review_waiting","waiting_for_payment","paid","delivered","refunded"],"description":"Status of the order item"},"CancelStatusEnum":{"type":"string","description":"Cancellation status of the order item","enum":["waiting","confirmation_waiting","confirmed","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"BenefitApplicant":{"type":"object","description":"Represents a benefit applicant in the system","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the benefit applicant","readOnly":true},"discount_item":{"type":"integer","description":"The ID of the discount item associated with this benefit applicant"},"order_item":{"type":"integer","description":"The ID of the order item associated with this benefit applicant"},"discount_share":{"type":"number","format":"decimal","description":"The share amount of the discount","minimum":0}},"required":["discount_item","order_item","discount_share"]},"OrderExternalStatus":{"type":"object","description":"A model representing external statuses of an order with a name and unique code.","properties":{"pk":{"type":"integer","description":"Unique identifier for the order.","readOnly":true},"uuid":{"type":"string","format":"uuid","description":"The unique identifier for the external status."},"name":{"type":"string","maxLength":64,"description":"The name of the external status."},"code":{"type":"string","maxLength":64,"description":"A unique code representing the external status."},"modified_date":{"type":"string","format":"date-time","readOnly":true,"description":"Modified Date"},"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"Created Date"}},"required":["name","code"]},"DataSource":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","format":"int64","readOnly":true,"description":"Data Source ID"},"name":{"type":"string","description":"Name of the data source"},"slug":{"type":"string","description":"URL-friendly version of the name","readOnly":true},"stock_list":{"type":"integer","description":"Related stock list ID"},"price_list":{"type":"integer","description":"Related price list ID"},"is_active":{"type":"boolean","description":"Indicates if the data source is active","default":true},"token":{"type":"string","description":"Authentication token for the data source","readOnly":true},"conf":{"type":"object","description":"Configuration settings for the data source","default":{},"nullable":true},"commission":{"type":"number","format":"decimal","description":"Commission rate for the data source","default":0,"minimum":0,"maximum":100},"maturity":{"type":"integer","description":"Maturity period in days","readOnly":true},"supplier_code":{"type":"string","description":"Supplier code for the data source","nullable":true},"supplier_detail":{"type":"object","description":"Supplier details","default":{},"nullable":true},"easy_return_detail":{"type":"object","description":"Easy return details","default":{},"nullable":true},"extras":{"type":"object","description":"Additional data source information","default":{},"nullable":true},"data_source_type":{"type":"string","description":"Type of the data source","enum":["unified","distributed"],"default":"unified"}},"required":["pk","name","created_date","modified_date"]},"ShippingOptionGroup":{"type":"object","description":"Represents a shipping option group in the system","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"The unique identifier for the shipping option group","readOnly":true},"amount":{"type":"number","format":"decimal","description":"The amount of the shipping option group"},"tax_rate":{"type":"number","format":"decimal","description":"The tax rate of the shipping option group"},"shipping_option_slug":{"type":"string","format":"slug","description":"The slug of the shipping option group","maxLength":128,"nullable":true},"created_date":{"type":"string","format":"date-time","description":"The date and time when the shipping option group was created","readOnly":true},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the shipping option group was last modified","readOnly":true}},"required":["amount","tax_rate"]},"CancellationReason":{"type":"object","description":"Represents a reason for order cancellation","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"pk":{"type":"integer","description":"Primary key of the cancellation reason","readOnly":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"extra_information_needed":{"type":"boolean","description":"Whether extra information is needed for this cancellation reason","default":false},"order":{"type":"integer","description":"Order of display for the cancellation reason","default":100},"subject":{"type":"string","description":"Subject/name of the cancellation reason","maxLength":100},"is_active":{"type":"boolean","description":"Whether the cancellation reason is active","default":true},"send_to_remote":{"type":"boolean","description":"Whether to send this reason to remote systems"},"send_to_oms":{"type":"boolean","description":"Whether to send this reason to OMS"},"translations":{"type":"object","description":"Translations for the cancellation reason","readOnly":true},"uuid":{"type":"string","description":"Unique identifier for the cancellation reason","readOnly":true}},"required":["cancellation_type","subject"]},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"Customer":{"type":"object","properties":{"pk":{"format":"int64","readOnly":true,"description":"Customer ID"},"email":{"type":"string","format":"email","description":"Email address of the customer"},"first_name":{"type":"string","description":"First name of the customer","maxLength":255},"last_name":{"type":"string","description":"Last name of the customer","maxLength":255},"phone_number":{"type":"string","description":"Phone number of the customer","nullable":true,"maxLength":128},"is_active":{"type":"boolean","description":"Indicates if the customer is active","default":false},"channel_code":{"type":"string","description":"Code representing the channel the customer belongs to","maxLength":64},"erp_code":{"type":"string","description":"Partner customer code (ERP code)","nullable":true,"maxLength":64},"attributes":{"type":"object","description":"Attributes as a JSON object"},"attribute_kwargs":{"type":"object","description":"Attribute kwargs as a JSON object"},"localized_attributes":{"type":"object","description":"Localized attributes as a JSON object"},"localized_attribute_kwargs":{"type":"object","description":"Localized attribute kwargs as a JSON object"},"extra_field":{"type":"object","description":"Additional fields as a JSON object"},"email_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving emails"},"sms_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving SMS"},"call_allowed":{"type":"boolean","description":"Indicates if the customer allows receiving calls"},"date_joined":{"type":"string","format":"date-time","description":"The date when the customer joined","nullable":true},"gender":{"type":"string","description":"Gender of the customer","nullable":true,"enum":["male","female"]},"user_type":{"type":"string","description":"Type of user","nullable":true,"enum":["guest","registered"]},"date_of_birth":{"type":"string","format":"date","description":"Date of birth of the customer","nullable":true},"channel":{"type":"integer","nullable":true,"description":"ID of the channel the customer belongs to"}},"required":["email","channel_code","is_active","email_allowed","sms_allowed","call_allowed"]},"CancellationRequestDetailedExport":{"type":"object","description":"Detailed cancellation request data optimized for export purposes. Used when export_format query parameter is provided. Returns JSON with a different field set than the standard detailed view.","properties":{"pk":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"object","$ref":"#/components/schemas/OrderItemDetailed","description":"Detailed order item information"},"channel":{"type":"object","$ref":"#/components/schemas/Channel","description":"Channel information"},"reason":{"type":"object","$ref":"#/components/schemas/CancellationReason","description":"Cancellation reason"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus","description":"Current status of the cancellation request"},"created_date":{"type":"string","format":"date-time","description":"Date when the cancellation request was created"},"customer":{"type":"object","$ref":"#/components/schemas/Customer","description":"Customer information"},"last_updated_by":{"type":"string","nullable":true,"description":"Username of the user who last updated the cancellation request"},"cancellation_type":{"$ref":"#/components/schemas/CancellationType","description":"Type of cancellation (refund, exchange, etc.)"},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true,"description":"Easy return information if applicable"},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"iban":{"type":"string","description":"IBAN for refund","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/detailed/":{"get":{"summary":"List detailed cancellation requests","description":"Retrieve a paginated list of cancellation requests with detailed information. Use export_format parameter to get a different set of fields optimized for data export purposes.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/export_format"},{"$ref":"#/components/parameters/created_date"},{"$ref":"#/components/parameters/modified_date"},{"$ref":"#/components/parameters/pk"},{"$ref":"#/components/parameters/pk__gt"},{"$ref":"#/components/parameters/pk__gte"},{"$ref":"#/components/parameters/pk__lt"},{"$ref":"#/components/parameters/pk__lte"},{"$ref":"#/components/parameters/pk__in"},{"$ref":"#/components/parameters/cancellation_type"},{"$ref":"#/components/parameters/cancellationRequestStatus"},{"$ref":"#/components/parameters/number"},{"$ref":"#/components/parameters/date_placed"},{"$ref":"#/components/parameters/sku"},{"$ref":"#/components/parameters/channel"},{"$ref":"#/components/parameters/customer_first_name"},{"$ref":"#/components/parameters/customer_last_name"},{"$ref":"#/components/parameters/customer_email"},{"$ref":"#/components/parameters/order_id"},{"$ref":"#/components/parameters/cancellation_plan_status"},{"$ref":"#/components/parameters/easy_return_code"},{"$ref":"#/components/parameters/tracking_number"},{"$ref":"#/components/parameters/currency_filter"},{"$ref":"#/components/parameters/order_item__shipping_option_group__shipping_option_slug"},{"$ref":"#/components/parameters/order_item"},{"$ref":"#/components/parameters/cancellation_reason_id"},{"$ref":"#/components/parameters/description"},{"$ref":"#/components/parameters/iban"},{"$ref":"#/components/parameters/holder_name"},{"$ref":"#/components/parameters/easy_return_id"},{"$ref":"#/components/parameters/quantity"},{"$ref":"#/components/parameters/fully_refund_as_loyalty_money"}],"responses":{"200":{"description":"A paginated list of detailed cancellation requests.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of cancellation requests available."},"next":{"type":"string","nullable":true,"description":"URL of the next results page."},"previous":{"type":"string","nullable":true,"description":"URL of the previous results page."},"results":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CancellationRequestDetailed"},{"$ref":"#/components/schemas/CancellationRequestDetailedExport"}]},"description":"Returns CancellationRequestDetailed by default, or CancellationRequestDetailedExport when export_format parameter is provided"}}}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Update cancellation request

> Update an existing cancellation request.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"CancellationRequestUpdate":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false},"reason":{"type":"integer","description":"Related cancellation reason ID"},"order_item":{"type":"integer","description":"Related order item ID"}}},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/":{"put":{"summary":"Update cancellation request","description":"Update an existing cancellation request.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequestUpdate"}}}},"responses":{"200":{"description":"Cancellation request updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequest"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Partially update cancellation request

> Partially update an existing cancellation request.

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"schemas":{"CancellationRequestUpdate":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false},"reason":{"type":"integer","description":"Related cancellation reason ID"},"order_item":{"type":"integer","description":"Related order item ID"}}},"CancellationRequestStatus":{"type":"string","description":"Status of the cancellation request.","enum":["open","waiting","confirmation_waiting","confirmed","waiting_approval","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"CancellationType":{"type":"string","description":"Type of cancellation","enum":["cancel","refund"]},"CancellationRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"},{"$ref":"#/components/schemas/Entity"}],"properties":{"id":{"type":"integer","format":"int64","readOnly":true,"description":"Cancellation Request ID"},"order_item":{"type":"integer","description":"Related order item ID"},"reason":{"type":"integer","description":"Related cancellation reason ID"},"description":{"type":"string","description":"Description of the cancellation request","nullable":true},"cancellation_type":{"$ref":"#/components/schemas/CancellationType"},"status":{"$ref":"#/components/schemas/CancellationRequestStatus"},"iban":{"type":"string","description":"IBAN for refund","nullable":true},"holder_name":{"type":"string","description":"Name of the account holder","nullable":true},"easy_return":{"type":"object","$ref":"#/components/schemas/CancellationEasyReturn","nullable":true},"quantity":{"type":"integer","description":"Quantity of items to be cancelled","minimum":1,"nullable":true},"fully_refund_as_loyalty_money":{"type":"boolean","description":"Flag to indicate if the refund should be processed as loyalty money","default":false}},"required":["id","order_item","reason","cancellation_type","status","created_date","modified_date"]},"UUIDStarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."},"uuid":{"type":"string","format":"uuid","description":"Unique UUID identifier","readOnly":true}}},"Entity":{"type":"object","properties":{"attributes":{"type":"object","description":"A JSON object to store various attributes of the entity."},"attributes_kwargs":{"type":"object","description":"A JSON object to store additional attribute keyword arguments."},"localized_attributes":{"type":"object","description":"A JSON object to store localized attributes."},"localized_attributes_kwargs":{"type":"object","description":"A JSON object to store localized attributes keyword arguments."}}},"CancellationEasyReturn":{"type":"object","allOf":[{"$ref":"#/components/schemas/UUIDStarterModel"}],"properties":{"id":{"type":"integer","description":"Unique identifier for the cancellation easy return","readOnly":true},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"code":{"type":"string","description":"Code for the cancellation easy return","nullable":true},"start_date":{"type":"string","format":"date-time","description":"Start date of the cancellation easy return","nullable":true},"end_date":{"type":"string","format":"date-time","description":"End date of the cancellation easy return","nullable":true},"max_count":{"type":"integer","description":"Maximum number of returns allowed","nullable":true},"status":{"$ref":"#/components/schemas/CancellationEasyReturnStatus"},"raw_request":{"type":"string","description":"Raw request data for the cancellation easy return","nullable":true},"raw_response":{"type":"string","description":"Raw response data for the cancellation easy return","nullable":true},"tracking_number":{"type":"string","description":"Tracking number for return","nullable":true},"tracking_url":{"type":"string","format":"uri","maxLength":4096,"description":"Tracking URL for return, if available","nullable":true},"pickup_date":{"type":"object","nullable":false,"default":{},"description":"JSON field to store pickup date-related data"}}},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancellationEasyReturnStatus":{"type":"string","description":"Status of the cancellation easy return.","enum":["active","cancelled"]}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"403":{"description":"Forbidden"},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/cancellation_requests/{id}/":{"patch":{"summary":"Partially update cancellation request","description":"Partially update an existing cancellation request.","tags":["Cancellation Requests"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequestUpdate"}}}},"responses":{"200":{"description":"Cancellation request partially updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationRequest"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/omnitron-openapis/cancellation-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.